docs/html/pango-X-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>Deprecated X font backend</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-ATSUI-Fonts.html" title="ATSUI Fonts">
  10 <link rel="next" href="lowlevel.html" title="Low Level Functionality">
  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-ATSUI-Fonts.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="lowlevel.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-X-Fonts-and-Rendering.synopsis" class="shortcut">Top</a>
  45                  |
  46                 <a href="#pango-X-Fonts-and-Rendering.description" class="shortcut">Description</a>
  47 </td></tr>
  48 </table>
  49 <div class="refentry" lang="en">
  50 <a name="pango-X-Fonts-and-Rendering"></a><div class="titlepage"></div>
  51 <div class="refnamediv"><table width="100%"><tr>
  52 <td valign="top">
  53 <h2><span class="refentrytitle"><a name="pango-X-Fonts-and-Rendering.top_of_page"></a>Deprecated X font backend</span></h2>
  54 <p>Deprecated X font backend — Font handling and rendering with the deprecated X font backend</p>
  55 </td>
  56 <td valign="top" align="right"></td>
  57 </tr></table></div>
  58 <div class="refsynopsisdiv">
  59 <a name="pango-X-Fonts-and-Rendering.synopsis"></a><h2>Synopsis</h2>
  60 <pre class="synopsis">
  61 #define             <a class="link" href="pango-X-Fonts-and-Rendering.html#PANGO-RENDER-TYPE-X--CAPS" title="PANGO_RENDER_TYPE_X">PANGO_RENDER_TYPE_X</a>
  62 <a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *      <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-get-context" title="pango_x_get_context ()">pango_x_get_context</a>                 (Display *display);
  63 void                <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-context-set-funcs" title="pango_x_context_set_funcs ()">pango_x_context_set_funcs</a>           (<a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
  64                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc" title="PangoGetGCFunc ()">PangoGetGCFunc</a> get_gc_func,
  65                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoFreeGCFunc" title="PangoFreeGCFunc ()">PangoFreeGCFunc</a> free_gc_func);
  66 GC                  (<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc" title="PangoGetGCFunc ()">*PangoGetGCFunc</a>)                   (<a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
  67                                                          <a class="link" href="pango-Text-Attributes.html#PangoColor" title="PangoColor">PangoColor</a> *color,
  68                                                          GC base_gc);
  69 void                (<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoFreeGCFunc" title="PangoFreeGCFunc ()">*PangoFreeGCFunc</a>)                  (<a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
  70                                                          GC gc);
  71 void                <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-render" title="pango_x_render ()">pango_x_render</a>                      (Display *display,
  72                                                          Drawable d,
  73                                                          GC gc,
  74                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
  75                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
  76                                                          <a
  77 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
  78 >gint</a> x,
  79                                                          <a
  80 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
  81 >gint</a> y);
  82 void                <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-render-layout-line" title="pango_x_render_layout_line ()">pango_x_render_layout_line</a>          (Display *display,
  83                                                          Drawable drawable,
  84                                                          GC gc,
  85                                                          <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine">PangoLayoutLine</a> *line,
  86                                                          int x,
  87                                                          int y);
  88 void                <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-render-layout" title="pango_x_render_layout ()">pango_x_render_layout</a>               (Display *display,
  89                                                          Drawable drawable,
  90                                                          GC gc,
  91                                                          <a class="link" href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
  92                                                          int x,
  93                                                          int y);
  94 typedef             <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a>;
  95 #define             <a class="link" href="pango-X-Fonts-and-Rendering.html#PANGO-X-MAKE-GLYPH--CAPS" title="PANGO_X_MAKE_GLYPH()">PANGO_X_MAKE_GLYPH</a>                  (subfont,index_)
  96 #define             <a class="link" href="pango-X-Fonts-and-Rendering.html#PANGO-X-GLYPH-SUBFONT--CAPS" title="PANGO_X_GLYPH_SUBFONT()">PANGO_X_GLYPH_SUBFONT</a>               (glyph)
  97 #define             <a class="link" href="pango-X-Fonts-and-Rendering.html#PANGO-X-GLYPH-INDEX--CAPS" title="PANGO_X_GLYPH_INDEX()">PANGO_X_GLYPH_INDEX</a>                 (glyph)
  98 <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *         <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-load-font" title="pango_x_load_font ()">pango_x_load_font</a>                   (Display *display,
  99                                                          const <a
 100 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 101 >gchar</a> *spec);
 102 <a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a>          <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-get-unknown-glyph" title="pango_x_get_unknown_glyph ()">pango_x_get_unknown_glyph</a>           (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
 103 <a
 104 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 105 >gboolean</a>            <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-has-glyph" title="pango_x_has_glyph ()">pango_x_has_glyph</a>                   (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 106                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a> glyph);
 107 int                 <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-list-subfonts" title="pango_x_list_subfonts ()">pango_x_list_subfonts</a>               (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 108                                                          char **charsets,
 109                                                          int n_charsets,
 110                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> **subfont_ids,
 111                                                          int **subfont_charsets);
 112 <a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *      <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-map-for-display" title="pango_x_font_map_for_display ()">pango_x_font_map_for_display</a>        (Display *display);
 113 void                <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-shutdown-display" title="pango_x_shutdown_display ()">pango_x_shutdown_display</a>            (Display *display);
 114 <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a> *   <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-map-get-font-cache" title="pango_x_font_map_get_font_cache ()">pango_x_font_map_get_font_cache</a>     (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *font_map);
 115 char *              <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-subfont-xlfd" title="pango_x_font_subfont_xlfd ()">pango_x_font_subfont_xlfd</a>           (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 116                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> subfont_id);
 117 <a
 118 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 119 >gboolean</a>            <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-find-first-subfont" title="pango_x_find_first_subfont ()">pango_x_find_first_subfont</a>          (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 120                                                          char **charsets,
 121                                                          int n_charsets,
 122                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> *rfont);
 123 <a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a>          <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-get-unknown-glyph" title="pango_x_font_get_unknown_glyph ()">pango_x_font_get_unknown_glyph</a>      (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 124                                                          <a
 125 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
 126 >gunichar</a> wc);
 127 <a
 128 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 129 >gboolean</a>            <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-apply-ligatures" title="pango_x_apply_ligatures ()">pango_x_apply_ligatures</a>             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 130                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> subfont,
 131                                                          <a
 132 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
 133 >gunichar</a> **glyphs,
 134                                                          int *n_glyphs,
 135                                                          int **clusters);
 136 void                <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-fallback-shape" title="pango_x_fallback_shape ()">pango_x_fallback_shape</a>              (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 137                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
 138                                                          const char *text,
 139                                                          int n_chars);
 140                     <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a>;
 141 <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a> *   <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-new" title="pango_x_font_cache_new ()">pango_x_font_cache_new</a>              (Display *display);
 142 void                <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-free" title="pango_x_font_cache_free ()">pango_x_font_cache_free</a>             (<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a> *cache);
 143 XFontStruct *       <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-load" title="pango_x_font_cache_load ()">pango_x_font_cache_load</a>             (<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a> *cache,
 144                                                          const char *xlfd);
 145 void                <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-unload" title="pango_x_font_cache_unload ()">pango_x_font_cache_unload</a>           (<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a> *cache,
 146                                                          XFontStruct *fs);
 147 </pre>
 148 </div>
 149 <div class="refsect1" lang="en">
 150 <a name="pango-X-Fonts-and-Rendering.description"></a><h2>Description</h2>
 151 <p>
 152 The functions and macros in this section are for use with the old
 153 X font backend which used server-side bitmap fonts. This font backend
 154 is no longer supported, and attempts to use it will produce
 155 unpredictable results. Use the <a class="link" href="pango-Xft-Fonts-and-Rendering.html" title="Xft Fonts and Rendering">Xft</a>
 156 or <a class="link" href="pango-Cairo-Rendering.html" title="Cairo Rendering">Cairo</a> backend instead.
 157 </p>
 158 </div>
 159 <div class="refsect1" lang="en">
 160 <a name="pango-X-Fonts-and-Rendering.details"></a><h2>Details</h2>
 161 <div class="refsect2" lang="en">
 162 <a name="PANGO-RENDER-TYPE-X--CAPS"></a><h3>PANGO_RENDER_TYPE_X</h3>
 163 <pre class="programlisting">#define PANGO_RENDER_TYPE_X "PangoRenderX"
 164 </pre>
 165 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 166 <h3 class="title">Warning</h3>
 167 <p><code class="literal">PANGO_RENDER_TYPE_X</code> is deprecated and should not be used in newly-written code.</p>
 168 </div>
 169 <p>
 170 A string constant identifying the X renderer. The associated quark (see
 171 <a
 172 href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#g-quark-from-string"
 173 ><code class="function">g_quark_from_string()</code></a>) is used to identify the renderer in <a class="link" href="pango-Modules.html#pango-find-map" title="pango_find_map ()"><code class="function">pango_find_map()</code></a>.
 174 </p>
 175 </div>
 176 <hr>
 177 <div class="refsect2" lang="en">
 178 <a name="pango-x-get-context"></a><h3>pango_x_get_context ()</h3>
 179 <pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *      pango_x_get_context                 (Display *display);</pre>
 180 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 181 <h3 class="title">Warning</h3>
 182 <p><code class="literal">pango_x_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-X-Fonts-and-Rendering.html#pango-x-font-map-for-display" title="pango_x_font_map_for_display ()"><code class="function">pango_x_font_map_for_display()</code></a> followed by
 183 <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>
 184 </div>
 185 <p>
 186 Retrieves a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> appropriate for rendering with X fonts on the
 187 given display.</p>
 188 <p>
 189 </p>
 190 <div class="variablelist"><table border="0">
 191 <col align="left" valign="top">
 192 <tbody>
 193 <tr>
 194 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 195 <td> an X display (As returned by <code class="function">XOpenDisplay()</code>.)
 196 </td>
 197 </tr>
 198 <tr>
 199 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 200 <td> the new <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
 201
 202 </td>
 203 </tr>
 204 </tbody>
 205 </table></div>
 206 </div>
 207 <hr>
 208 <div class="refsect2" lang="en">
 209 <a name="pango-x-context-set-funcs"></a><h3>pango_x_context_set_funcs ()</h3>
 210 <pre class="programlisting">void                pango_x_context_set_funcs           (<a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
 211                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc" title="PangoGetGCFunc ()">PangoGetGCFunc</a> get_gc_func,
 212                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoFreeGCFunc" title="PangoFreeGCFunc ()">PangoFreeGCFunc</a> free_gc_func);</pre>
 213 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 214 <h3 class="title">Warning</h3>
 215 <p><code class="literal">pango_x_context_set_funcs</code> is deprecated and should not be used in newly-written code.</p>
 216 </div>
 217 <p>
 218 Sets the functions that will be used to get GC's in various colors when
 219 rendering layouts with this context.</p>
 220 <p>
 221 </p>
 222 <div class="variablelist"><table border="0">
 223 <col align="left" valign="top">
 224 <tbody>
 225 <tr>
 226 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 227 <td> a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
 228 </td>
 229 </tr>
 230 <tr>
 231 <td><p><span class="term"><em class="parameter"><code>get_gc_func</code></em> :</span></p></td>
 232 <td> function called to create a new GC for a given color.
 233 </td>
 234 </tr>
 235 <tr>
 236 <td><p><span class="term"><em class="parameter"><code>free_gc_func</code></em> :</span></p></td>
 237 <td> function called to free a GC created with <em class="parameter"><code>get_gc_func</code></em>.
 238 </td>
 239 </tr>
 240 </tbody>
 241 </table></div>
 242 </div>
 243 <hr>
 244 <div class="refsect2" lang="en">
 245 <a name="PangoGetGCFunc"></a><h3>PangoGetGCFunc ()</h3>
 246 <pre class="programlisting">GC                  (*PangoGetGCFunc)                   (<a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
 247                                                          <a class="link" href="pango-Text-Attributes.html#PangoColor" title="PangoColor">PangoColor</a> *color,
 248                                                          GC base_gc);</pre>
 249 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 250 <h3 class="title">Warning</h3>
 251 <p><code class="literal">PangoGetGCFunc</code> is deprecated and should not be used in newly-written code.</p>
 252 </div>
 253 <p>
 254 Specifies the type of the function used to create a new GC for a given
 255 color.
 256 </p>
 257 <div class="variablelist"><table border="0">
 258 <col align="left" valign="top">
 259 <tbody>
 260 <tr>
 261 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 262 <td>a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
 263 </td>
 264 </tr>
 265 <tr>
 266 <td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
 267 <td>the color to create a new GC for.
 268 </td>
 269 </tr>
 270 <tr>
 271 <td><p><span class="term"><em class="parameter"><code>base_gc</code></em> :</span></p></td>
 272 <td>the GC to base the new GC on.
 273 </td>
 274 </tr>
 275 <tr>
 276 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 277 <td>the new GC.
 278 </td>
 279 </tr>
 280 </tbody>
 281 </table></div>
 282 </div>
 283 <hr>
 284 <div class="refsect2" lang="en">
 285 <a name="PangoFreeGCFunc"></a><h3>PangoFreeGCFunc ()</h3>
 286 <pre class="programlisting">void                (*PangoFreeGCFunc)                  (<a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
 287                                                          GC gc);</pre>
 288 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 289 <h3 class="title">Warning</h3>
 290 <p><code class="literal">PangoFreeGCFunc</code> is deprecated and should not be used in newly-written code.</p>
 291 </div>
 292 <p>
 293 Specifies the type of the function used to free a GC created with
 294 the corresponding <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc" title="PangoGetGCFunc ()"><span class="type">PangoGetGCFunc</span></a> function.
 295 </p>
 296 <div class="variablelist"><table border="0">
 297 <col align="left" valign="top">
 298 <tbody>
 299 <tr>
 300 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 301 <td>a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
 302 </td>
 303 </tr>
 304 <tr>
 305 <td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td>
 306 <td>the GC to free.
 307 </td>
 308 </tr>
 309 </tbody>
 310 </table></div>
 311 </div>
 312 <hr>
 313 <div class="refsect2" lang="en">
 314 <a name="pango-x-render"></a><h3>pango_x_render ()</h3>
 315 <pre class="programlisting">void                pango_x_render                      (Display *display,
 316                                                          Drawable d,
 317                                                          GC gc,
 318                                                          <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 319                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
 320                                                          <a
 321 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 322 >gint</a> x,
 323                                                          <a
 324 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 325 >gint</a> y);</pre>
 326 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 327 <h3 class="title">Warning</h3>
 328 <p><code class="literal">pango_x_render</code> is deprecated and should not be used in newly-written code.</p>
 329 </div>
 330 <p>
 331 Renders a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto an X drawable.</p>
 332 <p>
 333 </p>
 334 <div class="variablelist"><table border="0">
 335 <col align="left" valign="top">
 336 <tbody>
 337 <tr>
 338 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 339 <td> the X display.
 340 </td>
 341 </tr>
 342 <tr>
 343 <td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
 344 <td>       the drawable on which to draw string.
 345 </td>
 346 </tr>
 347 <tr>
 348 <td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td>
 349 <td>      the graphics context.
 350 </td>
 351 </tr>
 352 <tr>
 353 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 354 <td>    the font in which to draw the string.
 355 </td>
 356 </tr>
 357 <tr>
 358 <td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
 359 <td>  the glyph string to draw.
 360 </td>
 361 </tr>
 362 <tr>
 363 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
 364 <td>       the x position of start of string (in pixels).
 365 </td>
 366 </tr>
 367 <tr>
 368 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
 369 <td>       the y position of baseline (in pixels).
 370 </td>
 371 </tr>
 372 </tbody>
 373 </table></div>
 374 </div>
 375 <hr>
 376 <div class="refsect2" lang="en">
 377 <a name="pango-x-render-layout-line"></a><h3>pango_x_render_layout_line ()</h3>
 378 <pre class="programlisting">void                pango_x_render_layout_line          (Display *display,
 379                                                          Drawable drawable,
 380                                                          GC gc,
 381                                                          <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine">PangoLayoutLine</a> *line,
 382                                                          int x,
 383                                                          int y);</pre>
 384 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 385 <h3 class="title">Warning</h3>
 386 <p><code class="literal">pango_x_render_layout_line</code> is deprecated and should not be used in newly-written code.</p>
 387 </div>
 388 <p>
 389 Renders a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto an X drawable.</p>
 390 <p>
 391 </p>
 392 <div class="variablelist"><table border="0">
 393 <col align="left" valign="top">
 394 <tbody>
 395 <tr>
 396 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 397 <td>   the X display.
 398 </td>
 399 </tr>
 400 <tr>
 401 <td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td>
 402 <td>  the drawable on which to draw.
 403 </td>
 404 </tr>
 405 <tr>
 406 <td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td>
 407 <td>        GC to use for uncolored drawing.
 408 </td>
 409 </tr>
 410 <tr>
 411 <td><p><span class="term"><em class="parameter"><code>line</code></em> :</span></p></td>
 412 <td>      a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>.
 413 </td>
 414 </tr>
 415 <tr>
 416 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
 417 <td>         the x position of start of string (in pixels).
 418 </td>
 419 </tr>
 420 <tr>
 421 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
 422 <td>         the y position of baseline (in pixels).
 423 </td>
 424 </tr>
 425 </tbody>
 426 </table></div>
 427 </div>
 428 <hr>
 429 <div class="refsect2" lang="en">
 430 <a name="pango-x-render-layout"></a><h3>pango_x_render_layout ()</h3>
 431 <pre class="programlisting">void                pango_x_render_layout               (Display *display,
 432                                                          Drawable drawable,
 433                                                          GC gc,
 434                                                          <a class="link" href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
 435                                                          int x,
 436                                                          int y);</pre>
 437 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 438 <h3 class="title">Warning</h3>
 439 <p><code class="literal">pango_x_render_layout</code> is deprecated and should not be used in newly-written code.</p>
 440 </div>
 441 <p>
 442 Renders a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> onto an X drawable.</p>
 443 <p>
 444 </p>
 445 <div class="variablelist"><table border="0">
 446 <col align="left" valign="top">
 447 <tbody>
 448 <tr>
 449 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 450 <td>   the X display.
 451 </td>
 452 </tr>
 453 <tr>
 454 <td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td>
 455 <td>  the drawable on which to draw.
 456 </td>
 457 </tr>
 458 <tr>
 459 <td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td>
 460 <td>        GC to use for uncolored drawing.
 461 </td>
 462 </tr>
 463 <tr>
 464 <td><p><span class="term"><em class="parameter"><code>layout</code></em> :</span></p></td>
 465 <td>    a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.
 466 </td>
 467 </tr>
 468 <tr>
 469 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
 470 <td>         the x position of the left of the layout (in pixels).
 471 </td>
 472 </tr>
 473 <tr>
 474 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
 475 <td>         the y position of the top of the layout (in pixels).
 476 </td>
 477 </tr>
 478 </tbody>
 479 </table></div>
 480 </div>
 481 <hr>
 482 <div class="refsect2" lang="en">
 483 <a name="PangoXSubfont"></a><h3>PangoXSubfont</h3>
 484 <pre class="programlisting">typedef guint16 PangoXSubfont;
 485 </pre>
 486 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 487 <h3 class="title">Warning</h3>
 488 <p><code class="literal">PangoXSubfont</code> is deprecated and should not be used in newly-written code.</p>
 489 </div>
 490 <p>
 491 The <span class="type">PangoXSubFont</span> type is an integer ID that identifies one
 492 particular X font within the fonts referenced in a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 493 </p>
 494 </div>
 495 <hr>
 496 <div class="refsect2" lang="en">
 497 <a name="PANGO-X-MAKE-GLYPH--CAPS"></a><h3>PANGO_X_MAKE_GLYPH()</h3>
 498 <pre class="programlisting">#define PANGO_X_MAKE_GLYPH(subfont,index_) ((subfont)&lt;&lt;16 | (index_))
 499 </pre>
 500 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 501 <h3 class="title">Warning</h3>
 502 <p><code class="literal">PANGO_X_MAKE_GLYPH</code> is deprecated and should not be used in newly-written code.</p>
 503 </div>
 504 <p>
 505 Make a glyph index from a <span class="type">PangoXSubFont</span> index and a index
 506 of a character with the corresponding X font.
 507 </p>
 508 <div class="variablelist"><table border="0">
 509 <col align="left" valign="top">
 510 <tbody>
 511 <tr>
 512 <td><p><span class="term"><em class="parameter"><code>subfont</code></em> :</span></p></td>
 513 <td>a <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a> index
 514 </td>
 515 </tr>
 516 <tr>
 517 <td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
 518 <td>the index of a character within an X font.
 519 </td>
 520 </tr>
 521 </tbody>
 522 </table></div>
 523 </div>
 524 <hr>
 525 <div class="refsect2" lang="en">
 526 <a name="PANGO-X-GLYPH-SUBFONT--CAPS"></a><h3>PANGO_X_GLYPH_SUBFONT()</h3>
 527 <pre class="programlisting">#define PANGO_X_GLYPH_SUBFONT(glyph) ((glyph)&gt;&gt;16)
 528 </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_X_GLYPH_SUBFONT</code> is deprecated and should not be used in newly-written code.</p>
 532 </div>
 533 <p>
 534 Extract the subfont index from a glyph index.
 535 </p>
 536 <div class="variablelist"><table border="0">
 537 <col align="left" valign="top">
 538 <tbody><tr>
 539 <td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
 540 <td>a <span class="type">PangoGlyphIndex</span>
 541 </td>
 542 </tr></tbody>
 543 </table></div>
 544 </div>
 545 <hr>
 546 <div class="refsect2" lang="en">
 547 <a name="PANGO-X-GLYPH-INDEX--CAPS"></a><h3>PANGO_X_GLYPH_INDEX()</h3>
 548 <pre class="programlisting">#define PANGO_X_GLYPH_INDEX(glyph) ((glyph) &amp; 0xffff)
 549 </pre>
 550 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 551 <h3 class="title">Warning</h3>
 552 <p><code class="literal">PANGO_X_GLYPH_INDEX</code> is deprecated and should not be used in newly-written code.</p>
 553 </div>
 554 <p>
 555 Extract the character index within the X font from a
 556 glyph index.
 557 </p>
 558 <div class="variablelist"><table border="0">
 559 <col align="left" valign="top">
 560 <tbody><tr>
 561 <td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
 562 <td>a <span class="type">PangoGlyphIndex</span>
 563 </td>
 564 </tr></tbody>
 565 </table></div>
 566 </div>
 567 <hr>
 568 <div class="refsect2" lang="en">
 569 <a name="pango-x-load-font"></a><h3>pango_x_load_font ()</h3>
 570 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *         pango_x_load_font                   (Display *display,
 571                                                          const <a
 572 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 573 >gchar</a> *spec);</pre>
 574 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 575 <h3 class="title">Warning</h3>
 576 <p><code class="literal">pango_x_load_font</code> is deprecated and should not be used in newly-written code.</p>
 577 </div>
 578 <p>
 579 Loads up a logical font based on a "fontset" style text
 580 specification. This is not remotely useful (Pango API's generally
 581 work in terms of <a class="link" href="pango-Fonts.html#PangoFontDescription" title="PangoFontDescription"><span class="type">PangoFontDescription</span></a>) and the result may not
 582 work correctly in all circumstances. Use of this function should
 583 be avoided.</p>
 584 <p>
 585 </p>
 586 <div class="variablelist"><table border="0">
 587 <col align="left" valign="top">
 588 <tbody>
 589 <tr>
 590 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 591 <td> the X display.
 592 </td>
 593 </tr>
 594 <tr>
 595 <td><p><span class="term"><em class="parameter"><code>spec</code></em> :</span></p></td>
 596 <td>    a comma-separated list of XLFD's.
 597 </td>
 598 </tr>
 599 <tr>
 600 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 601 <td> a new <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 602 </td>
 603 </tr>
 604 </tbody>
 605 </table></div>
 606 </div>
 607 <hr>
 608 <div class="refsect2" lang="en">
 609 <a name="pango-x-get-unknown-glyph"></a><h3>pango_x_get_unknown_glyph ()</h3>
 610 <pre class="programlisting"><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a>          pango_x_get_unknown_glyph           (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
 611 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 612 <h3 class="title">Warning</h3>
 613 <p><code class="literal">pango_x_get_unknown_glyph</code> is deprecated and should not be used in newly-written code.</p>
 614 </div>
 615 <p>
 616 Returns the index of a glyph suitable for drawing unknown characters;
 617 you should generally 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,
 618 since that may return a glyph that provides a better representation
 619 of a particular char. (E.g., by showing hex digits, or a glyph
 620 representative of a certain Unicode range.)</p>
 621 <p>
 622 </p>
 623 <div class="variablelist"><table border="0">
 624 <col align="left" valign="top">
 625 <tbody>
 626 <tr>
 627 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 628 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 629 </td>
 630 </tr>
 631 <tr>
 632 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 633 <td> a glyph index into <em class="parameter"><code>font</code></em>.
 634 </td>
 635 </tr>
 636 </tbody>
 637 </table></div>
 638 </div>
 639 <hr>
 640 <div class="refsect2" lang="en">
 641 <a name="pango-x-has-glyph"></a><h3>pango_x_has_glyph ()</h3>
 642 <pre class="programlisting"><a
 643 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 644 >gboolean</a>            pango_x_has_glyph                   (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 645                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a> glyph);</pre>
 646 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 647 <h3 class="title">Warning</h3>
 648 <p><code class="literal">pango_x_has_glyph</code> is deprecated and should not be used in newly-written code.</p>
 649 </div>
 650 <p>
 651 Checks if the given glyph is present in a X font.</p>
 652 <p>
 653 </p>
 654 <div class="variablelist"><table border="0">
 655 <col align="left" valign="top">
 656 <tbody>
 657 <tr>
 658 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 659 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the X backend.
 660 </td>
 661 </tr>
 662 <tr>
 663 <td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
 664 <td> the index of a glyph in the font. (Formed
 665         using the <a class="link" href="pango-X-Fonts-and-Rendering.html#PANGO-X-MAKE-GLYPH--CAPS" title="PANGO_X_MAKE_GLYPH()"><span class="type">PANGO_X_MAKE_GLYPH</span></a> macro)
 666 </td>
 667 </tr>
 668 <tr>
 669 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 670 <td> <a
 671 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
 672 ><code class="literal">TRUE</code></a> if the glyph is present.
 673 </td>
 674 </tr>
 675 </tbody>
 676 </table></div>
 677 </div>
 678 <hr>
 679 <div class="refsect2" lang="en">
 680 <a name="pango-x-list-subfonts"></a><h3>pango_x_list_subfonts ()</h3>
 681 <pre class="programlisting">int                 pango_x_list_subfonts               (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 682                                                          char **charsets,
 683                                                          int n_charsets,
 684                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> **subfont_ids,
 685                                                          int **subfont_charsets);</pre>
 686 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 687 <h3 class="title">Warning</h3>
 688 <p><code class="literal">pango_x_list_subfonts</code> is deprecated and should not be used in newly-written code.</p>
 689 </div>
 690 <p>
 691 Lists the subfonts of a given font. The result is ordered first by charset,
 692 and then within each charset, by the order of fonts in the font specification.</p>
 693 <p>
 694 </p>
 695 <div class="variablelist"><table border="0">
 696 <col align="left" valign="top">
 697 <tbody>
 698 <tr>
 699 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 700 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 701 </td>
 702 </tr>
 703 <tr>
 704 <td><p><span class="term"><em class="parameter"><code>charsets</code></em> :</span></p></td>
 705 <td> the charsets to list subfonts for.
 706 </td>
 707 </tr>
 708 <tr>
 709 <td><p><span class="term"><em class="parameter"><code>n_charsets</code></em> :</span></p></td>
 710 <td> the number of charsets in <em class="parameter"><code>charsets</code></em>.
 711 </td>
 712 </tr>
 713 <tr>
 714 <td><p><span class="term"><em class="parameter"><code>subfont_ids</code></em> :</span></p></td>
 715 <td> location to store a pointer to an array of subfont IDs for each found subfont;
 716               the result must be freed using <a
 717 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
 718 ><code class="function">g_free()</code></a>.
 719 </td>
 720 </tr>
 721 <tr>
 722 <td><p><span class="term"><em class="parameter"><code>subfont_charsets</code></em> :</span></p></td>
 723 <td> location to store a pointer to an array of subfont IDs for each found subfont;
 724               the result must be freed using <a
 725 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
 726 ><code class="function">g_free()</code></a>.
 727 </td>
 728 </tr>
 729 <tr>
 730 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 731 <td> length of the arrays stored in <em class="parameter"><code>subfont_ids</code></em> and
 732 <em class="parameter"><code>subfont_charsets</code></em>.
 733 </td>
 734 </tr>
 735 </tbody>
 736 </table></div>
 737 </div>
 738 <hr>
 739 <div class="refsect2" lang="en">
 740 <a name="pango-x-font-map-for-display"></a><h3>pango_x_font_map_for_display ()</h3>
 741 <pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *      pango_x_font_map_for_display        (Display *display);</pre>
 742 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 743 <h3 class="title">Warning</h3>
 744 <p><code class="literal">pango_x_font_map_for_display</code> is deprecated and should not be used in newly-written code.</p>
 745 </div>
 746 <p>
 747 Returns a <span class="type">PangoXFontMap</span> for <em class="parameter"><code>display</code></em>. Font maps are cached and should
 748 not be freed. If the font map for a display is no longer needed, it can
 749 be released with <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-shutdown-display" title="pango_x_shutdown_display ()"><code class="function">pango_x_shutdown_display()</code></a>.</p>
 750 <p>
 751 </p>
 752 <div class="variablelist"><table border="0">
 753 <col align="left" valign="top">
 754 <tbody>
 755 <tr>
 756 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 757 <td> an X <span class="type">Display</span>.
 758 </td>
 759 </tr>
 760 <tr>
 761 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 762 <td> a <span class="type">PangoXFontMap</span> for <em class="parameter"><code>display</code></em>.
 763 </td>
 764 </tr>
 765 </tbody>
 766 </table></div>
 767 </div>
 768 <hr>
 769 <div class="refsect2" lang="en">
 770 <a name="pango-x-shutdown-display"></a><h3>pango_x_shutdown_display ()</h3>
 771 <pre class="programlisting">void                pango_x_shutdown_display            (Display *display);</pre>
 772 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 773 <h3 class="title">Warning</h3>
 774 <p><code class="literal">pango_x_shutdown_display</code> is deprecated and should not be used in newly-written code.</p>
 775 </div>
 776 <p>
 777 Free cached resources for the given X display structure.</p>
 778 <p>
 779 </p>
 780 <div class="variablelist"><table border="0">
 781 <col align="left" valign="top">
 782 <tbody><tr>
 783 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 784 <td> an X <span class="type">Display</span>
 785 </td>
 786 </tr></tbody>
 787 </table></div>
 788 </div>
 789 <hr>
 790 <div class="refsect2" lang="en">
 791 <a name="pango-x-font-map-get-font-cache"></a><h3>pango_x_font_map_get_font_cache ()</h3>
 792 <pre class="programlisting"><a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a> *   pango_x_font_map_get_font_cache     (<a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *font_map);</pre>
 793 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 794 <h3 class="title">Warning</h3>
 795 <p><code class="literal">pango_x_font_map_get_font_cache</code> is deprecated and should not be used in newly-written code.</p>
 796 </div>
 797 <p>
 798 Obtains the font cache associated with the given font map.</p>
 799 <p>
 800 </p>
 801 <div class="variablelist"><table border="0">
 802 <col align="left" valign="top">
 803 <tbody>
 804 <tr>
 805 <td><p><span class="term"><em class="parameter"><code>font_map</code></em> :</span></p></td>
 806 <td> a <span class="type">PangoXFontMap</span>.
 807 </td>
 808 </tr>
 809 <tr>
 810 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 811 <td> the <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache"><span class="type">PangoXFontCache</span></a> of <em class="parameter"><code>font_map</code></em>.
 812 </td>
 813 </tr>
 814 </tbody>
 815 </table></div>
 816 </div>
 817 <hr>
 818 <div class="refsect2" lang="en">
 819 <a name="pango-x-font-subfont-xlfd"></a><h3>pango_x_font_subfont_xlfd ()</h3>
 820 <pre class="programlisting">char *              pango_x_font_subfont_xlfd           (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 821                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> subfont_id);</pre>
 822 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 823 <h3 class="title">Warning</h3>
 824 <p><code class="literal">pango_x_font_subfont_xlfd</code> is deprecated and should not be used in newly-written code.</p>
 825 </div>
 826 <p>
 827 Determines the X Logical Font Description for the specified
 828 subfont.</p>
 829 <p>
 830 </p>
 831 <div class="variablelist"><table border="0">
 832 <col align="left" valign="top">
 833 <tbody>
 834 <tr>
 835 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 836 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the X backend.
 837 </td>
 838 </tr>
 839 <tr>
 840 <td><p><span class="term"><em class="parameter"><code>subfont_id</code></em> :</span></p></td>
 841 <td> the id of a subfont within the font.
 842 </td>
 843 </tr>
 844 <tr>
 845 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 846 <td> A newly-allocated string containing the XLFD for the
 847 subfont. This string must be freed with <a
 848 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
 849 ><code class="function">g_free()</code></a>.
 850 </td>
 851 </tr>
 852 </tbody>
 853 </table></div>
 854 </div>
 855 <hr>
 856 <div class="refsect2" lang="en">
 857 <a name="pango-x-find-first-subfont"></a><h3>pango_x_find_first_subfont ()</h3>
 858 <pre class="programlisting"><a
 859 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 860 >gboolean</a>            pango_x_find_first_subfont          (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 861                                                          char **charsets,
 862                                                          int n_charsets,
 863                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> *rfont);</pre>
 864 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 865 <h3 class="title">Warning</h3>
 866 <p><code class="literal">pango_x_find_first_subfont</code> is deprecated and should not be used in newly-written code.</p>
 867 </div>
 868 <p>
 869 Looks for subfonts with the <em class="parameter"><code>charset</code></em> charset,
 870 in <em class="parameter"><code>font</code></em>, and puts the first one in *<em class="parameter"><code>rfont</code></em>.</p>
 871 <p>
 872 </p>
 873 <div class="variablelist"><table border="0">
 874 <col align="left" valign="top">
 875 <tbody>
 876 <tr>
 877 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 878 <td> A <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 879 </td>
 880 </tr>
 881 <tr>
 882 <td><p><span class="term"><em class="parameter"><code>charsets</code></em> :</span></p></td>
 883 <td> An array of charsets.
 884 </td>
 885 </tr>
 886 <tr>
 887 <td><p><span class="term"><em class="parameter"><code>n_charsets</code></em> :</span></p></td>
 888 <td> The number of charsets in <em class="parameter"><code>charsets</code></em>.
 889 </td>
 890 </tr>
 891 <tr>
 892 <td><p><span class="term"><em class="parameter"><code>rfont</code></em> :</span></p></td>
 893 <td> A pointer to a <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a>.
 894 </td>
 895 </tr>
 896 <tr>
 897 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 898 <td> <a
 899 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
 900 ><code class="literal">TRUE</code></a> if *<em class="parameter"><code>rfont</code></em> now contains a font.
 901 </td>
 902 </tr>
 903 </tbody>
 904 </table></div>
 905 </div>
 906 <hr>
 907 <div class="refsect2" lang="en">
 908 <a name="pango-x-font-get-unknown-glyph"></a><h3>pango_x_font_get_unknown_glyph ()</h3>
 909 <pre class="programlisting"><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a>          pango_x_font_get_unknown_glyph      (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 910                                                          <a
 911 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
 912 >gunichar</a> wc);</pre>
 913 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 914 <h3 class="title">Warning</h3>
 915 <p><code class="literal">pango_x_font_get_unknown_glyph</code> is deprecated and should not be used in newly-written code.</p>
 916 </div>
 917 <p>
 918 Returns the index of a glyph suitable for drawing <em class="parameter"><code>wc</code></em> as an
 919 unknown character.
 920 </p>
 921 <p>
 922 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>
 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>font</code></em> :</span></p></td>
 930 <td> a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 931 </td>
 932 </tr>
 933 <tr>
 934 <td><p><span class="term"><em class="parameter"><code>wc</code></em> :</span></p></td>
 935 <td> the Unicode character for which a glyph is needed.
 936 </td>
 937 </tr>
 938 <tr>
 939 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 940 <td> a glyph index into <em class="parameter"><code>font</code></em>.
 941 </td>
 942 </tr>
 943 </tbody>
 944 </table></div>
 945 </div>
 946 <hr>
 947 <div class="refsect2" lang="en">
 948 <a name="pango-x-apply-ligatures"></a><h3>pango_x_apply_ligatures ()</h3>
 949 <pre class="programlisting"><a
 950 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 951 >gboolean</a>            pango_x_apply_ligatures             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 952                                                          <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> subfont,
 953                                                          <a
 954 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
 955 >gunichar</a> **glyphs,
 956                                                          int *n_glyphs,
 957                                                          int **clusters);</pre>
 958 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 959 <h3 class="title">Warning</h3>
 960 <p><code class="literal">pango_x_apply_ligatures</code> is deprecated and should not be used in newly-written code.</p>
 961 </div>
 962 <p>
 963 Previously did subfont-specific ligation. Now a no-op.</p>
 964 <p>
 965 </p>
 966 <div class="variablelist"><table border="0">
 967 <col align="left" valign="top">
 968 <tbody>
 969 <tr>
 970 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
 971 <td> unused
 972 </td>
 973 </tr>
 974 <tr>
 975 <td><p><span class="term"><em class="parameter"><code>subfont</code></em> :</span></p></td>
 976 <td> unused
 977 </td>
 978 </tr>
 979 <tr>
 980 <td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
 981 <td> unused
 982 </td>
 983 </tr>
 984 <tr>
 985 <td><p><span class="term"><em class="parameter"><code>n_glyphs</code></em> :</span></p></td>
 986 <td> unused
 987 </td>
 988 </tr>
 989 <tr>
 990 <td><p><span class="term"><em class="parameter"><code>clusters</code></em> :</span></p></td>
 991 <td> unused
 992 </td>
 993 </tr>
 994 <tr>
 995 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 996 <td> <a
 997 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
 998 ><code class="literal">FALSE</code></a>, always.
 999 </td>
1000 </tr>
1001 </tbody>
1002 </table></div>
1003 </div>
1004 <hr>
1005 <div class="refsect2" lang="en">
1006 <a name="pango-x-fallback-shape"></a><h3>pango_x_fallback_shape ()</h3>
1007 <pre class="programlisting">void                pango_x_fallback_shape              (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
1008                                                          <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
1009                                                          const char *text,
1010                                                          int n_chars);</pre>
1011 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1012 <h3 class="title">Warning</h3>
1013 <p><code class="literal">pango_x_fallback_shape</code> is deprecated and should not be used in newly-written code.</p>
1014 </div>
1015 <p>
1016 This is a simple fallback shaper, that can be used
1017 if no subfont that supports a given script is found.
1018 For every character in <em class="parameter"><code>text</code></em>, it puts the unknown glyph.</p>
1019 <p>
1020 </p>
1021 <div class="variablelist"><table border="0">
1022 <col align="left" valign="top">
1023 <tbody>
1024 <tr>
1025 <td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
1026 <td> A <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
1027 </td>
1028 </tr>
1029 <tr>
1030 <td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
1031 <td> A pointer to a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a>.
1032 </td>
1033 </tr>
1034 <tr>
1035 <td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
1036 <td> UTF-8 string.
1037 </td>
1038 </tr>
1039 <tr>
1040 <td><p><span class="term"><em class="parameter"><code>n_chars</code></em> :</span></p></td>
1041 <td> Number of UTF-8 seqs in <em class="parameter"><code>text</code></em>.
1042 </td>
1043 </tr>
1044 </tbody>
1045 </table></div>
1046 </div>
1047 <hr>
1048 <div class="refsect2" lang="en">
1049 <a name="PangoXFontCache"></a><h3>PangoXFontCache</h3>
1050 <pre class="programlisting">typedef struct _PangoXFontCache PangoXFontCache;</pre>
1051 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1052 <h3 class="title">Warning</h3>
1053 <p><code class="literal">PangoXFontCache</code> is deprecated and should not be used in newly-written code.</p>
1054 </div>
1055 <p>
1056 A <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache"><span class="type">PangoXFontCache</span></a> caches
1057 <span class="type">XFontStructs</span> for a single display by their XLFD name.
1058 </p>
1059 </div>
1060 <hr>
1061 <div class="refsect2" lang="en">
1062 <a name="pango-x-font-cache-new"></a><h3>pango_x_font_cache_new ()</h3>
1063 <pre class="programlisting"><a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a> *   pango_x_font_cache_new              (Display *display);</pre>
1064 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1065 <h3 class="title">Warning</h3>
1066 <p><code class="literal">pango_x_font_cache_new</code> is deprecated and should not be used in newly-written code.</p>
1067 </div>
1068 <p>
1069 Creates a font cache for the specified display.</p>
1070 <p>
1071 </p>
1072 <div class="variablelist"><table border="0">
1073 <col align="left" valign="top">
1074 <tbody>
1075 <tr>
1076 <td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
1077 <td> an X display.
1078 </td>
1079 </tr>
1080 <tr>
1081 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1082 <td> The newly allocated <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache"><span class="type">PangoXFontCache</span></a>, which should be
1083               freed with <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-free" title="pango_x_font_cache_free ()"><code class="function">pango_x_font_cache_free()</code></a>.
1084 </td>
1085 </tr>
1086 </tbody>
1087 </table></div>
1088 </div>
1089 <hr>
1090 <div class="refsect2" lang="en">
1091 <a name="pango-x-font-cache-free"></a><h3>pango_x_font_cache_free ()</h3>
1092 <pre class="programlisting">void                pango_x_font_cache_free             (<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a> *cache);</pre>
1093 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1094 <h3 class="title">Warning</h3>
1095 <p><code class="literal">pango_x_font_cache_free</code> is deprecated and should not be used in newly-written code.</p>
1096 </div>
1097 <p>
1098 Frees a <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache"><span class="type">PangoXFontCache</span></a> and all associated memory. All fonts loaded
1099 through this font cache will be freed along with the cache.</p>
1100 <p>
1101 </p>
1102 <div class="variablelist"><table border="0">
1103 <col align="left" valign="top">
1104 <tbody><tr>
1105 <td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
1106 <td> a <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache"><span class="type">PangoXFontCache</span></a>
1107 </td>
1108 </tr></tbody>
1109 </table></div>
1110 </div>
1111 <hr>
1112 <div class="refsect2" lang="en">
1113 <a name="pango-x-font-cache-load"></a><h3>pango_x_font_cache_load ()</h3>
1114 <pre class="programlisting">XFontStruct *       pango_x_font_cache_load             (<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a> *cache,
1115                                                          const char *xlfd);</pre>
1116 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1117 <h3 class="title">Warning</h3>
1118 <p><code class="literal">pango_x_font_cache_load</code> is deprecated and should not be used in newly-written code.</p>
1119 </div>
1120 <p>
1121 Loads a <span class="type">XFontStruct</span> from a X Logical Font Description. The
1122 result may be newly loaded, or it may have been previously
1123 stored.</p>
1124 <p>
1125 </p>
1126 <div class="variablelist"><table border="0">
1127 <col align="left" valign="top">
1128 <tbody>
1129 <tr>
1130 <td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
1131 <td> a <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache"><span class="type">PangoXFontCache</span></a>
1132 </td>
1133 </tr>
1134 <tr>
1135 <td><p><span class="term"><em class="parameter"><code>xlfd</code></em> :</span></p></td>
1136 <td> the X Logical Font Description to load.
1137 </td>
1138 </tr>
1139 <tr>
1140 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1141 <td> The font structure, or <a
1142 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1143 ><code class="literal">NULL</code></a> if the font could
1144 not be loaded. In order to free this structure, you must call
1145 <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-unload" title="pango_x_font_cache_unload ()"><code class="function">pango_x_font_cache_unload()</code></a>.
1146 </td>
1147 </tr>
1148 </tbody>
1149 </table></div>
1150 </div>
1151 <hr>
1152 <div class="refsect2" lang="en">
1153 <a name="pango-x-font-cache-unload"></a><h3>pango_x_font_cache_unload ()</h3>
1154 <pre class="programlisting">void                pango_x_font_cache_unload           (<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a> *cache,
1155                                                          XFontStruct *fs);</pre>
1156 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1157 <h3 class="title">Warning</h3>
1158 <p><code class="literal">pango_x_font_cache_unload</code> is deprecated and should not be used in newly-written code.</p>
1159 </div>
1160 <p>
1161 Frees a font structure previously loaded with <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-load" title="pango_x_font_cache_load ()"><code class="function">pango_x_font_cache_load()</code></a>.</p>
1162 <p>
1163 </p>
1164 <div class="variablelist"><table border="0">
1165 <col align="left" valign="top">
1166 <tbody>
1167 <tr>
1168 <td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
1169 <td> a <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache"><span class="type">PangoXFontCache</span></a>
1170 </td>
1171 </tr>
1172 <tr>
1173 <td><p><span class="term"><em class="parameter"><code>fs</code></em> :</span></p></td>
1174 <td> the font structure to unload
1175 </td>
1176 </tr>
1177 </tbody>
1178 </table></div>
1179 </div>
1180 </div>
1181 </div>
1182 <div class="footer">
1183 <hr>
1184           Generated by GTK-Doc V1.11</div>
1185 </body>
1186 </html>