cairo 1.14.1-x86-mingw32 → 1.14.2-x86-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 +18 -7
  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_sjlj-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-PostScript-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>PostScript Surfaces</title>
6
- <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
5
+ <title>Cairo: A Vector Graphics Library: PostScript 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-PNG-Support.html" title="PNG Support">
10
10
  <link rel="next" href="cairo-Recording-Surfaces.html" title="Recording Surfaces">
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-PNG-Support.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-Recording-Surfaces.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-PostScript-Surfaces.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#cairo-PostScript-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-PostScript-Surfaces.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19
+ <a href="#cairo-PostScript-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-PNG-Support.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24
+ <td><a accesskey="n" href="cairo-Recording-Surfaces.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-PostScript-Surfaces"></a><div class="titlepage"></div>
31
28
  <div class="refnamediv"><table width="100%"><tr>
@@ -33,499 +30,581 @@
33
30
  <h2><span class="refentrytitle"><a name="cairo-PostScript-Surfaces.top_of_page"></a>PostScript Surfaces</span></h2>
34
31
  <p>PostScript Surfaces — Rendering PostScript 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-PostScript-Surfaces.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">#define <a class="link" href="cairo-PostScript-Surfaces.html#CAIRO-HAS-PS-SURFACE:CAPS" title="CAIRO_HAS_PS_SURFACE">CAIRO_HAS_PS_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-PostScript-Surfaces.html#cairo-ps-surface-create" title="cairo_ps_surface_create ()">cairo_ps_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-PostScript-Surfaces.html#cairo-ps-surface-create-for-stream" title="cairo_ps_surface_create_for_stream ()">cairo_ps_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-PostScript-Surfaces.html#cairo-ps-surface-restrict-to-level" title="cairo_ps_surface_restrict_to_level ()">cairo_ps_surface_restrict_to_level</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>,
49
- <em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> level</code></em>);
50
- enum <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t">cairo_ps_level_t</a>;
51
- <span class="returnvalue">void</span> <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()">cairo_ps_get_levels</a> (<em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> const **levels</code></em>,
52
- <em class="parameter"><code><span class="type">int</span> *num_levels</code></em>);
53
- const <span class="returnvalue">char</span> * <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-to-string" title="cairo_ps_level_to_string ()">cairo_ps_level_to_string</a> (<em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> level</code></em>);
54
- <span class="returnvalue">void</span> <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-set-eps" title="cairo_ps_surface_set_eps ()">cairo_ps_surface_set_eps</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>,
55
- <em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="type">cairo_bool_t</span></a> eps</code></em>);
56
- <a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a> <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-get-eps" title="cairo_ps_surface_get_eps ()">cairo_ps_surface_get_eps</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>);
57
- <span class="returnvalue">void</span> <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-set-size" title="cairo_ps_surface_set_size ()">cairo_ps_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>,
58
- <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
59
- <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);
60
- <span class="returnvalue">void</span> <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()">cairo_ps_surface_dsc_begin_setup</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>);
61
- <span class="returnvalue">void</span> <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()">cairo_ps_surface_dsc_begin_page_setup</a>
62
- (<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>);
63
- <span class="returnvalue">void</span> <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()">cairo_ps_surface_dsc_comment</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>,
64
- <em class="parameter"><code>const <span class="type">char</span> *comment</code></em>);
65
- </pre>
35
+ <div class="refsect1">
36
+ <a name="cairo-PostScript-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-PostScript-Surfaces.html#cairo-ps-surface-create" title="cairo_ps_surface_create ()">cairo_ps_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-PostScript-Surfaces.html#cairo-ps-surface-create-for-stream" title="cairo_ps_surface_create_for_stream ()">cairo_ps_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-PostScript-Surfaces.html#cairo-ps-surface-restrict-to-level" title="cairo_ps_surface_restrict_to_level ()">cairo_ps_surface_restrict_to_level</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-PostScript-Surfaces.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()">cairo_ps_get_levels</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-PostScript-Surfaces.html#cairo-ps-level-to-string" title="cairo_ps_level_to_string ()">cairo_ps_level_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-PostScript-Surfaces.html#cairo-ps-surface-set-eps" title="cairo_ps_surface_set_eps ()">cairo_ps_surface_set_eps</a> <span class="c_punctuation">()</span>
88
+ </td>
89
+ </tr>
90
+ <tr>
91
+ <td class="function_type">
92
+ <a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
93
+ </td>
94
+ <td class="function_name">
95
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-get-eps" title="cairo_ps_surface_get_eps ()">cairo_ps_surface_get_eps</a> <span class="c_punctuation">()</span>
96
+ </td>
97
+ </tr>
98
+ <tr>
99
+ <td class="function_type">
100
+ <span class="returnvalue">void</span>
101
+ </td>
102
+ <td class="function_name">
103
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-set-size" title="cairo_ps_surface_set_size ()">cairo_ps_surface_set_size</a> <span class="c_punctuation">()</span>
104
+ </td>
105
+ </tr>
106
+ <tr>
107
+ <td class="function_type">
108
+ <span class="returnvalue">void</span>
109
+ </td>
110
+ <td class="function_name">
111
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()">cairo_ps_surface_dsc_begin_setup</a> <span class="c_punctuation">()</span>
112
+ </td>
113
+ </tr>
114
+ <tr>
115
+ <td class="function_type">
116
+ <span class="returnvalue">void</span>
117
+ </td>
118
+ <td class="function_name">
119
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()">cairo_ps_surface_dsc_begin_page_setup</a> <span class="c_punctuation">()</span>
120
+ </td>
121
+ </tr>
122
+ <tr>
123
+ <td class="function_type">
124
+ <span class="returnvalue">void</span>
125
+ </td>
126
+ <td class="function_name">
127
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()">cairo_ps_surface_dsc_comment</a> <span class="c_punctuation">()</span>
128
+ </td>
129
+ </tr>
130
+ </tbody>
131
+ </table></div>
66
132
  </div>
67
133
  <div class="refsect1">
68
- <a name="cairo-PostScript-Surfaces.description"></a><h2>Description</h2>
69
- <p>
70
- The PostScript surface is used to render cairo graphics to Adobe
71
- PostScript files and is a multi-page vector surface backend.
72
- </p>
134
+ <a name="cairo-PostScript-Surfaces.other"></a><h2>Types and Values</h2>
135
+ <div class="informaltable"><table width="100%" border="0">
136
+ <colgroup>
137
+ <col width="150px" class="name">
138
+ <col class="description">
139
+ </colgroup>
140
+ <tbody>
141
+ <tr>
142
+ <td class="define_keyword">#define</td>
143
+ <td class="function_name"><a class="link" href="cairo-PostScript-Surfaces.html#CAIRO-HAS-PS-SURFACE:CAPS" title="CAIRO_HAS_PS_SURFACE">CAIRO_HAS_PS_SURFACE</a></td>
144
+ </tr>
145
+ <tr>
146
+ <td class="datatype_keyword">enum</td>
147
+ <td class="function_name"><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t">cairo_ps_level_t</a></td>
148
+ </tr>
149
+ </tbody>
150
+ </table></div>
73
151
  </div>
74
152
  <div class="refsect1">
75
- <a name="cairo-PostScript-Surfaces.details"></a><h2>Details</h2>
76
- <div class="refsect2">
77
- <a name="CAIRO-HAS-PS-SURFACE:CAPS"></a><h3>CAIRO_HAS_PS_SURFACE</h3>
78
- <pre class="programlisting">#define CAIRO_HAS_PS_SURFACE 1
153
+ <a name="cairo-PostScript-Surfaces.object-hierarchy"></a><h2>Object Hierarchy</h2>
154
+ <pre class="screen">
79
155
  </pre>
80
- <p>
81
- Defined if the PostScript surface backend is available.
82
- This macro can be used to conditionally compile backend-specific code.
83
- </p>
84
- <p class="since">Since 1.2</p>
85
156
  </div>
86
- <hr>
157
+ <div class="refsect1">
158
+ <a name="cairo-PostScript-Surfaces.description"></a><h2>Description</h2>
159
+ <p>The PostScript surface is used to render cairo graphics to Adobe
160
+ PostScript files and is a multi-page vector surface backend.</p>
161
+ </div>
162
+ <div class="refsect1">
163
+ <a name="cairo-PostScript-Surfaces.functions_details"></a><h2>Functions</h2>
87
164
  <div class="refsect2">
88
- <a name="cairo-ps-surface-create"></a><h3>cairo_ps_surface_create ()</h3>
89
- <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_ps_surface_create (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
90
- <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
91
- <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
92
- <p>
93
- Creates a PostScript surface of the specified size in points to be
94
- written to <em class="parameter"><code>filename</code></em>. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-create-for-stream" title="cairo_ps_surface_create_for_stream ()"><code class="function">cairo_ps_surface_create_for_stream()</code></a> for
165
+ <a name="cairo-ps-surface-create"></a><h3>cairo_ps_surface_create ()</h3>
166
+ <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> *
167
+ cairo_ps_surface_create (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
168
+ <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
169
+ <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
170
+ <p>Creates a PostScript surface of the specified size in points to be
171
+ written to <em class="parameter"><code>filename</code></em>
172
+ . See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-create-for-stream" title="cairo_ps_surface_create_for_stream ()"><code class="function">cairo_ps_surface_create_for_stream()</code></a> for
95
173
  a more flexible mechanism for handling the PostScript output than
96
- simply writing it to a named file.
97
- </p>
98
- <p>
99
- Note that the size of individual pages of the PostScript output can
100
- vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-set-size" title="cairo_ps_surface_set_size ()"><code class="function">cairo_ps_surface_set_size()</code></a>.
101
- </p>
102
- <div class="variablelist"><table border="0">
103
- <col align="left" valign="top">
174
+ simply writing it to a named file.</p>
175
+ <p>Note that the size of individual pages of the PostScript output can
176
+ vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-set-size" title="cairo_ps_surface_set_size ()"><code class="function">cairo_ps_surface_set_size()</code></a>.</p>
177
+ <div class="refsect3">
178
+ <a name="id-1.5.7.7.2.6"></a><h4>Parameters</h4>
179
+ <div class="informaltable"><table width="100%" border="0">
180
+ <colgroup>
181
+ <col width="150px" class="parameters_name">
182
+ <col class="parameters_description">
183
+ <col width="200px" class="parameters_annotations">
184
+ </colgroup>
104
185
  <tbody>
105
186
  <tr>
106
- <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
107
- <td>a filename for the PS 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
187
+ <td class="parameter_name"><p>filename</p></td>
188
+ <td class="parameter_description"><p>a filename for the PS output (must be writable), <code class="literal">NULL</code> may be
108
189
  used to specify no output. This will generate a PS surface that
109
190
  may be queried and used as a source, without generating a
110
- temporary file.</td>
191
+ temporary file.</p></td>
192
+ <td class="parameter_annotations"> </td>
111
193
  </tr>
112
194
  <tr>
113
- <td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
114
- <td>width of the surface, in points (1 point == 1/72.0 inch)</td>
195
+ <td class="parameter_name"><p>width_in_points</p></td>
196
+ <td class="parameter_description"><p>width of the surface, in points (1 point == 1/72.0 inch)</p></td>
197
+ <td class="parameter_annotations"> </td>
115
198
  </tr>
116
199
  <tr>
117
- <td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
118
- <td>height of the surface, in points (1 point == 1/72.0 inch)</td>
119
- </tr>
120
- <tr>
121
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
122
- <td>a pointer to the newly created surface. The caller
123
- 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
124
- with it.
125
- This function always returns a valid pointer, but it will return a
126
- pointer to a "nil" surface if an error such as out of memory
127
- 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>
200
+ <td class="parameter_name"><p>height_in_points</p></td>
201
+ <td class="parameter_description"><p>height of the surface, in points (1 point == 1/72.0 inch)</p></td>
202
+ <td class="parameter_annotations"> </td>
128
203
  </tr>
129
204
  </tbody>
130
205
  </table></div>
206
+ </div>
207
+ <div class="refsect3">
208
+ <a name="id-1.5.7.7.2.7"></a><h4>Returns</h4>
209
+ <p> a pointer to the newly created surface. The caller
210
+ 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
211
+ with it.</p>
212
+ <p>This function always returns a valid pointer, but it will return a
213
+ pointer to a "nil" surface if an error such as out of memory
214
+ 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>
215
+ <p></p>
216
+ </div>
131
217
  <p class="since">Since 1.2</p>
132
218
  </div>
133
219
  <hr>
134
220
  <div class="refsect2">
135
- <a name="cairo-ps-surface-create-for-stream"></a><h3>cairo_ps_surface_create_for_stream ()</h3>
136
- <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_ps_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>,
137
- <em class="parameter"><code><span class="type">void</span> *closure</code></em>,
138
- <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
139
- <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
140
- <p>
141
- Creates a PostScript surface of the specified size in points to be
142
- written incrementally to the stream represented by <em class="parameter"><code>write_func</code></em> and
143
- <em class="parameter"><code>closure</code></em>. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-create" title="cairo_ps_surface_create ()"><code class="function">cairo_ps_surface_create()</code></a> for a more convenient way
144
- to simply direct the PostScript output to a named file.
145
- </p>
146
- <p>
147
- Note that the size of individual pages of the PostScript
148
- output can vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-set-size" title="cairo_ps_surface_set_size ()"><code class="function">cairo_ps_surface_set_size()</code></a>.
149
- </p>
150
- <div class="variablelist"><table border="0">
151
- <col align="left" valign="top">
221
+ <a name="cairo-ps-surface-create-for-stream"></a><h3>cairo_ps_surface_create_for_stream ()</h3>
222
+ <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> *
223
+ cairo_ps_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>,
224
+ <em class="parameter"><code><span class="type">void</span> *closure</code></em>,
225
+ <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
226
+ <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
227
+ <p>Creates a PostScript surface of the specified size in points to be
228
+ written incrementally to the stream represented by <em class="parameter"><code>write_func</code></em>
229
+ and
230
+ <em class="parameter"><code>closure</code></em>
231
+ . See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-create" title="cairo_ps_surface_create ()"><code class="function">cairo_ps_surface_create()</code></a> for a more convenient way
232
+ to simply direct the PostScript output to a named file.</p>
233
+ <p>Note that the size of individual pages of the PostScript
234
+ output can vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-set-size" title="cairo_ps_surface_set_size ()"><code class="function">cairo_ps_surface_set_size()</code></a>.</p>
235
+ <div class="refsect3">
236
+ <a name="id-1.5.7.7.3.6"></a><h4>Parameters</h4>
237
+ <div class="informaltable"><table width="100%" border="0">
238
+ <colgroup>
239
+ <col width="150px" class="parameters_name">
240
+ <col class="parameters_description">
241
+ <col width="200px" class="parameters_annotations">
242
+ </colgroup>
152
243
  <tbody>
153
244
  <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>,
245
+ <td class="parameter_name"><p>write_func</p></td>
246
+ <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>
247
+ to indicate a no-op <em class="parameter"><code>write_func</code></em>
248
+ . With a no-op <em class="parameter"><code>write_func</code></em>
249
+ ,
157
250
  the surface may be queried or used as a source without
158
- generating any temporary files.</td>
159
- </tr>
160
- <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>
251
+ generating any temporary files.</p></td>
252
+ <td class="parameter_annotations"> </td>
164
253
  </tr>
165
254
  <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>
255
+ <td class="parameter_name"><p>closure</p></td>
256
+ <td class="parameter_description"><p>the closure argument for <em class="parameter"><code>write_func</code></em>
257
+ </p></td>
258
+ <td class="parameter_annotations"> </td>
168
259
  </tr>
169
260
  <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>
261
+ <td class="parameter_name"><p>width_in_points</p></td>
262
+ <td class="parameter_description"><p>width of the surface, in points (1 point == 1/72.0 inch)</p></td>
263
+ <td class="parameter_annotations"> </td>
172
264
  </tr>
173
265
  <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>
266
+ <td class="parameter_name"><p>height_in_points</p></td>
267
+ <td class="parameter_description"><p>height of the surface, in points (1 point == 1/72.0 inch)</p></td>
268
+ <td class="parameter_annotations"> </td>
181
269
  </tr>
182
270
  </tbody>
183
271
  </table></div>
272
+ </div>
273
+ <div class="refsect3">
274
+ <a name="id-1.5.7.7.3.7"></a><h4>Returns</h4>
275
+ <p> a pointer to the newly created surface. The caller
276
+ 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
277
+ with it.</p>
278
+ <p>This function always returns a valid pointer, but it will return a
279
+ pointer to a "nil" surface if an error such as out of memory
280
+ 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>
281
+ <p></p>
282
+ </div>
184
283
  <p class="since">Since 1.2</p>
185
284
  </div>
186
285
  <hr>
187
286
  <div class="refsect2">
188
- <a name="cairo-ps-surface-restrict-to-level"></a><h3>cairo_ps_surface_restrict_to_level ()</h3>
189
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ps_surface_restrict_to_level (<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>,
190
- <em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> level</code></em>);</pre>
191
- <p>
192
- Restricts the generated PostSript file to <em class="parameter"><code>level</code></em>. See
193
- <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()"><code class="function">cairo_ps_get_levels()</code></a> for a list of available level values that
194
- can be used here.
195
- </p>
196
- <p>
197
- This function should only be called before any drawing operations
287
+ <a name="cairo-ps-surface-restrict-to-level"></a><h3>cairo_ps_surface_restrict_to_level ()</h3>
288
+ <pre class="programlisting"><span class="returnvalue">void</span>
289
+ cairo_ps_surface_restrict_to_level (<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>,
290
+ <em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> level</code></em>);</pre>
291
+ <p>Restricts the generated PostSript file to <em class="parameter"><code>level</code></em>
292
+ . See
293
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()"><code class="function">cairo_ps_get_levels()</code></a> for a list of available level values that
294
+ can be used here.</p>
295
+ <p>This function should only be called before any drawing operations
198
296
  have been performed on the given surface. The simplest way to do
199
297
  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">
298
+ surface.</p>
299
+ <div class="refsect3">
300
+ <a name="id-1.5.7.7.4.6"></a><h4>Parameters</h4>
301
+ <div class="informaltable"><table width="100%" border="0">
302
+ <colgroup>
303
+ <col width="150px" class="parameters_name">
304
+ <col class="parameters_description">
305
+ <col width="200px" class="parameters_annotations">
306
+ </colgroup>
204
307
  <tbody>
205
308
  <tr>
206
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
207
- <td>a PostScript <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>
309
+ <td class="parameter_name"><p>surface</p></td>
310
+ <td class="parameter_description"><p>a PostScript <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>
311
+ <td class="parameter_annotations"> </td>
209
312
  </tr>
210
313
  <tr>
211
- <td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
212
- <td>PostScript level</td>
314
+ <td class="parameter_name"><p>level</p></td>
315
+ <td class="parameter_description"><p>PostScript level</p></td>
316
+ <td class="parameter_annotations"> </td>
213
317
  </tr>
214
318
  </tbody>
215
319
  </table></div>
216
- <p class="since">Since 1.6</p>
217
320
  </div>
218
- <hr>
219
- <div class="refsect2">
220
- <a name="cairo-ps-level-t"></a><h3>enum cairo_ps_level_t</h3>
221
- <pre class="programlisting">typedef enum {
222
- CAIRO_PS_LEVEL_2,
223
- CAIRO_PS_LEVEL_3
224
- } cairo_ps_level_t;
225
- </pre>
226
- <p>
227
- <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> is used to describe the language level of the
228
- PostScript Language Reference that a generated PostScript file will
229
- conform to.
230
- </p>
231
- <div class="variablelist"><table border="0">
232
- <col align="left" valign="top">
233
- <tbody>
234
- <tr>
235
- <td><p><a name="CAIRO-PS-LEVEL-2:CAPS"></a><span class="term"><code class="literal">CAIRO_PS_LEVEL_2</code></span></p></td>
236
- <td>The language level 2 of the PostScript specification. (Since 1.6)
237
- </td>
238
- </tr>
239
- <tr>
240
- <td><p><a name="CAIRO-PS-LEVEL-3:CAPS"></a><span class="term"><code class="literal">CAIRO_PS_LEVEL_3</code></span></p></td>
241
- <td>The language level 3 of the PostScript specification. (Since 1.6)
242
- </td>
243
- </tr>
244
- </tbody>
245
- </table></div>
246
321
  <p class="since">Since 1.6</p>
247
322
  </div>
248
323
  <hr>
249
324
  <div class="refsect2">
250
- <a name="cairo-ps-get-levels"></a><h3>cairo_ps_get_levels ()</h3>
251
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ps_get_levels (<em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> const **levels</code></em>,
252
- <em class="parameter"><code><span class="type">int</span> *num_levels</code></em>);</pre>
253
- <p>
254
- Used to retrieve the list of supported levels. See
255
- <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-restrict-to-level" title="cairo_ps_surface_restrict_to_level ()"><code class="function">cairo_ps_surface_restrict_to_level()</code></a>.
256
- </p>
257
- <div class="variablelist"><table border="0">
258
- <col align="left" valign="top">
325
+ <a name="cairo-ps-get-levels"></a><h3>cairo_ps_get_levels ()</h3>
326
+ <pre class="programlisting"><span class="returnvalue">void</span>
327
+ cairo_ps_get_levels (<em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> const **levels</code></em>,
328
+ <em class="parameter"><code><span class="type">int</span> *num_levels</code></em>);</pre>
329
+ <p>Used to retrieve the list of supported levels. See
330
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-restrict-to-level" title="cairo_ps_surface_restrict_to_level ()"><code class="function">cairo_ps_surface_restrict_to_level()</code></a>.</p>
331
+ <div class="refsect3">
332
+ <a name="id-1.5.7.7.5.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>
259
339
  <tbody>
260
340
  <tr>
261
- <td><p><span class="term"><em class="parameter"><code>levels</code></em> :</span></p></td>
262
- <td>supported level list</td>
341
+ <td class="parameter_name"><p>levels</p></td>
342
+ <td class="parameter_description"><p>supported level list</p></td>
343
+ <td class="parameter_annotations"> </td>
263
344
  </tr>
264
345
  <tr>
265
- <td><p><span class="term"><em class="parameter"><code>num_levels</code></em> :</span></p></td>
266
- <td>list length</td>
346
+ <td class="parameter_name"><p>num_levels</p></td>
347
+ <td class="parameter_description"><p>list length</p></td>
348
+ <td class="parameter_annotations"> </td>
267
349
  </tr>
268
350
  </tbody>
269
351
  </table></div>
352
+ </div>
270
353
  <p class="since">Since 1.6</p>
271
354
  </div>
272
355
  <hr>
273
356
  <div class="refsect2">
274
- <a name="cairo-ps-level-to-string"></a><h3>cairo_ps_level_to_string ()</h3>
275
- <pre class="programlisting">const <span class="returnvalue">char</span> * cairo_ps_level_to_string (<em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> level</code></em>);</pre>
276
- <p>
277
- Get the string representation of the given <em class="parameter"><code>level</code></em> id. This function
278
- 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>level</code></em> id isn't valid. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()"><code class="function">cairo_ps_get_levels()</code></a>
279
- for a way to get the list of valid level ids.
280
- </p>
281
- <div class="variablelist"><table border="0">
282
- <col align="left" valign="top">
283
- <tbody>
284
- <tr>
285
- <td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
286
- <td>a level id</td>
287
- </tr>
288
- <tr>
289
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
290
- <td>the string associated to given level.</td>
291
- </tr>
292
- </tbody>
357
+ <a name="cairo-ps-level-to-string"></a><h3>cairo_ps_level_to_string ()</h3>
358
+ <pre class="programlisting">const <span class="returnvalue">char</span> *
359
+ cairo_ps_level_to_string (<em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> level</code></em>);</pre>
360
+ <p>Get the string representation of the given <em class="parameter"><code>level</code></em>
361
+ id. This function
362
+ will return <code class="literal">NULL</code> if <em class="parameter"><code>level</code></em>
363
+ id isn't valid. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()"><code class="function">cairo_ps_get_levels()</code></a>
364
+ for a way to get the list of valid level ids.</p>
365
+ <div class="refsect3">
366
+ <a name="id-1.5.7.7.6.5"></a><h4>Parameters</h4>
367
+ <div class="informaltable"><table width="100%" border="0">
368
+ <colgroup>
369
+ <col width="150px" class="parameters_name">
370
+ <col class="parameters_description">
371
+ <col width="200px" class="parameters_annotations">
372
+ </colgroup>
373
+ <tbody><tr>
374
+ <td class="parameter_name"><p>level</p></td>
375
+ <td class="parameter_description"><p>a level id</p></td>
376
+ <td class="parameter_annotations"> </td>
377
+ </tr></tbody>
293
378
  </table></div>
379
+ </div>
380
+ <div class="refsect3">
381
+ <a name="id-1.5.7.7.6.6"></a><h4>Returns</h4>
382
+ <p> the string associated to given level.</p>
383
+ <p></p>
384
+ </div>
294
385
  <p class="since">Since 1.6</p>
295
386
  </div>
296
387
  <hr>
297
388
  <div class="refsect2">
298
- <a name="cairo-ps-surface-set-eps"></a><h3>cairo_ps_surface_set_eps ()</h3>
299
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ps_surface_set_eps (<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>,
300
- <em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="type">cairo_bool_t</span></a> eps</code></em>);</pre>
301
- <p>
302
- If <em class="parameter"><code>eps</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the PostScript surface will output Encapsulated
303
- PostScript.
304
- </p>
305
- <p>
306
- This function should only be called before any drawing operations
389
+ <a name="cairo-ps-surface-set-eps"></a><h3>cairo_ps_surface_set_eps ()</h3>
390
+ <pre class="programlisting"><span class="returnvalue">void</span>
391
+ cairo_ps_surface_set_eps (<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>,
392
+ <em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="type">cairo_bool_t</span></a> eps</code></em>);</pre>
393
+ <p>If <em class="parameter"><code>eps</code></em>
394
+ is <code class="literal">TRUE</code>, the PostScript surface will output Encapsulated
395
+ PostScript.</p>
396
+ <p>This function should only be called before any drawing operations
307
397
  have been performed on the current page. The simplest way to do
308
398
  this is to call this function immediately after creating the
309
399
  surface. An Encapsulated PostScript file should never contain more
310
- than one page.
311
- </p>
312
- <div class="variablelist"><table border="0">
313
- <col align="left" valign="top">
400
+ than one page.</p>
401
+ <div class="refsect3">
402
+ <a name="id-1.5.7.7.7.6"></a><h4>Parameters</h4>
403
+ <div class="informaltable"><table width="100%" border="0">
404
+ <colgroup>
405
+ <col width="150px" class="parameters_name">
406
+ <col class="parameters_description">
407
+ <col width="200px" class="parameters_annotations">
408
+ </colgroup>
314
409
  <tbody>
315
410
  <tr>
316
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
317
- <td>a PostScript <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
318
- </td>
411
+ <td class="parameter_name"><p>surface</p></td>
412
+ <td class="parameter_description"><p>a PostScript <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>
413
+ <td class="parameter_annotations"> </td>
319
414
  </tr>
320
415
  <tr>
321
- <td><p><span class="term"><em class="parameter"><code>eps</code></em> :</span></p></td>
322
- <td>
323
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to output EPS format PostScript</td>
416
+ <td class="parameter_name"><p>eps</p></td>
417
+ <td class="parameter_description"><p><code class="literal">TRUE</code> to output EPS format PostScript</p></td>
418
+ <td class="parameter_annotations"> </td>
324
419
  </tr>
325
420
  </tbody>
326
421
  </table></div>
422
+ </div>
327
423
  <p class="since">Since 1.6</p>
328
424
  </div>
329
425
  <hr>
330
426
  <div class="refsect2">
331
- <a name="cairo-ps-surface-get-eps"></a><h3>cairo_ps_surface_get_eps ()</h3>
332
- <pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a> cairo_ps_surface_get_eps (<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>);</pre>
333
- <p>
334
- Check whether the PostScript surface will output Encapsulated PostScript.
335
- </p>
336
- <div class="variablelist"><table border="0">
337
- <col align="left" valign="top">
338
- <tbody>
339
- <tr>
340
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
341
- <td>a PostScript <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
342
- </td>
343
- </tr>
344
- <tr>
345
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
346
- <td>
347
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the surface will output Encapsulated PostScript.</td>
348
- </tr>
349
- </tbody>
427
+ <a name="cairo-ps-surface-get-eps"></a><h3>cairo_ps_surface_get_eps ()</h3>
428
+ <pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
429
+ cairo_ps_surface_get_eps (<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>);</pre>
430
+ <p>Check whether the PostScript surface will output Encapsulated PostScript.</p>
431
+ <div class="refsect3">
432
+ <a name="id-1.5.7.7.8.5"></a><h4>Parameters</h4>
433
+ <div class="informaltable"><table width="100%" border="0">
434
+ <colgroup>
435
+ <col width="150px" class="parameters_name">
436
+ <col class="parameters_description">
437
+ <col width="200px" class="parameters_annotations">
438
+ </colgroup>
439
+ <tbody><tr>
440
+ <td class="parameter_name"><p>surface</p></td>
441
+ <td class="parameter_description"><p>a PostScript <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>
442
+ <td class="parameter_annotations"> </td>
443
+ </tr></tbody>
350
444
  </table></div>
445
+ </div>
446
+ <div class="refsect3">
447
+ <a name="id-1.5.7.7.8.6"></a><h4>Returns</h4>
448
+ <p> <code class="literal">TRUE</code> if the surface will output Encapsulated PostScript.</p>
449
+ <p></p>
450
+ </div>
351
451
  <p class="since">Since 1.6</p>
352
452
  </div>
353
453
  <hr>
354
454
  <div class="refsect2">
355
- <a name="cairo-ps-surface-set-size"></a><h3>cairo_ps_surface_set_size ()</h3>
356
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ps_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>,
357
- <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
358
- <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
359
- <p>
360
- Changes the size of a PostScript surface for the current (and
361
- subsequent) pages.
362
- </p>
363
- <p>
364
- This function should only be called before any drawing operations
455
+ <a name="cairo-ps-surface-set-size"></a><h3>cairo_ps_surface_set_size ()</h3>
456
+ <pre class="programlisting"><span class="returnvalue">void</span>
457
+ cairo_ps_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>,
458
+ <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
459
+ <em class="parameter"><code><span class="type">double</span> height_in_points</code></em>);</pre>
460
+ <p>Changes the size of a PostScript surface for the current (and
461
+ subsequent) pages.</p>
462
+ <p>This function should only be called before any drawing operations
365
463
  have been performed on the current page. The simplest way to do
366
464
  this is to call this function immediately after creating the
367
465
  surface or immediately after completing a page with either
368
- <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>.
369
- </p>
370
- <div class="variablelist"><table border="0">
371
- <col align="left" valign="top">
466
+ <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>
467
+ <div class="refsect3">
468
+ <a name="id-1.5.7.7.9.6"></a><h4>Parameters</h4>
469
+ <div class="informaltable"><table width="100%" border="0">
470
+ <colgroup>
471
+ <col width="150px" class="parameters_name">
472
+ <col class="parameters_description">
473
+ <col width="200px" class="parameters_annotations">
474
+ </colgroup>
372
475
  <tbody>
373
476
  <tr>
374
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
375
- <td>a PostScript <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
376
- </td>
477
+ <td class="parameter_name"><p>surface</p></td>
478
+ <td class="parameter_description"><p>a PostScript <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>
479
+ <td class="parameter_annotations"> </td>
377
480
  </tr>
378
481
  <tr>
379
- <td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
380
- <td>new surface width, in points (1 point == 1/72.0 inch)</td>
482
+ <td class="parameter_name"><p>width_in_points</p></td>
483
+ <td class="parameter_description"><p>new surface width, in points (1 point == 1/72.0 inch)</p></td>
484
+ <td class="parameter_annotations"> </td>
381
485
  </tr>
382
486
  <tr>
383
- <td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
384
- <td>new surface height, in points (1 point == 1/72.0 inch)</td>
487
+ <td class="parameter_name"><p>height_in_points</p></td>
488
+ <td class="parameter_description"><p>new surface height, in points (1 point == 1/72.0 inch)</p></td>
489
+ <td class="parameter_annotations"> </td>
385
490
  </tr>
386
491
  </tbody>
387
492
  </table></div>
493
+ </div>
388
494
  <p class="since">Since 1.2</p>
389
495
  </div>
390
496
  <hr>
391
497
  <div class="refsect2">
392
- <a name="cairo-ps-surface-dsc-begin-setup"></a><h3>cairo_ps_surface_dsc_begin_setup ()</h3>
393
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ps_surface_dsc_begin_setup (<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>);</pre>
394
- <p>
395
- This function indicates that subsequent calls to
396
- <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> should direct comments to the Setup
397
- section of the PostScript output.
398
- </p>
399
- <p>
400
- This function should be called at most once per surface, and must
401
- be called before any call to <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a>
402
- and before any drawing is performed to the surface.
403
- </p>
404
- <p>
405
- See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> for more details.
406
- </p>
407
- <div class="variablelist"><table border="0">
408
- <col align="left" valign="top">
498
+ <a name="cairo-ps-surface-dsc-begin-setup"></a><h3>cairo_ps_surface_dsc_begin_setup ()</h3>
499
+ <pre class="programlisting"><span class="returnvalue">void</span>
500
+ cairo_ps_surface_dsc_begin_setup (<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>);</pre>
501
+ <p>This function indicates that subsequent calls to
502
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> should direct comments to the Setup
503
+ section of the PostScript output.</p>
504
+ <p>This function should be called at most once per surface, and must
505
+ be called before any call to <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a>
506
+ and before any drawing is performed to the surface.</p>
507
+ <p>See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> for more details.</p>
508
+ <div class="refsect3">
509
+ <a name="id-1.5.7.7.10.7"></a><h4>Parameters</h4>
510
+ <div class="informaltable"><table width="100%" border="0">
511
+ <colgroup>
512
+ <col width="150px" class="parameters_name">
513
+ <col class="parameters_description">
514
+ <col width="200px" class="parameters_annotations">
515
+ </colgroup>
409
516
  <tbody><tr>
410
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
411
- <td>a PostScript <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
412
- </td>
517
+ <td class="parameter_name"><p>surface</p></td>
518
+ <td class="parameter_description"><p>a PostScript <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>
519
+ <td class="parameter_annotations"> </td>
413
520
  </tr></tbody>
414
521
  </table></div>
522
+ </div>
415
523
  <p class="since">Since 1.2</p>
416
524
  </div>
417
525
  <hr>
418
526
  <div class="refsect2">
419
- <a name="cairo-ps-surface-dsc-begin-page-setup"></a><h3>cairo_ps_surface_dsc_begin_page_setup ()</h3>
420
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ps_surface_dsc_begin_page_setup
421
- (<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>);</pre>
422
- <p>
423
- This function indicates that subsequent calls to
424
- <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> should direct comments to the
425
- PageSetup section of the PostScript output.
426
- </p>
427
- <p>
428
- This function call is only needed for the first page of a
527
+ <a name="cairo-ps-surface-dsc-begin-page-setup"></a><h3>cairo_ps_surface_dsc_begin_page_setup ()</h3>
528
+ <pre class="programlisting"><span class="returnvalue">void</span>
529
+ cairo_ps_surface_dsc_begin_page_setup (<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>);</pre>
530
+ <p>This function indicates that subsequent calls to
531
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> should direct comments to the
532
+ PageSetup section of the PostScript output.</p>
533
+ <p>This function call is only needed for the first page of a
429
534
  surface. It should be called after any call to
430
- <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()"><code class="function">cairo_ps_surface_dsc_begin_setup()</code></a> and before any drawing is
431
- performed to the surface.
432
- </p>
433
- <p>
434
- See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> for more details.
435
- </p>
436
- <div class="variablelist"><table border="0">
437
- <col align="left" valign="top">
535
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()"><code class="function">cairo_ps_surface_dsc_begin_setup()</code></a> and before any drawing is
536
+ performed to the surface.</p>
537
+ <p>See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment" title="cairo_ps_surface_dsc_comment ()"><code class="function">cairo_ps_surface_dsc_comment()</code></a> for more details.</p>
538
+ <div class="refsect3">
539
+ <a name="id-1.5.7.7.11.7"></a><h4>Parameters</h4>
540
+ <div class="informaltable"><table width="100%" border="0">
541
+ <colgroup>
542
+ <col width="150px" class="parameters_name">
543
+ <col class="parameters_description">
544
+ <col width="200px" class="parameters_annotations">
545
+ </colgroup>
438
546
  <tbody><tr>
439
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
440
- <td>a PostScript <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
441
- </td>
547
+ <td class="parameter_name"><p>surface</p></td>
548
+ <td class="parameter_description"><p>a PostScript <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>
549
+ <td class="parameter_annotations"> </td>
442
550
  </tr></tbody>
443
551
  </table></div>
552
+ </div>
444
553
  <p class="since">Since 1.2</p>
445
554
  </div>
446
555
  <hr>
447
556
  <div class="refsect2">
448
- <a name="cairo-ps-surface-dsc-comment"></a><h3>cairo_ps_surface_dsc_comment ()</h3>
449
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_ps_surface_dsc_comment (<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>,
450
- <em class="parameter"><code>const <span class="type">char</span> *comment</code></em>);</pre>
451
- <p>
452
- Emit a comment into the PostScript output for the given surface.
453
- </p>
454
- <p>
455
- The comment is expected to conform to the PostScript Language
557
+ <a name="cairo-ps-surface-dsc-comment"></a><h3>cairo_ps_surface_dsc_comment ()</h3>
558
+ <pre class="programlisting"><span class="returnvalue">void</span>
559
+ cairo_ps_surface_dsc_comment (<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>,
560
+ <em class="parameter"><code>const <span class="type">char</span> *comment</code></em>);</pre>
561
+ <p>Emit a comment into the PostScript output for the given surface.</p>
562
+ <p>The comment is expected to conform to the PostScript Language
456
563
  Document Structuring Conventions (DSC). Please see that manual for
457
564
  details on the available comments and their meanings. In
458
565
  particular, the %%IncludeFeature comment allows a
459
566
  device-independent means of controlling printer device features. So
460
567
  the PostScript Printer Description Files Specification will also be
461
- a useful reference.
462
- </p>
463
- <p>
464
- The comment string must begin with a percent character (%) and the
568
+ a useful reference.</p>
569
+ <p>The comment string must begin with a percent character (%) and the
465
570
  total length of the string (including any initial percent
466
571
  characters) must not exceed 255 characters. Violating either of
467
- these conditions will place <em class="parameter"><code>surface</code></em> into an error state. But
572
+ these conditions will place <em class="parameter"><code>surface</code></em>
573
+ into an error state. But
468
574
  beyond these two conditions, this function will not enforce
469
- conformance of the comment with any particular specification.
470
- </p>
471
- <p>
472
- The comment string should not have a trailing newline.
473
- </p>
474
- <p>
475
- The DSC specifies different sections in which particular comments
575
+ conformance of the comment with any particular specification.</p>
576
+ <p>The comment string should not have a trailing newline.</p>
577
+ <p>The DSC specifies different sections in which particular comments
476
578
  can appear. This function provides for comments to be emitted
477
579
  within three sections: the header, the Setup section, and the
478
580
  PageSetup section. Comments appearing in the first two sections
479
581
  apply to the entire document while comments in the BeginPageSetup
480
- section apply only to a single page.
481
- </p>
482
- <p>
483
- For comments to appear in the header section, this function should
582
+ section apply only to a single page.</p>
583
+ <p>For comments to appear in the header section, this function should
484
584
  be called after the surface is created, but before a call to
485
- <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()"><code class="function">cairo_ps_surface_dsc_begin_setup()</code></a>.
486
- </p>
487
- <p>
488
- For comments to appear in the Setup section, this function should
489
- be called after a call to <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()"><code class="function">cairo_ps_surface_dsc_begin_setup()</code></a> but
490
- before a call to <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a>.
491
- </p>
492
- <p>
493
- For comments to appear in the PageSetup section, this function
585
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()"><code class="function">cairo_ps_surface_dsc_begin_setup()</code></a>.</p>
586
+ <p>For comments to appear in the Setup section, this function should
587
+ be called after a call to <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()"><code class="function">cairo_ps_surface_dsc_begin_setup()</code></a> but
588
+ before a call to <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a>.</p>
589
+ <p>For comments to appear in the PageSetup section, this function
494
590
  should be called after a call to
495
- <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a>.
496
- </p>
497
- <p>
498
- Note that it is only necessary to call
499
- <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a> for the first page of any
500
- surface. After a call to <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>
591
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a>.</p>
592
+ <p>Note that it is only necessary to call
593
+ <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a> for the first page of any
594
+ surface. After a call to <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>
501
595
  comments are unambiguously directed to the PageSetup section of the
502
596
  current page. But it doesn't hurt to call this function at the
503
597
  beginning of every page as that consistency may make the calling
504
- code simpler.
505
- </p>
506
- <p>
507
- As a final note, cairo automatically generates several comments on
598
+ code simpler.</p>
599
+ <p>As a final note, cairo automatically generates several comments on
508
600
  its own. As such, applications must not manually generate any of
509
- the following comments:
510
- </p>
511
- <p>
512
- Header section: %!PS-Adobe-3.0, %%Creator, %%CreationDate, %%Pages,
513
- %%BoundingBox, %%DocumentData, %%LanguageLevel, %%EndComments.
514
- </p>
515
- <p>
516
- Setup section: %%BeginSetup, %%EndSetup
517
- </p>
518
- <p>
519
- PageSetup section: %%BeginPageSetup, %%PageBoundingBox, %%EndPageSetup.
520
- </p>
521
- <p>
522
- Other sections: %%BeginProlog, %%EndProlog, %%Page, %%Trailer, %%EOF
523
- </p>
524
- <p>
525
- Here is an example sequence showing how this function might be used:
526
- </p>
527
- <p>
528
- </p>
601
+ the following comments:</p>
602
+ <p>Header section: %!PS-Adobe-3.0, %%Creator, %%CreationDate, %%Pages,
603
+ %%BoundingBox, %%DocumentData, %%LanguageLevel, %%EndComments.</p>
604
+ <p>Setup section: %%BeginSetup, %%EndSetup</p>
605
+ <p>PageSetup section: %%BeginPageSetup, %%PageBoundingBox, %%EndPageSetup.</p>
606
+ <p>Other sections: %%BeginProlog, %%EndProlog, %%Page, %%Trailer, %%EOF</p>
607
+ <p>Here is an example sequence showing how this function might be used:</p>
529
608
  <div class="informalexample"><pre class="programlisting">
530
609
  cairo_surface_t *surface = cairo_ps_surface_create (filename, width, height);
531
610
  ...
@@ -546,32 +625,83 @@ cairo_show_page (cr);
546
625
  cairo_ps_surface_dsc_comment (surface, "%%IncludeFeature: *PageSize A5");
547
626
  ...
548
627
  </pre></div>
549
- <p>
550
- </p>
551
- <div class="variablelist"><table border="0">
552
- <col align="left" valign="top">
628
+ <div class="refsect3">
629
+ <a name="id-1.5.7.7.12.20"></a><h4>Parameters</h4>
630
+ <div class="informaltable"><table width="100%" border="0">
631
+ <colgroup>
632
+ <col width="150px" class="parameters_name">
633
+ <col class="parameters_description">
634
+ <col width="200px" class="parameters_annotations">
635
+ </colgroup>
553
636
  <tbody>
554
637
  <tr>
555
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
556
- <td>a PostScript <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
557
- </td>
638
+ <td class="parameter_name"><p>surface</p></td>
639
+ <td class="parameter_description"><p>a PostScript <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>
640
+ <td class="parameter_annotations"> </td>
558
641
  </tr>
559
642
  <tr>
560
- <td><p><span class="term"><em class="parameter"><code>comment</code></em> :</span></p></td>
561
- <td>a comment string to be emitted into the PostScript output</td>
643
+ <td class="parameter_name"><p>comment</p></td>
644
+ <td class="parameter_description"><p>a comment string to be emitted into the PostScript output</p></td>
645
+ <td class="parameter_annotations"> </td>
562
646
  </tr>
563
647
  </tbody>
564
648
  </table></div>
649
+ </div>
650
+ <p class="since">Since 1.2</p>
651
+ </div>
652
+ </div>
653
+ <div class="refsect1">
654
+ <a name="cairo-PostScript-Surfaces.other_details"></a><h2>Types and Values</h2>
655
+ <div class="refsect2">
656
+ <a name="CAIRO-HAS-PS-SURFACE:CAPS"></a><h3>CAIRO_HAS_PS_SURFACE</h3>
657
+ <pre class="programlisting">#define CAIRO_HAS_PS_SURFACE 1
658
+ </pre>
659
+ <p>Defined if the PostScript surface backend is available.
660
+ This macro can be used to conditionally compile backend-specific code.</p>
565
661
  <p class="since">Since 1.2</p>
566
662
  </div>
663
+ <hr>
664
+ <div class="refsect2">
665
+ <a name="cairo-ps-level-t"></a><h3>enum cairo_ps_level_t</h3>
666
+ <p><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> is used to describe the language level of the
667
+ PostScript Language Reference that a generated PostScript file will
668
+ conform to.</p>
669
+ <div class="refsect3">
670
+ <a name="id-1.5.7.8.3.4"></a><h4>Members</h4>
671
+ <div class="informaltable"><table width="100%" border="0">
672
+ <colgroup>
673
+ <col width="300px" class="enum_members_name">
674
+ <col class="enum_members_description">
675
+ <col width="200px" class="enum_members_annotations">
676
+ </colgroup>
677
+ <tbody>
678
+ <tr>
679
+ <td class="enum_member_name"><p><a name="CAIRO-PS-LEVEL-2:CAPS"></a>CAIRO_PS_LEVEL_2</p></td>
680
+ <td class="enum_member_description">
681
+ <p>The language level 2 of the PostScript specification. (Since 1.6)</p>
682
+ </td>
683
+ <td class="enum_member_annotations"> </td>
684
+ </tr>
685
+ <tr>
686
+ <td class="enum_member_name"><p><a name="CAIRO-PS-LEVEL-3:CAPS"></a>CAIRO_PS_LEVEL_3</p></td>
687
+ <td class="enum_member_description">
688
+ <p>The language level 3 of the PostScript specification. (Since 1.6)</p>
689
+ </td>
690
+ <td class="enum_member_annotations"> </td>
691
+ </tr>
692
+ </tbody>
693
+ </table></div>
694
+ </div>
695
+ <p class="since">Since 1.6</p>
696
+ </div>
567
697
  </div>
568
698
  <div class="refsect1">
569
699
  <a name="cairo-PostScript-Surfaces.see-also"></a><h2>See Also</h2>
570
- <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
700
+ <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>
571
701
  </div>
572
702
  </div>
573
703
  <div class="footer">
574
704
  <hr>
575
- Generated by GTK-Doc V1.18</div>
705
+ Generated by GTK-Doc V1.20</div>
576
706
  </body>
577
707
  </html>