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>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="index.html" title="Cairo: A Vector Graphics Library">
|
9
9
|
<link rel="prev" href="cairo-user-font.html" title="User Fonts">
|
10
10
|
<link rel="next" href="cairo-surface.html" title="cairo_surface_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">
|
@@ -29,7 +29,7 @@
|
|
29
29
|
<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
|
30
30
|
<td><a accesskey="n" href="cairo-surface.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
31
31
|
</tr></table>
|
32
|
-
<div class="chapter"
|
32
|
+
<div class="chapter" title="Surfaces">
|
33
33
|
<div class="titlepage"><div><div><h2 class="title">
|
34
34
|
<a name="cairo-surfaces"></a>Surfaces</h2></div></div></div>
|
35
35
|
<div class="toc"><dl>
|
@@ -64,6 +64,6 @@
|
|
64
64
|
</div>
|
65
65
|
<div class="footer">
|
66
66
|
<hr>
|
67
|
-
Generated by GTK-Doc V1.
|
67
|
+
Generated by GTK-Doc V1.11</div>
|
68
68
|
</body>
|
69
69
|
</html>
|
@@ -3,12 +3,12 @@
|
|
3
3
|
<head>
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
5
|
<title>SVG 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-win32-surface.html" title="Win32 Surfaces">
|
10
10
|
<link rel="next" href="cairo-quartz-surface.html" title="Quartz 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-quartz-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-svg-surface.synopsis" class="shortcut">Top</a>
|
35
|
+
|
|
36
|
+
<a href="#cairo-svg-surface.description" class="shortcut">Description</a>
|
37
|
+
</td></tr>
|
36
38
|
</table>
|
37
|
-
<div class="refentry"
|
39
|
+
<div class="refentry" title="SVG Surfaces">
|
38
40
|
<a name="cairo-svg-surface"></a><div class="titlepage"></div>
|
39
41
|
<div class="refnamediv"><table width="100%"><tr>
|
40
42
|
<td valign="top">
|
@@ -43,14 +45,14 @@
|
|
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-svg-surface.synopsis"></a><h2>Synopsis</h2>
|
48
50
|
<pre class="synopsis">
|
49
|
-
#define <a class="link" href="cairo-svg-surface.html#CAIRO-HAS-SVG-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-svg-surface.html#CAIRO-HAS-SVG-SURFACE--CAPS" title="CAIRO_HAS_SVG_SURFACE">CAIRO_HAS_SVG_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-svg-surface.html#cairo-svg-surface-create" title="cairo_svg_surface_create ()">cairo_svg_surface_create</a> (const char *filename,
|
51
53
|
double width_in_points,
|
52
54
|
double height_in_points);
|
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-svg-surface.html#cairo-svg-surface-create-for-stream" title="cairo_svg_surface_create_for_stream ()">cairo_svg_surface_create_for_stream</a> (<a class="link" href="cairo-png-functions.html#cairo-write-func-t" title="cairo_write_func_t ()">cairo_write_func_t</a> write_func,
|
54
56
|
void *closure,
|
55
57
|
double width_in_points,
|
56
58
|
double height_in_points);
|
@@ -60,20 +62,20 @@ void <a class="link" href="cairo-svg-surface.html#cairo-svg-surfa
|
|
60
62
|
enum <a class="link" href="cairo-svg-surface.html#cairo-svg-version-t" title="enum cairo_svg_version_t">cairo_svg_version_t</a>;
|
61
63
|
void <a class="link" href="cairo-svg-surface.html#cairo-svg-get-versions" title="cairo_svg_get_versions ()">cairo_svg_get_versions</a> (<a class="link" href="cairo-svg-surface.html#cairo-svg-version-t" title="enum cairo_svg_version_t">cairo_svg_version_t</a> const **versions,
|
62
64
|
int *num_versions);
|
63
|
-
const char*
|
65
|
+
const char * <a class="link" href="cairo-svg-surface.html#cairo-svg-version-to-string" title="cairo_svg_version_to_string ()">cairo_svg_version_to_string</a> (<a class="link" href="cairo-svg-surface.html#cairo-svg-version-t" title="enum cairo_svg_version_t">cairo_svg_version_t</a> version);
|
64
66
|
</pre>
|
65
67
|
</div>
|
66
|
-
<div class="refsect1"
|
68
|
+
<div class="refsect1" title="Description">
|
67
69
|
<a name="cairo-svg-surface.description"></a><h2>Description</h2>
|
68
70
|
<p>
|
69
71
|
The SVG surface is used to render cairo graphics to
|
70
72
|
SVG files and is a multi-page vector surface backend.
|
71
73
|
</p>
|
72
74
|
</div>
|
73
|
-
<div class="refsect1"
|
75
|
+
<div class="refsect1" title="Details">
|
74
76
|
<a name="cairo-svg-surface.details"></a><h2>Details</h2>
|
75
|
-
<div class="refsect2"
|
76
|
-
<a name="CAIRO-HAS-SVG-SURFACE
|
77
|
+
<div class="refsect2" title="CAIRO_HAS_SVG_SURFACE">
|
78
|
+
<a name="CAIRO-HAS-SVG-SURFACE--CAPS"></a><h3>CAIRO_HAS_SVG_SURFACE</h3>
|
77
79
|
<pre class="programlisting">#define CAIRO_HAS_SVG_SURFACE 1
|
78
80
|
</pre>
|
79
81
|
<p>
|
@@ -82,23 +84,27 @@ This macro can be used to conditionally compile backend-specific code.
|
|
82
84
|
</p>
|
83
85
|
</div>
|
84
86
|
<hr>
|
85
|
-
<div class="refsect2"
|
87
|
+
<div class="refsect2" title="cairo_svg_surface_create ()">
|
86
88
|
<a name="cairo-svg-surface-create"></a><h3>cairo_svg_surface_create ()</h3>
|
87
|
-
<pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a
|
89
|
+
<pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * cairo_svg_surface_create (const char *filename,
|
88
90
|
double width_in_points,
|
89
91
|
double height_in_points);</pre>
|
90
92
|
<p>
|
91
93
|
Creates a SVG surface of the specified size in points to be written
|
92
94
|
to <em class="parameter"><code>filename</code></em>.</p>
|
93
95
|
<p>
|
94
|
-
|
95
96
|
</p>
|
96
97
|
<div class="variablelist"><table border="0">
|
97
98
|
<col align="left" valign="top">
|
98
99
|
<tbody>
|
99
100
|
<tr>
|
100
101
|
<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
|
101
|
-
<td> a filename for the SVG output (must be writable)
|
102
|
+
<td> a filename for the SVG output (must be writable), <a
|
103
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
104
|
+
><code class="literal">NULL</code></a> may be
|
105
|
+
used to specify no output. This will generate a SVG surface that
|
106
|
+
may be queried and used as a source, without generating a
|
107
|
+
temporary file.
|
102
108
|
</td>
|
103
109
|
</tr>
|
104
110
|
<tr>
|
@@ -125,13 +131,12 @@ occurs. You can use <a class="link" href="cairo-surface.html#cairo-surface-statu
|
|
125
131
|
</tr>
|
126
132
|
</tbody>
|
127
133
|
</table></div>
|
128
|
-
<p class="since">Since
|
129
|
-
</p>
|
134
|
+
<p class="since">Since 1.2</p>
|
130
135
|
</div>
|
131
136
|
<hr>
|
132
|
-
<div class="refsect2"
|
137
|
+
<div class="refsect2" title="cairo_svg_surface_create_for_stream ()">
|
133
138
|
<a name="cairo-svg-surface-create-for-stream"></a><h3>cairo_svg_surface_create_for_stream ()</h3>
|
134
|
-
<pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a
|
139
|
+
<pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * cairo_svg_surface_create_for_stream (<a class="link" href="cairo-png-functions.html#cairo-write-func-t" title="cairo_write_func_t ()">cairo_write_func_t</a> write_func,
|
135
140
|
void *closure,
|
136
141
|
double width_in_points,
|
137
142
|
double height_in_points);</pre>
|
@@ -139,14 +144,18 @@ occurs. You can use <a class="link" href="cairo-surface.html#cairo-surface-statu
|
|
139
144
|
Creates a SVG surface of the specified size in points to be written
|
140
145
|
incrementally to the stream represented by <em class="parameter"><code>write_func</code></em> and <em class="parameter"><code>closure</code></em>.</p>
|
141
146
|
<p>
|
142
|
-
|
143
147
|
</p>
|
144
148
|
<div class="variablelist"><table border="0">
|
145
149
|
<col align="left" valign="top">
|
146
150
|
<tbody>
|
147
151
|
<tr>
|
148
152
|
<td><p><span class="term"><em class="parameter"><code>write_func</code></em> :</span></p></td>
|
149
|
-
<td> a <a class="link" href="cairo-png-functions.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> to accept the output data
|
153
|
+
<td> a <a class="link" href="cairo-png-functions.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> to accept the output data, may be <a
|
154
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
155
|
+
><code class="literal">NULL</code></a>
|
156
|
+
to indicate a no-op <em class="parameter"><code>write_func</code></em>. With a no-op <em class="parameter"><code>write_func</code></em>,
|
157
|
+
the surface may be queried or used as a source without
|
158
|
+
generating any temporary files.
|
150
159
|
</td>
|
151
160
|
</tr>
|
152
161
|
<tr>
|
@@ -178,11 +187,10 @@ occurs. You can use <a class="link" href="cairo-surface.html#cairo-surface-statu
|
|
178
187
|
</tr>
|
179
188
|
</tbody>
|
180
189
|
</table></div>
|
181
|
-
<p class="since">Since
|
182
|
-
</p>
|
190
|
+
<p class="since">Since 1.2</p>
|
183
191
|
</div>
|
184
192
|
<hr>
|
185
|
-
<div class="refsect2"
|
193
|
+
<div class="refsect2" title="cairo_svg_surface_restrict_to_version ()">
|
186
194
|
<a name="cairo-svg-surface-restrict-to-version"></a><h3>cairo_svg_surface_restrict_to_version ()</h3>
|
187
195
|
<pre class="programlisting">void cairo_svg_surface_restrict_to_version
|
188
196
|
(<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
|
@@ -197,7 +205,6 @@ have been performed on the given surface. The simplest way to do
|
|
197
205
|
this is to call this function immediately after creating the
|
198
206
|
surface.</p>
|
199
207
|
<p>
|
200
|
-
|
201
208
|
</p>
|
202
209
|
<div class="variablelist"><table border="0">
|
203
210
|
<col align="left" valign="top">
|
@@ -214,11 +221,10 @@ surface.</p>
|
|
214
221
|
</tr>
|
215
222
|
</tbody>
|
216
223
|
</table></div>
|
217
|
-
<p class="since">Since
|
218
|
-
</p>
|
224
|
+
<p class="since">Since 1.2</p>
|
219
225
|
</div>
|
220
226
|
<hr>
|
221
|
-
<div class="refsect2"
|
227
|
+
<div class="refsect2" title="enum cairo_svg_version_t">
|
222
228
|
<a name="cairo-svg-version-t"></a><h3>enum cairo_svg_version_t</h3>
|
223
229
|
<pre class="programlisting">typedef enum _cairo_svg_version {
|
224
230
|
CAIRO_SVG_VERSION_1_1,
|
@@ -229,18 +235,17 @@ surface.</p>
|
|
229
235
|
<a class="link" href="cairo-svg-surface.html#cairo-svg-version-t" title="enum cairo_svg_version_t"><span class="type">cairo_svg_version_t</span></a> is used to describe the version number of the SVG
|
230
236
|
specification that a generated SVG file will conform to.</p>
|
231
237
|
<p>
|
232
|
-
|
233
238
|
</p>
|
234
239
|
<div class="variablelist"><table border="0">
|
235
240
|
<col align="left" valign="top">
|
236
241
|
<tbody>
|
237
242
|
<tr>
|
238
|
-
<td><p><a name="CAIRO-SVG-VERSION-1-1
|
243
|
+
<td><p><a name="CAIRO-SVG-VERSION-1-1--CAPS"></a><span class="term"><code class="literal">CAIRO_SVG_VERSION_1_1</code></span></p></td>
|
239
244
|
<td> The version 1.1 of the SVG specification.
|
240
245
|
</td>
|
241
246
|
</tr>
|
242
247
|
<tr>
|
243
|
-
<td><p><a name="CAIRO-SVG-VERSION-1-2
|
248
|
+
<td><p><a name="CAIRO-SVG-VERSION-1-2--CAPS"></a><span class="term"><code class="literal">CAIRO_SVG_VERSION_1_2</code></span></p></td>
|
244
249
|
<td> The version 1.2 of the SVG specification.
|
245
250
|
</td>
|
246
251
|
</tr>
|
@@ -248,7 +253,7 @@ specification that a generated SVG file will conform to.</p>
|
|
248
253
|
</table></div>
|
249
254
|
</div>
|
250
255
|
<hr>
|
251
|
-
<div class="refsect2"
|
256
|
+
<div class="refsect2" title="cairo_svg_get_versions ()">
|
252
257
|
<a name="cairo-svg-get-versions"></a><h3>cairo_svg_get_versions ()</h3>
|
253
258
|
<pre class="programlisting">void cairo_svg_get_versions (<a class="link" href="cairo-svg-surface.html#cairo-svg-version-t" title="enum cairo_svg_version_t">cairo_svg_version_t</a> const **versions,
|
254
259
|
int *num_versions);</pre>
|
@@ -256,7 +261,6 @@ specification that a generated SVG file will conform to.</p>
|
|
256
261
|
Used to retrieve the list of supported versions. See
|
257
262
|
<a class="link" href="cairo-svg-surface.html#cairo-svg-surface-restrict-to-version" title="cairo_svg_surface_restrict_to_version ()"><code class="function">cairo_svg_surface_restrict_to_version()</code></a>.</p>
|
258
263
|
<p>
|
259
|
-
|
260
264
|
</p>
|
261
265
|
<div class="variablelist"><table border="0">
|
262
266
|
<col align="left" valign="top">
|
@@ -273,19 +277,19 @@ Used to retrieve the list of supported versions. See
|
|
273
277
|
</tr>
|
274
278
|
</tbody>
|
275
279
|
</table></div>
|
276
|
-
<p class="since">Since
|
277
|
-
</p>
|
280
|
+
<p class="since">Since 1.2</p>
|
278
281
|
</div>
|
279
282
|
<hr>
|
280
|
-
<div class="refsect2"
|
283
|
+
<div class="refsect2" title="cairo_svg_version_to_string ()">
|
281
284
|
<a name="cairo-svg-version-to-string"></a><h3>cairo_svg_version_to_string ()</h3>
|
282
|
-
<pre class="programlisting">const char*
|
285
|
+
<pre class="programlisting">const char * cairo_svg_version_to_string (<a class="link" href="cairo-svg-surface.html#cairo-svg-version-t" title="enum cairo_svg_version_t">cairo_svg_version_t</a> version);</pre>
|
283
286
|
<p>
|
284
287
|
Get the string representation of the given <em class="parameter"><code>version</code></em> id. This function
|
285
|
-
will return <
|
288
|
+
will return <a
|
289
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
290
|
+
><code class="literal">NULL</code></a> if <em class="parameter"><code>version</code></em> isn't valid. See <a class="link" href="cairo-svg-surface.html#cairo-svg-get-versions" title="cairo_svg_get_versions ()"><code class="function">cairo_svg_get_versions()</code></a>
|
286
291
|
for a way to get the list of valid version ids.</p>
|
287
292
|
<p>
|
288
|
-
|
289
293
|
</p>
|
290
294
|
<div class="variablelist"><table border="0">
|
291
295
|
<col align="left" valign="top">
|
@@ -303,15 +307,14 @@ for a way to get the list of valid version ids.</p>
|
|
303
307
|
</tr>
|
304
308
|
</tbody>
|
305
309
|
</table></div>
|
306
|
-
<p class="since">Since
|
307
|
-
</p>
|
310
|
+
<p class="since">Since 1.2</p>
|
308
311
|
</div>
|
309
312
|
</div>
|
310
|
-
<div class="refsect1"
|
313
|
+
<div class="refsect1" title="See Also">
|
311
314
|
<a name="cairo-svg-surface.see-also"></a><h2>See Also</h2>
|
312
315
|
<p>
|
313
316
|
</p>
|
314
|
-
<div class="itemizedlist"><ul type="disc"><li>#<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><code class="function">cairo_surface_t()</code></a>
|
317
|
+
<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"><code class="function">cairo_surface_t()</code></a>
|
315
318
|
</li></ul></div>
|
316
319
|
<p>
|
317
320
|
</p>
|
@@ -319,6 +322,6 @@ for a way to get the list of valid version ids.</p>
|
|
319
322
|
</div>
|
320
323
|
<div class="footer">
|
321
324
|
<hr>
|
322
|
-
Generated by GTK-Doc V1.
|
325
|
+
Generated by GTK-Doc V1.11</div>
|
323
326
|
</body>
|
324
327
|
</html>
|
@@ -3,12 +3,12 @@
|
|
3
3
|
<head>
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
5
|
<title>Text</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-drawing.html" title="Drawing">
|
9
9
|
<link rel="prev" href="cairo-transformations.html" title="Transformations">
|
10
10
|
<link rel="next" href="cairo-fonts.html" title="Fonts">
|
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-fonts.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-text.synopsis" class="shortcut">Top</a>
|
35
|
+
|
|
36
|
+
<a href="#cairo-text.description" class="shortcut">Description</a>
|
37
|
+
</td></tr>
|
36
38
|
</table>
|
37
|
-
<div class="refentry"
|
39
|
+
<div class="refentry" title="Text">
|
38
40
|
<a name="cairo-text"></a><div class="titlepage"></div>
|
39
41
|
<div class="refnamediv"><table width="100%"><tr>
|
40
42
|
<td valign="top">
|
@@ -43,7 +45,7 @@
|
|
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-text.synopsis"></a><h2>Synopsis</h2>
|
48
50
|
<pre class="synopsis">
|
49
51
|
<a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a>;
|
@@ -67,10 +69,10 @@ void <a class="link" href="cairo-text.html#cairo-get-font-options
|
|
67
69
|
<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);
|
68
70
|
void <a class="link" href="cairo-text.html#cairo-set-font-face" title="cairo_set_font_face ()">cairo_set_font_face</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
69
71
|
<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);
|
70
|
-
<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a
|
72
|
+
<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-text.html#cairo-get-font-face" title="cairo_get_font_face ()">cairo_get_font_face</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);
|
71
73
|
void <a class="link" href="cairo-text.html#cairo-set-scaled-font" title="cairo_set_scaled_font ()">cairo_set_scaled_font</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
72
74
|
const <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a> *scaled_font);
|
73
|
-
<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-t" title="cairo_scaled_font_t">cairo_scaled_font_t</a
|
75
|
+
<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-text.html#cairo-get-scaled-font" title="cairo_get_scaled_font ()">cairo_get_scaled_font</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);
|
74
76
|
void <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()">cairo_show_text</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
75
77
|
const char *utf8);
|
76
78
|
void <a class="link" href="cairo-text.html#cairo-show-glyphs" title="cairo_show_glyphs ()">cairo_show_glyphs</a> (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
@@ -93,25 +95,25 @@ void <a class="link" href="cairo-text.html#cairo-glyph-extents" t
|
|
93
95
|
const <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> *glyphs,
|
94
96
|
int num_glyphs,
|
95
97
|
<a class="link" href="cairo-scaled-font.html#cairo-text-extents-t" title="cairo_text_extents_t">cairo_text_extents_t</a> *extents);
|
96
|
-
<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a
|
98
|
+
<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-text.html#cairo-toy-font-face-create" title="cairo_toy_font_face_create ()">cairo_toy_font_face_create</a> (const char *family,
|
97
99
|
<a class="link" href="cairo-text.html#cairo-font-slant-t" title="enum cairo_font_slant_t">cairo_font_slant_t</a> slant,
|
98
100
|
<a class="link" href="cairo-text.html#cairo-font-weight-t" title="enum cairo_font_weight_t">cairo_font_weight_t</a> weight);
|
99
|
-
const char*
|
101
|
+
const char * <a class="link" href="cairo-text.html#cairo-toy-font-face-get-family" title="cairo_toy_font_face_get_family ()">cairo_toy_font_face_get_family</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);
|
100
102
|
<a class="link" href="cairo-text.html#cairo-font-slant-t" title="enum cairo_font_slant_t">cairo_font_slant_t</a> <a class="link" href="cairo-text.html#cairo-toy-font-face-get-slant" title="cairo_toy_font_face_get_slant ()">cairo_toy_font_face_get_slant</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);
|
101
|
-
<a class="link" href="cairo-text.html#cairo-font-weight-t" title="enum cairo_font_weight_t">cairo_font_weight_t</a>
|
102
|
-
<a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a
|
103
|
+
<a class="link" href="cairo-text.html#cairo-font-weight-t" title="enum cairo_font_weight_t">cairo_font_weight_t</a> <a class="link" href="cairo-text.html#cairo-toy-font-face-get-weight" title="cairo_toy_font_face_get_weight ()">cairo_toy_font_face_get_weight</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);
|
104
|
+
<a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> * <a class="link" href="cairo-text.html#cairo-glyph-allocate" title="cairo_glyph_allocate ()">cairo_glyph_allocate</a> (int num_glyphs);
|
103
105
|
void <a class="link" href="cairo-text.html#cairo-glyph-free" title="cairo_glyph_free ()">cairo_glyph_free</a> (<a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> *glyphs);
|
104
|
-
<a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t">cairo_text_cluster_t</a
|
106
|
+
<a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t">cairo_text_cluster_t</a> * <a class="link" href="cairo-text.html#cairo-text-cluster-allocate" title="cairo_text_cluster_allocate ()">cairo_text_cluster_allocate</a> (int num_clusters);
|
105
107
|
void <a class="link" href="cairo-text.html#cairo-text-cluster-free" title="cairo_text_cluster_free ()">cairo_text_cluster_free</a> (<a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t">cairo_text_cluster_t</a> *clusters);
|
106
108
|
</pre>
|
107
109
|
</div>
|
108
|
-
<div class="refsect1"
|
110
|
+
<div class="refsect1" title="Description">
|
109
111
|
<a name="cairo-text.description"></a><h2>Description</h2>
|
110
112
|
<p>
|
111
113
|
Cairo has two sets of text rendering capabilities:
|
112
114
|
</p>
|
113
|
-
<div class="itemizedlist"><ul type="disc">
|
114
|
-
<li>
|
115
|
+
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
|
116
|
+
<li class="listitem">
|
115
117
|
The functions with <span class="emphasis"><em>text</em></span> in their name form cairo's
|
116
118
|
<em class="firstterm">toy</em> text API. The toy API takes UTF-8 encoded
|
117
119
|
text and is limited in its functionality to rendering simple
|
@@ -123,7 +125,7 @@ Cairo has two sets of text rendering capabilities:
|
|
123
125
|
This set of functions are really that, a toy text API, for testing and
|
124
126
|
demonstration purposes. Any serious application should avoid them.
|
125
127
|
</li>
|
126
|
-
<li>
|
128
|
+
<li class="listitem">
|
127
129
|
The functions with <span class="emphasis"><em>glyphs</em></span> in their name form cairo's
|
128
130
|
<em class="firstterm">low-level</em> text API. The low-level API relies on
|
129
131
|
the user to convert text to a set of glyph indexes and positions. This
|
@@ -135,9 +137,9 @@ Cairo has two sets of text rendering capabilities:
|
|
135
137
|
<p>
|
136
138
|
</p>
|
137
139
|
</div>
|
138
|
-
<div class="refsect1"
|
140
|
+
<div class="refsect1" title="Details">
|
139
141
|
<a name="cairo-text.details"></a><h2>Details</h2>
|
140
|
-
<div class="refsect2"
|
142
|
+
<div class="refsect2" title="cairo_glyph_t">
|
141
143
|
<a name="cairo-glyph-t"></a><h3>cairo_glyph_t</h3>
|
142
144
|
<pre class="programlisting">typedef struct {
|
143
145
|
unsigned long index;
|
@@ -162,7 +164,6 @@ Note that the offsets given by <em class="parameter"><code>x</code></em> and <em
|
|
162
164
|
drawing or measuring text, each glyph is individually positioned
|
163
165
|
with respect to the overall origin</p>
|
164
166
|
<p>
|
165
|
-
|
166
167
|
</p>
|
167
168
|
<div class="variablelist"><table border="0">
|
168
169
|
<col align="left" valign="top">
|
@@ -189,7 +190,7 @@ with respect to the overall origin</p>
|
|
189
190
|
</table></div>
|
190
191
|
</div>
|
191
192
|
<hr>
|
192
|
-
<div class="refsect2"
|
193
|
+
<div class="refsect2" title="enum cairo_font_slant_t">
|
193
194
|
<a name="cairo-font-slant-t"></a><h3>enum cairo_font_slant_t</h3>
|
194
195
|
<pre class="programlisting">typedef enum _cairo_font_slant {
|
195
196
|
CAIRO_FONT_SLANT_NORMAL,
|
@@ -200,23 +201,22 @@ with respect to the overall origin</p>
|
|
200
201
|
<p>
|
201
202
|
Specifies variants of a font face based on their slant.</p>
|
202
203
|
<p>
|
203
|
-
|
204
204
|
</p>
|
205
205
|
<div class="variablelist"><table border="0">
|
206
206
|
<col align="left" valign="top">
|
207
207
|
<tbody>
|
208
208
|
<tr>
|
209
|
-
<td><p><a name="CAIRO-FONT-SLANT-NORMAL
|
209
|
+
<td><p><a name="CAIRO-FONT-SLANT-NORMAL--CAPS"></a><span class="term"><code class="literal">CAIRO_FONT_SLANT_NORMAL</code></span></p></td>
|
210
210
|
<td> Upright font style
|
211
211
|
</td>
|
212
212
|
</tr>
|
213
213
|
<tr>
|
214
|
-
<td><p><a name="CAIRO-FONT-SLANT-ITALIC
|
214
|
+
<td><p><a name="CAIRO-FONT-SLANT-ITALIC--CAPS"></a><span class="term"><code class="literal">CAIRO_FONT_SLANT_ITALIC</code></span></p></td>
|
215
215
|
<td> Italic font style
|
216
216
|
</td>
|
217
217
|
</tr>
|
218
218
|
<tr>
|
219
|
-
<td><p><a name="CAIRO-FONT-SLANT-OBLIQUE
|
219
|
+
<td><p><a name="CAIRO-FONT-SLANT-OBLIQUE--CAPS"></a><span class="term"><code class="literal">CAIRO_FONT_SLANT_OBLIQUE</code></span></p></td>
|
220
220
|
<td> Oblique font style
|
221
221
|
</td>
|
222
222
|
</tr>
|
@@ -224,7 +224,7 @@ Specifies variants of a font face based on their slant.</p>
|
|
224
224
|
</table></div>
|
225
225
|
</div>
|
226
226
|
<hr>
|
227
|
-
<div class="refsect2"
|
227
|
+
<div class="refsect2" title="enum cairo_font_weight_t">
|
228
228
|
<a name="cairo-font-weight-t"></a><h3>enum cairo_font_weight_t</h3>
|
229
229
|
<pre class="programlisting">typedef enum _cairo_font_weight {
|
230
230
|
CAIRO_FONT_WEIGHT_NORMAL,
|
@@ -234,18 +234,17 @@ Specifies variants of a font face based on their slant.</p>
|
|
234
234
|
<p>
|
235
235
|
Specifies variants of a font face based on their weight.</p>
|
236
236
|
<p>
|
237
|
-
|
238
237
|
</p>
|
239
238
|
<div class="variablelist"><table border="0">
|
240
239
|
<col align="left" valign="top">
|
241
240
|
<tbody>
|
242
241
|
<tr>
|
243
|
-
<td><p><a name="CAIRO-FONT-WEIGHT-NORMAL
|
242
|
+
<td><p><a name="CAIRO-FONT-WEIGHT-NORMAL--CAPS"></a><span class="term"><code class="literal">CAIRO_FONT_WEIGHT_NORMAL</code></span></p></td>
|
244
243
|
<td> Normal font weight
|
245
244
|
</td>
|
246
245
|
</tr>
|
247
246
|
<tr>
|
248
|
-
<td><p><a name="CAIRO-FONT-WEIGHT-BOLD
|
247
|
+
<td><p><a name="CAIRO-FONT-WEIGHT-BOLD--CAPS"></a><span class="term"><code class="literal">CAIRO_FONT_WEIGHT_BOLD</code></span></p></td>
|
249
248
|
<td> Bold font weight
|
250
249
|
</td>
|
251
250
|
</tr>
|
@@ -253,7 +252,7 @@ Specifies variants of a font face based on their weight.</p>
|
|
253
252
|
</table></div>
|
254
253
|
</div>
|
255
254
|
<hr>
|
256
|
-
<div class="refsect2"
|
255
|
+
<div class="refsect2" title="cairo_text_cluster_t">
|
257
256
|
<a name="cairo-text-cluster-t"></a><h3>cairo_text_cluster_t</h3>
|
258
257
|
<pre class="programlisting">typedef struct {
|
259
258
|
int num_bytes;
|
@@ -276,7 +275,6 @@ ignore those clusters when PDF text is being selected.
|
|
276
275
|
See <a class="link" href="cairo-text.html#cairo-show-text-glyphs" title="cairo_show_text_glyphs ()"><code class="function">cairo_show_text_glyphs()</code></a> for how clusters are used in advanced
|
277
276
|
text operations.</p>
|
278
277
|
<p>
|
279
|
-
|
280
278
|
</p>
|
281
279
|
<div class="variablelist"><table border="0">
|
282
280
|
<col align="left" valign="top">
|
@@ -293,11 +291,10 @@ text operations.</p>
|
|
293
291
|
</tr>
|
294
292
|
</tbody>
|
295
293
|
</table></div>
|
296
|
-
<p class="since">Since
|
297
|
-
</p>
|
294
|
+
<p class="since">Since 1.8</p>
|
298
295
|
</div>
|
299
296
|
<hr>
|
300
|
-
<div class="refsect2"
|
297
|
+
<div class="refsect2" title="enum cairo_text_cluster_flags_t">
|
301
298
|
<a name="cairo-text-cluster-flags-t"></a><h3>enum cairo_text_cluster_flags_t</h3>
|
302
299
|
<pre class="programlisting">typedef enum _cairo_text_cluster_flags {
|
303
300
|
CAIRO_TEXT_CLUSTER_FLAG_BACKWARD = 0x00000001
|
@@ -306,22 +303,20 @@ text operations.</p>
|
|
306
303
|
<p>
|
307
304
|
Specifies properties of a text cluster mapping.</p>
|
308
305
|
<p>
|
309
|
-
|
310
306
|
</p>
|
311
307
|
<div class="variablelist"><table border="0">
|
312
308
|
<col align="left" valign="top">
|
313
309
|
<tbody><tr>
|
314
|
-
<td><p><a name="CAIRO-TEXT-CLUSTER-FLAG-BACKWARD
|
310
|
+
<td><p><a name="CAIRO-TEXT-CLUSTER-FLAG-BACKWARD--CAPS"></a><span class="term"><code class="literal">CAIRO_TEXT_CLUSTER_FLAG_BACKWARD</code></span></p></td>
|
315
311
|
<td> The clusters in the cluster array
|
316
312
|
map to glyphs in the glyph array from end to start.
|
317
313
|
</td>
|
318
314
|
</tr></tbody>
|
319
315
|
</table></div>
|
320
|
-
<p class="since">Since
|
321
|
-
</p>
|
316
|
+
<p class="since">Since 1.8</p>
|
322
317
|
</div>
|
323
318
|
<hr>
|
324
|
-
<div class="refsect2"
|
319
|
+
<div class="refsect2" title="cairo_select_font_face ()">
|
325
320
|
<a name="cairo-select-font-face"></a><h3>cairo_select_font_face ()</h3>
|
326
321
|
<pre class="programlisting">void cairo_select_font_face (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
327
322
|
const char *family,
|
@@ -364,14 +359,13 @@ pango), in conjunction with cairo.
|
|
364
359
|
If text is drawn without a call to <a class="link" href="cairo-text.html#cairo-select-font-face" title="cairo_select_font_face ()"><code class="function">cairo_select_font_face()</code></a>, (nor
|
365
360
|
<a class="link" href="cairo-text.html#cairo-set-font-face" title="cairo_set_font_face ()"><code class="function">cairo_set_font_face()</code></a> nor <a class="link" href="cairo-text.html#cairo-set-scaled-font" title="cairo_set_scaled_font ()"><code class="function">cairo_set_scaled_font()</code></a>), the default
|
366
361
|
family is platform-specific, but is essentially "sans-serif".
|
367
|
-
Default slant is <a class="link" href="cairo-text.html#CAIRO-FONT-SLANT-NORMAL
|
368
|
-
<a class="link" href="cairo-text.html#CAIRO-FONT-WEIGHT-NORMAL
|
362
|
+
Default slant is <a class="link" href="cairo-text.html#CAIRO-FONT-SLANT-NORMAL--CAPS"><code class="literal">CAIRO_FONT_SLANT_NORMAL</code></a>, and default weight is
|
363
|
+
<a class="link" href="cairo-text.html#CAIRO-FONT-WEIGHT-NORMAL--CAPS"><code class="literal">CAIRO_FONT_WEIGHT_NORMAL</code></a>.
|
369
364
|
</p>
|
370
365
|
<p>
|
371
366
|
This function is equivalent to a call to <a class="link" href="cairo-text.html#cairo-toy-font-face-create" title="cairo_toy_font_face_create ()"><code class="function">cairo_toy_font_face_create()</code></a>
|
372
367
|
followed by <a class="link" href="cairo-text.html#cairo-set-font-face" title="cairo_set_font_face ()"><code class="function">cairo_set_font_face()</code></a>.</p>
|
373
368
|
<p>
|
374
|
-
|
375
369
|
</p>
|
376
370
|
<div class="variablelist"><table border="0">
|
377
371
|
<col align="left" valign="top">
|
@@ -400,7 +394,7 @@ followed by <a class="link" href="cairo-text.html#cairo-set-font-face" title="ca
|
|
400
394
|
</table></div>
|
401
395
|
</div>
|
402
396
|
<hr>
|
403
|
-
<div class="refsect2"
|
397
|
+
<div class="refsect2" title="cairo_set_font_size ()">
|
404
398
|
<a name="cairo-set-font-size"></a><h3>cairo_set_font_size ()</h3>
|
405
399
|
<pre class="programlisting">void cairo_set_font_size (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
406
400
|
double size);</pre>
|
@@ -416,7 +410,6 @@ If text is drawn without a call to <a class="link" href="cairo-text.html#cairo-s
|
|
416
410
|
<a class="link" href="cairo-text.html#cairo-set-font-matrix" title="cairo_set_font_matrix ()"><code class="function">cairo_set_font_matrix()</code></a> nor <a class="link" href="cairo-text.html#cairo-set-scaled-font" title="cairo_set_scaled_font ()"><code class="function">cairo_set_scaled_font()</code></a>), the default
|
417
411
|
font size is 10.0.</p>
|
418
412
|
<p>
|
419
|
-
|
420
413
|
</p>
|
421
414
|
<div class="variablelist"><table border="0">
|
422
415
|
<col align="left" valign="top">
|
@@ -435,7 +428,7 @@ font size is 10.0.</p>
|
|
435
428
|
</table></div>
|
436
429
|
</div>
|
437
430
|
<hr>
|
438
|
-
<div class="refsect2"
|
431
|
+
<div class="refsect2" title="cairo_set_font_matrix ()">
|
439
432
|
<a name="cairo-set-font-matrix"></a><h3>cairo_set_font_matrix ()</h3>
|
440
433
|
<pre class="programlisting">void cairo_set_font_matrix (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
441
434
|
const <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *matrix);</pre>
|
@@ -447,7 +440,6 @@ simple scale is used (see <a class="link" href="cairo-text.html#cairo-set-font-s
|
|
447
440
|
complex font matrix can be used to shear the font
|
448
441
|
or stretch it unequally along the two axes</p>
|
449
442
|
<p>
|
450
|
-
|
451
443
|
</p>
|
452
444
|
<div class="variablelist"><table border="0">
|
453
445
|
<col align="left" valign="top">
|
@@ -467,7 +459,7 @@ the current font.
|
|
467
459
|
</table></div>
|
468
460
|
</div>
|
469
461
|
<hr>
|
470
|
-
<div class="refsect2"
|
462
|
+
<div class="refsect2" title="cairo_get_font_matrix ()">
|
471
463
|
<a name="cairo-get-font-matrix"></a><h3>cairo_get_font_matrix ()</h3>
|
472
464
|
<pre class="programlisting">void cairo_get_font_matrix (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
473
465
|
<a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *matrix);</pre>
|
@@ -475,7 +467,6 @@ the current font.
|
|
475
467
|
Stores the current font matrix into <em class="parameter"><code>matrix</code></em>. See
|
476
468
|
<a class="link" href="cairo-text.html#cairo-set-font-matrix" title="cairo_set_font_matrix ()"><code class="function">cairo_set_font_matrix()</code></a>.</p>
|
477
469
|
<p>
|
478
|
-
|
479
470
|
</p>
|
480
471
|
<div class="variablelist"><table border="0">
|
481
472
|
<col align="left" valign="top">
|
@@ -494,7 +485,7 @@ Stores the current font matrix into <em class="parameter"><code>matrix</code></e
|
|
494
485
|
</table></div>
|
495
486
|
</div>
|
496
487
|
<hr>
|
497
|
-
<div class="refsect2"
|
488
|
+
<div class="refsect2" title="cairo_set_font_options ()">
|
498
489
|
<a name="cairo-set-font-options"></a><h3>cairo_set_font_options ()</h3>
|
499
490
|
<pre class="programlisting">void cairo_set_font_options (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
500
491
|
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>
|
@@ -502,10 +493,9 @@ Stores the current font matrix into <em class="parameter"><code>matrix</code></e
|
|
502
493
|
Sets a set of custom font rendering options for the <a class="link" href="cairo-context.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a>.
|
503
494
|
Rendering options are derived by merging these options with the
|
504
495
|
options derived from underlying surface; if the value in <em class="parameter"><code>options</code></em>
|
505
|
-
has a default value (like <a class="link" href="cairo-context.html#CAIRO-ANTIALIAS-DEFAULT
|
496
|
+
has a default value (like <a class="link" href="cairo-context.html#CAIRO-ANTIALIAS-DEFAULT--CAPS"><code class="literal">CAIRO_ANTIALIAS_DEFAULT</code></a>), then the value
|
506
497
|
from the surface is used.</p>
|
507
498
|
<p>
|
508
|
-
|
509
499
|
</p>
|
510
500
|
<div class="variablelist"><table border="0">
|
511
501
|
<col align="left" valign="top">
|
@@ -524,7 +514,7 @@ from the surface is used.</p>
|
|
524
514
|
</table></div>
|
525
515
|
</div>
|
526
516
|
<hr>
|
527
|
-
<div class="refsect2"
|
517
|
+
<div class="refsect2" title="cairo_get_font_options ()">
|
528
518
|
<a name="cairo-get-font-options"></a><h3>cairo_get_font_options ()</h3>
|
529
519
|
<pre class="programlisting">void cairo_get_font_options (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
530
520
|
<a class="link" href="cairo-font-options.html#cairo-font-options-t" title="cairo_font_options_t">cairo_font_options_t</a> *options);</pre>
|
@@ -534,7 +524,6 @@ Note that the returned options do not include any options derived
|
|
534
524
|
from the underlying surface; they are literally the options
|
535
525
|
passed to <a class="link" href="cairo-text.html#cairo-set-font-options" title="cairo_set_font_options ()"><code class="function">cairo_set_font_options()</code></a>.</p>
|
536
526
|
<p>
|
537
|
-
|
538
527
|
</p>
|
539
528
|
<div class="variablelist"><table border="0">
|
540
529
|
<col align="left" valign="top">
|
@@ -554,7 +543,7 @@ passed to <a class="link" href="cairo-text.html#cairo-set-font-options" title="c
|
|
554
543
|
</table></div>
|
555
544
|
</div>
|
556
545
|
<hr>
|
557
|
-
<div class="refsect2"
|
546
|
+
<div class="refsect2" title="cairo_set_font_face ()">
|
558
547
|
<a name="cairo-set-font-face"></a><h3>cairo_set_font_face ()</h3>
|
559
548
|
<pre class="programlisting">void cairo_set_font_face (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
560
549
|
<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);</pre>
|
@@ -563,7 +552,6 @@ Replaces the current <a class="link" href="cairo-font-face.html#cairo-font-face-
|
|
563
552
|
<em class="parameter"><code>font_face</code></em>. The replaced font face in the <a class="link" href="cairo-context.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> will be
|
564
553
|
destroyed if there are no other references to it.</p>
|
565
554
|
<p>
|
566
|
-
|
567
555
|
</p>
|
568
556
|
<div class="variablelist"><table border="0">
|
569
557
|
<col align="left" valign="top">
|
@@ -575,20 +563,21 @@ destroyed if there are no other references to it.</p>
|
|
575
563
|
</tr>
|
576
564
|
<tr>
|
577
565
|
<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
|
578
|
-
<td> a <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>, or <
|
566
|
+
<td> a <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>, or <a
|
567
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
568
|
+
><code class="literal">NULL</code></a> to restore to the default font
|
579
569
|
</td>
|
580
570
|
</tr>
|
581
571
|
</tbody>
|
582
572
|
</table></div>
|
583
573
|
</div>
|
584
574
|
<hr>
|
585
|
-
<div class="refsect2"
|
575
|
+
<div class="refsect2" title="cairo_get_font_face ()">
|
586
576
|
<a name="cairo-get-font-face"></a><h3>cairo_get_font_face ()</h3>
|
587
|
-
<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
|
577
|
+
<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_get_font_face (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);</pre>
|
588
578
|
<p>
|
589
579
|
Gets the current font face for a <a class="link" href="cairo-context.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a>.</p>
|
590
580
|
<p>
|
591
|
-
|
592
581
|
</p>
|
593
582
|
<div class="variablelist"><table border="0">
|
594
583
|
<col align="left" valign="top">
|
@@ -604,9 +593,11 @@ Gets the current font face for a <a class="link" href="cairo-context.html#cairo-
|
|
604
593
|
cairo. To keep a reference to it, you must call
|
605
594
|
<a class="link" href="cairo-font-face.html#cairo-font-face-reference" title="cairo_font_face_reference ()"><code class="function">cairo_font_face_reference()</code></a>.
|
606
595
|
|
607
|
-
This function never returns <
|
596
|
+
This function never returns <a
|
597
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
598
|
+
><code class="literal">NULL</code></a>. If memory cannot be allocated, a
|
608
599
|
special "nil" <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> object will be returned on which
|
609
|
-
<a class="link" href="cairo-font-face.html#cairo-font-face-status" title="cairo_font_face_status ()"><code class="function">cairo_font_face_status()</code></a> returns <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY
|
600
|
+
<a class="link" href="cairo-font-face.html#cairo-font-face-status" title="cairo_font_face_status ()"><code class="function">cairo_font_face_status()</code></a> returns <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>. Using
|
610
601
|
this nil object will cause its error state to propagate to other
|
611
602
|
objects it is passed to, (for example, calling
|
612
603
|
<a class="link" href="cairo-text.html#cairo-set-font-face" title="cairo_set_font_face ()"><code class="function">cairo_set_font_face()</code></a> with a nil font will trigger an error that
|
@@ -617,7 +608,7 @@ will shutdown the <a class="link" href="cairo-context.html#cairo-t" title="cairo
|
|
617
608
|
</table></div>
|
618
609
|
</div>
|
619
610
|
<hr>
|
620
|
-
<div class="refsect2"
|
611
|
+
<div class="refsect2" title="cairo_set_scaled_font ()">
|
621
612
|
<a name="cairo-set-scaled-font"></a><h3>cairo_set_scaled_font ()</h3>
|
622
613
|
<pre class="programlisting">void cairo_set_scaled_font (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
623
614
|
const <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>
|
@@ -628,7 +619,6 @@ some translation, the current CTM of the <a class="link" href="cairo-context.htm
|
|
628
619
|
same as that of the <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>, which can be accessed
|
629
620
|
using <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-get-ctm" title="cairo_scaled_font_get_ctm ()"><code class="function">cairo_scaled_font_get_ctm()</code></a>.</p>
|
630
621
|
<p>
|
631
|
-
|
632
622
|
</p>
|
633
623
|
<div class="variablelist"><table border="0">
|
634
624
|
<col align="left" valign="top">
|
@@ -645,17 +635,15 @@ using <a class="link" href="cairo-scaled-font.html#cairo-scaled-font-get-ctm" ti
|
|
645
635
|
</tr>
|
646
636
|
</tbody>
|
647
637
|
</table></div>
|
648
|
-
<p class="since">Since
|
649
|
-
</p>
|
638
|
+
<p class="since">Since 1.2</p>
|
650
639
|
</div>
|
651
640
|
<hr>
|
652
|
-
<div class="refsect2"
|
641
|
+
<div class="refsect2" title="cairo_get_scaled_font ()">
|
653
642
|
<a name="cairo-get-scaled-font"></a><h3>cairo_get_scaled_font ()</h3>
|
654
|
-
<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
|
643
|
+
<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_get_scaled_font (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);</pre>
|
655
644
|
<p>
|
656
645
|
Gets the current scaled font for a <a class="link" href="cairo-context.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a>.</p>
|
657
646
|
<p>
|
658
|
-
|
659
647
|
</p>
|
660
648
|
<div class="variablelist"><table border="0">
|
661
649
|
<col align="left" valign="top">
|
@@ -671,9 +659,11 @@ Gets the current scaled font for a <a class="link" href="cairo-context.html#cair
|
|
671
659
|
cairo. To keep a reference to it, you must call
|
672
660
|
<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>.
|
673
661
|
|
674
|
-
This function never returns <
|
662
|
+
This function never returns <a
|
663
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
664
|
+
><code class="literal">NULL</code></a>. If memory cannot be allocated, a
|
675
665
|
special "nil" <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> object will be returned on which
|
676
|
-
<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-status" title="cairo_scaled_font_status ()"><code class="function">cairo_scaled_font_status()</code></a> returns <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY
|
666
|
+
<a class="link" href="cairo-scaled-font.html#cairo-scaled-font-status" title="cairo_scaled_font_status ()"><code class="function">cairo_scaled_font_status()</code></a> returns <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>. Using
|
677
667
|
this nil object will cause its error state to propagate to other
|
678
668
|
objects it is passed to, (for example, calling
|
679
669
|
<a class="link" href="cairo-text.html#cairo-set-scaled-font" title="cairo_set_scaled_font ()"><code class="function">cairo_set_scaled_font()</code></a> with a nil font will trigger an error that
|
@@ -683,11 +673,10 @@ will shutdown the <a class="link" href="cairo-context.html#cairo-t" title="cairo
|
|
683
673
|
</tr>
|
684
674
|
</tbody>
|
685
675
|
</table></div>
|
686
|
-
<p class="since">Since
|
687
|
-
</p>
|
676
|
+
<p class="since">Since 1.4</p>
|
688
677
|
</div>
|
689
678
|
<hr>
|
690
|
-
<div class="refsect2"
|
679
|
+
<div class="refsect2" title="cairo_show_text ()">
|
691
680
|
<a name="cairo-show-text"></a><h3>cairo_show_text ()</h3>
|
692
681
|
<pre class="programlisting">void cairo_show_text (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
693
682
|
const char *utf8);</pre>
|
@@ -717,7 +706,6 @@ and simple programs, but it is not expected to be adequate for
|
|
717
706
|
serious text-using applications. See <a class="link" href="cairo-text.html#cairo-show-glyphs" title="cairo_show_glyphs ()"><code class="function">cairo_show_glyphs()</code></a> for the
|
718
707
|
"real" text display API in cairo.</p>
|
719
708
|
<p>
|
720
|
-
|
721
709
|
</p>
|
722
710
|
<div class="variablelist"><table border="0">
|
723
711
|
<col align="left" valign="top">
|
@@ -729,14 +717,16 @@ serious text-using applications. See <a class="link" href="cairo-text.html#cairo
|
|
729
717
|
</tr>
|
730
718
|
<tr>
|
731
719
|
<td><p><span class="term"><em class="parameter"><code>utf8</code></em> :</span></p></td>
|
732
|
-
<td> a NUL-terminated string of text encoded in UTF-8, or <
|
720
|
+
<td> a NUL-terminated string of text encoded in UTF-8, or <a
|
721
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
722
|
+
><code class="literal">NULL</code></a>
|
733
723
|
</td>
|
734
724
|
</tr>
|
735
725
|
</tbody>
|
736
726
|
</table></div>
|
737
727
|
</div>
|
738
728
|
<hr>
|
739
|
-
<div class="refsect2"
|
729
|
+
<div class="refsect2" title="cairo_show_glyphs ()">
|
740
730
|
<a name="cairo-show-glyphs"></a><h3>cairo_show_glyphs ()</h3>
|
741
731
|
<pre class="programlisting">void cairo_show_glyphs (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
742
732
|
const <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> *glyphs,
|
@@ -746,7 +736,6 @@ A drawing operator that generates the shape from an array of glyphs,
|
|
746
736
|
rendered according to the current font face, font size
|
747
737
|
(font matrix), and font options.</p>
|
748
738
|
<p>
|
749
|
-
|
750
739
|
</p>
|
751
740
|
<div class="variablelist"><table border="0">
|
752
741
|
<col align="left" valign="top">
|
@@ -770,7 +759,7 @@ rendered according to the current font face, font size
|
|
770
759
|
</table></div>
|
771
760
|
</div>
|
772
761
|
<hr>
|
773
|
-
<div class="refsect2"
|
762
|
+
<div class="refsect2" title="cairo_show_text_glyphs ()">
|
774
763
|
<a name="cairo-show-text-glyphs"></a><h3>cairo_show_text_glyphs ()</h3>
|
775
764
|
<pre class="programlisting">void cairo_show_text_glyphs (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
776
765
|
const char *utf8,
|
@@ -784,11 +773,9 @@ rendered according to the current font face, font size
|
|
784
773
|
This operation has rendering effects similar to <a class="link" href="cairo-text.html#cairo-show-glyphs" title="cairo_show_glyphs ()"><code class="function">cairo_show_glyphs()</code></a>
|
785
774
|
but, if the target surface supports it, uses the provided text and
|
786
775
|
cluster mapping to embed the text for the glyphs shown in the output.
|
787
|
-
|
788
|
-
href="
|
789
|
-
|
790
|
-
If the target does not support it, this function acts like
|
791
|
-
<a class="link" href="cairo-text.html#cairo-show-glyphs" title="cairo_show_glyphs ()"><code class="function">cairo_show_glyphs()</code></a>.
|
776
|
+
If the target does not support the extended attributes, this function
|
777
|
+
acts like the basic <a class="link" href="cairo-text.html#cairo-show-glyphs" title="cairo_show_glyphs ()"><code class="function">cairo_show_glyphs()</code></a> as if it had been passed
|
778
|
+
<em class="parameter"><code>glyphs</code></em> and <em class="parameter"><code>num_glyphs</code></em>.
|
792
779
|
</p>
|
793
780
|
<p>
|
794
781
|
The mapping between <em class="parameter"><code>utf8</code></em> and <em class="parameter"><code>glyphs</code></em> is provided by an array of
|
@@ -799,7 +786,7 @@ and <em class="parameter"><code>glyphs</code></em> in entirety.
|
|
799
786
|
</p>
|
800
787
|
<p>
|
801
788
|
The first cluster always covers bytes from the beginning of <em class="parameter"><code>utf8</code></em>.
|
802
|
-
If <em class="parameter"><code>cluster_flags</code></em> do not have the <a class="link" href="cairo-text.html#CAIRO-TEXT-CLUSTER-FLAG-BACKWARD
|
789
|
+
If <em class="parameter"><code>cluster_flags</code></em> do not have the <a class="link" href="cairo-text.html#CAIRO-TEXT-CLUSTER-FLAG-BACKWARD--CAPS"><code class="literal">CAIRO_TEXT_CLUSTER_FLAG_BACKWARD</code></a>
|
803
790
|
set, the first cluster also covers the beginning
|
804
791
|
of <em class="parameter"><code>glyphs</code></em>, otherwise it covers the end of the <em class="parameter"><code>glyphs</code></em> array and
|
805
792
|
following clusters move backward.
|
@@ -807,7 +794,6 @@ following clusters move backward.
|
|
807
794
|
<p>
|
808
795
|
See <a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t"><span class="type">cairo_text_cluster_t</span></a> for constraints on valid clusters.</p>
|
809
796
|
<p>
|
810
|
-
|
811
797
|
</p>
|
812
798
|
<div class="variablelist"><table border="0">
|
813
799
|
<col align="left" valign="top">
|
@@ -854,18 +840,16 @@ See <a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_tex
|
|
854
840
|
</tr>
|
855
841
|
</tbody>
|
856
842
|
</table></div>
|
857
|
-
<p class="since">Since
|
858
|
-
</p>
|
843
|
+
<p class="since">Since 1.8</p>
|
859
844
|
</div>
|
860
845
|
<hr>
|
861
|
-
<div class="refsect2"
|
846
|
+
<div class="refsect2" title="cairo_font_extents ()">
|
862
847
|
<a name="cairo-font-extents"></a><h3>cairo_font_extents ()</h3>
|
863
848
|
<pre class="programlisting">void cairo_font_extents (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
864
849
|
<a class="link" href="cairo-scaled-font.html#cairo-font-extents-t" title="cairo_font_extents_t">cairo_font_extents_t</a> *extents);</pre>
|
865
850
|
<p>
|
866
851
|
Gets the font extents for the currently selected font.</p>
|
867
852
|
<p>
|
868
|
-
|
869
853
|
</p>
|
870
854
|
<div class="variablelist"><table border="0">
|
871
855
|
<col align="left" valign="top">
|
@@ -885,7 +869,7 @@ will be stored.
|
|
885
869
|
</table></div>
|
886
870
|
</div>
|
887
871
|
<hr>
|
888
|
-
<div class="refsect2"
|
872
|
+
<div class="refsect2" title="cairo_text_extents ()">
|
889
873
|
<a name="cairo-text-extents"></a><h3>cairo_text_extents ()</h3>
|
890
874
|
<pre class="programlisting">void cairo_text_extents (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
891
875
|
const char *utf8,
|
@@ -905,7 +889,6 @@ characters. In particular, trailing whitespace characters are
|
|
905
889
|
likely to not affect the size of the rectangle, though they will
|
906
890
|
affect the x_advance and y_advance values.</p>
|
907
891
|
<p>
|
908
|
-
|
909
892
|
</p>
|
910
893
|
<div class="variablelist"><table border="0">
|
911
894
|
<col align="left" valign="top">
|
@@ -917,7 +900,9 @@ affect the x_advance and y_advance values.</p>
|
|
917
900
|
</tr>
|
918
901
|
<tr>
|
919
902
|
<td><p><span class="term"><em class="parameter"><code>utf8</code></em> :</span></p></td>
|
920
|
-
<td> a NUL-terminated string of text encoded in UTF-8, or <
|
903
|
+
<td> a NUL-terminated string of text encoded in UTF-8, or <a
|
904
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
905
|
+
><code class="literal">NULL</code></a>
|
921
906
|
</td>
|
922
907
|
</tr>
|
923
908
|
<tr>
|
@@ -930,7 +915,7 @@ will be stored
|
|
930
915
|
</table></div>
|
931
916
|
</div>
|
932
917
|
<hr>
|
933
|
-
<div class="refsect2"
|
918
|
+
<div class="refsect2" title="cairo_glyph_extents ()">
|
934
919
|
<a name="cairo-glyph-extents"></a><h3>cairo_glyph_extents ()</h3>
|
935
920
|
<pre class="programlisting">void cairo_glyph_extents (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr,
|
936
921
|
const <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> *glyphs,
|
@@ -948,7 +933,6 @@ amount by which the current point would be advanced by
|
|
948
933
|
Note that whitespace glyphs do not contribute to the size of the
|
949
934
|
rectangle (extents.width and extents.height).</p>
|
950
935
|
<p>
|
951
|
-
|
952
936
|
</p>
|
953
937
|
<div class="variablelist"><table border="0">
|
954
938
|
<col align="left" valign="top">
|
@@ -978,9 +962,9 @@ will be stored
|
|
978
962
|
</table></div>
|
979
963
|
</div>
|
980
964
|
<hr>
|
981
|
-
<div class="refsect2"
|
965
|
+
<div class="refsect2" title="cairo_toy_font_face_create ()">
|
982
966
|
<a name="cairo-toy-font-face-create"></a><h3>cairo_toy_font_face_create ()</h3>
|
983
|
-
<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
|
967
|
+
<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_toy_font_face_create (const char *family,
|
984
968
|
<a class="link" href="cairo-text.html#cairo-font-slant-t" title="enum cairo_font_slant_t">cairo_font_slant_t</a> slant,
|
985
969
|
<a class="link" href="cairo-text.html#cairo-font-weight-t" title="enum cairo_font_weight_t">cairo_font_weight_t</a> weight);</pre>
|
986
970
|
<p>
|
@@ -997,7 +981,6 @@ family is assumed. The default family then can be queried using
|
|
997
981
|
The <a class="link" href="cairo-text.html#cairo-select-font-face" title="cairo_select_font_face ()"><code class="function">cairo_select_font_face()</code></a> function uses this to create font faces.
|
998
982
|
See that function for limitations of toy font faces.</p>
|
999
983
|
<p>
|
1000
|
-
|
1001
984
|
</p>
|
1002
985
|
<div class="variablelist"><table border="0">
|
1003
986
|
<col align="left" valign="top">
|
@@ -1026,17 +1009,15 @@ See that function for limitations of toy font faces.</p>
|
|
1026
1009
|
</tr>
|
1027
1010
|
</tbody>
|
1028
1011
|
</table></div>
|
1029
|
-
<p class="since">Since
|
1030
|
-
</p>
|
1012
|
+
<p class="since">Since 1.8</p>
|
1031
1013
|
</div>
|
1032
1014
|
<hr>
|
1033
|
-
<div class="refsect2"
|
1015
|
+
<div class="refsect2" title="cairo_toy_font_face_get_family ()">
|
1034
1016
|
<a name="cairo-toy-font-face-get-family"></a><h3>cairo_toy_font_face_get_family ()</h3>
|
1035
|
-
<pre class="programlisting">const char*
|
1017
|
+
<pre class="programlisting">const char * cairo_toy_font_face_get_family (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);</pre>
|
1036
1018
|
<p>
|
1037
1019
|
Gets the familly name of a toy font.</p>
|
1038
1020
|
<p>
|
1039
|
-
|
1040
1021
|
</p>
|
1041
1022
|
<div class="variablelist"><table border="0">
|
1042
1023
|
<col align="left" valign="top">
|
@@ -1055,17 +1036,15 @@ and remains valid as long as the font face is alive (referenced).
|
|
1055
1036
|
</tr>
|
1056
1037
|
</tbody>
|
1057
1038
|
</table></div>
|
1058
|
-
<p class="since">Since
|
1059
|
-
</p>
|
1039
|
+
<p class="since">Since 1.8</p>
|
1060
1040
|
</div>
|
1061
1041
|
<hr>
|
1062
|
-
<div class="refsect2"
|
1042
|
+
<div class="refsect2" title="cairo_toy_font_face_get_slant ()">
|
1063
1043
|
<a name="cairo-toy-font-face-get-slant"></a><h3>cairo_toy_font_face_get_slant ()</h3>
|
1064
1044
|
<pre class="programlisting"><a class="link" href="cairo-text.html#cairo-font-slant-t" title="enum cairo_font_slant_t">cairo_font_slant_t</a> cairo_toy_font_face_get_slant (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);</pre>
|
1065
1045
|
<p>
|
1066
1046
|
Gets the slant a toy font.</p>
|
1067
1047
|
<p>
|
1068
|
-
|
1069
1048
|
</p>
|
1070
1049
|
<div class="variablelist"><table border="0">
|
1071
1050
|
<col align="left" valign="top">
|
@@ -1083,17 +1062,15 @@ Gets the slant a toy font.</p>
|
|
1083
1062
|
</tr>
|
1084
1063
|
</tbody>
|
1085
1064
|
</table></div>
|
1086
|
-
<p class="since">Since
|
1087
|
-
</p>
|
1065
|
+
<p class="since">Since 1.8</p>
|
1088
1066
|
</div>
|
1089
1067
|
<hr>
|
1090
|
-
<div class="refsect2"
|
1068
|
+
<div class="refsect2" title="cairo_toy_font_face_get_weight ()">
|
1091
1069
|
<a name="cairo-toy-font-face-get-weight"></a><h3>cairo_toy_font_face_get_weight ()</h3>
|
1092
|
-
<pre class="programlisting"><a class="link" href="cairo-text.html#cairo-font-weight-t" title="enum cairo_font_weight_t">cairo_font_weight_t</a>
|
1070
|
+
<pre class="programlisting"><a class="link" href="cairo-text.html#cairo-font-weight-t" title="enum cairo_font_weight_t">cairo_font_weight_t</a> cairo_toy_font_face_get_weight (<a class="link" href="cairo-font-face.html#cairo-font-face-t" title="cairo_font_face_t">cairo_font_face_t</a> *font_face);</pre>
|
1093
1071
|
<p>
|
1094
1072
|
Gets the weight a toy font.</p>
|
1095
1073
|
<p>
|
1096
|
-
|
1097
1074
|
</p>
|
1098
1075
|
<div class="variablelist"><table border="0">
|
1099
1076
|
<col align="left" valign="top">
|
@@ -1111,13 +1088,12 @@ Gets the weight a toy font.</p>
|
|
1111
1088
|
</tr>
|
1112
1089
|
</tbody>
|
1113
1090
|
</table></div>
|
1114
|
-
<p class="since">Since
|
1115
|
-
</p>
|
1091
|
+
<p class="since">Since 1.8</p>
|
1116
1092
|
</div>
|
1117
1093
|
<hr>
|
1118
|
-
<div class="refsect2"
|
1094
|
+
<div class="refsect2" title="cairo_glyph_allocate ()">
|
1119
1095
|
<a name="cairo-glyph-allocate"></a><h3>cairo_glyph_allocate ()</h3>
|
1120
|
-
<pre class="programlisting"><a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a
|
1096
|
+
<pre class="programlisting"><a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> * cairo_glyph_allocate (int num_glyphs);</pre>
|
1121
1097
|
<p>
|
1122
1098
|
Allocates an array of <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t"><span class="type">cairo_glyph_t</span></a>'s.
|
1123
1099
|
This function is only useful in implementations of
|
@@ -1127,11 +1103,14 @@ For all other uses, user can use their own allocation method
|
|
1127
1103
|
for glyphs.
|
1128
1104
|
</p>
|
1129
1105
|
<p>
|
1130
|
-
This function returns <
|
1131
|
-
|
1106
|
+
This function returns <a
|
1107
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
1108
|
+
><code class="literal">NULL</code></a> if <em class="parameter"><code>num_glyphs</code></em> is not positive,
|
1109
|
+
or if out of memory. That means, the <a
|
1110
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
1111
|
+
><code class="literal">NULL</code></a> return value
|
1132
1112
|
signals out-of-memory only if <em class="parameter"><code>num_glyphs</code></em> was positive.</p>
|
1133
1113
|
<p>
|
1134
|
-
|
1135
1114
|
</p>
|
1136
1115
|
<div class="variablelist"><table border="0">
|
1137
1116
|
<col align="left" valign="top">
|
@@ -1150,11 +1129,10 @@ signals out-of-memory only if <em class="parameter"><code>num_glyphs</code></em>
|
|
1150
1129
|
</tr>
|
1151
1130
|
</tbody>
|
1152
1131
|
</table></div>
|
1153
|
-
<p class="since">Since
|
1154
|
-
</p>
|
1132
|
+
<p class="since">Since 1.8</p>
|
1155
1133
|
</div>
|
1156
1134
|
<hr>
|
1157
|
-
<div class="refsect2"
|
1135
|
+
<div class="refsect2" title="cairo_glyph_free ()">
|
1158
1136
|
<a name="cairo-glyph-free"></a><h3>cairo_glyph_free ()</h3>
|
1159
1137
|
<pre class="programlisting">void cairo_glyph_free (<a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t">cairo_glyph_t</a> *glyphs);</pre>
|
1160
1138
|
<p>
|
@@ -1165,23 +1143,23 @@ an array of glyphs that the user will free.
|
|
1165
1143
|
For all other uses, user can use their own allocation method
|
1166
1144
|
for glyphs.</p>
|
1167
1145
|
<p>
|
1168
|
-
|
1169
1146
|
</p>
|
1170
1147
|
<div class="variablelist"><table border="0">
|
1171
1148
|
<col align="left" valign="top">
|
1172
1149
|
<tbody><tr>
|
1173
1150
|
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
|
1174
|
-
<td> array of glyphs to free, or <
|
1151
|
+
<td> array of glyphs to free, or <a
|
1152
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
1153
|
+
><code class="literal">NULL</code></a>
|
1175
1154
|
</td>
|
1176
1155
|
</tr></tbody>
|
1177
1156
|
</table></div>
|
1178
|
-
<p class="since">Since
|
1179
|
-
</p>
|
1157
|
+
<p class="since">Since 1.8</p>
|
1180
1158
|
</div>
|
1181
1159
|
<hr>
|
1182
|
-
<div class="refsect2"
|
1160
|
+
<div class="refsect2" title="cairo_text_cluster_allocate ()">
|
1183
1161
|
<a name="cairo-text-cluster-allocate"></a><h3>cairo_text_cluster_allocate ()</h3>
|
1184
|
-
<pre class="programlisting"><a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t">cairo_text_cluster_t</a
|
1162
|
+
<pre class="programlisting"><a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t">cairo_text_cluster_t</a> * cairo_text_cluster_allocate (int num_clusters);</pre>
|
1185
1163
|
<p>
|
1186
1164
|
Allocates an array of <a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t"><span class="type">cairo_text_cluster_t</span></a>'s.
|
1187
1165
|
This function is only useful in implementations of
|
@@ -1191,11 +1169,14 @@ For all other uses, user can use their own allocation method
|
|
1191
1169
|
for text clusters.
|
1192
1170
|
</p>
|
1193
1171
|
<p>
|
1194
|
-
This function returns <
|
1195
|
-
|
1172
|
+
This function returns <a
|
1173
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
1174
|
+
><code class="literal">NULL</code></a> if <em class="parameter"><code>num_clusters</code></em> is not positive,
|
1175
|
+
or if out of memory. That means, the <a
|
1176
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
1177
|
+
><code class="literal">NULL</code></a> return value
|
1196
1178
|
signals out-of-memory only if <em class="parameter"><code>num_clusters</code></em> was positive.</p>
|
1197
1179
|
<p>
|
1198
|
-
|
1199
1180
|
</p>
|
1200
1181
|
<div class="variablelist"><table border="0">
|
1201
1182
|
<col align="left" valign="top">
|
@@ -1214,11 +1195,10 @@ signals out-of-memory only if <em class="parameter"><code>num_clusters</code></e
|
|
1214
1195
|
</tr>
|
1215
1196
|
</tbody>
|
1216
1197
|
</table></div>
|
1217
|
-
<p class="since">Since
|
1218
|
-
</p>
|
1198
|
+
<p class="since">Since 1.8</p>
|
1219
1199
|
</div>
|
1220
1200
|
<hr>
|
1221
|
-
<div class="refsect2"
|
1201
|
+
<div class="refsect2" title="cairo_text_cluster_free ()">
|
1222
1202
|
<a name="cairo-text-cluster-free"></a><h3>cairo_text_cluster_free ()</h3>
|
1223
1203
|
<pre class="programlisting">void cairo_text_cluster_free (<a class="link" href="cairo-text.html#cairo-text-cluster-t" title="cairo_text_cluster_t">cairo_text_cluster_t</a> *clusters);</pre>
|
1224
1204
|
<p>
|
@@ -1229,29 +1209,29 @@ an array of text clusters that the user will free.
|
|
1229
1209
|
For all other uses, user can use their own allocation method
|
1230
1210
|
for text clusters.</p>
|
1231
1211
|
<p>
|
1232
|
-
|
1233
1212
|
</p>
|
1234
1213
|
<div class="variablelist"><table border="0">
|
1235
1214
|
<col align="left" valign="top">
|
1236
1215
|
<tbody><tr>
|
1237
1216
|
<td><p><span class="term"><em class="parameter"><code>clusters</code></em> :</span></p></td>
|
1238
|
-
<td> array of text clusters to free, or <
|
1217
|
+
<td> array of text clusters to free, or <a
|
1218
|
+
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
|
1219
|
+
><code class="literal">NULL</code></a>
|
1239
1220
|
</td>
|
1240
1221
|
</tr></tbody>
|
1241
1222
|
</table></div>
|
1242
|
-
<p class="since">Since
|
1243
|
-
</p>
|
1223
|
+
<p class="since">Since 1.8</p>
|
1244
1224
|
</div>
|
1245
1225
|
</div>
|
1246
|
-
<div class="refsect1"
|
1226
|
+
<div class="refsect1" title="See Also">
|
1247
1227
|
<a name="cairo-text.see-also"></a><h2>See Also</h2>
|
1248
1228
|
<p>
|
1249
1229
|
</p>
|
1250
|
-
<div class="itemizedlist"><ul type="disc">
|
1251
|
-
<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>
|
1252
|
-
<li><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></li>
|
1253
|
-
<li><a class="link" href="cairo-paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a></li>
|
1254
|
-
<li><a class="link" href="cairo-paths.html#cairo-glyph-path" title="cairo_glyph_path ()"><code class="function">cairo_glyph_path()</code></a></li>
|
1230
|
+
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
|
1231
|
+
<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>
|
1232
|
+
<li class="listitem"><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></li>
|
1233
|
+
<li class="listitem"><a class="link" href="cairo-paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a></li>
|
1234
|
+
<li class="listitem"><a class="link" href="cairo-paths.html#cairo-glyph-path" title="cairo_glyph_path ()"><code class="function">cairo_glyph_path()</code></a></li>
|
1255
1235
|
</ul></div>
|
1256
1236
|
<p>
|
1257
1237
|
</p>
|
@@ -1259,6 +1239,6 @@ for text clusters.</p>
|
|
1259
1239
|
</div>
|
1260
1240
|
<div class="footer">
|
1261
1241
|
<hr>
|
1262
|
-
Generated by GTK-Doc V1.
|
1242
|
+
Generated by GTK-Doc V1.11</div>
|
1263
1243
|
</body>
|
1264
1244
|
</html>
|