PangoXftFont

typedef struct _PangoXftFont PangoXftFont;

PangoXftFont is an implementation of PangoFcFont using the Xft library for rendering. It is used in conjunction with PangoXftFontMap.

PangoXftFontMap

typedef struct _PangoXftFontMap PangoXftFontMap;

PangoXftFontMap is an implementation of PangoFcFontMap suitable for the Xft library as the renderer. It is used in to create fonts of type PangoXftFont.

PANGO_RENDER_TYPE_XFT

#define PANGO_RENDER_TYPE_XFT "PangoRenderXft"

A string constant that was used to identify shape engines that work with the Xft backend. See PANGO_RENDER_TYPE_FC for the replacement.

pango_xft_get_context ()

PangoContext*       pango_xft_get_context               (Display *display,
                                                         int screen);

Retrieves a PangoContext appropriate for rendering with Xft fonts on the given screen of the given display.

pango_xft_get_font_map ()

PangoFontMap*       pango_xft_get_font_map              (Display *display,
                                                         int screen);

Returns the PangoXftFontmap for the given display and screen. The fontmap is owned by Pango and will be valid until the display is closed.

Since 1.2

pango_xft_set_default_substitute ()

void                pango_xft_set_default_substitute    (Display *display,
                                                         int screen,
                                                         PangoXftSubstituteFunc 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

PangoXftSubstituteFunc ()

void                (*PangoXftSubstituteFunc)           (FcPattern *pattern,
                                                         gpointer data);

Function type for doing final config tweaking on prepared FcPatterns.

pango_xft_substitute_changed ()

void                pango_xft_substitute_changed        (Display *display,
                                                         int screen);

Call this function any time the results of the default substitution function set with pango_xft_set_default_substitute() change. That is, if your substitution function will return different results for the same input pattern, you must call this function.

Since 1.2

pango_xft_shutdown_display ()

void                pango_xft_shutdown_display          (Display *display,
                                                         int screen);

Release any resources that have been cached for the combination of display and screen. Note that when the X display is closed, resources are released automatically, without needing to call this function.

Since 1.2

pango_xft_font_get_font ()

XftFont*            pango_xft_font_get_font             (PangoFont *font);

Returns the XftFont of a font.

pango_xft_font_get_display ()

Display*            pango_xft_font_get_display          (PangoFont *font);

Returns the X display of the XftFont of a font.

pango_xft_font_has_char ()

gboolean            pango_xft_font_has_char             (PangoFont *font,
                                                         gunichar wc);

Determines whether font has a glyph for the codepoint wc.

Use pango_fc_font_has_char() instead.

Since 1.2

pango_xft_font_lock_face ()

FT_Face             pango_xft_font_lock_face            (PangoFont *font);

Gets the FreeType FT_Face associated with a font, This face will be kept around until you call pango_xft_font_unlock_face().

Use pango_fc_font_lock_face() instead.

Since 1.2

pango_xft_font_unlock_face ()

void                pango_xft_font_unlock_face          (PangoFont *font);

Releases a font previously obtained with pango_xft_font_lock_face().

Use pango_fc_font_unlock_face() instead.

Since 1.2

pango_xft_font_get_glyph ()

guint               pango_xft_font_get_glyph            (PangoFont *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_xft_font_has_char().

Use pango_fc_font_get_glyph() instead.

Since 1.2

pango_xft_font_get_unknown_glyph ()

PangoGlyph          pango_xft_font_get_unknown_glyph    (PangoFont *font,
                                                         gunichar wc);

Returns the index of a glyph suitable for drawing wc as an unknown character.

Use PANGO_GET_UNKNOWN_GLYPH() instead.

PangoXftRenderer

typedef struct _PangoXftRenderer PangoXftRenderer;

PangoXftRenderer is a subclass of PangoRenderer used for rendering with Pango's Xft backend. It can be used directly, or it can be further subclassed to modify exactly how drawing of individual elements occurs.

Since 1.8

PangoXftRendererClass

typedef struct {
  void (*composite_trapezoids) (PangoXftRenderer *xftrenderer,
				PangoRenderPart   part,
				XTrapezoid       *trapezoids,
				int               n_trapezoids);
  void (*composite_glyphs)     (PangoXftRenderer *xftrenderer,
				XftFont          *xft_font,
				XftGlyphSpec     *glyphs,
				int               n_glyphs);
} PangoXftRendererClass;

The class structure for PangoXftRenderer

Since 1.8

pango_xft_renderer_new ()

PangoRenderer*      pango_xft_renderer_new              (Display *display,
                                                         int screen);

Create a new PangoXftRenderer to allow rendering Pango objects with the Xft library. You must call pango_xft_renderer_set_draw() before using the renderer.

Since 1.8

pango_xft_renderer_set_draw ()

void                pango_xft_renderer_set_draw         (PangoXftRenderer *xftrenderer,
                                                         XftDraw *draw);

Sets the XftDraw object that the renderer is drawing to. The renderer must not be currently active.

Since 1.8

pango_xft_renderer_set_default_color ()

void                pango_xft_renderer_set_default_color
                                                        (PangoXftRenderer *xftrenderer,
                                                         PangoColor *default_color);

Sets the default foreground color for a XftRenderer.

Since 1.8

pango_xft_render ()

void                pango_xft_render                    (XftDraw *draw,
                                                         XftColor *color,
                                                         PangoFont *font,
                                                         PangoGlyphString *glyphs,
                                                         gint x,
                                                         gint y);

Renders a PangoGlyphString onto an XftDraw object wrapping an X drawable.

pango_xft_picture_render ()

void                pango_xft_picture_render            (Display *display,
                                                         Picture src_picture,
                                                         Picture dest_picture,
                                                         PangoFont *font,
                                                         PangoGlyphString *glyphs,
                                                         gint x,
                                                         gint y);

Renders a PangoGlyphString onto an Xrender Picture object.

pango_xft_render_transformed ()

void                pango_xft_render_transformed        (XftDraw *draw,
                                                         XftColor *color,
                                                         PangoMatrix *matrix,
                                                         PangoFont *font,
                                                         PangoGlyphString *glyphs,
                                                         int x,
                                                         int y);

Renders a PangoGlyphString onto a XftDraw, possibly transforming the layed-out coordinates through a transformation matrix. Note that the transformation matrix for font is not changed, so to produce correct rendering results, the font must have been loaded using a PangoContext with an identical transformation matrix to that passed in to this function.

Since 1.8

pango_xft_render_layout_line ()

void                pango_xft_render_layout_line        (XftDraw *draw,
                                                         XftColor *color,
                                                         PangoLayoutLine *line,
                                                         int x,
                                                         int y);

Render a PangoLayoutLine onto a XftDraw

Since 1.8

pango_xft_render_layout ()

void                pango_xft_render_layout             (XftDraw *draw,
                                                         XftColor *color,
                                                         PangoLayout *layout,
                                                         int x,
                                                         int y);

Render a PangoLayout onto a XftDraw

Since 1.8

The "display" property

  "display"                  gpointer              : Write / Construct Only

The display being rendered to.

The "screen" property

  "screen"                   gint                  : Write / Construct Only

The screen being rendered to.

Allowed values: >= 0

Default value: 0