25c817e5c5a2004127d3eb70ba443d1a4e727a71
[platform/upstream/harfbuzz.git] / docs / html / harfbuzz-hb-face.html
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=UTF-8">
5 <title>hb-face: HarfBuzz Manual</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7 <link rel="home" href="index.html" title="HarfBuzz Manual">
8 <link rel="up" href="ch09.html" title="Core API">
9 <link rel="prev" href="harfbuzz-hb-deprecated.html" title="hb-deprecated">
10 <link rel="next" href="harfbuzz-hb-font.html" title="hb-font">
11 <meta name="generator" content="GTK-Doc V1.25 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
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="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="#harfbuzz-hb-face.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
19                   <a href="#harfbuzz-hb-face.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
20 </td>
21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22 <td><a accesskey="u" href="ch09.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23 <td><a accesskey="p" href="harfbuzz-hb-deprecated.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24 <td><a accesskey="n" href="harfbuzz-hb-font.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
25 </tr></table>
26 <div class="refentry">
27 <a name="harfbuzz-hb-face"></a><div class="titlepage"></div>
28 <div class="refnamediv"><table width="100%"><tr>
29 <td valign="top">
30 <h2><span class="refentrytitle"><a name="harfbuzz-hb-face.top_of_page"></a>hb-face</span></h2>
31 <p>hb-face — Font face objects</p>
32 </td>
33 <td class="gallery_image" valign="top" align="right"></td>
34 </tr></table></div>
35 <div class="refsect1">
36 <a name="harfbuzz-hb-face.functions"></a><h2>Functions</h2>
37 <div class="informaltable"><table class="informaltable" width="100%" border="0">
38 <colgroup>
39 <col width="150px" class="functions_return">
40 <col class="functions_name">
41 </colgroup>
42 <tbody>
43 <tr>
44 <td class="function_type">unsigned <span class="returnvalue">int</span>
45 </td>
46 <td class="function_name">
47 <a class="link" href="harfbuzz-hb-face.html#hb-face-count" title="hb_face_count ()">hb_face_count</a> <span class="c_punctuation">()</span>
48 </td>
49 </tr>
50 <tr>
51 <td class="function_type">
52 <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
53 </td>
54 <td class="function_name">
55 <a class="link" href="harfbuzz-hb-face.html#hb-face-create" title="hb_face_create ()">hb_face_create</a> <span class="c_punctuation">()</span>
56 </td>
57 </tr>
58 <tr>
59 <td class="function_type">
60 <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
61 </td>
62 <td class="function_name">
63 <a class="link" href="harfbuzz-hb-face.html#hb-face-create-for-tables" title="hb_face_create_for_tables ()">hb_face_create_for_tables</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="harfbuzz-hb-face.html#hb-face-destroy" title="hb_face_destroy ()">hb_face_destroy</a> <span class="c_punctuation">()</span>
72 </td>
73 </tr>
74 <tr>
75 <td class="function_type">
76 <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
77 </td>
78 <td class="function_name">
79 <a class="link" href="harfbuzz-hb-face.html#hb-face-get-empty" title="hb_face_get_empty ()">hb_face_get_empty</a> <span class="c_punctuation">()</span>
80 </td>
81 </tr>
82 <tr>
83 <td class="function_type">unsigned <span class="returnvalue">int</span>
84 </td>
85 <td class="function_name">
86 <a class="link" href="harfbuzz-hb-face.html#hb-face-get-table-tags" title="hb_face_get_table_tags ()">hb_face_get_table_tags</a> <span class="c_punctuation">()</span>
87 </td>
88 </tr>
89 <tr>
90 <td class="function_type">unsigned <span class="returnvalue">int</span>
91 </td>
92 <td class="function_name">
93 <a class="link" href="harfbuzz-hb-face.html#hb-face-get-glyph-count" title="hb_face_get_glyph_count ()">hb_face_get_glyph_count</a> <span class="c_punctuation">()</span>
94 </td>
95 </tr>
96 <tr>
97 <td class="function_type">unsigned <span class="returnvalue">int</span>
98 </td>
99 <td class="function_name">
100 <a class="link" href="harfbuzz-hb-face.html#hb-face-get-index" title="hb_face_get_index ()">hb_face_get_index</a> <span class="c_punctuation">()</span>
101 </td>
102 </tr>
103 <tr>
104 <td class="function_type">unsigned <span class="returnvalue">int</span>
105 </td>
106 <td class="function_name">
107 <a class="link" href="harfbuzz-hb-face.html#hb-face-get-upem" title="hb_face_get_upem ()">hb_face_get_upem</a> <span class="c_punctuation">()</span>
108 </td>
109 </tr>
110 <tr>
111 <td class="function_type">
112 <span class="returnvalue">void</span> *
113 </td>
114 <td class="function_name">
115 <a class="link" href="harfbuzz-hb-face.html#hb-face-get-user-data" title="hb_face_get_user_data ()">hb_face_get_user_data</a> <span class="c_punctuation">()</span>
116 </td>
117 </tr>
118 <tr>
119 <td class="function_type">
120 <a class="link" href="harfbuzz-hb-common.html#hb-bool-t" title="hb_bool_t"><span class="returnvalue">hb_bool_t</span></a>
121 </td>
122 <td class="function_name">
123 <a class="link" href="harfbuzz-hb-face.html#hb-face-is-immutable" title="hb_face_is_immutable ()">hb_face_is_immutable</a> <span class="c_punctuation">()</span>
124 </td>
125 </tr>
126 <tr>
127 <td class="function_type">
128 <span class="returnvalue">void</span>
129 </td>
130 <td class="function_name">
131 <a class="link" href="harfbuzz-hb-face.html#hb-face-make-immutable" title="hb_face_make_immutable ()">hb_face_make_immutable</a> <span class="c_punctuation">()</span>
132 </td>
133 </tr>
134 <tr>
135 <td class="function_type">
136 <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
137 </td>
138 <td class="function_name">
139 <a class="link" href="harfbuzz-hb-face.html#hb-face-reference" title="hb_face_reference ()">hb_face_reference</a> <span class="c_punctuation">()</span>
140 </td>
141 </tr>
142 <tr>
143 <td class="function_type">
144 <a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="returnvalue">hb_blob_t</span></a> *
145 </td>
146 <td class="function_name">
147 <a class="link" href="harfbuzz-hb-face.html#hb-face-reference-blob" title="hb_face_reference_blob ()">hb_face_reference_blob</a> <span class="c_punctuation">()</span>
148 </td>
149 </tr>
150 <tr>
151 <td class="function_type">
152 <a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="returnvalue">hb_blob_t</span></a> *
153 </td>
154 <td class="function_name">
155 <a class="link" href="harfbuzz-hb-face.html#hb-face-reference-table" title="hb_face_reference_table ()">hb_face_reference_table</a> <span class="c_punctuation">()</span>
156 </td>
157 </tr>
158 <tr>
159 <td class="function_type">
160 <span class="returnvalue">void</span>
161 </td>
162 <td class="function_name">
163 <a class="link" href="harfbuzz-hb-face.html#hb-face-set-glyph-count" title="hb_face_set_glyph_count ()">hb_face_set_glyph_count</a> <span class="c_punctuation">()</span>
164 </td>
165 </tr>
166 <tr>
167 <td class="function_type">
168 <span class="returnvalue">void</span>
169 </td>
170 <td class="function_name">
171 <a class="link" href="harfbuzz-hb-face.html#hb-face-set-index" title="hb_face_set_index ()">hb_face_set_index</a> <span class="c_punctuation">()</span>
172 </td>
173 </tr>
174 <tr>
175 <td class="function_type">
176 <span class="returnvalue">void</span>
177 </td>
178 <td class="function_name">
179 <a class="link" href="harfbuzz-hb-face.html#hb-face-set-upem" title="hb_face_set_upem ()">hb_face_set_upem</a> <span class="c_punctuation">()</span>
180 </td>
181 </tr>
182 <tr>
183 <td class="function_type">
184 <a class="link" href="harfbuzz-hb-common.html#hb-bool-t" title="hb_bool_t"><span class="returnvalue">hb_bool_t</span></a>
185 </td>
186 <td class="function_name">
187 <a class="link" href="harfbuzz-hb-face.html#hb-face-set-user-data" title="hb_face_set_user_data ()">hb_face_set_user_data</a> <span class="c_punctuation">()</span>
188 </td>
189 </tr>
190 <tr>
191 <td class="function_type">
192 <span class="returnvalue">void</span>
193 </td>
194 <td class="function_name">
195 <a class="link" href="harfbuzz-hb-face.html#hb-face-collect-unicodes" title="hb_face_collect_unicodes ()">hb_face_collect_unicodes</a> <span class="c_punctuation">()</span>
196 </td>
197 </tr>
198 <tr>
199 <td class="function_type">
200 <span class="returnvalue">void</span>
201 </td>
202 <td class="function_name">
203 <a class="link" href="harfbuzz-hb-face.html#hb-face-collect-variation-selectors" title="hb_face_collect_variation_selectors ()">hb_face_collect_variation_selectors</a> <span class="c_punctuation">()</span>
204 </td>
205 </tr>
206 <tr>
207 <td class="function_type">
208 <span class="returnvalue">void</span>
209 </td>
210 <td class="function_name">
211 <a class="link" href="harfbuzz-hb-face.html#hb-face-collect-variation-unicodes" title="hb_face_collect_variation_unicodes ()">hb_face_collect_variation_unicodes</a> <span class="c_punctuation">()</span>
212 </td>
213 </tr>
214 <tr>
215 <td class="function_type">
216 <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
217 </td>
218 <td class="function_name">
219 <a class="link" href="harfbuzz-hb-face.html#hb-face-builder-create" title="hb_face_builder_create ()">hb_face_builder_create</a> <span class="c_punctuation">()</span>
220 </td>
221 </tr>
222 <tr>
223 <td class="function_type">
224 <a class="link" href="harfbuzz-hb-common.html#hb-bool-t" title="hb_bool_t"><span class="returnvalue">hb_bool_t</span></a>
225 </td>
226 <td class="function_name">
227 <a class="link" href="harfbuzz-hb-face.html#hb-face-builder-add-table" title="hb_face_builder_add_table ()">hb_face_builder_add_table</a> <span class="c_punctuation">()</span>
228 </td>
229 </tr>
230 </tbody>
231 </table></div>
232 </div>
233 <a name="hb-face-t"></a><div class="refsect1">
234 <a name="harfbuzz-hb-face.other"></a><h2>Types and Values</h2>
235 <div class="informaltable"><table class="informaltable" width="100%" border="0">
236 <colgroup>
237 <col width="150px" class="name">
238 <col class="description">
239 </colgroup>
240 <tbody><tr>
241 <td class="typedef_keyword">typedef</td>
242 <td class="function_name"><a class="link" href="harfbuzz-hb-face.html#hb-face-t">hb_face_t</a></td>
243 </tr></tbody>
244 </table></div>
245 </div>
246 <div class="refsect1">
247 <a name="harfbuzz-hb-face.object-hierarchy"></a><h2>Object Hierarchy</h2>
248 <pre class="screen">    <a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a>
249     <span class="lineart">╰──</span> hb_face_t
250 </pre>
251 </div>
252 <div class="refsect1">
253 <a name="harfbuzz-hb-face.includes"></a><h2>Includes</h2>
254 <pre class="synopsis">#include &lt;hb.h&gt;
255 </pre>
256 </div>
257 <div class="refsect1">
258 <a name="harfbuzz-hb-face.description"></a><h2>Description</h2>
259 <p>Font face is objects represent a single face in a font family.
260 More exactly, a font face represents a single face in a binary font file.
261 Font faces are typically built from a binary blob and a face index.
262 Font faces are used to create fonts.</p>
263 </div>
264 <div class="refsect1">
265 <a name="harfbuzz-hb-face.functions_details"></a><h2>Functions</h2>
266 <div class="refsect2">
267 <a name="hb-face-count"></a><h3>hb_face_count ()</h3>
268 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
269 hb_face_count (<em class="parameter"><code><a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="type">hb_blob_t</span></a> *blob</code></em>);</pre>
270 <p>Get number of faces in a blob.</p>
271 <div class="refsect3">
272 <a name="hb-face-count.parameters"></a><h4>Parameters</h4>
273 <div class="informaltable"><table class="informaltable" width="100%" border="0">
274 <colgroup>
275 <col width="150px" class="parameters_name">
276 <col class="parameters_description">
277 <col width="200px" class="parameters_annotations">
278 </colgroup>
279 <tbody><tr>
280 <td class="parameter_name"><p>blob</p></td>
281 <td class="parameter_description"><p>a blob.</p></td>
282 <td class="parameter_annotations"> </td>
283 </tr></tbody>
284 </table></div>
285 </div>
286 <div class="refsect3">
287 <a name="hb-face-count.returns"></a><h4>Returns</h4>
288 <p> Number of faces in <em class="parameter"><code>blob</code></em>
289 </p>
290 </div>
291 <p class="since">Since: <a class="link" href="api-index-1-7-7.html#api-index-1.7.7">1.7.7</a></p>
292 </div>
293 <hr>
294 <div class="refsect2">
295 <a name="hb-face-create"></a><h3>hb_face_create ()</h3>
296 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
297 hb_face_create (<em class="parameter"><code><a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="type">hb_blob_t</span></a> *blob</code></em>,
298                 <em class="parameter"><code>unsigned <span class="type">int</span> index</code></em>);</pre>
299 <p><span class="annotation">[Xconstructor]</span></p>
300 <div class="refsect3">
301 <a name="hb-face-create.returns"></a><h4>Returns</h4>
302 <p>. </p>
303 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
304 </div>
305 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
306 </div>
307 <hr>
308 <div class="refsect2">
309 <a name="hb-face-create-for-tables"></a><h3>hb_face_create_for_tables ()</h3>
310 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
311 hb_face_create_for_tables (<em class="parameter"><code><a class="link" href="harfbuzz-hb-font.html#hb-reference-table-func-t" title="hb_reference_table_func_t ()"><span class="type">hb_reference_table_func_t</span></a> reference_table_func</code></em>,
312                            <em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
313                            <em class="parameter"><code><a class="link" href="harfbuzz-hb-common.html#hb-destroy-func-t" title="hb_destroy_func_t ()"><span class="type">hb_destroy_func_t</span></a> destroy</code></em>);</pre>
314 <div class="refsect3">
315 <a name="hb-face-create-for-tables.parameters"></a><h4>Parameters</h4>
316 <div class="informaltable"><table class="informaltable" width="100%" border="0">
317 <colgroup>
318 <col width="150px" class="parameters_name">
319 <col class="parameters_description">
320 <col width="200px" class="parameters_annotations">
321 </colgroup>
322 <tbody><tr>
323 <td class="parameter_name"><p>reference_table_func</p></td>
324 <td class="parameter_description"><p>. </p></td>
325 <td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> user_data][<acronym title="This parameter is a 'destroy_data', for callbacks."><span class="acronym">destroy</span></acronym> destroy][<acronym title="The callback is valid until the GDestroyNotify argument is called."><span class="acronym">scope notified</span></acronym>]</span></td>
326 </tr></tbody>
327 </table></div>
328 </div>
329 <div class="refsect3">
330 <a name="hb-face-create-for-tables.returns"></a><h4>Returns</h4>
331 <p> (transfer full)</p>
332 </div>
333 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
334 </div>
335 <hr>
336 <div class="refsect2">
337 <a name="hb-face-destroy"></a><h3>hb_face_destroy ()</h3>
338 <pre class="programlisting"><span class="returnvalue">void</span>
339 hb_face_destroy (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>);</pre>
340 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
341 <div class="refsect3">
342 <a name="hb-face-destroy.parameters"></a><h4>Parameters</h4>
343 <div class="informaltable"><table class="informaltable" width="100%" border="0">
344 <colgroup>
345 <col width="150px" class="parameters_name">
346 <col class="parameters_description">
347 <col width="200px" class="parameters_annotations">
348 </colgroup>
349 <tbody><tr>
350 <td class="parameter_name"><p>face</p></td>
351 <td class="parameter_description"><p>a face.</p></td>
352 <td class="parameter_annotations"> </td>
353 </tr></tbody>
354 </table></div>
355 </div>
356 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
357 </div>
358 <hr>
359 <div class="refsect2">
360 <a name="hb-face-get-empty"></a><h3>hb_face_get_empty ()</h3>
361 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
362 hb_face_get_empty (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
363 <div class="refsect3">
364 <a name="hb-face-get-empty.returns"></a><h4>Returns</h4>
365 <p> (transfer full)</p>
366 </div>
367 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
368 </div>
369 <hr>
370 <div class="refsect2">
371 <a name="hb-face-get-table-tags"></a><h3>hb_face_get_table_tags ()</h3>
372 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
373 hb_face_get_table_tags (<em class="parameter"><code>const <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
374                         <em class="parameter"><code>unsigned <span class="type">int</span> start_offset</code></em>,
375                         <em class="parameter"><code>unsigned <span class="type">int</span> *table_count</code></em>,
376                         <em class="parameter"><code><a class="link" href="harfbuzz-hb-common.html#hb-tag-t" title="hb_tag_t"><span class="type">hb_tag_t</span></a> *table_tags</code></em>);</pre>
377 <p>Retrieves table tags for a face, if possible.</p>
378 <div class="refsect3">
379 <a name="hb-face-get-table-tags.parameters"></a><h4>Parameters</h4>
380 <div class="informaltable"><table class="informaltable" width="100%" border="0">
381 <colgroup>
382 <col width="150px" class="parameters_name">
383 <col class="parameters_description">
384 <col width="200px" class="parameters_annotations">
385 </colgroup>
386 <tbody>
387 <tr>
388 <td class="parameter_name"><p>face</p></td>
389 <td class="parameter_description"><p>a face.</p></td>
390 <td class="parameter_annotations"> </td>
391 </tr>
392 <tr>
393 <td class="parameter_name"><p>start_offset</p></td>
394 <td class="parameter_description"><p>index of first tag to return.</p></td>
395 <td class="parameter_annotations"> </td>
396 </tr>
397 <tr>
398 <td class="parameter_name"><p>table_count</p></td>
399 <td class="parameter_description"><p>input length of <em class="parameter"><code>table_tags</code></em>
400 array, output number of items written.</p></td>
401 <td class="parameter_annotations"> </td>
402 </tr>
403 <tr>
404 <td class="parameter_name"><p>table_tags</p></td>
405 <td class="parameter_description"><p>array to write tags into.</p></td>
406 <td class="parameter_annotations"> </td>
407 </tr>
408 </tbody>
409 </table></div>
410 </div>
411 <div class="refsect3">
412 <a name="hb-face-get-table-tags.returns"></a><h4>Returns</h4>
413 <p> total number of tables, or 0 if not possible to list.</p>
414 </div>
415 <p class="since">Since: <a class="link" href="api-index-1-6-0.html#api-index-1.6.0">1.6.0</a></p>
416 </div>
417 <hr>
418 <div class="refsect2">
419 <a name="hb-face-get-glyph-count"></a><h3>hb_face_get_glyph_count ()</h3>
420 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
421 hb_face_get_glyph_count (<em class="parameter"><code>const <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>);</pre>
422 <div class="refsect3">
423 <a name="hb-face-get-glyph-count.parameters"></a><h4>Parameters</h4>
424 <div class="informaltable"><table class="informaltable" width="100%" border="0">
425 <colgroup>
426 <col width="150px" class="parameters_name">
427 <col class="parameters_description">
428 <col width="200px" class="parameters_annotations">
429 </colgroup>
430 <tbody><tr>
431 <td class="parameter_name"><p>face</p></td>
432 <td class="parameter_description"><p>a face.</p></td>
433 <td class="parameter_annotations"> </td>
434 </tr></tbody>
435 </table></div>
436 </div>
437 <p class="since">Since: <a class="link" href="api-index-0-9-7.html#api-index-0.9.7">0.9.7</a></p>
438 </div>
439 <hr>
440 <div class="refsect2">
441 <a name="hb-face-get-index"></a><h3>hb_face_get_index ()</h3>
442 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
443 hb_face_get_index (<em class="parameter"><code>const <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>);</pre>
444 <div class="refsect3">
445 <a name="hb-face-get-index.parameters"></a><h4>Parameters</h4>
446 <div class="informaltable"><table class="informaltable" width="100%" border="0">
447 <colgroup>
448 <col width="150px" class="parameters_name">
449 <col class="parameters_description">
450 <col width="200px" class="parameters_annotations">
451 </colgroup>
452 <tbody><tr>
453 <td class="parameter_name"><p>face</p></td>
454 <td class="parameter_description"><p>a face.</p></td>
455 <td class="parameter_annotations"> </td>
456 </tr></tbody>
457 </table></div>
458 </div>
459 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
460 </div>
461 <hr>
462 <div class="refsect2">
463 <a name="hb-face-get-upem"></a><h3>hb_face_get_upem ()</h3>
464 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
465 hb_face_get_upem (<em class="parameter"><code>const <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>);</pre>
466 <div class="refsect3">
467 <a name="hb-face-get-upem.parameters"></a><h4>Parameters</h4>
468 <div class="informaltable"><table class="informaltable" width="100%" border="0">
469 <colgroup>
470 <col width="150px" class="parameters_name">
471 <col class="parameters_description">
472 <col width="200px" class="parameters_annotations">
473 </colgroup>
474 <tbody><tr>
475 <td class="parameter_name"><p>face</p></td>
476 <td class="parameter_description"><p>a face.</p></td>
477 <td class="parameter_annotations"> </td>
478 </tr></tbody>
479 </table></div>
480 </div>
481 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
482 </div>
483 <hr>
484 <div class="refsect2">
485 <a name="hb-face-get-user-data"></a><h3>hb_face_get_user_data ()</h3>
486 <pre class="programlisting"><span class="returnvalue">void</span> *
487 hb_face_get_user_data (<em class="parameter"><code>const <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
488                        <em class="parameter"><code><a class="link" href="harfbuzz-hb-common.html#hb-user-data-key-t"><span class="type">hb_user_data_key_t</span></a> *key</code></em>);</pre>
489 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
490 <div class="refsect3">
491 <a name="hb-face-get-user-data.parameters"></a><h4>Parameters</h4>
492 <div class="informaltable"><table class="informaltable" width="100%" border="0">
493 <colgroup>
494 <col width="150px" class="parameters_name">
495 <col class="parameters_description">
496 <col width="200px" class="parameters_annotations">
497 </colgroup>
498 <tbody><tr>
499 <td class="parameter_name"><p>face</p></td>
500 <td class="parameter_description"><p>a face.</p></td>
501 <td class="parameter_annotations"> </td>
502 </tr></tbody>
503 </table></div>
504 </div>
505 <div class="refsect3">
506 <a name="hb-face-get-user-data.returns"></a><h4>Returns</h4>
507 <p>. </p>
508 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
509 </div>
510 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
511 </div>
512 <hr>
513 <div class="refsect2">
514 <a name="hb-face-is-immutable"></a><h3>hb_face_is_immutable ()</h3>
515 <pre class="programlisting"><a class="link" href="harfbuzz-hb-common.html#hb-bool-t" title="hb_bool_t"><span class="returnvalue">hb_bool_t</span></a>
516 hb_face_is_immutable (<em class="parameter"><code>const <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>);</pre>
517 <div class="refsect3">
518 <a name="hb-face-is-immutable.parameters"></a><h4>Parameters</h4>
519 <div class="informaltable"><table class="informaltable" width="100%" border="0">
520 <colgroup>
521 <col width="150px" class="parameters_name">
522 <col class="parameters_description">
523 <col width="200px" class="parameters_annotations">
524 </colgroup>
525 <tbody><tr>
526 <td class="parameter_name"><p>face</p></td>
527 <td class="parameter_description"><p>a face.</p></td>
528 <td class="parameter_annotations"> </td>
529 </tr></tbody>
530 </table></div>
531 </div>
532 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
533 </div>
534 <hr>
535 <div class="refsect2">
536 <a name="hb-face-make-immutable"></a><h3>hb_face_make_immutable ()</h3>
537 <pre class="programlisting"><span class="returnvalue">void</span>
538 hb_face_make_immutable (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>);</pre>
539 <div class="refsect3">
540 <a name="hb-face-make-immutable.parameters"></a><h4>Parameters</h4>
541 <div class="informaltable"><table class="informaltable" width="100%" border="0">
542 <colgroup>
543 <col width="150px" class="parameters_name">
544 <col class="parameters_description">
545 <col width="200px" class="parameters_annotations">
546 </colgroup>
547 <tbody><tr>
548 <td class="parameter_name"><p>face</p></td>
549 <td class="parameter_description"><p>a face.</p></td>
550 <td class="parameter_annotations"> </td>
551 </tr></tbody>
552 </table></div>
553 </div>
554 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
555 </div>
556 <hr>
557 <div class="refsect2">
558 <a name="hb-face-reference"></a><h3>hb_face_reference ()</h3>
559 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
560 hb_face_reference (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>);</pre>
561 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
562 <div class="refsect3">
563 <a name="hb-face-reference.parameters"></a><h4>Parameters</h4>
564 <div class="informaltable"><table class="informaltable" width="100%" border="0">
565 <colgroup>
566 <col width="150px" class="parameters_name">
567 <col class="parameters_description">
568 <col width="200px" class="parameters_annotations">
569 </colgroup>
570 <tbody><tr>
571 <td class="parameter_name"><p>face</p></td>
572 <td class="parameter_description"><p>a face.</p></td>
573 <td class="parameter_annotations"> </td>
574 </tr></tbody>
575 </table></div>
576 </div>
577 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
578 </div>
579 <hr>
580 <div class="refsect2">
581 <a name="hb-face-reference-blob"></a><h3>hb_face_reference_blob ()</h3>
582 <pre class="programlisting"><a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="returnvalue">hb_blob_t</span></a> *
583 hb_face_reference_blob (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>);</pre>
584 <div class="refsect3">
585 <a name="hb-face-reference-blob.parameters"></a><h4>Parameters</h4>
586 <div class="informaltable"><table class="informaltable" width="100%" border="0">
587 <colgroup>
588 <col width="150px" class="parameters_name">
589 <col class="parameters_description">
590 <col width="200px" class="parameters_annotations">
591 </colgroup>
592 <tbody><tr>
593 <td class="parameter_name"><p>face</p></td>
594 <td class="parameter_description"><p>a face.</p></td>
595 <td class="parameter_annotations"> </td>
596 </tr></tbody>
597 </table></div>
598 </div>
599 <div class="refsect3">
600 <a name="hb-face-reference-blob.returns"></a><h4>Returns</h4>
601 <p>. </p>
602 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
603 </div>
604 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
605 </div>
606 <hr>
607 <div class="refsect2">
608 <a name="hb-face-reference-table"></a><h3>hb_face_reference_table ()</h3>
609 <pre class="programlisting"><a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="returnvalue">hb_blob_t</span></a> *
610 hb_face_reference_table (<em class="parameter"><code>const <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
611                          <em class="parameter"><code><a class="link" href="harfbuzz-hb-common.html#hb-tag-t" title="hb_tag_t"><span class="type">hb_tag_t</span></a> tag</code></em>);</pre>
612 <div class="refsect3">
613 <a name="hb-face-reference-table.parameters"></a><h4>Parameters</h4>
614 <div class="informaltable"><table class="informaltable" width="100%" border="0">
615 <colgroup>
616 <col width="150px" class="parameters_name">
617 <col class="parameters_description">
618 <col width="200px" class="parameters_annotations">
619 </colgroup>
620 <tbody><tr>
621 <td class="parameter_name"><p>face</p></td>
622 <td class="parameter_description"><p>a face.</p></td>
623 <td class="parameter_annotations"> </td>
624 </tr></tbody>
625 </table></div>
626 </div>
627 <div class="refsect3">
628 <a name="hb-face-reference-table.returns"></a><h4>Returns</h4>
629 <p>. </p>
630 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
631 </div>
632 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
633 </div>
634 <hr>
635 <div class="refsect2">
636 <a name="hb-face-set-glyph-count"></a><h3>hb_face_set_glyph_count ()</h3>
637 <pre class="programlisting"><span class="returnvalue">void</span>
638 hb_face_set_glyph_count (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
639                          <em class="parameter"><code>unsigned <span class="type">int</span> glyph_count</code></em>);</pre>
640 <div class="refsect3">
641 <a name="hb-face-set-glyph-count.parameters"></a><h4>Parameters</h4>
642 <div class="informaltable"><table class="informaltable" width="100%" border="0">
643 <colgroup>
644 <col width="150px" class="parameters_name">
645 <col class="parameters_description">
646 <col width="200px" class="parameters_annotations">
647 </colgroup>
648 <tbody><tr>
649 <td class="parameter_name"><p>face</p></td>
650 <td class="parameter_description"><p>a face.</p></td>
651 <td class="parameter_annotations"> </td>
652 </tr></tbody>
653 </table></div>
654 </div>
655 <p class="since">Since: <a class="link" href="api-index-0-9-7.html#api-index-0.9.7">0.9.7</a></p>
656 </div>
657 <hr>
658 <div class="refsect2">
659 <a name="hb-face-set-index"></a><h3>hb_face_set_index ()</h3>
660 <pre class="programlisting"><span class="returnvalue">void</span>
661 hb_face_set_index (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
662                    <em class="parameter"><code>unsigned <span class="type">int</span> index</code></em>);</pre>
663 <div class="refsect3">
664 <a name="hb-face-set-index.parameters"></a><h4>Parameters</h4>
665 <div class="informaltable"><table class="informaltable" width="100%" border="0">
666 <colgroup>
667 <col width="150px" class="parameters_name">
668 <col class="parameters_description">
669 <col width="200px" class="parameters_annotations">
670 </colgroup>
671 <tbody><tr>
672 <td class="parameter_name"><p>face</p></td>
673 <td class="parameter_description"><p>a face.</p></td>
674 <td class="parameter_annotations"> </td>
675 </tr></tbody>
676 </table></div>
677 </div>
678 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
679 </div>
680 <hr>
681 <div class="refsect2">
682 <a name="hb-face-set-upem"></a><h3>hb_face_set_upem ()</h3>
683 <pre class="programlisting"><span class="returnvalue">void</span>
684 hb_face_set_upem (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
685                   <em class="parameter"><code>unsigned <span class="type">int</span> upem</code></em>);</pre>
686 <div class="refsect3">
687 <a name="hb-face-set-upem.parameters"></a><h4>Parameters</h4>
688 <div class="informaltable"><table class="informaltable" width="100%" border="0">
689 <colgroup>
690 <col width="150px" class="parameters_name">
691 <col class="parameters_description">
692 <col width="200px" class="parameters_annotations">
693 </colgroup>
694 <tbody><tr>
695 <td class="parameter_name"><p>face</p></td>
696 <td class="parameter_description"><p>a face.</p></td>
697 <td class="parameter_annotations"> </td>
698 </tr></tbody>
699 </table></div>
700 </div>
701 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
702 </div>
703 <hr>
704 <div class="refsect2">
705 <a name="hb-face-set-user-data"></a><h3>hb_face_set_user_data ()</h3>
706 <pre class="programlisting"><a class="link" href="harfbuzz-hb-common.html#hb-bool-t" title="hb_bool_t"><span class="returnvalue">hb_bool_t</span></a>
707 hb_face_set_user_data (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
708                        <em class="parameter"><code><a class="link" href="harfbuzz-hb-common.html#hb-user-data-key-t"><span class="type">hb_user_data_key_t</span></a> *key</code></em>,
709                        <em class="parameter"><code><span class="type">void</span> *data</code></em>,
710                        <em class="parameter"><code><a class="link" href="harfbuzz-hb-common.html#hb-destroy-func-t" title="hb_destroy_func_t ()"><span class="type">hb_destroy_func_t</span></a> destroy</code></em>,
711                        <em class="parameter"><code><a class="link" href="harfbuzz-hb-common.html#hb-bool-t" title="hb_bool_t"><span class="type">hb_bool_t</span></a> replace</code></em>);</pre>
712 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
713 <div class="refsect3">
714 <a name="hb-face-set-user-data.parameters"></a><h4>Parameters</h4>
715 <div class="informaltable"><table class="informaltable" width="100%" border="0">
716 <colgroup>
717 <col width="150px" class="parameters_name">
718 <col class="parameters_description">
719 <col width="200px" class="parameters_annotations">
720 </colgroup>
721 <tbody><tr>
722 <td class="parameter_name"><p>face</p></td>
723 <td class="parameter_description"><p>a face.</p></td>
724 <td class="parameter_annotations"> </td>
725 </tr></tbody>
726 </table></div>
727 </div>
728 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
729 </div>
730 <hr>
731 <div class="refsect2">
732 <a name="hb-face-collect-unicodes"></a><h3>hb_face_collect_unicodes ()</h3>
733 <pre class="programlisting"><span class="returnvalue">void</span>
734 hb_face_collect_unicodes (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
735                           <em class="parameter"><code><a class="link" href="harfbuzz-hb-set.html#hb-set-t"><span class="type">hb_set_t</span></a> *out</code></em>);</pre>
736 <div class="refsect3">
737 <a name="hb-face-collect-unicodes.parameters"></a><h4>Parameters</h4>
738 <div class="informaltable"><table class="informaltable" width="100%" border="0">
739 <colgroup>
740 <col width="150px" class="parameters_name">
741 <col class="parameters_description">
742 <col width="200px" class="parameters_annotations">
743 </colgroup>
744 <tbody>
745 <tr>
746 <td class="parameter_name"><p>face</p></td>
747 <td class="parameter_description"><p>font face.</p></td>
748 <td class="parameter_annotations"> </td>
749 </tr>
750 <tr>
751 <td class="parameter_name"><p>out</p></td>
752 <td class="parameter_description"><p>set to add Unicode characters covered by <em class="parameter"><code>face</code></em>
753 to.</p></td>
754 <td class="parameter_annotations"> </td>
755 </tr>
756 </tbody>
757 </table></div>
758 </div>
759 <p class="since">Since: <a class="link" href="api-index-1-9-0.html#api-index-1.9.0">1.9.0</a></p>
760 </div>
761 <hr>
762 <div class="refsect2">
763 <a name="hb-face-collect-variation-selectors"></a><h3>hb_face_collect_variation_selectors ()</h3>
764 <pre class="programlisting"><span class="returnvalue">void</span>
765 hb_face_collect_variation_selectors (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
766                                      <em class="parameter"><code><a class="link" href="harfbuzz-hb-set.html#hb-set-t"><span class="type">hb_set_t</span></a> *out</code></em>);</pre>
767 <div class="refsect3">
768 <a name="hb-face-collect-variation-selectors.parameters"></a><h4>Parameters</h4>
769 <div class="informaltable"><table class="informaltable" width="100%" border="0">
770 <colgroup>
771 <col width="150px" class="parameters_name">
772 <col class="parameters_description">
773 <col width="200px" class="parameters_annotations">
774 </colgroup>
775 <tbody>
776 <tr>
777 <td class="parameter_name"><p>face</p></td>
778 <td class="parameter_description"><p>font face.</p></td>
779 <td class="parameter_annotations"> </td>
780 </tr>
781 <tr>
782 <td class="parameter_name"><p>out</p></td>
783 <td class="parameter_description"><p>set to add Variation Selector characters covered by <em class="parameter"><code>face</code></em>
784 to.</p></td>
785 <td class="parameter_annotations"> </td>
786 </tr>
787 </tbody>
788 </table></div>
789 </div>
790 <p class="since">Since: <a class="link" href="api-index-1-9-0.html#api-index-1.9.0">1.9.0</a></p>
791 </div>
792 <hr>
793 <div class="refsect2">
794 <a name="hb-face-collect-variation-unicodes"></a><h3>hb_face_collect_variation_unicodes ()</h3>
795 <pre class="programlisting"><span class="returnvalue">void</span>
796 hb_face_collect_variation_unicodes (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
797                                     <em class="parameter"><code><a class="link" href="harfbuzz-hb-common.html#hb-codepoint-t" title="hb_codepoint_t"><span class="type">hb_codepoint_t</span></a> variation_selector</code></em>,
798                                     <em class="parameter"><code><a class="link" href="harfbuzz-hb-set.html#hb-set-t"><span class="type">hb_set_t</span></a> *out</code></em>);</pre>
799 <div class="refsect3">
800 <a name="hb-face-collect-variation-unicodes.parameters"></a><h4>Parameters</h4>
801 <div class="informaltable"><table class="informaltable" width="100%" border="0">
802 <colgroup>
803 <col width="150px" class="parameters_name">
804 <col class="parameters_description">
805 <col width="200px" class="parameters_annotations">
806 </colgroup>
807 <tbody>
808 <tr>
809 <td class="parameter_name"><p>face</p></td>
810 <td class="parameter_description"><p>font face.</p></td>
811 <td class="parameter_annotations"> </td>
812 </tr>
813 <tr>
814 <td class="parameter_name"><p>out</p></td>
815 <td class="parameter_description"><p>set to add Unicode characters for <em class="parameter"><code>variation_selector</code></em>
816 covered by <em class="parameter"><code>face</code></em>
817 to.</p></td>
818 <td class="parameter_annotations"> </td>
819 </tr>
820 </tbody>
821 </table></div>
822 </div>
823 <p class="since">Since: <a class="link" href="api-index-1-9-0.html#api-index-1.9.0">1.9.0</a></p>
824 </div>
825 <hr>
826 <div class="refsect2">
827 <a name="hb-face-builder-create"></a><h3>hb_face_builder_create ()</h3>
828 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
829 hb_face_builder_create (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
830 <p>Creates a <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> that can be used with <a class="link" href="harfbuzz-hb-face.html#hb-face-builder-add-table" title="hb_face_builder_add_table ()"><code class="function">hb_face_builder_add_table()</code></a>.
831 After tables are added to the face, it can be compiled to a binary
832 font file by calling <a class="link" href="harfbuzz-hb-face.html#hb-face-reference-blob" title="hb_face_reference_blob ()"><code class="function">hb_face_reference_blob()</code></a>.</p>
833 <div class="refsect3">
834 <a name="hb-face-builder-create.returns"></a><h4>Returns</h4>
835 <p> New face. </p>
836 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
837 </div>
838 <p class="since">Since: <a class="link" href="api-index-1-9-0.html#api-index-1.9.0">1.9.0</a></p>
839 </div>
840 <hr>
841 <div class="refsect2">
842 <a name="hb-face-builder-add-table"></a><h3>hb_face_builder_add_table ()</h3>
843 <pre class="programlisting"><a class="link" href="harfbuzz-hb-common.html#hb-bool-t" title="hb_bool_t"><span class="returnvalue">hb_bool_t</span></a>
844 hb_face_builder_add_table (<em class="parameter"><code><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="type">hb_face_t</span></a> *face</code></em>,
845                            <em class="parameter"><code><a class="link" href="harfbuzz-hb-common.html#hb-tag-t" title="hb_tag_t"><span class="type">hb_tag_t</span></a> tag</code></em>,
846                            <em class="parameter"><code><a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="type">hb_blob_t</span></a> *blob</code></em>);</pre>
847 <p>Add table for <em class="parameter"><code>tag</code></em>
848  with data provided by <em class="parameter"><code>blob</code></em>
849  to the face.  <em class="parameter"><code>face</code></em>
850  must
851 be created using <a class="link" href="harfbuzz-hb-face.html#hb-face-builder-create" title="hb_face_builder_create ()"><code class="function">hb_face_builder_create()</code></a>.</p>
852 <p class="since">Since: <a class="link" href="api-index-1-9-0.html#api-index-1.9.0">1.9.0</a></p>
853 </div>
854 </div>
855 <div class="refsect1">
856 <a name="harfbuzz-hb-face.other_details"></a><h2>Types and Values</h2>
857 <div class="refsect2">
858 <a name="hb-face-t"></a><h3>hb_face_t</h3>
859 <pre class="programlisting">typedef struct hb_face_t hb_face_t;
860 </pre>
861 </div>
862 </div>
863 </div>
864 <div class="footer">
865 <hr>Generated by GTK-Doc V1.25</div>
866 </body>
867 </html>