cairo 1.14.1-x64-mingw32 → 1.14.2-x64-mingw32

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 (215) hide show
  1. checksums.yaml +4 -4
  2. data/NEWS +21 -0
  3. data/Rakefile +17 -6
  4. data/ext/cairo/cairo.def +1 -0
  5. data/ext/cairo/extconf.rb +23 -10
  6. data/ext/cairo/rb_cairo.c +3 -0
  7. data/ext/cairo/rb_cairo.h +3 -3
  8. data/ext/cairo/rb_cairo_context.c +1 -1
  9. data/ext/cairo/rb_cairo_io.c +4 -0
  10. data/ext/cairo/rb_cairo_io.h +2 -0
  11. data/ext/cairo/rb_cairo_pattern.c +4 -4
  12. data/ext/cairo/rb_cairo_private.h +2 -0
  13. data/ext/cairo/rb_cairo_surface.c +64 -232
  14. data/lib/2.0/cairo.so +0 -0
  15. data/lib/2.1/cairo.so +0 -0
  16. data/lib/2.2/cairo.so +0 -0
  17. data/lib/cairo.rb +20 -19
  18. data/lib/cairo/region.rb +14 -0
  19. data/test/test_region.rb +26 -0
  20. data/vendor/local/bin/fc-cache.exe +0 -0
  21. data/vendor/local/bin/fc-cat.exe +0 -0
  22. data/vendor/local/bin/fc-list.exe +0 -0
  23. data/vendor/local/bin/fc-match.exe +0 -0
  24. data/vendor/local/bin/fc-pattern.exe +0 -0
  25. data/vendor/local/bin/fc-query.exe +0 -0
  26. data/vendor/local/bin/fc-scan.exe +0 -0
  27. data/vendor/local/bin/fc-validate.exe +0 -0
  28. data/vendor/local/bin/freetype-config +2 -2
  29. data/vendor/local/bin/libcairo-2.dll +0 -0
  30. data/vendor/local/bin/libcairo-gobject-2.dll +0 -0
  31. data/vendor/local/bin/libcairo-script-interpreter-2.dll +0 -0
  32. data/vendor/local/bin/libfontconfig-1.dll +0 -0
  33. data/vendor/local/bin/libfreetype-6.dll +0 -0
  34. data/vendor/local/bin/libgcc_s_seh-1.dll +0 -0
  35. data/vendor/local/bin/libpixman-1-0.dll +0 -0
  36. data/vendor/local/bin/libpng-config +1 -1
  37. data/vendor/local/bin/libpng16-16.dll +0 -0
  38. data/vendor/local/bin/libpng16-config +1 -1
  39. data/vendor/local/bin/libstdc++-6.dll +0 -0
  40. data/vendor/local/bin/libwinpthread-1.dll +0 -0
  41. data/vendor/local/bin/libxml2-2.dll +0 -0
  42. data/vendor/local/bin/png-fix-itxt.exe +0 -0
  43. data/vendor/local/bin/pngfix.exe +0 -0
  44. data/vendor/local/bin/xmlcatalog.exe +0 -0
  45. data/vendor/local/bin/xmllint.exe +0 -0
  46. data/vendor/local/bin/zlib1.dll +0 -0
  47. data/vendor/local/include/cairo/cairo-version.h +1 -1
  48. data/vendor/local/include/freetype2/config/ftconfig.h +19 -2
  49. data/vendor/local/include/freetype2/config/ftheader.h +7 -5
  50. data/vendor/local/include/freetype2/config/ftoption.h +9 -22
  51. data/vendor/local/include/freetype2/config/ftstdlib.h +2 -3
  52. data/vendor/local/include/freetype2/freetype.h +38 -17
  53. data/vendor/local/include/freetype2/ft2build.h +1 -1
  54. data/vendor/local/include/freetype2/ftadvanc.h +2 -2
  55. data/vendor/local/include/freetype2/ftautoh.h +50 -2
  56. data/vendor/local/include/freetype2/ftbbox.h +1 -1
  57. data/vendor/local/include/freetype2/ftbdf.h +1 -1
  58. data/vendor/local/include/freetype2/ftbitmap.h +11 -3
  59. data/vendor/local/include/freetype2/ftbzip2.h +1 -1
  60. data/vendor/local/include/freetype2/ftcache.h +3 -3
  61. data/vendor/local/include/freetype2/ftcffdrv.h +1 -1
  62. data/vendor/local/include/freetype2/ftcid.h +2 -1
  63. data/vendor/local/include/freetype2/fterrdef.h +1 -1
  64. data/vendor/local/include/freetype2/fterrors.h +1 -1
  65. data/vendor/local/include/freetype2/{ftxf86.h → ftfntfmt.h} +22 -14
  66. data/vendor/local/include/freetype2/ftgasp.h +1 -1
  67. data/vendor/local/include/freetype2/ftglyph.h +1 -1
  68. data/vendor/local/include/freetype2/ftgxval.h +1 -1
  69. data/vendor/local/include/freetype2/ftgzip.h +1 -1
  70. data/vendor/local/include/freetype2/ftimage.h +7 -13
  71. data/vendor/local/include/freetype2/ftincrem.h +1 -1
  72. data/vendor/local/include/freetype2/ftlcdfil.h +2 -2
  73. data/vendor/local/include/freetype2/ftlist.h +1 -1
  74. data/vendor/local/include/freetype2/ftlzw.h +1 -1
  75. data/vendor/local/include/freetype2/ftmac.h +1 -1
  76. data/vendor/local/include/freetype2/ftmm.h +17 -11
  77. data/vendor/local/include/freetype2/ftmodapi.h +4 -2
  78. data/vendor/local/include/freetype2/ftmoderr.h +1 -1
  79. data/vendor/local/include/freetype2/ftotval.h +1 -1
  80. data/vendor/local/include/freetype2/ftoutln.h +1 -1
  81. data/vendor/local/include/freetype2/ftpfr.h +1 -1
  82. data/vendor/local/include/freetype2/ftrender.h +3 -8
  83. data/vendor/local/include/freetype2/ftsizes.h +1 -1
  84. data/vendor/local/include/freetype2/ftsnames.h +1 -1
  85. data/vendor/local/include/freetype2/ftstroke.h +1 -1
  86. data/vendor/local/include/freetype2/ftsynth.h +5 -3
  87. data/vendor/local/include/freetype2/ftsystem.h +10 -1
  88. data/vendor/local/include/freetype2/fttrigon.h +1 -1
  89. data/vendor/local/include/freetype2/ftttdrv.h +85 -22
  90. data/vendor/local/include/freetype2/fttypes.h +1 -1
  91. data/vendor/local/include/freetype2/ftwinfnt.h +3 -3
  92. data/vendor/local/include/freetype2/t1tables.h +4 -3
  93. data/vendor/local/include/freetype2/ttnameid.h +116 -116
  94. data/vendor/local/include/freetype2/tttables.h +2 -2
  95. data/vendor/local/include/freetype2/tttags.h +1 -1
  96. data/vendor/local/include/freetype2/ttunpat.h +1 -1
  97. data/vendor/local/include/libpng16/png.h +63 -80
  98. data/vendor/local/include/libpng16/pngconf.h +8 -30
  99. data/vendor/local/include/libpng16/pnglibconf.h +10 -4
  100. data/vendor/local/include/png.h +63 -80
  101. data/vendor/local/include/pngconf.h +8 -30
  102. data/vendor/local/include/pnglibconf.h +10 -4
  103. data/vendor/local/lib/libcairo-gobject.a +0 -0
  104. data/vendor/local/lib/libcairo-gobject.dll.a +0 -0
  105. data/vendor/local/lib/libcairo-gobject.la +2 -2
  106. data/vendor/local/lib/libcairo-script-interpreter.a +0 -0
  107. data/vendor/local/lib/libcairo-script-interpreter.dll.a +0 -0
  108. data/vendor/local/lib/libcairo-script-interpreter.la +2 -2
  109. data/vendor/local/lib/libcairo.a +0 -0
  110. data/vendor/local/lib/libcairo.dll.a +0 -0
  111. data/vendor/local/lib/libcairo.la +2 -2
  112. data/vendor/local/lib/libfontconfig.dll.a +0 -0
  113. data/vendor/local/lib/libfreetype.a +0 -0
  114. data/vendor/local/lib/libfreetype.dll.a +0 -0
  115. data/vendor/local/lib/libfreetype.la +4 -4
  116. data/vendor/local/lib/libpixman-1.a +0 -0
  117. data/vendor/local/lib/libpixman-1.dll.a +0 -0
  118. data/vendor/local/lib/libpng.a +0 -0
  119. data/vendor/local/lib/libpng.dll.a +0 -0
  120. data/vendor/local/lib/libpng.la +4 -4
  121. data/vendor/local/lib/libpng16.a +0 -0
  122. data/vendor/local/lib/libpng16.dll.a +0 -0
  123. data/vendor/local/lib/libpng16.la +4 -4
  124. data/vendor/local/lib/libxml2.a +0 -0
  125. data/vendor/local/lib/libxml2.dll.a +0 -0
  126. data/vendor/local/lib/libz.a +0 -0
  127. data/vendor/local/lib/libz.dll.a +0 -0
  128. data/vendor/local/lib/pkgconfig/cairo-fc.pc +1 -1
  129. data/vendor/local/lib/pkgconfig/cairo-ft.pc +1 -1
  130. data/vendor/local/lib/pkgconfig/cairo-gobject.pc +1 -1
  131. data/vendor/local/lib/pkgconfig/cairo-pdf.pc +1 -1
  132. data/vendor/local/lib/pkgconfig/cairo-png.pc +1 -1
  133. data/vendor/local/lib/pkgconfig/cairo-ps.pc +1 -1
  134. data/vendor/local/lib/pkgconfig/cairo-script.pc +1 -1
  135. data/vendor/local/lib/pkgconfig/cairo-svg.pc +1 -1
  136. data/vendor/local/lib/pkgconfig/cairo-win32-font.pc +1 -1
  137. data/vendor/local/lib/pkgconfig/cairo-win32.pc +1 -1
  138. data/vendor/local/lib/pkgconfig/cairo.pc +1 -1
  139. data/vendor/local/lib/pkgconfig/freetype2.pc +1 -1
  140. data/vendor/local/lib/pkgconfig/libpng.pc +1 -1
  141. data/vendor/local/lib/pkgconfig/libpng16.pc +1 -1
  142. data/vendor/local/share/aclocal/freetype2.m4 +1 -1
  143. data/vendor/local/share/gtk-doc/html/cairo/bindings-errors.html +12 -12
  144. data/vendor/local/share/gtk-doc/html/cairo/bindings-fonts.html +12 -12
  145. data/vendor/local/share/gtk-doc/html/cairo/bindings-memory.html +12 -12
  146. data/vendor/local/share/gtk-doc/html/cairo/bindings-overloading.html +13 -13
  147. data/vendor/local/share/gtk-doc/html/cairo/bindings-path.html +12 -12
  148. data/vendor/local/share/gtk-doc/html/cairo/bindings-patterns.html +35 -35
  149. data/vendor/local/share/gtk-doc/html/cairo/bindings-return-values.html +10 -10
  150. data/vendor/local/share/gtk-doc/html/cairo/bindings-streams.html +11 -11
  151. data/vendor/local/share/gtk-doc/html/cairo/bindings-surfaces.html +13 -13
  152. data/vendor/local/share/gtk-doc/html/cairo/cairo-Error-handling.html +294 -225
  153. data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +387 -269
  154. data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +432 -302
  155. data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html +325 -217
  156. data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html +298 -193
  157. data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html +1121 -812
  158. data/vendor/local/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html +513 -383
  159. data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-(CGFont)-Fonts.html +126 -83
  160. data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-Surfaces.html +172 -119
  161. data/vendor/local/share/gtk-doc/html/cairo/cairo-Raster-Sources.html +581 -372
  162. data/vendor/local/share/gtk-doc/html/cairo/cairo-Recording-Surfaces.html +179 -130
  163. data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html +888 -539
  164. data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +287 -192
  165. data/vendor/local/share/gtk-doc/html/cairo/cairo-Script-Surfaces.html +374 -231
  166. data/vendor/local/share/gtk-doc/html/cairo/cairo-Transformations.html +395 -219
  167. data/vendor/local/share/gtk-doc/html/cairo/cairo-Types.html +125 -75
  168. data/vendor/local/share/gtk-doc/html/cairo/cairo-User-Fonts.html +630 -464
  169. data/vendor/local/share/gtk-doc/html/cairo/cairo-Version-Information.html +225 -200
  170. data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +336 -214
  171. data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +277 -186
  172. data/vendor/local/share/gtk-doc/html/cairo/cairo-XCB-Surfaces.html +495 -350
  173. data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html +557 -362
  174. data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-XRender-Backend.html +158 -111
  175. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html +655 -441
  176. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +389 -280
  177. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html +667 -451
  178. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html +579 -351
  179. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html +2006 -1545
  180. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html +892 -618
  181. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +1624 -1188
  182. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-t.html +2903 -2104
  183. data/vendor/local/share/gtk-doc/html/cairo/cairo-drawing.html +13 -13
  184. data/vendor/local/share/gtk-doc/html/cairo/cairo-fonts.html +13 -13
  185. data/vendor/local/share/gtk-doc/html/cairo/cairo-support.html +13 -13
  186. data/vendor/local/share/gtk-doc/html/cairo/cairo-surfaces.html +13 -13
  187. data/vendor/local/share/gtk-doc/html/cairo/cairo-text.html +1115 -758
  188. data/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp2 +419 -604
  189. data/vendor/local/share/gtk-doc/html/cairo/home.png +0 -0
  190. data/vendor/local/share/gtk-doc/html/cairo/index-1.10.html +56 -56
  191. data/vendor/local/share/gtk-doc/html/cairo/index-1.12.html +70 -70
  192. data/vendor/local/share/gtk-doc/html/cairo/index-1.2.html +58 -58
  193. data/vendor/local/share/gtk-doc/html/cairo/index-1.4.html +39 -39
  194. data/vendor/local/share/gtk-doc/html/cairo/index-1.6.html +30 -30
  195. data/vendor/local/share/gtk-doc/html/cairo/index-1.8.html +38 -38
  196. data/vendor/local/share/gtk-doc/html/cairo/index-all.html +426 -426
  197. data/vendor/local/share/gtk-doc/html/cairo/index.html +6 -6
  198. data/vendor/local/share/gtk-doc/html/cairo/index.sgml +234 -325
  199. data/vendor/local/share/gtk-doc/html/cairo/language-bindings.html +12 -12
  200. data/vendor/local/share/gtk-doc/html/cairo/left-insensitive.png +0 -0
  201. data/vendor/local/share/gtk-doc/html/cairo/left.png +0 -0
  202. data/vendor/local/share/gtk-doc/html/cairo/right-insensitive.png +0 -0
  203. data/vendor/local/share/gtk-doc/html/cairo/right.png +0 -0
  204. data/vendor/local/share/gtk-doc/html/cairo/style.css +221 -26
  205. data/vendor/local/share/gtk-doc/html/cairo/up-insensitive.png +0 -0
  206. data/vendor/local/share/gtk-doc/html/cairo/up.png +0 -0
  207. data/vendor/local/share/license/cairo/README +1 -1
  208. data/vendor/local/share/license/freetype/README +6 -6
  209. data/vendor/local/share/license/freetype/README.git +1 -1
  210. data/vendor/local/share/license/libpng/README +2 -2
  211. data/vendor/local/share/man/man1/freetype-config.1 +1 -1
  212. data/vendor/local/share/man/man3/libpng.3 +85 -92
  213. data/vendor/local/share/man/man3/libpngpf.3 +2 -2
  214. data/vendor/local/share/man/man5/png.5 +1 -1
  215. metadata +23 -19
data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html CHANGED
@@ -2,30 +2,27 @@
2
2
  <html>
3
3
  <head>
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
- <title>PDF Surfaces</title>
6
- <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
5
+ <title>Cairo: A Vector Graphics Library: PDF Surfaces</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
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-Surfaces.html" title="Image Surfaces">
10
10
  <link rel="next" href="cairo-PNG-Support.html" title="PNG Support">
11
- <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.20 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
14
  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="cairo-Image-Surfaces.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="cairo-surfaces.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">Cairo: A Vector Graphics Library</th>
21
- <td><a accesskey="n" href="cairo-PNG-Support.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#cairo-PDF-Surfaces.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#cairo-PDF-Surfaces.description" class="shortcut">Description</a>
27
- </td></tr>
28
- </table>
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
+ <td width="100%" align="left" class="shortcuts">
17
+ <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
18
+ <a href="#cairo-PDF-Surfaces.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19
+ <a href="#cairo-PDF-Surfaces.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
20
+ </td>
21
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22
+ <td><a accesskey="u" href="cairo-surfaces.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23
+ <td><a accesskey="p" href="cairo-Image-Surfaces.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24
+ <td><a accesskey="n" href="cairo-PNG-Support.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
25
+ </tr></table>
29
26
  <div class="refentry">
30
27
  <a name="cairo-PDF-Surfaces"></a><div class="titlepage"></div>
31
28
  <div class="refnamediv"><table width="100%"><tr>
@@ -33,44 +30,99 @@
33
30
  <h2><span class="refentrytitle"><a name="cairo-PDF-Surfaces.top_of_page"></a>PDF Surfaces</span></h2>
34
31
  <p>PDF Surfaces — Rendering PDF documents</p>
35
32
  </td>
36
- <td valign="top" align="right"></td>
33
+ <td class="gallery_image" valign="top" align="right"></td>
37
34
  </tr></table></div>
38
- <div class="refsynopsisdiv">
39
- <a name="cairo-PDF-Surfaces.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">#define <a class="link" href="cairo-PDF-Surfaces.html#CAIRO-HAS-PDF-SURFACE:CAPS" title="CAIRO_HAS_PDF_SURFACE">CAIRO_HAS_PDF_SURFACE</a>
41
- <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> * <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-surface-create" title="cairo_pdf_surface_create ()">cairo_pdf_surface_create</a> (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
42
- <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
43
- <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);
44
- <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> * <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-surface-create-for-stream" title="cairo_pdf_surface_create_for_stream ()">cairo_pdf_surface_create_for_stream</a> (<em class="parameter"><code><a class="link" href="cairo-PNG-Support.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> write_func</code></em>,
45
- <em class="parameter"><code><span class="type">void</span> *closure</code></em>,
46
- <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
47
- <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);
48
- <span class="returnvalue">void</span> <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-surface-restrict-to-version" title="cairo_pdf_surface_restrict_to_version ()">cairo_pdf_surface_restrict_to_version</a>
49
- (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>,
50
- <em class="parameter"><code><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> version</code></em>);
51
- enum <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t">cairo_pdf_version_t</a>;
52
- <span class="returnvalue">void</span> <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-get-versions" title="cairo_pdf_get_versions ()">cairo_pdf_get_versions</a> (<em class="parameter"><code><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> const **versions</code></em>,
53
- <em class="parameter"><code><span class="type">int</span> *num_versions</code></em>);
54
- const <span class="returnvalue">char</span> * <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-to-string" title="cairo_pdf_version_to_string ()">cairo_pdf_version_to_string</a> (<em class="parameter"><code><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> version</code></em>);
55
- <span class="returnvalue">void</span> <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-surface-set-size" title="cairo_pdf_surface_set_size ()">cairo_pdf_surface_set_size</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>,
56
- <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
57
- <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);
35
+ <div class="refsect1">
36
+ <a name="cairo-PDF-Surfaces.functions"></a><h2>Functions</h2>
37
+ <div class="informaltable"><table width="100%" border="0">
38
+ <colgroup>
39
+ <col width="150px" class="functions_return">
40
+ <col class="functions_name">
41
+ </colgroup>
42
+ <tbody>
43
+ <tr>
44
+ <td class="function_type">
45
+ <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
46
+ </td>
47
+ <td class="function_name">
48
+ <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-surface-create" title="cairo_pdf_surface_create ()">cairo_pdf_surface_create</a> <span class="c_punctuation">()</span>
49
+ </td>
50
+ </tr>
51
+ <tr>
52
+ <td class="function_type">
53
+ <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
54
+ </td>
55
+ <td class="function_name">
56
+ <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-surface-create-for-stream" title="cairo_pdf_surface_create_for_stream ()">cairo_pdf_surface_create_for_stream</a> <span class="c_punctuation">()</span>
57
+ </td>
58
+ </tr>
59
+ <tr>
60
+ <td class="function_type">
61
+ <span class="returnvalue">void</span>
62
+ </td>
63
+ <td class="function_name">
64
+ <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-surface-restrict-to-version" title="cairo_pdf_surface_restrict_to_version ()">cairo_pdf_surface_restrict_to_version</a> <span class="c_punctuation">()</span>
65
+ </td>
66
+ </tr>
67
+ <tr>
68
+ <td class="function_type">
69
+ <span class="returnvalue">void</span>
70
+ </td>
71
+ <td class="function_name">
72
+ <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-get-versions" title="cairo_pdf_get_versions ()">cairo_pdf_get_versions</a> <span class="c_punctuation">()</span>
73
+ </td>
74
+ </tr>
75
+ <tr>
76
+ <td class="function_type">const <span class="returnvalue">char</span> *
77
+ </td>
78
+ <td class="function_name">
79
+ <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-to-string" title="cairo_pdf_version_to_string ()">cairo_pdf_version_to_string</a> <span class="c_punctuation">()</span>
80
+ </td>
81
+ </tr>
82
+ <tr>
83
+ <td class="function_type">
84
+ <span class="returnvalue">void</span>
85
+ </td>
86
+ <td class="function_name">
87
+ <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-surface-set-size" title="cairo_pdf_surface_set_size ()">cairo_pdf_surface_set_size</a> <span class="c_punctuation">()</span>
88
+ </td>
89
+ </tr>
90
+ </tbody>
91
+ </table></div>
92
+ </div>
93
+ <div class="refsect1">
94
+ <a name="cairo-PDF-Surfaces.other"></a><h2>Types and Values</h2>
95
+ <div class="informaltable"><table width="100%" border="0">
96
+ <colgroup>
97
+ <col width="150px" class="name">
98
+ <col class="description">
99
+ </colgroup>
100
+ <tbody>
101
+ <tr>
102
+ <td class="define_keyword">#define</td>
103
+ <td class="function_name"><a class="link" href="cairo-PDF-Surfaces.html#CAIRO-HAS-PDF-SURFACE:CAPS" title="CAIRO_HAS_PDF_SURFACE">CAIRO_HAS_PDF_SURFACE</a></td>
104
+ </tr>
105
+ <tr>
106
+ <td class="datatype_keyword">enum</td>
107
+ <td class="function_name"><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t">cairo_pdf_version_t</a></td>
108
+ </tr>
109
+ </tbody>
110
+ </table></div>
111
+ </div>
112
+ <div class="refsect1">
113
+ <a name="cairo-PDF-Surfaces.object-hierarchy"></a><h2>Object Hierarchy</h2>
114
+ <pre class="screen">
58
115
  </pre>
59
116
  </div>
60
117
  <div class="refsect1">
61
118
  <a name="cairo-PDF-Surfaces.description"></a><h2>Description</h2>
62
- <p>
63
- The PDF surface is used to render cairo graphics to Adobe
64
- PDF files and is a multi-page vector surface backend.
65
- </p>
66
- <p>
67
- The following mime types are supported: <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JPEG:CAPS" title="CAIRO_MIME_TYPE_JPEG"><code class="literal">CAIRO_MIME_TYPE_JPEG</code></a>,
119
+ <p>The PDF surface is used to render cairo graphics to Adobe
120
+ PDF files and is a multi-page vector surface backend.</p>
121
+ <p>The following mime types are supported: <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JPEG:CAPS" title="CAIRO_MIME_TYPE_JPEG"><code class="literal">CAIRO_MIME_TYPE_JPEG</code></a>,
68
122
  <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JP2:CAPS" title="CAIRO_MIME_TYPE_JP2"><code class="literal">CAIRO_MIME_TYPE_JP2</code></a>, <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-UNIQUE-ID:CAPS" title="CAIRO_MIME_TYPE_UNIQUE_ID"><code class="literal">CAIRO_MIME_TYPE_UNIQUE_ID</code></a>,
69
123
  <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2:CAPS" title="CAIRO_MIME_TYPE_JBIG2"><code class="literal">CAIRO_MIME_TYPE_JBIG2</code></a>, <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL</code></a>,
70
- <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</code></a>.
71
- </p>
72
- <p>
73
- JBIG2 data in PDF must be in the embedded format as descibed in
124
+ <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</code></a>.</p>
125
+ <p>JBIG2 data in PDF must be in the embedded format as descibed in
74
126
  ISO/IEC 11544. Image specific JBIG2 data must be in
75
127
  <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2:CAPS" title="CAIRO_MIME_TYPE_JBIG2"><code class="literal">CAIRO_MIME_TYPE_JBIG2</code></a>. Any global segments in the JBIG2 data
76
128
  (segments with page association field set to 0) must be in
@@ -80,263 +132,319 @@ multiple images. All images sharing the same global data must set
80
132
  one of the images must provide the global data using
81
133
  <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL</code></a>. The global data will only be
82
134
  embedded once but shared by all JBIG2 images with the same
83
- <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</code></a>.
84
- </p>
135
+ <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</code></a>.</p>
85
136
  </div>
86
137
  <div class="refsect1">
87
- <a name="cairo-PDF-Surfaces.details"></a><h2>Details</h2>
88
- <div class="refsect2">
89
- <a name="CAIRO-HAS-PDF-SURFACE:CAPS"></a><h3>CAIRO_HAS_PDF_SURFACE</h3>
90
- <pre class="programlisting">#define CAIRO_HAS_PDF_SURFACE 1
91
- </pre>
92
- <p>
93
- Defined if the PDF surface backend is available.
94
- This macro can be used to conditionally compile backend-specific code.
95
- </p>
96
- <p class="since">Since 1.2</p>
97
- </div>
98
- <hr>
138
+ <a name="cairo-PDF-Surfaces.functions_details"></a><h2>Functions</h2>
99
139
  <div class="refsect2">
100
- <a name="cairo-pdf-surface-create"></a><h3>cairo_pdf_surface_create ()</h3>
101
- <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> * cairo_pdf_surface_create (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
102
- <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
103
- <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
104
- <p>
105
- Creates a PDF surface of the specified size in points to be written
106
- to <em class="parameter"><code>filename</code></em>.
107
- </p>
108
- <div class="variablelist"><table border="0">
109
- <col align="left" valign="top">
140
+ <a name="cairo-pdf-surface-create"></a><h3>cairo_pdf_surface_create ()</h3>
141
+ <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
142
+ cairo_pdf_surface_create (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
143
+ <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
144
+ <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
145
+ <p>Creates a PDF surface of the specified size in points to be written
146
+ to <em class="parameter"><code>filename</code></em>
147
+ .</p>
148
+ <div class="refsect3">
149
+ <a name="id-1.5.5.7.2.5"></a><h4>Parameters</h4>
150
+ <div class="informaltable"><table width="100%" border="0">
151
+ <colgroup>
152
+ <col width="150px" class="parameters_name">
153
+ <col class="parameters_description">
154
+ <col width="200px" class="parameters_annotations">
155
+ </colgroup>
110
156
  <tbody>
111
157
  <tr>
112
- <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
113
- <td>a filename for the PDF output (must be writable), <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be
158
+ <td class="parameter_name"><p>filename</p></td>
159
+ <td class="parameter_description"><p>a filename for the PDF output (must be writable), <code class="literal">NULL</code> may be
114
160
  used to specify no output. This will generate a PDF surface that
115
161
  may be queried and used as a source, without generating a
116
- temporary file.</td>
162
+ temporary file.</p></td>
163
+ <td class="parameter_annotations"> </td>
117
164
  </tr>
118
165
  <tr>
119
- <td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
120
- <td>width of the surface, in points (1 point == 1/72.0 inch)</td>
166
+ <td class="parameter_name"><p>width_in_points</p></td>
167
+ <td class="parameter_description"><p>width of the surface, in points (1 point == 1/72.0 inch)</p></td>
168
+ <td class="parameter_annotations"> </td>
121
169
  </tr>
122
170
  <tr>
123
- <td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
124
- <td>height of the surface, in points (1 point == 1/72.0 inch)</td>
125
- </tr>
126
- <tr>
127
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
128
- <td>a pointer to the newly created surface. The caller
129
- owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
130
- with it.
131
- This function always returns a valid pointer, but it will return a
132
- pointer to a "nil" surface if an error such as out of memory
133
- occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.</td>
171
+ <td class="parameter_name"><p>height_in_points</p></td>
172
+ <td class="parameter_description"><p>height of the surface, in points (1 point == 1/72.0 inch)</p></td>
173
+ <td class="parameter_annotations"> </td>
134
174
  </tr>
135
175
  </tbody>
136
176
  </table></div>
177
+ </div>
178
+ <div class="refsect3">
179
+ <a name="id-1.5.5.7.2.6"></a><h4>Returns</h4>
180
+ <p> a pointer to the newly created surface. The caller
181
+ owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
182
+ with it.</p>
183
+ <p>This function always returns a valid pointer, but it will return a
184
+ pointer to a "nil" surface if an error such as out of memory
185
+ occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.</p>
186
+ <p></p>
187
+ </div>
137
188
  <p class="since">Since 1.2</p>
138
189
  </div>
139
190
  <hr>
140
191
  <div class="refsect2">
141
- <a name="cairo-pdf-surface-create-for-stream"></a><h3>cairo_pdf_surface_create_for_stream ()</h3>
142
- <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> * cairo_pdf_surface_create_for_stream (<em class="parameter"><code><a class="link" href="cairo-PNG-Support.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> write_func</code></em>,
143
- <em class="parameter"><code><span class="type">void</span> *closure</code></em>,
144
- <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
145
- <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
146
- <p>
147
- Creates a PDF surface of the specified size in points to be written
148
- incrementally to the stream represented by <em class="parameter"><code>write_func</code></em> and <em class="parameter"><code>closure</code></em>.
149
- </p>
150
- <div class="variablelist"><table border="0">
151
- <col align="left" valign="top">
192
+ <a name="cairo-pdf-surface-create-for-stream"></a><h3>cairo_pdf_surface_create_for_stream ()</h3>
193
+ <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
194
+ cairo_pdf_surface_create_for_stream (<em class="parameter"><code><a class="link" href="cairo-PNG-Support.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> write_func</code></em>,
195
+ <em class="parameter"><code><span class="type">void</span> *closure</code></em>,
196
+ <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
197
+ <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
198
+ <p>Creates a PDF surface of the specified size in points to be written
199
+ incrementally to the stream represented by <em class="parameter"><code>write_func</code></em>
200
+ and <em class="parameter"><code>closure</code></em>
201
+ .</p>
202
+ <div class="refsect3">
203
+ <a name="id-1.5.5.7.3.5"></a><h4>Parameters</h4>
204
+ <div class="informaltable"><table width="100%" border="0">
205
+ <colgroup>
206
+ <col width="150px" class="parameters_name">
207
+ <col class="parameters_description">
208
+ <col width="200px" class="parameters_annotations">
209
+ </colgroup>
152
210
  <tbody>
153
211
  <tr>
154
- <td><p><span class="term"><em class="parameter"><code>write_func</code></em> :</span></p></td>
155
- <td>a <a class="link" href="cairo-PNG-Support.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 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
156
- to indicate a no-op <em class="parameter"><code>write_func</code></em>. With a no-op <em class="parameter"><code>write_func</code></em>,
212
+ <td class="parameter_name"><p>write_func</p></td>
213
+ <td class="parameter_description"><p>a <a class="link" href="cairo-PNG-Support.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 <code class="literal">NULL</code>
214
+ to indicate a no-op <em class="parameter"><code>write_func</code></em>
215
+ . With a no-op <em class="parameter"><code>write_func</code></em>
216
+ ,
157
217
  the surface may be queried or used as a source without
158
- generating any temporary files.</td>
218
+ generating any temporary files.</p></td>
219
+ <td class="parameter_annotations"> </td>
159
220
  </tr>
160
221
  <tr>
161
- <td><p><span class="term"><em class="parameter"><code>closure</code></em> :</span></p></td>
162
- <td>the closure argument for <em class="parameter"><code>write_func</code></em>
163
- </td>
222
+ <td class="parameter_name"><p>closure</p></td>
223
+ <td class="parameter_description"><p>the closure argument for <em class="parameter"><code>write_func</code></em>
224
+ </p></td>
225
+ <td class="parameter_annotations"> </td>
164
226
  </tr>
165
227
  <tr>
166
- <td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
167
- <td>width of the surface, in points (1 point == 1/72.0 inch)</td>
228
+ <td class="parameter_name"><p>width_in_points</p></td>
229
+ <td class="parameter_description"><p>width of the surface, in points (1 point == 1/72.0 inch)</p></td>
230
+ <td class="parameter_annotations"> </td>
168
231
  </tr>
169
232
  <tr>
170
- <td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
171
- <td>height of the surface, in points (1 point == 1/72.0 inch)</td>
172
- </tr>
173
- <tr>
174
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
175
- <td>a pointer to the newly created surface. The caller
176
- owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
177
- with it.
178
- This function always returns a valid pointer, but it will return a
179
- pointer to a "nil" surface if an error such as out of memory
180
- occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.</td>
233
+ <td class="parameter_name"><p>height_in_points</p></td>
234
+ <td class="parameter_description"><p>height of the surface, in points (1 point == 1/72.0 inch)</p></td>
235
+ <td class="parameter_annotations"> </td>
181
236
  </tr>
182
237
  </tbody>
183
238
  </table></div>
239
+ </div>
240
+ <div class="refsect3">
241
+ <a name="id-1.5.5.7.3.6"></a><h4>Returns</h4>
242
+ <p> a pointer to the newly created surface. The caller
243
+ owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
244
+ with it.</p>
245
+ <p>This function always returns a valid pointer, but it will return a
246
+ pointer to a "nil" surface if an error such as out of memory
247
+ occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.</p>
248
+ <p></p>
249
+ </div>
184
250
  <p class="since">Since 1.2</p>
185
251
  </div>
186
252
  <hr>
187
253
  <div class="refsect2">
188
- <a name="cairo-pdf-surface-restrict-to-version"></a><h3>cairo_pdf_surface_restrict_to_version ()</h3>
189
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_pdf_surface_restrict_to_version
190
- (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>,
191
- <em class="parameter"><code><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> version</code></em>);</pre>
192
- <p>
193
- Restricts the generated PDF file to <em class="parameter"><code>version</code></em>. See <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-get-versions" title="cairo_pdf_get_versions ()"><code class="function">cairo_pdf_get_versions()</code></a>
194
- for a list of available version values that can be used here.
195
- </p>
196
- <p>
197
- This function should only be called before any drawing operations
254
+ <a name="cairo-pdf-surface-restrict-to-version"></a><h3>cairo_pdf_surface_restrict_to_version ()</h3>
255
+ <pre class="programlisting"><span class="returnvalue">void</span>
256
+ cairo_pdf_surface_restrict_to_version (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>,
257
+ <em class="parameter"><code><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> version</code></em>);</pre>
258
+ <p>Restricts the generated PDF file to <em class="parameter"><code>version</code></em>
259
+ . See <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-get-versions" title="cairo_pdf_get_versions ()"><code class="function">cairo_pdf_get_versions()</code></a>
260
+ for a list of available version values that can be used here.</p>
261
+ <p>This function should only be called before any drawing operations
198
262
  have been performed on the given surface. The simplest way to do
199
263
  this is to call this function immediately after creating the
200
- surface.
201
- </p>
202
- <div class="variablelist"><table border="0">
203
- <col align="left" valign="top">
264
+ surface.</p>
265
+ <div class="refsect3">
266
+ <a name="id-1.5.5.7.4.6"></a><h4>Parameters</h4>
267
+ <div class="informaltable"><table width="100%" border="0">
268
+ <colgroup>
269
+ <col width="150px" class="parameters_name">
270
+ <col class="parameters_description">
271
+ <col width="200px" class="parameters_annotations">
272
+ </colgroup>
204
273
  <tbody>
205
274
  <tr>
206
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
207
- <td>a PDF <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
208
- </td>
275
+ <td class="parameter_name"><p>surface</p></td>
276
+ <td class="parameter_description"><p>a PDF <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></p></td>
277
+ <td class="parameter_annotations"> </td>
209
278
  </tr>
210
279
  <tr>
211
- <td><p><span class="term"><em class="parameter"><code>version</code></em> :</span></p></td>
212
- <td>PDF version</td>
280
+ <td class="parameter_name"><p>version</p></td>
281
+ <td class="parameter_description"><p>PDF version</p></td>
282
+ <td class="parameter_annotations"> </td>
213
283
  </tr>
214
284
  </tbody>
215
285
  </table></div>
286
+ </div>
216
287
  <p class="since">Since 1.10</p>
217
288
  </div>
218
289
  <hr>
219
290
  <div class="refsect2">
220
- <a name="cairo-pdf-version-t"></a><h3>enum cairo_pdf_version_t</h3>
221
- <pre class="programlisting">typedef enum {
222
- CAIRO_PDF_VERSION_1_4,
223
- CAIRO_PDF_VERSION_1_5
224
- } cairo_pdf_version_t;
225
- </pre>
226
- <p>
227
- <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> is used to describe the version number of the PDF
228
- specification that a generated PDF file will conform to.
229
- </p>
230
- <div class="variablelist"><table border="0">
231
- <col align="left" valign="top">
291
+ <a name="cairo-pdf-get-versions"></a><h3>cairo_pdf_get_versions ()</h3>
292
+ <pre class="programlisting"><span class="returnvalue">void</span>
293
+ cairo_pdf_get_versions (<em class="parameter"><code><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> const **versions</code></em>,
294
+ <em class="parameter"><code><span class="type">int</span> *num_versions</code></em>);</pre>
295
+ <p>Used to retrieve the list of supported versions. See
296
+ <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-surface-restrict-to-version" title="cairo_pdf_surface_restrict_to_version ()"><code class="function">cairo_pdf_surface_restrict_to_version()</code></a>.</p>
297
+ <div class="refsect3">
298
+ <a name="id-1.5.5.7.5.5"></a><h4>Parameters</h4>
299
+ <div class="informaltable"><table width="100%" border="0">
300
+ <colgroup>
301
+ <col width="150px" class="parameters_name">
302
+ <col class="parameters_description">
303
+ <col width="200px" class="parameters_annotations">
304
+ </colgroup>
232
305
  <tbody>
233
306
  <tr>
234
- <td><p><a name="CAIRO-PDF-VERSION-1-4:CAPS"></a><span class="term"><code class="literal">CAIRO_PDF_VERSION_1_4</code></span></p></td>
235
- <td>The version 1.4 of the PDF specification. (Since 1.10)
236
- </td>
307
+ <td class="parameter_name"><p>versions</p></td>
308
+ <td class="parameter_description"><p>supported version list</p></td>
309
+ <td class="parameter_annotations"> </td>
237
310
  </tr>
238
311
  <tr>
239
- <td><p><a name="CAIRO-PDF-VERSION-1-5:CAPS"></a><span class="term"><code class="literal">CAIRO_PDF_VERSION_1_5</code></span></p></td>
240
- <td>The version 1.5 of the PDF specification. (Since 1.10)
241
- </td>
312
+ <td class="parameter_name"><p>num_versions</p></td>
313
+ <td class="parameter_description"><p>list length</p></td>
314
+ <td class="parameter_annotations"> </td>
242
315
  </tr>
243
316
  </tbody>
244
317
  </table></div>
318
+ </div>
245
319
  <p class="since">Since 1.10</p>
246
320
  </div>
247
321
  <hr>
248
322
  <div class="refsect2">
249
- <a name="cairo-pdf-get-versions"></a><h3>cairo_pdf_get_versions ()</h3>
250
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_pdf_get_versions (<em class="parameter"><code><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> const **versions</code></em>,
251
- <em class="parameter"><code><span class="type">int</span> *num_versions</code></em>);</pre>
252
- <p>
253
- Used to retrieve the list of supported versions. See
254
- <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-surface-restrict-to-version" title="cairo_pdf_surface_restrict_to_version ()"><code class="function">cairo_pdf_surface_restrict_to_version()</code></a>.
255
- </p>
256
- <div class="variablelist"><table border="0">
257
- <col align="left" valign="top">
258
- <tbody>
259
- <tr>
260
- <td><p><span class="term"><em class="parameter"><code>versions</code></em> :</span></p></td>
261
- <td>supported version list</td>
262
- </tr>
263
- <tr>
264
- <td><p><span class="term"><em class="parameter"><code>num_versions</code></em> :</span></p></td>
265
- <td>list length</td>
266
- </tr>
267
- </tbody>
323
+ <a name="cairo-pdf-version-to-string"></a><h3>cairo_pdf_version_to_string ()</h3>
324
+ <pre class="programlisting">const <span class="returnvalue">char</span> *
325
+ cairo_pdf_version_to_string (<em class="parameter"><code><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> version</code></em>);</pre>
326
+ <p>Get the string representation of the given <em class="parameter"><code>version</code></em>
327
+ id. This function
328
+ will return <code class="literal">NULL</code> if <em class="parameter"><code>version</code></em>
329
+ isn't valid. See <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-get-versions" title="cairo_pdf_get_versions ()"><code class="function">cairo_pdf_get_versions()</code></a>
330
+ for a way to get the list of valid version ids.</p>
331
+ <div class="refsect3">
332
+ <a name="id-1.5.5.7.6.5"></a><h4>Parameters</h4>
333
+ <div class="informaltable"><table width="100%" border="0">
334
+ <colgroup>
335
+ <col width="150px" class="parameters_name">
336
+ <col class="parameters_description">
337
+ <col width="200px" class="parameters_annotations">
338
+ </colgroup>
339
+ <tbody><tr>
340
+ <td class="parameter_name"><p>version</p></td>
341
+ <td class="parameter_description"><p>a version id</p></td>
342
+ <td class="parameter_annotations"> </td>
343
+ </tr></tbody>
268
344
  </table></div>
345
+ </div>
346
+ <div class="refsect3">
347
+ <a name="id-1.5.5.7.6.6"></a><h4>Returns</h4>
348
+ <p> the string associated to given version.</p>
349
+ <p></p>
350
+ </div>
269
351
  <p class="since">Since 1.10</p>
270
352
  </div>
271
353
  <hr>
272
354
  <div class="refsect2">
273
- <a name="cairo-pdf-version-to-string"></a><h3>cairo_pdf_version_to_string ()</h3>
274
- <pre class="programlisting">const <span class="returnvalue">char</span> * cairo_pdf_version_to_string (<em class="parameter"><code><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> version</code></em>);</pre>
275
- <p>
276
- Get the string representation of the given <em class="parameter"><code>version</code></em> id. This function
277
- will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>version</code></em> isn't valid. See <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-get-versions" title="cairo_pdf_get_versions ()"><code class="function">cairo_pdf_get_versions()</code></a>
278
- for a way to get the list of valid version ids.
279
- </p>
280
- <div class="variablelist"><table border="0">
281
- <col align="left" valign="top">
355
+ <a name="cairo-pdf-surface-set-size"></a><h3>cairo_pdf_surface_set_size ()</h3>
356
+ <pre class="programlisting"><span class="returnvalue">void</span>
357
+ cairo_pdf_surface_set_size (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>,
358
+ <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
359
+ <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
360
+ <p>Changes the size of a PDF surface for the current (and
361
+ subsequent) pages.</p>
362
+ <p>This function should only be called before any drawing operations
363
+ have been performed on the current page. The simplest way to do
364
+ this is to call this function immediately after creating the
365
+ surface or immediately after completing a page with either
366
+ <a class="link" href="cairo-cairo-t.html#cairo-show-page" title="cairo_show_page ()"><code class="function">cairo_show_page()</code></a> or <a class="link" href="cairo-cairo-t.html#cairo-copy-page" title="cairo_copy_page ()"><code class="function">cairo_copy_page()</code></a>.</p>
367
+ <div class="refsect3">
368
+ <a name="id-1.5.5.7.7.6"></a><h4>Parameters</h4>
369
+ <div class="informaltable"><table width="100%" border="0">
370
+ <colgroup>
371
+ <col width="150px" class="parameters_name">
372
+ <col class="parameters_description">
373
+ <col width="200px" class="parameters_annotations">
374
+ </colgroup>
282
375
  <tbody>
283
376
  <tr>
284
- <td><p><span class="term"><em class="parameter"><code>version</code></em> :</span></p></td>
285
- <td>a version id</td>
377
+ <td class="parameter_name"><p>surface</p></td>
378
+ <td class="parameter_description"><p>a PDF <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></p></td>
379
+ <td class="parameter_annotations"> </td>
380
+ </tr>
381
+ <tr>
382
+ <td class="parameter_name"><p>width_in_points</p></td>
383
+ <td class="parameter_description"><p>new surface width, in points (1 point == 1/72.0 inch)</p></td>
384
+ <td class="parameter_annotations"> </td>
286
385
  </tr>
287
386
  <tr>
288
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
289
- <td>the string associated to given version.</td>
387
+ <td class="parameter_name"><p>height_in_points</p></td>
388
+ <td class="parameter_description"><p>new surface height, in points (1 point == 1/72.0 inch)</p></td>
389
+ <td class="parameter_annotations"> </td>
290
390
  </tr>
291
391
  </tbody>
292
392
  </table></div>
293
- <p class="since">Since 1.10</p>
393
+ </div>
394
+ <p class="since">Since 1.2</p>
395
+ </div>
396
+ </div>
397
+ <div class="refsect1">
398
+ <a name="cairo-PDF-Surfaces.other_details"></a><h2>Types and Values</h2>
399
+ <div class="refsect2">
400
+ <a name="CAIRO-HAS-PDF-SURFACE:CAPS"></a><h3>CAIRO_HAS_PDF_SURFACE</h3>
401
+ <pre class="programlisting">#define CAIRO_HAS_PDF_SURFACE 1
402
+ </pre>
403
+ <p>Defined if the PDF surface backend is available.
404
+ This macro can be used to conditionally compile backend-specific code.</p>
405
+ <p class="since">Since 1.2</p>
294
406
  </div>
295
407
  <hr>
296
408
  <div class="refsect2">
297
- <a name="cairo-pdf-surface-set-size"></a><h3>cairo_pdf_surface_set_size ()</h3>
298
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_pdf_surface_set_size (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>,
299
- <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
300
- <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
301
- <p>
302
- Changes the size of a PDF surface for the current (and
303
- subsequent) pages.
304
- </p>
305
- <p>
306
- This function should only be called before any drawing operations
307
- have been performed on the current page. The simplest way to do
308
- this is to call this function immediately after creating the
309
- surface or immediately after completing a page with either
310
- <a class="link" href="cairo-cairo-t.html#cairo-show-page" title="cairo_show_page ()"><code class="function">cairo_show_page()</code></a> or <a class="link" href="cairo-cairo-t.html#cairo-copy-page" title="cairo_copy_page ()"><code class="function">cairo_copy_page()</code></a>.
311
- </p>
312
- <div class="variablelist"><table border="0">
313
- <col align="left" valign="top">
409
+ <a name="cairo-pdf-version-t"></a><h3>enum cairo_pdf_version_t</h3>
410
+ <p><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> is used to describe the version number of the PDF
411
+ specification that a generated PDF file will conform to.</p>
412
+ <div class="refsect3">
413
+ <a name="id-1.5.5.8.3.4"></a><h4>Members</h4>
414
+ <div class="informaltable"><table width="100%" border="0">
415
+ <colgroup>
416
+ <col width="300px" class="enum_members_name">
417
+ <col class="enum_members_description">
418
+ <col width="200px" class="enum_members_annotations">
419
+ </colgroup>
314
420
  <tbody>
315
421
  <tr>
316
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
317
- <td>a PDF <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
422
+ <td class="enum_member_name"><p><a name="CAIRO-PDF-VERSION-1-4:CAPS"></a>CAIRO_PDF_VERSION_1_4</p></td>
423
+ <td class="enum_member_description">
424
+ <p>The version 1.4 of the PDF specification. (Since 1.10)</p>
318
425
  </td>
426
+ <td class="enum_member_annotations"> </td>
319
427
  </tr>
320
428
  <tr>
321
- <td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
322
- <td>new surface width, in points (1 point == 1/72.0 inch)</td>
323
- </tr>
324
- <tr>
325
- <td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
326
- <td>new surface height, in points (1 point == 1/72.0 inch)</td>
429
+ <td class="enum_member_name"><p><a name="CAIRO-PDF-VERSION-1-5:CAPS"></a>CAIRO_PDF_VERSION_1_5</p></td>
430
+ <td class="enum_member_description">
431
+ <p>The version 1.5 of the PDF specification. (Since 1.10)</p>
432
+ </td>
433
+ <td class="enum_member_annotations"> </td>
327
434
  </tr>
328
435
  </tbody>
329
436
  </table></div>
330
- <p class="since">Since 1.2</p>
437
+ </div>
438
+ <p class="since">Since 1.10</p>
331
439
  </div>
332
440
  </div>
333
441
  <div class="refsect1">
334
442
  <a name="cairo-PDF-Surfaces.see-also"></a><h2>See Also</h2>
335
- <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
443
+ <p><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></p>
336
444
  </div>
337
445
  </div>
338
446
  <div class="footer">
339
447
  <hr>
340
- Generated by GTK-Doc V1.18</div>
448
+ Generated by GTK-Doc V1.20</div>
341
449
  </body>
342
450
  </html>