1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>Deprecated X font backend</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
7
<link rel="start" 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.6 (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="index" href="ix01.html" title="Index">
18
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
19
<link rel="index" href="ix03.html" title="Index of new symbols in 1.2">
20
<link rel="index" href="ix04.html" title="Index of new symbols in 1.4">
21
<link rel="index" href="ix05.html" title="Index of new symbols in 1.6">
22
<link rel="index" href="ix06.html" title="Index of new symbols in 1.8">
23
<link rel="index" href="ix07.html" title="Index of new symbols in 1.10">
24
<link rel="index" href="ix08.html" title="Index of new symbols in 1.12">
25
<link rel="index" href="ix09.html" title="Index of new symbols in 1.14">
26
<link rel="index" href="ix10.html" title="Index of new symbols in 1.16">
28
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
29
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
31
<td><a accesskey="p" href="pango-ATSUI-Fonts.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
32
<td><a accesskey="u" href="rendering.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
33
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
34
<th width="100%" align="center">Pango Reference Manual</th>
35
<td><a accesskey="n" href="lowlevel.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
37
<tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>
39
<a href="#desc" class="shortcut">Description</a></nobr></td></tr>
41
<div class="refentry" lang="en">
42
<a name="pango-X-Fonts-and-Rendering"></a><div class="titlepage"></div>
43
<div class="refnamediv"><table width="100%"><tr>
45
<h2><span class="refentrytitle"><a name="top_of_page"></a>Deprecated X font backend</span></h2>
46
<p>Deprecated X font backend — Font handling and rendering with the deprecated X font backend</p>
48
<td valign="top" align="right"></td>
50
<div class="refsynopsisdiv">
51
<a name="synopsis"></a><h2>Synopsis</h2>
52
<pre class="synopsis">
56
#define <a href="pango-X-Fonts-and-Rendering.html#PANGO-RENDER-TYPE-X:CAPS">PANGO_RENDER_TYPE_X</a>
57
<a href="pango-Text-Processing.html#PangoContext">PangoContext</a>* <a href="pango-X-Fonts-and-Rendering.html#pango-x-get-context">pango_x_get_context</a> (Display *display);
58
void <a href="pango-X-Fonts-and-Rendering.html#pango-x-context-set-funcs">pango_x_context_set_funcs</a> (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
59
<a href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc">PangoGetGCFunc</a> get_gc_func,
60
<a href="pango-X-Fonts-and-Rendering.html#PangoFreeGCFunc">PangoFreeGCFunc</a> free_gc_func);
61
GC (<a href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc">*PangoGetGCFunc</a>) (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
62
<a href="pango-Text-Attributes.html#PangoColor">PangoColor</a> *color,
64
void (<a href="pango-X-Fonts-and-Rendering.html#PangoFreeGCFunc">*PangoFreeGCFunc</a>) (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
66
void <a href="pango-X-Fonts-and-Rendering.html#pango-x-render">pango_x_render</a> (Display *display,
69
<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
70
<a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
72
href="../glib/glib-Basic-Types.html#gint"
75
href="../glib/glib-Basic-Types.html#gint"
77
void <a href="pango-X-Fonts-and-Rendering.html#pango-x-render-layout-line">pango_x_render_layout_line</a> (Display *display,
80
<a href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line,
83
void <a href="pango-X-Fonts-and-Rendering.html#pango-x-render-layout">pango_x_render_layout</a> (Display *display,
86
<a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
89
typedef <a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont">PangoXSubfont</a>;
90
#define <a href="pango-X-Fonts-and-Rendering.html#PANGO-X-MAKE-GLYPH:CAPS">PANGO_X_MAKE_GLYPH</a> (subfont,index_)
91
#define <a href="pango-X-Fonts-and-Rendering.html#PANGO-X-GLYPH-SUBFONT:CAPS">PANGO_X_GLYPH_SUBFONT</a> (glyph)
92
#define <a href="pango-X-Fonts-and-Rendering.html#PANGO-X-GLYPH-INDEX:CAPS">PANGO_X_GLYPH_INDEX</a> (glyph)
93
<a href="pango-Fonts.html#PangoFont">PangoFont</a>* <a href="pango-X-Fonts-and-Rendering.html#pango-x-load-font">pango_x_load_font</a> (Display *display,
95
href="../glib/glib-Basic-Types.html#gchar"
97
<a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> <a href="pango-X-Fonts-and-Rendering.html#pango-x-get-unknown-glyph">pango_x_get_unknown_glyph</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);
99
href="../glib/glib-Basic-Types.html#gboolean"
100
>gboolean</a> <a href="pango-X-Fonts-and-Rendering.html#pango-x-has-glyph">pango_x_has_glyph</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
101
<a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> glyph);
102
int <a href="pango-X-Fonts-and-Rendering.html#pango-x-list-subfonts">pango_x_list_subfonts</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
105
<a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont">PangoXSubfont</a> **subfont_ids,
106
int **subfont_charsets);
107
<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* <a href="pango-X-Fonts-and-Rendering.html#pango-x-font-map-for-display">pango_x_font_map_for_display</a> (Display *display);
108
void <a href="pango-X-Fonts-and-Rendering.html#pango-x-shutdown-display">pango_x_shutdown_display</a> (Display *display);
109
<a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a>* <a href="pango-X-Fonts-and-Rendering.html#pango-x-font-map-get-font-cache">pango_x_font_map_get_font_cache</a>
110
(<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *font_map);
111
char* <a href="pango-X-Fonts-and-Rendering.html#pango-x-font-subfont-xlfd">pango_x_font_subfont_xlfd</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
112
<a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont">PangoXSubfont</a> subfont_id);
114
href="../glib/glib-Basic-Types.html#gboolean"
115
>gboolean</a> <a href="pango-X-Fonts-and-Rendering.html#pango-x-find-first-subfont">pango_x_find_first_subfont</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
118
<a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont">PangoXSubfont</a> *rfont);
119
<a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> <a href="pango-X-Fonts-and-Rendering.html#pango-x-font-get-unknown-glyph">pango_x_font_get_unknown_glyph</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
121
href="../glib/glib-Unicode-Manipulation.html#gunichar"
124
href="../glib/glib-Basic-Types.html#gboolean"
125
>gboolean</a> <a href="pango-X-Fonts-and-Rendering.html#pango-x-apply-ligatures">pango_x_apply_ligatures</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
126
<a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont">PangoXSubfont</a> subfont,
128
href="../glib/glib-Unicode-Manipulation.html#gunichar"
129
>gunichar</a> **glyphs,
132
void <a href="pango-X-Fonts-and-Rendering.html#pango-x-fallback-shape">pango_x_fallback_shape</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
133
<a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
136
<a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a>;
137
<a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a>* <a href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-new">pango_x_font_cache_new</a> (Display *display);
138
void <a href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-free">pango_x_font_cache_free</a> (<a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a> *cache);
139
XFontStruct* <a href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-load">pango_x_font_cache_load</a> (<a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a> *cache,
141
void <a href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-unload">pango_x_font_cache_unload</a> (<a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a> *cache,
145
<div class="refsect1" lang="en">
146
<a name="desc"></a><h2>Description</h2>
148
The functions and macros in this section are for use with the old
149
X font backend which used server-side bitmap fonts. This font backend
150
is no longer supported, and attempts to use it will produce
151
unpredictable results. Use the <a href="pango-Xft-Fonts-and-Rendering.html" title="Xft Fonts and Rendering">Xft</a>
152
or <a href="pango-Cairo-Rendering.html" title="Cairo Rendering">Cairo</a> backend instead.
155
<div class="refsect1" lang="en">
156
<a name="details"></a><h2>Details</h2>
157
<div class="refsect2" lang="en">
158
<a name="id3157889"></a><h3>
159
<a name="PANGO-RENDER-TYPE-X:CAPS"></a>PANGO_RENDER_TYPE_X</h3>
160
<a class="indexterm" name="id3157904"></a><pre class="programlisting">#define PANGO_RENDER_TYPE_X "PangoRenderX"
162
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
163
<h3 class="title">Warning</h3>
164
<p><code class="literal">PANGO_RENDER_TYPE_X</code> is deprecated and should not be used in newly-written code.</p>
167
A string constant identifying the X renderer. The associated quark (see
169
href="../glib/glib-Quarks.html#g-quark-from-string"
170
><code class="function">g_quark_from_string()</code></a>) is used to identify the renderer in <a href="pango-Modules.html#pango-find-map"><code class="function">pango_find_map()</code></a>.
174
<div class="refsect2" lang="en">
175
<a name="id3157954"></a><h3>
176
<a name="pango-x-get-context"></a>pango_x_get_context ()</h3>
177
<a class="indexterm" name="id3157970"></a><pre class="programlisting"><a href="pango-Text-Processing.html#PangoContext">PangoContext</a>* pango_x_get_context (Display *display);</pre>
178
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
179
<h3 class="title">Warning</h3>
180
<p><code class="literal">pango_x_get_context</code> is deprecated and should not be used in newly-written code.</p>
183
Retrieves a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> appropriate for rendering with X fonts on the
188
<div class="variablelist"><table border="0">
189
<col align="left" valign="top">
193
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
194
<td> an X display (As returned by <code class="function">XOpenDisplay()</code>.)
199
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
200
<td> the new <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
207
<div class="refsect2" lang="en">
208
<a name="id3158071"></a><h3>
209
<a name="pango-x-context-set-funcs"></a>pango_x_context_set_funcs ()</h3>
210
<a class="indexterm" name="id3158088"></a><pre class="programlisting">void pango_x_context_set_funcs (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
211
<a href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc">PangoGetGCFunc</a> get_gc_func,
212
<a href="pango-X-Fonts-and-Rendering.html#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>
218
Sets the functions that will be used to get GC's in various colors when
219
rendering layouts with this context.</p>
223
<div class="variablelist"><table border="0">
224
<col align="left" valign="top">
228
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
229
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
234
<span class="term"><em class="parameter"><code>get_gc_func</code></em> :</span></td>
235
<td> function called to create a new GC for a given color.
240
<span class="term"><em class="parameter"><code>free_gc_func</code></em> :</span></td>
241
<td> function called to free a GC created with <em class="parameter"><code>get_gc_func</code></em>.
248
<div class="refsect2" lang="en">
249
<a name="id3158211"></a><h3>
250
<a name="PangoGetGCFunc"></a>PangoGetGCFunc ()</h3>
251
<a class="indexterm" name="id3158225"></a><pre class="programlisting">GC (*PangoGetGCFunc) (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
252
<a href="pango-Text-Attributes.html#PangoColor">PangoColor</a> *color,
254
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
255
<h3 class="title">Warning</h3>
256
<p><code class="literal">PangoGetGCFunc</code> is deprecated and should not be used in newly-written code.</p>
259
Specifies the type of the function used to create a new GC for a given
262
<div class="variablelist"><table border="0">
263
<col align="left" valign="top">
267
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
268
<td>a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
273
<span class="term"><em class="parameter"><code>color</code></em> :</span></td>
274
<td>the color to create a new GC for.
279
<span class="term"><em class="parameter"><code>base_gc</code></em> :</span></td>
280
<td>the GC to base the new GC on.
285
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
295
<div class="refsect2" lang="en">
296
<a name="id3158347"></a><h3>
297
<a name="PangoFreeGCFunc"></a>PangoFreeGCFunc ()</h3>
298
<a class="indexterm" name="id3158363"></a><pre class="programlisting">void (*PangoFreeGCFunc) (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
300
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
301
<h3 class="title">Warning</h3>
302
<p><code class="literal">PangoFreeGCFunc</code> is deprecated and should not be used in newly-written code.</p>
305
Specifies the type of the function used to free a GC created with
306
the corresponding <a href="pango-X-Fonts-and-Rendering.html#PangoGetGCFunc"><span class="type">PangoGetGCFunc</span></a> function.
308
<div class="variablelist"><table border="0">
309
<col align="left" valign="top">
313
<span class="term"><em class="parameter"><code>context</code></em> :</span></td>
314
<td>a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
319
<span class="term"><em class="parameter"><code>gc</code></em> :</span></td>
329
<div class="refsect2" lang="en">
330
<a name="id3158461"></a><h3>
331
<a name="pango-x-render"></a>pango_x_render ()</h3>
332
<a class="indexterm" name="id3158476"></a><pre class="programlisting">void pango_x_render (Display *display,
335
<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
336
<a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
338
href="../glib/glib-Basic-Types.html#gint"
341
href="../glib/glib-Basic-Types.html#gint"
343
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
344
<h3 class="title">Warning</h3>
345
<p><code class="literal">pango_x_render</code> is deprecated and should not be used in newly-written code.</p>
348
Renders a <a href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto an X drawable.</p>
352
<div class="variablelist"><table border="0">
353
<col align="left" valign="top">
357
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
363
<span class="term"><em class="parameter"><code>d</code></em> :</span></td>
364
<td> the drawable on which to draw string.
369
<span class="term"><em class="parameter"><code>gc</code></em> :</span></td>
370
<td> the graphics context.
375
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
376
<td> the font in which to draw the string.
381
<span class="term"><em class="parameter"><code>glyphs</code></em> :</span></td>
382
<td> the glyph string to draw.
387
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
388
<td> the x position of start of string (in pixels).
393
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
394
<td> the y position of baseline (in pixels).
401
<div class="refsect2" lang="en">
402
<a name="id3158678"></a><h3>
403
<a name="pango-x-render-layout-line"></a>pango_x_render_layout_line ()</h3>
404
<a class="indexterm" name="id3158694"></a><pre class="programlisting">void pango_x_render_layout_line (Display *display,
407
<a href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line,
410
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
411
<h3 class="title">Warning</h3>
412
<p><code class="literal">pango_x_render_layout_line</code> is deprecated and should not be used in newly-written code.</p>
415
Renders a <a href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto an X drawable.</p>
419
<div class="variablelist"><table border="0">
420
<col align="left" valign="top">
424
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
430
<span class="term"><em class="parameter"><code>drawable</code></em> :</span></td>
431
<td> the drawable on which to draw.
436
<span class="term"><em class="parameter"><code>gc</code></em> :</span></td>
437
<td> GC to use for uncolored drawing.
442
<span class="term"><em class="parameter"><code>line</code></em> :</span></td>
443
<td> a <a href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>.
448
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
449
<td> the x position of start of string (in pixels).
454
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
455
<td> the y position of baseline (in pixels).
462
<div class="refsect2" lang="en">
463
<a name="id3158880"></a><h3>
464
<a name="pango-x-render-layout"></a>pango_x_render_layout ()</h3>
465
<a class="indexterm" name="id3158896"></a><pre class="programlisting">void pango_x_render_layout (Display *display,
468
<a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
471
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
472
<h3 class="title">Warning</h3>
473
<p><code class="literal">pango_x_render_layout</code> is deprecated and should not be used in newly-written code.</p>
476
Renders a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> onto an X drawable.</p>
480
<div class="variablelist"><table border="0">
481
<col align="left" valign="top">
485
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
491
<span class="term"><em class="parameter"><code>drawable</code></em> :</span></td>
492
<td> the drawable on which to draw.
497
<span class="term"><em class="parameter"><code>gc</code></em> :</span></td>
498
<td> GC to use for uncolored drawing.
503
<span class="term"><em class="parameter"><code>layout</code></em> :</span></td>
504
<td> a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.
509
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
510
<td> the x position of the left of the layout (in pixels).
515
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
516
<td> the y position of the top of the layout (in pixels).
523
<div class="refsect2" lang="en">
524
<a name="id3159082"></a><h3>
525
<a name="PangoXSubfont"></a>PangoXSubfont</h3>
526
<a class="indexterm" name="id3159098"></a><pre class="programlisting">typedef guint16 PangoXSubfont;
528
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
529
<h3 class="title">Warning</h3>
530
<p><code class="literal">PangoXSubfont</code> is deprecated and should not be used in newly-written code.</p>
533
The <span class="type">PangoXSubFont</span> type is an integer ID that identifies one
534
particular X font within the fonts referenced in a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
538
<div class="refsect2" lang="en">
539
<a name="id3159144"></a><h3>
540
<a name="PANGO-X-MAKE-GLYPH:CAPS"></a>PANGO_X_MAKE_GLYPH()</h3>
541
<a class="indexterm" name="id3159160"></a><pre class="programlisting">#define PANGO_X_MAKE_GLYPH(subfont,index_) ((subfont)<<16 | (index_))
543
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
544
<h3 class="title">Warning</h3>
545
<p><code class="literal">PANGO_X_MAKE_GLYPH</code> is deprecated and should not be used in newly-written code.</p>
548
Make a glyph index from a <span class="type">PangoXSubFont</span> index and a index
549
of a character with the corresponding X font.
551
<div class="variablelist"><table border="0">
552
<col align="left" valign="top">
556
<span class="term"><em class="parameter"><code>subfont</code></em> :</span></td>
557
<td>a <a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont"><span class="type">PangoXSubfont</span></a> index
562
<span class="term"><em class="parameter"><code>index_</code></em> :</span></td>
563
<td>the index of a character within an X font.
572
<div class="refsect2" lang="en">
573
<a name="id3159240"></a><h3>
574
<a name="PANGO-X-GLYPH-SUBFONT:CAPS"></a>PANGO_X_GLYPH_SUBFONT()</h3>
575
<a class="indexterm" name="id3159255"></a><pre class="programlisting">#define PANGO_X_GLYPH_SUBFONT(glyph) ((glyph)>>16)
577
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
578
<h3 class="title">Warning</h3>
579
<p><code class="literal">PANGO_X_GLYPH_SUBFONT</code> is deprecated and should not be used in newly-written code.</p>
582
Extract the subfont index from a glyph index.
584
<div class="variablelist"><table border="0">
585
<col align="left" valign="top">
588
<span class="term"><em class="parameter"><code>glyph</code></em> :</span></td>
589
<td>a <span class="type">PangoGlyphIndex</span>
597
<div class="refsect2" lang="en">
598
<a name="id3159313"></a><h3>
599
<a name="PANGO-X-GLYPH-INDEX:CAPS"></a>PANGO_X_GLYPH_INDEX()</h3>
600
<a class="indexterm" name="id3159328"></a><pre class="programlisting">#define PANGO_X_GLYPH_INDEX(glyph) ((glyph) & 0xffff)
602
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
603
<h3 class="title">Warning</h3>
604
<p><code class="literal">PANGO_X_GLYPH_INDEX</code> is deprecated and should not be used in newly-written code.</p>
607
Extract the character index within the X font from a
610
<div class="variablelist"><table border="0">
611
<col align="left" valign="top">
614
<span class="term"><em class="parameter"><code>glyph</code></em> :</span></td>
615
<td>a <span class="type">PangoGlyphIndex</span>
623
<div class="refsect2" lang="en">
624
<a name="id3159384"></a><h3>
625
<a name="pango-x-load-font"></a>pango_x_load_font ()</h3>
626
<a class="indexterm" name="id3159400"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFont">PangoFont</a>* pango_x_load_font (Display *display,
628
href="../glib/glib-Basic-Types.html#gchar"
629
>gchar</a> *spec);</pre>
630
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
631
<h3 class="title">Warning</h3>
632
<p><code class="literal">pango_x_load_font</code> is deprecated and should not be used in newly-written code.</p>
635
Loads up a logical font based on a "fontset" style text
636
specification. This is not remotely useful (Pango API's generally
637
work in terms of <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>) and the result may not
638
work correctly in all circumstances. Use of this function should
643
<div class="variablelist"><table border="0">
644
<col align="left" valign="top">
648
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
654
<span class="term"><em class="parameter"><code>spec</code></em> :</span></td>
655
<td> a comma-separated list of XLFD's.
660
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
661
<td>a new <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
668
<div class="refsect2" lang="en">
669
<a name="id3159515"></a><h3>
670
<a name="pango-x-get-unknown-glyph"></a>pango_x_get_unknown_glyph ()</h3>
671
<a class="indexterm" name="id3159531"></a><pre class="programlisting"><a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> pango_x_get_unknown_glyph (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
672
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
673
<h3 class="title">Warning</h3>
674
<p><code class="literal">pango_x_get_unknown_glyph</code> is deprecated and should not be used in newly-written code.</p>
677
Returns the index of a glyph suitable for drawing unknown characters;
678
you should generally use <a href="pango-Glyph-Storage.html#PANGO-GET-UNKNOWN-GLYPH:CAPS"><code class="function">PANGO_GET_UNKNOWN_GLYPH()</code></a> instead,
679
since that may return a glyph that provides a better representation
680
of a particular char. (E.g., by showing hex digits, or a glyph
681
representative of a certain Unicode range.)</p>
685
<div class="variablelist"><table border="0">
686
<col align="left" valign="top">
690
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
691
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
696
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
697
<td> a glyph index into <em class="parameter"><code>font</code></em>.
704
<div class="refsect2" lang="en">
705
<a name="id3159633"></a><h3>
706
<a name="pango-x-has-glyph"></a>pango_x_has_glyph ()</h3>
707
<a class="indexterm" name="id3159649"></a><pre class="programlisting"><a
708
href="../glib/glib-Basic-Types.html#gboolean"
709
>gboolean</a> pango_x_has_glyph (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
710
<a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> glyph);</pre>
711
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
712
<h3 class="title">Warning</h3>
713
<p><code class="literal">pango_x_has_glyph</code> is deprecated and should not be used in newly-written code.</p>
716
Checks if the given glyph is present in a X font.</p>
720
<div class="variablelist"><table border="0">
721
<col align="left" valign="top">
725
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
726
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the X backend.
731
<span class="term"><em class="parameter"><code>glyph</code></em> :</span></td>
732
<td> the index of a glyph in the font. (Formed
733
using the <a href="pango-X-Fonts-and-Rendering.html#PANGO-X-MAKE-GLYPH:CAPS"><span class="type">PANGO_X_MAKE_GLYPH</span></a> macro)
738
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
740
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
741
><code class="literal">TRUE</code></a> if the glyph is present.
748
<div class="refsect2" lang="en">
749
<a name="id3159770"></a><h3>
750
<a name="pango-x-list-subfonts"></a>pango_x_list_subfonts ()</h3>
751
<a class="indexterm" name="id3159786"></a><pre class="programlisting">int pango_x_list_subfonts (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
754
<a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont">PangoXSubfont</a> **subfont_ids,
755
int **subfont_charsets);</pre>
756
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
757
<h3 class="title">Warning</h3>
758
<p><code class="literal">pango_x_list_subfonts</code> is deprecated and should not be used in newly-written code.</p>
761
Lists the subfonts of a given font. The result is ordered first by charset,
762
and then within each charset, by the order of fonts in the font specification.</p>
766
<div class="variablelist"><table border="0">
767
<col align="left" valign="top">
771
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
772
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
777
<span class="term"><em class="parameter"><code>charsets</code></em> :</span></td>
778
<td> the charsets to list subfonts for.
783
<span class="term"><em class="parameter"><code>n_charsets</code></em> :</span></td>
784
<td> the number of charsets in <em class="parameter"><code>charsets</code></em>.
789
<span class="term"><em class="parameter"><code>subfont_ids</code></em> :</span></td>
790
<td> location to store a pointer to an array of subfont IDs for each found subfont;
791
the result must be freed using <a
792
href="../glib/glib-Memory-Allocation.html#g-free"
793
><code class="function">g_free()</code></a>.
798
<span class="term"><em class="parameter"><code>subfont_charsets</code></em> :</span></td>
799
<td> location to store a pointer to an array of subfont IDs for each found subfont;
800
the result must be freed using <a
801
href="../glib/glib-Memory-Allocation.html#g-free"
802
><code class="function">g_free()</code></a>.
807
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
808
<td> length of the arrays stored in <em class="parameter"><code>subfont_ids</code></em> and
809
<em class="parameter"><code>subfont_charsets</code></em>.
816
<div class="refsect2" lang="en">
817
<a name="id3159997"></a><h3>
818
<a name="pango-x-font-map-for-display"></a>pango_x_font_map_for_display ()</h3>
819
<a class="indexterm" name="id3160013"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* pango_x_font_map_for_display (Display *display);</pre>
820
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
821
<h3 class="title">Warning</h3>
822
<p><code class="literal">pango_x_font_map_for_display</code> is deprecated and should not be used in newly-written code.</p>
825
Returns a <span class="type">PangoXFontMap</span> for <em class="parameter"><code>display</code></em>. Font maps are cached and should
826
not be freed. If the font map for a display is no longer needed, it can
827
be released with <a href="pango-X-Fonts-and-Rendering.html#pango-x-shutdown-display"><code class="function">pango_x_shutdown_display()</code></a>.</p>
831
<div class="variablelist"><table border="0">
832
<col align="left" valign="top">
836
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
837
<td> an X <span class="type">Display</span>.
842
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
843
<td> a <span class="type">PangoXFontMap</span> for <em class="parameter"><code>display</code></em>.
850
<div class="refsect2" lang="en">
851
<a name="id3160136"></a><h3>
852
<a name="pango-x-shutdown-display"></a>pango_x_shutdown_display ()</h3>
853
<a class="indexterm" name="id3160152"></a><pre class="programlisting">void pango_x_shutdown_display (Display *display);</pre>
854
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
855
<h3 class="title">Warning</h3>
856
<p><code class="literal">pango_x_shutdown_display</code> is deprecated and should not be used in newly-written code.</p>
859
Free cached resources for the given X display structure.</p>
863
<div class="variablelist"><table border="0">
864
<col align="left" valign="top">
867
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
868
<td> an X <span class="type">Display</span>
874
<div class="refsect2" lang="en">
875
<a name="id3160223"></a><h3>
876
<a name="pango-x-font-map-get-font-cache"></a>pango_x_font_map_get_font_cache ()</h3>
877
<a class="indexterm" name="id3160239"></a><pre class="programlisting"><a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a>* pango_x_font_map_get_font_cache
878
(<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *font_map);</pre>
879
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
880
<h3 class="title">Warning</h3>
881
<p><code class="literal">pango_x_font_map_get_font_cache</code> is deprecated and should not be used in newly-written code.</p>
884
Obtains the font cache associated with the given font map.</p>
888
<div class="variablelist"><table border="0">
889
<col align="left" valign="top">
893
<span class="term"><em class="parameter"><code>font_map</code></em> :</span></td>
894
<td> a <span class="type">PangoXFontMap</span>.
899
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
900
<td> the <a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache"><span class="type">PangoXFontCache</span></a> of <em class="parameter"><code>font_map</code></em>.
907
<div class="refsect2" lang="en">
908
<a name="id3160336"></a><h3>
909
<a name="pango-x-font-subfont-xlfd"></a>pango_x_font_subfont_xlfd ()</h3>
910
<a class="indexterm" name="id3160352"></a><pre class="programlisting">char* pango_x_font_subfont_xlfd (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
911
<a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont">PangoXSubfont</a> subfont_id);</pre>
912
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
913
<h3 class="title">Warning</h3>
914
<p><code class="literal">pango_x_font_subfont_xlfd</code> is deprecated and should not be used in newly-written code.</p>
917
Determines the X Logical Font Description for the specified
922
<div class="variablelist"><table border="0">
923
<col align="left" valign="top">
927
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
928
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the X backend.
933
<span class="term"><em class="parameter"><code>subfont_id</code></em> :</span></td>
934
<td> the id of a subfont within the font.
939
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
940
<td> A newly-allocated string containing the XLFD for the
941
subfont. This string must be freed with <a
942
href="../glib/glib-Memory-Allocation.html#g-free"
943
><code class="function">g_free()</code></a>.
950
<div class="refsect2" lang="en">
951
<a name="id3160468"></a><h3>
952
<a name="pango-x-find-first-subfont"></a>pango_x_find_first_subfont ()</h3>
953
<a class="indexterm" name="id3160484"></a><pre class="programlisting"><a
954
href="../glib/glib-Basic-Types.html#gboolean"
955
>gboolean</a> pango_x_find_first_subfont (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
958
<a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont">PangoXSubfont</a> *rfont);</pre>
959
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
960
<h3 class="title">Warning</h3>
961
<p><code class="literal">pango_x_find_first_subfont</code> is deprecated and should not be used in newly-written code.</p>
964
Looks for subfonts with the <em class="parameter"><code>charset</code></em> charset,
965
in <em class="parameter"><code>font</code></em>, and puts the first one in *<em class="parameter"><code>rfont</code></em>.</p>
969
<div class="variablelist"><table border="0">
970
<col align="left" valign="top">
974
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
975
<td> A <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
980
<span class="term"><em class="parameter"><code>charsets</code></em> :</span></td>
981
<td> An array of charsets.
986
<span class="term"><em class="parameter"><code>n_charsets</code></em> :</span></td>
987
<td> The number of charsets in <em class="parameter"><code>charsets</code></em>.
992
<span class="term"><em class="parameter"><code>rfont</code></em> :</span></td>
993
<td> A pointer to a <a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont"><span class="type">PangoXSubfont</span></a>.
998
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1000
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
1001
><code class="literal">TRUE</code></a> if *<em class="parameter"><code>rfont</code></em> now contains a font.
1008
<div class="refsect2" lang="en">
1009
<a name="id3160678"></a><h3>
1010
<a name="pango-x-font-get-unknown-glyph"></a>pango_x_font_get_unknown_glyph ()</h3>
1011
<a class="indexterm" name="id3160694"></a><pre class="programlisting"><a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> pango_x_font_get_unknown_glyph (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
1013
href="../glib/glib-Unicode-Manipulation.html#gunichar"
1014
>gunichar</a> wc);</pre>
1015
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1016
<h3 class="title">Warning</h3>
1017
<p><code class="literal">pango_x_font_get_unknown_glyph</code> is deprecated and should not be used in newly-written code.</p>
1020
Returns the index of a glyph suitable for drawing <em class="parameter"><code>wc</code></em> as an
1024
Use <a href="pango-Glyph-Storage.html#PANGO-GET-UNKNOWN-GLYPH:CAPS"><code class="function">PANGO_GET_UNKNOWN_GLYPH()</code></a> instead.</p>
1028
<div class="variablelist"><table border="0">
1029
<col align="left" valign="top">
1033
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
1034
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
1039
<span class="term"><em class="parameter"><code>wc</code></em> :</span></td>
1040
<td> the Unicode character for which a glyph is needed.
1045
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1046
<td> a glyph index into <em class="parameter"><code>font</code></em>.
1053
<div class="refsect2" lang="en">
1054
<a name="id3160824"></a><h3>
1055
<a name="pango-x-apply-ligatures"></a>pango_x_apply_ligatures ()</h3>
1056
<a class="indexterm" name="id3160840"></a><pre class="programlisting"><a
1057
href="../glib/glib-Basic-Types.html#gboolean"
1058
>gboolean</a> pango_x_apply_ligatures (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
1059
<a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont">PangoXSubfont</a> subfont,
1061
href="../glib/glib-Unicode-Manipulation.html#gunichar"
1062
>gunichar</a> **glyphs,
1064
int **clusters);</pre>
1065
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1066
<h3 class="title">Warning</h3>
1067
<p><code class="literal">pango_x_apply_ligatures</code> is deprecated and should not be used in newly-written code.</p>
1070
Previously did subfont-specific ligation. Now a no-op.</p>
1074
<div class="variablelist"><table border="0">
1075
<col align="left" valign="top">
1079
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
1085
<span class="term"><em class="parameter"><code>subfont</code></em> :</span></td>
1091
<span class="term"><em class="parameter"><code>glyphs</code></em> :</span></td>
1097
<span class="term"><em class="parameter"><code>n_glyphs</code></em> :</span></td>
1103
<span class="term"><em class="parameter"><code>clusters</code></em> :</span></td>
1109
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1111
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
1112
><code class="literal">FALSE</code></a>, always.
1119
<div class="refsect2" lang="en">
1120
<a name="id3161009"></a><h3>
1121
<a name="pango-x-fallback-shape"></a>pango_x_fallback_shape ()</h3>
1122
<a class="indexterm" name="id3161024"></a><pre class="programlisting">void pango_x_fallback_shape (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
1123
<a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
1126
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1127
<h3 class="title">Warning</h3>
1128
<p><code class="literal">pango_x_fallback_shape</code> is deprecated and should not be used in newly-written code.</p>
1131
This is a simple fallback shaper, that can be used
1132
if no subfont that supports a given script is found.
1133
For every character in <em class="parameter"><code>text</code></em>, it puts the unknown glyph.</p>
1137
<div class="variablelist"><table border="0">
1138
<col align="left" valign="top">
1142
<span class="term"><em class="parameter"><code>font</code></em> :</span></td>
1143
<td> A <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
1148
<span class="term"><em class="parameter"><code>glyphs</code></em> :</span></td>
1149
<td> A pointer to a <a href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a>.
1154
<span class="term"><em class="parameter"><code>text</code></em> :</span></td>
1160
<span class="term"><em class="parameter"><code>n_chars</code></em> :</span></td>
1161
<td> Number of UTF-8 seqs in <em class="parameter"><code>text</code></em>.
1168
<div class="refsect2" lang="en">
1169
<a name="id3161181"></a><h3>
1170
<a name="PangoXFontCache"></a>PangoXFontCache</h3>
1171
<a class="indexterm" name="id3161196"></a><pre class="programlisting">typedef struct _PangoXFontCache PangoXFontCache;</pre>
1172
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1173
<h3 class="title">Warning</h3>
1174
<p><code class="literal">PangoXFontCache</code> is deprecated and should not be used in newly-written code.</p>
1177
A <a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache"><span class="type">PangoXFontCache</span></a> caches
1178
<span class="type">XFontStructs</span> for a single display by their XLFD name.
1182
<div class="refsect2" lang="en">
1183
<a name="id3161237"></a><h3>
1184
<a name="pango-x-font-cache-new"></a>pango_x_font_cache_new ()</h3>
1185
<a class="indexterm" name="id3161252"></a><pre class="programlisting"><a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a>* pango_x_font_cache_new (Display *display);</pre>
1186
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1187
<h3 class="title">Warning</h3>
1188
<p><code class="literal">pango_x_font_cache_new</code> is deprecated and should not be used in newly-written code.</p>
1191
Creates a font cache for the specified display.</p>
1195
<div class="variablelist"><table border="0">
1196
<col align="left" valign="top">
1200
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
1206
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1207
<td> The newly allocated <a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache"><span class="type">PangoXFontCache</span></a>, which should be
1208
freed with <a href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-free"><code class="function">pango_x_font_cache_free()</code></a>.
1215
<div class="refsect2" lang="en">
1216
<a name="id3161346"></a><h3>
1217
<a name="pango-x-font-cache-free"></a>pango_x_font_cache_free ()</h3>
1218
<a class="indexterm" name="id3161362"></a><pre class="programlisting">void pango_x_font_cache_free (<a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a> *cache);</pre>
1219
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1220
<h3 class="title">Warning</h3>
1221
<p><code class="literal">pango_x_font_cache_free</code> is deprecated and should not be used in newly-written code.</p>
1224
Frees a <a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache"><span class="type">PangoXFontCache</span></a> and all associated memory. All fonts loaded
1225
through this font cache will be freed along with the cache.</p>
1229
<div class="variablelist"><table border="0">
1230
<col align="left" valign="top">
1233
<span class="term"><em class="parameter"><code>cache</code></em> :</span></td>
1234
<td> a <a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache"><span class="type">PangoXFontCache</span></a>
1240
<div class="refsect2" lang="en">
1241
<a name="id3161443"></a><h3>
1242
<a name="pango-x-font-cache-load"></a>pango_x_font_cache_load ()</h3>
1243
<a class="indexterm" name="id3161458"></a><pre class="programlisting">XFontStruct* pango_x_font_cache_load (<a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a> *cache,
1244
const char *xlfd);</pre>
1245
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1246
<h3 class="title">Warning</h3>
1247
<p><code class="literal">pango_x_font_cache_load</code> is deprecated and should not be used in newly-written code.</p>
1250
Loads a <span class="type">XFontStruct</span> from a X Logical Font Description. The
1251
result may be newly loaded, or it may have been previously
1256
<div class="variablelist"><table border="0">
1257
<col align="left" valign="top">
1261
<span class="term"><em class="parameter"><code>cache</code></em> :</span></td>
1262
<td> a <a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache"><span class="type">PangoXFontCache</span></a>
1267
<span class="term"><em class="parameter"><code>xlfd</code></em> :</span></td>
1268
<td> the X Logical Font Description to load.
1273
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1274
<td> The font structure, or <a
1275
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
1276
><code class="literal">NULL</code></a> if the font could
1277
not be loaded. In order to free this structure, you must call
1278
<a href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-unload"><code class="function">pango_x_font_cache_unload()</code></a>.
1285
<div class="refsect2" lang="en">
1286
<a name="id3161593"></a><h3>
1287
<a name="pango-x-font-cache-unload"></a>pango_x_font_cache_unload ()</h3>
1288
<a class="indexterm" name="id3161609"></a><pre class="programlisting">void pango_x_font_cache_unload (<a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache">PangoXFontCache</a> *cache,
1289
XFontStruct *fs);</pre>
1290
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1291
<h3 class="title">Warning</h3>
1292
<p><code class="literal">pango_x_font_cache_unload</code> is deprecated and should not be used in newly-written code.</p>
1295
Frees a font structure previously loaded with <a href="pango-X-Fonts-and-Rendering.html#pango-x-font-cache-load"><code class="function">pango_x_font_cache_load()</code></a>.</p>
1299
<div class="variablelist"><table border="0">
1300
<col align="left" valign="top">
1304
<span class="term"><em class="parameter"><code>cache</code></em> :</span></td>
1305
<td> a <a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache"><span class="type">PangoXFontCache</span></a>
1310
<span class="term"><em class="parameter"><code>fs</code></em> :</span></td>
1311
<td> the font structure to unload