cairo 1.7.0-x86-mswin32 → 1.8.0-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 +32 -0
- data/NEWS +9 -1
- data/README +1 -0
- data/Rakefile +2 -2
- data/cairo/DLL_FAQ.txt +397 -0
- data/cairo/README.txt +53 -0
- data/cairo/USAGE.txt +94 -0
- data/cairo/bin/libcairo-2.dll +0 -0
- data/cairo/bin/libpng12-0.dll +0 -0
- data/cairo/bin/zlib1.dll +0 -0
- data/cairo/include/cairo/cairo-deprecated.h +0 -4
- data/cairo/include/cairo/cairo-features.h +7 -22
- data/cairo/include/cairo/cairo-pdf.h +1 -1
- data/cairo/include/cairo/cairo-ps.h +1 -1
- data/cairo/include/cairo/cairo-svg.h +1 -1
- data/cairo/include/cairo/cairo-version.h +8 -0
- data/cairo/include/cairo/cairo-win32.h +9 -1
- data/cairo/include/cairo/cairo.h +420 -32
- data/cairo/include/libpng12/png.h +3592 -0
- data/cairo/include/libpng12/pngconf.h +1481 -0
- data/cairo/include/png.h +36 -13
- data/cairo/include/pngconf.h +3 -3
- data/cairo/include/zconf.h +332 -0
- data/cairo/include/zlib.h +1357 -0
- data/cairo/lib/cairo.def +22 -0
- data/cairo/lib/cairo.lib +0 -0
- data/cairo/lib/libcairo.dll.a +0 -0
- data/cairo/lib/libpng.def +1 -0
- data/cairo/lib/libpng.lib +0 -0
- data/cairo/lib/libpng12.dll.a +0 -0
- data/cairo/lib/pkgconfig/cairo-pdf.pc +5 -5
- data/cairo/lib/pkgconfig/cairo-png.pc +5 -5
- data/cairo/lib/pkgconfig/cairo-ps.pc +5 -5
- data/cairo/lib/pkgconfig/cairo-svg.pc +4 -4
- data/cairo/lib/pkgconfig/cairo-win32-font.pc +4 -4
- data/cairo/lib/pkgconfig/cairo-win32.pc +4 -4
- data/cairo/lib/pkgconfig/cairo.pc +4 -4
- data/cairo/lib/pkgconfig/libpng.pc +3 -2
- data/cairo/lib/pkgconfig/libpng12.pc +3 -2
- data/cairo/lib/zdll.exp +0 -0
- data/cairo/lib/zdll.lib +0 -0
- data/cairo/lib/zlib.def +60 -0
- data/cairo/manifest/cairo-dev_1.8.0-1_win32.mft +76 -0
- data/cairo/manifest/cairo_1.8.0-1_win32.mft +5 -0
- data/cairo/manifest/{libpng-dev-1.2.29.mft → libpng-dev_1.2.32-1_win32.mft} +5 -2
- data/cairo/manifest/libpng_1.2.32-1_win32.mft +2 -0
- data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING +0 -0
- data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING-LGPL-2.1 +0 -0
- data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING-MPL-1.1 +0 -0
- data/cairo/share/gtk-doc/html/cairo/bindings-errors.html +15 -11
- data/cairo/share/gtk-doc/html/cairo/bindings-fonts.html +15 -11
- data/cairo/share/gtk-doc/html/cairo/bindings-memory.html +20 -16
- data/cairo/share/gtk-doc/html/cairo/bindings-overloading.html +16 -12
- data/cairo/share/gtk-doc/html/cairo/bindings-path.html +17 -13
- data/cairo/share/gtk-doc/html/cairo/bindings-patterns.html +25 -21
- data/cairo/share/gtk-doc/html/cairo/bindings-return-values.html +17 -13
- data/cairo/share/gtk-doc/html/cairo/bindings-streams.html +14 -10
- data/cairo/share/gtk-doc/html/cairo/bindings-surfaces.html +19 -15
- data/cairo/share/gtk-doc/html/cairo/cairo-context.html +2721 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-drawing.html +57 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-error-status.html +361 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-font-face.html +418 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-font-options.html +695 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-fonts.html +63 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-ft-font.html +318 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-image-surface.html +486 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-cairo-matrix-t.html → cairo-matrix.html} +137 -156
- data/cairo/share/gtk-doc/html/cairo/{cairo-Paths.html → cairo-paths.html} +275 -306
- data/cairo/share/gtk-doc/html/cairo/cairo-pattern.html +1524 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-PDF-Surfaces.html → cairo-pdf-surface.html} +60 -70
- data/cairo/share/gtk-doc/html/cairo/cairo-png-functions.html +332 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-PostScript-Surfaces.html → cairo-ps-surface.html} +131 -150
- data/cairo/share/gtk-doc/html/cairo/cairo-quartz-font.html +153 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-Quartz-Surfaces.html → cairo-quartz-surface.html} +53 -62
- data/cairo/share/gtk-doc/html/cairo/cairo-scaled-font.html +1051 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-support.html +54 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-surface.html +1064 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-surfaces.html +69 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-svg-surface.html +324 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-text.html +1264 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-Transformations.html → cairo-transformations.html} +98 -115
- data/cairo/share/gtk-doc/html/cairo/cairo-types.html +134 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-user-font.html +769 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-version-info.html +355 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-win32-font.html +366 -0
- data/cairo/share/gtk-doc/html/cairo/cairo-win32-surface.html +321 -0
- data/cairo/share/gtk-doc/html/cairo/{cairo-XLib-Surfaces.html → cairo-xlib-surface.html} +104 -121
- data/cairo/share/gtk-doc/html/cairo/cairo.devhelp +390 -405
- data/cairo/share/gtk-doc/html/cairo/cairo.devhelp2 +390 -405
- data/cairo/share/gtk-doc/html/cairo/index-1.2.html +63 -59
- data/cairo/share/gtk-doc/html/cairo/index-1.4.html +45 -41
- data/cairo/share/gtk-doc/html/cairo/index-1.6.html +29 -23
- data/cairo/share/gtk-doc/html/cairo/index-1.8.html +107 -0
- data/cairo/share/gtk-doc/html/cairo/index-all.html +759 -0
- data/cairo/share/gtk-doc/html/cairo/index.html +51 -41
- data/cairo/share/gtk-doc/html/cairo/index.sgml +478 -466
- data/cairo/share/gtk-doc/html/cairo/language-bindings.html +22 -18
- data/cairo/share/gtk-doc/html/cairo/style.css +14 -2
- data/cairo/share/man/man3/libpng.3 +443 -17
- data/cairo/share/man/man3/libpngpf.3 +618 -102
- data/cairo/share/man/man5/png.5 +1 -1
- data/cairo/src/tml/make/cairo_1.8.0-1_win32.log +1021 -0
- data/cairo/src/tml/make/cairo_1.8.0-1_win32.sh +68 -0
- data/cairo/src/tml/make/libpng_1.2.32-1_win32.log +269 -0
- data/cairo/src/tml/make/libpng_1.2.32-1_win32.sh +63 -0
- 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
- data/doc/en/cairo-context.html +81 -91
- data/doc/en/cairo-font-options.html +11 -26
- data/doc/en/cairo-text-cluster-flag.html +35 -0
- data/doc/en/cairo-user-font-face-text-to-glyphs-data.html +3 -3
- data/doc/en/cairo.html +38 -42
- data/doc/en/index.html +129 -142
- data/doc/ja/cairo-font-options.html +3 -25
- data/doc/ja/cairo-text-cluster-flag.html +46 -0
- data/doc/ja/cairo-user-font-face-text-to-glyphs-data.html +16 -15
- data/doc/ja/cairo.html +3 -7
- data/doc/ja/index.html +9 -17
- data/src/cairo.def +1 -1
- data/src/cairo.so +0 -0
- data/src/lib/cairo/constants.rb +3 -1
- data/src/libruby-cairo.a +0 -0
- data/src/rb_cairo.c +2 -2
- data/src/rb_cairo.h +5 -5
- data/src/rb_cairo_constants.c +12 -19
- data/src/rb_cairo_context.c +25 -21
- data/src/rb_cairo_font_face.c +44 -29
- data/src/rb_cairo_font_options.c +1 -23
- data/src/rb_cairo_scaled_font.c +5 -5
- data/test/test_constants.rb +6 -9
- data/test/test_context.rb +0 -12
- data/test/test_font_face.rb +7 -7
- data/test/test_font_options.rb +2 -21
- data/test/test_scaled_font.rb +3 -3
- data/test/test_text_to_glyphs_data.rb +19 -15
- metadata +68 -45
- data/cairo/make/cairo-1.6.4-2.sh +0 -55
- data/cairo/make/libpng-1.2.29.sh +0 -35
- data/cairo/manifest/cairo-1.6.4-2.mft +0 -6
- data/cairo/manifest/cairo-dev-1.6.4-2.mft +0 -72
- data/cairo/manifest/libpng-1.2.29.mft +0 -2
- data/cairo/share/gtk-doc/html/cairo/Drawing.html +0 -53
- data/cairo/share/gtk-doc/html/cairo/Fonts.html +0 -56
- data/cairo/share/gtk-doc/html/cairo/Support.html +0 -50
- data/cairo/share/gtk-doc/html/cairo/Surfaces.html +0 -65
- data/cairo/share/gtk-doc/html/cairo/cairo-Error-Handling.html +0 -328
- data/cairo/share/gtk-doc/html/cairo/cairo-Font-Options.html +0 -720
- data/cairo/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +0 -297
- data/cairo/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +0 -484
- data/cairo/share/gtk-doc/html/cairo/cairo-PNG-Support.html +0 -345
- data/cairo/share/gtk-doc/html/cairo/cairo-Patterns.html +0 -1560
- data/cairo/share/gtk-doc/html/cairo/cairo-Quartz-Fonts.html +0 -161
- data/cairo/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +0 -337
- data/cairo/share/gtk-doc/html/cairo/cairo-Scaled-Fonts.html +0 -823
- data/cairo/share/gtk-doc/html/cairo/cairo-Text.html +0 -836
- data/cairo/share/gtk-doc/html/cairo/cairo-Types.html +0 -143
- data/cairo/share/gtk-doc/html/cairo/cairo-Version-Information.html +0 -325
- data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +0 -381
- data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +0 -331
- data/cairo/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +0 -427
- data/cairo/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +0 -995
- data/cairo/share/gtk-doc/html/cairo/cairo-cairo-t.html +0 -2795
- data/cairo/share/gtk-doc/html/cairo/ix01.html +0 -693
- data/doc/en/cairo-lcd-filter.html +0 -39
- data/doc/ja/cairo-lcd-filter.html +0 -63
@@ -1,143 +0,0 @@
|
|
1
|
-
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2
|
-
<html>
|
3
|
-
<head>
|
4
|
-
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
5
|
-
<title>Types</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
|
7
|
-
<link rel="start" href="index.html" title="Cairo: A Vector Graphics Library">
|
8
|
-
<link rel="up" href="Support.html" title="Utilities">
|
9
|
-
<link rel="prev" href="cairo-Version-Information.html" title="Version Information">
|
10
|
-
<link rel="next" href="ix01.html" title="Index">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
|
12
|
-
<link rel="stylesheet" href="style.css" type="text/css">
|
13
|
-
<link rel="chapter" href="Drawing.html" title="Drawing">
|
14
|
-
<link rel="chapter" href="Fonts.html" title="Fonts">
|
15
|
-
<link rel="chapter" href="Surfaces.html" title="Surfaces">
|
16
|
-
<link rel="chapter" href="Support.html" title="Utilities">
|
17
|
-
<link rel="index" href="ix01.html" title="Index">
|
18
|
-
<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
|
19
|
-
<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
|
20
|
-
<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
|
21
|
-
<link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
|
22
|
-
</head>
|
23
|
-
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
24
|
-
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
25
|
-
<tr valign="middle">
|
26
|
-
<td><a accesskey="p" href="cairo-Version-Information.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
27
|
-
<td><a accesskey="u" href="Support.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
28
|
-
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
29
|
-
<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
|
30
|
-
<td><a accesskey="n" href="ix01.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
31
|
-
</tr>
|
32
|
-
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2595884" class="shortcut">Top</a>
|
33
|
-
 | 
|
34
|
-
<a href="#id2622120" class="shortcut">Description</a></nobr></td></tr>
|
35
|
-
</table>
|
36
|
-
<div class="refentry" lang="en">
|
37
|
-
<a name="cairo-Types"></a><div class="titlepage"></div>
|
38
|
-
<div class="refnamediv"><table width="100%"><tr>
|
39
|
-
<td valign="top">
|
40
|
-
<h2>
|
41
|
-
<a name="id2595884"></a><span class="refentrytitle">Types</span>
|
42
|
-
</h2>
|
43
|
-
<p>Types — Generic data types</p>
|
44
|
-
</td>
|
45
|
-
<td valign="top" align="right"></td>
|
46
|
-
</tr></table></div>
|
47
|
-
<div class="refsynopsisdiv">
|
48
|
-
<h2>Synopsis</h2>
|
49
|
-
<pre class="synopsis">
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
typedef <a class="link" href="cairo-Types.html#cairo-bool-t">cairo_bool_t</a>;
|
54
|
-
<a class="link" href="cairo-Types.html#cairo-user-data-key-t">cairo_user_data_key_t</a>;
|
55
|
-
void (<a class="link" href="cairo-Types.html#cairo-destroy-func-t">*cairo_destroy_func_t</a>) (void *data);
|
56
|
-
</pre>
|
57
|
-
</div>
|
58
|
-
<div class="refsect1" lang="en">
|
59
|
-
<a name="id2622120"></a><h2>Description</h2>
|
60
|
-
<p>
|
61
|
-
Generic data types used in the cairo API
|
62
|
-
</p>
|
63
|
-
</div>
|
64
|
-
<div class="refsect1" lang="en">
|
65
|
-
<a name="id2591824"></a><h2>Details</h2>
|
66
|
-
<div class="refsect2" lang="en">
|
67
|
-
<a name="id2609294"></a><h3>
|
68
|
-
<a name="cairo-bool-t"></a>cairo_bool_t</h3>
|
69
|
-
<a class="indexterm" name="id2606148"></a><pre class="programlisting">typedef int cairo_bool_t;
|
70
|
-
</pre>
|
71
|
-
<p>
|
72
|
-
<a class="link" href="cairo-Types.html#cairo-bool-t"><span class="type">cairo_bool_t</span></a> is used for boolean values. Returns of type
|
73
|
-
<a class="link" href="cairo-Types.html#cairo-bool-t"><span class="type">cairo_bool_t</span></a> will always be either 0 or 1, but testing against
|
74
|
-
these values explicitly is not encouraged; just use the
|
75
|
-
value as a boolean condition.
|
76
|
-
</p>
|
77
|
-
<p>
|
78
|
-
</p>
|
79
|
-
<div class="informalexample"><pre class="programlisting">
|
80
|
-
if (cairo_in_stroke (cr, x, y)) {
|
81
|
-
/* do something */
|
82
|
-
}
|
83
|
-
</pre></div>
|
84
|
-
<p>
|
85
|
-
|
86
|
-
</p>
|
87
|
-
</div>
|
88
|
-
<hr>
|
89
|
-
<div class="refsect2" lang="en">
|
90
|
-
<a name="id2674808"></a><h3>
|
91
|
-
<a name="cairo-user-data-key-t"></a>cairo_user_data_key_t</h3>
|
92
|
-
<a class="indexterm" name="id2674819"></a><pre class="programlisting">typedef struct {
|
93
|
-
int unused;
|
94
|
-
} cairo_user_data_key_t;
|
95
|
-
</pre>
|
96
|
-
<p>
|
97
|
-
<a class="link" href="cairo-Types.html#cairo-user-data-key-t"><span class="type">cairo_user_data_key_t</span></a> is used for attaching user data to cairo
|
98
|
-
data structures. The actual contents of the struct is never used,
|
99
|
-
and there is no need to initialize the object; only the unique
|
100
|
-
address of a <span class="type">cairo_data_key_t</span> object is used. Typically, you
|
101
|
-
would just use the address of a static <span class="type">cairo_data_key_t</span> object.</p>
|
102
|
-
<p>
|
103
|
-
|
104
|
-
</p>
|
105
|
-
<div class="variablelist"><table border="0">
|
106
|
-
<col align="left" valign="top">
|
107
|
-
<tbody><tr>
|
108
|
-
<td><p><span class="term">int <em class="structfield"><code>unused</code></em>;</span></p></td>
|
109
|
-
<td> not used; ignore.
|
110
|
-
</td>
|
111
|
-
</tr></tbody>
|
112
|
-
</table></div>
|
113
|
-
</div>
|
114
|
-
<hr>
|
115
|
-
<div class="refsect2" lang="en">
|
116
|
-
<a name="id2669954"></a><h3>
|
117
|
-
<a name="cairo-destroy-func-t"></a>cairo_destroy_func_t ()</h3>
|
118
|
-
<a class="indexterm" name="id2669965"></a><pre class="programlisting">void (*cairo_destroy_func_t) (void *data);</pre>
|
119
|
-
<p>
|
120
|
-
<a class="link" href="cairo-Types.html#cairo-destroy-func-t"><span class="type">cairo_destroy_func_t</span></a> the type of function which is called when a
|
121
|
-
data element is destroyed. It is passed the pointer to the data
|
122
|
-
element and should free any memory and resources allocated for it.</p>
|
123
|
-
<p>
|
124
|
-
|
125
|
-
</p>
|
126
|
-
<div class="variablelist"><table border="0">
|
127
|
-
<col align="left" valign="top">
|
128
|
-
<tbody><tr>
|
129
|
-
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
130
|
-
<td> The data element being destroyed.
|
131
|
-
</td>
|
132
|
-
</tr></tbody>
|
133
|
-
</table></div>
|
134
|
-
</div>
|
135
|
-
</div>
|
136
|
-
<div class="refsect1" lang="en">
|
137
|
-
<a name="id2670024"></a><div class="refsect2" lang="en"><a name="id2670025"></a></div>
|
138
|
-
<hr>
|
139
|
-
<div class="refsect2" lang="en"><a name="id2670026"></a></div>
|
140
|
-
</div>
|
141
|
-
</div>
|
142
|
-
</body>
|
143
|
-
</html>
|
@@ -1,325 +0,0 @@
|
|
1
|
-
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2
|
-
<html>
|
3
|
-
<head>
|
4
|
-
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
5
|
-
<title>Version Information</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
|
7
|
-
<link rel="start" href="index.html" title="Cairo: A Vector Graphics Library">
|
8
|
-
<link rel="up" href="Support.html" title="Utilities">
|
9
|
-
<link rel="prev" href="cairo-Error-Handling.html" title="Error handling">
|
10
|
-
<link rel="next" href="cairo-Types.html" title="Types">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
|
12
|
-
<link rel="stylesheet" href="style.css" type="text/css">
|
13
|
-
<link rel="chapter" href="Drawing.html" title="Drawing">
|
14
|
-
<link rel="chapter" href="Fonts.html" title="Fonts">
|
15
|
-
<link rel="chapter" href="Surfaces.html" title="Surfaces">
|
16
|
-
<link rel="chapter" href="Support.html" title="Utilities">
|
17
|
-
<link rel="index" href="ix01.html" title="Index">
|
18
|
-
<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
|
19
|
-
<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
|
20
|
-
<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
|
21
|
-
<link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
|
22
|
-
</head>
|
23
|
-
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
24
|
-
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
25
|
-
<tr valign="middle">
|
26
|
-
<td><a accesskey="p" href="cairo-Error-Handling.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
27
|
-
<td><a accesskey="u" href="Support.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
28
|
-
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
29
|
-
<th width="100%" align="center">Cairo: A Vector Graphics Library</th>
|
30
|
-
<td><a accesskey="n" href="cairo-Types.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
31
|
-
</tr>
|
32
|
-
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2608366" class="shortcut">Top</a>
|
33
|
-
 | 
|
34
|
-
<a href="#id2671246" class="shortcut">Description</a></nobr></td></tr>
|
35
|
-
</table>
|
36
|
-
<div class="refentry" lang="en">
|
37
|
-
<a name="cairo-Version-Information"></a><div class="titlepage"></div>
|
38
|
-
<div class="refnamediv"><table width="100%"><tr>
|
39
|
-
<td valign="top">
|
40
|
-
<h2>
|
41
|
-
<a name="id2608366"></a><span class="refentrytitle">Version Information</span>
|
42
|
-
</h2>
|
43
|
-
<p>Version Information — Compile-time and run-time version checks.</p>
|
44
|
-
</td>
|
45
|
-
<td valign="top" align="right"></td>
|
46
|
-
</tr></table></div>
|
47
|
-
<div class="refsynopsisdiv">
|
48
|
-
<h2>Synopsis</h2>
|
49
|
-
<pre class="synopsis">
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
#define <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION:CAPS">CAIRO_VERSION</a>
|
54
|
-
#define <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-MAJOR:CAPS">CAIRO_VERSION_MAJOR</a>
|
55
|
-
#define <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-MINOR:CAPS">CAIRO_VERSION_MINOR</a>
|
56
|
-
#define <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-MICRO:CAPS">CAIRO_VERSION_MICRO</a>
|
57
|
-
#define <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-STRING:CAPS">CAIRO_VERSION_STRING</a>
|
58
|
-
#define <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-ENCODE:CAPS">CAIRO_VERSION_ENCODE</a> (major, minor, micro)
|
59
|
-
int <a class="link" href="cairo-Version-Information.html#cairo-version">cairo_version</a> (void);
|
60
|
-
const char* <a class="link" href="cairo-Version-Information.html#cairo-version-string">cairo_version_string</a> (void);
|
61
|
-
</pre>
|
62
|
-
</div>
|
63
|
-
<div class="refsect1" lang="en">
|
64
|
-
<a name="id2671246"></a><h2>Description</h2>
|
65
|
-
<p>
|
66
|
-
Cairo has a three-part version number scheme. In this scheme, we use
|
67
|
-
even vs. odd numbers to distinguish fixed points in the software
|
68
|
-
vs. in-progress development, (such as from git instead of a tar file,
|
69
|
-
or as a "snapshot" tar file as opposed to a "release" tar file).
|
70
|
-
</p>
|
71
|
-
<p>
|
72
|
-
</p>
|
73
|
-
<div class="informalexample"><pre class="programlisting">
|
74
|
-
_____ Major. Always 1, until we invent a new scheme.
|
75
|
-
/ ___ Minor. Even/Odd = Release/Snapshot (tar files) or Branch/Head (git)
|
76
|
-
| / _ Micro. Even/Odd = Tar-file/git
|
77
|
-
| | /
|
78
|
-
1.0.0
|
79
|
-
</pre></div>
|
80
|
-
<p>
|
81
|
-
</p>
|
82
|
-
<p>
|
83
|
-
Here are a few examples of versions that one might see.
|
84
|
-
</p>
|
85
|
-
<div class="informalexample"><pre class="programlisting">
|
86
|
-
Releases
|
87
|
-
--------
|
88
|
-
1.0.0 - A major release
|
89
|
-
1.0.2 - A subsequent maintenance release
|
90
|
-
1.2.0 - Another major release
|
91
|
-
|
92
|
-
Snapshots
|
93
|
-
---------
|
94
|
-
1.1.2 - A snapshot (working toward the 1.2.0 release)
|
95
|
-
|
96
|
-
In-progress development (eg. from git)
|
97
|
-
--------------------------------------
|
98
|
-
1.0.1 - Development on a maintenance branch (toward 1.0.2 release)
|
99
|
-
1.1.1 - Development on head (toward 1.1.2 snapshot and 1.2.0 release)
|
100
|
-
</pre></div>
|
101
|
-
<p>
|
102
|
-
</p>
|
103
|
-
<div class="refsect2" lang="en">
|
104
|
-
<a name="id2671297"></a><h3>Compatibility</h3>
|
105
|
-
<p>
|
106
|
-
The API/ABI compatibility guarantees for various versions are as
|
107
|
-
follows. First, let's assume some cairo-using application code that is
|
108
|
-
successfully using the API/ABI "from" one version of cairo. Then let's
|
109
|
-
ask the question whether this same code can be moved "to" the API/ABI
|
110
|
-
of another version of cairo.
|
111
|
-
</p>
|
112
|
-
<p>
|
113
|
-
Moving from a release to any later version (release, snapshot,
|
114
|
-
development) is always guaranteed to provide compatibility.
|
115
|
-
</p>
|
116
|
-
<p>
|
117
|
-
Moving from a snapshot to any later version is not guaranteed to
|
118
|
-
provide compatibility, since snapshots may introduce new API that ends
|
119
|
-
up being removed before the next release.
|
120
|
-
</p>
|
121
|
-
<p>
|
122
|
-
Moving from an in-development version (odd micro component) to any
|
123
|
-
later version is not guaranteed to provide compatibility. In fact,
|
124
|
-
there's not even a guarantee that the code will even continue to work
|
125
|
-
with the same in-development version number. This is because these
|
126
|
-
numbers don't correspond to any fixed state of the software, but
|
127
|
-
rather the many states between snapshots and releases.
|
128
|
-
</p>
|
129
|
-
</div>
|
130
|
-
<hr>
|
131
|
-
<div class="refsect2" lang="en">
|
132
|
-
<a name="id2671336"></a><h3>Examining the version</h3>
|
133
|
-
<p>
|
134
|
-
Cairo provides the ability to examine the version at either
|
135
|
-
compile-time or run-time and in both a human-readable form as well as
|
136
|
-
an encoded form suitable for direct comparison. Cairo also provides a
|
137
|
-
macro (<a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-ENCODE:CAPS"><code class="function">CAIRO_VERSION_ENCODE()</code></a>) to perform the encoding.
|
138
|
-
</p>
|
139
|
-
<p>
|
140
|
-
</p>
|
141
|
-
<div class="informalexample"><pre class="programlisting">
|
142
|
-
Compile-time
|
143
|
-
------------
|
144
|
-
%CAIRO_VERSION_STRING Human-readable
|
145
|
-
%CAIRO_VERSION Encoded, suitable for comparison
|
146
|
-
|
147
|
-
Run-time
|
148
|
-
--------
|
149
|
-
cairo_version_string() Human-readable
|
150
|
-
cairo_version() Encoded, suitable for comparison
|
151
|
-
</pre></div>
|
152
|
-
<p>
|
153
|
-
</p>
|
154
|
-
<p>
|
155
|
-
For example, checking that the cairo version is greater than or equal
|
156
|
-
to 1.0.0 could be achieved at compile-time or run-time as follows:
|
157
|
-
|
158
|
-
</p>
|
159
|
-
<div class="informalexample"><pre class="programlisting">
|
160
|
-
##if %CAIRO_VERSION >= %CAIRO_VERSION_ENCODE(1, 0, 0)
|
161
|
-
printf ("Compiling with suitable cairo version: %%s\n", %CAIRO_VERSION_STRING);
|
162
|
-
##endif
|
163
|
-
|
164
|
-
if (cairo_version() >= %CAIRO_VERSION_ENCODE(1, 0, 0))
|
165
|
-
printf ("Running with suitable cairo version: %%s\n", cairo_version_string ());
|
166
|
-
</pre></div>
|
167
|
-
<p>
|
168
|
-
</p>
|
169
|
-
</div>
|
170
|
-
</div>
|
171
|
-
<div class="refsect1" lang="en">
|
172
|
-
<a name="id2670838"></a><h2>Details</h2>
|
173
|
-
<div class="refsect2" lang="en">
|
174
|
-
<a name="id2670848"></a><h3>
|
175
|
-
<a name="CAIRO-VERSION:CAPS"></a>CAIRO_VERSION</h3>
|
176
|
-
<a class="indexterm" name="id2670861"></a><pre class="programlisting">#define CAIRO_VERSION</pre>
|
177
|
-
<p>
|
178
|
-
The version of cairo available at compile-time, encoded using
|
179
|
-
<a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-ENCODE:CAPS"><code class="function">CAIRO_VERSION_ENCODE()</code></a>.
|
180
|
-
</p>
|
181
|
-
</div>
|
182
|
-
<hr>
|
183
|
-
<div class="refsect2" lang="en">
|
184
|
-
<a name="id2670886"></a><h3>
|
185
|
-
<a name="CAIRO-VERSION-MAJOR:CAPS"></a>CAIRO_VERSION_MAJOR</h3>
|
186
|
-
<a class="indexterm" name="id2670898"></a><pre class="programlisting">#define CAIRO_VERSION_MAJOR 1
|
187
|
-
</pre>
|
188
|
-
<p>
|
189
|
-
The major component of the version of cairo available at compile-time.
|
190
|
-
</p>
|
191
|
-
</div>
|
192
|
-
<hr>
|
193
|
-
<div class="refsect2" lang="en">
|
194
|
-
<a name="id2670914"></a><h3>
|
195
|
-
<a name="CAIRO-VERSION-MINOR:CAPS"></a>CAIRO_VERSION_MINOR</h3>
|
196
|
-
<a class="indexterm" name="id2670926"></a><pre class="programlisting">#define CAIRO_VERSION_MINOR 6
|
197
|
-
</pre>
|
198
|
-
<p>
|
199
|
-
The minor component of the version of cairo available at compile-time.
|
200
|
-
</p>
|
201
|
-
</div>
|
202
|
-
<hr>
|
203
|
-
<div class="refsect2" lang="en">
|
204
|
-
<a name="id2670942"></a><h3>
|
205
|
-
<a name="CAIRO-VERSION-MICRO:CAPS"></a>CAIRO_VERSION_MICRO</h3>
|
206
|
-
<a class="indexterm" name="id2669742"></a><pre class="programlisting">#define CAIRO_VERSION_MICRO 4
|
207
|
-
</pre>
|
208
|
-
<p>
|
209
|
-
The micro component of the version of cairo available at compile-time.
|
210
|
-
</p>
|
211
|
-
</div>
|
212
|
-
<hr>
|
213
|
-
<div class="refsect2" lang="en">
|
214
|
-
<a name="id2669759"></a><h3>
|
215
|
-
<a name="CAIRO-VERSION-STRING:CAPS"></a>CAIRO_VERSION_STRING</h3>
|
216
|
-
<a class="indexterm" name="id2669770"></a><pre class="programlisting">#define CAIRO_VERSION_STRING "1.6.4"
|
217
|
-
</pre>
|
218
|
-
<p>
|
219
|
-
A human-readable string literal containing the version of cairo available
|
220
|
-
at compile-time, in the form of "X.Y.Z".
|
221
|
-
</p>
|
222
|
-
</div>
|
223
|
-
<hr>
|
224
|
-
<div class="refsect2" lang="en">
|
225
|
-
<a name="id2669787"></a><h3>
|
226
|
-
<a name="CAIRO-VERSION-ENCODE:CAPS"></a>CAIRO_VERSION_ENCODE()</h3>
|
227
|
-
<a class="indexterm" name="id2669798"></a><pre class="programlisting">#define CAIRO_VERSION_ENCODE(major, minor, micro)</pre>
|
228
|
-
<p>
|
229
|
-
This macro encodes the given cairo version into an integer. The numbers
|
230
|
-
returned by <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION:CAPS"><code class="literal">CAIRO_VERSION</code></a> and <a class="link" href="cairo-Version-Information.html#cairo-version"><code class="function">cairo_version()</code></a> are encoded using this macro.
|
231
|
-
Two encoded version numbers can be compared as integers. The encoding ensures
|
232
|
-
that later versions compare greater than earlier versions.
|
233
|
-
</p>
|
234
|
-
<div class="variablelist"><table border="0">
|
235
|
-
<col align="left" valign="top">
|
236
|
-
<tbody>
|
237
|
-
<tr>
|
238
|
-
<td><p><span class="term"><em class="parameter"><code>major</code></em> :</span></p></td>
|
239
|
-
<td>the major component of the version number
|
240
|
-
</td>
|
241
|
-
</tr>
|
242
|
-
<tr>
|
243
|
-
<td><p><span class="term"><em class="parameter"><code>minor</code></em> :</span></p></td>
|
244
|
-
<td>the minor component of the version number
|
245
|
-
</td>
|
246
|
-
</tr>
|
247
|
-
<tr>
|
248
|
-
<td><p><span class="term"><em class="parameter"><code>micro</code></em> :</span></p></td>
|
249
|
-
<td>the micro component of the version number
|
250
|
-
|
251
|
-
|
252
|
-
</td>
|
253
|
-
</tr>
|
254
|
-
</tbody>
|
255
|
-
</table></div>
|
256
|
-
</div>
|
257
|
-
<hr>
|
258
|
-
<div class="refsect2" lang="en">
|
259
|
-
<a name="id2669885"></a><h3>
|
260
|
-
<a name="cairo-version"></a>cairo_version ()</h3>
|
261
|
-
<a class="indexterm" name="id2674510"></a><pre class="programlisting">int cairo_version (void);</pre>
|
262
|
-
<p>
|
263
|
-
Returns the version of the cairo library encoded in a single
|
264
|
-
integer as per <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-ENCODE:CAPS"><code class="literal">CAIRO_VERSION_ENCODE</code></a>. The encoding ensures that
|
265
|
-
later versions compare greater than earlier versions.
|
266
|
-
</p>
|
267
|
-
<p>
|
268
|
-
A run-time comparison to check that cairo's version is greater than
|
269
|
-
or equal to version X.Y.Z could be performed as follows:
|
270
|
-
</p>
|
271
|
-
<p>
|
272
|
-
</p>
|
273
|
-
<div class="informalexample"><pre class="programlisting">
|
274
|
-
if (cairo_version() >= CAIRO_VERSION_ENCODE(X,Y,Z)) {...}
|
275
|
-
</pre></div>
|
276
|
-
<p>
|
277
|
-
</p>
|
278
|
-
<p>
|
279
|
-
See also <a class="link" href="cairo-Version-Information.html#cairo-version-string"><code class="function">cairo_version_string()</code></a> as well as the compile-time
|
280
|
-
equivalents <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION:CAPS"><code class="literal">CAIRO_VERSION</code></a> and <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-STRING:CAPS"><code class="literal">CAIRO_VERSION_STRING</code></a>.</p>
|
281
|
-
<p>
|
282
|
-
|
283
|
-
</p>
|
284
|
-
<div class="variablelist"><table border="0">
|
285
|
-
<col align="left" valign="top">
|
286
|
-
<tbody><tr>
|
287
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
288
|
-
<td> the encoded version.
|
289
|
-
</td>
|
290
|
-
</tr></tbody>
|
291
|
-
</table></div>
|
292
|
-
</div>
|
293
|
-
<hr>
|
294
|
-
<div class="refsect2" lang="en">
|
295
|
-
<a name="id2674609"></a><h3>
|
296
|
-
<a name="cairo-version-string"></a>cairo_version_string ()</h3>
|
297
|
-
<a class="indexterm" name="id2674621"></a><pre class="programlisting">const char* cairo_version_string (void);</pre>
|
298
|
-
<p>
|
299
|
-
Returns the version of the cairo library as a human-readable string
|
300
|
-
of the form "X.Y.Z".
|
301
|
-
</p>
|
302
|
-
<p>
|
303
|
-
See also <a class="link" href="cairo-Version-Information.html#cairo-version"><code class="function">cairo_version()</code></a> as well as the compile-time equivalents
|
304
|
-
<a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-STRING:CAPS"><code class="literal">CAIRO_VERSION_STRING</code></a> and <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION:CAPS"><code class="literal">CAIRO_VERSION</code></a>.</p>
|
305
|
-
<p>
|
306
|
-
|
307
|
-
</p>
|
308
|
-
<div class="variablelist"><table border="0">
|
309
|
-
<col align="left" valign="top">
|
310
|
-
<tbody><tr>
|
311
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
312
|
-
<td> a string containing the version.
|
313
|
-
</td>
|
314
|
-
</tr></tbody>
|
315
|
-
</table></div>
|
316
|
-
</div>
|
317
|
-
</div>
|
318
|
-
<div class="refsect1" lang="en">
|
319
|
-
<a name="id2674696"></a><div class="refsect2" lang="en"><a name="id2674697"></a></div>
|
320
|
-
<hr>
|
321
|
-
<div class="refsect2" lang="en"><a name="id2674698"></a></div>
|
322
|
-
</div>
|
323
|
-
</div>
|
324
|
-
</body>
|
325
|
-
</html>
|