docs/html/pango-Xft-Fonts-and-Rendering.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Xft Fonts and Rendering</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
   7 <link rel="home" href="index.html" title="Pango Reference Manual">
   8 <link rel="up" href="rendering.html" title="Rendering with Pango">
   9 <link rel="prev" href="pango-FreeType-Fonts-and-Rendering.html" title="FreeType Fonts and Rendering">
  10 <link rel="next" href="pango-Cairo-Rendering.html" title="Cairo Rendering">
  11 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 <link rel="chapter" href="pango.html" title="Basic Pango Interfaces">
  14 <link rel="chapter" href="rendering.html" title="Rendering with Pango">
  15 <link rel="chapter" href="lowlevel.html" title="Low Level Functionality">
  16 <link rel="chapter" href="tools.html" title="Pango Tools">
  17 <link rel="chapter" href="pango-hierarchy.html" title="Object Hierarchy">
  18 <link rel="index" href="index-all.html" title="Index">
  19 <link rel="index" href="index-deprecated.html" title="Index of deprecated symbols">
  20 <link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
  21 <link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
  22 <link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
  23 <link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
  24 <link rel="index" href="index-1.10.html" title="Index of new symbols in 1.10">
  25 <link rel="index" href="index-1.12.html" title="Index of new symbols in 1.12">
  26 <link rel="index" href="index-1.14.html" title="Index of new symbols in 1.14">
  27 <link rel="index" href="index-1.16.html" title="Index of new symbols in 1.16">
  28 <link rel="index" href="index-1.18.html" title="Index of new symbols in 1.18">
  29 <link rel="index" href="index-1.20.html" title="Index of new symbols in 1.20">
  30 <link rel="index" href="index-1.22.html" title="Index of new symbols in 1.22">
  31 <link rel="index" href="index-1.24.html" title="Index of new symbols in 1.24">
  32 <link rel="index" href="index-1.26.html" title="Index of new symbols in 1.26">
  33 </head>
  34 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  35 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  36 <tr valign="middle">
  37 <td><a accesskey="p" href="pango-FreeType-Fonts-and-Rendering.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  38 <td><a accesskey="u" href="rendering.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  39 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  40 <th width="100%" align="center">Pango Reference Manual</th>
  41 <td><a accesskey="n" href="pango-Cairo-Rendering.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  42 </tr>
  43 <tr><td colspan="5" class="shortcuts">
  44 <a href="#pango-Xft-Fonts-and-Rendering.synopsis" class="shortcut">Top</a>
  45                  |
  46                 <a href="#pango-Xft-Fonts-and-Rendering.description" class="shortcut">Description</a>
  47                  |
  48                 <a href="#pango-Xft-Fonts-and-Rendering.object-hierarchy" class="shortcut">Object Hierarchy</a>
  49                  |
  50                 <a href="#pango-Xft-Fonts-and-Rendering.properties" class="shortcut">Properties</a>
  51 </td></tr>
  52 </table>
  53 <div class="refentry" lang="en">
  54 <a name="pango-Xft-Fonts-and-Rendering"></a><div class="titlepage"></div>
  55 <div class="refnamediv"><table width="100%"><tr>
  56 <td valign="top">
  57 <h2><span class="refentrytitle"><a name="pango-Xft-Fonts-and-Rendering.top_of_page"></a>Xft Fonts and Rendering</span></h2>
  58 <p>Xft Fonts and Rendering — Font handling and rendering with the Xft backend</p>
  59 </td>
  60 <td valign="top" align="right"></td>
  61 </tr></table></div>
  62 <div class="refsynopsisdiv">
  63 <a name="pango-Xft-Fonts-and-Rendering.synopsis"></a><h2>Synopsis</h2>
  64 <a name="PangoXftFont"></a><a name="PangoXftFontMap"></a><a name="PangoXftRenderer"></a><pre class="synopsis">
  65                     <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftFont-struct" title="PangoXftFont">PangoXftFont</a>;
  66                     <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftFontMap-struct" title="PangoXftFontMap">PangoXftFontMap</a>;
  67 #define             <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PANGO-RENDER-TYPE-XFT--CAPS" title="PANGO_RENDER_TYPE_XFT">PANGO_RENDER_TYPE_XFT</a>
  68 <a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *      <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-get-context" title="pango_xft_get_context ()">pango_xft_get_context</a>               (Display *display,
  69                                                          int screen);
  70 <a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *      <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-get-font-map" title="pango_xft_get_font_map ()">pango_xft_get_font_map</a>              (Display *display,
  71                                                          int screen);
  72 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-set-default-substitute" title="pango_xft_set_default_substitute ()">pango_xft_set_default_substitute</a>    (Display *display,
  73                                                          int screen,
  74                                                          <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftSubstituteFunc" title="PangoXftSubstituteFunc ()">PangoXftSubstituteFunc</a> func,
  75                                                          <a
  76 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
  77 >gpointer</a> data,
  78                                                          <a
  79 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
  80 >GDestroyNotify</a> notify);
  81 void                (<a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftSubstituteFunc" title="PangoXftSubstituteFunc ()">*PangoXftSubstituteFunc</a>)           (FcPattern *pattern,
  82                                                          <a
  83 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
  84 >gpointer</a> data);
  85 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-substitute-changed" title="pango_xft_substitute_changed ()">pango_xft_substitute_changed</a>        (Display *display,
  86                                                          int screen);
  87 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-shutdown-display" title="pango_xft_shutdown_display ()">pango_xft_shutdown_display</a>          (Display *display,
  88                                                          int screen);
  89 XftFont *           <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-get-font" title="pango_xft_font_get_font ()">pango_xft_font_get_font</a>             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
  90 Display *           <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-get-display" title="pango_xft_font_get_display ()">pango_xft_font_get_display</a>          (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
  91 <a
  92 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
  93 >gboolean</a>            <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-has-char" title="pango_xft_font_has_char ()">pango_xft_font_has_char</a>             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
  94                                                          <a
  95 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
  96 >gunichar</a> wc);
  97 FT_Face             <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-lock-face" title="pango_xft_font_lock_face ()">pango_xft_font_lock_face</a>            (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
  98 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-unlock-face" title="pango_xft_font_unlock_face ()">pango_xft_font_unlock_face</a>          (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
  99 <a
 100 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
 101 >guint</a>               <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-get-glyph" title="pango_xft_font_get_glyph ()">pango_xft_font_get_glyph</a>            (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 102                                                          <a
 103 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
 104 >gunichar</a> wc);
 105 <a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a>          <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-get-unknown-glyph" title="pango_xft_font_get_unknown_glyph ()">pango_xft_font_get_unknown_glyph</a>    (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 106                                                          <a
 107 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
 108 >gunichar</a> wc);
 109                     <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer-struct" title="PangoXftRenderer">PangoXftRenderer</a>;
 110                     <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRendererClass" title="PangoXftRendererClass">PangoXftRendererClass</a>;
 111 <a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *     <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-renderer-new" title="pango_xft_renderer_new ()">pango_xft_renderer_new</a>              (Display *display,
 112                                                          int screen);
 113 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-renderer-set-draw" title="pango_xft_renderer_set_draw ()">pango_xft_renderer_set_draw</a>         (<a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer">PangoXftRenderer</a> *xftrenderer,
 114                                                          XftDraw *draw);
 115 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-renderer-set-default-color" title="pango_xft_renderer_set_default_color ()">pango_xft_renderer_set_default_color</a>
 116                                                         (<a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer">PangoXftRenderer</a> *xftrenderer,
 117                                                          <a class="link" href="pango-Text-Attributes.html#PangoColor" title="PangoColor">PangoColor</a> *default_color);
 118 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-render" title="pango_xft_render ()">pango_xft_render</a>                    (XftDraw *draw,
 119                                                          XftColor *color,
 120                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 121                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
 122                                                          <a
 123 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 124 >gint</a> x,
 125                                                          <a
 126 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 127 >gint</a> y);
 128 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-picture-render" title="pango_xft_picture_render ()">pango_xft_picture_render</a>            (Display *display,
 129                                                          Picture src_picture,
 130                                                          Picture dest_picture,
 131                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 132                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
 133                                                          <a
 134 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 135 >gint</a> x,
 136                                                          <a
 137 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 138 >gint</a> y);
 139 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-render-transformed" title="pango_xft_render_transformed ()">pango_xft_render_transformed</a>        (XftDraw *draw,
 140                                                          XftColor *color,
 141                                                          <a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="PangoMatrix">PangoMatrix</a> *matrix,
 142                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 143                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
 144                                                          int x,
 145                                                          int y);
 146 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-render-layout-line" title="pango_xft_render_layout_line ()">pango_xft_render_layout_line</a>        (XftDraw *draw,
 147                                                          XftColor *color,
 148                                                          <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine">PangoLayoutLine</a> *line,
 149                                                          int x,
 150                                                          int y);
 151 void                <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-render-layout" title="pango_xft_render_layout ()">pango_xft_render_layout</a>             (XftDraw *draw,
 152                                                          XftColor *color,
 153                                                          <a class="link" href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
 154                                                          int x,
 155                                                          int y);
 156 </pre>
 157 </div>
 158 <div class="refsect1" lang="en">
 159 <a name="pango-Xft-Fonts-and-Rendering.object-hierarchy"></a><h2>Object Hierarchy</h2>
 160 <pre class="synopsis">
 161   <a
 162 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 163 >GObject</a>
 164    +----<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a>
 165          +----<a class="link" href="PangoFcFont.html" title="PangoFcFont">PangoFcFont</a>
 166                +----PangoXftFont
 167 </pre>
 168 <pre class="synopsis">
 169   <a
 170 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 171 >GObject</a>
 172    +----<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>
 173          +----<a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a>
 174                +----PangoXftFontMap
 175 </pre>
 176 <pre class="synopsis">
 177   <a
 178 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 179 >GObject</a>
 180    +----<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a>
 181          +----PangoXftRenderer
 182 </pre>
 183 </div>
 184 <div class="refsect1" lang="en">
 185 <a name="pango-Xft-Fonts-and-Rendering.properties"></a><h2>Properties</h2>
 186 <pre class="synopsis">
 187   "<a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer--display" title='The "display" property'>display</a>"                  <a
 188 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
 189 >gpointer</a>              : Write / Construct Only
 190   "<a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer--screen" title='The "screen" property'>screen</a>"                   <a
 191 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 192 >gint</a>                  : Write / Construct Only
 193 </pre>
 194 </div>
 195 <div class="refsect1" lang="en">
 196 <a name="pango-Xft-Fonts-and-Rendering.description"></a><h2>Description</h2>
 197 <p>
 198 The Xft library is a library for displaying fonts on the X window
 199 system; internally it uses the fontconfig library to locate font
 200 files, and the FreeType library to load and render fonts. The
 201 Xft backend is the recommended Pango font backend for screen
 202 display with X. (The <a class="link" href="pango-Cairo-Rendering.html" title="Cairo Rendering">Cairo back end</a> is another possibility.)
 203 </p>
 204 <p>
 205 Using the Xft backend is generally straightforward;
 206 <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-get-context" title="pango_xft_get_context ()"><code class="function">pango_xft_get_context()</code></a> creates a context for a specified display
 207 and screen. You can then create a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> with that context
 208 and render it with <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-render-layout" title="pango_xft_render_layout ()"><code class="function">pango_xft_render_layout()</code></a>. At a more advanced
 209 level, the low-level fontconfig options used for rendering fonts
 210 can be affected using <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-set-default-substitute" title="pango_xft_set_default_substitute ()"><code class="function">pango_xft_set_default_substitute()</code></a>, and
 211 <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-substitute-changed" title="pango_xft_substitute_changed ()"><code class="function">pango_xft_substitute_changed()</code></a>.
 212 </p>
 213 <p>
 214 A range of functions for drawing pieces of a layout, such as
 215 individual layout lines and glyphs strings are provided.  You can also
 216 directly create a <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a>. Finally, in some advanced cases, it
 217 is useful to derive from <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a>. Deriving from
 218 <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a> is useful for two reasons. One reason is be to
 219 support custom attributes by overriding <a class="link" href="PangoRenderer.html#PangoRendererClass" title="PangoRendererClass"><span class="type">PangoRendererClass</span></a> virtual
 220 functions like 'prepare_run' or 'draw_shape'. The reason is to
 221 customize exactly how the final bits are drawn to the destination by
 222 overriding the <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRendererClass" title="PangoXftRendererClass"><span class="type">PangoXftRendererClass</span></a> virtual functions
 223 'composite_glyphs' and 'composite_trapezoids'.
 224 </p>
 225 </div>
 226 <div class="refsect1" lang="en">
 227 <a name="pango-Xft-Fonts-and-Rendering.details"></a><h2>Details</h2>
 228 <div class="refsect2" lang="en">
 229 <a name="PangoXftFont-struct"></a><h3>PangoXftFont</h3>
 230 <pre class="programlisting">typedef struct _PangoXftFont PangoXftFont;</pre>
 231 <p>
 232 <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftFont"><span class="type">PangoXftFont</span></a> is an implementation of <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> using the Xft
 233 library for rendering.  It is used in conjunction with <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftFontMap"><span class="type">PangoXftFontMap</span></a>.
 234 </p>
 235 </div>
 236 <hr>
 237 <div class="refsect2" lang="en">
 238 <a name="PangoXftFontMap-struct"></a><h3>PangoXftFontMap</h3>
 239 <pre class="programlisting">typedef struct _PangoXftFontMap PangoXftFontMap;</pre>
 240 <p>
 241 <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftFontMap"><span class="type">PangoXftFontMap</span></a> is an implementation of <a class="link" href="PangoFcFontMap.html" title="PangoFcFontMap"><span class="type">PangoFcFontMap</span></a> suitable for
 242 the Xft library as the renderer.  It is used in to create fonts of
 243 type <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftFont"><span class="type">PangoXftFont</span></a>.
 244 </p>
 245 </div>
 246 <hr>
 247 <div class="refsect2" lang="en">
 248 <a name="PANGO-RENDER-TYPE-XFT--CAPS"></a><h3>PANGO_RENDER_TYPE_XFT</h3>
 249 <pre class="programlisting">#define PANGO_RENDER_TYPE_XFT "PangoRenderXft"
 250 </pre>
 251 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 252 <h3 class="title">Warning</h3>
 253 <p><code class="literal">PANGO_RENDER_TYPE_XFT</code> is deprecated and should not be used in newly-written code.</p>
 254 </div>
 255 <p>
 256 A string constant that was used to identify shape engines that work
 257 with the Xft backend. See <a class="link" href="PangoFcFont.html#PANGO-RENDER-TYPE-FC--CAPS" title="PANGO_RENDER_TYPE_FC"><code class="literal">PANGO_RENDER_TYPE_FC</code></a> for the replacement.
 258 </p>
 259 </div>
 260 <hr>
 261 <div class="refsect2" lang="en">
 262 <a name="pango-xft-get-context"></a><h3>pango_xft_get_context ()</h3>
 263 <pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *      pango_xft_get_context               (Display *display,
 264                                                          int screen);</pre>
 265 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 266 <h3 class="title">Warning</h3>
 267 <p><code class="literal">pango_xft_get_context</code> has been deprecated since version 1.22 and should not be used in newly-written code. Use <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-get-font-map" title="pango_xft_get_font_map ()"><code class="function">pango_xft_get_font_map()</code></a> followed by
 268 <a class="link" href="pango-Fonts.html#pango-font-map-create-context" title="pango_font_map_create_context ()"><code class="function">pango_font_map_create_context()</code></a> instead.</p>
 269 </div>
 270 <p>
 271 Retrieves a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> appropriate for rendering with
 272 Xft fonts on the given screen of the given display.</p>
 273 <p>
 274 </p>
 275 <div class="variablelist"><table border="0">
 276 <col align="left" valign="top">
 277 <tbody>
 278 <tr>
 279 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 280 <td> an X display.
 281 </td>
 282 </tr>
 283 <tr>
 284 <td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
 285 <td> an X screen.
 286 </td>
 287 </tr>
 288 <tr>
 289 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 290 <td> the new <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
 291
 292 </td>
 293 </tr>
 294 </tbody>
 295 </table></div>
 296 </div>
 297 <hr>
 298 <div class="refsect2" lang="en">
 299 <a name="pango-xft-get-font-map"></a><h3>pango_xft_get_font_map ()</h3>
 300 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *      pango_xft_get_font_map              (Display *display,
 301                                                          int screen);</pre>
 302 <p>
 303 Returns the <span class="type">PangoXftFontmap</span> for the given display and screen.
 304 The fontmap is owned by Pango and will be valid until
 305 the display is closed.</p>
 306 <p>
 307 </p>
 308 <div class="variablelist"><table border="0">
 309 <col align="left" valign="top">
 310 <tbody>
 311 <tr>
 312 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 313 <td> an X display
 314 </td>
 315 </tr>
 316 <tr>
 317 <td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
 318 <td> the screen number of a screen within <em class="parameter"><code>display</code></em>
 319 </td>
 320 </tr>
 321 <tr>
 322 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 323 <td> a <a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> object, owned by Pango.
 324
 325 </td>
 326 </tr>
 327 </tbody>
 328 </table></div>
 329 <p class="since">Since 1.2</p>
 330 </div>
 331 <hr>
 332 <div class="refsect2" lang="en">
 333 <a name="pango-xft-set-default-substitute"></a><h3>pango_xft_set_default_substitute ()</h3>
 334 <pre class="programlisting">void                pango_xft_set_default_substitute    (Display *display,
 335                                                          int screen,
 336                                                          <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftSubstituteFunc" title="PangoXftSubstituteFunc ()">PangoXftSubstituteFunc</a> func,
 337                                                          <a
 338 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
 339 >gpointer</a> data,
 340                                                          <a
 341 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
 342 >GDestroyNotify</a> notify);</pre>
 343 <p>
 344 Sets a function that will be called to do final configuration
 345 substitution on a <span class="type">FcPattern</span> before it is used to load
 346 the font. This function can be used to do things like set
 347 hinting and antialiasing options.</p>
 348 <p>
 349 </p>
 350 <div class="variablelist"><table border="0">
 351 <col align="left" valign="top">
 352 <tbody>
 353 <tr>
 354 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 355 <td> an X Display
 356 </td>
 357 </tr>
 358 <tr>
 359 <td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
 360 <td> the screen number of a screen within <em class="parameter"><code>display</code></em>
 361 </td>
 362 </tr>
 363 <tr>
 364 <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
 365 <td> function to call to to do final config tweaking
 366        on <span class="type">FcPattern</span> objects.
 367 </td>
 368 </tr>
 369 <tr>
 370 <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
 371 <td> data to pass to <em class="parameter"><code>func</code></em>
 372 </td>
 373 </tr>
 374 <tr>
 375 <td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
 376 <td> function to call when <em class="parameter"><code>data</code></em> is no longer used.
 377 </td>
 378 </tr>
 379 </tbody>
 380 </table></div>
 381 <p class="since">Since 1.2</p>
 382 </div>
 383 <hr>
 384 <div class="refsect2" lang="en">
 385 <a name="PangoXftSubstituteFunc"></a><h3>PangoXftSubstituteFunc ()</h3>
 386 <pre class="programlisting">void                (*PangoXftSubstituteFunc)           (FcPattern *pattern,
 387                                                          <a
 388 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
 389 >gpointer</a> data);</pre>
 390 <p>
 391 Function type for doing final config tweaking on prepared FcPatterns.
 392 </p>
 393 <div class="variablelist"><table border="0">
 394 <col align="left" valign="top">
 395 <tbody>
 396 <tr>
 397 <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
 398 <td>the FcPattern to tweak.
 399 </td>
 400 </tr>
 401 <tr>
 402 <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
 403 <td>user data.
 404 </td>
 405 </tr>
 406 </tbody>
 407 </table></div>
 408 </div>
 409 <hr>
 410 <div class="refsect2" lang="en">
 411 <a name="pango-xft-substitute-changed"></a><h3>pango_xft_substitute_changed ()</h3>
 412 <pre class="programlisting">void                pango_xft_substitute_changed        (Display *display,
 413                                                          int screen);</pre>
 414 <p>
 415 Call this function any time the results of the
 416 default substitution function set with
 417 <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-set-default-substitute" title="pango_xft_set_default_substitute ()"><code class="function">pango_xft_set_default_substitute()</code></a> change.
 418 That is, if your substitution function will return different
 419 results for the same input pattern, you must call this function.</p>
 420 <p>
 421 </p>
 422 <div class="variablelist"><table border="0">
 423 <col align="left" valign="top">
 424 <tbody>
 425 <tr>
 426 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 427 <td> an X Display
 428 </td>
 429 </tr>
 430 <tr>
 431 <td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
 432 <td> the screen number of a screen within <em class="parameter"><code>display</code></em>
 433 </td>
 434 </tr>
 435 </tbody>
 436 </table></div>
 437 <p class="since">Since 1.2</p>
 438 </div>
 439 <hr>
 440 <div class="refsect2" lang="en">
 441 <a name="pango-xft-shutdown-display"></a><h3>pango_xft_shutdown_display ()</h3>
 442 <pre class="programlisting">void                pango_xft_shutdown_display          (Display *display,
 443                                                          int screen);</pre>
 444 <p>
 445 Release any resources that have been cached for the
 446 combination of <em class="parameter"><code>display</code></em> and <em class="parameter"><code>screen</code></em>. Note that when the
 447 X display is closed, resources are released automatically,
 448 without needing to call this function.</p>
 449 <p>
 450 </p>
 451 <div class="variablelist"><table border="0">
 452 <col align="left" valign="top">
 453 <tbody>
 454 <tr>
 455 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 456 <td> an X display
 457 </td>
 458 </tr>
 459 <tr>
 460 <td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
 461 <td> the screen number of a screen within <em class="parameter"><code>display</code></em>
 462 </td>
 463 </tr>
 464 </tbody>
 465 </table></div>
 466 <p class="since">Since 1.2</p>
 467 </div>
 468 <hr>
 469 <div class="refsect2" lang="en">
 470 <a name="pango-xft-font-get-font"></a><h3>pango_xft_font_get_font ()</h3>
 471 <pre class="programlisting">XftFont *           pango_xft_font_get_font             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
 472 <p>
 473 Returns the XftFont of a font.</p>
 474 <p>
 475 </p>
 476 <div class="variablelist"><table border="0">
 477 <col align="left" valign="top">
 478 <tbody>
 479 <tr>
 480 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 481 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 482 </td>
 483 </tr>
 484 <tr>
 485 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 486 <td> the XftFont associated to <em class="parameter"><code>font</code></em>, or <a
 487 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 488 ><code class="literal">NULL</code></a> if <em class="parameter"><code>font</code></em> is <a
 489 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 490 ><code class="literal">NULL</code></a>.
 491 </td>
 492 </tr>
 493 </tbody>
 494 </table></div>
 495 </div>
 496 <hr>
 497 <div class="refsect2" lang="en">
 498 <a name="pango-xft-font-get-display"></a><h3>pango_xft_font_get_display ()</h3>
 499 <pre class="programlisting">Display *           pango_xft_font_get_display          (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
 500 <p>
 501 Returns the X display of the XftFont of a font.</p>
 502 <p>
 503 </p>
 504 <div class="variablelist"><table border="0">
 505 <col align="left" valign="top">
 506 <tbody>
 507 <tr>
 508 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 509 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 510 </td>
 511 </tr>
 512 <tr>
 513 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 514 <td> the X display of the XftFont associated to <em class="parameter"><code>font</code></em>.
 515 </td>
 516 </tr>
 517 </tbody>
 518 </table></div>
 519 </div>
 520 <hr>
 521 <div class="refsect2" lang="en">
 522 <a name="pango-xft-font-has-char"></a><h3>pango_xft_font_has_char ()</h3>
 523 <pre class="programlisting"><a
 524 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 525 >gboolean</a>            pango_xft_font_has_char             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 526                                                          <a
 527 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
 528 >gunichar</a> wc);</pre>
 529 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 530 <h3 class="title">Warning</h3>
 531 <p><code class="literal">pango_xft_font_has_char</code> is deprecated and should not be used in newly-written code.</p>
 532 </div>
 533 <p>
 534 Determines whether <em class="parameter"><code>font</code></em> has a glyph for the codepoint <em class="parameter"><code>wc</code></em>.
 535 </p>
 536 <p>
 537 Use <a class="link" href="PangoFcFont.html#pango-fc-font-has-char" title="pango_fc_font_has_char ()"><code class="function">pango_fc_font_has_char()</code></a> instead.</p>
 538 <p>
 539 </p>
 540 <div class="variablelist"><table border="0">
 541 <col align="left" valign="top">
 542 <tbody>
 543 <tr>
 544 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 545 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> for the Xft backend
 546 </td>
 547 </tr>
 548 <tr>
 549 <td><p><span class="term"><em class="parameter"><code>wc</code></em> :</span></p></td>
 550 <td> Unicode codepoint to look up
 551 </td>
 552 </tr>
 553 <tr>
 554 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 555 <td> <a
 556 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
 557 ><code class="literal">TRUE</code></a> if <em class="parameter"><code>font</code></em> has the requested codepoint.
 558
 559 </td>
 560 </tr>
 561 </tbody>
 562 </table></div>
 563 <p class="since">Since 1.2</p>
 564 </div>
 565 <hr>
 566 <div class="refsect2" lang="en">
 567 <a name="pango-xft-font-lock-face"></a><h3>pango_xft_font_lock_face ()</h3>
 568 <pre class="programlisting">FT_Face             pango_xft_font_lock_face            (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
 569 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 570 <h3 class="title">Warning</h3>
 571 <p><code class="literal">pango_xft_font_lock_face</code> is deprecated and should not be used in newly-written code.</p>
 572 </div>
 573 <p>
 574 Gets the FreeType <span class="type">FT_Face</span> associated with a font,
 575 This face will be kept around until you call
 576 <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-unlock-face" title="pango_xft_font_unlock_face ()"><code class="function">pango_xft_font_unlock_face()</code></a>.
 577 </p>
 578 <p>
 579 Use <a class="link" href="PangoFcFont.html#pango-fc-font-lock-face" title="pango_fc_font_lock_face ()"><code class="function">pango_fc_font_lock_face()</code></a> instead.</p>
 580 <p>
 581 </p>
 582 <div class="variablelist"><table border="0">
 583 <col align="left" valign="top">
 584 <tbody>
 585 <tr>
 586 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 587 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 588 </td>
 589 </tr>
 590 <tr>
 591 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 592 <td> the FreeType <span class="type">FT_Face</span> associated with <em class="parameter"><code>font</code></em>.
 593
 594 </td>
 595 </tr>
 596 </tbody>
 597 </table></div>
 598 <p class="since">Since 1.2</p>
 599 </div>
 600 <hr>
 601 <div class="refsect2" lang="en">
 602 <a name="pango-xft-font-unlock-face"></a><h3>pango_xft_font_unlock_face ()</h3>
 603 <pre class="programlisting">void                pango_xft_font_unlock_face          (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
 604 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 605 <h3 class="title">Warning</h3>
 606 <p><code class="literal">pango_xft_font_unlock_face</code> is deprecated and should not be used in newly-written code.</p>
 607 </div>
 608 <p>
 609 Releases a font previously obtained with
 610 <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-lock-face" title="pango_xft_font_lock_face ()"><code class="function">pango_xft_font_lock_face()</code></a>.
 611 </p>
 612 <p>
 613 Use <a class="link" href="PangoFcFont.html#pango-fc-font-unlock-face" title="pango_fc_font_unlock_face ()"><code class="function">pango_fc_font_unlock_face()</code></a> instead.</p>
 614 <p>
 615 </p>
 616 <div class="variablelist"><table border="0">
 617 <col align="left" valign="top">
 618 <tbody><tr>
 619 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 620 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 621 </td>
 622 </tr></tbody>
 623 </table></div>
 624 <p class="since">Since 1.2</p>
 625 </div>
 626 <hr>
 627 <div class="refsect2" lang="en">
 628 <a name="pango-xft-font-get-glyph"></a><h3>pango_xft_font_get_glyph ()</h3>
 629 <pre class="programlisting"><a
 630 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
 631 >guint</a>               pango_xft_font_get_glyph            (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 632                                                          <a
 633 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
 634 >gunichar</a> wc);</pre>
 635 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 636 <h3 class="title">Warning</h3>
 637 <p><code class="literal">pango_xft_font_get_glyph</code> is deprecated and should not be used in newly-written code.</p>
 638 </div>
 639 <p>
 640 Gets the glyph index for a given Unicode character
 641 for <em class="parameter"><code>font</code></em>. If you only want to determine
 642 whether the font has the glyph, use <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-has-char" title="pango_xft_font_has_char ()"><code class="function">pango_xft_font_has_char()</code></a>.
 643 </p>
 644 <p>
 645 Use <a class="link" href="PangoFcFont.html#pango-fc-font-get-glyph" title="pango_fc_font_get_glyph ()"><code class="function">pango_fc_font_get_glyph()</code></a> instead.</p>
 646 <p>
 647 </p>
 648 <div class="variablelist"><table border="0">
 649 <col align="left" valign="top">
 650 <tbody>
 651 <tr>
 652 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 653 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> for the Xft backend
 654 </td>
 655 </tr>
 656 <tr>
 657 <td><p><span class="term"><em class="parameter"><code>wc</code></em> :</span></p></td>
 658 <td> Unicode codepoint to look up
 659 </td>
 660 </tr>
 661 <tr>
 662 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 663 <td> the glyph index, or 0, if the Unicode
 664  character does not exist in the font.
 665
 666 </td>
 667 </tr>
 668 </tbody>
 669 </table></div>
 670 <p class="since">Since 1.2</p>
 671 </div>
 672 <hr>
 673 <div class="refsect2" lang="en">
 674 <a name="pango-xft-font-get-unknown-glyph"></a><h3>pango_xft_font_get_unknown_glyph ()</h3>
 675 <pre class="programlisting"><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a>          pango_xft_font_get_unknown_glyph    (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 676                                                          <a
 677 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
 678 >gunichar</a> wc);</pre>
 679 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 680 <h3 class="title">Warning</h3>
 681 <p><code class="literal">pango_xft_font_get_unknown_glyph</code> is deprecated and should not be used in newly-written code.</p>
 682 </div>
 683 <p>
 684 Returns the index of a glyph suitable for drawing <em class="parameter"><code>wc</code></em> as an
 685 unknown character.
 686 </p>
 687 <p>
 688 Use <a class="link" href="pango-Glyph-Storage.html#PANGO-GET-UNKNOWN-GLYPH--CAPS" title="PANGO_GET_UNKNOWN_GLYPH()"><code class="function">PANGO_GET_UNKNOWN_GLYPH()</code></a> instead.</p>
 689 <p>
 690 </p>
 691 <div class="variablelist"><table border="0">
 692 <col align="left" valign="top">
 693 <tbody>
 694 <tr>
 695 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 696 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 697 </td>
 698 </tr>
 699 <tr>
 700 <td><p><span class="term"><em class="parameter"><code>wc</code></em> :</span></p></td>
 701 <td> the Unicode character for which a glyph is needed.
 702 </td>
 703 </tr>
 704 <tr>
 705 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 706 <td> a glyph index into <em class="parameter"><code>font</code></em>.
 707 </td>
 708 </tr>
 709 </tbody>
 710 </table></div>
 711 </div>
 712 <hr>
 713 <div class="refsect2" lang="en">
 714 <a name="PangoXftRenderer-struct"></a><h3>PangoXftRenderer</h3>
 715 <pre class="programlisting">typedef struct _PangoXftRenderer PangoXftRenderer;</pre>
 716 <p>
 717 <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a> is a subclass of <a class="link" href="PangoRenderer.html" title="PangoRenderer"><span class="type">PangoRenderer</span></a> used for rendering
 718 with Pango's Xft backend. It can be used directly, or it can be
 719 further subclassed to modify exactly how drawing of individual
 720 elements occurs.</p>
 721 <p>
 722 </p>
 723 <p class="since">Since 1.8</p>
 724 </div>
 725 <hr>
 726 <div class="refsect2" lang="en">
 727 <a name="PangoXftRendererClass"></a><h3>PangoXftRendererClass</h3>
 728 <pre class="programlisting">typedef struct {
 729   void (*composite_trapezoids) (PangoXftRenderer *xftrenderer,
 730                                 PangoRenderPart   part,
 731                                 XTrapezoid       *trapezoids,
 732                                 int               n_trapezoids);
 733   void (*composite_glyphs)     (PangoXftRenderer *xftrenderer,
 734                                 XftFont          *xft_font,
 735                                 XftGlyphSpec     *glyphs,
 736                                 int               n_glyphs);
 737 } PangoXftRendererClass;
 738 </pre>
 739 <p>
 740 The class structure for <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a></p>
 741 <p>
 742 </p>
 743 <div class="variablelist"><table border="0">
 744 <col align="left" valign="top">
 745 <tbody>
 746 <tr>
 747 <td><p><span class="term"><em class="structfield"><code>composite_trapezoids</code></em> ()</span></p></td>
 748 <td> draw the specified trapezoids using
 749   the current color and other attributes for <em class="parameter"><code>part</code></em>
 750 </td>
 751 </tr>
 752 <tr>
 753 <td><p><span class="term"><em class="structfield"><code>composite_glyphs</code></em> ()</span></p></td>
 754 <td> draw the specified glyphs using
 755   the current foreground color and other foreground
 756   attributes
 757 </td>
 758 </tr>
 759 </tbody>
 760 </table></div>
 761 <p class="since">Since 1.8</p>
 762 </div>
 763 <hr>
 764 <div class="refsect2" lang="en">
 765 <a name="pango-xft-renderer-new"></a><h3>pango_xft_renderer_new ()</h3>
 766 <pre class="programlisting"><a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *     pango_xft_renderer_new              (Display *display,
 767                                                          int screen);</pre>
 768 <p>
 769 Create a new <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a> to allow rendering Pango objects
 770 with the Xft library. You must call <a class="link" href="pango-Xft-Fonts-and-Rendering.html#pango-xft-renderer-set-draw" title="pango_xft_renderer_set_draw ()"><code class="function">pango_xft_renderer_set_draw()</code></a> before
 771 using the renderer.</p>
 772 <p>
 773 </p>
 774 <div class="variablelist"><table border="0">
 775 <col align="left" valign="top">
 776 <tbody>
 777 <tr>
 778 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 779 <td> an X display
 780 </td>
 781 </tr>
 782 <tr>
 783 <td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
 784 <td>   the index of the screen for <em class="parameter"><code>display</code></em> to which rendering will be done
 785 </td>
 786 </tr>
 787 <tr>
 788 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 789 <td> the newly created <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a>, which should
 790               be freed with <a
 791 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"
 792 ><code class="function">g_object_unref()</code></a>.
 793
 794 </td>
 795 </tr>
 796 </tbody>
 797 </table></div>
 798 <p class="since">Since 1.8</p>
 799 </div>
 800 <hr>
 801 <div class="refsect2" lang="en">
 802 <a name="pango-xft-renderer-set-draw"></a><h3>pango_xft_renderer_set_draw ()</h3>
 803 <pre class="programlisting">void                pango_xft_renderer_set_draw         (<a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer">PangoXftRenderer</a> *xftrenderer,
 804                                                          XftDraw *draw);</pre>
 805 <p>
 806 Sets the <span class="type">XftDraw</span> object that the renderer is drawing to.
 807 The renderer must not be currently active.</p>
 808 <p>
 809 </p>
 810 <div class="variablelist"><table border="0">
 811 <col align="left" valign="top">
 812 <tbody>
 813 <tr>
 814 <td><p><span class="term"><em class="parameter"><code>xftrenderer</code></em> :</span></p></td>
 815 <td> a <a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a>
 816 </td>
 817 </tr>
 818 <tr>
 819 <td><p><span class="term"><em class="parameter"><code>draw</code></em> :</span></p></td>
 820 <td> a <span class="type">XftDraw</span>
 821 </td>
 822 </tr>
 823 </tbody>
 824 </table></div>
 825 <p class="since">Since 1.8</p>
 826 </div>
 827 <hr>
 828 <div class="refsect2" lang="en">
 829 <a name="pango-xft-renderer-set-default-color"></a><h3>pango_xft_renderer_set_default_color ()</h3>
 830 <pre class="programlisting">void                pango_xft_renderer_set_default_color
 831                                                         (<a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer">PangoXftRenderer</a> *xftrenderer,
 832                                                          <a class="link" href="pango-Text-Attributes.html#PangoColor" title="PangoColor">PangoColor</a> *default_color);</pre>
 833 <p>
 834 Sets the default foreground color for a <span class="type">XftRenderer</span>.</p>
 835 <p>
 836 </p>
 837 <div class="variablelist"><table border="0">
 838 <col align="left" valign="top">
 839 <tbody>
 840 <tr>
 841 <td><p><span class="term"><em class="parameter"><code>xftrenderer</code></em> :</span></p></td>
 842 <td> a <span class="type">XftRenderer</span>
 843 </td>
 844 </tr>
 845 <tr>
 846 <td><p><span class="term"><em class="parameter"><code>default_color</code></em> :</span></p></td>
 847 <td> the default foreground color
 848 </td>
 849 </tr>
 850 </tbody>
 851 </table></div>
 852 <p class="since">Since 1.8</p>
 853 </div>
 854 <hr>
 855 <div class="refsect2" lang="en">
 856 <a name="pango-xft-render"></a><h3>pango_xft_render ()</h3>
 857 <pre class="programlisting">void                pango_xft_render                    (XftDraw *draw,
 858                                                          XftColor *color,
 859                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 860                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
 861                                                          <a
 862 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 863 >gint</a> x,
 864                                                          <a
 865 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 866 >gint</a> y);</pre>
 867 <p>
 868 Renders a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto an <span class="type">XftDraw</span> object wrapping an X drawable.</p>
 869 <p>
 870 </p>
 871 <div class="variablelist"><table border="0">
 872 <col align="left" valign="top">
 873 <tbody>
 874 <tr>
 875 <td><p><span class="term"><em class="parameter"><code>draw</code></em> :</span></p></td>
 876 <td>    the <span class="type">XftDraw</span> object.
 877 </td>
 878 </tr>
 879 <tr>
 880 <td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
 881 <td>   the color in which to draw the string
 882 </td>
 883 </tr>
 884 <tr>
 885 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 886 <td>    the font in which to draw the string
 887 </td>
 888 </tr>
 889 <tr>
 890 <td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
 891 <td>  the glyph string to draw
 892 </td>
 893 </tr>
 894 <tr>
 895 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
 896 <td>       the x position of start of string (in pixels)
 897 </td>
 898 </tr>
 899 <tr>
 900 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
 901 <td>       the y position of baseline (in pixels)
 902 </td>
 903 </tr>
 904 </tbody>
 905 </table></div>
 906 </div>
 907 <hr>
 908 <div class="refsect2" lang="en">
 909 <a name="pango-xft-picture-render"></a><h3>pango_xft_picture_render ()</h3>
 910 <pre class="programlisting">void                pango_xft_picture_render            (Display *display,
 911                                                          Picture src_picture,
 912                                                          Picture dest_picture,
 913                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 914                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
 915                                                          <a
 916 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 917 >gint</a> x,
 918                                                          <a
 919 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 920 >gint</a> y);</pre>
 921 <p>
 922 Renders a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto an Xrender <span class="type">Picture</span> object.</p>
 923 <p>
 924 </p>
 925 <div class="variablelist"><table border="0">
 926 <col align="left" valign="top">
 927 <tbody>
 928 <tr>
 929 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 930 <td>      an X display
 931 </td>
 932 </tr>
 933 <tr>
 934 <td><p><span class="term"><em class="parameter"><code>src_picture</code></em> :</span></p></td>
 935 <td>  the source picture to draw the string with
 936 </td>
 937 </tr>
 938 <tr>
 939 <td><p><span class="term"><em class="parameter"><code>dest_picture</code></em> :</span></p></td>
 940 <td> the destination picture to draw the string onto
 941 </td>
 942 </tr>
 943 <tr>
 944 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 945 <td>         the font in which to draw the string
 946 </td>
 947 </tr>
 948 <tr>
 949 <td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
 950 <td>       the glyph string to draw
 951 </td>
 952 </tr>
 953 <tr>
 954 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
 955 <td>            the x position of start of string (in pixels)
 956 </td>
 957 </tr>
 958 <tr>
 959 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
 960 <td>            the y position of baseline (in pixels)
 961 </td>
 962 </tr>
 963 </tbody>
 964 </table></div>
 965 </div>
 966 <hr>
 967 <div class="refsect2" lang="en">
 968 <a name="pango-xft-render-transformed"></a><h3>pango_xft_render_transformed ()</h3>
 969 <pre class="programlisting">void                pango_xft_render_transformed        (XftDraw *draw,
 970                                                          XftColor *color,
 971                                                          <a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="PangoMatrix">PangoMatrix</a> *matrix,
 972                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 973                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
 974                                                          int x,
 975                                                          int y);</pre>
 976 <p>
 977 Renders a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto a <span class="type">XftDraw</span>, possibly
 978 transforming the layed-out coordinates through a transformation
 979 matrix. Note that the transformation matrix for <em class="parameter"><code>font</code></em> is not
 980 changed, so to produce correct rendering results, the <em class="parameter"><code>font</code></em>
 981 must have been loaded using a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> with an identical
 982 transformation matrix to that passed in to this function.</p>
 983 <p>
 984 </p>
 985 <div class="variablelist"><table border="0">
 986 <col align="left" valign="top">
 987 <tbody>
 988 <tr>
 989 <td><p><span class="term"><em class="parameter"><code>draw</code></em> :</span></p></td>
 990 <td>    an <span class="type">XftDraw</span>
 991 </td>
 992 </tr>
 993 <tr>
 994 <td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
 995 <td>   the color in which to draw the glyphs
 996 </td>
 997 </tr>
 998 <tr>
 999 <td><p><span class="term"><em class="parameter"><code>matrix</code></em> :</span></p></td>
1000 <td>  a <a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="PangoMatrix"><span class="type">PangoMatrix</span></a>, or <a
1001 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1002 ><code class="literal">NULL</code></a> to use an identity transformation
1003 </td>
1004 </tr>
1005 <tr>
1006 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
1007 <td>    the font in which to draw the string
1008 </td>
1009 </tr>
1010 <tr>
1011 <td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
1012 <td>  the glyph string to draw
1013 </td>
1014 </tr>
1015 <tr>
1016 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
1017 <td>       the x position of the start of the string (in Pango
1018           units in user space coordinates)
1019 </td>
1020 </tr>
1021 <tr>
1022 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
1023 <td>       the y position of the baseline (in Pango units
1024           in user space coordinates)
1025 </td>
1026 </tr>
1027 </tbody>
1028 </table></div>
1029 <p class="since">Since 1.8</p>
1030 </div>
1031 <hr>
1032 <div class="refsect2" lang="en">
1033 <a name="pango-xft-render-layout-line"></a><h3>pango_xft_render_layout_line ()</h3>
1034 <pre class="programlisting">void                pango_xft_render_layout_line        (XftDraw *draw,
1035                                                          XftColor *color,
1036                                                          <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine">PangoLayoutLine</a> *line,
1037                                                          int x,
1038                                                          int y);</pre>
1039 <p>
1040 Render a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto a <span class="type">XftDraw</span></p>
1041 <p>
1042 </p>
1043 <div class="variablelist"><table border="0">
1044 <col align="left" valign="top">
1045 <tbody>
1046 <tr>
1047 <td><p><span class="term"><em class="parameter"><code>draw</code></em> :</span></p></td>
1048 <td>      an <span class="type">XftDraw</span>
1049 </td>
1050 </tr>
1051 <tr>
1052 <td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
1053 <td>     the foreground color in which to draw the layout line
1054             (may be overridden by color attributes)
1055 </td>
1056 </tr>
1057 <tr>
1058 <td><p><span class="term"><em class="parameter"><code>line</code></em> :</span></p></td>
1059 <td>      a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>
1060 </td>
1061 </tr>
1062 <tr>
1063 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
1064 <td>         the x position of start of string (in Pango units)
1065 </td>
1066 </tr>
1067 <tr>
1068 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
1069 <td>         the y position of baseline (in Pango units)
1070 </td>
1071 </tr>
1072 </tbody>
1073 </table></div>
1074 <p class="since">Since 1.8</p>
1075 </div>
1076 <hr>
1077 <div class="refsect2" lang="en">
1078 <a name="pango-xft-render-layout"></a><h3>pango_xft_render_layout ()</h3>
1079 <pre class="programlisting">void                pango_xft_render_layout             (XftDraw *draw,
1080                                                          XftColor *color,
1081                                                          <a class="link" href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
1082                                                          int x,
1083                                                          int y);</pre>
1084 <p>
1085 Render a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> onto a <span class="type">XftDraw</span></p>
1086 <p>
1087 </p>
1088 <div class="variablelist"><table border="0">
1089 <col align="left" valign="top">
1090 <tbody>
1091 <tr>
1092 <td><p><span class="term"><em class="parameter"><code>draw</code></em> :</span></p></td>
1093 <td>      an <span class="type">XftDraw</span>
1094 </td>
1095 </tr>
1096 <tr>
1097 <td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
1098 <td>     the foreground color in which to draw the layout
1099             (may be overridden by color attributes)
1100 </td>
1101 </tr>
1102 <tr>
1103 <td><p><span class="term"><em class="parameter"><code>layout</code></em> :</span></p></td>
1104 <td>    a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
1105 </td>
1106 </tr>
1107 <tr>
1108 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
1109 <td>         the X position of the left of the layout (in Pango units)
1110 </td>
1111 </tr>
1112 <tr>
1113 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
1114 <td>         the Y position of the top of the layout (in Pango units)
1115 </td>
1116 </tr>
1117 </tbody>
1118 </table></div>
1119 <p class="since">Since 1.8</p>
1120 </div>
1121 </div>
1122 <div class="refsect1" lang="en">
1123 <a name="pango-Xft-Fonts-and-Rendering.property-details"></a><h2>Property Details</h2>
1124 <div class="refsect2" lang="en">
1125 <a name="PangoXftRenderer--display"></a><h3>The <code class="literal">"display"</code> property</h3>
1126 <pre class="programlisting">  "display"                  <a
1127 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1128 >gpointer</a>              : Write / Construct Only</pre>
1129 <p>The display being rendered to.</p>
1130 </div>
1131 <hr>
1132 <div class="refsect2" lang="en">
1133 <a name="PangoXftRenderer--screen"></a><h3>The <code class="literal">"screen"</code> property</h3>
1134 <pre class="programlisting">  "screen"                   <a
1135 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1136 >gint</a>                  : Write / Construct Only</pre>
1137 <p>The screen being rendered to.</p>
1138 <p>Allowed values: &gt;= 0</p>
1139 <p>Default value: 0</p>
1140 </div>
1141 </div>
1142 </div>
1143 <div class="footer">
1144 <hr>
1145           Generated by GTK-Doc V1.11</div>
1146 </body>
1147 </html>