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.

Files changed (167) hide show
  1. data/ChangeLog +32 -0
  2. data/NEWS +9 -1
  3. data/README +1 -0
  4. data/Rakefile +2 -2
  5. data/cairo/DLL_FAQ.txt +397 -0
  6. data/cairo/README.txt +53 -0
  7. data/cairo/USAGE.txt +94 -0
  8. data/cairo/bin/libcairo-2.dll +0 -0
  9. data/cairo/bin/libpng12-0.dll +0 -0
  10. data/cairo/bin/zlib1.dll +0 -0
  11. data/cairo/include/cairo/cairo-deprecated.h +0 -4
  12. data/cairo/include/cairo/cairo-features.h +7 -22
  13. data/cairo/include/cairo/cairo-pdf.h +1 -1
  14. data/cairo/include/cairo/cairo-ps.h +1 -1
  15. data/cairo/include/cairo/cairo-svg.h +1 -1
  16. data/cairo/include/cairo/cairo-version.h +8 -0
  17. data/cairo/include/cairo/cairo-win32.h +9 -1
  18. data/cairo/include/cairo/cairo.h +420 -32
  19. data/cairo/include/libpng12/png.h +3592 -0
  20. data/cairo/include/libpng12/pngconf.h +1481 -0
  21. data/cairo/include/png.h +36 -13
  22. data/cairo/include/pngconf.h +3 -3
  23. data/cairo/include/zconf.h +332 -0
  24. data/cairo/include/zlib.h +1357 -0
  25. data/cairo/lib/cairo.def +22 -0
  26. data/cairo/lib/cairo.lib +0 -0
  27. data/cairo/lib/libcairo.dll.a +0 -0
  28. data/cairo/lib/libpng.def +1 -0
  29. data/cairo/lib/libpng.lib +0 -0
  30. data/cairo/lib/libpng12.dll.a +0 -0
  31. data/cairo/lib/pkgconfig/cairo-pdf.pc +5 -5
  32. data/cairo/lib/pkgconfig/cairo-png.pc +5 -5
  33. data/cairo/lib/pkgconfig/cairo-ps.pc +5 -5
  34. data/cairo/lib/pkgconfig/cairo-svg.pc +4 -4
  35. data/cairo/lib/pkgconfig/cairo-win32-font.pc +4 -4
  36. data/cairo/lib/pkgconfig/cairo-win32.pc +4 -4
  37. data/cairo/lib/pkgconfig/cairo.pc +4 -4
  38. data/cairo/lib/pkgconfig/libpng.pc +3 -2
  39. data/cairo/lib/pkgconfig/libpng12.pc +3 -2
  40. data/cairo/lib/zdll.exp +0 -0
  41. data/cairo/lib/zdll.lib +0 -0
  42. data/cairo/lib/zlib.def +60 -0
  43. data/cairo/manifest/cairo-dev_1.8.0-1_win32.mft +76 -0
  44. data/cairo/manifest/cairo_1.8.0-1_win32.mft +5 -0
  45. data/cairo/manifest/{libpng-dev-1.2.29.mft → libpng-dev_1.2.32-1_win32.mft} +5 -2
  46. data/cairo/manifest/libpng_1.2.32-1_win32.mft +2 -0
  47. data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING +0 -0
  48. data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING-LGPL-2.1 +0 -0
  49. data/cairo/share/doc/{cairo-1.6.4-2 → cairo_1.8.0-1_win32}/COPYING-MPL-1.1 +0 -0
  50. data/cairo/share/gtk-doc/html/cairo/bindings-errors.html +15 -11
  51. data/cairo/share/gtk-doc/html/cairo/bindings-fonts.html +15 -11
  52. data/cairo/share/gtk-doc/html/cairo/bindings-memory.html +20 -16
  53. data/cairo/share/gtk-doc/html/cairo/bindings-overloading.html +16 -12
  54. data/cairo/share/gtk-doc/html/cairo/bindings-path.html +17 -13
  55. data/cairo/share/gtk-doc/html/cairo/bindings-patterns.html +25 -21
  56. data/cairo/share/gtk-doc/html/cairo/bindings-return-values.html +17 -13
  57. data/cairo/share/gtk-doc/html/cairo/bindings-streams.html +14 -10
  58. data/cairo/share/gtk-doc/html/cairo/bindings-surfaces.html +19 -15
  59. data/cairo/share/gtk-doc/html/cairo/cairo-context.html +2721 -0
  60. data/cairo/share/gtk-doc/html/cairo/cairo-drawing.html +57 -0
  61. data/cairo/share/gtk-doc/html/cairo/cairo-error-status.html +361 -0
  62. data/cairo/share/gtk-doc/html/cairo/cairo-font-face.html +418 -0
  63. data/cairo/share/gtk-doc/html/cairo/cairo-font-options.html +695 -0
  64. data/cairo/share/gtk-doc/html/cairo/cairo-fonts.html +63 -0
  65. data/cairo/share/gtk-doc/html/cairo/cairo-ft-font.html +318 -0
  66. data/cairo/share/gtk-doc/html/cairo/cairo-image-surface.html +486 -0
  67. data/cairo/share/gtk-doc/html/cairo/{cairo-cairo-matrix-t.html → cairo-matrix.html} +137 -156
  68. data/cairo/share/gtk-doc/html/cairo/{cairo-Paths.html → cairo-paths.html} +275 -306
  69. data/cairo/share/gtk-doc/html/cairo/cairo-pattern.html +1524 -0
  70. data/cairo/share/gtk-doc/html/cairo/{cairo-PDF-Surfaces.html → cairo-pdf-surface.html} +60 -70
  71. data/cairo/share/gtk-doc/html/cairo/cairo-png-functions.html +332 -0
  72. data/cairo/share/gtk-doc/html/cairo/{cairo-PostScript-Surfaces.html → cairo-ps-surface.html} +131 -150
  73. data/cairo/share/gtk-doc/html/cairo/cairo-quartz-font.html +153 -0
  74. data/cairo/share/gtk-doc/html/cairo/{cairo-Quartz-Surfaces.html → cairo-quartz-surface.html} +53 -62
  75. data/cairo/share/gtk-doc/html/cairo/cairo-scaled-font.html +1051 -0
  76. data/cairo/share/gtk-doc/html/cairo/cairo-support.html +54 -0
  77. data/cairo/share/gtk-doc/html/cairo/cairo-surface.html +1064 -0
  78. data/cairo/share/gtk-doc/html/cairo/cairo-surfaces.html +69 -0
  79. data/cairo/share/gtk-doc/html/cairo/cairo-svg-surface.html +324 -0
  80. data/cairo/share/gtk-doc/html/cairo/cairo-text.html +1264 -0
  81. data/cairo/share/gtk-doc/html/cairo/{cairo-Transformations.html → cairo-transformations.html} +98 -115
  82. data/cairo/share/gtk-doc/html/cairo/cairo-types.html +134 -0
  83. data/cairo/share/gtk-doc/html/cairo/cairo-user-font.html +769 -0
  84. data/cairo/share/gtk-doc/html/cairo/cairo-version-info.html +355 -0
  85. data/cairo/share/gtk-doc/html/cairo/cairo-win32-font.html +366 -0
  86. data/cairo/share/gtk-doc/html/cairo/cairo-win32-surface.html +321 -0
  87. data/cairo/share/gtk-doc/html/cairo/{cairo-XLib-Surfaces.html → cairo-xlib-surface.html} +104 -121
  88. data/cairo/share/gtk-doc/html/cairo/cairo.devhelp +390 -405
  89. data/cairo/share/gtk-doc/html/cairo/cairo.devhelp2 +390 -405
  90. data/cairo/share/gtk-doc/html/cairo/index-1.2.html +63 -59
  91. data/cairo/share/gtk-doc/html/cairo/index-1.4.html +45 -41
  92. data/cairo/share/gtk-doc/html/cairo/index-1.6.html +29 -23
  93. data/cairo/share/gtk-doc/html/cairo/index-1.8.html +107 -0
  94. data/cairo/share/gtk-doc/html/cairo/index-all.html +759 -0
  95. data/cairo/share/gtk-doc/html/cairo/index.html +51 -41
  96. data/cairo/share/gtk-doc/html/cairo/index.sgml +478 -466
  97. data/cairo/share/gtk-doc/html/cairo/language-bindings.html +22 -18
  98. data/cairo/share/gtk-doc/html/cairo/style.css +14 -2
  99. data/cairo/share/man/man3/libpng.3 +443 -17
  100. data/cairo/share/man/man3/libpngpf.3 +618 -102
  101. data/cairo/share/man/man5/png.5 +1 -1
  102. data/cairo/src/tml/make/cairo_1.8.0-1_win32.log +1021 -0
  103. data/cairo/src/tml/make/cairo_1.8.0-1_win32.sh +68 -0
  104. data/cairo/src/tml/make/libpng_1.2.32-1_win32.log +269 -0
  105. data/cairo/src/tml/make/libpng_1.2.32-1_win32.sh +63 -0
  106. data/cairo/test/example_d.exe +0 -0
  107. data/cairo/test/minigzip_d.exe +0 -0
  108. data/cairo/test/testzlib_d.exe +0 -0
  109. data/cairo/test/untgz_d.exe +0 -0
  110. data/doc/en/cairo-context.html +81 -91
  111. data/doc/en/cairo-font-options.html +11 -26
  112. data/doc/en/cairo-text-cluster-flag.html +35 -0
  113. data/doc/en/cairo-user-font-face-text-to-glyphs-data.html +3 -3
  114. data/doc/en/cairo.html +38 -42
  115. data/doc/en/index.html +129 -142
  116. data/doc/ja/cairo-font-options.html +3 -25
  117. data/doc/ja/cairo-text-cluster-flag.html +46 -0
  118. data/doc/ja/cairo-user-font-face-text-to-glyphs-data.html +16 -15
  119. data/doc/ja/cairo.html +3 -7
  120. data/doc/ja/index.html +9 -17
  121. data/src/cairo.def +1 -1
  122. data/src/cairo.so +0 -0
  123. data/src/lib/cairo/constants.rb +3 -1
  124. data/src/libruby-cairo.a +0 -0
  125. data/src/rb_cairo.c +2 -2
  126. data/src/rb_cairo.h +5 -5
  127. data/src/rb_cairo_constants.c +12 -19
  128. data/src/rb_cairo_context.c +25 -21
  129. data/src/rb_cairo_font_face.c +44 -29
  130. data/src/rb_cairo_font_options.c +1 -23
  131. data/src/rb_cairo_scaled_font.c +5 -5
  132. data/test/test_constants.rb +6 -9
  133. data/test/test_context.rb +0 -12
  134. data/test/test_font_face.rb +7 -7
  135. data/test/test_font_options.rb +2 -21
  136. data/test/test_scaled_font.rb +3 -3
  137. data/test/test_text_to_glyphs_data.rb +19 -15
  138. metadata +68 -45
  139. data/cairo/make/cairo-1.6.4-2.sh +0 -55
  140. data/cairo/make/libpng-1.2.29.sh +0 -35
  141. data/cairo/manifest/cairo-1.6.4-2.mft +0 -6
  142. data/cairo/manifest/cairo-dev-1.6.4-2.mft +0 -72
  143. data/cairo/manifest/libpng-1.2.29.mft +0 -2
  144. data/cairo/share/gtk-doc/html/cairo/Drawing.html +0 -53
  145. data/cairo/share/gtk-doc/html/cairo/Fonts.html +0 -56
  146. data/cairo/share/gtk-doc/html/cairo/Support.html +0 -50
  147. data/cairo/share/gtk-doc/html/cairo/Surfaces.html +0 -65
  148. data/cairo/share/gtk-doc/html/cairo/cairo-Error-Handling.html +0 -328
  149. data/cairo/share/gtk-doc/html/cairo/cairo-Font-Options.html +0 -720
  150. data/cairo/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +0 -297
  151. data/cairo/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +0 -484
  152. data/cairo/share/gtk-doc/html/cairo/cairo-PNG-Support.html +0 -345
  153. data/cairo/share/gtk-doc/html/cairo/cairo-Patterns.html +0 -1560
  154. data/cairo/share/gtk-doc/html/cairo/cairo-Quartz-Fonts.html +0 -161
  155. data/cairo/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +0 -337
  156. data/cairo/share/gtk-doc/html/cairo/cairo-Scaled-Fonts.html +0 -823
  157. data/cairo/share/gtk-doc/html/cairo/cairo-Text.html +0 -836
  158. data/cairo/share/gtk-doc/html/cairo/cairo-Types.html +0 -143
  159. data/cairo/share/gtk-doc/html/cairo/cairo-Version-Information.html +0 -325
  160. data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +0 -381
  161. data/cairo/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +0 -331
  162. data/cairo/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +0 -427
  163. data/cairo/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +0 -995
  164. data/cairo/share/gtk-doc/html/cairo/cairo-cairo-t.html +0 -2795
  165. data/cairo/share/gtk-doc/html/cairo/ix01.html +0 -693
  166. data/doc/en/cairo-lcd-filter.html +0 -39
  167. 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&#160;A.&#160;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
- &#160;|&#160;
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 &#8212; 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&#160;<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>&#160;:</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&#160;A.&#160;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
- &#160;|&#160;
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 &#8212; 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 &gt;= %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() &gt;= %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>&#160;:</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>&#160;:</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>&#160;:</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() &gt;= 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>&#160;:</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>&#160;:</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>