/* Pango * pangocairo.h: * * Copyright (C) 1999, 2004 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ #ifndef __PANGOCAIRO_H__ #define __PANGOCAIRO_H__ #include #include G_BEGIN_DECLS /** * PangoCairoFont: * * #PangoCairoFont is an interface exported by fonts for * use with Cairo. The actual type of the font will depend * on the particular font technology Cairo was compiled to use. * * Since: 1.18 **/ typedef struct _PangoCairoFont PangoCairoFont; #define PANGO_TYPE_CAIRO_FONT (pango_cairo_font_get_type ()) #define PANGO_CAIRO_FONT(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_CAIRO_FONT, PangoCairoFont)) #define PANGO_IS_CAIRO_FONT(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_CAIRO_FONT)) /** * PangoCairoFontMap: * * #PangoCairoFontMap is an interface exported by font maps for * use with Cairo. The actual type of the font map will depend * on the particular font technology Cairo was compiled to use. * * Since: 1.10 **/ typedef struct _PangoCairoFontMap PangoCairoFontMap; #define PANGO_TYPE_CAIRO_FONT_MAP (pango_cairo_font_map_get_type ()) #define PANGO_CAIRO_FONT_MAP(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_CAIRO_FONT_MAP, PangoCairoFontMap)) #define PANGO_IS_CAIRO_FONT_MAP(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_CAIRO_FONT_MAP)) /** * PangoCairoShapeRendererFunc: * @cr: a Cairo context with current point set to where the shape should * be rendered * @attr: the %PANGO_ATTR_SHAPE to render * @do_path: whether only the shape path should be appended to current * path of @cr and no filling/stroking done. This will be set * to %TRUE when called from pango_cairo_layout_path() and * pango_cairo_layout_line_path() rendering functions. * @data: user data passed to pango_cairo_context_set_shape_renderer() * * Function type for rendering attributes of type %PANGO_ATTR_SHAPE * with Pango's Cairo renderer. */ typedef void (* PangoCairoShapeRendererFunc) (cairo_t *cr, PangoAttrShape *attr, gboolean do_path, gpointer data); /* * PangoCairoFontMap */ PANGO_AVAILABLE_IN_1_10 GType pango_cairo_font_map_get_type (void) G_GNUC_CONST; PANGO_AVAILABLE_IN_1_10 PangoFontMap *pango_cairo_font_map_new (void); PANGO_AVAILABLE_IN_1_18 PangoFontMap *pango_cairo_font_map_new_for_font_type (cairo_font_type_t fonttype); PANGO_AVAILABLE_IN_1_10 PangoFontMap *pango_cairo_font_map_get_default (void); PANGO_AVAILABLE_IN_1_22 void pango_cairo_font_map_set_default (PangoCairoFontMap *fontmap); PANGO_AVAILABLE_IN_1_18 cairo_font_type_t pango_cairo_font_map_get_font_type (PangoCairoFontMap *fontmap); PANGO_AVAILABLE_IN_1_10 void pango_cairo_font_map_set_resolution (PangoCairoFontMap *fontmap, double dpi); PANGO_AVAILABLE_IN_1_10 double pango_cairo_font_map_get_resolution (PangoCairoFontMap *fontmap); #ifndef PANGO_DISABLE_DEPRECATED PANGO_DEPRECATED_IN_1_22_FOR(pango_font_map_create_context) PangoContext *pango_cairo_font_map_create_context (PangoCairoFontMap *fontmap); #endif /* * PangoCairoFont */ PANGO_AVAILABLE_IN_1_18 GType pango_cairo_font_get_type (void) G_GNUC_CONST; PANGO_AVAILABLE_IN_1_18 cairo_scaled_font_t *pango_cairo_font_get_scaled_font (PangoCairoFont *font); /* Update a Pango context for the current state of a cairo context */ PANGO_AVAILABLE_IN_1_10 void pango_cairo_update_context (cairo_t *cr, PangoContext *context); PANGO_AVAILABLE_IN_1_10 void pango_cairo_context_set_font_options (PangoContext *context, const cairo_font_options_t *options); PANGO_AVAILABLE_IN_1_10 const cairo_font_options_t *pango_cairo_context_get_font_options (PangoContext *context); PANGO_AVAILABLE_IN_1_10 void pango_cairo_context_set_resolution (PangoContext *context, double dpi); PANGO_AVAILABLE_IN_1_10 double pango_cairo_context_get_resolution (PangoContext *context); PANGO_AVAILABLE_IN_1_18 void pango_cairo_context_set_shape_renderer (PangoContext *context, PangoCairoShapeRendererFunc func, gpointer data, GDestroyNotify dnotify); PANGO_AVAILABLE_IN_1_18 PangoCairoShapeRendererFunc pango_cairo_context_get_shape_renderer (PangoContext *context, gpointer *data); /* Convenience */ PANGO_AVAILABLE_IN_1_22 PangoContext *pango_cairo_create_context (cairo_t *cr); PANGO_AVAILABLE_IN_ALL PangoLayout *pango_cairo_create_layout (cairo_t *cr); PANGO_AVAILABLE_IN_1_10 void pango_cairo_update_layout (cairo_t *cr, PangoLayout *layout); /* * Rendering */ PANGO_AVAILABLE_IN_1_10 void pango_cairo_show_glyph_string (cairo_t *cr, PangoFont *font, PangoGlyphString *glyphs); PANGO_AVAILABLE_IN_1_22 void pango_cairo_show_glyph_item (cairo_t *cr, const char *text, PangoGlyphItem *glyph_item); PANGO_AVAILABLE_IN_1_10 void pango_cairo_show_layout_line (cairo_t *cr, PangoLayoutLine *line); PANGO_AVAILABLE_IN_1_10 void pango_cairo_show_layout (cairo_t *cr, PangoLayout *layout); PANGO_AVAILABLE_IN_1_14 void pango_cairo_show_error_underline (cairo_t *cr, double x, double y, double width, double height); /* * Rendering to a path */ PANGO_AVAILABLE_IN_1_10 void pango_cairo_glyph_string_path (cairo_t *cr, PangoFont *font, PangoGlyphString *glyphs); PANGO_AVAILABLE_IN_1_10 void pango_cairo_layout_line_path (cairo_t *cr, PangoLayoutLine *line); PANGO_AVAILABLE_IN_1_10 void pango_cairo_layout_path (cairo_t *cr, PangoLayout *layout); PANGO_AVAILABLE_IN_1_14 void pango_cairo_error_underline_path (cairo_t *cr, double x, double y, double width, double height); G_END_DECLS #endif /* __PANGOCAIRO_H__ */