SynopsisPangoFT2FontMap; #define PANGO_RENDER_TYPE_FT2 PangoFontMap* pango_ft2_font_map_new (void); void pango_ft2_font_map_set_resolution (PangoFT2FontMap *fontmap, double dpi_x, double dpi_y); PangoContext* pango_ft2_font_map_create_context (PangoFT2FontMap *fontmap); void (*PangoFT2SubstituteFunc) (FcPattern *pattern, gpointer data); void pango_ft2_font_map_set_default_substitute (PangoFT2FontMap *fontmap, PangoFT2SubstituteFunc func, gpointer data, GDestroyNotify notify); void pango_ft2_font_map_substitute_changed (PangoFT2FontMap *fontmap); PangoContext* pango_ft2_get_context (double dpi_x, double dpi_y); void pango_ft2_render (FT_Bitmap *bitmap, PangoFont *font, PangoGlyphString *glyphs, gint x, gint y); void pango_ft2_render_transformed (FT_Bitmap *bitmap, const PangoMatrix *matrix, PangoFont *font, PangoGlyphString *glyphs, int x, int y); void pango_ft2_render_layout_line (FT_Bitmap *bitmap, PangoLayoutLine *line, int x, int y); void pango_ft2_render_layout_line_subpixel (FT_Bitmap *bitmap, PangoLayoutLine *line, int x, int y); void pango_ft2_render_layout (FT_Bitmap *bitmap, PangoLayout *layout, int x, int y); void pango_ft2_render_layout_subpixel (FT_Bitmap *bitmap, PangoLayout *layout, int x, int y); PangoGlyph pango_ft2_get_unknown_glyph (PangoFont *font); int pango_ft2_font_get_kerning (PangoFont *font, PangoGlyph left, PangoGlyph right); FT_Face pango_ft2_font_get_face (PangoFont *font); PangoCoverage* pango_ft2_font_get_coverage (PangoFont *font, PangoLanguage *language); PangoFontMap* pango_ft2_font_map_for_display (void); void pango_ft2_shutdown_display (void); DescriptionThe macros and functions in this section are used to access fonts and render text to bitmaps using the FreeType 2 library. DetailsPangoFT2FontMaptypedef struct _PangoFT2FontMap PangoFT2FontMap; The PangoFT2FontMap is the PangoFontMap implementation for FreeType fonts. PANGO_RENDER_TYPE_FT2#define PANGO_RENDER_TYPE_FT2 "PangoRenderFT2" Warning
A string constant that was used to identify shape engines that work
with the FreeType backend. See pango_ft2_font_map_new ()PangoFontMap* pango_ft2_font_map_new (void);
Create a new PangoFT2FontMap object; a fontmap is used
to cache information about available fonts, and holds
certain global parameters such as the resolution and
the default substitute function (see
Since 1.2 pango_ft2_font_map_set_resolution ()void pango_ft2_font_map_set_resolution (PangoFT2FontMap *fontmap, double dpi_x, double dpi_y); Sets the horizontal and vertical resolutions for the fontmap.
Since 1.2 pango_ft2_font_map_create_context ()PangoContext* pango_ft2_font_map_create_context (PangoFT2FontMap *fontmap); Warning
Create a PangoContext for the given fontmap.
Since 1.2 PangoFT2SubstituteFunc ()void (*PangoFT2SubstituteFunc) (FcPattern *pattern, gpointer data); Function type for doing final config tweaking on prepared FcPatterns.
pango_ft2_font_map_set_default_substitute ()void pango_ft2_font_map_set_default_substitute (PangoFT2FontMap *fontmap, PangoFT2SubstituteFunc func, gpointer data, GDestroyNotify notify); Sets a function that will be called to do final configuration substitution on a FcPattern before it is used to load the font. This function can be used to do things like set hinting and antialiasing options.
Since 1.2 pango_ft2_font_map_substitute_changed ()void pango_ft2_font_map_substitute_changed (PangoFT2FontMap *fontmap);
Call this function any time the results of the
default substitution function set with
Since 1.2 pango_ft2_get_context ()PangoContext* pango_ft2_get_context (double dpi_x, double dpi_y); Warning
Retrieves a PangoContext for the default PangoFT2 fontmap
(see
pango_ft2_render ()void pango_ft2_render (FT_Bitmap *bitmap, PangoFont *font, PangoGlyphString *glyphs, gint x, gint y); Renders a PangoGlyphString onto a FreeType2 bitmap.
pango_ft2_render_transformed ()void pango_ft2_render_transformed (FT_Bitmap *bitmap, const PangoMatrix *matrix, PangoFont *font, PangoGlyphString *glyphs, int x, int y);
Renders a PangoGlyphString onto a FreeType2 bitmap, possibly
transforming the layed-out coordinates through a transformation
matrix. Note that the transformation matrix for
Since 1.6 pango_ft2_render_layout_line ()void pango_ft2_render_layout_line (FT_Bitmap *bitmap, PangoLayoutLine *line, int x, int y); Render a PangoLayoutLine onto a FreeType2 bitmap
pango_ft2_render_layout_line_subpixel ()void pango_ft2_render_layout_line_subpixel (FT_Bitmap *bitmap, PangoLayoutLine *line, int x, int y); Render a PangoLayoutLine onto a FreeType2 bitmap, with he location specified in fixed-point Pango units rather than pixels. (Using this will avoid extra inaccuracies from rounding to integer pixels multiple times, even if the final glyph positions are integers.)
Since 1.6 pango_ft2_render_layout ()void pango_ft2_render_layout (FT_Bitmap *bitmap, PangoLayout *layout, int x, int y); Render a PangoLayout onto a FreeType2 bitmap
pango_ft2_render_layout_subpixel ()void pango_ft2_render_layout_subpixel (FT_Bitmap *bitmap, PangoLayout *layout, int x, int y); Render a PangoLayout onto a FreeType2 bitmap, with he location specified in fixed-point Pango units rather than pixels. (Using this will avoid extra inaccuracies from rounding to integer pixels multiple times, even if the final glyph positions are integers.)
Since 1.6 pango_ft2_get_unknown_glyph ()PangoGlyph pango_ft2_get_unknown_glyph (PangoFont *font); Warning
Return the index of a glyph suitable for drawing unknown characters with
If you want to draw an unknown-box for a character that is not covered
by the font,
use
pango_ft2_font_get_kerning ()int pango_ft2_font_get_kerning (PangoFont *font, PangoGlyph left, PangoGlyph right); Warning
Retrieves kerning information for a combination of two glyphs.
Use
pango_ft2_font_get_face ()FT_Face pango_ft2_font_get_face (PangoFont *font); Warning
Returns the native FreeType2 FT_Face structure used for this PangoFont. This may be useful if you want to use FreeType2 functions directly.
Use
pango_ft2_font_get_coverage ()PangoCoverage* pango_ft2_font_get_coverage (PangoFont *font, PangoLanguage *language); Warning
Gets the PangoCoverage for a PangoFT2Font. Use
pango_ft2_font_map_for_display ()PangoFontMap* pango_ft2_font_map_for_display (void); Warning
Returns a PangoFT2FontMap. This font map is cached and should
not be freed. If the font map is no longer needed, it can
be released with
pango_ft2_shutdown_display ()void pango_ft2_shutdown_display (void); Warning
Free the global fontmap. (See
|