cairo 1.8.0-x86-mswin32 → 1.8.1-x86-mswin32
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of cairo might be problematic. Click here for more details.
- data/ChangeLog +25 -0
- data/NEWS +8 -0
- data/Rakefile +5 -32
- data/cairo/bin/libcairo-2.dll +0 -0
- data/cairo/bin/libpng12-0.dll +0 -0
- data/cairo/include/cairo/cairo-features.h +1 -1
- data/cairo/include/cairo/cairo-ft.h +75 -0
- data/cairo/include/cairo/cairo-version.h +1 -1
- data/cairo/include/cairo/cairo.h +16 -21
- data/cairo/include/libpng12/png.h +251 -121
- data/cairo/include/libpng12/pngconf.h +83 -56
- data/cairo/include/png.h +251 -121
- data/cairo/include/pngconf.h +83 -56
- data/cairo/lib/cairo.def +5 -0
- data/cairo/lib/cairo.lib +0 -0
- data/cairo/lib/libcairo.dll.a +0 -0
- data/cairo/lib/libpng.def +3 -0
- data/cairo/lib/libpng.lib +0 -0
- data/cairo/lib/libpng12.dll.a +0 -0
- data/cairo/lib/pkgconfig/cairo-ft.pc +12 -0
- data/cairo/lib/pkgconfig/cairo-pdf.pc +2 -2
- data/cairo/lib/pkgconfig/cairo-png.pc +2 -2
- data/cairo/lib/pkgconfig/cairo-ps.pc +2 -2
- data/cairo/lib/pkgconfig/cairo-svg.pc +2 -2
- data/cairo/lib/pkgconfig/cairo-win32-font.pc +2 -2
- data/cairo/lib/pkgconfig/cairo-win32.pc +2 -2
- data/cairo/lib/pkgconfig/cairo.pc +4 -4
- data/cairo/lib/pkgconfig/libpng.pc +2 -2
- data/cairo/lib/pkgconfig/libpng12.pc +2 -2
- data/cairo/manifest/{cairo-dev_1.8.0-1_win32.mft → cairo-dev_1.8.8-2_win32.mft} +5 -3
- data/cairo/manifest/cairo_1.8.8-2_win32.mft +5 -0
- data/cairo/manifest/{libpng-dev_1.2.32-1_win32.mft → libpng-dev_1.2.39-1_win32.mft} +3 -3
- data/cairo/manifest/libpng_1.2.39-1_win32.mft +2 -0
- data/cairo/share/doc/{cairo_1.8.0-1_win32 → cairo_1.8.8-2_win32}/COPYING +0 -0
- data/cairo/share/doc/{cairo_1.8.0-1_win32 → cairo_1.8.8-2_win32}/COPYING-LGPL-2.1 +0 -0
- data/cairo/share/doc/{cairo_1.8.0-1_win32 → cairo_1.8.8-2_win32}/COPYING-MPL-1.1 +0 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-errors.html +9 -9
- data/cairo/share/gtk-doc/html/cairo/bindings-fonts.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/bindings-memory.html +8 -8
- data/cairo/share/gtk-doc/html/cairo/bindings-overloading.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/bindings-path.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/bindings-patterns.html +6 -6
- data/cairo/share/gtk-doc/html/cairo/bindings-return-values.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/bindings-streams.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/bindings-surfaces.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/cairo-context.html +200 -262
- data/cairo/share/gtk-doc/html/cairo/cairo-drawing.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/cairo-error-status.html +61 -60
- data/cairo/share/gtk-doc/html/cairo/cairo-font-face.html +51 -53
- data/cairo/share/gtk-doc/html/cairo/cairo-font-options.html +65 -78
- data/cairo/share/gtk-doc/html/cairo/cairo-fonts.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/cairo-ft-font.html +37 -34
- data/cairo/share/gtk-doc/html/cairo/cairo-image-surface.html +49 -60
- data/cairo/share/gtk-doc/html/cairo/cairo-matrix.html +30 -41
- data/cairo/share/gtk-doc/html/cairo/cairo-paths.html +72 -97
- data/cairo/share/gtk-doc/html/cairo/cairo-pattern.html +184 -175
- data/cairo/share/gtk-doc/html/cairo/cairo-pdf-surface.html +40 -34
- data/cairo/share/gtk-doc/html/cairo/cairo-png-functions.html +57 -48
- data/cairo/share/gtk-doc/html/cairo/cairo-ps-surface.html +73 -76
- data/cairo/share/gtk-doc/html/cairo/cairo-quartz-font.html +27 -30
- data/cairo/share/gtk-doc/html/cairo/cairo-quartz-surface.html +29 -34
- data/cairo/share/gtk-doc/html/cairo/cairo-scaled-font.html +102 -106
- data/cairo/share/gtk-doc/html/cairo/cairo-support.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/cairo-surface.html +101 -127
- data/cairo/share/gtk-doc/html/cairo/cairo-surfaces.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/cairo-svg-surface.html +52 -49
- data/cairo/share/gtk-doc/html/cairo/cairo-text.html +126 -146
- data/cairo/share/gtk-doc/html/cairo/cairo-transformations.html +26 -35
- data/cairo/share/gtk-doc/html/cairo/cairo-types.html +16 -17
- data/cairo/share/gtk-doc/html/cairo/cairo-user-font.html +121 -127
- data/cairo/share/gtk-doc/html/cairo/cairo-version-info.html +50 -60
- data/cairo/share/gtk-doc/html/cairo/cairo-win32-font.html +37 -46
- data/cairo/share/gtk-doc/html/cairo/cairo-win32-surface.html +58 -58
- data/cairo/share/gtk-doc/html/cairo/cairo-xlib-surface.html +47 -63
- data/cairo/share/gtk-doc/html/cairo/cairo.devhelp +21 -21
- data/cairo/share/gtk-doc/html/cairo/cairo.devhelp2 +21 -21
- data/cairo/share/gtk-doc/html/cairo/index-1.2.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/index-1.4.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/index-1.6.html +5 -5
- data/cairo/share/gtk-doc/html/cairo/index-1.8.html +8 -8
- data/cairo/share/gtk-doc/html/cairo/index-all.html +24 -24
- data/cairo/share/gtk-doc/html/cairo/index.html +6 -6
- data/cairo/share/gtk-doc/html/cairo/index.sgml +19 -19
- data/cairo/share/gtk-doc/html/cairo/language-bindings.html +6 -6
- data/cairo/share/gtk-doc/html/cairo/style.css +8 -1
- data/cairo/share/man/man3/libpng.3 +299 -59
- data/cairo/share/man/man3/libpngpf.3 +2 -2
- data/cairo/share/man/man5/png.5 +1 -1
- data/cairo/src/tml/packaging/cairo_1.8.8-2_win32.log +949 -0
- data/cairo/src/tml/{make/cairo_1.8.0-1_win32.sh → packaging/cairo_1.8.8-2_win32.sh} +6 -6
- data/cairo/src/tml/{make/libpng_1.2.32-1_win32.log → packaging/libpng_1.2.39-1_win32.log} +74 -73
- data/cairo/src/tml/{make/libpng_1.2.32-1_win32.sh → packaging/libpng_1.2.39-1_win32.sh} +4 -4
- data/doc/ja/cairo-context.html +1 -1
- data/doc/ja/index.html +0 -3
- data/extconf.rb +1 -0
- data/pkg-config.rb +4 -0
- data/src/cairo.so +0 -0
- data/src/libruby-cairo.a +0 -0
- data/src/rb_cairo.c +2 -2
- data/src/rb_cairo_surface.c +6 -2
- metadata +20 -50
- data/cairo/DLL_FAQ.txt +0 -397
- data/cairo/README.txt +0 -53
- data/cairo/USAGE.txt +0 -94
- data/cairo/bin/zlib1.dll +0 -0
- data/cairo/include/zconf.h +0 -332
- data/cairo/include/zlib.h +0 -1357
- data/cairo/lib/zdll.exp +0 -0
- data/cairo/lib/zdll.lib +0 -0
- data/cairo/lib/zlib.def +0 -60
- data/cairo/manifest/cairo_1.8.0-1_win32.mft +0 -5
- data/cairo/manifest/libpng_1.2.32-1_win32.mft +0 -2
- data/cairo/src/tml/make/cairo_1.8.0-1_win32.log +0 -1021
- data/cairo/test/example_d.exe +0 -0
- data/cairo/test/minigzip_d.exe +0 -0
- data/cairo/test/testzlib_d.exe +0 -0
- data/cairo/test/untgz_d.exe +0 -0
@@ -3,12 +3,12 @@
|
|
3
3
|
<head>
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
5
|
<title>Quartz Surfaces</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.
|
7
|
-
<link rel="
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
|
7
|
+
<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
|
8
8
|
<link rel="up" href="cairo-surfaces.html" title="Surfaces">
|
9
9
|
<link rel="prev" href="cairo-svg-surface.html" title="SVG Surfaces">
|
10
10
|
<link rel="next" href="cairo-xlib-surface.html" title="XLib Surfaces">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
<link rel="chapter" href="cairo-drawing.html" title="Drawing">
|
14
14
|
<link rel="chapter" href="cairo-fonts.html" title="Fonts">
|
@@ -30,11 +30,13 @@
|
|
30
30
|
<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
|
31
31
|
<td><a accesskey="n" href="cairo-xlib-surface.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
32
32
|
</tr>
|
33
|
-
<tr><td colspan="5" class="shortcuts"
|
34
|
-
|
35
|
-
|
33
|
+
<tr><td colspan="5" class="shortcuts">
|
34
|
+
<a href="#cairo-quartz-surface.synopsis" class="shortcut">Top</a>
|
35
|
+
|
|
36
|
+
<a href="#cairo-quartz-surface.description" class="shortcut">Description</a>
|
37
|
+
</td></tr>
|
36
38
|
</table>
|
37
|
-
<div class="refentry"
|
39
|
+
<div class="refentry" title="Quartz Surfaces">
|
38
40
|
<a name="cairo-quartz-surface"></a><div class="titlepage"></div>
|
39
41
|
<div class="refnamediv"><table width="100%"><tr>
|
40
42
|
<td valign="top">
|
@@ -43,42 +45,41 @@
|
|
43
45
|
</td>
|
44
46
|
<td valign="top" align="right"></td>
|
45
47
|
</tr></table></div>
|
46
|
-
<div class="refsynopsisdiv">
|
48
|
+
<div class="refsynopsisdiv" title="Synopsis">
|
47
49
|
<a name="cairo-quartz-surface.synopsis"></a><h2>Synopsis</h2>
|
48
50
|
<pre class="synopsis">
|
49
|
-
#define <a class="link" href="cairo-quartz-surface.html#CAIRO-HAS-QUARTZ-SURFACE
|
50
|
-
<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a
|
51
|
+
#define <a class="link" href="cairo-quartz-surface.html#CAIRO-HAS-QUARTZ-SURFACE--CAPS" title="CAIRO_HAS_QUARTZ_SURFACE">CAIRO_HAS_QUARTZ_SURFACE</a>
|
52
|
+
<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * <a class="link" href="cairo-quartz-surface.html#cairo-quartz-surface-create" title="cairo_quartz_surface_create ()">cairo_quartz_surface_create</a> (<a class="link" href="cairo-image-surface.html#cairo-format-t" title="enum cairo_format_t">cairo_format_t</a> format,
|
51
53
|
unsigned int width,
|
52
54
|
unsigned int height);
|
53
|
-
<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a
|
55
|
+
<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * <a class="link" href="cairo-quartz-surface.html#cairo-quartz-surface-create-for-cg-context" title="cairo_quartz_surface_create_for_cg_context ()">cairo_quartz_surface_create_for_cg_context</a>
|
54
56
|
(CGContextRef cgContext,
|
55
57
|
unsigned int width,
|
56
58
|
unsigned int height);
|
57
59
|
CGContextRef <a class="link" href="cairo-quartz-surface.html#cairo-quartz-surface-get-cg-context" title="cairo_quartz_surface_get_cg_context ()">cairo_quartz_surface_get_cg_context</a> (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface);
|
58
60
|
</pre>
|
59
61
|
</div>
|
60
|
-
<div class="refsect1"
|
62
|
+
<div class="refsect1" title="Description">
|
61
63
|
<a name="cairo-quartz-surface.description"></a><h2>Description</h2>
|
62
64
|
<p>
|
63
65
|
The Quartz surface is used to render cairo graphics targeting the
|
64
66
|
Apple OS X Quartz rendering system.
|
65
67
|
</p>
|
66
68
|
</div>
|
67
|
-
<div class="refsect1"
|
69
|
+
<div class="refsect1" title="Details">
|
68
70
|
<a name="cairo-quartz-surface.details"></a><h2>Details</h2>
|
69
|
-
<div class="refsect2"
|
70
|
-
<a name="CAIRO-HAS-QUARTZ-SURFACE
|
71
|
-
<pre class="programlisting">#define
|
72
|
-
</pre>
|
71
|
+
<div class="refsect2" title="CAIRO_HAS_QUARTZ_SURFACE">
|
72
|
+
<a name="CAIRO-HAS-QUARTZ-SURFACE--CAPS"></a><h3>CAIRO_HAS_QUARTZ_SURFACE</h3>
|
73
|
+
<pre class="programlisting">#define CAIRO_HAS_QUARTZ_SURFACE</pre>
|
73
74
|
<p>
|
74
75
|
Defined if the Quartz surface backend is available.
|
75
76
|
This macro can be used to conditionally compile backend-specific code.
|
76
77
|
</p>
|
77
78
|
</div>
|
78
79
|
<hr>
|
79
|
-
<div class="refsect2"
|
80
|
+
<div class="refsect2" title="cairo_quartz_surface_create ()">
|
80
81
|
<a name="cairo-quartz-surface-create"></a><h3>cairo_quartz_surface_create ()</h3>
|
81
|
-
<pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a
|
82
|
+
<pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * cairo_quartz_surface_create (<a class="link" href="cairo-image-surface.html#cairo-format-t" title="enum cairo_format_t">cairo_format_t</a> format,
|
82
83
|
unsigned int width,
|
83
84
|
unsigned int height);</pre>
|
84
85
|
<p>
|
@@ -87,7 +88,6 @@ created using the Device RGB (or Device Gray, for A8) color space.
|
|
87
88
|
All Cairo operations, including those that require software
|
88
89
|
rendering, will succeed on this surface.</p>
|
89
90
|
<p>
|
90
|
-
|
91
91
|
</p>
|
92
92
|
<div class="variablelist"><table border="0">
|
93
93
|
<col align="left" valign="top">
|
@@ -115,13 +115,12 @@ rendering, will succeed on this surface.</p>
|
|
115
115
|
</tr>
|
116
116
|
</tbody>
|
117
117
|
</table></div>
|
118
|
-
<p class="since">Since
|
119
|
-
</p>
|
118
|
+
<p class="since">Since 1.4</p>
|
120
119
|
</div>
|
121
120
|
<hr>
|
122
|
-
<div class="refsect2"
|
121
|
+
<div class="refsect2" title="cairo_quartz_surface_create_for_cg_context ()">
|
123
122
|
<a name="cairo-quartz-surface-create-for-cg-context"></a><h3>cairo_quartz_surface_create_for_cg_context ()</h3>
|
124
|
-
<pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a
|
123
|
+
<pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * cairo_quartz_surface_create_for_cg_context
|
125
124
|
(CGContextRef cgContext,
|
126
125
|
unsigned int width,
|
127
126
|
unsigned int height);</pre>
|
@@ -146,7 +145,6 @@ CGContextScaleCTM (cgContext, 1.0, -1.0);
|
|
146
145
|
All Cairo operations are implemented in terms of Quartz operations,
|
147
146
|
as long as Quartz-compatible elements are used (such as Quartz fonts).</p>
|
148
147
|
<p>
|
149
|
-
|
150
148
|
</p>
|
151
149
|
<div class="variablelist"><table border="0">
|
152
150
|
<col align="left" valign="top">
|
@@ -174,18 +172,16 @@ as long as Quartz-compatible elements are used (such as Quartz fonts).</p>
|
|
174
172
|
</tr>
|
175
173
|
</tbody>
|
176
174
|
</table></div>
|
177
|
-
<p class="since">Since
|
178
|
-
</p>
|
175
|
+
<p class="since">Since 1.4</p>
|
179
176
|
</div>
|
180
177
|
<hr>
|
181
|
-
<div class="refsect2"
|
178
|
+
<div class="refsect2" title="cairo_quartz_surface_get_cg_context ()">
|
182
179
|
<a name="cairo-quartz-surface-get-cg-context"></a><h3>cairo_quartz_surface_get_cg_context ()</h3>
|
183
180
|
<pre class="programlisting">CGContextRef cairo_quartz_surface_get_cg_context (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface);</pre>
|
184
181
|
<p>
|
185
182
|
Returns the CGContextRef that the given Quartz surface is backed
|
186
183
|
by.</p>
|
187
184
|
<p>
|
188
|
-
|
189
185
|
</p>
|
190
186
|
<div class="variablelist"><table border="0">
|
191
187
|
<col align="left" valign="top">
|
@@ -203,21 +199,20 @@ by.</p>
|
|
203
199
|
</tr>
|
204
200
|
</tbody>
|
205
201
|
</table></div>
|
206
|
-
<p class="since">Since
|
207
|
-
</p>
|
202
|
+
<p class="since">Since 1.4</p>
|
208
203
|
</div>
|
209
204
|
</div>
|
210
|
-
<div class="refsect1"
|
205
|
+
<div class="refsect1" title="See Also">
|
211
206
|
<a name="cairo-quartz-surface.see-also"></a><h2>See Also</h2>
|
212
207
|
<p>
|
213
208
|
</p>
|
214
|
-
<div class="itemizedlist"><ul type="disc"><li><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></li></ul></div>
|
209
|
+
<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></li></ul></div>
|
215
210
|
<p>
|
216
211
|
</p>
|
217
212
|
</div>
|
218
213
|
</div>
|
219
214
|
<div class="footer">
|
220
215
|
<hr>
|
221
|
-
Generated by GTK-Doc V1.
|
216
|
+
Generated by GTK-Doc V1.11</div>
|
222
217
|
</body>
|
223
218
|
</html>
|
@@ -3,12 +3,12 @@
|
|
3
3
|
<head>
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
5
|
<title>cairo_scaled_font_t</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.
|
7
|
-
<link rel="
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
|
7
|
+
<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
|
8
8
|
<link rel="up" href="cairo-fonts.html" title="Fonts">
|
9
9
|
<link rel="prev" href="cairo-font-face.html" title="cairo_font_face_t">
|
10
10
|
<link rel="next" href="cairo-font-options.html" title="cairo_font_options_t">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
<link rel="chapter" href="cairo-drawing.html" title="Drawing">
|
14
14
|
<link rel="chapter" href="cairo-fonts.html" title="Fonts">
|
@@ -30,11 +30,13 @@
|
|
30
30
|
<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
|
31
31
|
<td><a accesskey="n" href="cairo-font-options.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
32
32
|
</tr>
|
33
|
-
<tr><td colspan="5" class="shortcuts"
|
34
|
-
|
35
|
-
|
33
|
+
<tr><td colspan="5" class="shortcuts">
|
34
|
+
<a href="#cairo-scaled-font.synopsis" class="shortcut">Top</a>
|
35
|
+
|
|
36
|
+
<a href="#cairo-scaled-font.description" class="shortcut">Description</a>
|
37
|
+
</td></tr>
|
36
38
|
</table>
|
37
|
-
<div class="refentry"
|
39
|
+
<div class="refentry" title="cairo_scaled_font_t">
|
38
40
|
<a name="cairo-scaled-font"></a><div class="titlepage"></div>
|
39
41
|
<div class="refnamediv"><table width="100%"><tr>
|
40
42
|
<td valign="top">
|
@@ -43,15 +45,15 @@
|
|
43
45
|
</td>
|
44
46
|
<td valign="top" align="right"></td>
|
45
47
|
</tr></table></div>
|
46
|
-
<div class="refsynopsisdiv">
|
48
|
+
<div class="refsynopsisdiv" title="Synopsis">
|
47
49
|
<a name="cairo-scaled-font.synopsis"></a><h2>Synopsis</h2>
|
48
50
|
<pre class="synopsis">
|
49
51
|
typedef <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a>;
|
50
|
-
<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a
|
52
|
+
<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> * <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()">cairo_scaled_font_create</a> (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face,
|
51
53
|
const <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *font_matrix,
|
52
54
|
const <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *ctm,
|
53
55
|
const <a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
|
54
|
-
<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a
|
56
|
+
<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> * <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-reference" title="cairo_scaled_font_reference ()">cairo_scaled_font_reference</a> (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);
|
55
57
|
void <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-destroy" title="cairo_scaled_font_destroy ()">cairo_scaled_font_destroy</a> (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);
|
56
58
|
<a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-status" title="cairo_scaled_font_status ()">cairo_scaled_font_status</a> (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);
|
57
59
|
<a class="link" href="cairo-scaled-font.html#cairo-font-extents-t" title="cairo_font_extents_t">cairo_font_extents_t</a>;
|
@@ -75,7 +77,7 @@ void <a class="link" href="cairo-scaled-font.html#cairo-scaled-fo
|
|
75
77
|
<a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t">cairo_text_cluster_t</a> **clusters,
|
76
78
|
int *num_clusters,
|
77
79
|
<a class="link" href="cairo-text.html#cairo-text-cluster-flags-t" title="enum cairo_text_cluster_flags_t">cairo_text_cluster_flags_t</a> *cluster_flags);
|
78
|
-
<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a
|
80
|
+
<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> * <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-get-font-face" title="cairo_scaled_font_get_font_face ()">cairo_scaled_font_get_font_face</a> (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);
|
79
81
|
void <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-get-font-options" title="cairo_scaled_font_get_font_options ()">cairo_scaled_font_get_font_options</a> (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
80
82
|
<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
|
81
83
|
void <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-get-font-matrix" title="cairo_scaled_font_get_font_matrix ()">cairo_scaled_font_get_font_matrix</a> (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
@@ -91,20 +93,20 @@ unsigned int <a class="link" href="cairo-scaled-font.html#cairo-scaled-fo
|
|
91
93
|
const <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a> *key,
|
92
94
|
void *user_data,
|
93
95
|
<a class="link" href="cairo-types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()">cairo_destroy_func_t</a> destroy);
|
94
|
-
void*
|
96
|
+
void * <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-get-user-data" title="cairo_scaled_font_get_user_data ()">cairo_scaled_font_get_user_data</a> (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
95
97
|
const <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a> *key);
|
96
98
|
</pre>
|
97
99
|
</div>
|
98
|
-
<div class="refsect1"
|
100
|
+
<div class="refsect1" title="Description">
|
99
101
|
<a name="cairo-scaled-font.description"></a><h2>Description</h2>
|
100
102
|
<p>
|
101
103
|
<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> represents a realization of a font face at a particular
|
102
104
|
size and transformation and a certain set of font options.
|
103
105
|
</p>
|
104
106
|
</div>
|
105
|
-
<div class="refsect1"
|
107
|
+
<div class="refsect1" title="Details">
|
106
108
|
<a name="cairo-scaled-font.details"></a><h2>Details</h2>
|
107
|
-
<div class="refsect2"
|
109
|
+
<div class="refsect2" title="cairo_scaled_font_t">
|
108
110
|
<a name="cairo-scaled-font-t"></a><h3>cairo_scaled_font_t</h3>
|
109
111
|
<pre class="programlisting">typedef struct _cairo_scaled_font cairo_scaled_font_t;
|
110
112
|
</pre>
|
@@ -123,13 +125,12 @@ scaled font can be queried using <a class="link" href="cairo-scaled-font.html#ca
|
|
123
125
|
Memory management of <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> is done with
|
124
126
|
<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-reference" title="cairo_scaled_font_reference ()"><code class="function">cairo_scaled_font_reference()</code></a> and <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-destroy" title="cairo_scaled_font_destroy ()"><code class="function">cairo_scaled_font_destroy()</code></a>.</p>
|
125
127
|
<p>
|
126
|
-
|
127
128
|
</p>
|
128
129
|
</div>
|
129
130
|
<hr>
|
130
|
-
<div class="refsect2"
|
131
|
+
<div class="refsect2" title="cairo_scaled_font_create ()">
|
131
132
|
<a name="cairo-scaled-font-create"></a><h3>cairo_scaled_font_create ()</h3>
|
132
|
-
<pre class="programlisting"><a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a
|
133
|
+
<pre class="programlisting"><a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> * cairo_scaled_font_create (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face,
|
133
134
|
const <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *font_matrix,
|
134
135
|
const <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *ctm,
|
135
136
|
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>
|
@@ -138,7 +139,6 @@ Creates a <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" titl
|
|
138
139
|
describe the size of the font and the environment in which it will
|
139
140
|
be used.</p>
|
140
141
|
<p>
|
141
|
-
|
142
142
|
</p>
|
143
143
|
<div class="variablelist"><table border="0">
|
144
144
|
<col align="left" valign="top">
|
@@ -166,8 +166,7 @@ be used.</p>
|
|
166
166
|
<tr>
|
167
167
|
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
|
168
168
|
<td> options to use when getting metrics for the font and
|
169
|
-
rendering with it.
|
170
|
-
meaning the default options.
|
169
|
+
rendering with it.
|
171
170
|
</td>
|
172
171
|
</tr>
|
173
172
|
<tr>
|
@@ -180,9 +179,9 @@ be used.</p>
|
|
180
179
|
</table></div>
|
181
180
|
</div>
|
182
181
|
<hr>
|
183
|
-
<div class="refsect2"
|
182
|
+
<div class="refsect2" title="cairo_scaled_font_reference ()">
|
184
183
|
<a name="cairo-scaled-font-reference"></a><h3>cairo_scaled_font_reference ()</h3>
|
185
|
-
<pre class="programlisting"><a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a
|
184
|
+
<pre class="programlisting"><a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> * cairo_scaled_font_reference (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);</pre>
|
186
185
|
<p>
|
187
186
|
Increases the reference count on <em class="parameter"><code>scaled_font</code></em> by one. This prevents
|
188
187
|
<em class="parameter"><code>scaled_font</code></em> from being destroyed until a matching call to
|
@@ -192,14 +191,15 @@ Increases the reference count on <em class="parameter"><code>scaled_font</code><
|
|
192
191
|
The number of references to a <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> can be get using
|
193
192
|
<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-get-reference-count" title="cairo_scaled_font_get_reference_count ()"><code class="function">cairo_scaled_font_get_reference_count()</code></a>.</p>
|
194
193
|
<p>
|
195
|
-
|
196
194
|
</p>
|
197
195
|
<div class="variablelist"><table border="0">
|
198
196
|
<col align="left" valign="top">
|
199
197
|
<tbody>
|
200
198
|
<tr>
|
201
199
|
<td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
|
202
|
-
<td> a <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a>, (may be <
|
200
|
+
<td> a <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a>, (may be <a
|
201
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
202
|
+
><code class="literal">NULL</code></a> in which case
|
203
203
|
this function does nothing)
|
204
204
|
</td>
|
205
205
|
</tr>
|
@@ -212,7 +212,7 @@ this function does nothing)
|
|
212
212
|
</table></div>
|
213
213
|
</div>
|
214
214
|
<hr>
|
215
|
-
<div class="refsect2"
|
215
|
+
<div class="refsect2" title="cairo_scaled_font_destroy ()">
|
216
216
|
<a name="cairo-scaled-font-destroy"></a><h3>cairo_scaled_font_destroy ()</h3>
|
217
217
|
<pre class="programlisting">void cairo_scaled_font_destroy (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);</pre>
|
218
218
|
<p>
|
@@ -220,7 +220,6 @@ Decreases the reference count on <em class="parameter"><code>font</code></em> by
|
|
220
220
|
is zero, then <em class="parameter"><code>font</code></em> and all associated resources are freed.
|
221
221
|
See <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-reference" title="cairo_scaled_font_reference ()"><code class="function">cairo_scaled_font_reference()</code></a>.</p>
|
222
222
|
<p>
|
223
|
-
|
224
223
|
</p>
|
225
224
|
<div class="variablelist"><table border="0">
|
226
225
|
<col align="left" valign="top">
|
@@ -232,14 +231,13 @@ See <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-reference" ti
|
|
232
231
|
</table></div>
|
233
232
|
</div>
|
234
233
|
<hr>
|
235
|
-
<div class="refsect2"
|
234
|
+
<div class="refsect2" title="cairo_scaled_font_status ()">
|
236
235
|
<a name="cairo-scaled-font-status"></a><h3>cairo_scaled_font_status ()</h3>
|
237
236
|
<pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_scaled_font_status (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);</pre>
|
238
237
|
<p>
|
239
238
|
Checks whether an error has previously occurred for this
|
240
239
|
scaled_font.</p>
|
241
240
|
<p>
|
242
|
-
|
243
241
|
</p>
|
244
242
|
<div class="variablelist"><table border="0">
|
245
243
|
<col align="left" valign="top">
|
@@ -251,15 +249,15 @@ scaled_font.</p>
|
|
251
249
|
</tr>
|
252
250
|
<tr>
|
253
251
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
254
|
-
<td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS
|
255
|
-
<a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY
|
252
|
+
<td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or another error such as
|
253
|
+
<a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>.
|
256
254
|
</td>
|
257
255
|
</tr>
|
258
256
|
</tbody>
|
259
257
|
</table></div>
|
260
258
|
</div>
|
261
259
|
<hr>
|
262
|
-
<div class="refsect2"
|
260
|
+
<div class="refsect2" title="cairo_font_extents_t">
|
263
261
|
<a name="cairo-font-extents-t"></a><h3>cairo_font_extents_t</h3>
|
264
262
|
<pre class="programlisting">typedef struct {
|
265
263
|
double ascent;
|
@@ -283,7 +281,6 @@ not be doubled. They will change slightly due to hinting (so you
|
|
283
281
|
can't assume that metrics are independent of the transformation
|
284
282
|
matrix), but otherwise will remain unchanged.</p>
|
285
283
|
<p>
|
286
|
-
|
287
284
|
</p>
|
288
285
|
<div class="variablelist"><table border="0">
|
289
286
|
<col align="left" valign="top">
|
@@ -338,14 +335,13 @@ matrix), but otherwise will remain unchanged.</p>
|
|
338
335
|
</table></div>
|
339
336
|
</div>
|
340
337
|
<hr>
|
341
|
-
<div class="refsect2"
|
338
|
+
<div class="refsect2" title="cairo_scaled_font_extents ()">
|
342
339
|
<a name="cairo-scaled-font-extents"></a><h3>cairo_scaled_font_extents ()</h3>
|
343
340
|
<pre class="programlisting">void cairo_scaled_font_extents (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
344
341
|
<a class="link" href="cairo-scaled-font.html#cairo-font-extents-t" title="cairo_font_extents_t">cairo_font_extents_t</a> *extents);</pre>
|
345
342
|
<p>
|
346
343
|
Gets the metrics for a <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a>.</p>
|
347
344
|
<p>
|
348
|
-
|
349
345
|
</p>
|
350
346
|
<div class="variablelist"><table border="0">
|
351
347
|
<col align="left" valign="top">
|
@@ -364,7 +360,7 @@ Gets the metrics for a <a class="link" href="cairo-scaled-font.html#cairo-scaled
|
|
364
360
|
</table></div>
|
365
361
|
</div>
|
366
362
|
<hr>
|
367
|
-
<div class="refsect2"
|
363
|
+
<div class="refsect2" title="cairo_text_extents_t">
|
368
364
|
<a name="cairo-text-extents-t"></a><h3>cairo_text_extents_t</h3>
|
369
365
|
<pre class="programlisting">typedef struct {
|
370
366
|
double x_bearing;
|
@@ -386,7 +382,6 @@ doubled. They will change slightly due to hinting (so you can't
|
|
386
382
|
assume that metrics are independent of the transformation matrix),
|
387
383
|
but otherwise will remain unchanged.</p>
|
388
384
|
<p>
|
389
|
-
|
390
385
|
</p>
|
391
386
|
<div class="variablelist"><table border="0">
|
392
387
|
<col align="left" valign="top">
|
@@ -433,7 +428,7 @@ but otherwise will remain unchanged.</p>
|
|
433
428
|
</table></div>
|
434
429
|
</div>
|
435
430
|
<hr>
|
436
|
-
<div class="refsect2"
|
431
|
+
<div class="refsect2" title="cairo_scaled_font_text_extents ()">
|
437
432
|
<a name="cairo-scaled-font-text-extents"></a><h3>cairo_scaled_font_text_extents ()</h3>
|
438
433
|
<pre class="programlisting">void cairo_scaled_font_text_extents (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
439
434
|
const char *utf8,
|
@@ -455,7 +450,6 @@ characters. In particular, trailing whitespace characters are
|
|
455
450
|
likely to not affect the size of the rectangle, though they will
|
456
451
|
affect the x_advance and y_advance values.</p>
|
457
452
|
<p>
|
458
|
-
|
459
453
|
</p>
|
460
454
|
<div class="variablelist"><table border="0">
|
461
455
|
<col align="left" valign="top">
|
@@ -477,11 +471,10 @@ affect the x_advance and y_advance values.</p>
|
|
477
471
|
</tr>
|
478
472
|
</tbody>
|
479
473
|
</table></div>
|
480
|
-
<p class="since">Since
|
481
|
-
</p>
|
474
|
+
<p class="since">Since 1.2</p>
|
482
475
|
</div>
|
483
476
|
<hr>
|
484
|
-
<div class="refsect2"
|
477
|
+
<div class="refsect2" title="cairo_scaled_font_glyph_extents ()">
|
485
478
|
<a name="cairo-scaled-font-glyph-extents"></a><h3>cairo_scaled_font_glyph_extents ()</h3>
|
486
479
|
<pre class="programlisting">void cairo_scaled_font_glyph_extents (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
487
480
|
const <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> *glyphs,
|
@@ -500,7 +493,6 @@ would be advanced by <a class="link" href="cairo-text.html#cairo-show-glyphs" ti
|
|
500
493
|
Note that whitespace glyphs do not contribute to the size of the
|
501
494
|
rectangle (extents.width and extents.height).</p>
|
502
495
|
<p>
|
503
|
-
|
504
496
|
</p>
|
505
497
|
<div class="variablelist"><table border="0">
|
506
498
|
<col align="left" valign="top">
|
@@ -529,7 +521,7 @@ rectangle (extents.width and extents.height).</p>
|
|
529
521
|
</table></div>
|
530
522
|
</div>
|
531
523
|
<hr>
|
532
|
-
<div class="refsect2"
|
524
|
+
<div class="refsect2" title="cairo_scaled_font_text_to_glyphs ()">
|
533
525
|
<a name="cairo-scaled-font-text-to-glyphs"></a><h3>cairo_scaled_font_text_to_glyphs ()</h3>
|
534
526
|
<pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_scaled_font_text_to_glyphs (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
535
527
|
double x,
|
@@ -546,31 +538,43 @@ Converts UTF-8 text to an array of glyphs, optionally with cluster
|
|
546
538
|
mapping, that can be used to render later using <em class="parameter"><code>scaled_font</code></em>.
|
547
539
|
</p>
|
548
540
|
<p>
|
549
|
-
If <em class="parameter"><code>glyphs</code></em> initially points to a non-<
|
541
|
+
If <em class="parameter"><code>glyphs</code></em> initially points to a non-<a
|
542
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
543
|
+
><code class="literal">NULL</code></a> value, that array is used
|
550
544
|
as a glyph buffer, and <em class="parameter"><code>num_glyphs</code></em> should point to the number of glyph
|
551
545
|
entries available there. If the provided glyph array is too short for
|
552
546
|
the conversion, a new glyph array is allocated using <a class="link" href="cairo-text.html#cairo-glyph-allocate" title="cairo_glyph_allocate ()"><code class="function">cairo_glyph_allocate()</code></a>
|
553
547
|
and placed in <em class="parameter"><code>glyphs</code></em>. Upon return, <em class="parameter"><code>num_glyphs</code></em> always contains the
|
554
|
-
number of generated glyphs. If the value <em class="parameter"><code>glyphs</code></em> points
|
548
|
+
number of generated glyphs. If the value <em class="parameter"><code>glyphs</code></em> points to has changed
|
555
549
|
after the call, the user is responsible for freeing the allocated glyph
|
556
|
-
array using <a class="link" href="cairo-text.html#cairo-glyph-free" title="cairo_glyph_free ()"><code class="function">cairo_glyph_free()</code></a>.
|
550
|
+
array using <a class="link" href="cairo-text.html#cairo-glyph-free" title="cairo_glyph_free ()"><code class="function">cairo_glyph_free()</code></a>. This may happen even if the provided
|
551
|
+
array was large enough.
|
557
552
|
</p>
|
558
553
|
<p>
|
559
|
-
If <em class="parameter"><code>clusters</code></em> is not <
|
554
|
+
If <em class="parameter"><code>clusters</code></em> is not <a
|
555
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
556
|
+
><code class="literal">NULL</code></a>, <em class="parameter"><code>num_clusters</code></em> and <em class="parameter"><code>cluster_flags</code></em> should not be <a
|
557
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
558
|
+
><code class="literal">NULL</code></a>,
|
560
559
|
and cluster mapping will be computed.
|
561
560
|
The semantics of how cluster array allocation works is similar to the glyph
|
562
561
|
array. That is,
|
563
|
-
if <em class="parameter"><code>clusters</code></em> initially points to a non-<
|
562
|
+
if <em class="parameter"><code>clusters</code></em> initially points to a non-<a
|
563
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
564
|
+
><code class="literal">NULL</code></a> value, that array is used
|
564
565
|
as a cluster buffer, and <em class="parameter"><code>num_clusters</code></em> should point to the number of cluster
|
565
566
|
entries available there. If the provided cluster array is too short for
|
566
567
|
the conversion, a new cluster array is allocated using <a class="link" href="cairo-text.html#cairo-text-cluster-allocate" title="cairo_text_cluster_allocate ()"><code class="function">cairo_text_cluster_allocate()</code></a>
|
567
568
|
and placed in <em class="parameter"><code>clusters</code></em>. Upon return, <em class="parameter"><code>num_clusters</code></em> always contains the
|
568
569
|
number of generated clusters. If the value <em class="parameter"><code>clusters</code></em> points at has changed
|
569
570
|
after the call, the user is responsible for freeing the allocated cluster
|
570
|
-
array using <a class="link" href="cairo-text.html#cairo-text-cluster-free" title="cairo_text_cluster_free ()"><code class="function">cairo_text_cluster_free()</code></a>.
|
571
|
+
array using <a class="link" href="cairo-text.html#cairo-text-cluster-free" title="cairo_text_cluster_free ()"><code class="function">cairo_text_cluster_free()</code></a>. This may happen even if the provided
|
572
|
+
array was large enough.
|
571
573
|
</p>
|
572
574
|
<p>
|
573
|
-
In the simplest case, <em class="parameter"><code>glyphs</code></em> and <em class="parameter"><code>clusters</code></em> can point to <
|
575
|
+
In the simplest case, <em class="parameter"><code>glyphs</code></em> and <em class="parameter"><code>clusters</code></em> can point to <a
|
576
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
577
|
+
><code class="literal">NULL</code></a> initially
|
574
578
|
and a suitable array will be allocated. In code:
|
575
579
|
</p>
|
576
580
|
<div class="informalexample"><pre class="programlisting">
|
@@ -667,7 +671,6 @@ The output values can be readily passed to <a class="link" href="cairo-text.html
|
|
667
671
|
<a class="link" href="cairo-text.html#cairo-show-glyphs" title="cairo_show_glyphs ()"><code class="function">cairo_show_glyphs()</code></a>, or related functions, assuming that the exact
|
668
672
|
same <em class="parameter"><code>scaled_font</code></em> is used for the operation.</p>
|
669
673
|
<p>
|
670
|
-
|
671
674
|
</p>
|
672
675
|
<div class="variablelist"><table border="0">
|
673
676
|
<col align="left" valign="top">
|
@@ -709,23 +712,29 @@ same <em class="parameter"><code>scaled_font</code></em> is used for the operati
|
|
709
712
|
</tr>
|
710
713
|
<tr>
|
711
714
|
<td><p><span class="term"><em class="parameter"><code>clusters</code></em> :</span></p></td>
|
712
|
-
<td> pointer to array of cluster mapping information to fill, or <
|
715
|
+
<td> pointer to array of cluster mapping information to fill, or <a
|
716
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
717
|
+
><code class="literal">NULL</code></a>
|
713
718
|
</td>
|
714
719
|
</tr>
|
715
720
|
<tr>
|
716
721
|
<td><p><span class="term"><em class="parameter"><code>num_clusters</code></em> :</span></p></td>
|
717
|
-
<td> pointer to number of clusters, or <
|
722
|
+
<td> pointer to number of clusters, or <a
|
723
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
724
|
+
><code class="literal">NULL</code></a>
|
718
725
|
</td>
|
719
726
|
</tr>
|
720
727
|
<tr>
|
721
728
|
<td><p><span class="term"><em class="parameter"><code>cluster_flags</code></em> :</span></p></td>
|
722
729
|
<td> pointer to location to store cluster flags corresponding to the
|
723
|
-
output <em class="parameter"><code>clusters</code></em>, or <
|
730
|
+
output <em class="parameter"><code>clusters</code></em>, or <a
|
731
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
732
|
+
><code class="literal">NULL</code></a>
|
724
733
|
</td>
|
725
734
|
</tr>
|
726
735
|
<tr>
|
727
736
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
728
|
-
<td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS
|
737
|
+
<td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> upon success, or an error status
|
729
738
|
if the input values are wrong or if conversion failed. If the input
|
730
739
|
values are correct but the conversion failed, the error status is also
|
731
740
|
set on <em class="parameter"><code>scaled_font</code></em>.
|
@@ -734,17 +743,15 @@ set on <em class="parameter"><code>scaled_font</code></em>.
|
|
734
743
|
</tr>
|
735
744
|
</tbody>
|
736
745
|
</table></div>
|
737
|
-
<p class="since">Since
|
738
|
-
</p>
|
746
|
+
<p class="since">Since 1.8</p>
|
739
747
|
</div>
|
740
748
|
<hr>
|
741
|
-
<div class="refsect2"
|
749
|
+
<div class="refsect2" title="cairo_scaled_font_get_font_face ()">
|
742
750
|
<a name="cairo-scaled-font-get-font-face"></a><h3>cairo_scaled_font_get_font_face ()</h3>
|
743
|
-
<pre class="programlisting"><a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a
|
751
|
+
<pre class="programlisting"><a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> * cairo_scaled_font_get_font_face (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);</pre>
|
744
752
|
<p>
|
745
753
|
Gets the font face that this scaled font was created for.</p>
|
746
754
|
<p>
|
747
|
-
|
748
755
|
</p>
|
749
756
|
<div class="variablelist"><table border="0">
|
750
757
|
<col align="left" valign="top">
|
@@ -763,11 +770,10 @@ created.
|
|
763
770
|
</tr>
|
764
771
|
</tbody>
|
765
772
|
</table></div>
|
766
|
-
<p class="since">Since
|
767
|
-
</p>
|
773
|
+
<p class="since">Since 1.2</p>
|
768
774
|
</div>
|
769
775
|
<hr>
|
770
|
-
<div class="refsect2"
|
776
|
+
<div class="refsect2" title="cairo_scaled_font_get_font_options ()">
|
771
777
|
<a name="cairo-scaled-font-get-font-options"></a><h3>cairo_scaled_font_get_font_options ()</h3>
|
772
778
|
<pre class="programlisting">void cairo_scaled_font_get_font_options (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
773
779
|
<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
|
@@ -775,7 +781,6 @@ created.
|
|
775
781
|
Stores the font options with which <em class="parameter"><code>scaled_font</code></em> was created into
|
776
782
|
<em class="parameter"><code>options</code></em>.</p>
|
777
783
|
<p>
|
778
|
-
|
779
784
|
</p>
|
780
785
|
<div class="variablelist"><table border="0">
|
781
786
|
<col align="left" valign="top">
|
@@ -792,11 +797,10 @@ Stores the font options with which <em class="parameter"><code>scaled_font</code
|
|
792
797
|
</tr>
|
793
798
|
</tbody>
|
794
799
|
</table></div>
|
795
|
-
<p class="since">Since
|
796
|
-
</p>
|
800
|
+
<p class="since">Since 1.2</p>
|
797
801
|
</div>
|
798
802
|
<hr>
|
799
|
-
<div class="refsect2"
|
803
|
+
<div class="refsect2" title="cairo_scaled_font_get_font_matrix ()">
|
800
804
|
<a name="cairo-scaled-font-get-font-matrix"></a><h3>cairo_scaled_font_get_font_matrix ()</h3>
|
801
805
|
<pre class="programlisting">void cairo_scaled_font_get_font_matrix (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
802
806
|
<a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *font_matrix);</pre>
|
@@ -804,7 +808,6 @@ Stores the font options with which <em class="parameter"><code>scaled_font</code
|
|
804
808
|
Stores the font matrix with which <em class="parameter"><code>scaled_font</code></em> was created into
|
805
809
|
<em class="parameter"><code>matrix</code></em>.</p>
|
806
810
|
<p>
|
807
|
-
|
808
811
|
</p>
|
809
812
|
<div class="variablelist"><table border="0">
|
810
813
|
<col align="left" valign="top">
|
@@ -821,18 +824,16 @@ Stores the font matrix with which <em class="parameter"><code>scaled_font</code>
|
|
821
824
|
</tr>
|
822
825
|
</tbody>
|
823
826
|
</table></div>
|
824
|
-
<p class="since">Since
|
825
|
-
</p>
|
827
|
+
<p class="since">Since 1.2</p>
|
826
828
|
</div>
|
827
829
|
<hr>
|
828
|
-
<div class="refsect2"
|
830
|
+
<div class="refsect2" title="cairo_scaled_font_get_ctm ()">
|
829
831
|
<a name="cairo-scaled-font-get-ctm"></a><h3>cairo_scaled_font_get_ctm ()</h3>
|
830
832
|
<pre class="programlisting">void cairo_scaled_font_get_ctm (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
831
833
|
<a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *ctm);</pre>
|
832
834
|
<p>
|
833
835
|
Stores the CTM with which <em class="parameter"><code>scaled_font</code></em> was created into <em class="parameter"><code>ctm</code></em>.</p>
|
834
836
|
<p>
|
835
|
-
|
836
837
|
</p>
|
837
838
|
<div class="variablelist"><table border="0">
|
838
839
|
<col align="left" valign="top">
|
@@ -849,11 +850,10 @@ Stores the CTM with which <em class="parameter"><code>scaled_font</code></em> wa
|
|
849
850
|
</tr>
|
850
851
|
</tbody>
|
851
852
|
</table></div>
|
852
|
-
<p class="since">Since
|
853
|
-
</p>
|
853
|
+
<p class="since">Since 1.2</p>
|
854
854
|
</div>
|
855
855
|
<hr>
|
856
|
-
<div class="refsect2"
|
856
|
+
<div class="refsect2" title="cairo_scaled_font_get_scale_matrix ()">
|
857
857
|
<a name="cairo-scaled-font-get-scale-matrix"></a><h3>cairo_scaled_font_get_scale_matrix ()</h3>
|
858
858
|
<pre class="programlisting">void cairo_scaled_font_get_scale_matrix (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
859
859
|
<a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *scale_matrix);</pre>
|
@@ -863,7 +863,6 @@ The scale matrix is product of the font matrix and the ctm
|
|
863
863
|
associated with the scaled font, and hence is the matrix mapping from
|
864
864
|
font space to device space.</p>
|
865
865
|
<p>
|
866
|
-
|
867
866
|
</p>
|
868
867
|
<div class="variablelist"><table border="0">
|
869
868
|
<col align="left" valign="top">
|
@@ -880,18 +879,16 @@ font space to device space.</p>
|
|
880
879
|
</tr>
|
881
880
|
</tbody>
|
882
881
|
</table></div>
|
883
|
-
<p class="since">Since
|
884
|
-
</p>
|
882
|
+
<p class="since">Since 1.8</p>
|
885
883
|
</div>
|
886
884
|
<hr>
|
887
|
-
<div class="refsect2"
|
885
|
+
<div class="refsect2" title="cairo_scaled_font_get_type ()">
|
888
886
|
<a name="cairo-scaled-font-get-type"></a><h3>cairo_scaled_font_get_type ()</h3>
|
889
887
|
<pre class="programlisting"><a class="link" href="cairo-font-face.html#cairo-font-type-t" title="enum cairo_font_type_t">cairo_font_type_t</a> cairo_scaled_font_get_type (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);</pre>
|
890
888
|
<p>
|
891
889
|
This function returns the type of the backend used to create
|
892
890
|
a scaled font. See <a class="link" href="cairo-font-face.html#cairo-font-type-t" title="enum cairo_font_type_t"><span class="type">cairo_font_type_t</span></a> for available types.</p>
|
893
891
|
<p>
|
894
|
-
|
895
892
|
</p>
|
896
893
|
<div class="variablelist"><table border="0">
|
897
894
|
<col align="left" valign="top">
|
@@ -909,18 +906,16 @@ a scaled font. See <a class="link" href="cairo-font-face.html#cairo-font-type-t"
|
|
909
906
|
</tr>
|
910
907
|
</tbody>
|
911
908
|
</table></div>
|
912
|
-
<p class="since">Since
|
913
|
-
</p>
|
909
|
+
<p class="since">Since 1.2</p>
|
914
910
|
</div>
|
915
911
|
<hr>
|
916
|
-
<div class="refsect2"
|
912
|
+
<div class="refsect2" title="cairo_scaled_font_get_reference_count ()">
|
917
913
|
<a name="cairo-scaled-font-get-reference-count"></a><h3>cairo_scaled_font_get_reference_count ()</h3>
|
918
914
|
<pre class="programlisting">unsigned int cairo_scaled_font_get_reference_count
|
919
915
|
(<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);</pre>
|
920
916
|
<p>
|
921
917
|
Returns the current reference count of <em class="parameter"><code>scaled_font</code></em>.</p>
|
922
918
|
<p>
|
923
|
-
|
924
919
|
</p>
|
925
920
|
<div class="variablelist"><table border="0">
|
926
921
|
<col align="left" valign="top">
|
@@ -939,11 +934,10 @@ object is a nil object, 0 will be returned.
|
|
939
934
|
</tr>
|
940
935
|
</tbody>
|
941
936
|
</table></div>
|
942
|
-
<p class="since">Since
|
943
|
-
</p>
|
937
|
+
<p class="since">Since 1.4</p>
|
944
938
|
</div>
|
945
939
|
<hr>
|
946
|
-
<div class="refsect2"
|
940
|
+
<div class="refsect2" title="cairo_scaled_font_set_user_data ()">
|
947
941
|
<a name="cairo-scaled-font-set-user-data"></a><h3>cairo_scaled_font_set_user_data ()</h3>
|
948
942
|
<pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_scaled_font_set_user_data (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
949
943
|
const <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a> *key,
|
@@ -951,10 +945,11 @@ object is a nil object, 0 will be returned.
|
|
951
945
|
<a class="link" href="cairo-types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()">cairo_destroy_func_t</a> destroy);</pre>
|
952
946
|
<p>
|
953
947
|
Attach user data to <em class="parameter"><code>scaled_font</code></em>. To remove user data from a surface,
|
954
|
-
call this function with the key that was used to set it and <
|
948
|
+
call this function with the key that was used to set it and <a
|
949
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
950
|
+
><code class="literal">NULL</code></a>
|
955
951
|
for <em class="parameter"><code>data</code></em>.</p>
|
956
952
|
<p>
|
957
|
-
|
958
953
|
</p>
|
959
954
|
<div class="variablelist"><table border="0">
|
960
955
|
<col align="left" valign="top">
|
@@ -983,27 +978,27 @@ same key.
|
|
983
978
|
</tr>
|
984
979
|
<tr>
|
985
980
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
986
|
-
<td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS
|
981
|
+
<td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> if a
|
987
982
|
slot could not be allocated for the user data.
|
988
983
|
|
989
984
|
</td>
|
990
985
|
</tr>
|
991
986
|
</tbody>
|
992
987
|
</table></div>
|
993
|
-
<p class="since">Since
|
994
|
-
</p>
|
988
|
+
<p class="since">Since 1.4</p>
|
995
989
|
</div>
|
996
990
|
<hr>
|
997
|
-
<div class="refsect2"
|
991
|
+
<div class="refsect2" title="cairo_scaled_font_get_user_data ()">
|
998
992
|
<a name="cairo-scaled-font-get-user-data"></a><h3>cairo_scaled_font_get_user_data ()</h3>
|
999
|
-
<pre class="programlisting">void*
|
993
|
+
<pre class="programlisting">void * cairo_scaled_font_get_user_data (<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font,
|
1000
994
|
const <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a> *key);</pre>
|
1001
995
|
<p>
|
1002
996
|
Return user data previously attached to <em class="parameter"><code>scaled_font</code></em> using the
|
1003
997
|
specified key. If no user data has been attached with the given
|
1004
|
-
key this function returns <
|
998
|
+
key this function returns <a
|
999
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
1000
|
+
><code class="literal">NULL</code></a>.</p>
|
1005
1001
|
<p>
|
1006
|
-
|
1007
1002
|
</p>
|
1008
1003
|
<div class="variablelist"><table border="0">
|
1009
1004
|
<col align="left" valign="top">
|
@@ -1021,24 +1016,25 @@ attached to
|
|
1021
1016
|
</tr>
|
1022
1017
|
<tr>
|
1023
1018
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1024
|
-
<td> the user data previously attached or <
|
1019
|
+
<td> the user data previously attached or <a
|
1020
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
1021
|
+
><code class="literal">NULL</code></a>.
|
1025
1022
|
|
1026
1023
|
</td>
|
1027
1024
|
</tr>
|
1028
1025
|
</tbody>
|
1029
1026
|
</table></div>
|
1030
|
-
<p class="since">Since
|
1031
|
-
</p>
|
1027
|
+
<p class="since">Since 1.4</p>
|
1032
1028
|
</div>
|
1033
1029
|
</div>
|
1034
|
-
<div class="refsect1"
|
1030
|
+
<div class="refsect1" title="See Also">
|
1035
1031
|
<a name="cairo-scaled-font.see-also"></a><h2>See Also</h2>
|
1036
1032
|
<p>
|
1037
1033
|
</p>
|
1038
|
-
<div class="itemizedlist"><ul type="disc">
|
1039
|
-
<li><a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a></li>
|
1040
|
-
<li><a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t"><span class="type">cairo_matrix_t</span></a></li>
|
1041
|
-
<li><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></li>
|
1034
|
+
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
|
1035
|
+
<li class="listitem"><a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a></li>
|
1036
|
+
<li class="listitem"><a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t"><span class="type">cairo_matrix_t</span></a></li>
|
1037
|
+
<li class="listitem"><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></li>
|
1042
1038
|
</ul></div>
|
1043
1039
|
<p>
|
1044
1040
|
</p>
|
@@ -1046,6 +1042,6 @@ attached to
|
|
1046
1042
|
</div>
|
1047
1043
|
<div class="footer">
|
1048
1044
|
<hr>
|
1049
|
-
Generated by GTK-Doc V1.
|
1045
|
+
Generated by GTK-Doc V1.11</div>
|
1050
1046
|
</body>
|
1051
1047
|
</html>
|