Imported Upstream version 1.7.6
[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">
45 <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
46 </td>
47 <td class="function_name">
48 <a class="link" href="harfbuzz-hb-face.html#hb-face-create" title="hb_face_create ()">hb_face_create</a> <span class="c_punctuation">()</span>
49 </td>
50 </tr>
51 <tr>
52 <td class="function_type">
53 <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
54 </td>
55 <td class="function_name">
56 <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>
57 </td>
58 </tr>
59 <tr>
60 <td class="function_type">
61 <span class="returnvalue">void</span>
62 </td>
63 <td class="function_name">
64 <a class="link" href="harfbuzz-hb-face.html#hb-face-destroy" title="hb_face_destroy ()">hb_face_destroy</a> <span class="c_punctuation">()</span>
65 </td>
66 </tr>
67 <tr>
68 <td class="function_type">
69 <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
70 </td>
71 <td class="function_name">
72 <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>
73 </td>
74 </tr>
75 <tr>
76 <td class="function_type">unsigned <span class="returnvalue">int</span>
77 </td>
78 <td class="function_name">
79 <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>
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-glyph-count" title="hb_face_get_glyph_count ()">hb_face_get_glyph_count</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-index" title="hb_face_get_index ()">hb_face_get_index</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-upem" title="hb_face_get_upem ()">hb_face_get_upem</a> <span class="c_punctuation">()</span>
101 </td>
102 </tr>
103 <tr>
104 <td class="function_type">
105 <span class="returnvalue">void</span> *
106 </td>
107 <td class="function_name">
108 <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>
109 </td>
110 </tr>
111 <tr>
112 <td class="function_type">
113 <a class="link" href="harfbuzz-hb-common.html#hb-bool-t" title="hb_bool_t"><span class="returnvalue">hb_bool_t</span></a>
114 </td>
115 <td class="function_name">
116 <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>
117 </td>
118 </tr>
119 <tr>
120 <td class="function_type">
121 <span class="returnvalue">void</span>
122 </td>
123 <td class="function_name">
124 <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>
125 </td>
126 </tr>
127 <tr>
128 <td class="function_type">
129 <a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
130 </td>
131 <td class="function_name">
132 <a class="link" href="harfbuzz-hb-face.html#hb-face-reference" title="hb_face_reference ()">hb_face_reference</a> <span class="c_punctuation">()</span>
133 </td>
134 </tr>
135 <tr>
136 <td class="function_type">
137 <a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="returnvalue">hb_blob_t</span></a> *
138 </td>
139 <td class="function_name">
140 <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>
141 </td>
142 </tr>
143 <tr>
144 <td class="function_type">
145 <a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="returnvalue">hb_blob_t</span></a> *
146 </td>
147 <td class="function_name">
148 <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>
149 </td>
150 </tr>
151 <tr>
152 <td class="function_type">
153 <span class="returnvalue">void</span>
154 </td>
155 <td class="function_name">
156 <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>
157 </td>
158 </tr>
159 <tr>
160 <td class="function_type">
161 <span class="returnvalue">void</span>
162 </td>
163 <td class="function_name">
164 <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>
165 </td>
166 </tr>
167 <tr>
168 <td class="function_type">
169 <span class="returnvalue">void</span>
170 </td>
171 <td class="function_name">
172 <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>
173 </td>
174 </tr>
175 <tr>
176 <td class="function_type">
177 <a class="link" href="harfbuzz-hb-common.html#hb-bool-t" title="hb_bool_t"><span class="returnvalue">hb_bool_t</span></a>
178 </td>
179 <td class="function_name">
180 <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>
181 </td>
182 </tr>
183 </tbody>
184 </table></div>
185 </div>
186 <a name="hb-face-t"></a><div class="refsect1">
187 <a name="harfbuzz-hb-face.other"></a><h2>Types and Values</h2>
188 <div class="informaltable"><table class="informaltable" width="100%" border="0">
189 <colgroup>
190 <col width="150px" class="name">
191 <col class="description">
192 </colgroup>
193 <tbody><tr>
194 <td class="typedef_keyword">typedef</td>
195 <td class="function_name"><a class="link" href="harfbuzz-hb-face.html#hb-face-t">hb_face_t</a></td>
196 </tr></tbody>
197 </table></div>
198 </div>
199 <div class="refsect1">
200 <a name="harfbuzz-hb-face.object-hierarchy"></a><h2>Object Hierarchy</h2>
201 <pre class="screen">    <a href="/home/behdad/.local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a>
202     <span class="lineart">╰──</span> hb_face_t
203 </pre>
204 </div>
205 <div class="refsect1">
206 <a name="harfbuzz-hb-face.description"></a><h2>Description</h2>
207 </div>
208 <div class="refsect1">
209 <a name="harfbuzz-hb-face.functions_details"></a><h2>Functions</h2>
210 <div class="refsect2">
211 <a name="hb-face-create"></a><h3>hb_face_create ()</h3>
212 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
213 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>,
214                 <em class="parameter"><code>unsigned <span class="type">int</span> index</code></em>);</pre>
215 <p><span class="annotation">[Xconstructor]</span></p>
216 <div class="refsect3">
217 <a name="hb-face-create.returns"></a><h4>Returns</h4>
218 <p>. </p>
219 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
220 </div>
221 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
222 </div>
223 <hr>
224 <div class="refsect2">
225 <a name="hb-face-create-for-tables"></a><h3>hb_face_create_for_tables ()</h3>
226 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
227 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>,
228                            <em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
229                            <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>
230 <div class="refsect3">
231 <a name="hb-face-create-for-tables.parameters"></a><h4>Parameters</h4>
232 <div class="informaltable"><table class="informaltable" width="100%" border="0">
233 <colgroup>
234 <col width="150px" class="parameters_name">
235 <col class="parameters_description">
236 <col width="200px" class="parameters_annotations">
237 </colgroup>
238 <tbody><tr>
239 <td class="parameter_name"><p>reference_table_func</p></td>
240 <td class="parameter_description"><p>. </p></td>
241 <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>
242 </tr></tbody>
243 </table></div>
244 </div>
245 <div class="refsect3">
246 <a name="hb-face-create-for-tables.returns"></a><h4>Returns</h4>
247 <p> (transfer full)</p>
248 </div>
249 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
250 </div>
251 <hr>
252 <div class="refsect2">
253 <a name="hb-face-destroy"></a><h3>hb_face_destroy ()</h3>
254 <pre class="programlisting"><span class="returnvalue">void</span>
255 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>
256 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
257 <div class="refsect3">
258 <a name="hb-face-destroy.parameters"></a><h4>Parameters</h4>
259 <div class="informaltable"><table class="informaltable" width="100%" border="0">
260 <colgroup>
261 <col width="150px" class="parameters_name">
262 <col class="parameters_description">
263 <col width="200px" class="parameters_annotations">
264 </colgroup>
265 <tbody><tr>
266 <td class="parameter_name"><p>face</p></td>
267 <td class="parameter_description"><p>a face.</p></td>
268 <td class="parameter_annotations"> </td>
269 </tr></tbody>
270 </table></div>
271 </div>
272 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
273 </div>
274 <hr>
275 <div class="refsect2">
276 <a name="hb-face-get-empty"></a><h3>hb_face_get_empty ()</h3>
277 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
278 hb_face_get_empty (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
279 <div class="refsect3">
280 <a name="hb-face-get-empty.returns"></a><h4>Returns</h4>
281 <p> (transfer full)</p>
282 </div>
283 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
284 </div>
285 <hr>
286 <div class="refsect2">
287 <a name="hb-face-get-table-tags"></a><h3>hb_face_get_table_tags ()</h3>
288 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
289 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>,
290                         <em class="parameter"><code>unsigned <span class="type">int</span> start_offset</code></em>,
291                         <em class="parameter"><code>unsigned <span class="type">int</span> *table_count</code></em>,
292                         <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>
293 <p>Retrieves table tags for a face, if possible.</p>
294 <div class="refsect3">
295 <a name="hb-face-get-table-tags.parameters"></a><h4>Parameters</h4>
296 <div class="informaltable"><table class="informaltable" width="100%" border="0">
297 <colgroup>
298 <col width="150px" class="parameters_name">
299 <col class="parameters_description">
300 <col width="200px" class="parameters_annotations">
301 </colgroup>
302 <tbody><tr>
303 <td class="parameter_name"><p>face</p></td>
304 <td class="parameter_description"><p>a face.</p></td>
305 <td class="parameter_annotations"> </td>
306 </tr></tbody>
307 </table></div>
308 </div>
309 <div class="refsect3">
310 <a name="hb-face-get-table-tags.returns"></a><h4>Returns</h4>
311 <p> total number of tables, or 0 if not possible to list.</p>
312 </div>
313 <p class="since">Since: <a class="link" href="api-index-1-6-0.html#api-index-1.6.0">1.6.0</a></p>
314 </div>
315 <hr>
316 <div class="refsect2">
317 <a name="hb-face-get-glyph-count"></a><h3>hb_face_get_glyph_count ()</h3>
318 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
319 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>
320 <div class="refsect3">
321 <a name="hb-face-get-glyph-count.parameters"></a><h4>Parameters</h4>
322 <div class="informaltable"><table class="informaltable" width="100%" border="0">
323 <colgroup>
324 <col width="150px" class="parameters_name">
325 <col class="parameters_description">
326 <col width="200px" class="parameters_annotations">
327 </colgroup>
328 <tbody><tr>
329 <td class="parameter_name"><p>face</p></td>
330 <td class="parameter_description"><p>a face.</p></td>
331 <td class="parameter_annotations"> </td>
332 </tr></tbody>
333 </table></div>
334 </div>
335 <p class="since">Since: <a class="link" href="api-index-0-9-7.html#api-index-0.9.7">0.9.7</a></p>
336 </div>
337 <hr>
338 <div class="refsect2">
339 <a name="hb-face-get-index"></a><h3>hb_face_get_index ()</h3>
340 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
341 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>
342 <div class="refsect3">
343 <a name="hb-face-get-index.parameters"></a><h4>Parameters</h4>
344 <div class="informaltable"><table class="informaltable" width="100%" border="0">
345 <colgroup>
346 <col width="150px" class="parameters_name">
347 <col class="parameters_description">
348 <col width="200px" class="parameters_annotations">
349 </colgroup>
350 <tbody><tr>
351 <td class="parameter_name"><p>face</p></td>
352 <td class="parameter_description"><p>a face.</p></td>
353 <td class="parameter_annotations"> </td>
354 </tr></tbody>
355 </table></div>
356 </div>
357 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
358 </div>
359 <hr>
360 <div class="refsect2">
361 <a name="hb-face-get-upem"></a><h3>hb_face_get_upem ()</h3>
362 <pre class="programlisting">unsigned <span class="returnvalue">int</span>
363 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>
364 <div class="refsect3">
365 <a name="hb-face-get-upem.parameters"></a><h4>Parameters</h4>
366 <div class="informaltable"><table class="informaltable" width="100%" border="0">
367 <colgroup>
368 <col width="150px" class="parameters_name">
369 <col class="parameters_description">
370 <col width="200px" class="parameters_annotations">
371 </colgroup>
372 <tbody><tr>
373 <td class="parameter_name"><p>face</p></td>
374 <td class="parameter_description"><p>a face.</p></td>
375 <td class="parameter_annotations"> </td>
376 </tr></tbody>
377 </table></div>
378 </div>
379 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
380 </div>
381 <hr>
382 <div class="refsect2">
383 <a name="hb-face-get-user-data"></a><h3>hb_face_get_user_data ()</h3>
384 <pre class="programlisting"><span class="returnvalue">void</span> *
385 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>,
386                        <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>
387 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
388 <div class="refsect3">
389 <a name="hb-face-get-user-data.parameters"></a><h4>Parameters</h4>
390 <div class="informaltable"><table class="informaltable" width="100%" border="0">
391 <colgroup>
392 <col width="150px" class="parameters_name">
393 <col class="parameters_description">
394 <col width="200px" class="parameters_annotations">
395 </colgroup>
396 <tbody><tr>
397 <td class="parameter_name"><p>face</p></td>
398 <td class="parameter_description"><p>a face.</p></td>
399 <td class="parameter_annotations"> </td>
400 </tr></tbody>
401 </table></div>
402 </div>
403 <div class="refsect3">
404 <a name="hb-face-get-user-data.returns"></a><h4>Returns</h4>
405 <p>. </p>
406 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
407 </div>
408 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
409 </div>
410 <hr>
411 <div class="refsect2">
412 <a name="hb-face-is-immutable"></a><h3>hb_face_is_immutable ()</h3>
413 <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>
414 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>
415 <div class="refsect3">
416 <a name="hb-face-is-immutable.parameters"></a><h4>Parameters</h4>
417 <div class="informaltable"><table class="informaltable" width="100%" border="0">
418 <colgroup>
419 <col width="150px" class="parameters_name">
420 <col class="parameters_description">
421 <col width="200px" class="parameters_annotations">
422 </colgroup>
423 <tbody><tr>
424 <td class="parameter_name"><p>face</p></td>
425 <td class="parameter_description"><p>a face.</p></td>
426 <td class="parameter_annotations"> </td>
427 </tr></tbody>
428 </table></div>
429 </div>
430 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
431 </div>
432 <hr>
433 <div class="refsect2">
434 <a name="hb-face-make-immutable"></a><h3>hb_face_make_immutable ()</h3>
435 <pre class="programlisting"><span class="returnvalue">void</span>
436 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>
437 <div class="refsect3">
438 <a name="hb-face-make-immutable.parameters"></a><h4>Parameters</h4>
439 <div class="informaltable"><table class="informaltable" width="100%" border="0">
440 <colgroup>
441 <col width="150px" class="parameters_name">
442 <col class="parameters_description">
443 <col width="200px" class="parameters_annotations">
444 </colgroup>
445 <tbody><tr>
446 <td class="parameter_name"><p>face</p></td>
447 <td class="parameter_description"><p>a face.</p></td>
448 <td class="parameter_annotations"> </td>
449 </tr></tbody>
450 </table></div>
451 </div>
452 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
453 </div>
454 <hr>
455 <div class="refsect2">
456 <a name="hb-face-reference"></a><h3>hb_face_reference ()</h3>
457 <pre class="programlisting"><a class="link" href="harfbuzz-hb-face.html#hb-face-t"><span class="returnvalue">hb_face_t</span></a> *
458 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>
459 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
460 <div class="refsect3">
461 <a name="hb-face-reference.parameters"></a><h4>Parameters</h4>
462 <div class="informaltable"><table class="informaltable" width="100%" border="0">
463 <colgroup>
464 <col width="150px" class="parameters_name">
465 <col class="parameters_description">
466 <col width="200px" class="parameters_annotations">
467 </colgroup>
468 <tbody><tr>
469 <td class="parameter_name"><p>face</p></td>
470 <td class="parameter_description"><p>a face.</p></td>
471 <td class="parameter_annotations"> </td>
472 </tr></tbody>
473 </table></div>
474 </div>
475 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
476 </div>
477 <hr>
478 <div class="refsect2">
479 <a name="hb-face-reference-blob"></a><h3>hb_face_reference_blob ()</h3>
480 <pre class="programlisting"><a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="returnvalue">hb_blob_t</span></a> *
481 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>
482 <div class="refsect3">
483 <a name="hb-face-reference-blob.parameters"></a><h4>Parameters</h4>
484 <div class="informaltable"><table class="informaltable" width="100%" border="0">
485 <colgroup>
486 <col width="150px" class="parameters_name">
487 <col class="parameters_description">
488 <col width="200px" class="parameters_annotations">
489 </colgroup>
490 <tbody><tr>
491 <td class="parameter_name"><p>face</p></td>
492 <td class="parameter_description"><p>a face.</p></td>
493 <td class="parameter_annotations"> </td>
494 </tr></tbody>
495 </table></div>
496 </div>
497 <div class="refsect3">
498 <a name="hb-face-reference-blob.returns"></a><h4>Returns</h4>
499 <p>. </p>
500 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
501 </div>
502 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
503 </div>
504 <hr>
505 <div class="refsect2">
506 <a name="hb-face-reference-table"></a><h3>hb_face_reference_table ()</h3>
507 <pre class="programlisting"><a class="link" href="harfbuzz-hb-blob.html#hb-blob-t"><span class="returnvalue">hb_blob_t</span></a> *
508 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>,
509                          <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>
510 <div class="refsect3">
511 <a name="hb-face-reference-table.parameters"></a><h4>Parameters</h4>
512 <div class="informaltable"><table class="informaltable" width="100%" border="0">
513 <colgroup>
514 <col width="150px" class="parameters_name">
515 <col class="parameters_description">
516 <col width="200px" class="parameters_annotations">
517 </colgroup>
518 <tbody><tr>
519 <td class="parameter_name"><p>face</p></td>
520 <td class="parameter_description"><p>a face.</p></td>
521 <td class="parameter_annotations"> </td>
522 </tr></tbody>
523 </table></div>
524 </div>
525 <div class="refsect3">
526 <a name="hb-face-reference-table.returns"></a><h4>Returns</h4>
527 <p>. </p>
528 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
529 </div>
530 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
531 </div>
532 <hr>
533 <div class="refsect2">
534 <a name="hb-face-set-glyph-count"></a><h3>hb_face_set_glyph_count ()</h3>
535 <pre class="programlisting"><span class="returnvalue">void</span>
536 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>,
537                          <em class="parameter"><code>unsigned <span class="type">int</span> glyph_count</code></em>);</pre>
538 <div class="refsect3">
539 <a name="hb-face-set-glyph-count.parameters"></a><h4>Parameters</h4>
540 <div class="informaltable"><table class="informaltable" width="100%" border="0">
541 <colgroup>
542 <col width="150px" class="parameters_name">
543 <col class="parameters_description">
544 <col width="200px" class="parameters_annotations">
545 </colgroup>
546 <tbody><tr>
547 <td class="parameter_name"><p>face</p></td>
548 <td class="parameter_description"><p>a face.</p></td>
549 <td class="parameter_annotations"> </td>
550 </tr></tbody>
551 </table></div>
552 </div>
553 <p class="since">Since: <a class="link" href="api-index-0-9-7.html#api-index-0.9.7">0.9.7</a></p>
554 </div>
555 <hr>
556 <div class="refsect2">
557 <a name="hb-face-set-index"></a><h3>hb_face_set_index ()</h3>
558 <pre class="programlisting"><span class="returnvalue">void</span>
559 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>,
560                    <em class="parameter"><code>unsigned <span class="type">int</span> index</code></em>);</pre>
561 <div class="refsect3">
562 <a name="hb-face-set-index.parameters"></a><h4>Parameters</h4>
563 <div class="informaltable"><table class="informaltable" width="100%" border="0">
564 <colgroup>
565 <col width="150px" class="parameters_name">
566 <col class="parameters_description">
567 <col width="200px" class="parameters_annotations">
568 </colgroup>
569 <tbody><tr>
570 <td class="parameter_name"><p>face</p></td>
571 <td class="parameter_description"><p>a face.</p></td>
572 <td class="parameter_annotations"> </td>
573 </tr></tbody>
574 </table></div>
575 </div>
576 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
577 </div>
578 <hr>
579 <div class="refsect2">
580 <a name="hb-face-set-upem"></a><h3>hb_face_set_upem ()</h3>
581 <pre class="programlisting"><span class="returnvalue">void</span>
582 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>,
583                   <em class="parameter"><code>unsigned <span class="type">int</span> upem</code></em>);</pre>
584 <div class="refsect3">
585 <a name="hb-face-set-upem.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 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
600 </div>
601 <hr>
602 <div class="refsect2">
603 <a name="hb-face-set-user-data"></a><h3>hb_face_set_user_data ()</h3>
604 <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>
605 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>,
606                        <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>,
607                        <em class="parameter"><code><span class="type">void</span> *data</code></em>,
608                        <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>,
609                        <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>
610 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
611 <div class="refsect3">
612 <a name="hb-face-set-user-data.parameters"></a><h4>Parameters</h4>
613 <div class="informaltable"><table class="informaltable" width="100%" border="0">
614 <colgroup>
615 <col width="150px" class="parameters_name">
616 <col class="parameters_description">
617 <col width="200px" class="parameters_annotations">
618 </colgroup>
619 <tbody><tr>
620 <td class="parameter_name"><p>face</p></td>
621 <td class="parameter_description"><p>a face.</p></td>
622 <td class="parameter_annotations"> </td>
623 </tr></tbody>
624 </table></div>
625 </div>
626 <p class="since">Since: <a class="link" href="api-index-0-9-2.html#api-index-0.9.2">0.9.2</a></p>
627 </div>
628 </div>
629 <div class="refsect1">
630 <a name="harfbuzz-hb-face.other_details"></a><h2>Types and Values</h2>
631 <div class="refsect2">
632 <a name="hb-face-t"></a><h3>hb_face_t</h3>
633 <pre class="programlisting">typedef struct hb_face_t hb_face_t;
634 </pre>
635 </div>
636 </div>
637 </div>
638 <div class="footer">
639 <hr>Generated by GTK-Doc V1.27.1</div>
640 </body>
641 </html>