Imported Upstream version 1.8.1
[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="ch08.html" title="HarfBuzz API">
9 <link rel="prev" href="harfbuzz-hb-blob.html" title="hb-blob">
10 <link rel="next" href="harfbuzz-hb-font.html" title="hb-font">
11 <meta name="generator" content="GTK-Doc V1.27.1 (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="ch08.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23 <td><a accesskey="p" href="harfbuzz-hb-blob.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</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 </tbody>
191 </table></div>
192 </div>
193 <a name="hb-face-t"></a><div class="refsect1">
194 <a name="harfbuzz-hb-face.other"></a><h2>Types and Values</h2>
195 <div class="informaltable"><table class="informaltable" width="100%" border="0">
196 <colgroup>
197 <col width="150px" class="name">
198 <col class="description">
199 </colgroup>
200 <tbody><tr>
201 <td class="typedef_keyword">typedef</td>
202 <td class="function_name"><a class="link" href="harfbuzz-hb-face.html#hb-face-t">hb_face_t</a></td>
203 </tr></tbody>
204 </table></div>
205 </div>
206 <div class="refsect1">
207 <a name="harfbuzz-hb-face.object-hierarchy"></a><h2>Object Hierarchy</h2>
208 <pre class="screen">    <a href="/home/behdad/.local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a>
209     <span class="lineart">╰──</span> hb_face_t
210 </pre>
211 </div>
212 <div class="refsect1">
213 <a name="harfbuzz-hb-face.description"></a><h2>Description</h2>
214 </div>
215 <div class="refsect1">
216 <a name="harfbuzz-hb-face.functions_details"></a><h2>Functions</h2>
217 <div class="refsect2">
218 <a name="hb-face-count"></a><h3>hb_face_count ()</h3>
219 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
220 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>
221 </div>
222 <hr>
223 <div class="refsect2">
224 <a name="hb-face-create"></a><h3>hb_face_create ()</h3>
225 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
226 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>,
227                 <em class="parameter"><code>unsigned <span class="type">int</span> index</code></em>);</pre>
228 <p><span class="annotation">[Xconstructor]</span></p>
229 <div class="refsect3">
230 <a name="hb-face-create.returns"></a><h4>Returns</h4>
231 <p>. </p>
232 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
233 </div>
234 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
235 </div>
236 <hr>
237 <div class="refsect2">
238 <a name="hb-face-create-for-tables"></a><h3>hb_face_create_for_tables ()</h3>
239 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
240 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>,
241                            <em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
242                            <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>
243 <div class="refsect3">
244 <a name="hb-face-create-for-tables.parameters"></a><h4>Parameters</h4>
245 <div class="informaltable"><table class="informaltable" width="100%" border="0">
246 <colgroup>
247 <col width="150px" class="parameters_name">
248 <col class="parameters_description">
249 <col width="200px" class="parameters_annotations">
250 </colgroup>
251 <tbody><tr>
252 <td class="parameter_name"><p>reference_table_func</p></td>
253 <td class="parameter_description"><p>. </p></td>
254 <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>
255 </tr></tbody>
256 </table></div>
257 </div>
258 <div class="refsect3">
259 <a name="hb-face-create-for-tables.returns"></a><h4>Returns</h4>
260 <p> (transfer full)</p>
261 </div>
262 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
263 </div>
264 <hr>
265 <div class="refsect2">
266 <a name="hb-face-destroy"></a><h3>hb_face_destroy ()</h3>
267 <pre class="programlisting"><span class="returnvalue">void</span>
268 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>
269 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
270 <div class="refsect3">
271 <a name="hb-face-destroy.parameters"></a><h4>Parameters</h4>
272 <div class="informaltable"><table class="informaltable" width="100%" border="0">
273 <colgroup>
274 <col width="150px" class="parameters_name">
275 <col class="parameters_description">
276 <col width="200px" class="parameters_annotations">
277 </colgroup>
278 <tbody><tr>
279 <td class="parameter_name"><p>face</p></td>
280 <td class="parameter_description"><p>a face.</p></td>
281 <td class="parameter_annotations"> </td>
282 </tr></tbody>
283 </table></div>
284 </div>
285 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
286 </div>
287 <hr>
288 <div class="refsect2">
289 <a name="hb-face-get-empty"></a><h3>hb_face_get_empty ()</h3>
290 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
291 hb_face_get_empty (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
292 <div class="refsect3">
293 <a name="hb-face-get-empty.returns"></a><h4>Returns</h4>
294 <p> (transfer full)</p>
295 </div>
296 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
297 </div>
298 <hr>
299 <div class="refsect2">
300 <a name="hb-face-get-table-tags"></a><h3>hb_face_get_table_tags ()</h3>
301 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
302 hb_face_get_table_tags (<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>,
303                         <em class="parameter"><code>unsigned <span class="type">int</span> start_offset</code></em>,
304                         <em class="parameter"><code>unsigned <span class="type">int</span> *table_count</code></em>,
305                         <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>
306 <p>Retrieves table tags for a face, if possible.</p>
307 <div class="refsect3">
308 <a name="hb-face-get-table-tags.parameters"></a><h4>Parameters</h4>
309 <div class="informaltable"><table class="informaltable" width="100%" border="0">
310 <colgroup>
311 <col width="150px" class="parameters_name">
312 <col class="parameters_description">
313 <col width="200px" class="parameters_annotations">
314 </colgroup>
315 <tbody><tr>
316 <td class="parameter_name"><p>face</p></td>
317 <td class="parameter_description"><p>a face.</p></td>
318 <td class="parameter_annotations"> </td>
319 </tr></tbody>
320 </table></div>
321 </div>
322 <div class="refsect3">
323 <a name="hb-face-get-table-tags.returns"></a><h4>Returns</h4>
324 <p> total number of tables, or 0 if not possible to list.</p>
325 </div>
326 <p class="since">Since: <a class="link" href="api-index-1-6-0.html#api-index-1.6.0">1.6.0</a></p>
327 </div>
328 <hr>
329 <div class="refsect2">
330 <a name="hb-face-get-glyph-count"></a><h3>hb_face_get_glyph_count ()</h3>
331 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
332 hb_face_get_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>);</pre>
333 <div class="refsect3">
334 <a name="hb-face-get-glyph-count.parameters"></a><h4>Parameters</h4>
335 <div class="informaltable"><table class="informaltable" width="100%" border="0">
336 <colgroup>
337 <col width="150px" class="parameters_name">
338 <col class="parameters_description">
339 <col width="200px" class="parameters_annotations">
340 </colgroup>
341 <tbody><tr>
342 <td class="parameter_name"><p>face</p></td>
343 <td class="parameter_description"><p>a face.</p></td>
344 <td class="parameter_annotations"> </td>
345 </tr></tbody>
346 </table></div>
347 </div>
348 <p class="since">Since: <a class="link" href="api-index-0-9-7.html#api-index-0.9.7">0.9.7</a></p>
349 </div>
350 <hr>
351 <div class="refsect2">
352 <a name="hb-face-get-index"></a><h3>hb_face_get_index ()</h3>
353 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
354 hb_face_get_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>);</pre>
355 <div class="refsect3">
356 <a name="hb-face-get-index.parameters"></a><h4>Parameters</h4>
357 <div class="informaltable"><table class="informaltable" width="100%" border="0">
358 <colgroup>
359 <col width="150px" class="parameters_name">
360 <col class="parameters_description">
361 <col width="200px" class="parameters_annotations">
362 </colgroup>
363 <tbody><tr>
364 <td class="parameter_name"><p>face</p></td>
365 <td class="parameter_description"><p>a face.</p></td>
366 <td class="parameter_annotations"> </td>
367 </tr></tbody>
368 </table></div>
369 </div>
370 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
371 </div>
372 <hr>
373 <div class="refsect2">
374 <a name="hb-face-get-upem"></a><h3>hb_face_get_upem ()</h3>
375 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
376 hb_face_get_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>);</pre>
377 <div class="refsect3">
378 <a name="hb-face-get-upem.parameters"></a><h4>Parameters</h4>
379 <div class="informaltable"><table class="informaltable" width="100%" border="0">
380 <colgroup>
381 <col width="150px" class="parameters_name">
382 <col class="parameters_description">
383 <col width="200px" class="parameters_annotations">
384 </colgroup>
385 <tbody><tr>
386 <td class="parameter_name"><p>face</p></td>
387 <td class="parameter_description"><p>a face.</p></td>
388 <td class="parameter_annotations"> </td>
389 </tr></tbody>
390 </table></div>
391 </div>
392 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
393 </div>
394 <hr>
395 <div class="refsect2">
396 <a name="hb-face-get-user-data"></a><h3>hb_face_get_user_data ()</h3>
397 <pre class="programlisting"><span class="returnvalue">void</span> *
398 hb_face_get_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>,
399                        <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>
400 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
401 <div class="refsect3">
402 <a name="hb-face-get-user-data.parameters"></a><h4>Parameters</h4>
403 <div class="informaltable"><table class="informaltable" width="100%" border="0">
404 <colgroup>
405 <col width="150px" class="parameters_name">
406 <col class="parameters_description">
407 <col width="200px" class="parameters_annotations">
408 </colgroup>
409 <tbody><tr>
410 <td class="parameter_name"><p>face</p></td>
411 <td class="parameter_description"><p>a face.</p></td>
412 <td class="parameter_annotations"> </td>
413 </tr></tbody>
414 </table></div>
415 </div>
416 <div class="refsect3">
417 <a name="hb-face-get-user-data.returns"></a><h4>Returns</h4>
418 <p>. </p>
419 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
420 </div>
421 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
422 </div>
423 <hr>
424 <div class="refsect2">
425 <a name="hb-face-is-immutable"></a><h3>hb_face_is_immutable ()</h3>
426 <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>
427 hb_face_is_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>
428 <div class="refsect3">
429 <a name="hb-face-is-immutable.parameters"></a><h4>Parameters</h4>
430 <div class="informaltable"><table class="informaltable" width="100%" border="0">
431 <colgroup>
432 <col width="150px" class="parameters_name">
433 <col class="parameters_description">
434 <col width="200px" class="parameters_annotations">
435 </colgroup>
436 <tbody><tr>
437 <td class="parameter_name"><p>face</p></td>
438 <td class="parameter_description"><p>a face.</p></td>
439 <td class="parameter_annotations"> </td>
440 </tr></tbody>
441 </table></div>
442 </div>
443 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
444 </div>
445 <hr>
446 <div class="refsect2">
447 <a name="hb-face-make-immutable"></a><h3>hb_face_make_immutable ()</h3>
448 <pre class="programlisting"><span class="returnvalue">void</span>
449 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>
450 <div class="refsect3">
451 <a name="hb-face-make-immutable.parameters"></a><h4>Parameters</h4>
452 <div class="informaltable"><table class="informaltable" width="100%" border="0">
453 <colgroup>
454 <col width="150px" class="parameters_name">
455 <col class="parameters_description">
456 <col width="200px" class="parameters_annotations">
457 </colgroup>
458 <tbody><tr>
459 <td class="parameter_name"><p>face</p></td>
460 <td class="parameter_description"><p>a face.</p></td>
461 <td class="parameter_annotations"> </td>
462 </tr></tbody>
463 </table></div>
464 </div>
465 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
466 </div>
467 <hr>
468 <div class="refsect2">
469 <a name="hb-face-reference"></a><h3>hb_face_reference ()</h3>
470 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
471 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>
472 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
473 <div class="refsect3">
474 <a name="hb-face-reference.parameters"></a><h4>Parameters</h4>
475 <div class="informaltable"><table class="informaltable" width="100%" border="0">
476 <colgroup>
477 <col width="150px" class="parameters_name">
478 <col class="parameters_description">
479 <col width="200px" class="parameters_annotations">
480 </colgroup>
481 <tbody><tr>
482 <td class="parameter_name"><p>face</p></td>
483 <td class="parameter_description"><p>a face.</p></td>
484 <td class="parameter_annotations"> </td>
485 </tr></tbody>
486 </table></div>
487 </div>
488 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
489 </div>
490 <hr>
491 <div class="refsect2">
492 <a name="hb-face-reference-blob"></a><h3>hb_face_reference_blob ()</h3>
493 <pre class="programlisting"><a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="returnvalue">hb_blob_t</span></a> *
494 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>
495 <div class="refsect3">
496 <a name="hb-face-reference-blob.parameters"></a><h4>Parameters</h4>
497 <div class="informaltable"><table class="informaltable" width="100%" border="0">
498 <colgroup>
499 <col width="150px" class="parameters_name">
500 <col class="parameters_description">
501 <col width="200px" class="parameters_annotations">
502 </colgroup>
503 <tbody><tr>
504 <td class="parameter_name"><p>face</p></td>
505 <td class="parameter_description"><p>a face.</p></td>
506 <td class="parameter_annotations"> </td>
507 </tr></tbody>
508 </table></div>
509 </div>
510 <div class="refsect3">
511 <a name="hb-face-reference-blob.returns"></a><h4>Returns</h4>
512 <p>. </p>
513 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
514 </div>
515 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
516 </div>
517 <hr>
518 <div class="refsect2">
519 <a name="hb-face-reference-table"></a><h3>hb_face_reference_table ()</h3>
520 <pre class="programlisting"><a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="returnvalue">hb_blob_t</span></a> *
521 hb_face_reference_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>,
522                          <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>
523 <div class="refsect3">
524 <a name="hb-face-reference-table.parameters"></a><h4>Parameters</h4>
525 <div class="informaltable"><table class="informaltable" width="100%" border="0">
526 <colgroup>
527 <col width="150px" class="parameters_name">
528 <col class="parameters_description">
529 <col width="200px" class="parameters_annotations">
530 </colgroup>
531 <tbody><tr>
532 <td class="parameter_name"><p>face</p></td>
533 <td class="parameter_description"><p>a face.</p></td>
534 <td class="parameter_annotations"> </td>
535 </tr></tbody>
536 </table></div>
537 </div>
538 <div class="refsect3">
539 <a name="hb-face-reference-table.returns"></a><h4>Returns</h4>
540 <p>. </p>
541 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
542 </div>
543 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
544 </div>
545 <hr>
546 <div class="refsect2">
547 <a name="hb-face-set-glyph-count"></a><h3>hb_face_set_glyph_count ()</h3>
548 <pre class="programlisting"><span class="returnvalue">void</span>
549 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>,
550                          <em class="parameter"><code>unsigned <span class="type">int</span> glyph_count</code></em>);</pre>
551 <div class="refsect3">
552 <a name="hb-face-set-glyph-count.parameters"></a><h4>Parameters</h4>
553 <div class="informaltable"><table class="informaltable" width="100%" border="0">
554 <colgroup>
555 <col width="150px" class="parameters_name">
556 <col class="parameters_description">
557 <col width="200px" class="parameters_annotations">
558 </colgroup>
559 <tbody><tr>
560 <td class="parameter_name"><p>face</p></td>
561 <td class="parameter_description"><p>a face.</p></td>
562 <td class="parameter_annotations"> </td>
563 </tr></tbody>
564 </table></div>
565 </div>
566 <p class="since">Since: <a class="link" href="api-index-0-9-7.html#api-index-0.9.7">0.9.7</a></p>
567 </div>
568 <hr>
569 <div class="refsect2">
570 <a name="hb-face-set-index"></a><h3>hb_face_set_index ()</h3>
571 <pre class="programlisting"><span class="returnvalue">void</span>
572 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>,
573                    <em class="parameter"><code>unsigned <span class="type">int</span> index</code></em>);</pre>
574 <div class="refsect3">
575 <a name="hb-face-set-index.parameters"></a><h4>Parameters</h4>
576 <div class="informaltable"><table class="informaltable" width="100%" border="0">
577 <colgroup>
578 <col width="150px" class="parameters_name">
579 <col class="parameters_description">
580 <col width="200px" class="parameters_annotations">
581 </colgroup>
582 <tbody><tr>
583 <td class="parameter_name"><p>face</p></td>
584 <td class="parameter_description"><p>a face.</p></td>
585 <td class="parameter_annotations"> </td>
586 </tr></tbody>
587 </table></div>
588 </div>
589 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
590 </div>
591 <hr>
592 <div class="refsect2">
593 <a name="hb-face-set-upem"></a><h3>hb_face_set_upem ()</h3>
594 <pre class="programlisting"><span class="returnvalue">void</span>
595 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>,
596                   <em class="parameter"><code>unsigned <span class="type">int</span> upem</code></em>);</pre>
597 <div class="refsect3">
598 <a name="hb-face-set-upem.parameters"></a><h4>Parameters</h4>
599 <div class="informaltable"><table class="informaltable" width="100%" border="0">
600 <colgroup>
601 <col width="150px" class="parameters_name">
602 <col class="parameters_description">
603 <col width="200px" class="parameters_annotations">
604 </colgroup>
605 <tbody><tr>
606 <td class="parameter_name"><p>face</p></td>
607 <td class="parameter_description"><p>a face.</p></td>
608 <td class="parameter_annotations"> </td>
609 </tr></tbody>
610 </table></div>
611 </div>
612 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
613 </div>
614 <hr>
615 <div class="refsect2">
616 <a name="hb-face-set-user-data"></a><h3>hb_face_set_user_data ()</h3>
617 <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>
618 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>,
619                        <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>,
620                        <em class="parameter"><code><span class="type">void</span> *data</code></em>,
621                        <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>,
622                        <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>
623 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
624 <div class="refsect3">
625 <a name="hb-face-set-user-data.parameters"></a><h4>Parameters</h4>
626 <div class="informaltable"><table class="informaltable" width="100%" border="0">
627 <colgroup>
628 <col width="150px" class="parameters_name">
629 <col class="parameters_description">
630 <col width="200px" class="parameters_annotations">
631 </colgroup>
632 <tbody><tr>
633 <td class="parameter_name"><p>face</p></td>
634 <td class="parameter_description"><p>a face.</p></td>
635 <td class="parameter_annotations"> </td>
636 </tr></tbody>
637 </table></div>
638 </div>
639 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
640 </div>
641 </div>
642 <div class="refsect1">
643 <a name="harfbuzz-hb-face.other_details"></a><h2>Types and Values</h2>
644 <div class="refsect2">
645 <a name="hb-face-t"></a><h3>hb_face_t</h3>
646 <pre class="programlisting">typedef struct hb_face_t hb_face_t;
647 </pre>
648 </div>
649 </div>
650 </div>
651 <div class="footer">
652 <hr>Generated by GTK-Doc V1.27.1</div>
653 </body>
654 </html>