← Back to branch summary

~ubuntu-branches/ubuntu/trusty/pango1.0/trusty

« back to all changes in this revision

Viewing changes to docs/html/pango-X-Fonts-and-Rendering.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2009-03-22 15:11:40 UTC
  • mfrom: (1.2.58 upstream)
  • Revision ID: james.westby@ubuntu.com-20090322151140-82q75bew60hvjxyg
Tags: 1.24.0-1
* New upstream release:
  + debian/patches/90_relibtoolize.patch:
    - Updated for the new version.
  + debian/control.in:
    - Update build dependencies.
  + debian/rules,
    debian/libpango1.0-0.symbols:
    - Update for API additions.
* debian/patches/13_pango-view-undefined-references.patch:
  + Fix linking of pango-view for the udeb.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/html/pango-X-Fonts-and-Rendering.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>Deprecated X font backend</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.2">
7
7
<link rel="home" href="index.html" title="Pango Reference Manual">
8
8
<link rel="up" href="rendering.html" title="Rendering with Pango">
9
9
<link rel="prev" href="pango-ATSUI-Fonts.html" title="ATSUI Fonts">
10
10
<link rel="next" href="lowlevel.html" title="Low Level Functionality">
11
 
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="pango.html" title="Basic Pango Interfaces">
14
14
<link rel="chapter" href="rendering.html" title="Rendering with Pango">
38
38
<th width="100%" align="center">Pango Reference Manual</th>
39
39
<td><a accesskey="n" href="lowlevel.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
40
40
</tr>
41
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#pango-X-Fonts-and-Rendering.synopsis" class="shortcut">Top</a>
42
 
                   | 
43
 
                  <a href="#pango-X-Fonts-and-Rendering.description" class="shortcut">Description</a></nobr></td></tr>
 
41
<tr><td colspan="5" class="shortcuts">
 
42
<a href="#pango-X-Fonts-and-Rendering.synopsis" class="shortcut">Top</a>
 
43
                 | 
 
44
                <a href="#pango-X-Fonts-and-Rendering.description" class="shortcut">Description</a>
 
45
</td></tr>
44
46
</table>
45
47
<div class="refentry" lang="en">
46
48
<a name="pango-X-Fonts-and-Rendering"></a><div class="titlepage"></div>
54
56
<div class="refsynopsisdiv">
55
57
<a name="pango-X-Fonts-and-Rendering.synopsis"></a><h2>Synopsis</h2>
56
58
<pre class="synopsis">
57
 
#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>
58
 
<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);
 
59
#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>
 
60
<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);
59
61
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,
60
62
                                                         <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc" title="PangoGetGCFunc ()">PangoGetGCFunc</a> get_gc_func,
61
63
                                                         <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoFreeGCFunc" title="PangoFreeGCFunc ()">PangoFreeGCFunc</a> free_gc_func);
70
72
                                                         <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
71
73
                                                         <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
72
74
                                                         <a
73
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
 
75
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
74
76
>gint</a> x,
75
77
                                                         <a
76
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
 
78
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
77
79
>gint</a> y);
78
80
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,
79
81
                                                         Drawable drawable,
88
90
                                                         int x,
89
91
                                                         int y);
90
92
typedef             <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a>;
91
 
#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_)
92
 
#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)
93
 
#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)
94
 
<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,
 
93
#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_)
 
94
#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)
 
95
#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)
 
96
<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,
95
97
                                                         const <a
96
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
 
98
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
97
99
>gchar</a> *spec);
98
100
<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);
99
101
<a
100
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
102
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
101
103
>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,
102
104
                                                         <a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a> glyph);
103
105
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,
105
107
                                                         int n_charsets,
106
108
                                                         <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> **subfont_ids,
107
109
                                                         int **subfont_charsets);
108
 
<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);
 
110
<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);
109
111
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);
110
 
<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);
111
 
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,
 
112
<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);
 
113
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,
112
114
                                                         <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> subfont_id);
113
115
<a
114
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
116
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
115
117
>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,
116
118
                                                         char **charsets,
117
119
                                                         int n_charsets,
118
120
                                                         <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> *rfont);
119
121
<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,
120
122
                                                         <a
121
 
href="/usr/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
 
123
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
122
124
>gunichar</a> wc);
123
125
<a
124
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
126
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
125
127
>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,
126
128
                                                         <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> subfont,
127
129
                                                         <a
128
 
href="/usr/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
 
130
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
129
131
>gunichar</a> **glyphs,
130
132
                                                         int *n_glyphs,
131
133
                                                         int **clusters);
134
136
                                                         const char *text,
135
137
                                                         int n_chars);
136
138
                    <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a>;
137
 
<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);
 
139
<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);
138
140
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);
139
 
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,
 
141
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,
140
142
                                                         const char *xlfd);
141
143
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,
142
144
                                                         XFontStruct *fs);
155
157
<div class="refsect1" lang="en">
156
158
<a name="pango-X-Fonts-and-Rendering.details"></a><h2>Details</h2>
157
159
<div class="refsect2" lang="en">
158
 
<a name="PANGO-RENDER-TYPE-X:CAPS"></a><h3>PANGO_RENDER_TYPE_X</h3>
 
160
<a name="PANGO-RENDER-TYPE-X--CAPS"></a><h3>PANGO_RENDER_TYPE_X</h3>
159
161
<pre class="programlisting">#define PANGO_RENDER_TYPE_X "PangoRenderX"
160
162
</pre>
161
163
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
163
165
<p><code class="literal">PANGO_RENDER_TYPE_X</code> is deprecated and should not be used in newly-written code.</p>
164
166
</div>
165
167
<p>
166
 
A string constant identifying the X renderer. The associated quark (see 
 
168
A string constant identifying the X renderer. The associated quark (see
167
169
<a
168
 
href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#g-quark-from-string"
169
 
><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>. 
 
170
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Quarks.html#g-quark-from-string"
 
171
><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>.
170
172
</p>
171
173
</div>
172
174
<hr>
173
175
<div class="refsect2" lang="en">
174
176
<a name="pango-x-get-context"></a><h3>pango_x_get_context ()</h3>
175
 
<pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a>*       pango_x_get_context                 (Display *display);</pre>
 
177
<pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext">PangoContext</a> *      pango_x_get_context                 (Display *display);</pre>
176
178
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
177
179
<h3 class="title">Warning</h3>
178
180
<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
182
184
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
183
185
given display.</p>
184
186
<p>
185
 
 
186
187
</p>
187
188
<div class="variablelist"><table border="0">
188
189
<col align="left" valign="top">
215
216
Sets the functions that will be used to get GC's in various colors when
216
217
rendering layouts with this context.</p>
217
218
<p>
218
 
 
219
219
</p>
220
220
<div class="variablelist"><table border="0">
221
221
<col align="left" valign="top">
250
250
</div>
251
251
<p>
252
252
Specifies the type of the function used to create a new GC for a given
253
 
color. 
 
253
color.
254
254
</p>
255
255
<div class="variablelist"><table border="0">
256
256
<col align="left" valign="top">
273
273
<tr>
274
274
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
275
275
<td>the new GC.
276
 
 
277
 
 
278
276
</td>
279
277
</tr>
280
278
</tbody>
290
288
<p><code class="literal">PangoFreeGCFunc</code> is deprecated and should not be used in newly-written code.</p>
291
289
</div>
292
290
<p>
293
 
Specifies the type of the function used to free a GC created with 
 
291
Specifies the type of the function used to free a GC created with
294
292
the corresponding <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc" title="PangoGetGCFunc ()"><span class="type">PangoGetGCFunc</span></a> function.
295
293
</p>
296
294
<div class="variablelist"><table border="0">
304
302
<tr>
305
303
<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td>
306
304
<td>the GC to free.
307
 
 
308
 
 
309
305
</td>
310
306
</tr>
311
307
</tbody>
320
316
                                                         <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
321
317
                                                         <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString">PangoGlyphString</a> *glyphs,
322
318
                                                         <a
323
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
 
319
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
324
320
>gint</a> x,
325
321
                                                         <a
326
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
 
322
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
327
323
>gint</a> y);</pre>
328
324
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
329
325
<h3 class="title">Warning</h3>
332
328
<p>
333
329
Renders a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto an X drawable.</p>
334
330
<p>
335
 
 
336
331
</p>
337
332
<div class="variablelist"><table border="0">
338
333
<col align="left" valign="top">
391
386
<p>
392
387
Renders a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto an X drawable.</p>
393
388
<p>
394
 
 
395
389
</p>
396
390
<div class="variablelist"><table border="0">
397
391
<col align="left" valign="top">
445
439
<p>
446
440
Renders a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> onto an X drawable.</p>
447
441
<p>
448
 
 
449
442
</p>
450
443
<div class="variablelist"><table border="0">
451
444
<col align="left" valign="top">
499
492
</div>
500
493
<hr>
501
494
<div class="refsect2" lang="en">
502
 
<a name="PANGO-X-MAKE-GLYPH:CAPS"></a><h3>PANGO_X_MAKE_GLYPH()</h3>
 
495
<a name="PANGO-X-MAKE-GLYPH--CAPS"></a><h3>PANGO_X_MAKE_GLYPH()</h3>
503
496
<pre class="programlisting">#define PANGO_X_MAKE_GLYPH(subfont,index_) ((subfont)&lt;&lt;16 | (index_))
504
497
</pre>
505
498
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
521
514
<tr>
522
515
<td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
523
516
<td>the index of a character within an X font.
524
 
 
525
 
 
526
517
</td>
527
518
</tr>
528
519
</tbody>
530
521
</div>
531
522
<hr>
532
523
<div class="refsect2" lang="en">
533
 
<a name="PANGO-X-GLYPH-SUBFONT:CAPS"></a><h3>PANGO_X_GLYPH_SUBFONT()</h3>
 
524
<a name="PANGO-X-GLYPH-SUBFONT--CAPS"></a><h3>PANGO_X_GLYPH_SUBFONT()</h3>
534
525
<pre class="programlisting">#define PANGO_X_GLYPH_SUBFONT(glyph) ((glyph)&gt;&gt;16)
535
526
</pre>
536
527
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
545
536
<tbody><tr>
546
537
<td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
547
538
<td>a <span class="type">PangoGlyphIndex</span>
548
 
 
549
 
 
550
539
</td>
551
540
</tr></tbody>
552
541
</table></div>
553
542
</div>
554
543
<hr>
555
544
<div class="refsect2" lang="en">
556
 
<a name="PANGO-X-GLYPH-INDEX:CAPS"></a><h3>PANGO_X_GLYPH_INDEX()</h3>
 
545
<a name="PANGO-X-GLYPH-INDEX--CAPS"></a><h3>PANGO_X_GLYPH_INDEX()</h3>
557
546
<pre class="programlisting">#define PANGO_X_GLYPH_INDEX(glyph) ((glyph) &amp; 0xffff)
558
547
</pre>
559
548
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
569
558
<tbody><tr>
570
559
<td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
571
560
<td>a <span class="type">PangoGlyphIndex</span>
572
 
 
573
 
 
574
561
</td>
575
562
</tr></tbody>
576
563
</table></div>
578
565
<hr>
579
566
<div class="refsect2" lang="en">
580
567
<a name="pango-x-load-font"></a><h3>pango_x_load_font ()</h3>
581
 
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a>*          pango_x_load_font                   (Display *display,
 
568
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *         pango_x_load_font                   (Display *display,
582
569
                                                         const <a
583
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
 
570
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
584
571
>gchar</a> *spec);</pre>
585
572
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
586
573
<h3 class="title">Warning</h3>
593
580
work correctly in all circumstances. Use of this function should
594
581
be avoided.</p>
595
582
<p>
596
 
 
597
583
</p>
598
584
<div class="variablelist"><table border="0">
599
585
<col align="left" valign="top">
626
612
</div>
627
613
<p>
628
614
Returns the index of a glyph suitable for drawing unknown characters;
629
 
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,
 
615
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,
630
616
since that may return a glyph that provides a better representation
631
617
of a particular char. (E.g., by showing hex digits, or a glyph
632
618
representative of a certain Unicode range.)</p>
633
619
<p>
634
 
 
635
620
</p>
636
621
<div class="variablelist"><table border="0">
637
622
<col align="left" valign="top">
653
638
<div class="refsect2" lang="en">
654
639
<a name="pango-x-has-glyph"></a><h3>pango_x_has_glyph ()</h3>
655
640
<pre class="programlisting"><a
656
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
641
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
657
642
>gboolean</a>            pango_x_has_glyph                   (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
658
643
                                                         <a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph">PangoGlyph</a> glyph);</pre>
659
644
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
663
648
<p>
664
649
Checks if the given glyph is present in a X font.</p>
665
650
<p>
666
 
 
667
651
</p>
668
652
<div class="variablelist"><table border="0">
669
653
<col align="left" valign="top">
676
660
<tr>
677
661
<td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
678
662
<td> the index of a glyph in the font. (Formed
679
 
        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)
 
663
        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)
680
664
</td>
681
665
</tr>
682
666
<tr>
683
667
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
684
 
<td> <code class="literal">TRUE</code> if the glyph is present.
 
668
<td> <a
 
669
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
 
670
><code class="literal">TRUE</code></a> if the glyph is present.
685
671
</td>
686
672
</tr>
687
673
</tbody>
703
689
Lists the subfonts of a given font. The result is ordered first by charset,
704
690
and then within each charset, by the order of fonts in the font specification.</p>
705
691
<p>
706
 
 
707
692
</p>
708
693
<div class="variablelist"><table border="0">
709
694
<col align="left" valign="top">
727
712
<td><p><span class="term"><em class="parameter"><code>subfont_ids</code></em> :</span></p></td>
728
713
<td> location to store a pointer to an array of subfont IDs for each found subfont;
729
714
              the result must be freed using <a
730
 
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
 
715
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
731
716
><code class="function">g_free()</code></a>.
732
717
</td>
733
718
</tr>
735
720
<td><p><span class="term"><em class="parameter"><code>subfont_charsets</code></em> :</span></p></td>
736
721
<td> location to store a pointer to an array of subfont IDs for each found subfont;
737
722
              the result must be freed using <a
738
 
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
 
723
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
739
724
><code class="function">g_free()</code></a>.
740
725
</td>
741
726
</tr>
751
736
<hr>
752
737
<div class="refsect2" lang="en">
753
738
<a name="pango-x-font-map-for-display"></a><h3>pango_x_font_map_for_display ()</h3>
754
 
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>*       pango_x_font_map_for_display        (Display *display);</pre>
 
739
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *      pango_x_font_map_for_display        (Display *display);</pre>
755
740
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
756
741
<h3 class="title">Warning</h3>
757
742
<p><code class="literal">pango_x_font_map_for_display</code> is deprecated and should not be used in newly-written code.</p>
761
746
not be freed. If the font map for a display is no longer needed, it can
762
747
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>
763
748
<p>
764
 
 
765
749
</p>
766
750
<div class="variablelist"><table border="0">
767
751
<col align="left" valign="top">
790
774
<p>
791
775
Free cached resources for the given X display structure.</p>
792
776
<p>
793
 
 
794
777
</p>
795
778
<div class="variablelist"><table border="0">
796
779
<col align="left" valign="top">
804
787
<hr>
805
788
<div class="refsect2" lang="en">
806
789
<a name="pango-x-font-map-get-font-cache"></a><h3>pango_x_font_map_get_font_cache ()</h3>
807
 
<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>
 
790
<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>
808
791
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
809
792
<h3 class="title">Warning</h3>
810
793
<p><code class="literal">pango_x_font_map_get_font_cache</code> is deprecated and should not be used in newly-written code.</p>
812
795
<p>
813
796
Obtains the font cache associated with the given font map.</p>
814
797
<p>
815
 
 
816
798
</p>
817
799
<div class="variablelist"><table border="0">
818
800
<col align="left" valign="top">
833
815
<hr>
834
816
<div class="refsect2" lang="en">
835
817
<a name="pango-x-font-subfont-xlfd"></a><h3>pango_x_font_subfont_xlfd ()</h3>
836
 
<pre class="programlisting">char*               pango_x_font_subfont_xlfd           (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 
818
<pre class="programlisting">char *              pango_x_font_subfont_xlfd           (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
837
819
                                                         <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> subfont_id);</pre>
838
820
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
839
821
<h3 class="title">Warning</h3>
843
825
Determines the X Logical Font Description for the specified
844
826
subfont.</p>
845
827
<p>
846
 
 
847
828
</p>
848
829
<div class="variablelist"><table border="0">
849
830
<col align="left" valign="top">
862
843
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
863
844
<td> A newly-allocated string containing the XLFD for the
864
845
subfont. This string must be freed with <a
865
 
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
 
846
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
866
847
><code class="function">g_free()</code></a>.
867
848
</td>
868
849
</tr>
873
854
<div class="refsect2" lang="en">
874
855
<a name="pango-x-find-first-subfont"></a><h3>pango_x_find_first_subfont ()</h3>
875
856
<pre class="programlisting"><a
876
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
857
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
877
858
>gboolean</a>            pango_x_find_first_subfont          (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
878
859
                                                         char **charsets,
879
860
                                                         int n_charsets,
886
867
Looks for subfonts with the <em class="parameter"><code>charset</code></em> charset,
887
868
in <em class="parameter"><code>font</code></em>, and puts the first one in *<em class="parameter"><code>rfont</code></em>.</p>
888
869
<p>
889
 
 
890
870
</p>
891
871
<div class="variablelist"><table border="0">
892
872
<col align="left" valign="top">
913
893
</tr>
914
894
<tr>
915
895
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
916
 
<td> <code class="literal">TRUE</code> if *<em class="parameter"><code>rfont</code></em> now contains a font.
 
896
<td> <a
 
897
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
 
898
><code class="literal">TRUE</code></a> if *<em class="parameter"><code>rfont</code></em> now contains a font.
917
899
</td>
918
900
</tr>
919
901
</tbody>
924
906
<a name="pango-x-font-get-unknown-glyph"></a><h3>pango_x_font_get_unknown_glyph ()</h3>
925
907
<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,
926
908
                                                         <a
927
 
href="/usr/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
 
909
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
928
910
>gunichar</a> wc);</pre>
929
911
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
930
912
<h3 class="title">Warning</h3>
935
917
unknown character.
936
918
</p>
937
919
<p>
938
 
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>
 
920
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>
939
921
<p>
940
 
 
941
922
</p>
942
923
<div class="variablelist"><table border="0">
943
924
<col align="left" valign="top">
964
945
<div class="refsect2" lang="en">
965
946
<a name="pango-x-apply-ligatures"></a><h3>pango_x_apply_ligatures ()</h3>
966
947
<pre class="programlisting"><a
967
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
948
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
968
949
>gboolean</a>            pango_x_apply_ligatures             (<a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
969
950
                                                         <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont">PangoXSubfont</a> subfont,
970
951
                                                         <a
971
 
href="/usr/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
 
952
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
972
953
>gunichar</a> **glyphs,
973
954
                                                         int *n_glyphs,
974
955
                                                         int **clusters);</pre>
979
960
<p>
980
961
Previously did subfont-specific ligation. Now a no-op.</p>
981
962
<p>
982
 
 
983
963
</p>
984
964
<div class="variablelist"><table border="0">
985
965
<col align="left" valign="top">
1011
991
</tr>
1012
992
<tr>
1013
993
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1014
 
<td> <code class="literal">FALSE</code>, always.
 
994
<td> <a
 
995
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
 
996
><code class="literal">FALSE</code></a>, always.
1015
997
</td>
1016
998
</tr>
1017
999
</tbody>
1033
1015
if no subfont that supports a given script is found.
1034
1016
For every character in <em class="parameter"><code>text</code></em>, it puts the unknown glyph.</p>
1035
1017
<p>
1036
 
 
1037
1018
</p>
1038
1019
<div class="variablelist"><table border="0">
1039
1020
<col align="left" valign="top">
1071
1052
</div>
1072
1053
<p>
1073
1054
A <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache"><span class="type">PangoXFontCache</span></a> caches
1074
 
<span class="type">XFontStructs</span> for a single display by their XLFD name. 
 
1055
<span class="type">XFontStructs</span> for a single display by their XLFD name.
1075
1056
</p>
1076
1057
</div>
1077
1058
<hr>
1078
1059
<div class="refsect2" lang="en">
1079
1060
<a name="pango-x-font-cache-new"></a><h3>pango_x_font_cache_new ()</h3>
1080
 
<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>
 
1061
<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>
1081
1062
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1082
1063
<h3 class="title">Warning</h3>
1083
1064
<p><code class="literal">pango_x_font_cache_new</code> is deprecated and should not be used in newly-written code.</p>
1085
1066
<p>
1086
1067
Creates a font cache for the specified display.</p>
1087
1068
<p>
1088
 
 
1089
1069
</p>
1090
1070
<div class="variablelist"><table border="0">
1091
1071
<col align="left" valign="top">
1116
1096
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
1117
1097
through this font cache will be freed along with the cache.</p>
1118
1098
<p>
1119
 
 
1120
1099
</p>
1121
1100
<div class="variablelist"><table border="0">
1122
1101
<col align="left" valign="top">
1130
1109
<hr>
1131
1110
<div class="refsect2" lang="en">
1132
1111
<a name="pango-x-font-cache-load"></a><h3>pango_x_font_cache_load ()</h3>
1133
 
<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,
 
1112
<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,
1134
1113
                                                         const char *xlfd);</pre>
1135
1114
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1136
1115
<h3 class="title">Warning</h3>
1141
1120
result may be newly loaded, or it may have been previously
1142
1121
stored.</p>
1143
1122
<p>
1144
 
 
1145
1123
</p>
1146
1124
<div class="variablelist"><table border="0">
1147
1125
<col align="left" valign="top">
1158
1136
</tr>
1159
1137
<tr>
1160
1138
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1161
 
<td> The font structure, or <code class="literal">NULL</code> if the font could
 
1139
<td> The font structure, or <a
 
1140
href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
 
1141
><code class="literal">NULL</code></a> if the font could
1162
1142
not be loaded. In order to free this structure, you must call
1163
1143
<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>.
1164
1144
</td>
1178
1158
<p>
1179
1159
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>
1180
1160
<p>
1181
 
 
1182
1161
</p>
1183
1162
<div class="variablelist"><table border="0">
1184
1163
<col align="left" valign="top">
1200
1179
</div>
1201
1180
<div class="footer">
1202
1181
<hr>
1203
 
          Generated by GTK-Doc V1.10</div>
 
1182
          Generated by GTK-Doc V1.11</div>
1204
1183
</body>
1205
1184
</html>