~ubuntu-branches/debian/sid/pango1.0/sid

« back to all changes in this revision

Viewing changes to docs/html/pango-Modules.html

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2014-03-20 18:01:45 UTC
  • mfrom: (1.9.3)
  • Revision ID: package-import@ubuntu.com-20140320180145-y2zs0pzp6390a6y9
Tags: 1.36.3-1
* Add xauth test-dep, needed for xvfb-run
* New upstream release
  - Fix builddir != srdir builds
    + Drop 0001-Fix-tests-for-builddir-srcdir-by-setting-G_TEST_-SRC.patch,
      which was a cherry-pick of this fix.
  - Avoid a crash when FT_Face is NULL
  - Update pango_color_parse docs

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="lowlevel.html" title="Low Level Functionality">
9
9
<link rel="prev" href="PangoEngineShape.html" title="PangoEngineShape">
10
10
<link rel="next" href="pango-Miscellaneous-Utilities.html" title="Miscellaneous Utilities">
11
 
<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.20.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
 
<td width="100%" align="left">
17
 
<a href="#" class="shortcut">Top</a>
18
 
                   | 
19
 
                  <a href="#pango-Modules.description" class="shortcut">Description</a>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
 
16
<td width="100%" align="left" class="shortcuts">
 
17
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
 
18
                  <a href="#pango-Modules.description" class="shortcut">Description</a></span>
20
19
</td>
21
20
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22
21
<td><a accesskey="u" href="lowlevel.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
30
29
<h2><span class="refentrytitle"><a name="pango-Modules.top_of_page"></a>Modules</span></h2>
31
30
<p>Modules — Support for loadable modules</p>
32
31
</td>
33
 
<td valign="top" align="right"></td>
 
32
<td class="gallery_image" valign="top" align="right"></td>
34
33
</tr></table></div>
35
 
<div class="refsynopsisdiv">
36
 
<a name="pango-Modules.synopsis"></a><h2>Synopsis</h2>
37
 
<pre class="synopsis">struct              <a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule">PangoIncludedModule</a>;
38
 
                    <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap">PangoMap</a>;
39
 
                    <a class="link" href="pango-Modules.html#PangoMapEntry" title="PangoMapEntry">PangoMapEntry</a>;
40
 
<a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="returnvalue">PangoMap</span></a> *          <a class="link" href="pango-Modules.html#pango-find-map" title="pango_find_map ()">pango_find_map</a>                      (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>,
41
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> engine_type_id</code></em>,
42
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> render_type_id</code></em>);
43
 
<a class="link" href="pango-Engines.html#PangoEngine"><span class="returnvalue">PangoEngine</span></a> *       <a class="link" href="pango-Modules.html#pango-map-get-engine" title="pango_map_get_engine ()">pango_map_get_engine</a>                (<em class="parameter"><code><a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> *map</code></em>,
44
 
                                                         <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> script</code></em>);
45
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Modules.html#pango-map-get-engines" title="pango_map_get_engines ()">pango_map_get_engines</a>               (<em class="parameter"><code><a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> *map</code></em>,
46
 
                                                         <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> script</code></em>,
47
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> **exact_engines</code></em>,
48
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> **fallback_engines</code></em>);
49
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Modules.html#pango-module-register" title="pango_module_register ()">pango_module_register</a>               (<em class="parameter"><code><a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a> *module</code></em>);
50
 
</pre>
 
34
<div class="refsect1">
 
35
<a name="pango-Modules.functions"></a><h2>Functions</h2>
 
36
<div class="informaltable"><table width="100%" border="0">
 
37
<colgroup>
 
38
<col width="150px" class="functions_return">
 
39
<col class="functions_name">
 
40
</colgroup>
 
41
<tbody>
 
42
<tr>
 
43
<td class="function_type">
 
44
<a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="returnvalue">PangoMap</span></a> *
 
45
</td>
 
46
<td class="function_name">
 
47
<a class="link" href="pango-Modules.html#pango-find-map" title="pango_find_map ()">pango_find_map</a> <span class="c_punctuation">()</span>
 
48
</td>
 
49
</tr>
 
50
<tr>
 
51
<td class="function_type">
 
52
<a class="link" href="pango-Engines.html#PangoEngine"><span class="returnvalue">PangoEngine</span></a> *
 
53
</td>
 
54
<td class="function_name">
 
55
<a class="link" href="pango-Modules.html#pango-map-get-engine" title="pango_map_get_engine ()">pango_map_get_engine</a> <span class="c_punctuation">()</span>
 
56
</td>
 
57
</tr>
 
58
<tr>
 
59
<td class="function_type">
 
60
<span class="returnvalue">void</span>
 
61
</td>
 
62
<td class="function_name">
 
63
<a class="link" href="pango-Modules.html#pango-map-get-engines" title="pango_map_get_engines ()">pango_map_get_engines</a> <span class="c_punctuation">()</span>
 
64
</td>
 
65
</tr>
 
66
<tr>
 
67
<td class="function_type">
 
68
<span class="returnvalue">void</span>
 
69
</td>
 
70
<td class="function_name">
 
71
<a class="link" href="pango-Modules.html#pango-module-register" title="pango_module_register ()">pango_module_register</a> <span class="c_punctuation">()</span>
 
72
</td>
 
73
</tr>
 
74
</tbody>
 
75
</table></div>
 
76
</div>
 
77
<div class="refsect1">
 
78
<a name="pango-Modules.other"></a><h2>Types and Values</h2>
 
79
<div class="informaltable"><table width="100%" border="0">
 
80
<colgroup>
 
81
<col width="150px" class="name">
 
82
<col class="description">
 
83
</colgroup>
 
84
<tbody>
 
85
<tr>
 
86
<td class="datatype_keyword">struct</td>
 
87
<td class="function_name"><a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule">PangoIncludedModule</a></td>
 
88
</tr>
 
89
<tr>
 
90
<td class="datatype_keyword"> </td>
 
91
<td class="function_name"><a class="link" href="pango-Modules.html#PangoMap" title="PangoMap">PangoMap</a></td>
 
92
</tr>
 
93
<tr>
 
94
<td class="datatype_keyword"> </td>
 
95
<td class="function_name"><a class="link" href="pango-Modules.html#PangoMapEntry" title="PangoMapEntry">PangoMapEntry</a></td>
 
96
</tr>
 
97
</tbody>
 
98
</table></div>
51
99
</div>
52
100
<div class="refsect1">
53
101
<a name="pango-Modules.description"></a><h2>Description</h2>
54
 
<p>
55
 
Functions and macros in this section are used to support loading dynamic
 
102
<p>Functions and macros in this section are used to support loading dynamic
56
103
modules that add engines to Pango at run time.</p>
57
104
</div>
58
105
<div class="refsect1">
59
 
<a name="pango-Modules.details"></a><h2>Details</h2>
 
106
<a name="pango-Modules.functions_details"></a><h2>Functions</h2>
 
107
<div class="refsect2">
 
108
<a name="pango-find-map"></a><h3>pango_find_map ()</h3>
 
109
<pre class="programlisting"><a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="returnvalue">PangoMap</span></a> *
 
110
pango_find_map (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>,
 
111
                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> engine_type_id</code></em>,
 
112
                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> render_type_id</code></em>);</pre>
 
113
<p>Locate a <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> for a particular engine type and render
 
114
type. The resulting map can be used to determine the engine
 
115
for each character.</p>
 
116
<div class="refsect3">
 
117
<a name="id-1.4.11.6.2.5"></a><h4>Parameters</h4>
 
118
<div class="informaltable"><table width="100%" border="0">
 
119
<colgroup>
 
120
<col width="150px" class="parameters_name">
 
121
<col class="parameters_description">
 
122
<col width="200px" class="parameters_annotations">
 
123
</colgroup>
 
124
<tbody>
 
125
<tr>
 
126
<td class="parameter_name"><p>language</p></td>
 
127
<td class="parameter_description"><p>the language tag for which to find the map</p></td>
 
128
<td class="parameter_annotations"> </td>
 
129
</tr>
 
130
<tr>
 
131
<td class="parameter_name"><p>engine_type_id</p></td>
 
132
<td class="parameter_description"><p>the engine type for the map to find</p></td>
 
133
<td class="parameter_annotations"> </td>
 
134
</tr>
 
135
<tr>
 
136
<td class="parameter_name"><p>render_type_id</p></td>
 
137
<td class="parameter_description"><p>the render type for the map to find</p></td>
 
138
<td class="parameter_annotations"> </td>
 
139
</tr>
 
140
</tbody>
 
141
</table></div>
 
142
</div>
 
143
<div class="refsect3">
 
144
<a name="id-1.4.11.6.2.6"></a><h4>Returns</h4>
 
145
<p> the suitable <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a>.</p>
 
146
<p></p>
 
147
</div>
 
148
</div>
 
149
<hr>
 
150
<div class="refsect2">
 
151
<a name="pango-map-get-engine"></a><h3>pango_map_get_engine ()</h3>
 
152
<pre class="programlisting"><a class="link" href="pango-Engines.html#PangoEngine"><span class="returnvalue">PangoEngine</span></a> *
 
153
pango_map_get_engine (<em class="parameter"><code><a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> *map</code></em>,
 
154
                      <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a> script</code></em>);</pre>
 
155
<p>Returns the best engine listed in the map for a given script</p>
 
156
<div class="refsect3">
 
157
<a name="id-1.4.11.6.3.5"></a><h4>Parameters</h4>
 
158
<div class="informaltable"><table width="100%" border="0">
 
159
<colgroup>
 
160
<col width="150px" class="parameters_name">
 
161
<col class="parameters_description">
 
162
<col width="200px" class="parameters_annotations">
 
163
</colgroup>
 
164
<tbody>
 
165
<tr>
 
166
<td class="parameter_name"><p>map</p></td>
 
167
<td class="parameter_description"><p>a <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a></p></td>
 
168
<td class="parameter_annotations"> </td>
 
169
</tr>
 
170
<tr>
 
171
<td class="parameter_name"><p>script</p></td>
 
172
<td class="parameter_description"><p>a <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a></p></td>
 
173
<td class="parameter_annotations"> </td>
 
174
</tr>
 
175
</tbody>
 
176
</table></div>
 
177
</div>
 
178
<div class="refsect3">
 
179
<a name="id-1.4.11.6.3.6"></a><h4>Returns</h4>
 
180
<p> the best engine, if one is listed for the script,
 
181
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The lookup may cause the engine to be loaded;
 
182
once an engine is loaded, it won't be unloaded. If multiple
 
183
engines are exact for the script, the choice of which is
 
184
returned is arbitrary.</p>
 
185
<p></p>
 
186
</div>
 
187
</div>
 
188
<hr>
 
189
<div class="refsect2">
 
190
<a name="pango-map-get-engines"></a><h3>pango_map_get_engines ()</h3>
 
191
<pre class="programlisting"><span class="returnvalue">void</span>
 
192
pango_map_get_engines (<em class="parameter"><code><a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> *map</code></em>,
 
193
                       <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a> script</code></em>,
 
194
                       <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> **exact_engines</code></em>,
 
195
                       <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> **fallback_engines</code></em>);</pre>
 
196
<p>Finds engines in the map that handle the given script. The returned
 
197
lists should be freed with g_slist_free, but the engines in the
 
198
lists are owned by GLib and will be kept around permanently, so
 
199
they should not be unref'ed.</p>
 
200
<div class="refsect3">
 
201
<a name="id-1.4.11.6.4.5"></a><h4>Parameters</h4>
 
202
<div class="informaltable"><table width="100%" border="0">
 
203
<colgroup>
 
204
<col width="150px" class="parameters_name">
 
205
<col class="parameters_description">
 
206
<col width="200px" class="parameters_annotations">
 
207
</colgroup>
 
208
<tbody>
 
209
<tr>
 
210
<td class="parameter_name"><p>map</p></td>
 
211
<td class="parameter_description"><p>a <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a></p></td>
 
212
<td class="parameter_annotations"> </td>
 
213
</tr>
 
214
<tr>
 
215
<td class="parameter_name"><p>script</p></td>
 
216
<td class="parameter_description"><p>a <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a></p></td>
 
217
<td class="parameter_annotations"> </td>
 
218
</tr>
 
219
<tr>
 
220
<td class="parameter_name"><p>exact_engines</p></td>
 
221
<td class="parameter_description"><p>location to store list of engines that exactly
 
222
handle this script.</p></td>
 
223
<td class="parameter_annotations"> </td>
 
224
</tr>
 
225
<tr>
 
226
<td class="parameter_name"><p>fallback_engines</p></td>
 
227
<td class="parameter_description"><p>location to store list of engines that approximately
 
228
handle this script.</p></td>
 
229
<td class="parameter_annotations"> </td>
 
230
</tr>
 
231
</tbody>
 
232
</table></div>
 
233
</div>
 
234
<p class="since">Since 1.4</p>
 
235
</div>
 
236
<hr>
 
237
<div class="refsect2">
 
238
<a name="pango-module-register"></a><h3>pango_module_register ()</h3>
 
239
<pre class="programlisting"><span class="returnvalue">void</span>
 
240
pango_module_register (<em class="parameter"><code><a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a> *module</code></em>);</pre>
 
241
<p>Registers a statically linked module with Pango. The
 
242
<a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a> structure that is passed in contains the
 
243
functions that would otherwise be loaded from a dynamically loaded
 
244
module.</p>
 
245
<div class="refsect3">
 
246
<a name="id-1.4.11.6.5.5"></a><h4>Parameters</h4>
 
247
<div class="informaltable"><table width="100%" border="0">
 
248
<colgroup>
 
249
<col width="150px" class="parameters_name">
 
250
<col class="parameters_description">
 
251
<col width="200px" class="parameters_annotations">
 
252
</colgroup>
 
253
<tbody><tr>
 
254
<td class="parameter_name"><p>module</p></td>
 
255
<td class="parameter_description"><p>a <a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a></p></td>
 
256
<td class="parameter_annotations"> </td>
 
257
</tr></tbody>
 
258
</table></div>
 
259
</div>
 
260
</div>
 
261
</div>
 
262
<div class="refsect1">
 
263
<a name="pango-Modules.other_details"></a><h2>Types and Values</h2>
60
264
<div class="refsect2">
61
265
<a name="PangoIncludedModule"></a><h3>struct PangoIncludedModule</h3>
62
266
<pre class="programlisting">struct PangoIncludedModule {
67
271
  PangoEngine *(*create) (const char       *id);
68
272
};
69
273
</pre>
70
 
<p>
71
 
The <a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a> structure for a statically linked module
 
274
<p>The <a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a> structure for a statically linked module
72
275
contains the functions that would otherwise be loaded from a dynamically
73
276
loaded module.</p>
74
 
<div class="variablelist"><table border="0" class="variablelist">
 
277
<div class="refsect3">
 
278
<a name="id-1.4.11.7.2.5"></a><h4>Members</h4>
 
279
<div class="informaltable"><table width="100%" border="0">
75
280
<colgroup>
76
 
<col align="left" valign="top">
77
 
<col>
 
281
<col width="300px" class="struct_members_name">
 
282
<col class="struct_members_description">
 
283
<col width="200px" class="struct_members_annotations">
78
284
</colgroup>
79
285
<tbody>
80
286
<tr>
81
 
<td><p><span class="term"><em class="structfield"><code><a name="PangoIncludedModule.list"></a>list</code></em> ()</span></p></td>
82
 
<td>a function that lists the engines defined in this module.</td>
83
 
</tr>
84
 
<tr>
85
 
<td><p><span class="term"><em class="structfield"><code><a name="PangoIncludedModule.init"></a>init</code></em> ()</span></p></td>
86
 
<td>a function to initialize the module.</td>
87
 
</tr>
88
 
<tr>
89
 
<td><p><span class="term"><em class="structfield"><code><a name="PangoIncludedModule.exit"></a>exit</code></em> ()</span></p></td>
90
 
<td>a function to finalize the module.</td>
91
 
</tr>
92
 
<tr>
93
 
<td><p><span class="term"><em class="structfield"><code><a name="PangoIncludedModule.create"></a>create</code></em> ()</span></p></td>
94
 
<td>a function to create an engine, given the engine name.</td>
 
287
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoIncludedModule.list"></a>list</code></em> ()</p></td>
 
288
<td class="struct_member_description"><p>a function that lists the engines defined in this module.</p></td>
 
289
<td class="struct_member_annotations"> </td>
 
290
</tr>
 
291
<tr>
 
292
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoIncludedModule.init"></a>init</code></em> ()</p></td>
 
293
<td class="struct_member_description"><p>a function to initialize the module.</p></td>
 
294
<td class="struct_member_annotations"> </td>
 
295
</tr>
 
296
<tr>
 
297
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoIncludedModule.exit"></a>exit</code></em> ()</p></td>
 
298
<td class="struct_member_description"><p>a function to finalize the module.</p></td>
 
299
<td class="struct_member_annotations"> </td>
 
300
</tr>
 
301
<tr>
 
302
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoIncludedModule.create"></a>create</code></em> ()</p></td>
 
303
<td class="struct_member_description"><p>a function to create an engine, given the engine name.</p></td>
 
304
<td class="struct_member_annotations"> </td>
95
305
</tr>
96
306
</tbody>
97
307
</table></div>
98
308
</div>
 
309
</div>
99
310
<hr>
100
311
<div class="refsect2">
101
312
<a name="PangoMap"></a><h3>PangoMap</h3>
102
313
<pre class="programlisting">typedef struct _PangoMap PangoMap;</pre>
103
 
<p>
104
 
A <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> structure can be used to determine the engine to
 
314
<p>A <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> structure can be used to determine the engine to
105
315
use for each character.</p>
106
316
</div>
107
317
<hr>
108
318
<div class="refsect2">
109
319
<a name="PangoMapEntry"></a><h3>PangoMapEntry</h3>
110
320
<pre class="programlisting">typedef struct _PangoMapEntry PangoMapEntry;</pre>
111
 
<p>
112
 
A <a class="link" href="pango-Modules.html#PangoMapEntry" title="PangoMapEntry"><span class="type">PangoMapEntry</span></a> contains information about the engine that should be used
 
321
<p>A <a class="link" href="pango-Modules.html#PangoMapEntry" title="PangoMapEntry"><span class="type">PangoMapEntry</span></a> contains information about the engine that should be used
113
322
for the codepoint to which this entry belongs and also whether the engine
114
323
matches the language tag for this entry's map exactly or just approximately.</p>
115
324
</div>
116
 
<hr>
117
 
<div class="refsect2">
118
 
<a name="pango-find-map"></a><h3>pango_find_map ()</h3>
119
 
<pre class="programlisting"><a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="returnvalue">PangoMap</span></a> *          pango_find_map                      (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>,
120
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> engine_type_id</code></em>,
121
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> render_type_id</code></em>);</pre>
122
 
<p>
123
 
Locate a <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> for a particular engine type and render
124
 
type. The resulting map can be used to determine the engine
125
 
for each character.</p>
126
 
<div class="variablelist"><table border="0" class="variablelist">
127
 
<colgroup>
128
 
<col align="left" valign="top">
129
 
<col>
130
 
</colgroup>
131
 
<tbody>
132
 
<tr>
133
 
<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
134
 
<td>the language tag for which to find the map</td>
135
 
</tr>
136
 
<tr>
137
 
<td><p><span class="term"><em class="parameter"><code>engine_type_id</code></em> :</span></p></td>
138
 
<td>the engine type for the map to find</td>
139
 
</tr>
140
 
<tr>
141
 
<td><p><span class="term"><em class="parameter"><code>render_type_id</code></em> :</span></p></td>
142
 
<td>the render type for the map to find</td>
143
 
</tr>
144
 
<tr>
145
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
146
 
<td>the suitable <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a>.</td>
147
 
</tr>
148
 
</tbody>
149
 
</table></div>
150
 
</div>
151
 
<hr>
152
 
<div class="refsect2">
153
 
<a name="pango-map-get-engine"></a><h3>pango_map_get_engine ()</h3>
154
 
<pre class="programlisting"><a class="link" href="pango-Engines.html#PangoEngine"><span class="returnvalue">PangoEngine</span></a> *       pango_map_get_engine                (<em class="parameter"><code><a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> *map</code></em>,
155
 
                                                         <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> script</code></em>);</pre>
156
 
<p>
157
 
Returns the best engine listed in the map for a given script</p>
158
 
<div class="variablelist"><table border="0" class="variablelist">
159
 
<colgroup>
160
 
<col align="left" valign="top">
161
 
<col>
162
 
</colgroup>
163
 
<tbody>
164
 
<tr>
165
 
<td><p><span class="term"><em class="parameter"><code>map</code></em> :</span></p></td>
166
 
<td>a <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a>
167
 
</td>
168
 
</tr>
169
 
<tr>
170
 
<td><p><span class="term"><em class="parameter"><code>script</code></em> :</span></p></td>
171
 
<td>a <a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a>
172
 
</td>
173
 
</tr>
174
 
<tr>
175
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
176
 
<td>the best engine, if one is listed for the script,
177
 
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The lookup may cause the engine to be loaded;
178
 
once an engine is loaded, it won't be unloaded. If multiple
179
 
engines are exact for the script, the choice of which is
180
 
returned is arbitrary.</td>
181
 
</tr>
182
 
</tbody>
183
 
</table></div>
184
 
</div>
185
 
<hr>
186
 
<div class="refsect2">
187
 
<a name="pango-map-get-engines"></a><h3>pango_map_get_engines ()</h3>
188
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_map_get_engines               (<em class="parameter"><code><a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> *map</code></em>,
189
 
                                                         <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> script</code></em>,
190
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> **exact_engines</code></em>,
191
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> **fallback_engines</code></em>);</pre>
192
 
<p>
193
 
Finds engines in the map that handle the given script. The returned
194
 
lists should be freed with g_slist_free, but the engines in the
195
 
lists are owned by GLib and will be kept around permanently, so
196
 
they should not be unref'ed.</p>
197
 
<div class="variablelist"><table border="0" class="variablelist">
198
 
<colgroup>
199
 
<col align="left" valign="top">
200
 
<col>
201
 
</colgroup>
202
 
<tbody>
203
 
<tr>
204
 
<td><p><span class="term"><em class="parameter"><code>map</code></em> :</span></p></td>
205
 
<td>a <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a>
206
 
</td>
207
 
</tr>
208
 
<tr>
209
 
<td><p><span class="term"><em class="parameter"><code>script</code></em> :</span></p></td>
210
 
<td>a <a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a>
211
 
</td>
212
 
</tr>
213
 
<tr>
214
 
<td><p><span class="term"><em class="parameter"><code>exact_engines</code></em> :</span></p></td>
215
 
<td>location to store list of engines that exactly
216
 
handle this script.</td>
217
 
</tr>
218
 
<tr>
219
 
<td><p><span class="term"><em class="parameter"><code>fallback_engines</code></em> :</span></p></td>
220
 
<td>location to store list of engines that approximately
221
 
handle this script.</td>
222
 
</tr>
223
 
</tbody>
224
 
</table></div>
225
 
<p class="since">Since 1.4</p>
226
 
</div>
227
 
<hr>
228
 
<div class="refsect2">
229
 
<a name="pango-module-register"></a><h3>pango_module_register ()</h3>
230
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_module_register               (<em class="parameter"><code><a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a> *module</code></em>);</pre>
231
 
<p>
232
 
Registers a statically linked module with Pango. The
233
 
<a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a> structure that is passed in contains the
234
 
functions that would otherwise be loaded from a dynamically loaded
235
 
module.</p>
236
 
<div class="variablelist"><table border="0" class="variablelist">
237
 
<colgroup>
238
 
<col align="left" valign="top">
239
 
<col>
240
 
</colgroup>
241
 
<tbody><tr>
242
 
<td><p><span class="term"><em class="parameter"><code>module</code></em> :</span></p></td>
243
 
<td>a <a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a>
244
 
</td>
245
 
</tr></tbody>
246
 
</table></div>
247
 
</div>
248
325
</div>
249
326
</div>
250
327
<div class="footer">
251
328
<hr>
252
 
          Generated by GTK-Doc V1.19.1</div>
 
329
          Generated by GTK-Doc V1.20.1</div>
253
330
</body>
254
331
</html>
 
 
b'\\ No newline at end of file'