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.

Files changed (117) hide show
  1. data/ChangeLog +25 -0
  2. data/NEWS +8 -0
  3. data/Rakefile +5 -32
  4. data/cairo/bin/libcairo-2.dll +0 -0
  5. data/cairo/bin/libpng12-0.dll +0 -0
  6. data/cairo/include/cairo/cairo-features.h +1 -1
  7. data/cairo/include/cairo/cairo-ft.h +75 -0
  8. data/cairo/include/cairo/cairo-version.h +1 -1
  9. data/cairo/include/cairo/cairo.h +16 -21
  10. data/cairo/include/libpng12/png.h +251 -121
  11. data/cairo/include/libpng12/pngconf.h +83 -56
  12. data/cairo/include/png.h +251 -121
  13. data/cairo/include/pngconf.h +83 -56
  14. data/cairo/lib/cairo.def +5 -0
  15. data/cairo/lib/cairo.lib +0 -0
  16. data/cairo/lib/libcairo.dll.a +0 -0
  17. data/cairo/lib/libpng.def +3 -0
  18. data/cairo/lib/libpng.lib +0 -0
  19. data/cairo/lib/libpng12.dll.a +0 -0
  20. data/cairo/lib/pkgconfig/cairo-ft.pc +12 -0
  21. data/cairo/lib/pkgconfig/cairo-pdf.pc +2 -2
  22. data/cairo/lib/pkgconfig/cairo-png.pc +2 -2
  23. data/cairo/lib/pkgconfig/cairo-ps.pc +2 -2
  24. data/cairo/lib/pkgconfig/cairo-svg.pc +2 -2
  25. data/cairo/lib/pkgconfig/cairo-win32-font.pc +2 -2
  26. data/cairo/lib/pkgconfig/cairo-win32.pc +2 -2
  27. data/cairo/lib/pkgconfig/cairo.pc +4 -4
  28. data/cairo/lib/pkgconfig/libpng.pc +2 -2
  29. data/cairo/lib/pkgconfig/libpng12.pc +2 -2
  30. data/cairo/manifest/{cairo-dev_1.8.0-1_win32.mft → cairo-dev_1.8.8-2_win32.mft} +5 -3
  31. data/cairo/manifest/cairo_1.8.8-2_win32.mft +5 -0
  32. data/cairo/manifest/{libpng-dev_1.2.32-1_win32.mft → libpng-dev_1.2.39-1_win32.mft} +3 -3
  33. data/cairo/manifest/libpng_1.2.39-1_win32.mft +2 -0
  34. data/cairo/share/doc/{cairo_1.8.0-1_win32 → cairo_1.8.8-2_win32}/COPYING +0 -0
  35. data/cairo/share/doc/{cairo_1.8.0-1_win32 → cairo_1.8.8-2_win32}/COPYING-LGPL-2.1 +0 -0
  36. data/cairo/share/doc/{cairo_1.8.0-1_win32 → cairo_1.8.8-2_win32}/COPYING-MPL-1.1 +0 -0
  37. data/cairo/share/gtk-doc/html/cairo/bindings-errors.html +9 -9
  38. data/cairo/share/gtk-doc/html/cairo/bindings-fonts.html +5 -5
  39. data/cairo/share/gtk-doc/html/cairo/bindings-memory.html +8 -8
  40. data/cairo/share/gtk-doc/html/cairo/bindings-overloading.html +5 -5
  41. data/cairo/share/gtk-doc/html/cairo/bindings-path.html +5 -5
  42. data/cairo/share/gtk-doc/html/cairo/bindings-patterns.html +6 -6
  43. data/cairo/share/gtk-doc/html/cairo/bindings-return-values.html +5 -5
  44. data/cairo/share/gtk-doc/html/cairo/bindings-streams.html +5 -5
  45. data/cairo/share/gtk-doc/html/cairo/bindings-surfaces.html +5 -5
  46. data/cairo/share/gtk-doc/html/cairo/cairo-context.html +200 -262
  47. data/cairo/share/gtk-doc/html/cairo/cairo-drawing.html +5 -5
  48. data/cairo/share/gtk-doc/html/cairo/cairo-error-status.html +61 -60
  49. data/cairo/share/gtk-doc/html/cairo/cairo-font-face.html +51 -53
  50. data/cairo/share/gtk-doc/html/cairo/cairo-font-options.html +65 -78
  51. data/cairo/share/gtk-doc/html/cairo/cairo-fonts.html +5 -5
  52. data/cairo/share/gtk-doc/html/cairo/cairo-ft-font.html +37 -34
  53. data/cairo/share/gtk-doc/html/cairo/cairo-image-surface.html +49 -60
  54. data/cairo/share/gtk-doc/html/cairo/cairo-matrix.html +30 -41
  55. data/cairo/share/gtk-doc/html/cairo/cairo-paths.html +72 -97
  56. data/cairo/share/gtk-doc/html/cairo/cairo-pattern.html +184 -175
  57. data/cairo/share/gtk-doc/html/cairo/cairo-pdf-surface.html +40 -34
  58. data/cairo/share/gtk-doc/html/cairo/cairo-png-functions.html +57 -48
  59. data/cairo/share/gtk-doc/html/cairo/cairo-ps-surface.html +73 -76
  60. data/cairo/share/gtk-doc/html/cairo/cairo-quartz-font.html +27 -30
  61. data/cairo/share/gtk-doc/html/cairo/cairo-quartz-surface.html +29 -34
  62. data/cairo/share/gtk-doc/html/cairo/cairo-scaled-font.html +102 -106
  63. data/cairo/share/gtk-doc/html/cairo/cairo-support.html +5 -5
  64. data/cairo/share/gtk-doc/html/cairo/cairo-surface.html +101 -127
  65. data/cairo/share/gtk-doc/html/cairo/cairo-surfaces.html +5 -5
  66. data/cairo/share/gtk-doc/html/cairo/cairo-svg-surface.html +52 -49
  67. data/cairo/share/gtk-doc/html/cairo/cairo-text.html +126 -146
  68. data/cairo/share/gtk-doc/html/cairo/cairo-transformations.html +26 -35
  69. data/cairo/share/gtk-doc/html/cairo/cairo-types.html +16 -17
  70. data/cairo/share/gtk-doc/html/cairo/cairo-user-font.html +121 -127
  71. data/cairo/share/gtk-doc/html/cairo/cairo-version-info.html +50 -60
  72. data/cairo/share/gtk-doc/html/cairo/cairo-win32-font.html +37 -46
  73. data/cairo/share/gtk-doc/html/cairo/cairo-win32-surface.html +58 -58
  74. data/cairo/share/gtk-doc/html/cairo/cairo-xlib-surface.html +47 -63
  75. data/cairo/share/gtk-doc/html/cairo/cairo.devhelp +21 -21
  76. data/cairo/share/gtk-doc/html/cairo/cairo.devhelp2 +21 -21
  77. data/cairo/share/gtk-doc/html/cairo/index-1.2.html +5 -5
  78. data/cairo/share/gtk-doc/html/cairo/index-1.4.html +5 -5
  79. data/cairo/share/gtk-doc/html/cairo/index-1.6.html +5 -5
  80. data/cairo/share/gtk-doc/html/cairo/index-1.8.html +8 -8
  81. data/cairo/share/gtk-doc/html/cairo/index-all.html +24 -24
  82. data/cairo/share/gtk-doc/html/cairo/index.html +6 -6
  83. data/cairo/share/gtk-doc/html/cairo/index.sgml +19 -19
  84. data/cairo/share/gtk-doc/html/cairo/language-bindings.html +6 -6
  85. data/cairo/share/gtk-doc/html/cairo/style.css +8 -1
  86. data/cairo/share/man/man3/libpng.3 +299 -59
  87. data/cairo/share/man/man3/libpngpf.3 +2 -2
  88. data/cairo/share/man/man5/png.5 +1 -1
  89. data/cairo/src/tml/packaging/cairo_1.8.8-2_win32.log +949 -0
  90. data/cairo/src/tml/{make/cairo_1.8.0-1_win32.sh → packaging/cairo_1.8.8-2_win32.sh} +6 -6
  91. data/cairo/src/tml/{make/libpng_1.2.32-1_win32.log → packaging/libpng_1.2.39-1_win32.log} +74 -73
  92. data/cairo/src/tml/{make/libpng_1.2.32-1_win32.sh → packaging/libpng_1.2.39-1_win32.sh} +4 -4
  93. data/doc/ja/cairo-context.html +1 -1
  94. data/doc/ja/index.html +0 -3
  95. data/extconf.rb +1 -0
  96. data/pkg-config.rb +4 -0
  97. data/src/cairo.so +0 -0
  98. data/src/libruby-cairo.a +0 -0
  99. data/src/rb_cairo.c +2 -2
  100. data/src/rb_cairo_surface.c +6 -2
  101. metadata +20 -50
  102. data/cairo/DLL_FAQ.txt +0 -397
  103. data/cairo/README.txt +0 -53
  104. data/cairo/USAGE.txt +0 -94
  105. data/cairo/bin/zlib1.dll +0 -0
  106. data/cairo/include/zconf.h +0 -332
  107. data/cairo/include/zlib.h +0 -1357
  108. data/cairo/lib/zdll.exp +0 -0
  109. data/cairo/lib/zdll.lib +0 -0
  110. data/cairo/lib/zlib.def +0 -60
  111. data/cairo/manifest/cairo_1.8.0-1_win32.mft +0 -5
  112. data/cairo/manifest/libpng_1.2.32-1_win32.mft +0 -2
  113. data/cairo/src/tml/make/cairo_1.8.0-1_win32.log +0 -1021
  114. data/cairo/test/example_d.exe +0 -0
  115. data/cairo/test/minigzip_d.exe +0 -0
  116. data/cairo/test/testzlib_d.exe +0 -0
  117. data/cairo/test/untgz_d.exe +0 -0
data/cairo/share/gtk-doc/html/cairo/cairo-pdf-surface.html CHANGED
@@ -3,12 +3,12 @@
3
3
  <head>
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <title>PDF Surfaces</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">
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-image-surface.html" title="Image Surfaces">
10
10
  <link rel="next" href="cairo-png-functions.html" title="PNG Support">
11
- <meta name="generator" content="GTK-Doc V1.10 (XML mode)">
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-png-functions.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"><nobr><a href="#cairo-pdf-surface.synopsis" class="shortcut">Top</a>
34
-  | 
35
- <a href="#cairo-pdf-surface.description" class="shortcut">Description</a></nobr></td></tr>
33
+ <tr><td colspan="5" class="shortcuts">
34
+ <a href="#cairo-pdf-surface.synopsis" class="shortcut">Top</a>
35
+  | 
36
+ <a href="#cairo-pdf-surface.description" class="shortcut">Description</a>
37
+ </td></tr>
36
38
  </table>
37
- <div class="refentry" lang="en">
39
+ <div class="refentry" title="PDF Surfaces">
38
40
  <a name="cairo-pdf-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-pdf-surface.synopsis"></a><h2>Synopsis</h2>
48
50
  <pre class="synopsis">
49
- #define <a class="link" href="cairo-pdf-surface.html#CAIRO-HAS-PDF-SURFACE:CAPS" title="CAIRO_HAS_PDF_SURFACE">CAIRO_HAS_PDF_SURFACE</a>
50
- <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* <a class="link" href="cairo-pdf-surface.html#cairo-pdf-surface-create" title="cairo_pdf_surface_create ()">cairo_pdf_surface_create</a> (const char *filename,
51
+ #define <a class="link" href="cairo-pdf-surface.html#CAIRO-HAS-PDF-SURFACE--CAPS" title="CAIRO_HAS_PDF_SURFACE">CAIRO_HAS_PDF_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-pdf-surface.html#cairo-pdf-surface-create" title="cairo_pdf_surface_create ()">cairo_pdf_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>* <a class="link" href="cairo-pdf-surface.html#cairo-pdf-surface-create-for-stream" title="cairo_pdf_surface_create_for_stream ()">cairo_pdf_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,
55
+ <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * <a class="link" href="cairo-pdf-surface.html#cairo-pdf-surface-create-for-stream" title="cairo_pdf_surface_create_for_stream ()">cairo_pdf_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);
@@ -59,17 +61,17 @@ void <a class="link" href="cairo-pdf-surface.html#cairo-pdf-surfa
59
61
  double height_in_points);
60
62
  </pre>
61
63
  </div>
62
- <div class="refsect1" lang="en">
64
+ <div class="refsect1" title="Description">
63
65
  <a name="cairo-pdf-surface.description"></a><h2>Description</h2>
64
66
  <p>
65
67
  The PDF surface is used to render cairo graphics to Adobe
66
68
  PDF files and is a multi-page vector surface backend.
67
69
  </p>
68
70
  </div>
69
- <div class="refsect1" lang="en">
71
+ <div class="refsect1" title="Details">
70
72
  <a name="cairo-pdf-surface.details"></a><h2>Details</h2>
71
- <div class="refsect2" lang="en">
72
- <a name="CAIRO-HAS-PDF-SURFACE:CAPS"></a><h3>CAIRO_HAS_PDF_SURFACE</h3>
73
+ <div class="refsect2" title="CAIRO_HAS_PDF_SURFACE">
74
+ <a name="CAIRO-HAS-PDF-SURFACE--CAPS"></a><h3>CAIRO_HAS_PDF_SURFACE</h3>
73
75
  <pre class="programlisting">#define CAIRO_HAS_PDF_SURFACE 1
74
76
  </pre>
75
77
  <p>
@@ -78,23 +80,27 @@ This macro can be used to conditionally compile backend-specific code.
78
80
  </p>
79
81
  </div>
80
82
  <hr>
81
- <div class="refsect2" lang="en">
83
+ <div class="refsect2" title="cairo_pdf_surface_create ()">
82
84
  <a name="cairo-pdf-surface-create"></a><h3>cairo_pdf_surface_create ()</h3>
83
- <pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* cairo_pdf_surface_create (const char *filename,
85
+ <pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * cairo_pdf_surface_create (const char *filename,
84
86
  double width_in_points,
85
87
  double height_in_points);</pre>
86
88
  <p>
87
89
  Creates a PDF surface of the specified size in points to be written
88
90
  to <em class="parameter"><code>filename</code></em>.</p>
89
91
  <p>
90
-
91
92
  </p>
92
93
  <div class="variablelist"><table border="0">
93
94
  <col align="left" valign="top">
94
95
  <tbody>
95
96
  <tr>
96
97
  <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
97
- <td> a filename for the PDF output (must be writable)
98
+ <td> a filename for the PDF output (must be writable), <a
99
+ href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
100
+ ><code class="literal">NULL</code></a> may be
101
+ used to specify no output. This will generate a PDF surface that
102
+ may be queried and used as a source, without generating a
103
+ temporary file.
98
104
  </td>
99
105
  </tr>
100
106
  <tr>
@@ -121,13 +127,12 @@ occurs. You can use <a class="link" href="cairo-surface.html#cairo-surface-statu
121
127
  </tr>
122
128
  </tbody>
123
129
  </table></div>
124
- <p class="since">Since 1.2
125
- </p>
130
+ <p class="since">Since 1.2</p>
126
131
  </div>
127
132
  <hr>
128
- <div class="refsect2" lang="en">
133
+ <div class="refsect2" title="cairo_pdf_surface_create_for_stream ()">
129
134
  <a name="cairo-pdf-surface-create-for-stream"></a><h3>cairo_pdf_surface_create_for_stream ()</h3>
130
- <pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* cairo_pdf_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
+ <pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * cairo_pdf_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,
131
136
  void *closure,
132
137
  double width_in_points,
133
138
  double height_in_points);</pre>
@@ -135,14 +140,18 @@ occurs. You can use <a class="link" href="cairo-surface.html#cairo-surface-statu
135
140
  Creates a PDF surface of the specified size in points to be written
136
141
  incrementally to the stream represented by <em class="parameter"><code>write_func</code></em> and <em class="parameter"><code>closure</code></em>.</p>
137
142
  <p>
138
-
139
143
  </p>
140
144
  <div class="variablelist"><table border="0">
141
145
  <col align="left" valign="top">
142
146
  <tbody>
143
147
  <tr>
144
148
  <td><p><span class="term"><em class="parameter"><code>write_func</code></em> :</span></p></td>
145
- <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
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, may be <a
150
+ href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
151
+ ><code class="literal">NULL</code></a>
152
+ 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>,
153
+ the surface may be queried or used as a source without
154
+ generating any temporary files.
146
155
  </td>
147
156
  </tr>
148
157
  <tr>
@@ -174,11 +183,10 @@ occurs. You can use <a class="link" href="cairo-surface.html#cairo-surface-statu
174
183
  </tr>
175
184
  </tbody>
176
185
  </table></div>
177
- <p class="since">Since 1.2
178
- </p>
186
+ <p class="since">Since 1.2</p>
179
187
  </div>
180
188
  <hr>
181
- <div class="refsect2" lang="en">
189
+ <div class="refsect2" title="cairo_pdf_surface_set_size ()">
182
190
  <a name="cairo-pdf-surface-set-size"></a><h3>cairo_pdf_surface_set_size ()</h3>
183
191
  <pre class="programlisting">void cairo_pdf_surface_set_size (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
184
192
  double width_in_points,
@@ -194,7 +202,6 @@ this is to call this function immediately after creating the
194
202
  surface or immediately after completing a page with either
195
203
  <a class="link" href="cairo-context.html#cairo-show-page" title="cairo_show_page ()"><code class="function">cairo_show_page()</code></a> or <a class="link" href="cairo-context.html#cairo-copy-page" title="cairo_copy_page ()"><code class="function">cairo_copy_page()</code></a>.</p>
196
204
  <p>
197
-
198
205
  </p>
199
206
  <div class="variablelist"><table border="0">
200
207
  <col align="left" valign="top">
@@ -216,21 +223,20 @@ surface or immediately after completing a page with either
216
223
  </tr>
217
224
  </tbody>
218
225
  </table></div>
219
- <p class="since">Since 1.2
220
- </p>
226
+ <p class="since">Since 1.2</p>
221
227
  </div>
222
228
  </div>
223
- <div class="refsect1" lang="en">
229
+ <div class="refsect1" title="See Also">
224
230
  <a name="cairo-pdf-surface.see-also"></a><h2>See Also</h2>
225
231
  <p>
226
232
  </p>
227
- <div class="itemizedlist"><ul type="disc"><li><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></li></ul></div>
233
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></li></ul></div>
228
234
  <p>
229
235
  </p>
230
236
  </div>
231
237
  </div>
232
238
  <div class="footer">
233
239
  <hr>
234
- Generated by GTK-Doc V1.10</div>
240
+ Generated by GTK-Doc V1.11</div>
235
241
  </body>
236
242
  </html>
data/cairo/share/gtk-doc/html/cairo/cairo-png-functions.html CHANGED
@@ -3,12 +3,12 @@
3
3
  <head>
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <title>PNG Support</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">
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-pdf-surface.html" title="PDF Surfaces">
10
10
  <link rel="next" href="cairo-ps-surface.html" title="PostScript Surfaces">
11
- <meta name="generator" content="GTK-Doc V1.10 (XML mode)">
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-ps-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"><nobr><a href="#cairo-png-functions.synopsis" class="shortcut">Top</a>
34
-  | 
35
- <a href="#cairo-png-functions.description" class="shortcut">Description</a></nobr></td></tr>
33
+ <tr><td colspan="5" class="shortcuts">
34
+ <a href="#cairo-png-functions.synopsis" class="shortcut">Top</a>
35
+  | 
36
+ <a href="#cairo-png-functions.description" class="shortcut">Description</a>
37
+ </td></tr>
36
38
  </table>
37
- <div class="refentry" lang="en">
39
+ <div class="refentry" title="PNG Support">
38
40
  <a name="cairo-png-functions"></a><div class="titlepage"></div>
39
41
  <div class="refnamediv"><table width="100%"><tr>
40
42
  <td valign="top">
@@ -43,15 +45,15 @@
43
45
  </td>
44
46
  <td valign="top" align="right"></td>
45
47
  </tr></table></div>
46
- <div class="refsynopsisdiv">
48
+ <div class="refsynopsisdiv" title="Synopsis">
47
49
  <a name="cairo-png-functions.synopsis"></a><h2>Synopsis</h2>
48
50
  <pre class="synopsis">
49
- #define <a class="link" href="cairo-png-functions.html#CAIRO-HAS-PNG-FUNCTIONS:CAPS" title="CAIRO_HAS_PNG_FUNCTIONS">CAIRO_HAS_PNG_FUNCTIONS</a>
50
- <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* <a class="link" href="cairo-png-functions.html#cairo-image-surface-create-from-png" title="cairo_image_surface_create_from_png ()">cairo_image_surface_create_from_png</a> (const char *filename);
51
+ #define <a class="link" href="cairo-png-functions.html#CAIRO-HAS-PNG-FUNCTIONS--CAPS" title="CAIRO_HAS_PNG_FUNCTIONS">CAIRO_HAS_PNG_FUNCTIONS</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-png-functions.html#cairo-image-surface-create-from-png" title="cairo_image_surface_create_from_png ()">cairo_image_surface_create_from_png</a> (const char *filename);
51
53
  <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> (<a class="link" href="cairo-png-functions.html#cairo-read-func-t" title="cairo_read_func_t ()">*cairo_read_func_t</a>) (void *closure,
52
54
  unsigned char *data,
53
55
  unsigned int length);
54
- <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* <a class="link" href="cairo-png-functions.html#cairo-image-surface-create-from-png-stream" title="cairo_image_surface_create_from_png_stream ()">cairo_image_surface_create_from_png_stream</a>
56
+ <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * <a class="link" href="cairo-png-functions.html#cairo-image-surface-create-from-png-stream" title="cairo_image_surface_create_from_png_stream ()">cairo_image_surface_create_from_png_stream</a>
55
57
  (<a class="link" href="cairo-png-functions.html#cairo-read-func-t" title="cairo_read_func_t ()">cairo_read_func_t</a> read_func,
56
58
  void *closure);
57
59
  <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-png-functions.html#cairo-surface-write-to-png" title="cairo_surface_write_to_png ()">cairo_surface_write_to_png</a> (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
@@ -64,17 +66,17 @@
64
66
  void *closure);
65
67
  </pre>
66
68
  </div>
67
- <div class="refsect1" lang="en">
69
+ <div class="refsect1" title="Description">
68
70
  <a name="cairo-png-functions.description"></a><h2>Description</h2>
69
71
  <p>
70
72
  The PNG functions allow reading PNG images into image surfaces, and writing
71
73
  any surface to a PNG file.
72
74
  </p>
73
75
  </div>
74
- <div class="refsect1" lang="en">
76
+ <div class="refsect1" title="Details">
75
77
  <a name="cairo-png-functions.details"></a><h2>Details</h2>
76
- <div class="refsect2" lang="en">
77
- <a name="CAIRO-HAS-PNG-FUNCTIONS:CAPS"></a><h3>CAIRO_HAS_PNG_FUNCTIONS</h3>
78
+ <div class="refsect2" title="CAIRO_HAS_PNG_FUNCTIONS">
79
+ <a name="CAIRO-HAS-PNG-FUNCTIONS--CAPS"></a><h3>CAIRO_HAS_PNG_FUNCTIONS</h3>
78
80
  <pre class="programlisting">#define CAIRO_HAS_PNG_FUNCTIONS 1
79
81
  </pre>
80
82
  <p>
@@ -84,14 +86,13 @@ PNG functions.
84
86
  </p>
85
87
  </div>
86
88
  <hr>
87
- <div class="refsect2" lang="en">
89
+ <div class="refsect2" title="cairo_image_surface_create_from_png ()">
88
90
  <a name="cairo-image-surface-create-from-png"></a><h3>cairo_image_surface_create_from_png ()</h3>
89
- <pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* cairo_image_surface_create_from_png (const char *filename);</pre>
91
+ <pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * cairo_image_surface_create_from_png (const char *filename);</pre>
90
92
  <p>
91
93
  Creates a new image surface and initializes the contents to the
92
94
  given PNG file.</p>
93
95
  <p>
94
-
95
96
  </p>
96
97
  <div class="variablelist"><table border="0">
97
98
  <col align="left" valign="top">
@@ -108,16 +109,20 @@ of the PNG file, or a "nil" surface if any error occurred. A nil
108
109
  surface can be checked for with cairo_surface_status(surface) which
109
110
  may return one of the following values:
110
111
 
111
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>
112
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-FILE-NOT-FOUND:CAPS"><code class="literal">CAIRO_STATUS_FILE_NOT_FOUND</code></a>
113
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-READ-ERROR:CAPS"><code class="literal">CAIRO_STATUS_READ_ERROR</code></a>
112
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>
113
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-FILE-NOT-FOUND--CAPS"><code class="literal">CAIRO_STATUS_FILE_NOT_FOUND</code></a>
114
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-READ-ERROR--CAPS"><code class="literal">CAIRO_STATUS_READ_ERROR</code></a>
115
+
116
+ Alternatively, you can allow errors to propagate through the drawing
117
+ operations and check the status on the context upon completion
118
+ using <a class="link" href="cairo-context.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a>.
114
119
  </td>
115
120
  </tr>
116
121
  </tbody>
117
122
  </table></div>
118
123
  </div>
119
124
  <hr>
120
- <div class="refsect2" lang="en">
125
+ <div class="refsect2" title="cairo_read_func_t ()">
121
126
  <a name="cairo-read-func-t"></a><h3>cairo_read_func_t ()</h3>
122
127
  <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> (*cairo_read_func_t) (void *closure,
123
128
  unsigned char *data,
@@ -128,10 +133,9 @@ backend needs to read data from an input stream. It is passed the
128
133
  closure which was specified by the user at the time the read
129
134
  function was registered, the buffer to read the data into and the
130
135
  length of the data in bytes. The read function should return
131
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> if all the data was successfully read,
132
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-READ-ERROR:CAPS"><code class="literal">CAIRO_STATUS_READ_ERROR</code></a> otherwise.</p>
136
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> if all the data was successfully read,
137
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-READ-ERROR--CAPS"><code class="literal">CAIRO_STATUS_READ_ERROR</code></a> otherwise.</p>
133
138
  <p>
134
-
135
139
  </p>
136
140
  <div class="variablelist"><table border="0">
137
141
  <col align="left" valign="top">
@@ -160,16 +164,15 @@ length of the data in bytes. The read function should return
160
164
  </table></div>
161
165
  </div>
162
166
  <hr>
163
- <div class="refsect2" lang="en">
167
+ <div class="refsect2" title="cairo_image_surface_create_from_png_stream ()">
164
168
  <a name="cairo-image-surface-create-from-png-stream"></a><h3>cairo_image_surface_create_from_png_stream ()</h3>
165
- <pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a>* cairo_image_surface_create_from_png_stream
169
+ <pre class="programlisting"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> * cairo_image_surface_create_from_png_stream
166
170
  (<a class="link" href="cairo-png-functions.html#cairo-read-func-t" title="cairo_read_func_t ()">cairo_read_func_t</a> read_func,
167
171
  void *closure);</pre>
168
172
  <p>
169
173
  Creates a new image surface from PNG data read incrementally
170
174
  via the <em class="parameter"><code>read_func</code></em> function.</p>
171
175
  <p>
172
-
173
176
  </p>
174
177
  <div class="variablelist"><table border="0">
175
178
  <col align="left" valign="top">
@@ -187,15 +190,24 @@ via the <em class="parameter"><code>read_func</code></em> function.</p>
187
190
  <tr>
188
191
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
189
192
  <td> a new <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> initialized with the contents
190
- of the PNG file or <code class="literal">NULL</code> if the data read is not a valid PNG image or
191
- memory could not be allocated for the operation.
193
+ of the PNG file or a "nil" surface if the data read is not a valid PNG image
194
+ or memory could not be allocated for the operation. A nil
195
+ surface can be checked for with cairo_surface_status(surface) which
196
+ may return one of the following values:
197
+
198
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>
199
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-READ-ERROR--CAPS"><code class="literal">CAIRO_STATUS_READ_ERROR</code></a>
200
+
201
+ Alternatively, you can allow errors to propagate through the drawing
202
+ operations and check the status on the context upon completion
203
+ using <a class="link" href="cairo-context.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a>.
192
204
  </td>
193
205
  </tr>
194
206
  </tbody>
195
207
  </table></div>
196
208
  </div>
197
209
  <hr>
198
- <div class="refsect2" lang="en">
210
+ <div class="refsect2" title="cairo_surface_write_to_png ()">
199
211
  <a name="cairo-surface-write-to-png"></a><h3>cairo_surface_write_to_png ()</h3>
200
212
  <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_surface_write_to_png (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
201
213
  const char *filename);</pre>
@@ -203,7 +215,6 @@ memory could not be allocated for the operation.
203
215
  Writes the contents of <em class="parameter"><code>surface</code></em> to a new file <em class="parameter"><code>filename</code></em> as a PNG
204
216
  image.</p>
205
217
  <p>
206
-
207
218
  </p>
208
219
  <div class="variablelist"><table border="0">
209
220
  <col align="left" valign="top">
@@ -220,11 +231,11 @@ image.</p>
220
231
  </tr>
221
232
  <tr>
222
233
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
223
- <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> if the PNG file was written
224
- successfully. Otherwise, <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> if memory could not
234
+ <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> if the PNG file was written
235
+ successfully. Otherwise, <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> if memory could not
225
236
  be allocated for the operation or
226
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SURFACE-TYPE-MISMATCH:CAPS"><code class="literal">CAIRO_STATUS_SURFACE_TYPE_MISMATCH</code></a> if the surface does not have
227
- pixel contents, or <a class="link" href="cairo-error-status.html#CAIRO-STATUS-WRITE-ERROR:CAPS"><code class="literal">CAIRO_STATUS_WRITE_ERROR</code></a> if an I/O error occurs
237
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SURFACE-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_SURFACE_TYPE_MISMATCH</code></a> if the surface does not have
238
+ pixel contents, or <a class="link" href="cairo-error-status.html#CAIRO-STATUS-WRITE-ERROR--CAPS"><code class="literal">CAIRO_STATUS_WRITE_ERROR</code></a> if an I/O error occurs
228
239
  while attempting to write the file.
229
240
  </td>
230
241
  </tr>
@@ -232,7 +243,7 @@ while attempting to write the file.
232
243
  </table></div>
233
244
  </div>
234
245
  <hr>
235
- <div class="refsect2" lang="en">
246
+ <div class="refsect2" title="cairo_write_func_t ()">
236
247
  <a name="cairo-write-func-t"></a><h3>cairo_write_func_t ()</h3>
237
248
  <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> (*cairo_write_func_t) (void *closure,
238
249
  unsigned char *data,
@@ -243,10 +254,9 @@ backend needs to write data to an output stream. It is passed the
243
254
  closure which was specified by the user at the time the write
244
255
  function was registered, the data to write and the length of the
245
256
  data in bytes. The write function should return
246
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> if all the data was successfully written,
247
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-WRITE-ERROR:CAPS"><code class="literal">CAIRO_STATUS_WRITE_ERROR</code></a> otherwise.</p>
257
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> if all the data was successfully written,
258
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-WRITE-ERROR--CAPS"><code class="literal">CAIRO_STATUS_WRITE_ERROR</code></a> otherwise.</p>
248
259
  <p>
249
-
250
260
  </p>
251
261
  <div class="variablelist"><table border="0">
252
262
  <col align="left" valign="top">
@@ -275,7 +285,7 @@ data in bytes. The write function should return
275
285
  </table></div>
276
286
  </div>
277
287
  <hr>
278
- <div class="refsect2" lang="en">
288
+ <div class="refsect2" title="cairo_surface_write_to_png_stream ()">
279
289
  <a name="cairo-surface-write-to-png-stream"></a><h3>cairo_surface_write_to_png_stream ()</h3>
280
290
  <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_surface_write_to_png_stream (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface,
281
291
  <a class="link" href="cairo-png-functions.html#cairo-write-func-t" title="cairo_write_func_t ()">cairo_write_func_t</a> write_func,
@@ -283,7 +293,6 @@ data in bytes. The write function should return
283
293
  <p>
284
294
  Writes the image surface to the write function.</p>
285
295
  <p>
286
-
287
296
  </p>
288
297
  <div class="variablelist"><table border="0">
289
298
  <col align="left" valign="top">
@@ -305,10 +314,10 @@ Writes the image surface to the write function.</p>
305
314
  </tr>
306
315
  <tr>
307
316
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
308
- <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> if the PNG file was written
309
- successfully. Otherwise, <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> is returned if
317
+ <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> if the PNG file was written
318
+ successfully. Otherwise, <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> is returned if
310
319
  memory could not be allocated for the operation,
311
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SURFACE-TYPE-MISMATCH:CAPS"><code class="literal">CAIRO_STATUS_SURFACE_TYPE_MISMATCH</code></a> if the surface does not have
320
+ <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SURFACE-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_SURFACE_TYPE_MISMATCH</code></a> if the surface does not have
312
321
  pixel contents.
313
322
  </td>
314
323
  </tr>
@@ -316,17 +325,17 @@ pixel contents.
316
325
  </table></div>
317
326
  </div>
318
327
  </div>
319
- <div class="refsect1" lang="en">
328
+ <div class="refsect1" title="See Also">
320
329
  <a name="cairo-png-functions.see-also"></a><h2>See Also</h2>
321
330
  <p>
322
331
  </p>
323
- <div class="itemizedlist"><ul type="disc"><li><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></li></ul></div>
332
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></li></ul></div>
324
333
  <p>
325
334
  </p>
326
335
  </div>
327
336
  </div>
328
337
  <div class="footer">
329
338
  <hr>
330
- Generated by GTK-Doc V1.10</div>
339
+ Generated by GTK-Doc V1.11</div>
331
340
  </body>
332
341
  </html>