← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/cairo/intrepid-updates

« back to all changes in this revision

Viewing changes to doc/public/html/cairo-Font-Options.html

  • Committer: Bazaar Package Importer
  • Author(s): Fabien Tassin
  • Date: 2008-09-25 16:22:33 UTC
  • mfrom: (1.1.9 upstream)
  • Revision ID: james.westby@ubuntu.com-20080925162233-btx61ymk181i7mcc
Tags: 1.7.6-0ubuntu1
* New upstream version. Most noticable changes are:
  - some API changes with especially the removal of
    cairo_font_options_set_lcd_filter and cairo_font_options_get_lcd_filter
  - xlib: Faster bookkeeping
  - PS: Fix gradients with non-constant alpha
  - Fix deadlock in user-font code
* debian/patches/00list: Remove 03_from_git_fix_lcd_filter_default.dpatch,
  add debian/patches/03_fix_ftbfs_withing_xcb.dpatch
* debian/libcairo2.symbols, debian/libcairo-directfb2.symbols: update
  list of symbols

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/public/html/cairo-Font-Options.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>cairo_font_options_t</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
7
 
<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
8
 
<link rel="up" href="Fonts.html" title="Fonts">
9
 
<link rel="prev" href="cairo-Scaled-Fonts.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.10 (XML mode)">
12
 
<link rel="stylesheet" href="style.css" type="text/css">
13
 
<link rel="chapter" href="Drawing.html" title="Drawing">
14
 
<link rel="chapter" href="Fonts.html" title="Fonts">
15
 
<link rel="chapter" href="Surfaces.html" title="Surfaces">
16
 
<link rel="chapter" href="Support.html" title="Utilities">
17
 
<link rel="index" href="ix01.html" title="Index">
18
 
<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
19
 
<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
20
 
<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
21
 
<link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
22
 
<link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
23
 
</head>
24
 
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
25
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
26
 
<tr valign="middle">
27
 
<td><a accesskey="p" href="cairo-Scaled-Fonts.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
28
 
<td><a accesskey="u" href="Fonts.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
29
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
30
 
<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
31
 
<td><a accesskey="n" href="cairo-FreeType-Fonts.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
32
 
</tr>
33
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#cairo-Font-Options.synopsis" class="shortcut">Top</a>
34
 
                   | 
35
 
                  <a href="#cairo-Font-Options.description" class="shortcut">Description</a></nobr></td></tr>
36
 
</table>
37
 
<div class="refentry" lang="en">
38
 
<a name="cairo-Font-Options"></a><div class="titlepage"></div>
39
 
<div class="refnamediv"><table width="100%"><tr>
40
 
<td valign="top">
41
 
<h2><span class="refentrytitle"><a name="cairo-Font-Options.top_of_page"></a>cairo_font_options_t</span></h2>
42
 
<p>cairo_font_options_t — How a font should be rendered</p>
43
 
</td>
44
 
<td valign="top" align="right"></td>
45
 
</tr></table></div>
46
 
<div class="refsynopsisdiv">
47
 
<a name="cairo-Font-Options.synopsis"></a><h2>Synopsis</h2>
48
 
<pre class="synopsis">
49
 
typedef             <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a>;
50
 
<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a>* <a class="link" href="cairo-Font-Options.html#cairo-font-options-create" title="cairo_font_options_create ()">cairo_font_options_create</a>         (void);
51
 
<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a>* <a class="link" href="cairo-Font-Options.html#cairo-font-options-copy" title="cairo_font_options_copy ()">cairo_font_options_copy</a>           (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *original);
52
 
void                <a class="link" href="cairo-Font-Options.html#cairo-font-options-destroy" title="cairo_font_options_destroy ()">cairo_font_options_destroy</a>          (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
53
 
<a class="link" href="cairo-Error-Handling.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a>      <a class="link" href="cairo-Font-Options.html#cairo-font-options-status" title="cairo_font_options_status ()">cairo_font_options_status</a>           (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
54
 
void                <a class="link" href="cairo-Font-Options.html#cairo-font-options-merge" title="cairo_font_options_merge ()">cairo_font_options_merge</a>            (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
55
 
                                                         const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *other);
56
 
unsigned long       <a class="link" href="cairo-Font-Options.html#cairo-font-options-hash" title="cairo_font_options_hash ()">cairo_font_options_hash</a>             (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
57
 
<a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a>        <a class="link" href="cairo-Font-Options.html#cairo-font-options-equal" title="cairo_font_options_equal ()">cairo_font_options_equal</a>            (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
58
 
                                                         const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *other);
59
 
void                <a class="link" href="cairo-Font-Options.html#cairo-font-options-set-antialias" title="cairo_font_options_set_antialias ()">cairo_font_options_set_antialias</a>    (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
60
 
                                                         <a class="link" href="cairo-cairo-t.html#cairo-antialias-t" title="enum cairo_antialias_t">cairo_antialias_t</a> antialias);
61
 
<a class="link" href="cairo-cairo-t.html#cairo-antialias-t" title="enum cairo_antialias_t">cairo_antialias_t</a>   <a class="link" href="cairo-Font-Options.html#cairo-font-options-get-antialias" title="cairo_font_options_get_antialias ()">cairo_font_options_get_antialias</a>    (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
62
 
enum                <a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a>;
63
 
void                <a class="link" href="cairo-Font-Options.html#cairo-font-options-set-subpixel-order" title="cairo_font_options_set_subpixel_order ()">cairo_font_options_set_subpixel_order</a>
64
 
                                                        (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
65
 
                                                         <a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a> subpixel_order);
66
 
<a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a> <a class="link" href="cairo-Font-Options.html#cairo-font-options-get-subpixel-order" title="cairo_font_options_get_subpixel_order ()">cairo_font_options_get_subpixel_order</a>
67
 
                                                        (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
68
 
enum                <a class="link" href="cairo-Font-Options.html#cairo-lcd-filter-t" title="enum cairo_lcd_filter_t">cairo_lcd_filter_t</a>;
69
 
void                <a class="link" href="cairo-Font-Options.html#cairo-font-options-set-lcd-filter" title="cairo_font_options_set_lcd_filter ()">cairo_font_options_set_lcd_filter</a>   (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
70
 
                                                         <a class="link" href="cairo-Font-Options.html#cairo-lcd-filter-t" title="enum cairo_lcd_filter_t">cairo_lcd_filter_t</a> lcd_filter);
71
 
<a class="link" href="cairo-Font-Options.html#cairo-lcd-filter-t" title="enum cairo_lcd_filter_t">cairo_lcd_filter_t</a>  <a class="link" href="cairo-Font-Options.html#cairo-font-options-get-lcd-filter" title="cairo_font_options_get_lcd_filter ()">cairo_font_options_get_lcd_filter</a>   (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
72
 
enum                <a class="link" href="cairo-Font-Options.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a>;
73
 
void                <a class="link" href="cairo-Font-Options.html#cairo-font-options-set-hint-style" title="cairo_font_options_set_hint_style ()">cairo_font_options_set_hint_style</a>   (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
74
 
                                                         <a class="link" href="cairo-Font-Options.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a> hint_style);
75
 
<a class="link" href="cairo-Font-Options.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a>  <a class="link" href="cairo-Font-Options.html#cairo-font-options-get-hint-style" title="cairo_font_options_get_hint_style ()">cairo_font_options_get_hint_style</a>   (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
76
 
enum                <a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a>;
77
 
void                <a class="link" href="cairo-Font-Options.html#cairo-font-options-set-hint-metrics" title="cairo_font_options_set_hint_metrics ()">cairo_font_options_set_hint_metrics</a> (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
78
 
                                                         <a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a> hint_metrics);
79
 
<a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a> <a class="link" href="cairo-Font-Options.html#cairo-font-options-get-hint-metrics" title="cairo_font_options_get_hint_metrics ()">cairo_font_options_get_hint_metrics</a>
80
 
                                                        (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
81
 
</pre>
82
 
</div>
83
 
<div class="refsect1" lang="en">
84
 
<a name="cairo-Font-Options.description"></a><h2>Description</h2>
85
 
<p>
86
 
The font options specify how fonts should be rendered.  Most of the time the
87
 
font options implied by a surface are just right and do not need any changes,
88
 
but for pixel-based targets tweaking font options may result in superior
89
 
output on a particular display.
90
 
</p>
91
 
</div>
92
 
<div class="refsect1" lang="en">
93
 
<a name="cairo-Font-Options.details"></a><h2>Details</h2>
94
 
<div class="refsect2" lang="en">
95
 
<a name="cairo-font-options-t"></a><h3>cairo_font_options_t</h3>
96
 
<pre class="programlisting">typedef struct _cairo_font_options cairo_font_options_t;
97
 
</pre>
98
 
<p>
99
 
An opaque structure holding all options that are used when
100
 
rendering fonts.
101
 
</p>
102
 
<p>
103
 
Individual features of a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> can be set or
104
 
accessed using functions named
105
 
cairo_font_options_set_<span class="emphasis"><em>feature_name</em></span> and
106
 
cairo_font_options_get_<span class="emphasis"><em>feature_name</em></span>, like
107
 
<a class="link" href="cairo-Font-Options.html#cairo-font-options-set-antialias" title="cairo_font_options_set_antialias ()"><code class="function">cairo_font_options_set_antialias()</code></a> and
108
 
<a class="link" href="cairo-Font-Options.html#cairo-font-options-get-antialias" title="cairo_font_options_get_antialias ()"><code class="function">cairo_font_options_get_antialias()</code></a>.
109
 
</p>
110
 
<p>
111
 
New features may be added to a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> in the
112
 
future.  For this reason, <a class="link" href="cairo-Font-Options.html#cairo-font-options-copy" title="cairo_font_options_copy ()"><code class="function">cairo_font_options_copy()</code></a>,
113
 
<a class="link" href="cairo-Font-Options.html#cairo-font-options-equal" title="cairo_font_options_equal ()"><code class="function">cairo_font_options_equal()</code></a>, <a class="link" href="cairo-Font-Options.html#cairo-font-options-merge" title="cairo_font_options_merge ()"><code class="function">cairo_font_options_merge()</code></a>, and
114
 
<a class="link" href="cairo-Font-Options.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
115
 
for equality, merge, or compute a hash value of
116
 
<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> objects.</p>
117
 
<p>
118
 
 
119
 
</p>
120
 
</div>
121
 
<hr>
122
 
<div class="refsect2" lang="en">
123
 
<a name="cairo-font-options-create"></a><h3>cairo_font_options_create ()</h3>
124
 
<pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a>* cairo_font_options_create         (void);</pre>
125
 
<p>
126
 
Allocates a new font options object with all options initialized
127
 
 to default values.</p>
128
 
<p>
129
 
 
130
 
</p>
131
 
<div class="variablelist"><table border="0">
132
 
<col align="left" valign="top">
133
 
<tbody><tr>
134
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
135
 
<td> a newly allocated <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>. Free with
136
 
  <a class="link" href="cairo-Font-Options.html#cairo-font-options-destroy" title="cairo_font_options_destroy ()"><code class="function">cairo_font_options_destroy()</code></a>. This function always returns a
137
 
  valid pointer; if memory cannot be allocated, then a special
138
 
  error object is returned where all operations on the object do nothing.
139
 
  You can check for this with <a class="link" href="cairo-Font-Options.html#cairo-font-options-status" title="cairo_font_options_status ()"><code class="function">cairo_font_options_status()</code></a>.
140
 
</td>
141
 
</tr></tbody>
142
 
</table></div>
143
 
</div>
144
 
<hr>
145
 
<div class="refsect2" lang="en">
146
 
<a name="cairo-font-options-copy"></a><h3>cairo_font_options_copy ()</h3>
147
 
<pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a>* cairo_font_options_copy           (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *original);</pre>
148
 
<p>
149
 
Allocates a new font options object copying the option values from
150
 
 <em class="parameter"><code>original</code></em>.</p>
151
 
<p>
152
 
 
153
 
</p>
154
 
<div class="variablelist"><table border="0">
155
 
<col align="left" valign="top">
156
 
<tbody>
157
 
<tr>
158
 
<td><p><span class="term"><em class="parameter"><code>original</code></em> :</span></p></td>
159
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
160
 
</td>
161
 
</tr>
162
 
<tr>
163
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
164
 
<td> a newly allocated <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>. Free with
165
 
  <a class="link" href="cairo-Font-Options.html#cairo-font-options-destroy" title="cairo_font_options_destroy ()"><code class="function">cairo_font_options_destroy()</code></a>. This function always returns a
166
 
  valid pointer; if memory cannot be allocated, then a special
167
 
  error object is returned where all operations on the object do nothing.
168
 
  You can check for this with <a class="link" href="cairo-Font-Options.html#cairo-font-options-status" title="cairo_font_options_status ()"><code class="function">cairo_font_options_status()</code></a>.
169
 
</td>
170
 
</tr>
171
 
</tbody>
172
 
</table></div>
173
 
</div>
174
 
<hr>
175
 
<div class="refsect2" lang="en">
176
 
<a name="cairo-font-options-destroy"></a><h3>cairo_font_options_destroy ()</h3>
177
 
<pre class="programlisting">void                cairo_font_options_destroy          (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
178
 
<p>
179
 
Destroys a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> object created with with
180
 
<a class="link" href="cairo-Font-Options.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-Font-Options.html#cairo-font-options-copy" title="cairo_font_options_copy ()"><code class="function">cairo_font_options_copy()</code></a>.</p>
181
 
<p>
182
 
 
183
 
</p>
184
 
<div class="variablelist"><table border="0">
185
 
<col align="left" valign="top">
186
 
<tbody><tr>
187
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
188
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
189
 
</td>
190
 
</tr></tbody>
191
 
</table></div>
192
 
</div>
193
 
<hr>
194
 
<div class="refsect2" lang="en">
195
 
<a name="cairo-font-options-status"></a><h3>cairo_font_options_status ()</h3>
196
 
<pre class="programlisting"><a class="link" href="cairo-Error-Handling.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a>      cairo_font_options_status           (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
197
 
<p>
198
 
Checks whether an error has previously occurred for this
199
 
font options object</p>
200
 
<p>
201
 
 
202
 
</p>
203
 
<div class="variablelist"><table border="0">
204
 
<col align="left" valign="top">
205
 
<tbody>
206
 
<tr>
207
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
208
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
209
 
</td>
210
 
</tr>
211
 
<tr>
212
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
213
 
<td> <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>
214
 
</td>
215
 
</tr>
216
 
</tbody>
217
 
</table></div>
218
 
</div>
219
 
<hr>
220
 
<div class="refsect2" lang="en">
221
 
<a name="cairo-font-options-merge"></a><h3>cairo_font_options_merge ()</h3>
222
 
<pre class="programlisting">void                cairo_font_options_merge            (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
223
 
                                                         const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *other);</pre>
224
 
<p>
225
 
Merges non-default options from <em class="parameter"><code>other</code></em> into <em class="parameter"><code>options</code></em>, replacing
226
 
existing values. This operation can be thought of as somewhat
227
 
similar to compositing <em class="parameter"><code>other</code></em> onto <em class="parameter"><code>options</code></em> with the operation
228
 
of <code class="literal">CAIRO_OPERATION_OVER</code>.</p>
229
 
<p>
230
 
 
231
 
</p>
232
 
<div class="variablelist"><table border="0">
233
 
<col align="left" valign="top">
234
 
<tbody>
235
 
<tr>
236
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
237
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
238
 
</td>
239
 
</tr>
240
 
<tr>
241
 
<td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
242
 
<td> another <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
243
 
</td>
244
 
</tr>
245
 
</tbody>
246
 
</table></div>
247
 
</div>
248
 
<hr>
249
 
<div class="refsect2" lang="en">
250
 
<a name="cairo-font-options-hash"></a><h3>cairo_font_options_hash ()</h3>
251
 
<pre class="programlisting">unsigned long       cairo_font_options_hash             (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
252
 
<p>
253
 
Compute a hash for the font options object; this value will
254
 
be useful when storing an object containing a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
255
 
in a hash table.</p>
256
 
<p>
257
 
 
258
 
</p>
259
 
<div class="variablelist"><table border="0">
260
 
<col align="left" valign="top">
261
 
<tbody>
262
 
<tr>
263
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
264
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
265
 
</td>
266
 
</tr>
267
 
<tr>
268
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
269
 
<td> the hash value for the font options object.
270
 
  The return value can be cast to a 32-bit type if a
271
 
  32-bit hash value is needed.
272
 
</td>
273
 
</tr>
274
 
</tbody>
275
 
</table></div>
276
 
</div>
277
 
<hr>
278
 
<div class="refsect2" lang="en">
279
 
<a name="cairo-font-options-equal"></a><h3>cairo_font_options_equal ()</h3>
280
 
<pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t">cairo_bool_t</a>        cairo_font_options_equal            (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
281
 
                                                         const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *other);</pre>
282
 
<p>
283
 
Compares two font options objects for equality.</p>
284
 
<p>
285
 
 
286
 
</p>
287
 
<div class="variablelist"><table border="0">
288
 
<col align="left" valign="top">
289
 
<tbody>
290
 
<tr>
291
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
292
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
293
 
</td>
294
 
</tr>
295
 
<tr>
296
 
<td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
297
 
<td> another <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
298
 
</td>
299
 
</tr>
300
 
<tr>
301
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
302
 
<td> <a
303
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
304
 
><code class="literal">TRUE</code></a> if all fields of the two font options objects match.
305
 
Note that this function will return <a
306
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
307
 
><code class="literal">FALSE</code></a> if either object is in
308
 
error.
309
 
</td>
310
 
</tr>
311
 
</tbody>
312
 
</table></div>
313
 
</div>
314
 
<hr>
315
 
<div class="refsect2" lang="en">
316
 
<a name="cairo-font-options-set-antialias"></a><h3>cairo_font_options_set_antialias ()</h3>
317
 
<pre class="programlisting">void                cairo_font_options_set_antialias    (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
318
 
                                                         <a class="link" href="cairo-cairo-t.html#cairo-antialias-t" title="enum cairo_antialias_t">cairo_antialias_t</a> antialias);</pre>
319
 
<p>
320
 
Sets the antialiasing mode for the font options object. This
321
 
specifies the type of antialiasing to do when rendering text.</p>
322
 
<p>
323
 
 
324
 
</p>
325
 
<div class="variablelist"><table border="0">
326
 
<col align="left" valign="top">
327
 
<tbody>
328
 
<tr>
329
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
330
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
331
 
</td>
332
 
</tr>
333
 
<tr>
334
 
<td><p><span class="term"><em class="parameter"><code>antialias</code></em> :</span></p></td>
335
 
<td> the new antialiasing mode
336
 
</td>
337
 
</tr>
338
 
</tbody>
339
 
</table></div>
340
 
</div>
341
 
<hr>
342
 
<div class="refsect2" lang="en">
343
 
<a name="cairo-font-options-get-antialias"></a><h3>cairo_font_options_get_antialias ()</h3>
344
 
<pre class="programlisting"><a class="link" href="cairo-cairo-t.html#cairo-antialias-t" title="enum cairo_antialias_t">cairo_antialias_t</a>   cairo_font_options_get_antialias    (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
345
 
<p>
346
 
Gets the antialiasing mode for the font options object.</p>
347
 
<p>
348
 
 
349
 
</p>
350
 
<div class="variablelist"><table border="0">
351
 
<col align="left" valign="top">
352
 
<tbody>
353
 
<tr>
354
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
355
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
356
 
</td>
357
 
</tr>
358
 
<tr>
359
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
360
 
<td> the antialiasing mode
361
 
</td>
362
 
</tr>
363
 
</tbody>
364
 
</table></div>
365
 
</div>
366
 
<hr>
367
 
<div class="refsect2" lang="en">
368
 
<a name="cairo-subpixel-order-t"></a><h3>enum cairo_subpixel_order_t</h3>
369
 
<pre class="programlisting">typedef enum _cairo_subpixel_order {
370
 
    CAIRO_SUBPIXEL_ORDER_DEFAULT,
371
 
    CAIRO_SUBPIXEL_ORDER_RGB,
372
 
    CAIRO_SUBPIXEL_ORDER_BGR,
373
 
    CAIRO_SUBPIXEL_ORDER_VRGB,
374
 
    CAIRO_SUBPIXEL_ORDER_VBGR
375
 
} cairo_subpixel_order_t;
376
 
</pre>
377
 
<p>
378
 
The subpixel order specifies the order of color elements within
379
 
each pixel on the display device when rendering with an
380
 
antialiasing mode of <a class="link" href="cairo-cairo-t.html#CAIRO-ANTIALIAS-SUBPIXEL:CAPS"><code class="literal">CAIRO_ANTIALIAS_SUBPIXEL</code></a>.</p>
381
 
<p>
382
 
 
383
 
</p>
384
 
<div class="variablelist"><table border="0">
385
 
<col align="left" valign="top">
386
 
<tbody>
387
 
<tr>
388
 
<td><p><a name="CAIRO-SUBPIXEL-ORDER-DEFAULT:CAPS"></a><span class="term"><code class="literal">CAIRO_SUBPIXEL_ORDER_DEFAULT</code></span></p></td>
389
 
<td> Use the default subpixel order for
390
 
  for the target device
391
 
</td>
392
 
</tr>
393
 
<tr>
394
 
<td><p><a name="CAIRO-SUBPIXEL-ORDER-RGB:CAPS"></a><span class="term"><code class="literal">CAIRO_SUBPIXEL_ORDER_RGB</code></span></p></td>
395
 
<td> Subpixel elements are arranged horizontally
396
 
  with red at the left
397
 
</td>
398
 
</tr>
399
 
<tr>
400
 
<td><p><a name="CAIRO-SUBPIXEL-ORDER-BGR:CAPS"></a><span class="term"><code class="literal">CAIRO_SUBPIXEL_ORDER_BGR</code></span></p></td>
401
 
<td>  Subpixel elements are arranged horizontally
402
 
  with blue at the left
403
 
</td>
404
 
</tr>
405
 
<tr>
406
 
<td><p><a name="CAIRO-SUBPIXEL-ORDER-VRGB:CAPS"></a><span class="term"><code class="literal">CAIRO_SUBPIXEL_ORDER_VRGB</code></span></p></td>
407
 
<td> Subpixel elements are arranged vertically
408
 
  with red at the top
409
 
</td>
410
 
</tr>
411
 
<tr>
412
 
<td><p><a name="CAIRO-SUBPIXEL-ORDER-VBGR:CAPS"></a><span class="term"><code class="literal">CAIRO_SUBPIXEL_ORDER_VBGR</code></span></p></td>
413
 
<td> Subpixel elements are arranged vertically
414
 
  with blue at the top
415
 
</td>
416
 
</tr>
417
 
</tbody>
418
 
</table></div>
419
 
</div>
420
 
<hr>
421
 
<div class="refsect2" lang="en">
422
 
<a name="cairo-font-options-set-subpixel-order"></a><h3>cairo_font_options_set_subpixel_order ()</h3>
423
 
<pre class="programlisting">void                cairo_font_options_set_subpixel_order
424
 
                                                        (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
425
 
                                                         <a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a> subpixel_order);</pre>
426
 
<p>
427
 
Sets the subpixel order for the font options object. The subpixel
428
 
order specifies the order of color elements within each pixel on
429
 
the display device when rendering with an antialiasing mode of
430
 
<a class="link" href="cairo-cairo-t.html#CAIRO-ANTIALIAS-SUBPIXEL:CAPS"><code class="literal">CAIRO_ANTIALIAS_SUBPIXEL</code></a>. See the documentation for
431
 
<a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t"><span class="type">cairo_subpixel_order_t</span></a> for full details.</p>
432
 
<p>
433
 
 
434
 
</p>
435
 
<div class="variablelist"><table border="0">
436
 
<col align="left" valign="top">
437
 
<tbody>
438
 
<tr>
439
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
440
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
441
 
</td>
442
 
</tr>
443
 
<tr>
444
 
<td><p><span class="term"><em class="parameter"><code>subpixel_order</code></em> :</span></p></td>
445
 
<td> the new subpixel order
446
 
</td>
447
 
</tr>
448
 
</tbody>
449
 
</table></div>
450
 
</div>
451
 
<hr>
452
 
<div class="refsect2" lang="en">
453
 
<a name="cairo-font-options-get-subpixel-order"></a><h3>cairo_font_options_get_subpixel_order ()</h3>
454
 
<pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t">cairo_subpixel_order_t</a> cairo_font_options_get_subpixel_order
455
 
                                                        (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
456
 
<p>
457
 
Gets the subpixel order for the font options object.
458
 
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-subpixel-order-t" title="enum cairo_subpixel_order_t"><span class="type">cairo_subpixel_order_t</span></a> for full details.</p>
459
 
<p>
460
 
 
461
 
</p>
462
 
<div class="variablelist"><table border="0">
463
 
<col align="left" valign="top">
464
 
<tbody>
465
 
<tr>
466
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
467
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
468
 
</td>
469
 
</tr>
470
 
<tr>
471
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
472
 
<td> the subpixel order for the font options object
473
 
</td>
474
 
</tr>
475
 
</tbody>
476
 
</table></div>
477
 
</div>
478
 
<hr>
479
 
<div class="refsect2" lang="en">
480
 
<a name="cairo-lcd-filter-t"></a><h3>enum cairo_lcd_filter_t</h3>
481
 
<pre class="programlisting">typedef enum _cairo_lcd_filter {
482
 
    CAIRO_LCD_FILTER_DEFAULT,
483
 
    CAIRO_LCD_FILTER_NONE,
484
 
    CAIRO_LCD_FILTER_INTRA_PIXEL,
485
 
    CAIRO_LCD_FILTER_FIR3,
486
 
    CAIRO_LCD_FILTER_FIR5
487
 
} cairo_lcd_filter_t;
488
 
</pre>
489
 
<p>
490
 
The LCD filter specifies the low-pass filter applied to LCD-optimized
491
 
bitmaps generated with an antialiasing mode of <a class="link" href="cairo-cairo-t.html#CAIRO-ANTIALIAS-SUBPIXEL:CAPS"><code class="literal">CAIRO_ANTIALIAS_SUBPIXEL</code></a>.</p>
492
 
<p>
493
 
 
494
 
</p>
495
 
<div class="variablelist"><table border="0">
496
 
<col align="left" valign="top">
497
 
<tbody>
498
 
<tr>
499
 
<td><p><a name="CAIRO-LCD-FILTER-DEFAULT:CAPS"></a><span class="term"><code class="literal">CAIRO_LCD_FILTER_DEFAULT</code></span></p></td>
500
 
<td> Use the default LCD filter for
501
 
  font backend and target device
502
 
</td>
503
 
</tr>
504
 
<tr>
505
 
<td><p><a name="CAIRO-LCD-FILTER-NONE:CAPS"></a><span class="term"><code class="literal">CAIRO_LCD_FILTER_NONE</code></span></p></td>
506
 
<td> Do not perform LCD filtering
507
 
</td>
508
 
</tr>
509
 
<tr>
510
 
<td><p><a name="CAIRO-LCD-FILTER-INTRA-PIXEL:CAPS"></a><span class="term"><code class="literal">CAIRO_LCD_FILTER_INTRA_PIXEL</code></span></p></td>
511
 
<td> Intra-pixel filter
512
 
</td>
513
 
</tr>
514
 
<tr>
515
 
<td><p><a name="CAIRO-LCD-FILTER-FIR3:CAPS"></a><span class="term"><code class="literal">CAIRO_LCD_FILTER_FIR3</code></span></p></td>
516
 
<td> FIR filter with a 3x3 kernel
517
 
</td>
518
 
</tr>
519
 
<tr>
520
 
<td><p><a name="CAIRO-LCD-FILTER-FIR5:CAPS"></a><span class="term"><code class="literal">CAIRO_LCD_FILTER_FIR5</code></span></p></td>
521
 
<td> FIR filter with a 5x5 kernel
522
 
</td>
523
 
</tr>
524
 
</tbody>
525
 
</table></div>
526
 
<p class="since">Since  1.8
527
 
</p>
528
 
</div>
529
 
<hr>
530
 
<div class="refsect2" lang="en">
531
 
<a name="cairo-font-options-set-lcd-filter"></a><h3>cairo_font_options_set_lcd_filter ()</h3>
532
 
<pre class="programlisting">void                cairo_font_options_set_lcd_filter   (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
533
 
                                                         <a class="link" href="cairo-Font-Options.html#cairo-lcd-filter-t" title="enum cairo_lcd_filter_t">cairo_lcd_filter_t</a> lcd_filter);</pre>
534
 
<p>
535
 
Sets the LCD filter for the font options object. The LCD filter
536
 
specifies how pixels are filtered when rendered with an antialiasing
537
 
mode of <a class="link" href="cairo-cairo-t.html#CAIRO-ANTIALIAS-SUBPIXEL:CAPS"><code class="literal">CAIRO_ANTIALIAS_SUBPIXEL</code></a>. See the documentation for
538
 
<a class="link" href="cairo-Font-Options.html#cairo-lcd-filter-t" title="enum cairo_lcd_filter_t"><span class="type">cairo_lcd_filter_t</span></a> for full details.</p>
539
 
<p>
540
 
 
541
 
</p>
542
 
<div class="variablelist"><table border="0">
543
 
<col align="left" valign="top">
544
 
<tbody>
545
 
<tr>
546
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
547
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
548
 
</td>
549
 
</tr>
550
 
<tr>
551
 
<td><p><span class="term"><em class="parameter"><code>lcd_filter</code></em> :</span></p></td>
552
 
<td> the new LCD filter
553
 
</td>
554
 
</tr>
555
 
</tbody>
556
 
</table></div>
557
 
<p class="since">Since  1.8
558
 
</p>
559
 
</div>
560
 
<hr>
561
 
<div class="refsect2" lang="en">
562
 
<a name="cairo-font-options-get-lcd-filter"></a><h3>cairo_font_options_get_lcd_filter ()</h3>
563
 
<pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-lcd-filter-t" title="enum cairo_lcd_filter_t">cairo_lcd_filter_t</a>  cairo_font_options_get_lcd_filter   (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
564
 
<p>
565
 
Gets the LCD filter for the font options object.
566
 
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-lcd-filter-t" title="enum cairo_lcd_filter_t"><span class="type">cairo_lcd_filter_t</span></a> for full details.</p>
567
 
<p>
568
 
 
569
 
</p>
570
 
<div class="variablelist"><table border="0">
571
 
<col align="left" valign="top">
572
 
<tbody>
573
 
<tr>
574
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
575
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
576
 
</td>
577
 
</tr>
578
 
<tr>
579
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
580
 
<td> the LCD filter for the font options object
581
 
 
582
 
</td>
583
 
</tr>
584
 
</tbody>
585
 
</table></div>
586
 
<p class="since">Since  1.8
587
 
</p>
588
 
</div>
589
 
<hr>
590
 
<div class="refsect2" lang="en">
591
 
<a name="cairo-hint-style-t"></a><h3>enum cairo_hint_style_t</h3>
592
 
<pre class="programlisting">typedef enum _cairo_hint_style {
593
 
    CAIRO_HINT_STYLE_DEFAULT,
594
 
    CAIRO_HINT_STYLE_NONE,
595
 
    CAIRO_HINT_STYLE_SLIGHT,
596
 
    CAIRO_HINT_STYLE_MEDIUM,
597
 
    CAIRO_HINT_STYLE_FULL
598
 
} cairo_hint_style_t;
599
 
</pre>
600
 
<p>
601
 
Specifies the type of hinting to do on font outlines. Hinting
602
 
is the process of fitting outlines to the pixel grid in order
603
 
to improve the appearance of the result. Since hinting outlines
604
 
involves distorting them, it also reduces the faithfulness
605
 
to the original outline shapes. Not all of the outline hinting
606
 
styles are supported by all font backends.
607
 
</p>
608
 
<p>
609
 
New entries may be added in future versions.</p>
610
 
<p>
611
 
 
612
 
</p>
613
 
<div class="variablelist"><table border="0">
614
 
<col align="left" valign="top">
615
 
<tbody>
616
 
<tr>
617
 
<td><p><a name="CAIRO-HINT-STYLE-DEFAULT:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_STYLE_DEFAULT</code></span></p></td>
618
 
<td> Use the default hint style for
619
 
  font backend and target device
620
 
</td>
621
 
</tr>
622
 
<tr>
623
 
<td><p><a name="CAIRO-HINT-STYLE-NONE:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_STYLE_NONE</code></span></p></td>
624
 
<td> Do not hint outlines
625
 
</td>
626
 
</tr>
627
 
<tr>
628
 
<td><p><a name="CAIRO-HINT-STYLE-SLIGHT:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_STYLE_SLIGHT</code></span></p></td>
629
 
<td> Hint outlines slightly to improve
630
 
  contrast while retaining good fidelity to the original
631
 
  shapes.
632
 
</td>
633
 
</tr>
634
 
<tr>
635
 
<td><p><a name="CAIRO-HINT-STYLE-MEDIUM:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_STYLE_MEDIUM</code></span></p></td>
636
 
<td> Hint outlines with medium strength
637
 
  giving a compromise between fidelity to the original shapes
638
 
  and contrast
639
 
</td>
640
 
</tr>
641
 
<tr>
642
 
<td><p><a name="CAIRO-HINT-STYLE-FULL:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_STYLE_FULL</code></span></p></td>
643
 
<td> Hint outlines to maximize contrast
644
 
</td>
645
 
</tr>
646
 
</tbody>
647
 
</table></div>
648
 
</div>
649
 
<hr>
650
 
<div class="refsect2" lang="en">
651
 
<a name="cairo-font-options-set-hint-style"></a><h3>cairo_font_options_set_hint_style ()</h3>
652
 
<pre class="programlisting">void                cairo_font_options_set_hint_style   (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
653
 
                                                         <a class="link" href="cairo-Font-Options.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a> hint_style);</pre>
654
 
<p>
655
 
Sets the hint style for font outlines for the font options object.
656
 
This controls whether to fit font outlines to the pixel grid,
657
 
and if so, whether to optimize for fidelity or contrast.
658
 
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-hint-style-t" title="enum cairo_hint_style_t"><span class="type">cairo_hint_style_t</span></a> for full details.</p>
659
 
<p>
660
 
 
661
 
</p>
662
 
<div class="variablelist"><table border="0">
663
 
<col align="left" valign="top">
664
 
<tbody>
665
 
<tr>
666
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
667
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
668
 
</td>
669
 
</tr>
670
 
<tr>
671
 
<td><p><span class="term"><em class="parameter"><code>hint_style</code></em> :</span></p></td>
672
 
<td> the new hint style
673
 
</td>
674
 
</tr>
675
 
</tbody>
676
 
</table></div>
677
 
</div>
678
 
<hr>
679
 
<div class="refsect2" lang="en">
680
 
<a name="cairo-font-options-get-hint-style"></a><h3>cairo_font_options_get_hint_style ()</h3>
681
 
<pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-hint-style-t" title="enum cairo_hint_style_t">cairo_hint_style_t</a>  cairo_font_options_get_hint_style   (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
682
 
<p>
683
 
Gets the hint style for font outlines for the font options object.
684
 
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-hint-style-t" title="enum cairo_hint_style_t"><span class="type">cairo_hint_style_t</span></a> for full details.</p>
685
 
<p>
686
 
 
687
 
</p>
688
 
<div class="variablelist"><table border="0">
689
 
<col align="left" valign="top">
690
 
<tbody>
691
 
<tr>
692
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
693
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
694
 
</td>
695
 
</tr>
696
 
<tr>
697
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
698
 
<td> the hint style for the font options object
699
 
</td>
700
 
</tr>
701
 
</tbody>
702
 
</table></div>
703
 
</div>
704
 
<hr>
705
 
<div class="refsect2" lang="en">
706
 
<a name="cairo-hint-metrics-t"></a><h3>enum cairo_hint_metrics_t</h3>
707
 
<pre class="programlisting">typedef enum _cairo_hint_metrics {
708
 
    CAIRO_HINT_METRICS_DEFAULT,
709
 
    CAIRO_HINT_METRICS_OFF,
710
 
    CAIRO_HINT_METRICS_ON
711
 
} cairo_hint_metrics_t;
712
 
</pre>
713
 
<p>
714
 
Specifies whether to hint font metrics; hinting font metrics
715
 
means quantizing them so that they are integer values in
716
 
device space. Doing this improves the consistency of
717
 
letter and line spacing, however it also means that text
718
 
will be laid out differently at different zoom factors.</p>
719
 
<p>
720
 
 
721
 
</p>
722
 
<div class="variablelist"><table border="0">
723
 
<col align="left" valign="top">
724
 
<tbody>
725
 
<tr>
726
 
<td><p><a name="CAIRO-HINT-METRICS-DEFAULT:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_METRICS_DEFAULT</code></span></p></td>
727
 
<td> Hint metrics in the default
728
 
 manner for the font backend and target device
729
 
</td>
730
 
</tr>
731
 
<tr>
732
 
<td><p><a name="CAIRO-HINT-METRICS-OFF:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_METRICS_OFF</code></span></p></td>
733
 
<td> Do not hint font metrics
734
 
</td>
735
 
</tr>
736
 
<tr>
737
 
<td><p><a name="CAIRO-HINT-METRICS-ON:CAPS"></a><span class="term"><code class="literal">CAIRO_HINT_METRICS_ON</code></span></p></td>
738
 
<td> Hint font metrics
739
 
</td>
740
 
</tr>
741
 
</tbody>
742
 
</table></div>
743
 
</div>
744
 
<hr>
745
 
<div class="refsect2" lang="en">
746
 
<a name="cairo-font-options-set-hint-metrics"></a><h3>cairo_font_options_set_hint_metrics ()</h3>
747
 
<pre class="programlisting">void                cairo_font_options_set_hint_metrics (<a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options,
748
 
                                                         <a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a> hint_metrics);</pre>
749
 
<p>
750
 
Sets the metrics hinting mode for the font options object. This
751
 
controls whether metrics are quantized to integer values in
752
 
device units.
753
 
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t"><span class="type">cairo_hint_metrics_t</span></a> for full details.</p>
754
 
<p>
755
 
 
756
 
</p>
757
 
<div class="variablelist"><table border="0">
758
 
<col align="left" valign="top">
759
 
<tbody>
760
 
<tr>
761
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
762
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
763
 
</td>
764
 
</tr>
765
 
<tr>
766
 
<td><p><span class="term"><em class="parameter"><code>hint_metrics</code></em> :</span></p></td>
767
 
<td> the new metrics hinting mode
768
 
</td>
769
 
</tr>
770
 
</tbody>
771
 
</table></div>
772
 
</div>
773
 
<hr>
774
 
<div class="refsect2" lang="en">
775
 
<a name="cairo-font-options-get-hint-metrics"></a><h3>cairo_font_options_get_hint_metrics ()</h3>
776
 
<pre class="programlisting"><a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t">cairo_hint_metrics_t</a> cairo_font_options_get_hint_metrics
777
 
                                                        (const <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
778
 
<p>
779
 
Gets the metrics hinting mode for the font options object.
780
 
See the documentation for <a class="link" href="cairo-Font-Options.html#cairo-hint-metrics-t" title="enum cairo_hint_metrics_t"><span class="type">cairo_hint_metrics_t</span></a> for full details.</p>
781
 
<p>
782
 
 
783
 
</p>
784
 
<div class="variablelist"><table border="0">
785
 
<col align="left" valign="top">
786
 
<tbody>
787
 
<tr>
788
 
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
789
 
<td> a <a class="link" href="cairo-Font-Options.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a>
790
 
</td>
791
 
</tr>
792
 
<tr>
793
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
794
 
<td> the metrics hinting mode for the font options object
795
 
</td>
796
 
</tr>
797
 
</tbody>
798
 
</table></div>
799
 
</div>
800
 
</div>
801
 
<div class="refsect1" lang="en">
802
 
<a name="cairo-Font-Options.see-also"></a><h2>See Also</h2>
803
 
<p>
804
 
</p>
805
 
<div class="itemizedlist"><ul type="disc"><li><a class="link" href="cairo-Scaled-Fonts.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a></li></ul></div>
806
 
<p>
807
 
</p>
808
 
</div>
809
 
</div>
810
 
<div class="footer">
811
 
<hr>
812
 
          Generated by GTK-Doc V1.10</div>
813
 
</body>
814
 
</html>