~ubuntu-branches/ubuntu/karmic/pango1.0/karmic-security

« back to all changes in this revision

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

Tags: upstream-1.15.4
ImportĀ upstreamĀ versionĀ 1.15.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=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">
 
27
</head>
 
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">
 
30
<tr valign="middle">
 
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>
 
36
</tr>
 
37
<tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>
 
38
                  &#160;|&#160;
 
39
                  <a href="#desc" class="shortcut">Description</a></nobr></td></tr>
 
40
</table>
 
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>
 
44
<td valign="top">
 
45
<h2><span class="refentrytitle"><a name="top_of_page"></a>Deprecated X font backend</span></h2>
 
46
<p>Deprecated X font backend &#8212; Font handling and rendering with the deprecated X font backend</p>
 
47
</td>
 
48
<td valign="top" align="right"></td>
 
49
</tr></table></div>
 
50
<div class="refsynopsisdiv">
 
51
<a name="synopsis"></a><h2>Synopsis</h2>
 
52
<pre class="synopsis">
 
53
 
 
54
 
 
55
 
 
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,
 
63
                                             GC base_gc);
 
64
void        (<a href="pango-X-Fonts-and-Rendering.html#PangoFreeGCFunc">*PangoFreeGCFunc</a>)              (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
 
65
                                             GC gc);
 
66
void        <a href="pango-X-Fonts-and-Rendering.html#pango-x-render">pango_x_render</a>                  (Display *display,
 
67
                                             Drawable d,
 
68
                                             GC gc,
 
69
                                             <a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 
70
                                             <a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
 
71
                                             <a
 
72
href="../glib/glib-Basic-Types.html#gint"
 
73
>gint</a> x,
 
74
                                             <a
 
75
href="../glib/glib-Basic-Types.html#gint"
 
76
>gint</a> y);
 
77
void        <a href="pango-X-Fonts-and-Rendering.html#pango-x-render-layout-line">pango_x_render_layout_line</a>      (Display *display,
 
78
                                             Drawable drawable,
 
79
                                             GC gc,
 
80
                                             <a href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line,
 
81
                                             int x,
 
82
                                             int y);
 
83
void        <a href="pango-X-Fonts-and-Rendering.html#pango-x-render-layout">pango_x_render_layout</a>           (Display *display,
 
84
                                             Drawable drawable,
 
85
                                             GC gc,
 
86
                                             <a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
 
87
                                             int x,
 
88
                                             int y);
 
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,
 
94
                                             const <a
 
95
href="../glib/glib-Basic-Types.html#gchar"
 
96
>gchar</a> *spec);
 
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);
 
98
<a
 
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,
 
103
                                             char **charsets,
 
104
                                             int n_charsets,
 
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);
 
113
<a
 
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,
 
116
                                             char **charsets,
 
117
                                             int n_charsets,
 
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,
 
120
                                             <a
 
121
href="../glib/glib-Unicode-Manipulation.html#gunichar"
 
122
>gunichar</a> wc);
 
123
<a
 
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,
 
127
                                             <a
 
128
href="../glib/glib-Unicode-Manipulation.html#gunichar"
 
129
>gunichar</a> **glyphs,
 
130
                                             int *n_glyphs,
 
131
                                             int **clusters);
 
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,
 
134
                                             const char *text,
 
135
                                             int n_chars);
 
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,
 
140
                                             const char *xlfd);
 
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,
 
142
                                             XFontStruct *fs);
 
143
</pre>
 
144
</div>
 
145
<div class="refsect1" lang="en">
 
146
<a name="desc"></a><h2>Description</h2>
 
147
<p>
 
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.
 
153
</p>
 
154
</div>
 
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"
 
161
</pre>
 
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>
 
165
</div>
 
166
<p>
 
167
A string constant identifying the X renderer. The associated quark (see 
 
168
<a
 
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>. 
 
171
</p>
 
172
</div>
 
173
<hr>
 
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>
 
181
</div>
 
182
<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
 
184
given display.</p>
 
185
<p>
 
186
 
 
187
</p>
 
188
<div class="variablelist"><table border="0">
 
189
<col align="left" valign="top">
 
190
<tbody>
 
191
<tr>
 
192
<td>
 
193
<span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></td>
 
194
<td> an X display (As returned by <code class="function">XOpenDisplay()</code>.)
 
195
</td>
 
196
</tr>
 
197
<tr>
 
198
<td>
 
199
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
200
<td> the new <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
 
201
</td>
 
202
</tr>
 
203
</tbody>
 
204
</table></div>
 
205
</div>
 
206
<hr>
 
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>
 
216
</div>
 
217
<p>
 
218
Sets the functions that will be used to get GC's in various colors when
 
219
rendering layouts with this context.</p>
 
220
<p>
 
221
 
 
222
</p>
 
223
<div class="variablelist"><table border="0">
 
224
<col align="left" valign="top">
 
225
<tbody>
 
226
<tr>
 
227
<td>
 
228
<span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
229
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
 
230
</td>
 
231
</tr>
 
232
<tr>
 
233
<td>
 
234
<span class="term"><em class="parameter"><code>get_gc_func</code></em>&#160;:</span></td>
 
235
<td> function called to create a new GC for a given color.
 
236
</td>
 
237
</tr>
 
238
<tr>
 
239
<td>
 
240
<span class="term"><em class="parameter"><code>free_gc_func</code></em>&#160;:</span></td>
 
241
<td> function called to free a GC created with <em class="parameter"><code>get_gc_func</code></em>.
 
242
</td>
 
243
</tr>
 
244
</tbody>
 
245
</table></div>
 
246
</div>
 
247
<hr>
 
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,
 
253
                                             GC base_gc);</pre>
 
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>
 
257
</div>
 
258
<p>
 
259
Specifies the type of the function used to create a new GC for a given
 
260
color. 
 
261
</p>
 
262
<div class="variablelist"><table border="0">
 
263
<col align="left" valign="top">
 
264
<tbody>
 
265
<tr>
 
266
<td>
 
267
<span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
268
<td>a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
 
269
</td>
 
270
</tr>
 
271
<tr>
 
272
<td>
 
273
<span class="term"><em class="parameter"><code>color</code></em>&#160;:</span></td>
 
274
<td>the color to create a new GC for.
 
275
</td>
 
276
</tr>
 
277
<tr>
 
278
<td>
 
279
<span class="term"><em class="parameter"><code>base_gc</code></em>&#160;:</span></td>
 
280
<td>the GC to base the new GC on.
 
281
</td>
 
282
</tr>
 
283
<tr>
 
284
<td>
 
285
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
286
<td>the new GC.
 
287
 
 
288
 
 
289
</td>
 
290
</tr>
 
291
</tbody>
 
292
</table></div>
 
293
</div>
 
294
<hr>
 
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,
 
299
                                             GC gc);</pre>
 
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>
 
303
</div>
 
304
<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.
 
307
</p>
 
308
<div class="variablelist"><table border="0">
 
309
<col align="left" valign="top">
 
310
<tbody>
 
311
<tr>
 
312
<td>
 
313
<span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
314
<td>a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
 
315
</td>
 
316
</tr>
 
317
<tr>
 
318
<td>
 
319
<span class="term"><em class="parameter"><code>gc</code></em>&#160;:</span></td>
 
320
<td>the GC to free.
 
321
 
 
322
 
 
323
</td>
 
324
</tr>
 
325
</tbody>
 
326
</table></div>
 
327
</div>
 
328
<hr>
 
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,
 
333
                                             Drawable d,
 
334
                                             GC gc,
 
335
                                             <a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
 
336
                                             <a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
 
337
                                             <a
 
338
href="../glib/glib-Basic-Types.html#gint"
 
339
>gint</a> x,
 
340
                                             <a
 
341
href="../glib/glib-Basic-Types.html#gint"
 
342
>gint</a> y);</pre>
 
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>
 
346
</div>
 
347
<p>
 
348
Renders a <a href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> onto an X drawable.</p>
 
349
<p>
 
350
 
 
351
</p>
 
352
<div class="variablelist"><table border="0">
 
353
<col align="left" valign="top">
 
354
<tbody>
 
355
<tr>
 
356
<td>
 
357
<span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></td>
 
358
<td> the X display.
 
359
</td>
 
360
</tr>
 
361
<tr>
 
362
<td>
 
363
<span class="term"><em class="parameter"><code>d</code></em>&#160;:</span></td>
 
364
<td>       the drawable on which to draw string.
 
365
</td>
 
366
</tr>
 
367
<tr>
 
368
<td>
 
369
<span class="term"><em class="parameter"><code>gc</code></em>&#160;:</span></td>
 
370
<td>      the graphics context.
 
371
</td>
 
372
</tr>
 
373
<tr>
 
374
<td>
 
375
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
376
<td>    the font in which to draw the string.
 
377
</td>
 
378
</tr>
 
379
<tr>
 
380
<td>
 
381
<span class="term"><em class="parameter"><code>glyphs</code></em>&#160;:</span></td>
 
382
<td>  the glyph string to draw.
 
383
</td>
 
384
</tr>
 
385
<tr>
 
386
<td>
 
387
<span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></td>
 
388
<td>       the x position of start of string (in pixels).
 
389
</td>
 
390
</tr>
 
391
<tr>
 
392
<td>
 
393
<span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></td>
 
394
<td>       the y position of baseline (in pixels).
 
395
</td>
 
396
</tr>
 
397
</tbody>
 
398
</table></div>
 
399
</div>
 
400
<hr>
 
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,
 
405
                                             Drawable drawable,
 
406
                                             GC gc,
 
407
                                             <a href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line,
 
408
                                             int x,
 
409
                                             int y);</pre>
 
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>
 
413
</div>
 
414
<p>
 
415
Renders a <a href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> onto an X drawable.</p>
 
416
<p>
 
417
 
 
418
</p>
 
419
<div class="variablelist"><table border="0">
 
420
<col align="left" valign="top">
 
421
<tbody>
 
422
<tr>
 
423
<td>
 
424
<span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></td>
 
425
<td>   the X display.
 
426
</td>
 
427
</tr>
 
428
<tr>
 
429
<td>
 
430
<span class="term"><em class="parameter"><code>drawable</code></em>&#160;:</span></td>
 
431
<td>  the drawable on which to draw.
 
432
</td>
 
433
</tr>
 
434
<tr>
 
435
<td>
 
436
<span class="term"><em class="parameter"><code>gc</code></em>&#160;:</span></td>
 
437
<td>        GC to use for uncolored drawing.
 
438
</td>
 
439
</tr>
 
440
<tr>
 
441
<td>
 
442
<span class="term"><em class="parameter"><code>line</code></em>&#160;:</span></td>
 
443
<td>      a <a href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>.
 
444
</td>
 
445
</tr>
 
446
<tr>
 
447
<td>
 
448
<span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></td>
 
449
<td>         the x position of start of string (in pixels).
 
450
</td>
 
451
</tr>
 
452
<tr>
 
453
<td>
 
454
<span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></td>
 
455
<td>         the y position of baseline (in pixels).
 
456
</td>
 
457
</tr>
 
458
</tbody>
 
459
</table></div>
 
460
</div>
 
461
<hr>
 
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,
 
466
                                             Drawable drawable,
 
467
                                             GC gc,
 
468
                                             <a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
 
469
                                             int x,
 
470
                                             int y);</pre>
 
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>
 
474
</div>
 
475
<p>
 
476
Renders a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> onto an X drawable.</p>
 
477
<p>
 
478
 
 
479
</p>
 
480
<div class="variablelist"><table border="0">
 
481
<col align="left" valign="top">
 
482
<tbody>
 
483
<tr>
 
484
<td>
 
485
<span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></td>
 
486
<td>   the X display.
 
487
</td>
 
488
</tr>
 
489
<tr>
 
490
<td>
 
491
<span class="term"><em class="parameter"><code>drawable</code></em>&#160;:</span></td>
 
492
<td>  the drawable on which to draw.
 
493
</td>
 
494
</tr>
 
495
<tr>
 
496
<td>
 
497
<span class="term"><em class="parameter"><code>gc</code></em>&#160;:</span></td>
 
498
<td>        GC to use for uncolored drawing.
 
499
</td>
 
500
</tr>
 
501
<tr>
 
502
<td>
 
503
<span class="term"><em class="parameter"><code>layout</code></em>&#160;:</span></td>
 
504
<td>    a <a href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.
 
505
</td>
 
506
</tr>
 
507
<tr>
 
508
<td>
 
509
<span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></td>
 
510
<td>         the x position of the left of the layout (in pixels).
 
511
</td>
 
512
</tr>
 
513
<tr>
 
514
<td>
 
515
<span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></td>
 
516
<td>         the y position of the top of the layout (in pixels).
 
517
</td>
 
518
</tr>
 
519
</tbody>
 
520
</table></div>
 
521
</div>
 
522
<hr>
 
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;
 
527
</pre>
 
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>
 
531
</div>
 
532
<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>.
 
535
</p>
 
536
</div>
 
537
<hr>
 
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)&lt;&lt;16 | (index_))
 
542
</pre>
 
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>
 
546
</div>
 
547
<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.
 
550
</p>
 
551
<div class="variablelist"><table border="0">
 
552
<col align="left" valign="top">
 
553
<tbody>
 
554
<tr>
 
555
<td>
 
556
<span class="term"><em class="parameter"><code>subfont</code></em>&#160;:</span></td>
 
557
<td>a <a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont"><span class="type">PangoXSubfont</span></a> index
 
558
</td>
 
559
</tr>
 
560
<tr>
 
561
<td>
 
562
<span class="term"><em class="parameter"><code>index_</code></em>&#160;:</span></td>
 
563
<td>the index of a character within an X font.
 
564
 
 
565
 
 
566
</td>
 
567
</tr>
 
568
</tbody>
 
569
</table></div>
 
570
</div>
 
571
<hr>
 
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)&gt;&gt;16)
 
576
</pre>
 
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>
 
580
</div>
 
581
<p>
 
582
Extract the subfont index from a glyph index.
 
583
</p>
 
584
<div class="variablelist"><table border="0">
 
585
<col align="left" valign="top">
 
586
<tbody><tr>
 
587
<td>
 
588
<span class="term"><em class="parameter"><code>glyph</code></em>&#160;:</span></td>
 
589
<td>a <span class="type">PangoGlyphIndex</span>
 
590
 
 
591
 
 
592
</td>
 
593
</tr></tbody>
 
594
</table></div>
 
595
</div>
 
596
<hr>
 
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) &amp; 0xffff)
 
601
</pre>
 
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>
 
605
</div>
 
606
<p>
 
607
Extract the character index within the X font from a
 
608
glyph index.
 
609
</p>
 
610
<div class="variablelist"><table border="0">
 
611
<col align="left" valign="top">
 
612
<tbody><tr>
 
613
<td>
 
614
<span class="term"><em class="parameter"><code>glyph</code></em>&#160;:</span></td>
 
615
<td>a <span class="type">PangoGlyphIndex</span>
 
616
 
 
617
 
 
618
</td>
 
619
</tr></tbody>
 
620
</table></div>
 
621
</div>
 
622
<hr>
 
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,
 
627
                                             const <a
 
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>
 
633
</div>
 
634
<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
 
639
be avoided.</p>
 
640
<p>
 
641
 
 
642
</p>
 
643
<div class="variablelist"><table border="0">
 
644
<col align="left" valign="top">
 
645
<tbody>
 
646
<tr>
 
647
<td>
 
648
<span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></td>
 
649
<td> the X display.
 
650
</td>
 
651
</tr>
 
652
<tr>
 
653
<td>
 
654
<span class="term"><em class="parameter"><code>spec</code></em>&#160;:</span></td>
 
655
<td>    a comma-separated list of XLFD's.
 
656
</td>
 
657
</tr>
 
658
<tr>
 
659
<td>
 
660
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
661
<td>a new <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 
662
</td>
 
663
</tr>
 
664
</tbody>
 
665
</table></div>
 
666
</div>
 
667
<hr>
 
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>
 
675
</div>
 
676
<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>
 
682
<p>
 
683
 
 
684
</p>
 
685
<div class="variablelist"><table border="0">
 
686
<col align="left" valign="top">
 
687
<tbody>
 
688
<tr>
 
689
<td>
 
690
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
691
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 
692
</td>
 
693
</tr>
 
694
<tr>
 
695
<td>
 
696
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
697
<td> a glyph index into <em class="parameter"><code>font</code></em>.
 
698
</td>
 
699
</tr>
 
700
</tbody>
 
701
</table></div>
 
702
</div>
 
703
<hr>
 
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>
 
714
</div>
 
715
<p>
 
716
Checks if the given glyph is present in a X font.</p>
 
717
<p>
 
718
 
 
719
</p>
 
720
<div class="variablelist"><table border="0">
 
721
<col align="left" valign="top">
 
722
<tbody>
 
723
<tr>
 
724
<td>
 
725
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
726
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the X backend.
 
727
</td>
 
728
</tr>
 
729
<tr>
 
730
<td>
 
731
<span class="term"><em class="parameter"><code>glyph</code></em>&#160;:</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)
 
734
</td>
 
735
</tr>
 
736
<tr>
 
737
<td>
 
738
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
739
<td> <a
 
740
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
 
741
><code class="literal">TRUE</code></a> if the glyph is present.
 
742
</td>
 
743
</tr>
 
744
</tbody>
 
745
</table></div>
 
746
</div>
 
747
<hr>
 
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,
 
752
                                             char **charsets,
 
753
                                             int n_charsets,
 
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>
 
759
</div>
 
760
<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>
 
763
<p>
 
764
 
 
765
</p>
 
766
<div class="variablelist"><table border="0">
 
767
<col align="left" valign="top">
 
768
<tbody>
 
769
<tr>
 
770
<td>
 
771
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
772
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 
773
</td>
 
774
</tr>
 
775
<tr>
 
776
<td>
 
777
<span class="term"><em class="parameter"><code>charsets</code></em>&#160;:</span></td>
 
778
<td> the charsets to list subfonts for.
 
779
</td>
 
780
</tr>
 
781
<tr>
 
782
<td>
 
783
<span class="term"><em class="parameter"><code>n_charsets</code></em>&#160;:</span></td>
 
784
<td> the number of charsets in <em class="parameter"><code>charsets</code></em>.
 
785
</td>
 
786
</tr>
 
787
<tr>
 
788
<td>
 
789
<span class="term"><em class="parameter"><code>subfont_ids</code></em>&#160;:</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>.
 
794
</td>
 
795
</tr>
 
796
<tr>
 
797
<td>
 
798
<span class="term"><em class="parameter"><code>subfont_charsets</code></em>&#160;:</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>.
 
803
</td>
 
804
</tr>
 
805
<tr>
 
806
<td>
 
807
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</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>.
 
810
</td>
 
811
</tr>
 
812
</tbody>
 
813
</table></div>
 
814
</div>
 
815
<hr>
 
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>
 
823
</div>
 
824
<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>
 
828
<p>
 
829
 
 
830
</p>
 
831
<div class="variablelist"><table border="0">
 
832
<col align="left" valign="top">
 
833
<tbody>
 
834
<tr>
 
835
<td>
 
836
<span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></td>
 
837
<td> an X <span class="type">Display</span>.
 
838
</td>
 
839
</tr>
 
840
<tr>
 
841
<td>
 
842
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
843
<td> a <span class="type">PangoXFontMap</span> for <em class="parameter"><code>display</code></em>.
 
844
</td>
 
845
</tr>
 
846
</tbody>
 
847
</table></div>
 
848
</div>
 
849
<hr>
 
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>
 
857
</div>
 
858
<p>
 
859
Free cached resources for the given X display structure.</p>
 
860
<p>
 
861
 
 
862
</p>
 
863
<div class="variablelist"><table border="0">
 
864
<col align="left" valign="top">
 
865
<tbody><tr>
 
866
<td>
 
867
<span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></td>
 
868
<td> an X <span class="type">Display</span>
 
869
</td>
 
870
</tr></tbody>
 
871
</table></div>
 
872
</div>
 
873
<hr>
 
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>
 
882
</div>
 
883
<p>
 
884
Obtains the font cache associated with the given font map.</p>
 
885
<p>
 
886
 
 
887
</p>
 
888
<div class="variablelist"><table border="0">
 
889
<col align="left" valign="top">
 
890
<tbody>
 
891
<tr>
 
892
<td>
 
893
<span class="term"><em class="parameter"><code>font_map</code></em>&#160;:</span></td>
 
894
<td> a <span class="type">PangoXFontMap</span>.
 
895
</td>
 
896
</tr>
 
897
<tr>
 
898
<td>
 
899
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</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>.
 
901
</td>
 
902
</tr>
 
903
</tbody>
 
904
</table></div>
 
905
</div>
 
906
<hr>
 
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>
 
915
</div>
 
916
<p>
 
917
Determines the X Logical Font Description for the specified
 
918
subfont.</p>
 
919
<p>
 
920
 
 
921
</p>
 
922
<div class="variablelist"><table border="0">
 
923
<col align="left" valign="top">
 
924
<tbody>
 
925
<tr>
 
926
<td>
 
927
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
928
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> which must be from the X backend.
 
929
</td>
 
930
</tr>
 
931
<tr>
 
932
<td>
 
933
<span class="term"><em class="parameter"><code>subfont_id</code></em>&#160;:</span></td>
 
934
<td> the id of a subfont within the font.
 
935
</td>
 
936
</tr>
 
937
<tr>
 
938
<td>
 
939
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</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>.
 
944
</td>
 
945
</tr>
 
946
</tbody>
 
947
</table></div>
 
948
</div>
 
949
<hr>
 
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,
 
956
                                             char **charsets,
 
957
                                             int n_charsets,
 
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>
 
962
</div>
 
963
<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>
 
966
<p>
 
967
 
 
968
</p>
 
969
<div class="variablelist"><table border="0">
 
970
<col align="left" valign="top">
 
971
<tbody>
 
972
<tr>
 
973
<td>
 
974
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
975
<td> A <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 
976
</td>
 
977
</tr>
 
978
<tr>
 
979
<td>
 
980
<span class="term"><em class="parameter"><code>charsets</code></em>&#160;:</span></td>
 
981
<td> An array of charsets.
 
982
</td>
 
983
</tr>
 
984
<tr>
 
985
<td>
 
986
<span class="term"><em class="parameter"><code>n_charsets</code></em>&#160;:</span></td>
 
987
<td> The number of charsets in <em class="parameter"><code>charsets</code></em>.
 
988
</td>
 
989
</tr>
 
990
<tr>
 
991
<td>
 
992
<span class="term"><em class="parameter"><code>rfont</code></em>&#160;:</span></td>
 
993
<td> A pointer to a <a href="pango-X-Fonts-and-Rendering.html#PangoXSubfont"><span class="type">PangoXSubfont</span></a>.
 
994
</td>
 
995
</tr>
 
996
<tr>
 
997
<td>
 
998
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
999
<td> <a
 
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.
 
1002
</td>
 
1003
</tr>
 
1004
</tbody>
 
1005
</table></div>
 
1006
</div>
 
1007
<hr>
 
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,
 
1012
                                             <a
 
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>
 
1018
</div>
 
1019
<p>
 
1020
Returns the index of a glyph suitable for drawing <em class="parameter"><code>wc</code></em> as an
 
1021
unknown character.
 
1022
</p>
 
1023
<p>
 
1024
Use <a href="pango-Glyph-Storage.html#PANGO-GET-UNKNOWN-GLYPH:CAPS"><code class="function">PANGO_GET_UNKNOWN_GLYPH()</code></a> instead.</p>
 
1025
<p>
 
1026
 
 
1027
</p>
 
1028
<div class="variablelist"><table border="0">
 
1029
<col align="left" valign="top">
 
1030
<tbody>
 
1031
<tr>
 
1032
<td>
 
1033
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
1034
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 
1035
</td>
 
1036
</tr>
 
1037
<tr>
 
1038
<td>
 
1039
<span class="term"><em class="parameter"><code>wc</code></em>&#160;:</span></td>
 
1040
<td> the Unicode character for which a glyph is needed.
 
1041
</td>
 
1042
</tr>
 
1043
<tr>
 
1044
<td>
 
1045
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1046
<td> a glyph index into <em class="parameter"><code>font</code></em>.
 
1047
</td>
 
1048
</tr>
 
1049
</tbody>
 
1050
</table></div>
 
1051
</div>
 
1052
<hr>
 
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,
 
1060
                                             <a
 
1061
href="../glib/glib-Unicode-Manipulation.html#gunichar"
 
1062
>gunichar</a> **glyphs,
 
1063
                                             int *n_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>
 
1068
</div>
 
1069
<p>
 
1070
Previously did subfont-specific ligation. Now a no-op.</p>
 
1071
<p>
 
1072
 
 
1073
</p>
 
1074
<div class="variablelist"><table border="0">
 
1075
<col align="left" valign="top">
 
1076
<tbody>
 
1077
<tr>
 
1078
<td>
 
1079
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
1080
<td> unused
 
1081
</td>
 
1082
</tr>
 
1083
<tr>
 
1084
<td>
 
1085
<span class="term"><em class="parameter"><code>subfont</code></em>&#160;:</span></td>
 
1086
<td> unused
 
1087
</td>
 
1088
</tr>
 
1089
<tr>
 
1090
<td>
 
1091
<span class="term"><em class="parameter"><code>glyphs</code></em>&#160;:</span></td>
 
1092
<td> unused
 
1093
</td>
 
1094
</tr>
 
1095
<tr>
 
1096
<td>
 
1097
<span class="term"><em class="parameter"><code>n_glyphs</code></em>&#160;:</span></td>
 
1098
<td> unused
 
1099
</td>
 
1100
</tr>
 
1101
<tr>
 
1102
<td>
 
1103
<span class="term"><em class="parameter"><code>clusters</code></em>&#160;:</span></td>
 
1104
<td> unused
 
1105
</td>
 
1106
</tr>
 
1107
<tr>
 
1108
<td>
 
1109
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1110
<td> <a
 
1111
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
 
1112
><code class="literal">FALSE</code></a>, always.
 
1113
</td>
 
1114
</tr>
 
1115
</tbody>
 
1116
</table></div>
 
1117
</div>
 
1118
<hr>
 
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,
 
1124
                                             const char *text,
 
1125
                                             int n_chars);</pre>
 
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>
 
1129
</div>
 
1130
<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>
 
1134
<p>
 
1135
 
 
1136
</p>
 
1137
<div class="variablelist"><table border="0">
 
1138
<col align="left" valign="top">
 
1139
<tbody>
 
1140
<tr>
 
1141
<td>
 
1142
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
 
1143
<td> A <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
 
1144
</td>
 
1145
</tr>
 
1146
<tr>
 
1147
<td>
 
1148
<span class="term"><em class="parameter"><code>glyphs</code></em>&#160;:</span></td>
 
1149
<td> A pointer to a <a href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a>.
 
1150
</td>
 
1151
</tr>
 
1152
<tr>
 
1153
<td>
 
1154
<span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
 
1155
<td> UTF-8 string.
 
1156
</td>
 
1157
</tr>
 
1158
<tr>
 
1159
<td>
 
1160
<span class="term"><em class="parameter"><code>n_chars</code></em>&#160;:</span></td>
 
1161
<td> Number of UTF-8 seqs in <em class="parameter"><code>text</code></em>.
 
1162
</td>
 
1163
</tr>
 
1164
</tbody>
 
1165
</table></div>
 
1166
</div>
 
1167
<hr>
 
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>
 
1175
</div>
 
1176
<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. 
 
1179
</p>
 
1180
</div>
 
1181
<hr>
 
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>
 
1189
</div>
 
1190
<p>
 
1191
Creates a font cache for the specified display.</p>
 
1192
<p>
 
1193
 
 
1194
</p>
 
1195
<div class="variablelist"><table border="0">
 
1196
<col align="left" valign="top">
 
1197
<tbody>
 
1198
<tr>
 
1199
<td>
 
1200
<span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></td>
 
1201
<td> an X display.
 
1202
</td>
 
1203
</tr>
 
1204
<tr>
 
1205
<td>
 
1206
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</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>.
 
1209
</td>
 
1210
</tr>
 
1211
</tbody>
 
1212
</table></div>
 
1213
</div>
 
1214
<hr>
 
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>
 
1222
</div>
 
1223
<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>
 
1226
<p>
 
1227
 
 
1228
</p>
 
1229
<div class="variablelist"><table border="0">
 
1230
<col align="left" valign="top">
 
1231
<tbody><tr>
 
1232
<td>
 
1233
<span class="term"><em class="parameter"><code>cache</code></em>&#160;:</span></td>
 
1234
<td> a <a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache"><span class="type">PangoXFontCache</span></a>
 
1235
</td>
 
1236
</tr></tbody>
 
1237
</table></div>
 
1238
</div>
 
1239
<hr>
 
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>
 
1248
</div>
 
1249
<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
 
1252
stored.</p>
 
1253
<p>
 
1254
 
 
1255
</p>
 
1256
<div class="variablelist"><table border="0">
 
1257
<col align="left" valign="top">
 
1258
<tbody>
 
1259
<tr>
 
1260
<td>
 
1261
<span class="term"><em class="parameter"><code>cache</code></em>&#160;:</span></td>
 
1262
<td> a <a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache"><span class="type">PangoXFontCache</span></a>
 
1263
</td>
 
1264
</tr>
 
1265
<tr>
 
1266
<td>
 
1267
<span class="term"><em class="parameter"><code>xlfd</code></em>&#160;:</span></td>
 
1268
<td> the X Logical Font Description to load.
 
1269
</td>
 
1270
</tr>
 
1271
<tr>
 
1272
<td>
 
1273
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</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>.
 
1279
</td>
 
1280
</tr>
 
1281
</tbody>
 
1282
</table></div>
 
1283
</div>
 
1284
<hr>
 
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>
 
1293
</div>
 
1294
<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>
 
1296
<p>
 
1297
 
 
1298
</p>
 
1299
<div class="variablelist"><table border="0">
 
1300
<col align="left" valign="top">
 
1301
<tbody>
 
1302
<tr>
 
1303
<td>
 
1304
<span class="term"><em class="parameter"><code>cache</code></em>&#160;:</span></td>
 
1305
<td> a <a href="pango-X-Fonts-and-Rendering.html#PangoXFontCache"><span class="type">PangoXFontCache</span></a>
 
1306
</td>
 
1307
</tr>
 
1308
<tr>
 
1309
<td>
 
1310
<span class="term"><em class="parameter"><code>fs</code></em>&#160;:</span></td>
 
1311
<td> the font structure to unload
 
1312
</td>
 
1313
</tr>
 
1314
</tbody>
 
1315
</table></div>
 
1316
</div>
 
1317
</div>
 
1318
</div>
 
1319
</body>
 
1320
</html>