diff options
Diffstat (limited to 'pango/pangoxft-font.c')
| -rw-r--r-- | pango/pangoxft-font.c | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/pango/pangoxft-font.c b/pango/pangoxft-font.c index 2b1b6740..4e5dcb7b 100644 --- a/pango/pangoxft-font.c +++ b/pango/pangoxft-font.c @@ -19,6 +19,36 @@ * Boston, MA 02111-1307, USA. */ +/** + * SECTION:xft-fonts + * @short_description:Font handling and rendering with the Xft backend + * @title:Xft Fonts and Rendering + * + * The Xft library is a library for displaying fonts on the X window + * system; internally it uses the fontconfig library to locate font + * files, and the FreeType library to load and render fonts. The + * Xft backend is the recommended Pango font backend for screen + * display with X. (The <link linkend="pango-Cairo-Rendering">Cairo back end</link> is another possibility.) + * + * Using the Xft backend is generally straightforward; + * pango_xft_get_context() creates a context for a specified display + * and screen. You can then create a #PangoLayout with that context + * and render it with pango_xft_render_layout(). At a more advanced + * level, the low-level fontconfig options used for rendering fonts + * can be affected using pango_xft_set_default_substitute(), and + * pango_xft_substitute_changed(). + * + * A range of functions for drawing pieces of a layout, such as + * individual layout lines and glyphs strings are provided. You can also + * directly create a #PangoXftRenderer. Finally, in some advanced cases, it + * is useful to derive from #PangoXftRenderer. Deriving from + * #PangoXftRenderer is useful for two reasons. One reason is be to + * support custom attributes by overriding #PangoRendererClass virtual + * functions like 'prepare_run' or 'draw_shape'. The reason is to + * customize exactly how the final bits are drawn to the destination by + * overriding the #PangoXftRendererClass virtual functions + * 'composite_glyphs' and 'composite_trapezoids'. + */ #include "config.h" #include <stdlib.h> |