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.75.2">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
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.15.1 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
43
43
<em class="parameter"><code><a class="link" href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc" title="PangoGetGCFunc ()"><span class="type">PangoGetGCFunc</span></a> get_gc_func</code></em>,
44
44
<em class="parameter"><code><a class="link" href="pango-X-Fonts-and-Rendering.html#PangoFreeGCFunc" title="PangoFreeGCFunc ()"><span class="type">PangoFreeGCFunc</span></a> free_gc_func</code></em>);
45
45
<span class="returnvalue">GC</span> (<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc" title="PangoGetGCFunc ()">*PangoGetGCFunc</a>) (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,
46
<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoColor" title="PangoColor"><span class="type">PangoColor</span></a> *color</code></em>,
46
<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>,
47
47
<em class="parameter"><code><span class="type">GC</span> base_gc</code></em>);
48
48
<span class="returnvalue">void</span> (<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoFreeGCFunc" title="PangoFreeGCFunc ()">*PangoFreeGCFunc</a>) (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,
49
49
<em class="parameter"><code><span class="type">GC</span> gc</code></em>);
51
51
<em class="parameter"><code><span class="type">Drawable</span> d</code></em>,
52
52
<em class="parameter"><code><span class="type">GC</span> gc</code></em>,
53
53
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
54
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
55
<em class="parameter"><code><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
56
<em class="parameter"><code><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);
54
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
55
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
56
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);
57
57
<span class="returnvalue">void</span> <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> (<em class="parameter"><code><span class="type">Display</span> *display</code></em>,
58
58
<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>,
59
59
<em class="parameter"><code><span class="type">GC</span> gc</code></em>,
60
<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
60
<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
61
61
<em class="parameter"><code><span class="type">int</span> x</code></em>,
62
62
<em class="parameter"><code><span class="type">int</span> y</code></em>);
63
63
<span class="returnvalue">void</span> <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-render-layout" title="pango_x_render_layout ()">pango_x_render_layout</a> (<em class="parameter"><code><span class="type">Display</span> *display</code></em>,
72
72
#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)
73
73
#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)
74
74
<a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></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> (<em class="parameter"><code><span class="type">Display</span> *display</code></em>,
75
<em class="parameter"><code>const <a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *spec</code></em>);
75
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *spec</code></em>);
76
76
<a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="returnvalue">PangoGlyph</span></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> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>);
77
<a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></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> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
77
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></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> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
78
78
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="type">PangoGlyph</span></a> glyph</code></em>);
79
79
<span class="returnvalue">int</span> <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-list-subfonts" title="pango_x_list_subfonts ()">pango_x_list_subfonts</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
80
80
<em class="parameter"><code><span class="type">char</span> **charsets</code></em>,
86
86
<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache"><span class="returnvalue">PangoXFontCache</span></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> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> *font_map</code></em>);
87
87
<span class="returnvalue">char</span> * <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> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
88
88
<em class="parameter"><code><a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a> subfont_id</code></em>);
89
<a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></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> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
89
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></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> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
90
90
<em class="parameter"><code><span class="type">char</span> **charsets</code></em>,
91
91
<em class="parameter"><code><span class="type">int</span> n_charsets</code></em>,
92
92
<em class="parameter"><code><a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a> *rfont</code></em>);
93
93
<a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="returnvalue">PangoGlyph</span></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> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
94
<em class="parameter"><code><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);
95
<a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></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> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
94
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);
95
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></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> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
96
96
<em class="parameter"><code><a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a> subfont</code></em>,
97
<em class="parameter"><code><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> **glyphs</code></em>,
97
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> **glyphs</code></em>,
98
98
<em class="parameter"><code><span class="type">int</span> *n_glyphs</code></em>,
99
99
<em class="parameter"><code><span class="type">int</span> **clusters</code></em>);
100
100
<span class="returnvalue">void</span> <a class="link" href="pango-X-Fonts-and-Rendering.html#pango-x-fallback-shape" title="pango_x_fallback_shape ()">pango_x_fallback_shape</a> (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
101
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
101
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
102
102
<em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
103
103
<em class="parameter"><code><span class="type">int</span> n_chars</code></em>);
104
104
<a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXFontCache" title="PangoXFontCache">PangoXFontCache</a>;
155
155
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
156
<td>an X display (As returned by <code class="function">XOpenDisplay()</code>.)
156
<td>an X display (As returned by <code class="function">XOpenDisplay()</code>.)</td>
160
159
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
161
<td> the new <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
160
<td>the new <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.</td>
186
183
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
187
<td>a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
184
<td>a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.</td>
191
187
<td><p><span class="term"><em class="parameter"><code>get_gc_func</code></em> :</span></p></td>
192
<td>function called to create a new GC for a given color.
188
<td>function called to create a new GC for a given color.</td>
196
191
<td><p><span class="term"><em class="parameter"><code>free_gc_func</code></em> :</span></p></td>
197
<td>function called to free a GC created with <em class="parameter"><code>get_gc_func</code></em>.
192
<td>function called to free a GC created with <em class="parameter"><code>get_gc_func</code></em>.</td>
204
198
<div class="refsect2">
205
199
<a name="PangoGetGCFunc"></a><h3>PangoGetGCFunc ()</h3>
206
200
<pre class="programlisting"><span class="returnvalue">GC</span> (*PangoGetGCFunc) (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>,
207
<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoColor" title="PangoColor"><span class="type">PangoColor</span></a> *color</code></em>,
201
<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>,
208
202
<em class="parameter"><code><span class="type">GC</span> base_gc</code></em>);</pre>
209
203
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
210
204
<h3 class="title">Warning</h3>
221
215
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
222
<td>a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
216
<td>a <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.</td>
226
219
<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
227
<td>the color to create a new GC for.
220
<td>the color to create a new GC for.</td>
231
223
<td><p><span class="term"><em class="parameter"><code>base_gc</code></em> :</span></p></td>
232
<td>the GC to base the new GC on.
224
<td>the GC to base the new GC on.</td>
236
227
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
276
264
<em class="parameter"><code><span class="type">Drawable</span> d</code></em>,
277
265
<em class="parameter"><code><span class="type">GC</span> gc</code></em>,
278
266
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
279
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
280
<em class="parameter"><code><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
281
<em class="parameter"><code><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
267
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
268
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
269
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
282
270
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
283
271
<h3 class="title">Warning</h3>
284
272
<p><code class="literal">pango_x_render</code> is deprecated and should not be used in newly-written code.</p>
287
Renders a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto an X drawable.
275
Renders a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto an X drawable.
289
277
<div class="variablelist"><table border="0">
290
278
<col align="left" valign="top">
293
281
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
282
<td>the X display.</td>
298
285
<td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
299
<td>the drawable on which to draw string.
286
<td>the drawable on which to draw string.</td>
303
289
<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td>
304
<td>the graphics context.
290
<td>the graphics context.</td>
308
293
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
309
<td>the font in which to draw the string.
294
<td>the font in which to draw the string.</td>
313
297
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
314
<td>the glyph string to draw.
298
<td>the glyph string to draw.</td>
318
301
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
319
<td>the x position of start of string (in pixels).
302
<td>the x position of start of string (in pixels).</td>
323
305
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
324
<td>the y position of baseline (in pixels).
306
<td>the y position of baseline (in pixels).</td>
333
314
<pre class="programlisting"><span class="returnvalue">void</span> pango_x_render_layout_line (<em class="parameter"><code><span class="type">Display</span> *display</code></em>,
334
315
<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>,
335
316
<em class="parameter"><code><span class="type">GC</span> gc</code></em>,
336
<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
317
<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
337
318
<em class="parameter"><code><span class="type">int</span> x</code></em>,
338
319
<em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
339
320
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
341
322
<p><code class="literal">pango_x_render_layout_line</code> is deprecated and should not be used in newly-written code.</p>
344
Renders a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto an X drawable.
325
Renders a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto an X drawable.
346
327
<div class="variablelist"><table border="0">
347
328
<col align="left" valign="top">
350
331
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
332
<td>the X display.</td>
355
335
<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td>
356
<td>the drawable on which to draw.
336
<td>the drawable on which to draw.</td>
360
339
<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td>
361
<td>GC to use for uncolored drawing.
340
<td>GC to use for uncolored drawing.</td>
365
343
<td><p><span class="term"><em class="parameter"><code>line</code></em> :</span></p></td>
366
<td>a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>.
344
<td>a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>.</td>
370
347
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
371
<td>the x position of start of string (in pixels).
348
<td>the x position of start of string (in pixels).</td>
375
351
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
376
<td>the y position of baseline (in pixels).
352
<td>the y position of baseline (in pixels).</td>
402
377
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
378
<td>the X display.</td>
407
381
<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td>
408
<td>the drawable on which to draw.
382
<td>the drawable on which to draw.</td>
412
385
<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td>
413
<td>GC to use for uncolored drawing.
386
<td>GC to use for uncolored drawing.</td>
417
389
<td><p><span class="term"><em class="parameter"><code>layout</code></em> :</span></p></td>
418
<td>a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.
390
<td>a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.</td>
422
393
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
423
<td>the x position of the left of the layout (in pixels).
394
<td>the x position of the left of the layout (in pixels).</td>
427
397
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
428
<td>the y position of the top of the layout (in pixels).
398
<td>the y position of the top of the layout (in pixels).</td>
465
434
<td><p><span class="term"><em class="parameter"><code>subfont</code></em> :</span></p></td>
466
<td>a <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a> index
435
<td>a <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a> index</td>
470
438
<td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
471
<td>the index of a character within an X font.
439
<td>the index of a character within an X font.</td>
521
488
<div class="refsect2">
522
489
<a name="pango-x-load-font"></a><h3>pango_x_load_font ()</h3>
523
490
<pre class="programlisting"><a class="link" href="pango-Fonts.html#PangoFont"><span class="returnvalue">PangoFont</span></a> * pango_x_load_font (<em class="parameter"><code><span class="type">Display</span> *display</code></em>,
524
<em class="parameter"><code>const <a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *spec</code></em>);</pre>
491
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *spec</code></em>);</pre>
525
492
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
526
493
<h3 class="title">Warning</h3>
527
494
<p><code class="literal">pango_x_load_font</code> is deprecated and should not be used in newly-written code.</p>
530
497
Loads up a logical font based on a "fontset" style text
531
498
specification. This is not remotely useful (Pango API's generally
532
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
499
work in terms of <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>) and the result may not
533
500
work correctly in all circumstances. Use of this function should
540
507
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
508
<td>the X display.</td>
545
511
<td><p><span class="term"><em class="parameter"><code>spec</code></em> :</span></p></td>
546
<td>a comma-separated list of XLFD's.
512
<td>a comma-separated list of XLFD's.</td>
550
515
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
551
<td> a new <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
516
<td>a new <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</td>
576
540
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
577
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
541
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</td>
581
544
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
582
<td> a glyph index into <em class="parameter"><code>font</code></em>.
545
<td>a glyph index into <em class="parameter"><code>font</code></em>.</td>
589
551
<div class="refsect2">
590
552
<a name="pango-x-has-glyph"></a><h3>pango_x_has_glyph ()</h3>
591
<pre class="programlisting"><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_x_has_glyph (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
553
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_x_has_glyph (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
592
554
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="type">PangoGlyph</span></a> glyph</code></em>);</pre>
593
555
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
594
556
<h3 class="title">Warning</h3>
604
566
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
605
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the X backend.
567
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the X backend.</td>
609
570
<td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
610
571
<td>the index of a glyph in the font. (Formed
611
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)
572
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)</td>
615
575
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
616
<td> <a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the glyph is present.
577
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the glyph is present.</td>
642
602
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
643
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
603
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</td>
647
606
<td><p><span class="term"><em class="parameter"><code>charsets</code></em> :</span></p></td>
648
<td>the charsets to list subfonts for.
607
<td>the charsets to list subfonts for.</td>
652
610
<td><p><span class="term"><em class="parameter"><code>n_charsets</code></em> :</span></p></td>
653
<td>the number of charsets in <em class="parameter"><code>charsets</code></em>.
611
<td>the number of charsets in <em class="parameter"><code>charsets</code></em>.</td>
657
614
<td><p><span class="term"><em class="parameter"><code>subfont_ids</code></em> :</span></p></td>
658
615
<td>location to store a pointer to an array of subfont IDs for each found subfont;
659
the result must be freed using <a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
616
the result must be freed using <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
663
619
<td><p><span class="term"><em class="parameter"><code>subfont_charsets</code></em> :</span></p></td>
664
620
<td>location to store a pointer to an array of subfont IDs for each found subfont;
665
the result must be freed using <a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
621
the result must be freed using <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
669
624
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
670
<td> length of the arrays stored in <em class="parameter"><code>subfont_ids</code></em> and
671
<em class="parameter"><code>subfont_charsets</code></em>.
625
<td>length of the arrays stored in <em class="parameter"><code>subfont_ids</code></em> and
626
<em class="parameter"><code>subfont_charsets</code></em>.</td>
694
648
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
695
<td>an X <span class="type">Display</span>.
649
<td>an X <span class="type">Display</span>.</td>
699
652
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
700
<td> a <span class="type">PangoXFontMap</span> for <em class="parameter"><code>display</code></em>.
653
<td>a <span class="type">PangoXFontMap</span> for <em class="parameter"><code>display</code></em>.</td>
741
693
<td><p><span class="term"><em class="parameter"><code>font_map</code></em> :</span></p></td>
742
<td>a <span class="type">PangoXFontMap</span>.
694
<td>a <span class="type">PangoXFontMap</span>.</td>
746
697
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
747
<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>.
698
<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>.</td>
770
720
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
771
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the X backend.
721
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the X backend.</td>
775
724
<td><p><span class="term"><em class="parameter"><code>subfont_id</code></em> :</span></p></td>
776
<td>the id of a subfont within the font.
725
<td>the id of a subfont within the font.</td>
780
728
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
781
<td> A newly-allocated string containing the XLFD for the
782
subfont. This string must be freed with <a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
729
<td>A newly-allocated string containing the XLFD for the
730
subfont. This string must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
789
736
<div class="refsect2">
790
737
<a name="pango-x-find-first-subfont"></a><h3>pango_x_find_first_subfont ()</h3>
791
<pre class="programlisting"><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_x_find_first_subfont (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
738
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_x_find_first_subfont (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
792
739
<em class="parameter"><code><span class="type">char</span> **charsets</code></em>,
793
740
<em class="parameter"><code><span class="type">int</span> n_charsets</code></em>,
794
741
<em class="parameter"><code><a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a> *rfont</code></em>);</pre>
807
754
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
808
<td>A <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
755
<td>A <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</td>
812
758
<td><p><span class="term"><em class="parameter"><code>charsets</code></em> :</span></p></td>
813
<td>An array of charsets.
759
<td>An array of charsets.</td>
817
762
<td><p><span class="term"><em class="parameter"><code>n_charsets</code></em> :</span></p></td>
818
<td>The number of charsets in <em class="parameter"><code>charsets</code></em>.
763
<td>The number of charsets in <em class="parameter"><code>charsets</code></em>.</td>
822
766
<td><p><span class="term"><em class="parameter"><code>rfont</code></em> :</span></p></td>
823
<td>A pointer to a <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a>.
767
<td>A pointer to a <a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a>.</td>
827
770
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
828
<td> <a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if *<em class="parameter"><code>rfont</code></em> now contains a font.
772
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if *<em class="parameter"><code>rfont</code></em> now contains a font.</td>
835
778
<div class="refsect2">
836
779
<a name="pango-x-font-get-unknown-glyph"></a><h3>pango_x_font_get_unknown_glyph ()</h3>
837
780
<pre class="programlisting"><a class="link" href="pango-Glyph-Storage.html#PangoGlyph" title="PangoGlyph"><span class="returnvalue">PangoGlyph</span></a> pango_x_font_get_unknown_glyph (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
838
<em class="parameter"><code><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);</pre>
781
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> wc</code></em>);</pre>
839
782
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
840
783
<h3 class="title">Warning</h3>
841
784
<p><code class="literal">pango_x_font_get_unknown_glyph</code> is deprecated and should not be used in newly-written code.</p>
854
797
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
855
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
798
<td>a <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</td>
859
801
<td><p><span class="term"><em class="parameter"><code>wc</code></em> :</span></p></td>
860
<td>the Unicode character for which a glyph is needed.
802
<td>the Unicode character for which a glyph is needed.</td>
864
805
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
865
<td> a glyph index into <em class="parameter"><code>font</code></em>.
806
<td>a glyph index into <em class="parameter"><code>font</code></em>.</td>
872
812
<div class="refsect2">
873
813
<a name="pango-x-apply-ligatures"></a><h3>pango_x_apply_ligatures ()</h3>
874
<pre class="programlisting"><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_x_apply_ligatures (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
814
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_x_apply_ligatures (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
875
815
<em class="parameter"><code><a class="link" href="pango-X-Fonts-and-Rendering.html#PangoXSubfont" title="PangoXSubfont"><span class="type">PangoXSubfont</span></a> subfont</code></em>,
876
<em class="parameter"><code><a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> **glyphs</code></em>,
816
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> **glyphs</code></em>,
877
817
<em class="parameter"><code><span class="type">int</span> *n_glyphs</code></em>,
878
818
<em class="parameter"><code><span class="type">int</span> **clusters</code></em>);</pre>
879
819
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
890
830
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
895
834
<td><p><span class="term"><em class="parameter"><code>subfont</code></em> :</span></p></td>
900
838
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
905
842
<td><p><span class="term"><em class="parameter"><code>n_glyphs</code></em> :</span></p></td>
910
846
<td><p><span class="term"><em class="parameter"><code>clusters</code></em> :</span></p></td>
915
850
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
916
<td> <a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, always.
852
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, always.</td>
923
858
<div class="refsect2">
924
859
<a name="pango-x-fallback-shape"></a><h3>pango_x_fallback_shape ()</h3>
925
860
<pre class="programlisting"><span class="returnvalue">void</span> pango_x_fallback_shape (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
926
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
861
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
927
862
<em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
928
863
<em class="parameter"><code><span class="type">int</span> n_chars</code></em>);</pre>
929
864
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
942
877
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
943
<td>A <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
878
<td>A <a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.</td>
947
881
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
948
<td>A pointer to a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="PangoGlyphString"><span class="type">PangoGlyphString</span></a>.
882
<td>A pointer to a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a>.</td>
952
885
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
886
<td>UTF-8 string.</td>
957
889
<td><p><span class="term"><em class="parameter"><code>n_chars</code></em> :</span></p></td>
958
<td>Number of UTF-8 seqs in <em class="parameter"><code>text</code></em>.
890
<td>Number of UTF-8 seqs in <em class="parameter"><code>text</code></em>.</td>
992
923
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
924
<td>an X display.</td>
997
927
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
998
<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
999
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>.
928
<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
929
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>.</td>
1049
978
<td><p><span class="term"><em class="parameter"><code>xlfd</code></em> :</span></p></td>
1050
<td>the X Logical Font Description to load.
979
<td>the X Logical Font Description to load.</td>
1054
982
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1055
<td> The font structure, or <a href="/home/behdad/.local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the font could
983
<td>The font structure, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the font could
1056
984
not be loaded. In order to free this structure, you must call
1057
<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>.
985
<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>.</td>