FreeType Fonts and Rendering

Name

FreeType Fonts and Rendering -- 

Synopsis



#define     PANGO_RENDER_TYPE_FT2
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_layout_line    (FT_Bitmap *bitmap,
                                             PangoLayoutLine *line,
                                             int x,
                                             int y);
void        pango_ft2_render_layout         (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);

Description

Details

PANGO_RENDER_TYPE_FT2

#define PANGO_RENDER_TYPE_FT2 "PangoRenderFT2"

A string constant identifying the FreeType renderer. The associated quark (see g_quark_from_string()) is used to identify the renderer in pango_find_map().


pango_ft2_get_context ()

PangoContext* pango_ft2_get_context         (double dpi_x,
                                             double dpi_y);

Retrieves a PangoContext appropriate for rendering with the PangoFT2 backend.

dpi_x :

the horizontal dpi of the target device

dpi_y :

the vertical dpi of the target device

Returns :

the new PangoContext


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.

bitmap :

the FreeType2 bitmap onto which to draw the string

font :

the font in which to draw the string

glyphs :

the glyph string to draw

x :

the x position of the start of the string (in pixels)

y :

the y position of the baseline (in pixels)


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

bitmap :

a FT_Bitmap to render the line onto

line :

a PangoLayoutLine

x :

the x position of start of string (in pixels)

y :

the y position of baseline (in pixels)


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

bitmap :

a FT_Bitmap to render the line onto

layout :

a PangoLayout

x :

the X position of the left of the layout (in pixels)

y :

the Y position of the top of the layout (in pixels)


pango_ft2_get_unknown_glyph ()

PangoGlyph  pango_ft2_get_unknown_glyph     (PangoFont *font);

Return the index of a glyph suitable for drawing unknown characters.

font :

a PangoFont

Returns :

a glyph index into font


pango_ft2_font_get_kerning ()

int         pango_ft2_font_get_kerning      (PangoFont *font,
                                             PangoGlyph left,
                                             PangoGlyph right);

Retrieves kerning information for a combination of two glyphs.

font :

a PangoFont

left :

the left PangoGlyph

right :

the right PangoGlyph

Returns :

The amount of kerning (in Pango units) to apply for the given combination of glyphs.


pango_ft2_font_get_face ()

FT_Face     pango_ft2_font_get_face         (PangoFont *font);

Returns the native FreeType2 FT_Face structure used for this PangoFont. This may be useful if you want to use FreeType2 functions directly.

font :

a PangoFont

Returns :

a pointer to a FT_Face structure, with the size set correctly


pango_ft2_font_get_coverage ()

PangoCoverage* pango_ft2_font_get_coverage  (PangoFont *font,
                                             PangoLanguage *language);

Should not be called directly, use pango_font_get_coverage() instead.

font :

a PangoFT2Font.

language :

a language tag.

Returns :

a PangoCoverage.


pango_ft2_font_map_for_display ()

PangoFontMap* pango_ft2_font_map_for_display
                                            (void);

Returns a PangoFT2FontMap. Font maps are cached and should not be freed. If the font map is no longer needed, it can be released with pango_ft2_shutdown_display().

Returns :

a PangoFT2FontMap.


pango_ft2_shutdown_display ()

void        pango_ft2_shutdown_display      (void);

Free cached resources.