$szTitle = "PangoFcFont"; include "./_header.inc"; ?>
Pango Reference Manual | ||||
---|---|---|---|---|
PangoFcFont; PangoFcFontClass; #define PANGO_RENDER_TYPE_FC FT_Face pango_fc_font_lock_face (PangoFcFont *font); void pango_fc_font_unlock_face (PangoFcFont *font); gboolean pango_fc_font_has_char (PangoFcFont *font, gunichar wc); guint pango_fc_font_get_glyph (PangoFcFont *font, gunichar wc); PangoGlyph pango_fc_font_get_unknown_glyph (PangoFcFont *font, gunichar wc); void pango_fc_font_kern_glyphs (PangoFcFont *font, PangoGlyphString *glyphs);
PangoFcFont is a base class for font implementation using the Fontconfig and FreeType libraries. It is used in the Xft and FreeType backends shipped with Pango, but can also be used when creating new backends. Any backend deriving from this base class will take advantage of the wide range of shapers implemented using FreeType that come with Pango.
typedef struct _PangoFcFont PangoFcFont;
PangoFcFont is a base class for font implementations
using the Fontconfig and FreeType libraries and is used in
conjunction with PangoFcFontMap. When deriving from this
class, you need to implement all of its virtual functions
other than shutdown()
along with the get_glyph_extents()
virtual function from PangoFont.
typedef struct { FT_Face (*lock_face) (PangoFcFont *font); void (*unlock_face) (PangoFcFont *font); gboolean (*has_char) (PangoFcFont *font, gunichar wc); guint (*get_glyph) (PangoFcFont *font, gunichar wc); PangoGlyph (*get_unknown_glyph) (PangoFcFont *font, gunichar wc); void (*shutdown) (PangoFcFont *font); } PangoFcFontClass;
Class structure for PangoFcFont.
|
Returns the FT_Face of the font and increases the reference count for the face by one. |
|
Decreases the reference count for the FT_Face of the font by one. When the count is zero, the PangoFcFont subclass is allowed to free the FT_Face. |
|
Return TRUE if the the font contains a glyph
corresponding to the specified character.
|
|
Gets the glyph that corresponds to the given Unicode character. |
|
Gets the glyph that should be used to
display an unknown-glyph indication for the specified
Unicode character.
May be NULL .
|
|
Performs any font-specific shutdown code that
needs to be done when pango_fc_font_map_shutdown is called.
May be NULL .
|
#define PANGO_RENDER_TYPE_FC "PangoRenderFc"
A string constant used to identify shape engines that work
with the fontconfig based backends. See the engine_type
field
of PangoEngineInfo.
FT_Face pango_fc_font_lock_face (PangoFcFont *font);
Gets the FreeType FT_Face associated with a font,
This face will be kept around until you call
pango_fc_font_unlock_face()
.
|
a PangoFcFont. |
Returns : |
the FreeType FT_Face associated with font .
|
Since 1.4
void pango_fc_font_unlock_face (PangoFcFont *font);
Releases a font previously obtained with
pango_fc_font_lock_face()
.
|
a PangoFcFont. |
Since 1.4
gboolean pango_fc_font_has_char (PangoFcFont *font, gunichar wc);
Determines whether font
has a glyph for the codepoint wc
.
|
a PangoFcFont |
|
Unicode codepoint to look up |
Returns : |
TRUE if font has the requested codepoint.
|
Since 1.4
guint pango_fc_font_get_glyph (PangoFcFont *font, gunichar wc);
Gets the glyph index for a given Unicode character
for font
. If you only want to determine
whether the font has the glyph, use pango_fc_font_has_char()
.
|
a PangoFcFont |
|
Unicode character to look up |
Returns : |
the glyph index, or 0, if the Unicode character doesn't exist in the font. |
Since 1.4
PangoGlyph pango_fc_font_get_unknown_glyph (PangoFcFont *font, gunichar wc);
pango_fc_font_get_unknown_glyph
is deprecated and should not be used in newly-written code.
Returns the index of a glyph suitable for drawing wc
as an
unknown character.
Use PANGO_GET_UNKNOWN_GLYPH()
instead.
|
a PangoFcFont |
|
the Unicode character for which a glyph is needed. |
Returns : |
a glyph index into font .
|
Since 1.4
void pango_fc_font_kern_glyphs (PangoFcFont *font, PangoGlyphString *glyphs);
Adjust each adjacent pair of glyphs in glyphs
according to
kerning information in font
.
|
a PangoFcFont |
|
a PangoGlyphString |
Since 1.4
The base class for font maps; creating a new Fontconfig-based backend involves deriving from both PangoFcFontMap and PangoFcFont. . |