Mercurial > repos > rliterman > csp2

comparison CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html @ 68:5028fdace37b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 16:23:26 -0400
parents
children
comparison
equal deleted inserted replaced
67:0e9998148a16 68:5028fdace37b
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>cairo_font_options_t: Cairo: A Vector Graphics Library</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7 <link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
8 <link rel="up" href="cairo-fonts.html" title="Fonts">
9 <link rel="prev" href="cairo-cairo-scaled-font-t.html" title="cairo_scaled_font_t">
10 <link rel="next" href="cairo-FreeType-Fonts.html" title="FreeType Fonts">
11 <meta name="generator" content="GTK-Doc V1.27 (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="#cairo-cairo-font-options-t.description" class="shortcut">Description</a></span>
19 </td>
20 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
21 <td><a accesskey="u" href="cairo-fonts.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
22 <td><a accesskey="p" href="cairo-cairo-scaled-font-t.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
23 <td><a accesskey="n" href="cairo-FreeType-Fonts.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
24 </tr></table>
25 <div class="refentry">
26 <a name="cairo-cairo-font-options-t"></a><div class="titlepage"></div>
27 <div class="refnamediv"><table width="100%"><tr>
28 <td valign="top">
29 <h2><span class="refentrytitle"><a name="cairo-cairo-font-options-t.top_of_page"></a>cairo_font_options_t</span></h2>
30 <p>cairo_font_options_t — How a font should be rendered</p>
31 </td>
32 <td class="gallery_image" valign="top" align="right"></td>
33 </tr></table></div>
34 <div class="refsect1">
35 <a name="cairo-cairo-font-options-t.functions"></a><h2>Functions</h2>
36 <div class="informaltable"><table class="informaltable" width="100%" border="0">
37 <colgroup>
38 <col width="150px" class="functions_return">
39 <col class="functions_name">
40 </colgroup>
41 <tbody>
42 <tr>
43 <td class="function_type">
44 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="returnvalue">cairo_font_options_t</span></a> *
45 </td>
46 <td class="function_name">
47 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-create" title="cairo_font_options_create ()">cairo_font_options_create</a> <span class="c_punctuation">()</span>
48 </td>
49 </tr>
50 <tr>
51 <td class="function_type">
52 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="returnvalue">cairo_font_options_t</span></a> *
53 </td>
54 <td class="function_name">
55 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-copy" title="cairo_font_options_copy ()">cairo_font_options_copy</a> <span class="c_punctuation">()</span>
56 </td>
57 </tr>
58 <tr>
59 <td class="function_type">
60 <span class="returnvalue">void</span>
61 </td>
62 <td class="function_name">
63 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-destroy" title="cairo_font_options_destroy ()">cairo_font_options_destroy</a> <span class="c_punctuation">()</span>
64 </td>
65 </tr>
66 <tr>
67 <td class="function_type">
68 <a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
69 </td>
70 <td class="function_name">
71 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-status" title="cairo_font_options_status ()">cairo_font_options_status</a> <span class="c_punctuation">()</span>
72 </td>
73 </tr>
74 <tr>
75 <td class="function_type">
76 <span class="returnvalue">void</span>
77 </td>
78 <td class="function_name">
79 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-merge" title="cairo_font_options_merge ()">cairo_font_options_merge</a> <span class="c_punctuation">()</span>
80 </td>
81 </tr>
82 <tr>
83 <td class="function_type">unsigned <span class="returnvalue">long</span>
84 </td>
85 <td class="function_name">
86 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-hash" title="cairo_font_options_hash ()">cairo_font_options_hash</a> <span class="c_punctuation">()</span>
87 </td>
88 </tr>
89 <tr>
90 <td class="function_type">
91 <a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
92 </td>
93 <td class="function_name">
94 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-equal" title="cairo_font_options_equal ()">cairo_font_options_equal</a> <span class="c_punctuation">()</span>
95 </td>
96 </tr>
97 <tr>
98 <td class="function_type">
99 <span class="returnvalue">void</span>
100 </td>
101 <td class="function_name">
102 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-set-antialias" title="cairo_font_options_set_antialias ()">cairo_font_options_set_antialias</a> <span class="c_punctuation">()</span>
103 </td>
104 </tr>
105 <tr>
106 <td class="function_type">
107 <a class="link" href="cairo-cairo-t.html#cairo-antialias-t" title="enum cairo_antialias_t"><span class="returnvalue">cairo_antialias_t</span></a>
108 </td>
109 <td class="function_name">
110 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-get-antialias" title="cairo_font_options_get_antialias ()">cairo_font_options_get_antialias</a> <span class="c_punctuation">()</span>
111 </td>
112 </tr>
113 <tr>
114 <td class="function_type">
115 <span class="returnvalue">void</span>
116 </td>
117 <td class="function_name">
118 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-set-subpixel-order" title="cairo_font_options_set_subpixel_order ()">cairo_font_options_set_subpixel_order</a> <span class="c_punctuation">()</span>
119 </td>
120 </tr>
121 <tr>
122 <td class="function_type">
123 <a class="link" href="cairo-cairo-font-options-t.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t"><span class="returnvalue">cairo_subpixel_order_t</span></a>
124 </td>
125 <td class="function_name">
126 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-get-subpixel-order" title="cairo_font_options_get_subpixel_order ()">cairo_font_options_get_subpixel_order</a> <span class="c_punctuation">()</span>
127 </td>
128 </tr>
129 <tr>
130 <td class="function_type">
131 <span class="returnvalue">void</span>
132 </td>
133 <td class="function_name">
134 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-set-hint-style" title="cairo_font_options_set_hint_style ()">cairo_font_options_set_hint_style</a> <span class="c_punctuation">()</span>
135 </td>
136 </tr>
137 <tr>
138 <td class="function_type">
139 <a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-style-t" title="enum cairo_hint_style_t"><span class="returnvalue">cairo_hint_style_t</span></a>
140 </td>
141 <td class="function_name">
142 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-get-hint-style" title="cairo_font_options_get_hint_style ()">cairo_font_options_get_hint_style</a> <span class="c_punctuation">()</span>
143 </td>
144 </tr>
145 <tr>
146 <td class="function_type">
147 <span class="returnvalue">void</span>
148 </td>
149 <td class="function_name">
150 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-set-hint-metrics" title="cairo_font_options_set_hint_metrics ()">cairo_font_options_set_hint_metrics</a> <span class="c_punctuation">()</span>
151 </td>
152 </tr>
153 <tr>
154 <td class="function_type">
155 <a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t"><span class="returnvalue">cairo_hint_metrics_t</span></a>
156 </td>
157 <td class="function_name">
158 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-get-hint-metrics" title="cairo_font_options_get_hint_metrics ()">cairo_font_options_get_hint_metrics</a> <span class="c_punctuation">()</span>
159 </td>
160 </tr>
161 <tr>
162 <td class="function_type">const <span class="returnvalue">char</span> *
163 </td>
164 <td class="function_name">
165 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-get-variations" title="cairo_font_options_get_variations ()">cairo_font_options_get_variations</a> <span class="c_punctuation">()</span>
166 </td>
167 </tr>
168 <tr>
169 <td class="function_type">
170 <span class="returnvalue">void</span>
171 </td>
172 <td class="function_name">
173 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-set-variations" title="cairo_font_options_set_variations ()">cairo_font_options_set_variations</a> <span class="c_punctuation">()</span>
174 </td>
175 </tr>
176 </tbody>
177 </table></div>
178 </div>
179 <div class="refsect1">
180 <a name="cairo-cairo-font-options-t.other"></a><h2>Types and Values</h2>
181 <div class="informaltable"><table class="informaltable" width="100%" border="0">
182 <colgroup>
183 <col width="150px" class="name">
184 <col class="description">
185 </colgroup>
186 <tbody>
187 <tr>
188 <td class="typedef_keyword">typedef</td>
189 <td class="function_name"><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a></td>
190 </tr>
191 <tr>
192 <td class="datatype_keyword">enum</td>
193 <td class="function_name"><a class="link" href="cairo-cairo-font-options-t.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a></td>
194 </tr>
195 <tr>
196 <td class="datatype_keyword">enum</td>
197 <td class="function_name"><a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a></td>
198 </tr>
199 <tr>
200 <td class="datatype_keyword">enum</td>
201 <td class="function_name"><a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a></td>
202 </tr>
203 </tbody>
204 </table></div>
205 </div>
206 <div class="refsect1">
207 <a name="cairo-cairo-font-options-t.description"></a><h2>Description</h2>
208 <p>The font options specify how fonts should be rendered. Most of the
209 time the font options implied by a surface are just right and do not
210 need any changes, but for pixel-based targets tweaking font options
211 may result in superior output on a particular display.</p>
212 </div>
213 <div class="refsect1">
214 <a name="cairo-cairo-font-options-t.functions_details"></a><h2>Functions</h2>
215 <div class="refsect2">
216 <a name="cairo-font-options-create"></a><h3>cairo_font_options_create ()</h3>
217 <pre class="programlisting"><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="returnvalue">cairo_font_options_t</span></a> *
218 cairo_font_options_create (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
219 <p>Allocates a new font options object with all options initialized
220 to default values.</p>
221 <div class="refsect3">
222 <a name="cairo-font-options-create.returns"></a><h4>Returns</h4>
223 <p> a newly allocated <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>. Free with
224 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-destroy" title="cairo_font_options_destroy ()"><code class="function">cairo_font_options_destroy()</code></a>. This function always returns a
225 valid pointer; if memory cannot be allocated, then a special
226 error object is returned where all operations on the object do nothing.
227 You can check for this with <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-status" title="cairo_font_options_status ()"><code class="function">cairo_font_options_status()</code></a>.</p>
228 </div>
229 <p class="since">Since: 1.0</p>
230 </div>
231 <hr>
232 <div class="refsect2">
233 <a name="cairo-font-options-copy"></a><h3>cairo_font_options_copy ()</h3>
234 <pre class="programlisting"><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="returnvalue">cairo_font_options_t</span></a> *
235 cairo_font_options_copy (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *original</code></em>);</pre>
236 <p>Allocates a new font options object copying the option values from
237 <em class="parameter"><code>original</code></em>
238 .</p>
239 <div class="refsect3">
240 <a name="cairo-font-options-copy.parameters"></a><h4>Parameters</h4>
241 <div class="informaltable"><table class="informaltable" width="100%" border="0">
242 <colgroup>
243 <col width="150px" class="parameters_name">
244 <col class="parameters_description">
245 <col width="200px" class="parameters_annotations">
246 </colgroup>
247 <tbody><tr>
248 <td class="parameter_name"><p>original</p></td>
249 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
250 <td class="parameter_annotations"> </td>
251 </tr></tbody>
252 </table></div>
253 </div>
254 <div class="refsect3">
255 <a name="cairo-font-options-copy.returns"></a><h4>Returns</h4>
256 <p> a newly allocated <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>. Free with
257 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-destroy" title="cairo_font_options_destroy ()"><code class="function">cairo_font_options_destroy()</code></a>. This function always returns a
258 valid pointer; if memory cannot be allocated, then a special
259 error object is returned where all operations on the object do nothing.
260 You can check for this with <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-status" title="cairo_font_options_status ()"><code class="function">cairo_font_options_status()</code></a>.</p>
261 </div>
262 <p class="since">Since: 1.0</p>
263 </div>
264 <hr>
265 <div class="refsect2">
266 <a name="cairo-font-options-destroy"></a><h3>cairo_font_options_destroy ()</h3>
267 <pre class="programlisting"><span class="returnvalue">void</span>
268 cairo_font_options_destroy (<em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>);</pre>
269 <p>Destroys a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> object created with
270 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-create" title="cairo_font_options_create ()"><code class="function">cairo_font_options_create()</code></a> or <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-copy" title="cairo_font_options_copy ()"><code class="function">cairo_font_options_copy()</code></a>.</p>
271 <div class="refsect3">
272 <a name="cairo-font-options-destroy.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>options</p></td>
281 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
282 <td class="parameter_annotations"> </td>
283 </tr></tbody>
284 </table></div>
285 </div>
286 <p class="since">Since: 1.0</p>
287 </div>
288 <hr>
289 <div class="refsect2">
290 <a name="cairo-font-options-status"></a><h3>cairo_font_options_status ()</h3>
291 <pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
292 cairo_font_options_status (<em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>);</pre>
293 <p>Checks whether an error has previously occurred for this
294 font options object</p>
295 <div class="refsect3">
296 <a name="cairo-font-options-status.parameters"></a><h4>Parameters</h4>
297 <div class="informaltable"><table class="informaltable" width="100%" border="0">
298 <colgroup>
299 <col width="150px" class="parameters_name">
300 <col class="parameters_description">
301 <col width="200px" class="parameters_annotations">
302 </colgroup>
303 <tbody><tr>
304 <td class="parameter_name"><p>options</p></td>
305 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
306 <td class="parameter_annotations"> </td>
307 </tr></tbody>
308 </table></div>
309 </div>
310 <div class="refsect3">
311 <a name="cairo-font-options-status.returns"></a><h4>Returns</h4>
312 <p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a></p>
313 </div>
314 <p class="since">Since: 1.0</p>
315 </div>
316 <hr>
317 <div class="refsect2">
318 <a name="cairo-font-options-merge"></a><h3>cairo_font_options_merge ()</h3>
319 <pre class="programlisting"><span class="returnvalue">void</span>
320 cairo_font_options_merge (<em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
321 <em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *other</code></em>);</pre>
322 <p>Merges non-default options from <em class="parameter"><code>other</code></em>
323 into <em class="parameter"><code>options</code></em>
324 , replacing
325 existing values. This operation can be thought of as somewhat
326 similar to compositing <em class="parameter"><code>other</code></em>
327 onto <em class="parameter"><code>options</code></em>
328 with the operation
329 of <a class="link" href="cairo-cairo-t.html#CAIRO-OPERATOR-OVER:CAPS"><code class="literal">CAIRO_OPERATOR_OVER</code></a>.</p>
330 <div class="refsect3">
331 <a name="cairo-font-options-merge.parameters"></a><h4>Parameters</h4>
332 <div class="informaltable"><table class="informaltable" width="100%" border="0">
333 <colgroup>
334 <col width="150px" class="parameters_name">
335 <col class="parameters_description">
336 <col width="200px" class="parameters_annotations">
337 </colgroup>
338 <tbody>
339 <tr>
340 <td class="parameter_name"><p>options</p></td>
341 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
342 <td class="parameter_annotations"> </td>
343 </tr>
344 <tr>
345 <td class="parameter_name"><p>other</p></td>
346 <td class="parameter_description"><p>another <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
347 <td class="parameter_annotations"> </td>
348 </tr>
349 </tbody>
350 </table></div>
351 </div>
352 <p class="since">Since: 1.0</p>
353 </div>
354 <hr>
355 <div class="refsect2">
356 <a name="cairo-font-options-hash"></a><h3>cairo_font_options_hash ()</h3>
357 <pre class="programlisting">unsigned <span class="returnvalue">long</span>
358 cairo_font_options_hash (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>);</pre>
359 <p>Compute a hash for the font options object; this value will
360 be useful when storing an object containing a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
361 in a hash table.</p>
362 <div class="refsect3">
363 <a name="cairo-font-options-hash.parameters"></a><h4>Parameters</h4>
364 <div class="informaltable"><table class="informaltable" width="100%" border="0">
365 <colgroup>
366 <col width="150px" class="parameters_name">
367 <col class="parameters_description">
368 <col width="200px" class="parameters_annotations">
369 </colgroup>
370 <tbody><tr>
371 <td class="parameter_name"><p>options</p></td>
372 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
373 <td class="parameter_annotations"> </td>
374 </tr></tbody>
375 </table></div>
376 </div>
377 <div class="refsect3">
378 <a name="cairo-font-options-hash.returns"></a><h4>Returns</h4>
379 <p> the hash value for the font options object.
380 The return value can be cast to a 32-bit type if a
381 32-bit hash value is needed.</p>
382 </div>
383 <p class="since">Since: 1.0</p>
384 </div>
385 <hr>
386 <div class="refsect2">
387 <a name="cairo-font-options-equal"></a><h3>cairo_font_options_equal ()</h3>
388 <pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
389 cairo_font_options_equal (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
390 <em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *other</code></em>);</pre>
391 <p>Compares two font options objects for equality.</p>
392 <div class="refsect3">
393 <a name="cairo-font-options-equal.parameters"></a><h4>Parameters</h4>
394 <div class="informaltable"><table class="informaltable" width="100%" border="0">
395 <colgroup>
396 <col width="150px" class="parameters_name">
397 <col class="parameters_description">
398 <col width="200px" class="parameters_annotations">
399 </colgroup>
400 <tbody>
401 <tr>
402 <td class="parameter_name"><p>options</p></td>
403 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
404 <td class="parameter_annotations"> </td>
405 </tr>
406 <tr>
407 <td class="parameter_name"><p>other</p></td>
408 <td class="parameter_description"><p>another <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
409 <td class="parameter_annotations"> </td>
410 </tr>
411 </tbody>
412 </table></div>
413 </div>
414 <div class="refsect3">
415 <a name="cairo-font-options-equal.returns"></a><h4>Returns</h4>
416 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if all fields of the two font options objects match.
417 Note that this function will return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if either object is in
418 error.</p>
419 </div>
420 <p class="since">Since: 1.0</p>
421 </div>
422 <hr>
423 <div class="refsect2">
424 <a name="cairo-font-options-set-antialias"></a><h3>cairo_font_options_set_antialias ()</h3>
425 <pre class="programlisting"><span class="returnvalue">void</span>
426 cairo_font_options_set_antialias (<em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
427 <em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-antialias-t" title="enum cairo_antialias_t"><span class="type">cairo_antialias_t</span></a> antialias</code></em>);</pre>
428 <p>Sets the antialiasing mode for the font options object. This
429 specifies the type of antialiasing to do when rendering text.</p>
430 <div class="refsect3">
431 <a name="cairo-font-options-set-antialias.parameters"></a><h4>Parameters</h4>
432 <div class="informaltable"><table class="informaltable" width="100%" border="0">
433 <colgroup>
434 <col width="150px" class="parameters_name">
435 <col class="parameters_description">
436 <col width="200px" class="parameters_annotations">
437 </colgroup>
438 <tbody>
439 <tr>
440 <td class="parameter_name"><p>options</p></td>
441 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
442 <td class="parameter_annotations"> </td>
443 </tr>
444 <tr>
445 <td class="parameter_name"><p>antialias</p></td>
446 <td class="parameter_description"><p>the new antialiasing mode</p></td>
447 <td class="parameter_annotations"> </td>
448 </tr>
449 </tbody>
450 </table></div>
451 </div>
452 <p class="since">Since: 1.0</p>
453 </div>
454 <hr>
455 <div class="refsect2">
456 <a name="cairo-font-options-get-antialias"></a><h3>cairo_font_options_get_antialias ()</h3>
457 <pre class="programlisting"><a class="link" href="cairo-cairo-t.html#cairo-antialias-t" title="enum cairo_antialias_t"><span class="returnvalue">cairo_antialias_t</span></a>
458 cairo_font_options_get_antialias (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>);</pre>
459 <p>Gets the antialiasing mode for the font options object.</p>
460 <div class="refsect3">
461 <a name="cairo-font-options-get-antialias.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>options</p></td>
470 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
471 <td class="parameter_annotations"> </td>
472 </tr></tbody>
473 </table></div>
474 </div>
475 <div class="refsect3">
476 <a name="cairo-font-options-get-antialias.returns"></a><h4>Returns</h4>
477 <p> the antialiasing mode</p>
478 </div>
479 <p class="since">Since: 1.0</p>
480 </div>
481 <hr>
482 <div class="refsect2">
483 <a name="cairo-font-options-set-subpixel-order"></a><h3>cairo_font_options_set_subpixel_order ()</h3>
484 <pre class="programlisting"><span class="returnvalue">void</span>
485 cairo_font_options_set_subpixel_order (<em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
486 <em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t"><span class="type">cairo_subpixel_order_t</span></a> subpixel_order</code></em>);</pre>
487 <p>Sets the subpixel order for the font options object. The subpixel
488 order specifies the order of color elements within each pixel on
489 the display device when rendering with an antialiasing mode of
490 <a class="link" href="cairo-cairo-t.html#CAIRO-ANTIALIAS-SUBPIXEL:CAPS"><code class="literal">CAIRO_ANTIALIAS_SUBPIXEL</code></a>. See the documentation for
491 <a class="link" href="cairo-cairo-font-options-t.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t"><span class="type">cairo_subpixel_order_t</span></a> for full details.</p>
492 <div class="refsect3">
493 <a name="cairo-font-options-set-subpixel-order.parameters"></a><h4>Parameters</h4>
494 <div class="informaltable"><table class="informaltable" width="100%" border="0">
495 <colgroup>
496 <col width="150px" class="parameters_name">
497 <col class="parameters_description">
498 <col width="200px" class="parameters_annotations">
499 </colgroup>
500 <tbody>
501 <tr>
502 <td class="parameter_name"><p>options</p></td>
503 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
504 <td class="parameter_annotations"> </td>
505 </tr>
506 <tr>
507 <td class="parameter_name"><p>subpixel_order</p></td>
508 <td class="parameter_description"><p>the new subpixel order</p></td>
509 <td class="parameter_annotations"> </td>
510 </tr>
511 </tbody>
512 </table></div>
513 </div>
514 <p class="since">Since: 1.0</p>
515 </div>
516 <hr>
517 <div class="refsect2">
518 <a name="cairo-font-options-get-subpixel-order"></a><h3>cairo_font_options_get_subpixel_order ()</h3>
519 <pre class="programlisting"><a class="link" href="cairo-cairo-font-options-t.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t"><span class="returnvalue">cairo_subpixel_order_t</span></a>
520 cairo_font_options_get_subpixel_order (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>);</pre>
521 <p>Gets the subpixel order for the font options object.
522 See the documentation for <a class="link" href="cairo-cairo-font-options-t.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t"><span class="type">cairo_subpixel_order_t</span></a> for full details.</p>
523 <div class="refsect3">
524 <a name="cairo-font-options-get-subpixel-order.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>options</p></td>
533 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
534 <td class="parameter_annotations"> </td>
535 </tr></tbody>
536 </table></div>
537 </div>
538 <div class="refsect3">
539 <a name="cairo-font-options-get-subpixel-order.returns"></a><h4>Returns</h4>
540 <p> the subpixel order for the font options object</p>
541 </div>
542 <p class="since">Since: 1.0</p>
543 </div>
544 <hr>
545 <div class="refsect2">
546 <a name="cairo-font-options-set-hint-style"></a><h3>cairo_font_options_set_hint_style ()</h3>
547 <pre class="programlisting"><span class="returnvalue">void</span>
548 cairo_font_options_set_hint_style (<em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
549 <em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-style-t" title="enum cairo_hint_style_t"><span class="type">cairo_hint_style_t</span></a> hint_style</code></em>);</pre>
550 <p>Sets the hint style for font outlines for the font options object.
551 This controls whether to fit font outlines to the pixel grid,
552 and if so, whether to optimize for fidelity or contrast.
553 See the documentation for <a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-style-t" title="enum cairo_hint_style_t"><span class="type">cairo_hint_style_t</span></a> for full details.</p>
554 <div class="refsect3">
555 <a name="cairo-font-options-set-hint-style.parameters"></a><h4>Parameters</h4>
556 <div class="informaltable"><table class="informaltable" width="100%" border="0">
557 <colgroup>
558 <col width="150px" class="parameters_name">
559 <col class="parameters_description">
560 <col width="200px" class="parameters_annotations">
561 </colgroup>
562 <tbody>
563 <tr>
564 <td class="parameter_name"><p>options</p></td>
565 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
566 <td class="parameter_annotations"> </td>
567 </tr>
568 <tr>
569 <td class="parameter_name"><p>hint_style</p></td>
570 <td class="parameter_description"><p>the new hint style</p></td>
571 <td class="parameter_annotations"> </td>
572 </tr>
573 </tbody>
574 </table></div>
575 </div>
576 <p class="since">Since: 1.0</p>
577 </div>
578 <hr>
579 <div class="refsect2">
580 <a name="cairo-font-options-get-hint-style"></a><h3>cairo_font_options_get_hint_style ()</h3>
581 <pre class="programlisting"><a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-style-t" title="enum cairo_hint_style_t"><span class="returnvalue">cairo_hint_style_t</span></a>
582 cairo_font_options_get_hint_style (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>);</pre>
583 <p>Gets the hint style for font outlines for the font options object.
584 See the documentation for <a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-style-t" title="enum cairo_hint_style_t"><span class="type">cairo_hint_style_t</span></a> for full details.</p>
585 <div class="refsect3">
586 <a name="cairo-font-options-get-hint-style.parameters"></a><h4>Parameters</h4>
587 <div class="informaltable"><table class="informaltable" width="100%" border="0">
588 <colgroup>
589 <col width="150px" class="parameters_name">
590 <col class="parameters_description">
591 <col width="200px" class="parameters_annotations">
592 </colgroup>
593 <tbody><tr>
594 <td class="parameter_name"><p>options</p></td>
595 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
596 <td class="parameter_annotations"> </td>
597 </tr></tbody>
598 </table></div>
599 </div>
600 <div class="refsect3">
601 <a name="cairo-font-options-get-hint-style.returns"></a><h4>Returns</h4>
602 <p> the hint style for the font options object</p>
603 </div>
604 <p class="since">Since: 1.0</p>
605 </div>
606 <hr>
607 <div class="refsect2">
608 <a name="cairo-font-options-set-hint-metrics"></a><h3>cairo_font_options_set_hint_metrics ()</h3>
609 <pre class="programlisting"><span class="returnvalue">void</span>
610 cairo_font_options_set_hint_metrics (<em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
611 <em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t"><span class="type">cairo_hint_metrics_t</span></a> hint_metrics</code></em>);</pre>
612 <p>Sets the metrics hinting mode for the font options object. This
613 controls whether metrics are quantized to integer values in
614 device units.
615 See the documentation for <a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t"><span class="type">cairo_hint_metrics_t</span></a> for full details.</p>
616 <div class="refsect3">
617 <a name="cairo-font-options-set-hint-metrics.parameters"></a><h4>Parameters</h4>
618 <div class="informaltable"><table class="informaltable" width="100%" border="0">
619 <colgroup>
620 <col width="150px" class="parameters_name">
621 <col class="parameters_description">
622 <col width="200px" class="parameters_annotations">
623 </colgroup>
624 <tbody>
625 <tr>
626 <td class="parameter_name"><p>options</p></td>
627 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
628 <td class="parameter_annotations"> </td>
629 </tr>
630 <tr>
631 <td class="parameter_name"><p>hint_metrics</p></td>
632 <td class="parameter_description"><p>the new metrics hinting mode</p></td>
633 <td class="parameter_annotations"> </td>
634 </tr>
635 </tbody>
636 </table></div>
637 </div>
638 <p class="since">Since: 1.0</p>
639 </div>
640 <hr>
641 <div class="refsect2">
642 <a name="cairo-font-options-get-hint-metrics"></a><h3>cairo_font_options_get_hint_metrics ()</h3>
643 <pre class="programlisting"><a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t"><span class="returnvalue">cairo_hint_metrics_t</span></a>
644 cairo_font_options_get_hint_metrics (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>);</pre>
645 <p>Gets the metrics hinting mode for the font options object.
646 See the documentation for <a class="link" href="cairo-cairo-font-options-t.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t"><span class="type">cairo_hint_metrics_t</span></a> for full details.</p>
647 <div class="refsect3">
648 <a name="cairo-font-options-get-hint-metrics.parameters"></a><h4>Parameters</h4>
649 <div class="informaltable"><table class="informaltable" width="100%" border="0">
650 <colgroup>
651 <col width="150px" class="parameters_name">
652 <col class="parameters_description">
653 <col width="200px" class="parameters_annotations">
654 </colgroup>
655 <tbody><tr>
656 <td class="parameter_name"><p>options</p></td>
657 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
658 <td class="parameter_annotations"> </td>
659 </tr></tbody>
660 </table></div>
661 </div>
662 <div class="refsect3">
663 <a name="cairo-font-options-get-hint-metrics.returns"></a><h4>Returns</h4>
664 <p> the metrics hinting mode for the font options object</p>
665 </div>
666 <p class="since">Since: 1.0</p>
667 </div>
668 <hr>
669 <div class="refsect2">
670 <a name="cairo-font-options-get-variations"></a><h3>cairo_font_options_get_variations ()</h3>
671 <pre class="programlisting">const <span class="returnvalue">char</span> *
672 cairo_font_options_get_variations (<em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>);</pre>
673 <p>Gets the OpenType font variations for the font options object.
674 See <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-set-variations" title="cairo_font_options_set_variations ()"><code class="function">cairo_font_options_set_variations()</code></a> for details about the
675 string format.</p>
676 <div class="refsect3">
677 <a name="cairo-font-options-get-variations.parameters"></a><h4>Parameters</h4>
678 <div class="informaltable"><table class="informaltable" width="100%" border="0">
679 <colgroup>
680 <col width="150px" class="parameters_name">
681 <col class="parameters_description">
682 <col width="200px" class="parameters_annotations">
683 </colgroup>
684 <tbody><tr>
685 <td class="parameter_name"><p>options</p></td>
686 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
687 <td class="parameter_annotations"> </td>
688 </tr></tbody>
689 </table></div>
690 </div>
691 <div class="refsect3">
692 <a name="cairo-font-options-get-variations.returns"></a><h4>Returns</h4>
693 <p> the font variations for the font options object. The
694 returned string belongs to the <em class="parameter"><code>options</code></em>
695 and must not be modified.
696 It is valid until either the font options object is destroyed or
697 the font variations in this object is modified with
698 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-set-variations" title="cairo_font_options_set_variations ()"><code class="function">cairo_font_options_set_variations()</code></a>.</p>
699 </div>
700 <p class="since">Since: 1.16</p>
701 </div>
702 <hr>
703 <div class="refsect2">
704 <a name="cairo-font-options-set-variations"></a><h3>cairo_font_options_set_variations ()</h3>
705 <pre class="programlisting"><span class="returnvalue">void</span>
706 cairo_font_options_set_variations (<em class="parameter"><code><a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
707 <em class="parameter"><code>const <span class="type">char</span> *variations</code></em>);</pre>
708 <p>Sets the OpenType font variations for the font options object.
709 Font variations are specified as a string with a format that
710 is similar to the CSS font-variation-settings. The string contains
711 a comma-separated list of axis assignments, which each assignment
712 consists of a 4-character axis name and a value, separated by
713 whitespace and optional equals sign.</p>
714 <p>Examples:</p>
715 <p>wght=200,wdth=140.5</p>
716 <p>wght 200 , wdth 140.5</p>
717 <div class="refsect3">
718 <a name="cairo-font-options-set-variations.parameters"></a><h4>Parameters</h4>
719 <div class="informaltable"><table class="informaltable" width="100%" border="0">
720 <colgroup>
721 <col width="150px" class="parameters_name">
722 <col class="parameters_description">
723 <col width="200px" class="parameters_annotations">
724 </colgroup>
725 <tbody>
726 <tr>
727 <td class="parameter_name"><p>options</p></td>
728 <td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a></p></td>
729 <td class="parameter_annotations"> </td>
730 </tr>
731 <tr>
732 <td class="parameter_name"><p>variations</p></td>
733 <td class="parameter_description"><p>the new font variations, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
734 <td class="parameter_annotations"> </td>
735 </tr>
736 </tbody>
737 </table></div>
738 </div>
739 <p class="since">Since: 1.16</p>
740 </div>
741 </div>
742 <div class="refsect1">
743 <a name="cairo-cairo-font-options-t.other_details"></a><h2>Types and Values</h2>
744 <div class="refsect2">
745 <a name="cairo-font-options-t"></a><h3>cairo_font_options_t</h3>
746 <pre class="programlisting">typedef struct _cairo_font_options cairo_font_options_t;
747 </pre>
748 <p>An opaque structure holding all options that are used when
749 rendering fonts.</p>
750 <p>Individual features of a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> can be set or
751 accessed using functions named
752 <code class="function">cairo_font_options_set_<span class="emphasis"><em>feature_name</em></span>()</code> and
753 <code class="function">cairo_font_options_get_<span class="emphasis"><em>feature_name</em></span>()</code>, like
754 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-set-antialias" title="cairo_font_options_set_antialias ()"><code class="function">cairo_font_options_set_antialias()</code></a> and
755 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-get-antialias" title="cairo_font_options_get_antialias ()"><code class="function">cairo_font_options_get_antialias()</code></a>.</p>
756 <p>New features may be added to a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> in the
757 future. For this reason, <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-copy" title="cairo_font_options_copy ()"><code class="function">cairo_font_options_copy()</code></a>,
758 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-equal" title="cairo_font_options_equal ()"><code class="function">cairo_font_options_equal()</code></a>, <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-merge" title="cairo_font_options_merge ()"><code class="function">cairo_font_options_merge()</code></a>, and
759 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-hash" title="cairo_font_options_hash ()"><code class="function">cairo_font_options_hash()</code></a> should be used to copy, check
760 for equality, merge, or compute a hash value of
761 <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> objects.</p>
762 <p class="since">Since: 1.0</p>
763 </div>
764 <hr>
765 <div class="refsect2">
766 <a name="cairo-subpixel-order-t"></a><h3>enum cairo_subpixel_order_t</h3>
767 <p>The subpixel order specifies the order of color elements within
768 each pixel on the display device when rendering with an
769 antialiasing mode of <a class="link" href="cairo-cairo-t.html#CAIRO-ANTIALIAS-SUBPIXEL:CAPS"><code class="literal">CAIRO_ANTIALIAS_SUBPIXEL</code></a>.</p>
770 <div class="refsect3">
771 <a name="cairo-subpixel-order-t.members"></a><h4>Members</h4>
772 <div class="informaltable"><table class="informaltable" width="100%" border="0">
773 <colgroup>
774 <col width="300px" class="enum_members_name">
775 <col class="enum_members_description">
776 <col width="200px" class="enum_members_annotations">
777 </colgroup>
778 <tbody>
779 <tr>
780 <td class="enum_member_name"><p><a name="CAIRO-SUBPIXEL-ORDER-DEFAULT:CAPS"></a>CAIRO_SUBPIXEL_ORDER_DEFAULT</p></td>
781 <td class="enum_member_description">
782 <p>Use the default subpixel order for
783 for the target device, since 1.0</p>
784 </td>
785 <td class="enum_member_annotations"> </td>
786 </tr>
787 <tr>
788 <td class="enum_member_name"><p><a name="CAIRO-SUBPIXEL-ORDER-RGB:CAPS"></a>CAIRO_SUBPIXEL_ORDER_RGB</p></td>
789 <td class="enum_member_description">
790 <p>Subpixel elements are arranged horizontally
791 with red at the left, since 1.0</p>
792 </td>
793 <td class="enum_member_annotations"> </td>
794 </tr>
795 <tr>
796 <td class="enum_member_name"><p><a name="CAIRO-SUBPIXEL-ORDER-BGR:CAPS"></a>CAIRO_SUBPIXEL_ORDER_BGR</p></td>
797 <td class="enum_member_description">
798 <p>Subpixel elements are arranged horizontally
799 with blue at the left, since 1.0</p>
800 </td>
801 <td class="enum_member_annotations"> </td>
802 </tr>
803 <tr>
804 <td class="enum_member_name"><p><a name="CAIRO-SUBPIXEL-ORDER-VRGB:CAPS"></a>CAIRO_SUBPIXEL_ORDER_VRGB</p></td>
805 <td class="enum_member_description">
806 <p>Subpixel elements are arranged vertically
807 with red at the top, since 1.0</p>
808 </td>
809 <td class="enum_member_annotations"> </td>
810 </tr>
811 <tr>
812 <td class="enum_member_name"><p><a name="CAIRO-SUBPIXEL-ORDER-VBGR:CAPS"></a>CAIRO_SUBPIXEL_ORDER_VBGR</p></td>
813 <td class="enum_member_description">
814 <p>Subpixel elements are arranged vertically
815 with blue at the top, since 1.0</p>
816 </td>
817 <td class="enum_member_annotations"> </td>
818 </tr>
819 </tbody>
820 </table></div>
821 </div>
822 <p class="since">Since: 1.0</p>
823 </div>
824 <hr>
825 <div class="refsect2">
826 <a name="cairo-hint-style-t"></a><h3>enum cairo_hint_style_t</h3>
827 <p>Specifies the type of hinting to do on font outlines. Hinting
828 is the process of fitting outlines to the pixel grid in order
829 to improve the appearance of the result. Since hinting outlines
830 involves distorting them, it also reduces the faithfulness
831 to the original outline shapes. Not all of the outline hinting
832 styles are supported by all font backends.</p>
833 <p>New entries may be added in future versions.</p>
834 <div class="refsect3">
835 <a name="cairo-hint-style-t.members"></a><h4>Members</h4>
836 <div class="informaltable"><table class="informaltable" width="100%" border="0">
837 <colgroup>
838 <col width="300px" class="enum_members_name">
839 <col class="enum_members_description">
840 <col width="200px" class="enum_members_annotations">
841 </colgroup>
842 <tbody>
843 <tr>
844 <td class="enum_member_name"><p><a name="CAIRO-HINT-STYLE-DEFAULT:CAPS"></a>CAIRO_HINT_STYLE_DEFAULT</p></td>
845 <td class="enum_member_description">
846 <p>Use the default hint style for
847 font backend and target device, since 1.0</p>
848 </td>
849 <td class="enum_member_annotations"> </td>
850 </tr>
851 <tr>
852 <td class="enum_member_name"><p><a name="CAIRO-HINT-STYLE-NONE:CAPS"></a>CAIRO_HINT_STYLE_NONE</p></td>
853 <td class="enum_member_description">
854 <p>Do not hint outlines, since 1.0</p>
855 </td>
856 <td class="enum_member_annotations"> </td>
857 </tr>
858 <tr>
859 <td class="enum_member_name"><p><a name="CAIRO-HINT-STYLE-SLIGHT:CAPS"></a>CAIRO_HINT_STYLE_SLIGHT</p></td>
860 <td class="enum_member_description">
861 <p>Hint outlines slightly to improve
862 contrast while retaining good fidelity to the original
863 shapes, since 1.0</p>
864 </td>
865 <td class="enum_member_annotations"> </td>
866 </tr>
867 <tr>
868 <td class="enum_member_name"><p><a name="CAIRO-HINT-STYLE-MEDIUM:CAPS"></a>CAIRO_HINT_STYLE_MEDIUM</p></td>
869 <td class="enum_member_description">
870 <p>Hint outlines with medium strength
871 giving a compromise between fidelity to the original shapes
872 and contrast, since 1.0</p>
873 </td>
874 <td class="enum_member_annotations"> </td>
875 </tr>
876 <tr>
877 <td class="enum_member_name"><p><a name="CAIRO-HINT-STYLE-FULL:CAPS"></a>CAIRO_HINT_STYLE_FULL</p></td>
878 <td class="enum_member_description">
879 <p>Hint outlines to maximize contrast, since 1.0</p>
880 </td>
881 <td class="enum_member_annotations"> </td>
882 </tr>
883 </tbody>
884 </table></div>
885 </div>
886 <p class="since">Since: 1.0</p>
887 </div>
888 <hr>
889 <div class="refsect2">
890 <a name="cairo-hint-metrics-t"></a><h3>enum cairo_hint_metrics_t</h3>
891 <p>Specifies whether to hint font metrics; hinting font metrics
892 means quantizing them so that they are integer values in
893 device space. Doing this improves the consistency of
894 letter and line spacing, however it also means that text
895 will be laid out differently at different zoom factors.</p>
896 <div class="refsect3">
897 <a name="cairo-hint-metrics-t.members"></a><h4>Members</h4>
898 <div class="informaltable"><table class="informaltable" width="100%" border="0">
899 <colgroup>
900 <col width="300px" class="enum_members_name">
901 <col class="enum_members_description">
902 <col width="200px" class="enum_members_annotations">
903 </colgroup>
904 <tbody>
905 <tr>
906 <td class="enum_member_name"><p><a name="CAIRO-HINT-METRICS-DEFAULT:CAPS"></a>CAIRO_HINT_METRICS_DEFAULT</p></td>
907 <td class="enum_member_description">
908 <p>Hint metrics in the default
909 manner for the font backend and target device, since 1.0</p>
910 </td>
911 <td class="enum_member_annotations"> </td>
912 </tr>
913 <tr>
914 <td class="enum_member_name"><p><a name="CAIRO-HINT-METRICS-OFF:CAPS"></a>CAIRO_HINT_METRICS_OFF</p></td>
915 <td class="enum_member_description">
916 <p>Do not hint font metrics, since 1.0</p>
917 </td>
918 <td class="enum_member_annotations"> </td>
919 </tr>
920 <tr>
921 <td class="enum_member_name"><p><a name="CAIRO-HINT-METRICS-ON:CAPS"></a>CAIRO_HINT_METRICS_ON</p></td>
922 <td class="enum_member_description">
923 <p>Hint font metrics, since 1.0</p>
924 </td>
925 <td class="enum_member_annotations"> </td>
926 </tr>
927 </tbody>
928 </table></div>
929 </div>
930 <p class="since">Since: 1.0</p>
931 </div>
932 </div>
933 <div class="refsect1">
934 <a name="cairo-cairo-font-options-t.see-also"></a><h2>See Also</h2>
935 <p><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a></p>
936 </div>
937 </div>
938 <div class="footer">
939 <hr>Generated by GTK-Doc V1.27</div>
940 </body>
941 </html>