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-Paths.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>Paths</title>
6
- <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
5
+ <title>Cairo: A Vector Graphics Library: Paths</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-drawing.html" title="Drawing">
9
9
  <link rel="prev" href="cairo-cairo-t.html" title="cairo_t">
10
10
  <link rel="next" href="cairo-cairo-pattern-t.html" title="cairo_pattern_t">
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-cairo-t.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="cairo-drawing.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-cairo-pattern-t.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-Paths.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#cairo-Paths.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-Paths.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19
+ <a href="#cairo-Paths.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-drawing.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23
+ <td><a accesskey="p" href="cairo-cairo-t.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24
+ <td><a accesskey="n" href="cairo-cairo-pattern-t.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-Paths"></a><div class="titlepage"></div>
31
28
  <div class="refnamediv"><table width="100%"><tr>
@@ -33,622 +30,614 @@
33
30
  <h2><span class="refentrytitle"><a name="cairo-Paths.top_of_page"></a>Paths</span></h2>
34
31
  <p>Paths — Creating paths and manipulating path data</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-Paths.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis"> <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a>;
41
- union <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t">cairo_path_data_t</a>;
42
- enum <a class="link" href="cairo-Paths.html#cairo-path-data-type-t" title="enum cairo_path_data_type_t">cairo_path_data_type_t</a>;
43
- <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="returnvalue">cairo_path_t</span></a> * <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()">cairo_copy_path</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);
44
- <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="returnvalue">cairo_path_t</span></a> * <a class="link" href="cairo-Paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()">cairo_copy_path_flat</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);
45
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-path-destroy" title="cairo_path_destroy ()">cairo_path_destroy</a> (<em class="parameter"><code><a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a> *path</code></em>);
46
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-append-path" title="cairo_append_path ()">cairo_append_path</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
47
- <em class="parameter"><code>const <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a> *path</code></em>);
48
- <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-Paths.html#cairo-has-current-point" title="cairo_has_current_point ()">cairo_has_current_point</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);
49
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-get-current-point" title="cairo_get_current_point ()">cairo_get_current_point</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
50
- <em class="parameter"><code><span class="type">double</span> *x</code></em>,
51
- <em class="parameter"><code><span class="type">double</span> *y</code></em>);
52
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-new-path" title="cairo_new_path ()">cairo_new_path</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);
53
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()">cairo_new_sub_path</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);
54
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()">cairo_close_path</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);
55
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-arc" title="cairo_arc ()">cairo_arc</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
56
- <em class="parameter"><code><span class="type">double</span> xc</code></em>,
57
- <em class="parameter"><code><span class="type">double</span> yc</code></em>,
58
- <em class="parameter"><code><span class="type">double</span> radius</code></em>,
59
- <em class="parameter"><code><span class="type">double</span> angle1</code></em>,
60
- <em class="parameter"><code><span class="type">double</span> angle2</code></em>);
61
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-arc-negative" title="cairo_arc_negative ()">cairo_arc_negative</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
62
- <em class="parameter"><code><span class="type">double</span> xc</code></em>,
63
- <em class="parameter"><code><span class="type">double</span> yc</code></em>,
64
- <em class="parameter"><code><span class="type">double</span> radius</code></em>,
65
- <em class="parameter"><code><span class="type">double</span> angle1</code></em>,
66
- <em class="parameter"><code><span class="type">double</span> angle2</code></em>);
67
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-curve-to" title="cairo_curve_to ()">cairo_curve_to</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
68
- <em class="parameter"><code><span class="type">double</span> x1</code></em>,
69
- <em class="parameter"><code><span class="type">double</span> y1</code></em>,
70
- <em class="parameter"><code><span class="type">double</span> x2</code></em>,
71
- <em class="parameter"><code><span class="type">double</span> y2</code></em>,
72
- <em class="parameter"><code><span class="type">double</span> x3</code></em>,
73
- <em class="parameter"><code><span class="type">double</span> y3</code></em>);
74
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()">cairo_line_to</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
75
- <em class="parameter"><code><span class="type">double</span> x</code></em>,
76
- <em class="parameter"><code><span class="type">double</span> y</code></em>);
77
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()">cairo_move_to</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
78
- <em class="parameter"><code><span class="type">double</span> x</code></em>,
79
- <em class="parameter"><code><span class="type">double</span> y</code></em>);
80
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-rectangle" title="cairo_rectangle ()">cairo_rectangle</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
81
- <em class="parameter"><code><span class="type">double</span> x</code></em>,
82
- <em class="parameter"><code><span class="type">double</span> y</code></em>,
83
- <em class="parameter"><code><span class="type">double</span> width</code></em>,
84
- <em class="parameter"><code><span class="type">double</span> height</code></em>);
85
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-glyph-path" title="cairo_glyph_path ()">cairo_glyph_path</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
86
- <em class="parameter"><code>const <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t"><span class="type">cairo_glyph_t</span></a> *glyphs</code></em>,
87
- <em class="parameter"><code><span class="type">int</span> num_glyphs</code></em>);
88
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-text-path" title="cairo_text_path ()">cairo_text_path</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
89
- <em class="parameter"><code>const <span class="type">char</span> *utf8</code></em>);
90
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-rel-curve-to" title="cairo_rel_curve_to ()">cairo_rel_curve_to</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
91
- <em class="parameter"><code><span class="type">double</span> dx1</code></em>,
92
- <em class="parameter"><code><span class="type">double</span> dy1</code></em>,
93
- <em class="parameter"><code><span class="type">double</span> dx2</code></em>,
94
- <em class="parameter"><code><span class="type">double</span> dy2</code></em>,
95
- <em class="parameter"><code><span class="type">double</span> dx3</code></em>,
96
- <em class="parameter"><code><span class="type">double</span> dy3</code></em>);
97
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-rel-line-to" title="cairo_rel_line_to ()">cairo_rel_line_to</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
98
- <em class="parameter"><code><span class="type">double</span> dx</code></em>,
99
- <em class="parameter"><code><span class="type">double</span> dy</code></em>);
100
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-rel-move-to" title="cairo_rel_move_to ()">cairo_rel_move_to</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
101
- <em class="parameter"><code><span class="type">double</span> dx</code></em>,
102
- <em class="parameter"><code><span class="type">double</span> dy</code></em>);
103
- <span class="returnvalue">void</span> <a class="link" href="cairo-Paths.html#cairo-path-extents" title="cairo_path_extents ()">cairo_path_extents</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
104
- <em class="parameter"><code><span class="type">double</span> *x1</code></em>,
105
- <em class="parameter"><code><span class="type">double</span> *y1</code></em>,
106
- <em class="parameter"><code><span class="type">double</span> *x2</code></em>,
107
- <em class="parameter"><code><span class="type">double</span> *y2</code></em>);
108
- </pre>
109
- </div>
110
- <div class="refsect1">
111
- <a name="cairo-Paths.description"></a><h2>Description</h2>
112
- <p>
113
- Paths are the most basic drawing tools and are primarily used to implicitly
114
- generate simple masks.
115
- </p>
116
- </div>
117
35
  <div class="refsect1">
118
- <a name="cairo-Paths.details"></a><h2>Details</h2>
119
- <div class="refsect2">
120
- <a name="cairo-path-t"></a><h3>cairo_path_t</h3>
121
- <pre class="programlisting">typedef struct {
122
- cairo_status_t status;
123
- cairo_path_data_t *data;
124
- int num_data;
125
- } cairo_path_t;
126
- </pre>
127
- <p>
128
- A data structure for holding a path. This data structure serves as
129
- the return value for <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> and
130
- <a class="link" href="cairo-Paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()"><code class="function">cairo_copy_path_flat()</code></a> as well the input value for
131
- <a class="link" href="cairo-Paths.html#cairo-append-path" title="cairo_append_path ()"><code class="function">cairo_append_path()</code></a>.
132
- </p>
133
- <p>
134
- See <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for hints on how to iterate over the
135
- actual data within the path.
136
- </p>
137
- <p>
138
- The num_data member gives the number of elements in the data
139
- array. This number is larger than the number of independent path
140
- portions (defined in <a class="link" href="cairo-Paths.html#cairo-path-data-type-t" title="enum cairo_path_data_type_t"><span class="type">cairo_path_data_type_t</span></a>), since the data
141
- includes both headers and coordinates for each portion.
142
- </p>
143
- <div class="variablelist"><table border="0">
144
- <col align="left" valign="top">
36
+ <a name="cairo-Paths.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>
145
42
  <tbody>
146
43
  <tr>
147
- <td><p><span class="term"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="type">cairo_status_t</span></a> <em class="structfield"><code><a name="cairo-path-t.status"></a>status</code></em>;</span></p></td>
148
- <td>the current error status</td>
44
+ <td class="function_type">
45
+ <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="returnvalue">cairo_path_t</span></a> *
46
+ </td>
47
+ <td class="function_name">
48
+ <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()">cairo_copy_path</a> <span class="c_punctuation">()</span>
49
+ </td>
149
50
  </tr>
150
51
  <tr>
151
- <td><p><span class="term"><a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> *<em class="structfield"><code><a name="cairo-path-t.data"></a>data</code></em>;</span></p></td>
152
- <td>the elements in the path</td>
52
+ <td class="function_type">
53
+ <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="returnvalue">cairo_path_t</span></a> *
54
+ </td>
55
+ <td class="function_name">
56
+ <a class="link" href="cairo-Paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()">cairo_copy_path_flat</a> <span class="c_punctuation">()</span>
57
+ </td>
153
58
  </tr>
154
59
  <tr>
155
- <td><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="cairo-path-t.num-data"></a>num_data</code></em>;</span></p></td>
156
- <td>the number of elements in the data array</td>
60
+ <td class="function_type">
61
+ <span class="returnvalue">void</span>
62
+ </td>
63
+ <td class="function_name">
64
+ <a class="link" href="cairo-Paths.html#cairo-path-destroy" title="cairo_path_destroy ()">cairo_path_destroy</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-Paths.html#cairo-append-path" title="cairo_append_path ()">cairo_append_path</a> <span class="c_punctuation">()</span>
73
+ </td>
74
+ </tr>
75
+ <tr>
76
+ <td class="function_type">
77
+ <a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
78
+ </td>
79
+ <td class="function_name">
80
+ <a class="link" href="cairo-Paths.html#cairo-has-current-point" title="cairo_has_current_point ()">cairo_has_current_point</a> <span class="c_punctuation">()</span>
81
+ </td>
82
+ </tr>
83
+ <tr>
84
+ <td class="function_type">
85
+ <span class="returnvalue">void</span>
86
+ </td>
87
+ <td class="function_name">
88
+ <a class="link" href="cairo-Paths.html#cairo-get-current-point" title="cairo_get_current_point ()">cairo_get_current_point</a> <span class="c_punctuation">()</span>
89
+ </td>
90
+ </tr>
91
+ <tr>
92
+ <td class="function_type">
93
+ <span class="returnvalue">void</span>
94
+ </td>
95
+ <td class="function_name">
96
+ <a class="link" href="cairo-Paths.html#cairo-new-path" title="cairo_new_path ()">cairo_new_path</a> <span class="c_punctuation">()</span>
97
+ </td>
98
+ </tr>
99
+ <tr>
100
+ <td class="function_type">
101
+ <span class="returnvalue">void</span>
102
+ </td>
103
+ <td class="function_name">
104
+ <a class="link" href="cairo-Paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()">cairo_new_sub_path</a> <span class="c_punctuation">()</span>
105
+ </td>
106
+ </tr>
107
+ <tr>
108
+ <td class="function_type">
109
+ <span class="returnvalue">void</span>
110
+ </td>
111
+ <td class="function_name">
112
+ <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()">cairo_close_path</a> <span class="c_punctuation">()</span>
113
+ </td>
114
+ </tr>
115
+ <tr>
116
+ <td class="function_type">
117
+ <span class="returnvalue">void</span>
118
+ </td>
119
+ <td class="function_name">
120
+ <a class="link" href="cairo-Paths.html#cairo-arc" title="cairo_arc ()">cairo_arc</a> <span class="c_punctuation">()</span>
121
+ </td>
122
+ </tr>
123
+ <tr>
124
+ <td class="function_type">
125
+ <span class="returnvalue">void</span>
126
+ </td>
127
+ <td class="function_name">
128
+ <a class="link" href="cairo-Paths.html#cairo-arc-negative" title="cairo_arc_negative ()">cairo_arc_negative</a> <span class="c_punctuation">()</span>
129
+ </td>
130
+ </tr>
131
+ <tr>
132
+ <td class="function_type">
133
+ <span class="returnvalue">void</span>
134
+ </td>
135
+ <td class="function_name">
136
+ <a class="link" href="cairo-Paths.html#cairo-curve-to" title="cairo_curve_to ()">cairo_curve_to</a> <span class="c_punctuation">()</span>
137
+ </td>
138
+ </tr>
139
+ <tr>
140
+ <td class="function_type">
141
+ <span class="returnvalue">void</span>
142
+ </td>
143
+ <td class="function_name">
144
+ <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()">cairo_line_to</a> <span class="c_punctuation">()</span>
145
+ </td>
146
+ </tr>
147
+ <tr>
148
+ <td class="function_type">
149
+ <span class="returnvalue">void</span>
150
+ </td>
151
+ <td class="function_name">
152
+ <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()">cairo_move_to</a> <span class="c_punctuation">()</span>
153
+ </td>
154
+ </tr>
155
+ <tr>
156
+ <td class="function_type">
157
+ <span class="returnvalue">void</span>
158
+ </td>
159
+ <td class="function_name">
160
+ <a class="link" href="cairo-Paths.html#cairo-rectangle" title="cairo_rectangle ()">cairo_rectangle</a> <span class="c_punctuation">()</span>
161
+ </td>
162
+ </tr>
163
+ <tr>
164
+ <td class="function_type">
165
+ <span class="returnvalue">void</span>
166
+ </td>
167
+ <td class="function_name">
168
+ <a class="link" href="cairo-Paths.html#cairo-glyph-path" title="cairo_glyph_path ()">cairo_glyph_path</a> <span class="c_punctuation">()</span>
169
+ </td>
157
170
  </tr>
158
- </tbody>
159
- </table></div>
160
- <p class="since">Since 1.0</p>
161
- </div>
162
- <hr>
163
- <div class="refsect2">
164
- <a name="cairo-path-data-t"></a><h3>union cairo_path_data_t</h3>
165
- <pre class="programlisting">union _cairo_path_data_t {
166
- struct {
167
- cairo_path_data_type_t type;
168
- int length;
169
- } header;
170
- struct {
171
- double x, y;
172
- } point;
173
- };
174
- </pre>
175
- <p>
176
- <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> is used to represent the path data inside a
177
- <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>.
178
- </p>
179
- <p>
180
- The data structure is designed to try to balance the demands of
181
- efficiency and ease-of-use. A path is represented as an array of
182
- <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a>, which is a union of headers and points.
183
- </p>
184
- <p>
185
- Each portion of the path is represented by one or more elements in
186
- the array, (one header followed by 0 or more points). The length
187
- value of the header is the number of array elements for the current
188
- portion including the header, (ie. length == 1 + # of points), and
189
- where the number of points for each element type is as follows:
190
- </p>
191
- <p>
192
- </p>
193
- <pre class="programlisting">
194
- %CAIRO_PATH_MOVE_TO: 1 point
195
- %CAIRO_PATH_LINE_TO: 1 point
196
- %CAIRO_PATH_CURVE_TO: 3 points
197
- %CAIRO_PATH_CLOSE_PATH: 0 points
198
- </pre>
199
- <p>
200
- </p>
201
- <p>
202
- The semantics and ordering of the coordinate values are consistent
203
- with <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>, and
204
- <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a>.
205
- </p>
206
- <p>
207
- Here is sample code for iterating through a <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>:
208
- </p>
209
- <p>
210
- </p>
211
- <div class="informalexample"><pre class="programlisting">
212
- int i;
213
- cairo_path_t *path;
214
- cairo_path_data_t *data;
215
-  
216
- path = cairo_copy_path (cr);
217
-  
218
- for (i=0; i &lt; path-&gt;num_data; i += path-&gt;data[i].header.length) {
219
- data = &amp;path-&gt;data[i];
220
- switch (data-&gt;header.type) {
221
- case CAIRO_PATH_MOVE_TO:
222
- do_move_to_things (data[1].point.x, data[1].point.y);
223
- break;
224
- case CAIRO_PATH_LINE_TO:
225
- do_line_to_things (data[1].point.x, data[1].point.y);
226
- break;
227
- case CAIRO_PATH_CURVE_TO:
228
- do_curve_to_things (data[1].point.x, data[1].point.y,
229
- data[2].point.x, data[2].point.y,
230
- data[3].point.x, data[3].point.y);
231
- break;
232
- case CAIRO_PATH_CLOSE_PATH:
233
- do_close_path_things ();
234
- break;
235
- }
236
- }
237
- cairo_path_destroy (path);
238
- </pre></div>
239
- <p>
240
- </p>
241
- <p>
242
- As of cairo 1.4, cairo does not mind if there are more elements in
243
- a portion of the path than needed. Such elements can be used by
244
- users of the cairo API to hold extra values in the path data
245
- structure. For this reason, it is recommended that applications
246
- always use <code class="literal">data-&gt;header.length</code> to
247
- iterate over the path data, instead of hardcoding the number of
248
- elements for each element type.
249
- </p>
250
- <p class="since">Since 1.0</p>
251
- </div>
252
- <hr>
253
- <div class="refsect2">
254
- <a name="cairo-path-data-type-t"></a><h3>enum cairo_path_data_type_t</h3>
255
- <pre class="programlisting">typedef enum {
256
- CAIRO_PATH_MOVE_TO,
257
- CAIRO_PATH_LINE_TO,
258
- CAIRO_PATH_CURVE_TO,
259
- CAIRO_PATH_CLOSE_PATH
260
- } cairo_path_data_type_t;
261
- </pre>
262
- <p>
263
- <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> is used to describe the type of one portion
264
- of a path when represented as a <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>.
265
- See <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for details.
266
- </p>
267
- <div class="variablelist"><table border="0">
268
- <col align="left" valign="top">
269
- <tbody>
270
171
  <tr>
271
- <td><p><a name="CAIRO-PATH-MOVE-TO:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_MOVE_TO</code></span></p></td>
272
- <td>A move-to operation, since 1.0
172
+ <td class="function_type">
173
+ <span class="returnvalue">void</span>
174
+ </td>
175
+ <td class="function_name">
176
+ <a class="link" href="cairo-Paths.html#cairo-text-path" title="cairo_text_path ()">cairo_text_path</a> <span class="c_punctuation">()</span>
177
+ </td>
178
+ </tr>
179
+ <tr>
180
+ <td class="function_type">
181
+ <span class="returnvalue">void</span>
182
+ </td>
183
+ <td class="function_name">
184
+ <a class="link" href="cairo-Paths.html#cairo-rel-curve-to" title="cairo_rel_curve_to ()">cairo_rel_curve_to</a> <span class="c_punctuation">()</span>
273
185
  </td>
274
186
  </tr>
275
187
  <tr>
276
- <td><p><a name="CAIRO-PATH-LINE-TO:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_LINE_TO</code></span></p></td>
277
- <td>A line-to operation, since 1.0
188
+ <td class="function_type">
189
+ <span class="returnvalue">void</span>
190
+ </td>
191
+ <td class="function_name">
192
+ <a class="link" href="cairo-Paths.html#cairo-rel-line-to" title="cairo_rel_line_to ()">cairo_rel_line_to</a> <span class="c_punctuation">()</span>
278
193
  </td>
279
194
  </tr>
280
195
  <tr>
281
- <td><p><a name="CAIRO-PATH-CURVE-TO:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_CURVE_TO</code></span></p></td>
282
- <td>A curve-to operation, since 1.0
196
+ <td class="function_type">
197
+ <span class="returnvalue">void</span>
198
+ </td>
199
+ <td class="function_name">
200
+ <a class="link" href="cairo-Paths.html#cairo-rel-move-to" title="cairo_rel_move_to ()">cairo_rel_move_to</a> <span class="c_punctuation">()</span>
283
201
  </td>
284
202
  </tr>
285
203
  <tr>
286
- <td><p><a name="CAIRO-PATH-CLOSE-PATH:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_CLOSE_PATH</code></span></p></td>
287
- <td>A close-path operation, since 1.0
204
+ <td class="function_type">
205
+ <span class="returnvalue">void</span>
206
+ </td>
207
+ <td class="function_name">
208
+ <a class="link" href="cairo-Paths.html#cairo-path-extents" title="cairo_path_extents ()">cairo_path_extents</a> <span class="c_punctuation">()</span>
288
209
  </td>
289
210
  </tr>
290
211
  </tbody>
291
212
  </table></div>
292
- <p class="since">Since 1.0</p>
293
213
  </div>
294
- <hr>
214
+ <div class="refsect1">
215
+ <a name="cairo-Paths.other"></a><h2>Types and Values</h2>
216
+ <div class="informaltable"><table width="100%" border="0">
217
+ <colgroup>
218
+ <col width="150px" class="name">
219
+ <col class="description">
220
+ </colgroup>
221
+ <tbody>
222
+ <tr>
223
+ <td class="datatype_keyword"> </td>
224
+ <td class="function_name"><a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t">cairo_path_t</a></td>
225
+ </tr>
226
+ <tr>
227
+ <td class="datatype_keyword">union</td>
228
+ <td class="function_name"><a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t">cairo_path_data_t</a></td>
229
+ </tr>
230
+ <tr>
231
+ <td class="datatype_keyword">enum</td>
232
+ <td class="function_name"><a class="link" href="cairo-Paths.html#cairo-path-data-type-t" title="enum cairo_path_data_type_t">cairo_path_data_type_t</a></td>
233
+ </tr>
234
+ </tbody>
235
+ </table></div>
236
+ </div>
237
+ <div class="refsect1">
238
+ <a name="cairo-Paths.object-hierarchy"></a><h2>Object Hierarchy</h2>
239
+ <pre class="screen">
240
+ </pre>
241
+ </div>
242
+ <div class="refsect1">
243
+ <a name="cairo-Paths.description"></a><h2>Description</h2>
244
+ <p>Paths are the most basic drawing tools and are primarily used to implicitly
245
+ generate simple masks.</p>
246
+ </div>
247
+ <div class="refsect1">
248
+ <a name="cairo-Paths.functions_details"></a><h2>Functions</h2>
295
249
  <div class="refsect2">
296
- <a name="cairo-copy-path"></a><h3>cairo_copy_path ()</h3>
297
- <pre class="programlisting"><a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="returnvalue">cairo_path_t</span></a> * cairo_copy_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
298
- <p>
299
- Creates a copy of the current path and returns it to the user as a
250
+ <a name="cairo-copy-path"></a><h3>cairo_copy_path ()</h3>
251
+ <pre class="programlisting"><a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="returnvalue">cairo_path_t</span></a> *
252
+ cairo_copy_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
253
+ <p>Creates a copy of the current path and returns it to the user as a
300
254
  <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>. See <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for hints on how to iterate
301
- over the returned data structure.
302
- </p>
303
- <p>
304
- This function will always return a valid pointer, but the result
305
- will have no data (<code class="literal">data==<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></code> and
255
+ over the returned data structure.</p>
256
+ <p>This function will always return a valid pointer, but the result
257
+ will have no data (<code class="literal">data==<code class="literal">NULL</code></code> and
306
258
  <code class="literal">num_data==0</code>), if either of the following
307
- conditions hold:
308
- </p>
309
- <p>
310
- </p>
259
+ conditions hold:</p>
311
260
  <div class="orderedlist"><ol class="orderedlist" type="1">
312
261
  <li class="listitem">If there is insufficient memory to copy the path. In this
313
262
  case <code class="literal">path-&gt;status</code> will be set to
314
263
  <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>.</li>
315
264
  <li class="listitem">If <em class="parameter"><code>cr</code></em> is already in an error state. In this case
316
265
  <code class="literal">path-&gt;status</code> will contain the same status that
317
- would be returned by <a class="link" href="cairo-cairo-t.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a>.</li>
266
+ would be returned by <a class="link" href="cairo-cairo-t.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a>.</li>
318
267
  </ol></div>
319
- <p>
320
- </p>
321
- <div class="variablelist"><table border="0">
322
- <col align="left" valign="top">
323
- <tbody>
324
- <tr>
325
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
326
- <td>a cairo context</td>
327
- </tr>
328
- <tr>
329
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
330
- <td>the copy of the current path. The caller owns the
331
- returned object and should call <a class="link" href="cairo-Paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> when finished
332
- with it.</td>
333
- </tr>
334
- </tbody>
268
+ <div class="refsect3">
269
+ <a name="id-1.3.3.7.2.7"></a><h4>Parameters</h4>
270
+ <div class="informaltable"><table width="100%" border="0">
271
+ <colgroup>
272
+ <col width="150px" class="parameters_name">
273
+ <col class="parameters_description">
274
+ <col width="200px" class="parameters_annotations">
275
+ </colgroup>
276
+ <tbody><tr>
277
+ <td class="parameter_name"><p>cr</p></td>
278
+ <td class="parameter_description"><p>a cairo context</p></td>
279
+ <td class="parameter_annotations"> </td>
280
+ </tr></tbody>
335
281
  </table></div>
282
+ </div>
283
+ <div class="refsect3">
284
+ <a name="id-1.3.3.7.2.8"></a><h4>Returns</h4>
285
+ <p> the copy of the current path. The caller owns the
286
+ returned object and should call <a class="link" href="cairo-Paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> when finished
287
+ with it.</p>
288
+ <p></p>
289
+ </div>
336
290
  <p class="since">Since 1.0</p>
337
291
  </div>
338
292
  <hr>
339
293
  <div class="refsect2">
340
- <a name="cairo-copy-path-flat"></a><h3>cairo_copy_path_flat ()</h3>
341
- <pre class="programlisting"><a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="returnvalue">cairo_path_t</span></a> * cairo_copy_path_flat (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
342
- <p>
343
- Gets a flattened copy of the current path and returns it to the
294
+ <a name="cairo-copy-path-flat"></a><h3>cairo_copy_path_flat ()</h3>
295
+ <pre class="programlisting"><a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="returnvalue">cairo_path_t</span></a> *
296
+ cairo_copy_path_flat (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
297
+ <p>Gets a flattened copy of the current path and returns it to the
344
298
  user as a <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>. See <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for hints on
345
- how to iterate over the returned data structure.
346
- </p>
347
- <p>
348
- This function is like <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> except that any curves
299
+ how to iterate over the returned data structure.</p>
300
+ <p>This function is like <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> except that any curves
349
301
  in the path will be approximated with piecewise-linear
350
302
  approximations, (accurate to within the current tolerance
351
303
  value). That is, the result is guaranteed to not have any elements
352
304
  of type <a class="link" href="cairo-Paths.html#CAIRO-PATH-CURVE-TO:CAPS"><code class="literal">CAIRO_PATH_CURVE_TO</code></a> which will instead be replaced by a
353
- series of <a class="link" href="cairo-Paths.html#CAIRO-PATH-LINE-TO:CAPS"><code class="literal">CAIRO_PATH_LINE_TO</code></a> elements.
354
- </p>
355
- <p>
356
- This function will always return a valid pointer, but the result
357
- will have no data (<code class="literal">data==<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></code> and
305
+ series of <a class="link" href="cairo-Paths.html#CAIRO-PATH-LINE-TO:CAPS"><code class="literal">CAIRO_PATH_LINE_TO</code></a> elements.</p>
306
+ <p>This function will always return a valid pointer, but the result
307
+ will have no data (<code class="literal">data==<code class="literal">NULL</code></code> and
358
308
  <code class="literal">num_data==0</code>), if either of the following
359
- conditions hold:
360
- </p>
361
- <p>
362
- </p>
309
+ conditions hold:</p>
363
310
  <div class="orderedlist"><ol class="orderedlist" type="1">
364
311
  <li class="listitem">If there is insufficient memory to copy the path. In this
365
312
  case <code class="literal">path-&gt;status</code> will be set to
366
313
  <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>.</li>
367
314
  <li class="listitem">If <em class="parameter"><code>cr</code></em> is already in an error state. In this case
368
315
  <code class="literal">path-&gt;status</code> will contain the same status that
369
- would be returned by <a class="link" href="cairo-cairo-t.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a>.</li>
316
+ would be returned by <a class="link" href="cairo-cairo-t.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a>.</li>
370
317
  </ol></div>
371
- <p>
372
- </p>
373
- <div class="variablelist"><table border="0">
374
- <col align="left" valign="top">
375
- <tbody>
376
- <tr>
377
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
378
- <td>a cairo context</td>
379
- </tr>
380
- <tr>
381
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
382
- <td>the copy of the current path. The caller owns the
383
- returned object and should call <a class="link" href="cairo-Paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> when finished
384
- with it.</td>
385
- </tr>
386
- </tbody>
318
+ <div class="refsect3">
319
+ <a name="id-1.3.3.7.3.8"></a><h4>Parameters</h4>
320
+ <div class="informaltable"><table width="100%" border="0">
321
+ <colgroup>
322
+ <col width="150px" class="parameters_name">
323
+ <col class="parameters_description">
324
+ <col width="200px" class="parameters_annotations">
325
+ </colgroup>
326
+ <tbody><tr>
327
+ <td class="parameter_name"><p>cr</p></td>
328
+ <td class="parameter_description"><p>a cairo context</p></td>
329
+ <td class="parameter_annotations"> </td>
330
+ </tr></tbody>
387
331
  </table></div>
332
+ </div>
333
+ <div class="refsect3">
334
+ <a name="id-1.3.3.7.3.9"></a><h4>Returns</h4>
335
+ <p> the copy of the current path. The caller owns the
336
+ returned object and should call <a class="link" href="cairo-Paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> when finished
337
+ with it.</p>
338
+ <p></p>
339
+ </div>
388
340
  <p class="since">Since 1.0</p>
389
341
  </div>
390
342
  <hr>
391
343
  <div class="refsect2">
392
- <a name="cairo-path-destroy"></a><h3>cairo_path_destroy ()</h3>
393
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_path_destroy (<em class="parameter"><code><a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a> *path</code></em>);</pre>
394
- <p>
395
- Immediately releases all memory associated with <em class="parameter"><code>path</code></em>. After a call
396
- to <a class="link" href="cairo-Paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> the <em class="parameter"><code>path</code></em> pointer is no longer valid and
397
- should not be used further.
398
- </p>
399
- <p>
400
- Note: <a class="link" href="cairo-Paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> should only be called with a
344
+ <a name="cairo-path-destroy"></a><h3>cairo_path_destroy ()</h3>
345
+ <pre class="programlisting"><span class="returnvalue">void</span>
346
+ cairo_path_destroy (<em class="parameter"><code><a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a> *path</code></em>);</pre>
347
+ <p>Immediately releases all memory associated with <em class="parameter"><code>path</code></em>
348
+ . After a call
349
+ to <a class="link" href="cairo-Paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> the <em class="parameter"><code>path</code></em>
350
+ pointer is no longer valid and
351
+ should not be used further.</p>
352
+ <p>Note: <a class="link" href="cairo-Paths.html#cairo-path-destroy" title="cairo_path_destroy ()"><code class="function">cairo_path_destroy()</code></a> should only be called with a
401
353
  pointer to a <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a> returned by a cairo function. Any path
402
354
  that is created manually (ie. outside of cairo) should be destroyed
403
- manually as well.
404
- </p>
405
- <div class="variablelist"><table border="0">
406
- <col align="left" valign="top">
355
+ manually as well.</p>
356
+ <div class="refsect3">
357
+ <a name="id-1.3.3.7.4.6"></a><h4>Parameters</h4>
358
+ <div class="informaltable"><table width="100%" border="0">
359
+ <colgroup>
360
+ <col width="150px" class="parameters_name">
361
+ <col class="parameters_description">
362
+ <col width="200px" class="parameters_annotations">
363
+ </colgroup>
407
364
  <tbody><tr>
408
- <td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
409
- <td>a path previously returned by either <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> or
410
- <a class="link" href="cairo-Paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()"><code class="function">cairo_copy_path_flat()</code></a>.</td>
365
+ <td class="parameter_name"><p>path</p></td>
366
+ <td class="parameter_description"><p>a path previously returned by either <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> or
367
+ <a class="link" href="cairo-Paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()"><code class="function">cairo_copy_path_flat()</code></a>.</p></td>
368
+ <td class="parameter_annotations"> </td>
411
369
  </tr></tbody>
412
370
  </table></div>
371
+ </div>
413
372
  <p class="since">Since 1.0</p>
414
373
  </div>
415
374
  <hr>
416
375
  <div class="refsect2">
417
- <a name="cairo-append-path"></a><h3>cairo_append_path ()</h3>
418
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_append_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
419
- <em class="parameter"><code>const <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a> *path</code></em>);</pre>
420
- <p>
421
- Append the <em class="parameter"><code>path</code></em> onto the current path. The <em class="parameter"><code>path</code></em> may be either the
422
- return value from one of <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> or
423
- <a class="link" href="cairo-Paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()"><code class="function">cairo_copy_path_flat()</code></a> or it may be constructed manually. See
376
+ <a name="cairo-append-path"></a><h3>cairo_append_path ()</h3>
377
+ <pre class="programlisting"><span class="returnvalue">void</span>
378
+ cairo_append_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
379
+ <em class="parameter"><code>const <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a> *path</code></em>);</pre>
380
+ <p>Append the <em class="parameter"><code>path</code></em>
381
+ onto the current path. The <em class="parameter"><code>path</code></em>
382
+ may be either the
383
+ return value from one of <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> or
384
+ <a class="link" href="cairo-Paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()"><code class="function">cairo_copy_path_flat()</code></a> or it may be constructed manually. See
424
385
  <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a> for details on how the path data structure should be
425
386
  initialized, and note that <code class="literal">path-&gt;status</code> must be
426
- initialized to <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>.
427
- </p>
428
- <div class="variablelist"><table border="0">
429
- <col align="left" valign="top">
387
+ initialized to <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>.</p>
388
+ <div class="refsect3">
389
+ <a name="id-1.3.3.7.5.5"></a><h4>Parameters</h4>
390
+ <div class="informaltable"><table width="100%" border="0">
391
+ <colgroup>
392
+ <col width="150px" class="parameters_name">
393
+ <col class="parameters_description">
394
+ <col width="200px" class="parameters_annotations">
395
+ </colgroup>
430
396
  <tbody>
431
397
  <tr>
432
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
433
- <td>a cairo context</td>
398
+ <td class="parameter_name"><p>cr</p></td>
399
+ <td class="parameter_description"><p>a cairo context</p></td>
400
+ <td class="parameter_annotations"> </td>
434
401
  </tr>
435
402
  <tr>
436
- <td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
437
- <td>path to be appended</td>
403
+ <td class="parameter_name"><p>path</p></td>
404
+ <td class="parameter_description"><p>path to be appended</p></td>
405
+ <td class="parameter_annotations"> </td>
438
406
  </tr>
439
407
  </tbody>
440
408
  </table></div>
409
+ </div>
441
410
  <p class="since">Since 1.0</p>
442
411
  </div>
443
412
  <hr>
444
413
  <div class="refsect2">
445
- <a name="cairo-has-current-point"></a><h3>cairo_has_current_point ()</h3>
446
- <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_has_current_point (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
447
- <p>
448
- Returns whether a current point is defined on the current path.
449
- See <a class="link" href="cairo-Paths.html#cairo-get-current-point" title="cairo_get_current_point ()"><code class="function">cairo_get_current_point()</code></a> for details on the current point.
450
- </p>
451
- <div class="variablelist"><table border="0">
452
- <col align="left" valign="top">
453
- <tbody>
454
- <tr>
455
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
456
- <td>a cairo context</td>
457
- </tr>
458
- <tr>
459
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
460
- <td>whether a current point is defined.</td>
461
- </tr>
462
- </tbody>
414
+ <a name="cairo-has-current-point"></a><h3>cairo_has_current_point ()</h3>
415
+ <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>
416
+ cairo_has_current_point (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
417
+ <p>Returns whether a current point is defined on the current path.
418
+ See <a class="link" href="cairo-Paths.html#cairo-get-current-point" title="cairo_get_current_point ()"><code class="function">cairo_get_current_point()</code></a> for details on the current point.</p>
419
+ <div class="refsect3">
420
+ <a name="id-1.3.3.7.6.5"></a><h4>Parameters</h4>
421
+ <div class="informaltable"><table width="100%" border="0">
422
+ <colgroup>
423
+ <col width="150px" class="parameters_name">
424
+ <col class="parameters_description">
425
+ <col width="200px" class="parameters_annotations">
426
+ </colgroup>
427
+ <tbody><tr>
428
+ <td class="parameter_name"><p>cr</p></td>
429
+ <td class="parameter_description"><p>a cairo context</p></td>
430
+ <td class="parameter_annotations"> </td>
431
+ </tr></tbody>
463
432
  </table></div>
433
+ </div>
434
+ <div class="refsect3">
435
+ <a name="id-1.3.3.7.6.6"></a><h4>Returns</h4>
436
+ <p> whether a current point is defined.</p>
437
+ <p></p>
438
+ </div>
464
439
  <p class="since">Since 1.6</p>
465
440
  </div>
466
441
  <hr>
467
442
  <div class="refsect2">
468
- <a name="cairo-get-current-point"></a><h3>cairo_get_current_point ()</h3>
469
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_get_current_point (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
470
- <em class="parameter"><code><span class="type">double</span> *x</code></em>,
471
- <em class="parameter"><code><span class="type">double</span> *y</code></em>);</pre>
472
- <p>
473
- Gets the current point of the current path, which is
474
- conceptually the final point reached by the path so far.
475
- </p>
476
- <p>
477
- The current point is returned in the user-space coordinate
478
- system. If there is no defined current point or if <em class="parameter"><code>cr</code></em> is in an
479
- error status, <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em> will both be set to 0.0. It is possible to
480
- check this in advance with <a class="link" href="cairo-Paths.html#cairo-has-current-point" title="cairo_has_current_point ()"><code class="function">cairo_has_current_point()</code></a>.
481
- </p>
482
- <p>
483
- Most path construction functions alter the current point. See the
443
+ <a name="cairo-get-current-point"></a><h3>cairo_get_current_point ()</h3>
444
+ <pre class="programlisting"><span class="returnvalue">void</span>
445
+ cairo_get_current_point (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
446
+ <em class="parameter"><code><span class="type">double</span> *x</code></em>,
447
+ <em class="parameter"><code><span class="type">double</span> *y</code></em>);</pre>
448
+ <p>Gets the current point of the current path, which is
449
+ conceptually the final point reached by the path so far.</p>
450
+ <p>The current point is returned in the user-space coordinate
451
+ system. If there is no defined current point or if <em class="parameter"><code>cr</code></em>
452
+ is in an
453
+ error status, <em class="parameter"><code>x</code></em>
454
+ and <em class="parameter"><code>y</code></em>
455
+ will both be set to 0.0. It is possible to
456
+ check this in advance with <a class="link" href="cairo-Paths.html#cairo-has-current-point" title="cairo_has_current_point ()"><code class="function">cairo_has_current_point()</code></a>.</p>
457
+ <p>Most path construction functions alter the current point. See the
484
458
  following for details on how they affect the current point:
485
- <a class="link" href="cairo-Paths.html#cairo-new-path" title="cairo_new_path ()"><code class="function">cairo_new_path()</code></a>, <a class="link" href="cairo-Paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()"><code class="function">cairo_new_sub_path()</code></a>,
486
- <a class="link" href="cairo-Paths.html#cairo-append-path" title="cairo_append_path ()"><code class="function">cairo_append_path()</code></a>, <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a>,
487
- <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>,
488
- <a class="link" href="cairo-Paths.html#cairo-rel-move-to" title="cairo_rel_move_to ()"><code class="function">cairo_rel_move_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-rel-line-to" title="cairo_rel_line_to ()"><code class="function">cairo_rel_line_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-rel-curve-to" title="cairo_rel_curve_to ()"><code class="function">cairo_rel_curve_to()</code></a>,
489
- <a class="link" href="cairo-Paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a>, <a class="link" href="cairo-Paths.html#cairo-arc-negative" title="cairo_arc_negative ()"><code class="function">cairo_arc_negative()</code></a>, <a class="link" href="cairo-Paths.html#cairo-rectangle" title="cairo_rectangle ()"><code class="function">cairo_rectangle()</code></a>,
490
- <a class="link" href="cairo-Paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a>, <a class="link" href="cairo-Paths.html#cairo-glyph-path" title="cairo_glyph_path ()"><code class="function">cairo_glyph_path()</code></a>, <code class="function">cairo_stroke_to_path()</code>.
491
- </p>
492
- <p>
493
- Some functions use and alter the current point but do not
459
+ <a class="link" href="cairo-Paths.html#cairo-new-path" title="cairo_new_path ()"><code class="function">cairo_new_path()</code></a>, <a class="link" href="cairo-Paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()"><code class="function">cairo_new_sub_path()</code></a>,
460
+ <a class="link" href="cairo-Paths.html#cairo-append-path" title="cairo_append_path ()"><code class="function">cairo_append_path()</code></a>, <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a>,
461
+ <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>,
462
+ <a class="link" href="cairo-Paths.html#cairo-rel-move-to" title="cairo_rel_move_to ()"><code class="function">cairo_rel_move_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-rel-line-to" title="cairo_rel_line_to ()"><code class="function">cairo_rel_line_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-rel-curve-to" title="cairo_rel_curve_to ()"><code class="function">cairo_rel_curve_to()</code></a>,
463
+ <a class="link" href="cairo-Paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a>, <a class="link" href="cairo-Paths.html#cairo-arc-negative" title="cairo_arc_negative ()"><code class="function">cairo_arc_negative()</code></a>, <a class="link" href="cairo-Paths.html#cairo-rectangle" title="cairo_rectangle ()"><code class="function">cairo_rectangle()</code></a>,
464
+ <a class="link" href="cairo-Paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a>, <a class="link" href="cairo-Paths.html#cairo-glyph-path" title="cairo_glyph_path ()"><code class="function">cairo_glyph_path()</code></a>, <code class="function">cairo_stroke_to_path()</code>.</p>
465
+ <p>Some functions use and alter the current point but do not
494
466
  otherwise change current path:
495
- <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.
496
- </p>
497
- <p>
498
- Some functions unset the current path and as a result, current point:
499
- <a class="link" href="cairo-cairo-t.html#cairo-fill" title="cairo_fill ()"><code class="function">cairo_fill()</code></a>, <a class="link" href="cairo-cairo-t.html#cairo-stroke" title="cairo_stroke ()"><code class="function">cairo_stroke()</code></a>.
500
- </p>
501
- <div class="variablelist"><table border="0">
502
- <col align="left" valign="top">
467
+ <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.</p>
468
+ <p>Some functions unset the current path and as a result, current point:
469
+ <a class="link" href="cairo-cairo-t.html#cairo-fill" title="cairo_fill ()"><code class="function">cairo_fill()</code></a>, <a class="link" href="cairo-cairo-t.html#cairo-stroke" title="cairo_stroke ()"><code class="function">cairo_stroke()</code></a>.</p>
470
+ <div class="refsect3">
471
+ <a name="id-1.3.3.7.7.9"></a><h4>Parameters</h4>
472
+ <div class="informaltable"><table width="100%" border="0">
473
+ <colgroup>
474
+ <col width="150px" class="parameters_name">
475
+ <col class="parameters_description">
476
+ <col width="200px" class="parameters_annotations">
477
+ </colgroup>
503
478
  <tbody>
504
479
  <tr>
505
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
506
- <td>a cairo context</td>
480
+ <td class="parameter_name"><p>cr</p></td>
481
+ <td class="parameter_description"><p>a cairo context</p></td>
482
+ <td class="parameter_annotations"> </td>
507
483
  </tr>
508
484
  <tr>
509
- <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
510
- <td>return value for X coordinate of the current point</td>
485
+ <td class="parameter_name"><p>x</p></td>
486
+ <td class="parameter_description"><p>return value for X coordinate of the current point</p></td>
487
+ <td class="parameter_annotations"> </td>
511
488
  </tr>
512
489
  <tr>
513
- <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
514
- <td>return value for Y coordinate of the current point</td>
490
+ <td class="parameter_name"><p>y</p></td>
491
+ <td class="parameter_description"><p>return value for Y coordinate of the current point</p></td>
492
+ <td class="parameter_annotations"> </td>
515
493
  </tr>
516
494
  </tbody>
517
495
  </table></div>
496
+ </div>
518
497
  <p class="since">Since 1.0</p>
519
498
  </div>
520
499
  <hr>
521
500
  <div class="refsect2">
522
- <a name="cairo-new-path"></a><h3>cairo_new_path ()</h3>
523
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_new_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
524
- <p>
525
- Clears the current path. After this call there will be no path and
526
- no current point.
527
- </p>
528
- <div class="variablelist"><table border="0">
529
- <col align="left" valign="top">
501
+ <a name="cairo-new-path"></a><h3>cairo_new_path ()</h3>
502
+ <pre class="programlisting"><span class="returnvalue">void</span>
503
+ cairo_new_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
504
+ <p>Clears the current path. After this call there will be no path and
505
+ no current point.</p>
506
+ <div class="refsect3">
507
+ <a name="id-1.3.3.7.8.5"></a><h4>Parameters</h4>
508
+ <div class="informaltable"><table width="100%" border="0">
509
+ <colgroup>
510
+ <col width="150px" class="parameters_name">
511
+ <col class="parameters_description">
512
+ <col width="200px" class="parameters_annotations">
513
+ </colgroup>
530
514
  <tbody><tr>
531
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
532
- <td>a cairo context</td>
515
+ <td class="parameter_name"><p>cr</p></td>
516
+ <td class="parameter_description"><p>a cairo context</p></td>
517
+ <td class="parameter_annotations"> </td>
533
518
  </tr></tbody>
534
519
  </table></div>
520
+ </div>
535
521
  <p class="since">Since 1.0</p>
536
522
  </div>
537
523
  <hr>
538
524
  <div class="refsect2">
539
- <a name="cairo-new-sub-path"></a><h3>cairo_new_sub_path ()</h3>
540
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_new_sub_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
541
- <p>
542
- Begin a new sub-path. Note that the existing path is not
543
- affected. After this call there will be no current point.
544
- </p>
545
- <p>
546
- In many cases, this call is not needed since new sub-paths are
547
- frequently started with <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>.
548
- </p>
549
- <p>
550
- A call to <a class="link" href="cairo-Paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()"><code class="function">cairo_new_sub_path()</code></a> is particularly useful when
551
- beginning a new sub-path with one of the <a class="link" href="cairo-Paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a> calls. This
525
+ <a name="cairo-new-sub-path"></a><h3>cairo_new_sub_path ()</h3>
526
+ <pre class="programlisting"><span class="returnvalue">void</span>
527
+ cairo_new_sub_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
528
+ <p>Begin a new sub-path. Note that the existing path is not
529
+ affected. After this call there will be no current point.</p>
530
+ <p>In many cases, this call is not needed since new sub-paths are
531
+ frequently started with <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>.</p>
532
+ <p>A call to <a class="link" href="cairo-Paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()"><code class="function">cairo_new_sub_path()</code></a> is particularly useful when
533
+ beginning a new sub-path with one of the <a class="link" href="cairo-Paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a> calls. This
552
534
  makes things easier as it is no longer necessary to manually
553
535
  compute the arc's initial coordinates for a call to
554
- <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>.
555
- </p>
556
- <div class="variablelist"><table border="0">
557
- <col align="left" valign="top">
536
+ <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>.</p>
537
+ <div class="refsect3">
538
+ <a name="id-1.3.3.7.9.7"></a><h4>Parameters</h4>
539
+ <div class="informaltable"><table width="100%" border="0">
540
+ <colgroup>
541
+ <col width="150px" class="parameters_name">
542
+ <col class="parameters_description">
543
+ <col width="200px" class="parameters_annotations">
544
+ </colgroup>
558
545
  <tbody><tr>
559
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
560
- <td>a cairo context</td>
546
+ <td class="parameter_name"><p>cr</p></td>
547
+ <td class="parameter_description"><p>a cairo context</p></td>
548
+ <td class="parameter_annotations"> </td>
561
549
  </tr></tbody>
562
550
  </table></div>
551
+ </div>
563
552
  <p class="since">Since 1.2</p>
564
553
  </div>
565
554
  <hr>
566
555
  <div class="refsect2">
567
- <a name="cairo-close-path"></a><h3>cairo_close_path ()</h3>
568
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_close_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
569
- <p>
570
- Adds a line segment to the path from the current point to the
556
+ <a name="cairo-close-path"></a><h3>cairo_close_path ()</h3>
557
+ <pre class="programlisting"><span class="returnvalue">void</span>
558
+ cairo_close_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
559
+ <p>Adds a line segment to the path from the current point to the
571
560
  beginning of the current sub-path, (the most recent point passed to
572
- <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>), and closes this sub-path. After this call the
573
- current point will be at the joined endpoint of the sub-path.
574
- </p>
575
- <p>
576
- The behavior of <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a> is distinct from simply calling
577
- <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a> with the equivalent coordinate in the case of
561
+ <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>), and closes this sub-path. After this call the
562
+ current point will be at the joined endpoint of the sub-path.</p>
563
+ <p>The behavior of <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a> is distinct from simply calling
564
+ <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a> with the equivalent coordinate in the case of
578
565
  stroking. When a closed sub-path is stroked, there are no caps on
579
566
  the ends of the sub-path. Instead, there is a line join connecting
580
- the final and initial segments of the sub-path.
581
- </p>
582
- <p>
583
- If there is no current point before the call to <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a>,
584
- this function will have no effect.
585
- </p>
586
- <p>
587
- Note: As of cairo version 1.2.4 any call to <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a> will
567
+ the final and initial segments of the sub-path.</p>
568
+ <p>If there is no current point before the call to <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a>,
569
+ this function will have no effect.</p>
570
+ <p>Note: As of cairo version 1.2.4 any call to <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a> will
588
571
  place an explicit MOVE_TO element into the path immediately after
589
- the CLOSE_PATH element, (which can be seen in <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> for
572
+ the CLOSE_PATH element, (which can be seen in <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> for
590
573
  example). This can simplify path processing in some cases as it may
591
574
  not be necessary to save the "last move_to point" during processing
592
575
  as the MOVE_TO immediately after the CLOSE_PATH will provide that
593
- point.
594
- </p>
595
- <div class="variablelist"><table border="0">
596
- <col align="left" valign="top">
576
+ point.</p>
577
+ <div class="refsect3">
578
+ <a name="id-1.3.3.7.10.8"></a><h4>Parameters</h4>
579
+ <div class="informaltable"><table width="100%" border="0">
580
+ <colgroup>
581
+ <col width="150px" class="parameters_name">
582
+ <col class="parameters_description">
583
+ <col width="200px" class="parameters_annotations">
584
+ </colgroup>
597
585
  <tbody><tr>
598
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
599
- <td>a cairo context</td>
586
+ <td class="parameter_name"><p>cr</p></td>
587
+ <td class="parameter_description"><p>a cairo context</p></td>
588
+ <td class="parameter_annotations"> </td>
600
589
  </tr></tbody>
601
590
  </table></div>
591
+ </div>
602
592
  <p class="since">Since 1.0</p>
603
593
  </div>
604
594
  <hr>
605
595
  <div class="refsect2">
606
- <a name="cairo-arc"></a><h3>cairo_arc ()</h3>
607
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_arc (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
608
- <em class="parameter"><code><span class="type">double</span> xc</code></em>,
609
- <em class="parameter"><code><span class="type">double</span> yc</code></em>,
610
- <em class="parameter"><code><span class="type">double</span> radius</code></em>,
611
- <em class="parameter"><code><span class="type">double</span> angle1</code></em>,
612
- <em class="parameter"><code><span class="type">double</span> angle2</code></em>);</pre>
613
- <p>
614
- Adds a circular arc of the given <em class="parameter"><code>radius</code></em> to the current path. The
615
- arc is centered at (<em class="parameter"><code>xc</code></em>, <em class="parameter"><code>yc</code></em>), begins at <em class="parameter"><code>angle1</code></em> and proceeds in
616
- the direction of increasing angles to end at <em class="parameter"><code>angle2</code></em>. If <em class="parameter"><code>angle2</code></em> is
617
- less than <em class="parameter"><code>angle1</code></em> it will be progressively increased by
618
- <code class="literal">2*M_PI</code> until it is greater than <em class="parameter"><code>angle1</code></em>.
619
- </p>
620
- <p>
621
- If there is a current point, an initial line segment will be added
596
+ <a name="cairo-arc"></a><h3>cairo_arc ()</h3>
597
+ <pre class="programlisting"><span class="returnvalue">void</span>
598
+ cairo_arc (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
599
+ <em class="parameter"><code><span class="type">double</span> xc</code></em>,
600
+ <em class="parameter"><code><span class="type">double</span> yc</code></em>,
601
+ <em class="parameter"><code><span class="type">double</span> radius</code></em>,
602
+ <em class="parameter"><code><span class="type">double</span> angle1</code></em>,
603
+ <em class="parameter"><code><span class="type">double</span> angle2</code></em>);</pre>
604
+ <p>Adds a circular arc of the given <em class="parameter"><code>radius</code></em>
605
+ to the current path. The
606
+ arc is centered at (<em class="parameter"><code>xc</code></em>
607
+ , <em class="parameter"><code>yc</code></em>
608
+ ), begins at <em class="parameter"><code>angle1</code></em>
609
+ and proceeds in
610
+ the direction of increasing angles to end at <em class="parameter"><code>angle2</code></em>
611
+ . If <em class="parameter"><code>angle2</code></em>
612
+ is
613
+ less than <em class="parameter"><code>angle1</code></em>
614
+ it will be progressively increased by
615
+ <code class="literal">2*M_PI</code> until it is greater than <em class="parameter"><code>angle1</code></em>
616
+ .</p>
617
+ <p>If there is a current point, an initial line segment will be added
622
618
  to the path to connect the current point to the beginning of the
623
619
  arc. If this initial line is undesired, it can be avoided by
624
- calling <a class="link" href="cairo-Paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()"><code class="function">cairo_new_sub_path()</code></a> before calling <a class="link" href="cairo-Paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a>.
625
- </p>
626
- <p>
627
- Angles are measured in radians. An angle of 0.0 is in the direction
620
+ calling <a class="link" href="cairo-Paths.html#cairo-new-sub-path" title="cairo_new_sub_path ()"><code class="function">cairo_new_sub_path()</code></a> before calling <a class="link" href="cairo-Paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a>.</p>
621
+ <p>Angles are measured in radians. An angle of 0.0 is in the direction
628
622
  of the positive X axis (in user space). An angle of
629
623
  <code class="literal">M_PI/2.0</code> radians (90 degrees) is in the
630
624
  direction of the positive Y axis (in user space). Angles increase
631
625
  in the direction from the positive X axis toward the positive Y
632
626
  axis. So with the default transformation matrix, angles increase in
633
- a clockwise direction.
634
- </p>
635
- <p>
636
- (To convert from degrees to radians, use <code class="literal">degrees * (M_PI /
637
- 180.)</code>.)
638
- </p>
639
- <p>
640
- This function gives the arc in the direction of increasing angles;
641
- see <a class="link" href="cairo-Paths.html#cairo-arc-negative" title="cairo_arc_negative ()"><code class="function">cairo_arc_negative()</code></a> to get the arc in the direction of
642
- decreasing angles.
643
- </p>
644
- <p>
645
- The arc is circular in user space. To achieve an elliptical arc,
627
+ a clockwise direction.</p>
628
+ <p>(To convert from degrees to radians, use <code class="literal">degrees * (M_PI /
629
+ 180.)</code>.)</p>
630
+ <p>This function gives the arc in the direction of increasing angles;
631
+ see <a class="link" href="cairo-Paths.html#cairo-arc-negative" title="cairo_arc_negative ()"><code class="function">cairo_arc_negative()</code></a> to get the arc in the direction of
632
+ decreasing angles.</p>
633
+ <p>The arc is circular in user space. To achieve an elliptical arc,
646
634
  you can scale the current transformation matrix by different
647
635
  amounts in the X and Y directions. For example, to draw an ellipse
648
- in the box given by <em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>, <em class="parameter"><code>width</code></em>, <em class="parameter"><code>height</code></em>:
649
- </p>
650
- <p>
651
- </p>
636
+ in the box given by <em class="parameter"><code>x</code></em>
637
+ , <em class="parameter"><code>y</code></em>
638
+ , <em class="parameter"><code>width</code></em>
639
+ , <em class="parameter"><code>height</code></em>
640
+ :</p>
652
641
  <div class="informalexample"><pre class="programlisting">
653
642
  cairo_save (cr);
654
643
  cairo_translate (cr, x + width / 2., y + height / 2.);
@@ -656,224 +645,299 @@ cairo_scale (cr, width / 2., height / 2.);
656
645
  cairo_arc (cr, 0., 0., 1., 0., 2 * M_PI);
657
646
  cairo_restore (cr);
658
647
  </pre></div>
659
- <p>
660
- </p>
661
- <div class="variablelist"><table border="0">
662
- <col align="left" valign="top">
648
+ <div class="refsect3">
649
+ <a name="id-1.3.3.7.11.11"></a><h4>Parameters</h4>
650
+ <div class="informaltable"><table width="100%" border="0">
651
+ <colgroup>
652
+ <col width="150px" class="parameters_name">
653
+ <col class="parameters_description">
654
+ <col width="200px" class="parameters_annotations">
655
+ </colgroup>
663
656
  <tbody>
664
657
  <tr>
665
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
666
- <td>a cairo context</td>
658
+ <td class="parameter_name"><p>cr</p></td>
659
+ <td class="parameter_description"><p>a cairo context</p></td>
660
+ <td class="parameter_annotations"> </td>
667
661
  </tr>
668
662
  <tr>
669
- <td><p><span class="term"><em class="parameter"><code>xc</code></em> :</span></p></td>
670
- <td>X position of the center of the arc</td>
663
+ <td class="parameter_name"><p>xc</p></td>
664
+ <td class="parameter_description"><p>X position of the center of the arc</p></td>
665
+ <td class="parameter_annotations"> </td>
671
666
  </tr>
672
667
  <tr>
673
- <td><p><span class="term"><em class="parameter"><code>yc</code></em> :</span></p></td>
674
- <td>Y position of the center of the arc</td>
668
+ <td class="parameter_name"><p>yc</p></td>
669
+ <td class="parameter_description"><p>Y position of the center of the arc</p></td>
670
+ <td class="parameter_annotations"> </td>
675
671
  </tr>
676
672
  <tr>
677
- <td><p><span class="term"><em class="parameter"><code>radius</code></em> :</span></p></td>
678
- <td>the radius of the arc</td>
673
+ <td class="parameter_name"><p>radius</p></td>
674
+ <td class="parameter_description"><p>the radius of the arc</p></td>
675
+ <td class="parameter_annotations"> </td>
679
676
  </tr>
680
677
  <tr>
681
- <td><p><span class="term"><em class="parameter"><code>angle1</code></em> :</span></p></td>
682
- <td>the start angle, in radians</td>
678
+ <td class="parameter_name"><p>angle1</p></td>
679
+ <td class="parameter_description"><p>the start angle, in radians</p></td>
680
+ <td class="parameter_annotations"> </td>
683
681
  </tr>
684
682
  <tr>
685
- <td><p><span class="term"><em class="parameter"><code>angle2</code></em> :</span></p></td>
686
- <td>the end angle, in radians</td>
683
+ <td class="parameter_name"><p>angle2</p></td>
684
+ <td class="parameter_description"><p>the end angle, in radians</p></td>
685
+ <td class="parameter_annotations"> </td>
687
686
  </tr>
688
687
  </tbody>
689
688
  </table></div>
689
+ </div>
690
690
  <p class="since">Since 1.0</p>
691
691
  </div>
692
692
  <hr>
693
693
  <div class="refsect2">
694
- <a name="cairo-arc-negative"></a><h3>cairo_arc_negative ()</h3>
695
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_arc_negative (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
696
- <em class="parameter"><code><span class="type">double</span> xc</code></em>,
697
- <em class="parameter"><code><span class="type">double</span> yc</code></em>,
698
- <em class="parameter"><code><span class="type">double</span> radius</code></em>,
699
- <em class="parameter"><code><span class="type">double</span> angle1</code></em>,
700
- <em class="parameter"><code><span class="type">double</span> angle2</code></em>);</pre>
701
- <p>
702
- Adds a circular arc of the given <em class="parameter"><code>radius</code></em> to the current path. The
703
- arc is centered at (<em class="parameter"><code>xc</code></em>, <em class="parameter"><code>yc</code></em>), begins at <em class="parameter"><code>angle1</code></em> and proceeds in
704
- the direction of decreasing angles to end at <em class="parameter"><code>angle2</code></em>. If <em class="parameter"><code>angle2</code></em> is
705
- greater than <em class="parameter"><code>angle1</code></em> it will be progressively decreased by
706
- <code class="literal">2*M_PI</code> until it is less than <em class="parameter"><code>angle1</code></em>.
707
- </p>
708
- <p>
709
- See <a class="link" href="cairo-Paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a> for more details. This function differs only in the
710
- direction of the arc between the two angles.
711
- </p>
712
- <div class="variablelist"><table border="0">
713
- <col align="left" valign="top">
694
+ <a name="cairo-arc-negative"></a><h3>cairo_arc_negative ()</h3>
695
+ <pre class="programlisting"><span class="returnvalue">void</span>
696
+ cairo_arc_negative (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
697
+ <em class="parameter"><code><span class="type">double</span> xc</code></em>,
698
+ <em class="parameter"><code><span class="type">double</span> yc</code></em>,
699
+ <em class="parameter"><code><span class="type">double</span> radius</code></em>,
700
+ <em class="parameter"><code><span class="type">double</span> angle1</code></em>,
701
+ <em class="parameter"><code><span class="type">double</span> angle2</code></em>);</pre>
702
+ <p>Adds a circular arc of the given <em class="parameter"><code>radius</code></em>
703
+ to the current path. The
704
+ arc is centered at (<em class="parameter"><code>xc</code></em>
705
+ , <em class="parameter"><code>yc</code></em>
706
+ ), begins at <em class="parameter"><code>angle1</code></em>
707
+ and proceeds in
708
+ the direction of decreasing angles to end at <em class="parameter"><code>angle2</code></em>
709
+ . If <em class="parameter"><code>angle2</code></em>
710
+ is
711
+ greater than <em class="parameter"><code>angle1</code></em>
712
+ it will be progressively decreased by
713
+ <code class="literal">2*M_PI</code> until it is less than <em class="parameter"><code>angle1</code></em>
714
+ .</p>
715
+ <p>See <a class="link" href="cairo-Paths.html#cairo-arc" title="cairo_arc ()"><code class="function">cairo_arc()</code></a> for more details. This function differs only in the
716
+ direction of the arc between the two angles.</p>
717
+ <div class="refsect3">
718
+ <a name="id-1.3.3.7.12.6"></a><h4>Parameters</h4>
719
+ <div class="informaltable"><table width="100%" border="0">
720
+ <colgroup>
721
+ <col width="150px" class="parameters_name">
722
+ <col class="parameters_description">
723
+ <col width="200px" class="parameters_annotations">
724
+ </colgroup>
714
725
  <tbody>
715
726
  <tr>
716
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
717
- <td>a cairo context</td>
727
+ <td class="parameter_name"><p>cr</p></td>
728
+ <td class="parameter_description"><p>a cairo context</p></td>
729
+ <td class="parameter_annotations"> </td>
718
730
  </tr>
719
731
  <tr>
720
- <td><p><span class="term"><em class="parameter"><code>xc</code></em> :</span></p></td>
721
- <td>X position of the center of the arc</td>
732
+ <td class="parameter_name"><p>xc</p></td>
733
+ <td class="parameter_description"><p>X position of the center of the arc</p></td>
734
+ <td class="parameter_annotations"> </td>
722
735
  </tr>
723
736
  <tr>
724
- <td><p><span class="term"><em class="parameter"><code>yc</code></em> :</span></p></td>
725
- <td>Y position of the center of the arc</td>
737
+ <td class="parameter_name"><p>yc</p></td>
738
+ <td class="parameter_description"><p>Y position of the center of the arc</p></td>
739
+ <td class="parameter_annotations"> </td>
726
740
  </tr>
727
741
  <tr>
728
- <td><p><span class="term"><em class="parameter"><code>radius</code></em> :</span></p></td>
729
- <td>the radius of the arc</td>
742
+ <td class="parameter_name"><p>radius</p></td>
743
+ <td class="parameter_description"><p>the radius of the arc</p></td>
744
+ <td class="parameter_annotations"> </td>
730
745
  </tr>
731
746
  <tr>
732
- <td><p><span class="term"><em class="parameter"><code>angle1</code></em> :</span></p></td>
733
- <td>the start angle, in radians</td>
747
+ <td class="parameter_name"><p>angle1</p></td>
748
+ <td class="parameter_description"><p>the start angle, in radians</p></td>
749
+ <td class="parameter_annotations"> </td>
734
750
  </tr>
735
751
  <tr>
736
- <td><p><span class="term"><em class="parameter"><code>angle2</code></em> :</span></p></td>
737
- <td>the end angle, in radians</td>
752
+ <td class="parameter_name"><p>angle2</p></td>
753
+ <td class="parameter_description"><p>the end angle, in radians</p></td>
754
+ <td class="parameter_annotations"> </td>
738
755
  </tr>
739
756
  </tbody>
740
757
  </table></div>
758
+ </div>
741
759
  <p class="since">Since 1.0</p>
742
760
  </div>
743
761
  <hr>
744
762
  <div class="refsect2">
745
- <a name="cairo-curve-to"></a><h3>cairo_curve_to ()</h3>
746
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_curve_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
747
- <em class="parameter"><code><span class="type">double</span> x1</code></em>,
748
- <em class="parameter"><code><span class="type">double</span> y1</code></em>,
749
- <em class="parameter"><code><span class="type">double</span> x2</code></em>,
750
- <em class="parameter"><code><span class="type">double</span> y2</code></em>,
751
- <em class="parameter"><code><span class="type">double</span> x3</code></em>,
752
- <em class="parameter"><code><span class="type">double</span> y3</code></em>);</pre>
753
- <p>
754
- Adds a cubic Bézier spline to the path from the current point to
755
- position (<em class="parameter"><code>x3</code></em>, <em class="parameter"><code>y3</code></em>) in user-space coordinates, using (<em class="parameter"><code>x1</code></em>, <em class="parameter"><code>y1</code></em>) and
756
- (<em class="parameter"><code>x2</code></em>, <em class="parameter"><code>y2</code></em>) as the control points. After this call the current point
757
- will be (<em class="parameter"><code>x3</code></em>, <em class="parameter"><code>y3</code></em>).
758
- </p>
759
- <p>
760
- If there is no current point before the call to <a class="link" href="cairo-Paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>
763
+ <a name="cairo-curve-to"></a><h3>cairo_curve_to ()</h3>
764
+ <pre class="programlisting"><span class="returnvalue">void</span>
765
+ cairo_curve_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
766
+ <em class="parameter"><code><span class="type">double</span> x1</code></em>,
767
+ <em class="parameter"><code><span class="type">double</span> y1</code></em>,
768
+ <em class="parameter"><code><span class="type">double</span> x2</code></em>,
769
+ <em class="parameter"><code><span class="type">double</span> y2</code></em>,
770
+ <em class="parameter"><code><span class="type">double</span> x3</code></em>,
771
+ <em class="parameter"><code><span class="type">double</span> y3</code></em>);</pre>
772
+ <p>Adds a cubic Bézier spline to the path from the current point to
773
+ position (<em class="parameter"><code>x3</code></em>
774
+ , <em class="parameter"><code>y3</code></em>
775
+ ) in user-space coordinates, using (<em class="parameter"><code>x1</code></em>
776
+ , <em class="parameter"><code>y1</code></em>
777
+ ) and
778
+ (<em class="parameter"><code>x2</code></em>
779
+ , <em class="parameter"><code>y2</code></em>
780
+ ) as the control points. After this call the current point
781
+ will be (<em class="parameter"><code>x3</code></em>
782
+ , <em class="parameter"><code>y3</code></em>
783
+ ).</p>
784
+ <p>If there is no current point before the call to <a class="link" href="cairo-Paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>
761
785
  this function will behave as if preceded by a call to
762
- cairo_move_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>x1</code></em>, <em class="parameter"><code>y1</code></em>).
763
- </p>
764
- <div class="variablelist"><table border="0">
765
- <col align="left" valign="top">
786
+ cairo_move_to(<em class="parameter"><code>cr</code></em>
787
+ , <em class="parameter"><code>x1</code></em>
788
+ , <em class="parameter"><code>y1</code></em>
789
+ ).</p>
790
+ <div class="refsect3">
791
+ <a name="id-1.3.3.7.13.6"></a><h4>Parameters</h4>
792
+ <div class="informaltable"><table width="100%" border="0">
793
+ <colgroup>
794
+ <col width="150px" class="parameters_name">
795
+ <col class="parameters_description">
796
+ <col width="200px" class="parameters_annotations">
797
+ </colgroup>
766
798
  <tbody>
767
799
  <tr>
768
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
769
- <td>a cairo context</td>
800
+ <td class="parameter_name"><p>cr</p></td>
801
+ <td class="parameter_description"><p>a cairo context</p></td>
802
+ <td class="parameter_annotations"> </td>
770
803
  </tr>
771
804
  <tr>
772
- <td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
773
- <td>the X coordinate of the first control point</td>
805
+ <td class="parameter_name"><p>x1</p></td>
806
+ <td class="parameter_description"><p>the X coordinate of the first control point</p></td>
807
+ <td class="parameter_annotations"> </td>
774
808
  </tr>
775
809
  <tr>
776
- <td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
777
- <td>the Y coordinate of the first control point</td>
810
+ <td class="parameter_name"><p>y1</p></td>
811
+ <td class="parameter_description"><p>the Y coordinate of the first control point</p></td>
812
+ <td class="parameter_annotations"> </td>
778
813
  </tr>
779
814
  <tr>
780
- <td><p><span class="term"><em class="parameter"><code>x2</code></em> :</span></p></td>
781
- <td>the X coordinate of the second control point</td>
815
+ <td class="parameter_name"><p>x2</p></td>
816
+ <td class="parameter_description"><p>the X coordinate of the second control point</p></td>
817
+ <td class="parameter_annotations"> </td>
782
818
  </tr>
783
819
  <tr>
784
- <td><p><span class="term"><em class="parameter"><code>y2</code></em> :</span></p></td>
785
- <td>the Y coordinate of the second control point</td>
820
+ <td class="parameter_name"><p>y2</p></td>
821
+ <td class="parameter_description"><p>the Y coordinate of the second control point</p></td>
822
+ <td class="parameter_annotations"> </td>
786
823
  </tr>
787
824
  <tr>
788
- <td><p><span class="term"><em class="parameter"><code>x3</code></em> :</span></p></td>
789
- <td>the X coordinate of the end of the curve</td>
825
+ <td class="parameter_name"><p>x3</p></td>
826
+ <td class="parameter_description"><p>the X coordinate of the end of the curve</p></td>
827
+ <td class="parameter_annotations"> </td>
790
828
  </tr>
791
829
  <tr>
792
- <td><p><span class="term"><em class="parameter"><code>y3</code></em> :</span></p></td>
793
- <td>the Y coordinate of the end of the curve</td>
830
+ <td class="parameter_name"><p>y3</p></td>
831
+ <td class="parameter_description"><p>the Y coordinate of the end of the curve</p></td>
832
+ <td class="parameter_annotations"> </td>
794
833
  </tr>
795
834
  </tbody>
796
835
  </table></div>
836
+ </div>
797
837
  <p class="since">Since 1.0</p>
798
838
  </div>
799
839
  <hr>
800
840
  <div class="refsect2">
801
- <a name="cairo-line-to"></a><h3>cairo_line_to ()</h3>
802
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_line_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
803
- <em class="parameter"><code><span class="type">double</span> x</code></em>,
804
- <em class="parameter"><code><span class="type">double</span> y</code></em>);</pre>
805
- <p>
806
- Adds a line to the path from the current point to position (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>)
841
+ <a name="cairo-line-to"></a><h3>cairo_line_to ()</h3>
842
+ <pre class="programlisting"><span class="returnvalue">void</span>
843
+ cairo_line_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
844
+ <em class="parameter"><code><span class="type">double</span> x</code></em>,
845
+ <em class="parameter"><code><span class="type">double</span> y</code></em>);</pre>
846
+ <p>Adds a line to the path from the current point to position (<em class="parameter"><code>x</code></em>
847
+ , <em class="parameter"><code>y</code></em>
848
+ )
807
849
  in user-space coordinates. After this call the current point
808
- will be (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>).
809
- </p>
810
- <p>
811
- If there is no current point before the call to <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>
812
- this function will behave as cairo_move_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>).
813
- </p>
814
- <div class="variablelist"><table border="0">
815
- <col align="left" valign="top">
850
+ will be (<em class="parameter"><code>x</code></em>
851
+ , <em class="parameter"><code>y</code></em>
852
+ ).</p>
853
+ <p>If there is no current point before the call to <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>
854
+ this function will behave as cairo_move_to(<em class="parameter"><code>cr</code></em>
855
+ , <em class="parameter"><code>x</code></em>
856
+ , <em class="parameter"><code>y</code></em>
857
+ ).</p>
858
+ <div class="refsect3">
859
+ <a name="id-1.3.3.7.14.6"></a><h4>Parameters</h4>
860
+ <div class="informaltable"><table width="100%" border="0">
861
+ <colgroup>
862
+ <col width="150px" class="parameters_name">
863
+ <col class="parameters_description">
864
+ <col width="200px" class="parameters_annotations">
865
+ </colgroup>
816
866
  <tbody>
817
867
  <tr>
818
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
819
- <td>a cairo context</td>
868
+ <td class="parameter_name"><p>cr</p></td>
869
+ <td class="parameter_description"><p>a cairo context</p></td>
870
+ <td class="parameter_annotations"> </td>
820
871
  </tr>
821
872
  <tr>
822
- <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
823
- <td>the X coordinate of the end of the new line</td>
873
+ <td class="parameter_name"><p>x</p></td>
874
+ <td class="parameter_description"><p>the X coordinate of the end of the new line</p></td>
875
+ <td class="parameter_annotations"> </td>
824
876
  </tr>
825
877
  <tr>
826
- <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
827
- <td>the Y coordinate of the end of the new line</td>
878
+ <td class="parameter_name"><p>y</p></td>
879
+ <td class="parameter_description"><p>the Y coordinate of the end of the new line</p></td>
880
+ <td class="parameter_annotations"> </td>
828
881
  </tr>
829
882
  </tbody>
830
883
  </table></div>
884
+ </div>
831
885
  <p class="since">Since 1.0</p>
832
886
  </div>
833
887
  <hr>
834
888
  <div class="refsect2">
835
- <a name="cairo-move-to"></a><h3>cairo_move_to ()</h3>
836
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_move_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
837
- <em class="parameter"><code><span class="type">double</span> x</code></em>,
838
- <em class="parameter"><code><span class="type">double</span> y</code></em>);</pre>
839
- <p>
840
- Begin a new sub-path. After this call the current point will be (<em class="parameter"><code>x</code></em>,
841
- <em class="parameter"><code>y</code></em>).
842
- </p>
843
- <div class="variablelist"><table border="0">
844
- <col align="left" valign="top">
889
+ <a name="cairo-move-to"></a><h3>cairo_move_to ()</h3>
890
+ <pre class="programlisting"><span class="returnvalue">void</span>
891
+ cairo_move_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
892
+ <em class="parameter"><code><span class="type">double</span> x</code></em>,
893
+ <em class="parameter"><code><span class="type">double</span> y</code></em>);</pre>
894
+ <p>Begin a new sub-path. After this call the current point will be (<em class="parameter"><code>x</code></em>
895
+ ,
896
+ <em class="parameter"><code>y</code></em>
897
+ ).</p>
898
+ <div class="refsect3">
899
+ <a name="id-1.3.3.7.15.5"></a><h4>Parameters</h4>
900
+ <div class="informaltable"><table width="100%" border="0">
901
+ <colgroup>
902
+ <col width="150px" class="parameters_name">
903
+ <col class="parameters_description">
904
+ <col width="200px" class="parameters_annotations">
905
+ </colgroup>
845
906
  <tbody>
846
907
  <tr>
847
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
848
- <td>a cairo context</td>
908
+ <td class="parameter_name"><p>cr</p></td>
909
+ <td class="parameter_description"><p>a cairo context</p></td>
910
+ <td class="parameter_annotations"> </td>
849
911
  </tr>
850
912
  <tr>
851
- <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
852
- <td>the X coordinate of the new position</td>
913
+ <td class="parameter_name"><p>x</p></td>
914
+ <td class="parameter_description"><p>the X coordinate of the new position</p></td>
915
+ <td class="parameter_annotations"> </td>
853
916
  </tr>
854
917
  <tr>
855
- <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
856
- <td>the Y coordinate of the new position</td>
918
+ <td class="parameter_name"><p>y</p></td>
919
+ <td class="parameter_description"><p>the Y coordinate of the new position</p></td>
920
+ <td class="parameter_annotations"> </td>
857
921
  </tr>
858
922
  </tbody>
859
923
  </table></div>
924
+ </div>
860
925
  <p class="since">Since 1.0</p>
861
926
  </div>
862
927
  <hr>
863
928
  <div class="refsect2">
864
- <a name="cairo-rectangle"></a><h3>cairo_rectangle ()</h3>
865
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_rectangle (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
866
- <em class="parameter"><code><span class="type">double</span> x</code></em>,
867
- <em class="parameter"><code><span class="type">double</span> y</code></em>,
868
- <em class="parameter"><code><span class="type">double</span> width</code></em>,
869
- <em class="parameter"><code><span class="type">double</span> height</code></em>);</pre>
870
- <p>
871
- Adds a closed sub-path rectangle of the given size to the current
872
- path at position (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>) in user-space coordinates.
873
- </p>
874
- <p>
875
- This function is logically equivalent to:
876
- </p>
929
+ <a name="cairo-rectangle"></a><h3>cairo_rectangle ()</h3>
930
+ <pre class="programlisting"><span class="returnvalue">void</span>
931
+ cairo_rectangle (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
932
+ <em class="parameter"><code><span class="type">double</span> x</code></em>,
933
+ <em class="parameter"><code><span class="type">double</span> y</code></em>,
934
+ <em class="parameter"><code><span class="type">double</span> width</code></em>,
935
+ <em class="parameter"><code><span class="type">double</span> height</code></em>);</pre>
936
+ <p>Adds a closed sub-path rectangle of the given size to the current
937
+ path at position (<em class="parameter"><code>x</code></em>
938
+ , <em class="parameter"><code>y</code></em>
939
+ ) in user-space coordinates.</p>
940
+ <p>This function is logically equivalent to:</p>
877
941
  <div class="informalexample"><pre class="programlisting">
878
942
  cairo_move_to (cr, x, y);
879
943
  cairo_rel_line_to (cr, width, 0);
@@ -881,314 +945,559 @@ cairo_rel_line_to (cr, 0, height);
881
945
  cairo_rel_line_to (cr, -width, 0);
882
946
  cairo_close_path (cr);
883
947
  </pre></div>
884
- <p>
885
- </p>
886
- <div class="variablelist"><table border="0">
887
- <col align="left" valign="top">
948
+ <div class="refsect3">
949
+ <a name="id-1.3.3.7.16.7"></a><h4>Parameters</h4>
950
+ <div class="informaltable"><table width="100%" border="0">
951
+ <colgroup>
952
+ <col width="150px" class="parameters_name">
953
+ <col class="parameters_description">
954
+ <col width="200px" class="parameters_annotations">
955
+ </colgroup>
888
956
  <tbody>
889
957
  <tr>
890
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
891
- <td>a cairo context</td>
958
+ <td class="parameter_name"><p>cr</p></td>
959
+ <td class="parameter_description"><p>a cairo context</p></td>
960
+ <td class="parameter_annotations"> </td>
892
961
  </tr>
893
962
  <tr>
894
- <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
895
- <td>the X coordinate of the top left corner of the rectangle</td>
963
+ <td class="parameter_name"><p>x</p></td>
964
+ <td class="parameter_description"><p>the X coordinate of the top left corner of the rectangle</p></td>
965
+ <td class="parameter_annotations"> </td>
896
966
  </tr>
897
967
  <tr>
898
- <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
899
- <td>the Y coordinate to the top left corner of the rectangle</td>
968
+ <td class="parameter_name"><p>y</p></td>
969
+ <td class="parameter_description"><p>the Y coordinate to the top left corner of the rectangle</p></td>
970
+ <td class="parameter_annotations"> </td>
900
971
  </tr>
901
972
  <tr>
902
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
903
- <td>the width of the rectangle</td>
973
+ <td class="parameter_name"><p>width</p></td>
974
+ <td class="parameter_description"><p>the width of the rectangle</p></td>
975
+ <td class="parameter_annotations"> </td>
904
976
  </tr>
905
977
  <tr>
906
- <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
907
- <td>the height of the rectangle</td>
978
+ <td class="parameter_name"><p>height</p></td>
979
+ <td class="parameter_description"><p>the height of the rectangle</p></td>
980
+ <td class="parameter_annotations"> </td>
908
981
  </tr>
909
982
  </tbody>
910
983
  </table></div>
984
+ </div>
911
985
  <p class="since">Since 1.0</p>
912
986
  </div>
913
987
  <hr>
914
988
  <div class="refsect2">
915
- <a name="cairo-glyph-path"></a><h3>cairo_glyph_path ()</h3>
916
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_glyph_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
917
- <em class="parameter"><code>const <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t"><span class="type">cairo_glyph_t</span></a> *glyphs</code></em>,
918
- <em class="parameter"><code><span class="type">int</span> num_glyphs</code></em>);</pre>
919
- <p>
920
- Adds closed paths for the glyphs to the current path. The generated
989
+ <a name="cairo-glyph-path"></a><h3>cairo_glyph_path ()</h3>
990
+ <pre class="programlisting"><span class="returnvalue">void</span>
991
+ cairo_glyph_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
992
+ <em class="parameter"><code>const <a class="link" href="cairo-text.html#cairo-glyph-t" title="cairo_glyph_t"><span class="type">cairo_glyph_t</span></a> *glyphs</code></em>,
993
+ <em class="parameter"><code><span class="type">int</span> num_glyphs</code></em>);</pre>
994
+ <p>Adds closed paths for the glyphs to the current path. The generated
921
995
  path if filled, achieves an effect similar to that of
922
- <a class="link" href="cairo-text.html#cairo-show-glyphs" title="cairo_show_glyphs ()"><code class="function">cairo_show_glyphs()</code></a>.
923
- </p>
924
- <div class="variablelist"><table border="0">
925
- <col align="left" valign="top">
996
+ <a class="link" href="cairo-text.html#cairo-show-glyphs" title="cairo_show_glyphs ()"><code class="function">cairo_show_glyphs()</code></a>.</p>
997
+ <div class="refsect3">
998
+ <a name="id-1.3.3.7.17.5"></a><h4>Parameters</h4>
999
+ <div class="informaltable"><table width="100%" border="0">
1000
+ <colgroup>
1001
+ <col width="150px" class="parameters_name">
1002
+ <col class="parameters_description">
1003
+ <col width="200px" class="parameters_annotations">
1004
+ </colgroup>
926
1005
  <tbody>
927
1006
  <tr>
928
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
929
- <td>a cairo context</td>
1007
+ <td class="parameter_name"><p>cr</p></td>
1008
+ <td class="parameter_description"><p>a cairo context</p></td>
1009
+ <td class="parameter_annotations"> </td>
930
1010
  </tr>
931
1011
  <tr>
932
- <td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
933
- <td>array of glyphs to show</td>
1012
+ <td class="parameter_name"><p>glyphs</p></td>
1013
+ <td class="parameter_description"><p>array of glyphs to show</p></td>
1014
+ <td class="parameter_annotations"> </td>
934
1015
  </tr>
935
1016
  <tr>
936
- <td><p><span class="term"><em class="parameter"><code>num_glyphs</code></em> :</span></p></td>
937
- <td>number of glyphs to show</td>
1017
+ <td class="parameter_name"><p>num_glyphs</p></td>
1018
+ <td class="parameter_description"><p>number of glyphs to show</p></td>
1019
+ <td class="parameter_annotations"> </td>
938
1020
  </tr>
939
1021
  </tbody>
940
1022
  </table></div>
1023
+ </div>
941
1024
  <p class="since">Since 1.0</p>
942
1025
  </div>
943
1026
  <hr>
944
1027
  <div class="refsect2">
945
- <a name="cairo-text-path"></a><h3>cairo_text_path ()</h3>
946
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_text_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
947
- <em class="parameter"><code>const <span class="type">char</span> *utf8</code></em>);</pre>
948
- <p>
949
- Adds closed paths for text to the current path. The generated
1028
+ <a name="cairo-text-path"></a><h3>cairo_text_path ()</h3>
1029
+ <pre class="programlisting"><span class="returnvalue">void</span>
1030
+ cairo_text_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
1031
+ <em class="parameter"><code>const <span class="type">char</span> *utf8</code></em>);</pre>
1032
+ <p>Adds closed paths for text to the current path. The generated
950
1033
  path if filled, achieves an effect similar to that of
951
- <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.
952
- </p>
953
- <p>
954
- Text conversion and positioning is done similar to <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.
955
- </p>
956
- <p>
957
- Like <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>, After this call the current point is
1034
+ <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.</p>
1035
+ <p>Text conversion and positioning is done similar to <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.</p>
1036
+ <p>Like <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>, After this call the current point is
958
1037
  moved to the origin of where the next glyph would be placed in
959
1038
  this same progression. That is, the current point will be at
960
1039
  the origin of the final glyph offset by its advance values.
961
- This allows for chaining multiple calls to to <a class="link" href="cairo-Paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a>
962
- without having to set current point in between.
963
- </p>
964
- <p>
965
- Note: The <a class="link" href="cairo-Paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a> function call is part of what the cairo
1040
+ This allows for chaining multiple calls to to <a class="link" href="cairo-Paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a>
1041
+ without having to set current point in between.</p>
1042
+ <p>Note: The <a class="link" href="cairo-Paths.html#cairo-text-path" title="cairo_text_path ()"><code class="function">cairo_text_path()</code></a> function call is part of what the cairo
966
1043
  designers call the "toy" text API. It is convenient for short demos
967
1044
  and simple programs, but it is not expected to be adequate for
968
- serious text-using applications. See <a class="link" href="cairo-Paths.html#cairo-glyph-path" title="cairo_glyph_path ()"><code class="function">cairo_glyph_path()</code></a> for the
969
- "real" text path API in cairo.
970
- </p>
971
- <div class="variablelist"><table border="0">
972
- <col align="left" valign="top">
1045
+ serious text-using applications. See <a class="link" href="cairo-Paths.html#cairo-glyph-path" title="cairo_glyph_path ()"><code class="function">cairo_glyph_path()</code></a> for the
1046
+ "real" text path API in cairo.</p>
1047
+ <div class="refsect3">
1048
+ <a name="id-1.3.3.7.18.8"></a><h4>Parameters</h4>
1049
+ <div class="informaltable"><table width="100%" border="0">
1050
+ <colgroup>
1051
+ <col width="150px" class="parameters_name">
1052
+ <col class="parameters_description">
1053
+ <col width="200px" class="parameters_annotations">
1054
+ </colgroup>
973
1055
  <tbody>
974
1056
  <tr>
975
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
976
- <td>a cairo context</td>
1057
+ <td class="parameter_name"><p>cr</p></td>
1058
+ <td class="parameter_description"><p>a cairo context</p></td>
1059
+ <td class="parameter_annotations"> </td>
977
1060
  </tr>
978
1061
  <tr>
979
- <td><p><span class="term"><em class="parameter"><code>utf8</code></em> :</span></p></td>
980
- <td>a NUL-terminated string of text encoded in UTF-8, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
981
- </td>
1062
+ <td class="parameter_name"><p>utf8</p></td>
1063
+ <td class="parameter_description"><p>a NUL-terminated string of text encoded in UTF-8, or <code class="literal">NULL</code></p></td>
1064
+ <td class="parameter_annotations"> </td>
982
1065
  </tr>
983
1066
  </tbody>
984
1067
  </table></div>
1068
+ </div>
985
1069
  <p class="since">Since 1.0</p>
986
1070
  </div>
987
1071
  <hr>
988
1072
  <div class="refsect2">
989
- <a name="cairo-rel-curve-to"></a><h3>cairo_rel_curve_to ()</h3>
990
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_rel_curve_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
991
- <em class="parameter"><code><span class="type">double</span> dx1</code></em>,
992
- <em class="parameter"><code><span class="type">double</span> dy1</code></em>,
993
- <em class="parameter"><code><span class="type">double</span> dx2</code></em>,
994
- <em class="parameter"><code><span class="type">double</span> dy2</code></em>,
995
- <em class="parameter"><code><span class="type">double</span> dx3</code></em>,
996
- <em class="parameter"><code><span class="type">double</span> dy3</code></em>);</pre>
997
- <p>
998
- Relative-coordinate version of <a class="link" href="cairo-Paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>. All offsets are
1073
+ <a name="cairo-rel-curve-to"></a><h3>cairo_rel_curve_to ()</h3>
1074
+ <pre class="programlisting"><span class="returnvalue">void</span>
1075
+ cairo_rel_curve_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
1076
+ <em class="parameter"><code><span class="type">double</span> dx1</code></em>,
1077
+ <em class="parameter"><code><span class="type">double</span> dy1</code></em>,
1078
+ <em class="parameter"><code><span class="type">double</span> dx2</code></em>,
1079
+ <em class="parameter"><code><span class="type">double</span> dy2</code></em>,
1080
+ <em class="parameter"><code><span class="type">double</span> dx3</code></em>,
1081
+ <em class="parameter"><code><span class="type">double</span> dy3</code></em>);</pre>
1082
+ <p>Relative-coordinate version of <a class="link" href="cairo-Paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>. All offsets are
999
1083
  relative to the current point. Adds a cubic Bézier spline to the
1000
1084
  path from the current point to a point offset from the current
1001
- point by (<em class="parameter"><code>dx3</code></em>, <em class="parameter"><code>dy3</code></em>), using points offset by (<em class="parameter"><code>dx1</code></em>, <em class="parameter"><code>dy1</code></em>) and
1002
- (<em class="parameter"><code>dx2</code></em>, <em class="parameter"><code>dy2</code></em>) as the control points. After this call the current
1003
- point will be offset by (<em class="parameter"><code>dx3</code></em>, <em class="parameter"><code>dy3</code></em>).
1004
- </p>
1005
- <p>
1006
- Given a current point of (x, y), cairo_rel_curve_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>dx1</code></em>,
1007
- <em class="parameter"><code>dy1</code></em>, <em class="parameter"><code>dx2</code></em>, <em class="parameter"><code>dy2</code></em>, <em class="parameter"><code>dx3</code></em>, <em class="parameter"><code>dy3</code></em>) is logically equivalent to
1008
- cairo_curve_to(<em class="parameter"><code>cr</code></em>, x+<em class="parameter"><code>dx1</code></em>, y+<em class="parameter"><code>dy1</code></em>, x+<em class="parameter"><code>dx2</code></em>, y+<em class="parameter"><code>dy2</code></em>, x+<em class="parameter"><code>dx3</code></em>, y+<em class="parameter"><code>dy3</code></em>).
1009
- </p>
1010
- <p>
1011
- It is an error to call this function with no current point. Doing
1012
- so will cause <em class="parameter"><code>cr</code></em> to shutdown with a status of
1013
- <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.
1014
- </p>
1015
- <div class="variablelist"><table border="0">
1016
- <col align="left" valign="top">
1085
+ point by (<em class="parameter"><code>dx3</code></em>
1086
+ , <em class="parameter"><code>dy3</code></em>
1087
+ ), using points offset by (<em class="parameter"><code>dx1</code></em>
1088
+ , <em class="parameter"><code>dy1</code></em>
1089
+ ) and
1090
+ (<em class="parameter"><code>dx2</code></em>
1091
+ , <em class="parameter"><code>dy2</code></em>
1092
+ ) as the control points. After this call the current
1093
+ point will be offset by (<em class="parameter"><code>dx3</code></em>
1094
+ , <em class="parameter"><code>dy3</code></em>
1095
+ ).</p>
1096
+ <p>Given a current point of (x, y), cairo_rel_curve_to(<em class="parameter"><code>cr</code></em>
1097
+ , <em class="parameter"><code>dx1</code></em>
1098
+ ,
1099
+ <em class="parameter"><code>dy1</code></em>
1100
+ , <em class="parameter"><code>dx2</code></em>
1101
+ , <em class="parameter"><code>dy2</code></em>
1102
+ , <em class="parameter"><code>dx3</code></em>
1103
+ , <em class="parameter"><code>dy3</code></em>
1104
+ ) is logically equivalent to
1105
+ cairo_curve_to(<em class="parameter"><code>cr</code></em>
1106
+ , x+<em class="parameter"><code>dx1</code></em>
1107
+ , y+<em class="parameter"><code>dy1</code></em>
1108
+ , x+<em class="parameter"><code>dx2</code></em>
1109
+ , y+<em class="parameter"><code>dy2</code></em>
1110
+ , x+<em class="parameter"><code>dx3</code></em>
1111
+ , y+<em class="parameter"><code>dy3</code></em>
1112
+ ).</p>
1113
+ <p>It is an error to call this function with no current point. Doing
1114
+ so will cause <em class="parameter"><code>cr</code></em>
1115
+ to shutdown with a status of
1116
+ <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.</p>
1117
+ <div class="refsect3">
1118
+ <a name="id-1.3.3.7.19.7"></a><h4>Parameters</h4>
1119
+ <div class="informaltable"><table width="100%" border="0">
1120
+ <colgroup>
1121
+ <col width="150px" class="parameters_name">
1122
+ <col class="parameters_description">
1123
+ <col width="200px" class="parameters_annotations">
1124
+ </colgroup>
1017
1125
  <tbody>
1018
1126
  <tr>
1019
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
1020
- <td>a cairo context</td>
1127
+ <td class="parameter_name"><p>cr</p></td>
1128
+ <td class="parameter_description"><p>a cairo context</p></td>
1129
+ <td class="parameter_annotations"> </td>
1021
1130
  </tr>
1022
1131
  <tr>
1023
- <td><p><span class="term"><em class="parameter"><code>dx1</code></em> :</span></p></td>
1024
- <td>the X offset to the first control point</td>
1132
+ <td class="parameter_name"><p>dx1</p></td>
1133
+ <td class="parameter_description"><p>the X offset to the first control point</p></td>
1134
+ <td class="parameter_annotations"> </td>
1025
1135
  </tr>
1026
1136
  <tr>
1027
- <td><p><span class="term"><em class="parameter"><code>dy1</code></em> :</span></p></td>
1028
- <td>the Y offset to the first control point</td>
1137
+ <td class="parameter_name"><p>dy1</p></td>
1138
+ <td class="parameter_description"><p>the Y offset to the first control point</p></td>
1139
+ <td class="parameter_annotations"> </td>
1029
1140
  </tr>
1030
1141
  <tr>
1031
- <td><p><span class="term"><em class="parameter"><code>dx2</code></em> :</span></p></td>
1032
- <td>the X offset to the second control point</td>
1142
+ <td class="parameter_name"><p>dx2</p></td>
1143
+ <td class="parameter_description"><p>the X offset to the second control point</p></td>
1144
+ <td class="parameter_annotations"> </td>
1033
1145
  </tr>
1034
1146
  <tr>
1035
- <td><p><span class="term"><em class="parameter"><code>dy2</code></em> :</span></p></td>
1036
- <td>the Y offset to the second control point</td>
1147
+ <td class="parameter_name"><p>dy2</p></td>
1148
+ <td class="parameter_description"><p>the Y offset to the second control point</p></td>
1149
+ <td class="parameter_annotations"> </td>
1037
1150
  </tr>
1038
1151
  <tr>
1039
- <td><p><span class="term"><em class="parameter"><code>dx3</code></em> :</span></p></td>
1040
- <td>the X offset to the end of the curve</td>
1152
+ <td class="parameter_name"><p>dx3</p></td>
1153
+ <td class="parameter_description"><p>the X offset to the end of the curve</p></td>
1154
+ <td class="parameter_annotations"> </td>
1041
1155
  </tr>
1042
1156
  <tr>
1043
- <td><p><span class="term"><em class="parameter"><code>dy3</code></em> :</span></p></td>
1044
- <td>the Y offset to the end of the curve</td>
1157
+ <td class="parameter_name"><p>dy3</p></td>
1158
+ <td class="parameter_description"><p>the Y offset to the end of the curve</p></td>
1159
+ <td class="parameter_annotations"> </td>
1045
1160
  </tr>
1046
1161
  </tbody>
1047
1162
  </table></div>
1163
+ </div>
1048
1164
  <p class="since">Since 1.0</p>
1049
1165
  </div>
1050
1166
  <hr>
1051
1167
  <div class="refsect2">
1052
- <a name="cairo-rel-line-to"></a><h3>cairo_rel_line_to ()</h3>
1053
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_rel_line_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
1054
- <em class="parameter"><code><span class="type">double</span> dx</code></em>,
1055
- <em class="parameter"><code><span class="type">double</span> dy</code></em>);</pre>
1056
- <p>
1057
- Relative-coordinate version of <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>. Adds a line to the
1168
+ <a name="cairo-rel-line-to"></a><h3>cairo_rel_line_to ()</h3>
1169
+ <pre class="programlisting"><span class="returnvalue">void</span>
1170
+ cairo_rel_line_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
1171
+ <em class="parameter"><code><span class="type">double</span> dx</code></em>,
1172
+ <em class="parameter"><code><span class="type">double</span> dy</code></em>);</pre>
1173
+ <p>Relative-coordinate version of <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>. Adds a line to the
1058
1174
  path from the current point to a point that is offset from the
1059
- current point by (<em class="parameter"><code>dx</code></em>, <em class="parameter"><code>dy</code></em>) in user space. After this call the
1060
- current point will be offset by (<em class="parameter"><code>dx</code></em>, <em class="parameter"><code>dy</code></em>).
1061
- </p>
1062
- <p>
1063
- Given a current point of (x, y), cairo_rel_line_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>dx</code></em>, <em class="parameter"><code>dy</code></em>)
1064
- is logically equivalent to cairo_line_to(<em class="parameter"><code>cr</code></em>, x + <em class="parameter"><code>dx</code></em>, y + <em class="parameter"><code>dy</code></em>).
1065
- </p>
1066
- <p>
1067
- It is an error to call this function with no current point. Doing
1068
- so will cause <em class="parameter"><code>cr</code></em> to shutdown with a status of
1069
- <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.
1070
- </p>
1071
- <div class="variablelist"><table border="0">
1072
- <col align="left" valign="top">
1175
+ current point by (<em class="parameter"><code>dx</code></em>
1176
+ , <em class="parameter"><code>dy</code></em>
1177
+ ) in user space. After this call the
1178
+ current point will be offset by (<em class="parameter"><code>dx</code></em>
1179
+ , <em class="parameter"><code>dy</code></em>
1180
+ ).</p>
1181
+ <p>Given a current point of (x, y), cairo_rel_line_to(<em class="parameter"><code>cr</code></em>
1182
+ , <em class="parameter"><code>dx</code></em>
1183
+ , <em class="parameter"><code>dy</code></em>
1184
+ )
1185
+ is logically equivalent to cairo_line_to(<em class="parameter"><code>cr</code></em>
1186
+ , x + <em class="parameter"><code>dx</code></em>
1187
+ , y + <em class="parameter"><code>dy</code></em>
1188
+ ).</p>
1189
+ <p>It is an error to call this function with no current point. Doing
1190
+ so will cause <em class="parameter"><code>cr</code></em>
1191
+ to shutdown with a status of
1192
+ <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.</p>
1193
+ <div class="refsect3">
1194
+ <a name="id-1.3.3.7.20.7"></a><h4>Parameters</h4>
1195
+ <div class="informaltable"><table width="100%" border="0">
1196
+ <colgroup>
1197
+ <col width="150px" class="parameters_name">
1198
+ <col class="parameters_description">
1199
+ <col width="200px" class="parameters_annotations">
1200
+ </colgroup>
1073
1201
  <tbody>
1074
1202
  <tr>
1075
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
1076
- <td>a cairo context</td>
1203
+ <td class="parameter_name"><p>cr</p></td>
1204
+ <td class="parameter_description"><p>a cairo context</p></td>
1205
+ <td class="parameter_annotations"> </td>
1077
1206
  </tr>
1078
1207
  <tr>
1079
- <td><p><span class="term"><em class="parameter"><code>dx</code></em> :</span></p></td>
1080
- <td>the X offset to the end of the new line</td>
1208
+ <td class="parameter_name"><p>dx</p></td>
1209
+ <td class="parameter_description"><p>the X offset to the end of the new line</p></td>
1210
+ <td class="parameter_annotations"> </td>
1081
1211
  </tr>
1082
1212
  <tr>
1083
- <td><p><span class="term"><em class="parameter"><code>dy</code></em> :</span></p></td>
1084
- <td>the Y offset to the end of the new line</td>
1213
+ <td class="parameter_name"><p>dy</p></td>
1214
+ <td class="parameter_description"><p>the Y offset to the end of the new line</p></td>
1215
+ <td class="parameter_annotations"> </td>
1085
1216
  </tr>
1086
1217
  </tbody>
1087
1218
  </table></div>
1219
+ </div>
1088
1220
  <p class="since">Since 1.0</p>
1089
1221
  </div>
1090
1222
  <hr>
1091
1223
  <div class="refsect2">
1092
- <a name="cairo-rel-move-to"></a><h3>cairo_rel_move_to ()</h3>
1093
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_rel_move_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
1094
- <em class="parameter"><code><span class="type">double</span> dx</code></em>,
1095
- <em class="parameter"><code><span class="type">double</span> dy</code></em>);</pre>
1096
- <p>
1097
- Begin a new sub-path. After this call the current point will offset
1098
- by (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>).
1099
- </p>
1100
- <p>
1101
- Given a current point of (x, y), cairo_rel_move_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>dx</code></em>, <em class="parameter"><code>dy</code></em>)
1102
- is logically equivalent to cairo_move_to(<em class="parameter"><code>cr</code></em>, x + <em class="parameter"><code>dx</code></em>, y + <em class="parameter"><code>dy</code></em>).
1103
- </p>
1104
- <p>
1105
- It is an error to call this function with no current point. Doing
1106
- so will cause <em class="parameter"><code>cr</code></em> to shutdown with a status of
1107
- <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.
1108
- </p>
1109
- <div class="variablelist"><table border="0">
1110
- <col align="left" valign="top">
1224
+ <a name="cairo-rel-move-to"></a><h3>cairo_rel_move_to ()</h3>
1225
+ <pre class="programlisting"><span class="returnvalue">void</span>
1226
+ cairo_rel_move_to (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
1227
+ <em class="parameter"><code><span class="type">double</span> dx</code></em>,
1228
+ <em class="parameter"><code><span class="type">double</span> dy</code></em>);</pre>
1229
+ <p>Begin a new sub-path. After this call the current point will offset
1230
+ by (<em class="parameter"><code>x</code></em>
1231
+ , <em class="parameter"><code>y</code></em>
1232
+ ).</p>
1233
+ <p>Given a current point of (x, y), cairo_rel_move_to(<em class="parameter"><code>cr</code></em>
1234
+ , <em class="parameter"><code>dx</code></em>
1235
+ , <em class="parameter"><code>dy</code></em>
1236
+ )
1237
+ is logically equivalent to cairo_move_to(<em class="parameter"><code>cr</code></em>
1238
+ , x + <em class="parameter"><code>dx</code></em>
1239
+ , y + <em class="parameter"><code>dy</code></em>
1240
+ ).</p>
1241
+ <p>It is an error to call this function with no current point. Doing
1242
+ so will cause <em class="parameter"><code>cr</code></em>
1243
+ to shutdown with a status of
1244
+ <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.</p>
1245
+ <div class="refsect3">
1246
+ <a name="id-1.3.3.7.21.7"></a><h4>Parameters</h4>
1247
+ <div class="informaltable"><table width="100%" border="0">
1248
+ <colgroup>
1249
+ <col width="150px" class="parameters_name">
1250
+ <col class="parameters_description">
1251
+ <col width="200px" class="parameters_annotations">
1252
+ </colgroup>
1111
1253
  <tbody>
1112
1254
  <tr>
1113
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
1114
- <td>a cairo context</td>
1255
+ <td class="parameter_name"><p>cr</p></td>
1256
+ <td class="parameter_description"><p>a cairo context</p></td>
1257
+ <td class="parameter_annotations"> </td>
1115
1258
  </tr>
1116
1259
  <tr>
1117
- <td><p><span class="term"><em class="parameter"><code>dx</code></em> :</span></p></td>
1118
- <td>the X offset</td>
1260
+ <td class="parameter_name"><p>dx</p></td>
1261
+ <td class="parameter_description"><p>the X offset</p></td>
1262
+ <td class="parameter_annotations"> </td>
1119
1263
  </tr>
1120
1264
  <tr>
1121
- <td><p><span class="term"><em class="parameter"><code>dy</code></em> :</span></p></td>
1122
- <td>the Y offset</td>
1265
+ <td class="parameter_name"><p>dy</p></td>
1266
+ <td class="parameter_description"><p>the Y offset</p></td>
1267
+ <td class="parameter_annotations"> </td>
1123
1268
  </tr>
1124
1269
  </tbody>
1125
1270
  </table></div>
1271
+ </div>
1126
1272
  <p class="since">Since 1.0</p>
1127
1273
  </div>
1128
1274
  <hr>
1129
1275
  <div class="refsect2">
1130
- <a name="cairo-path-extents"></a><h3>cairo_path_extents ()</h3>
1131
- <pre class="programlisting"><span class="returnvalue">void</span> cairo_path_extents (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
1132
- <em class="parameter"><code><span class="type">double</span> *x1</code></em>,
1133
- <em class="parameter"><code><span class="type">double</span> *y1</code></em>,
1134
- <em class="parameter"><code><span class="type">double</span> *x2</code></em>,
1135
- <em class="parameter"><code><span class="type">double</span> *y2</code></em>);</pre>
1136
- <p>
1137
- Computes a bounding box in user-space coordinates covering the
1276
+ <a name="cairo-path-extents"></a><h3>cairo_path_extents ()</h3>
1277
+ <pre class="programlisting"><span class="returnvalue">void</span>
1278
+ cairo_path_extents (<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> *cr</code></em>,
1279
+ <em class="parameter"><code><span class="type">double</span> *x1</code></em>,
1280
+ <em class="parameter"><code><span class="type">double</span> *y1</code></em>,
1281
+ <em class="parameter"><code><span class="type">double</span> *x2</code></em>,
1282
+ <em class="parameter"><code><span class="type">double</span> *y2</code></em>);</pre>
1283
+ <p>Computes a bounding box in user-space coordinates covering the
1138
1284
  points on the current path. If the current path is empty, returns
1139
1285
  an empty rectangle ((0,0), (0,0)). Stroke parameters, fill rule,
1140
- surface dimensions and clipping are not taken into account.
1141
- </p>
1142
- <p>
1143
- Contrast with <a class="link" href="cairo-cairo-t.html#cairo-fill-extents" title="cairo_fill_extents ()"><code class="function">cairo_fill_extents()</code></a> and <a class="link" href="cairo-cairo-t.html#cairo-stroke-extents" title="cairo_stroke_extents ()"><code class="function">cairo_stroke_extents()</code></a> which
1286
+ surface dimensions and clipping are not taken into account.</p>
1287
+ <p>Contrast with <a class="link" href="cairo-cairo-t.html#cairo-fill-extents" title="cairo_fill_extents ()"><code class="function">cairo_fill_extents()</code></a> and <a class="link" href="cairo-cairo-t.html#cairo-stroke-extents" title="cairo_stroke_extents ()"><code class="function">cairo_stroke_extents()</code></a> which
1144
1288
  return the extents of only the area that would be "inked" by
1145
- the corresponding drawing operations.
1146
- </p>
1147
- <p>
1148
- The result of <a class="link" href="cairo-Paths.html#cairo-path-extents" title="cairo_path_extents ()"><code class="function">cairo_path_extents()</code></a> is defined as equivalent to the
1149
- limit of <a class="link" href="cairo-cairo-t.html#cairo-stroke-extents" title="cairo_stroke_extents ()"><code class="function">cairo_stroke_extents()</code></a> with <a class="link" href="cairo-cairo-t.html#CAIRO-LINE-CAP-ROUND:CAPS"><code class="literal">CAIRO_LINE_CAP_ROUND</code></a> as the
1289
+ the corresponding drawing operations.</p>
1290
+ <p>The result of <a class="link" href="cairo-Paths.html#cairo-path-extents" title="cairo_path_extents ()"><code class="function">cairo_path_extents()</code></a> is defined as equivalent to the
1291
+ limit of <a class="link" href="cairo-cairo-t.html#cairo-stroke-extents" title="cairo_stroke_extents ()"><code class="function">cairo_stroke_extents()</code></a> with <a class="link" href="cairo-cairo-t.html#CAIRO-LINE-CAP-ROUND:CAPS"><code class="literal">CAIRO_LINE_CAP_ROUND</code></a> as the
1150
1292
  line width approaches 0.0, (but never reaching the empty-rectangle
1151
- returned by <a class="link" href="cairo-cairo-t.html#cairo-stroke-extents" title="cairo_stroke_extents ()"><code class="function">cairo_stroke_extents()</code></a> for a line width of 0.0).
1152
- </p>
1153
- <p>
1154
- Specifically, this means that zero-area sub-paths such as
1155
- <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>;<a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a> segments, (even degenerate cases
1293
+ returned by <a class="link" href="cairo-cairo-t.html#cairo-stroke-extents" title="cairo_stroke_extents ()"><code class="function">cairo_stroke_extents()</code></a> for a line width of 0.0).</p>
1294
+ <p>Specifically, this means that zero-area sub-paths such as
1295
+ <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>;<a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a> segments, (even degenerate cases
1156
1296
  where the coordinates to both calls are identical), will be
1157
1297
  considered as contributing to the extents. However, a lone
1158
- <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a> will not contribute to the results of
1159
- <a class="link" href="cairo-Paths.html#cairo-path-extents" title="cairo_path_extents ()"><code class="function">cairo_path_extents()</code></a>.
1160
- </p>
1161
- <div class="variablelist"><table border="0">
1162
- <col align="left" valign="top">
1298
+ <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a> will not contribute to the results of
1299
+ <a class="link" href="cairo-Paths.html#cairo-path-extents" title="cairo_path_extents ()"><code class="function">cairo_path_extents()</code></a>.</p>
1300
+ <div class="refsect3">
1301
+ <a name="id-1.3.3.7.22.8"></a><h4>Parameters</h4>
1302
+ <div class="informaltable"><table width="100%" border="0">
1303
+ <colgroup>
1304
+ <col width="150px" class="parameters_name">
1305
+ <col class="parameters_description">
1306
+ <col width="200px" class="parameters_annotations">
1307
+ </colgroup>
1163
1308
  <tbody>
1164
1309
  <tr>
1165
- <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
1166
- <td>a cairo context</td>
1310
+ <td class="parameter_name"><p>cr</p></td>
1311
+ <td class="parameter_description"><p>a cairo context</p></td>
1312
+ <td class="parameter_annotations"> </td>
1167
1313
  </tr>
1168
1314
  <tr>
1169
- <td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
1170
- <td>left of the resulting extents</td>
1315
+ <td class="parameter_name"><p>x1</p></td>
1316
+ <td class="parameter_description"><p>left of the resulting extents</p></td>
1317
+ <td class="parameter_annotations"> </td>
1171
1318
  </tr>
1172
1319
  <tr>
1173
- <td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
1174
- <td>top of the resulting extents</td>
1320
+ <td class="parameter_name"><p>y1</p></td>
1321
+ <td class="parameter_description"><p>top of the resulting extents</p></td>
1322
+ <td class="parameter_annotations"> </td>
1175
1323
  </tr>
1176
1324
  <tr>
1177
- <td><p><span class="term"><em class="parameter"><code>x2</code></em> :</span></p></td>
1178
- <td>right of the resulting extents</td>
1325
+ <td class="parameter_name"><p>x2</p></td>
1326
+ <td class="parameter_description"><p>right of the resulting extents</p></td>
1327
+ <td class="parameter_annotations"> </td>
1179
1328
  </tr>
1180
1329
  <tr>
1181
- <td><p><span class="term"><em class="parameter"><code>y2</code></em> :</span></p></td>
1182
- <td>bottom of the resulting extents</td>
1330
+ <td class="parameter_name"><p>y2</p></td>
1331
+ <td class="parameter_description"><p>bottom of the resulting extents</p></td>
1332
+ <td class="parameter_annotations"> </td>
1183
1333
  </tr>
1184
1334
  </tbody>
1185
1335
  </table></div>
1336
+ </div>
1186
1337
  <p class="since">Since 1.6</p>
1187
1338
  </div>
1188
1339
  </div>
1340
+ <div class="refsect1">
1341
+ <a name="cairo-Paths.other_details"></a><h2>Types and Values</h2>
1342
+ <div class="refsect2">
1343
+ <a name="cairo-path-t"></a><h3>cairo_path_t</h3>
1344
+ <pre class="programlisting">typedef struct {
1345
+ cairo_status_t status;
1346
+ cairo_path_data_t *data;
1347
+ int num_data;
1348
+ } cairo_path_t;
1349
+ </pre>
1350
+ <p>A data structure for holding a path. This data structure serves as
1351
+ the return value for <a class="link" href="cairo-Paths.html#cairo-copy-path" title="cairo_copy_path ()"><code class="function">cairo_copy_path()</code></a> and
1352
+ <a class="link" href="cairo-Paths.html#cairo-copy-path-flat" title="cairo_copy_path_flat ()"><code class="function">cairo_copy_path_flat()</code></a> as well the input value for
1353
+ <a class="link" href="cairo-Paths.html#cairo-append-path" title="cairo_append_path ()"><code class="function">cairo_append_path()</code></a>.</p>
1354
+ <p>See <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for hints on how to iterate over the
1355
+ actual data within the path.</p>
1356
+ <p>The num_data member gives the number of elements in the data
1357
+ array. This number is larger than the number of independent path
1358
+ portions (defined in <a class="link" href="cairo-Paths.html#cairo-path-data-type-t" title="enum cairo_path_data_type_t"><span class="type">cairo_path_data_type_t</span></a>), since the data
1359
+ includes both headers and coordinates for each portion.</p>
1360
+ <div class="refsect3">
1361
+ <a name="id-1.3.3.8.2.7"></a><h4>Members</h4>
1362
+ <div class="informaltable"><table width="100%" border="0">
1363
+ <colgroup>
1364
+ <col width="300px" class="struct_members_name">
1365
+ <col class="struct_members_description">
1366
+ <col width="200px" class="struct_members_annotations">
1367
+ </colgroup>
1368
+ <tbody>
1369
+ <tr>
1370
+ <td class="struct_member_name"><p><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="type">cairo_status_t</span></a> <em class="structfield"><code><a name="cairo-path-t.status"></a>status</code></em>;</p></td>
1371
+ <td class="struct_member_description"><p>the current error status</p></td>
1372
+ <td class="struct_member_annotations"> </td>
1373
+ </tr>
1374
+ <tr>
1375
+ <td class="struct_member_name"><p><a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> *<em class="structfield"><code><a name="cairo-path-t.data"></a>data</code></em>;</p></td>
1376
+ <td class="struct_member_description"><p>the elements in the path</p></td>
1377
+ <td class="struct_member_annotations"> </td>
1378
+ </tr>
1379
+ <tr>
1380
+ <td class="struct_member_name"><p><span class="type">int</span> <em class="structfield"><code><a name="cairo-path-t.num-data"></a>num_data</code></em>;</p></td>
1381
+ <td class="struct_member_description"><p>the number of elements in the data array</p></td>
1382
+ <td class="struct_member_annotations"> </td>
1383
+ </tr>
1384
+ </tbody>
1385
+ </table></div>
1386
+ </div>
1387
+ <p class="since">Since 1.0</p>
1388
+ </div>
1389
+ <hr>
1390
+ <div class="refsect2">
1391
+ <a name="cairo-path-data-t"></a><h3>union cairo_path_data_t</h3>
1392
+ <p><a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> is used to represent the path data inside a
1393
+ <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>.</p>
1394
+ <p>The data structure is designed to try to balance the demands of
1395
+ efficiency and ease-of-use. A path is represented as an array of
1396
+ <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a>, which is a union of headers and points.</p>
1397
+ <p>Each portion of the path is represented by one or more elements in
1398
+ the array, (one header followed by 0 or more points). The length
1399
+ value of the header is the number of array elements for the current
1400
+ portion including the header, (ie. length == 1 + # of points), and
1401
+ where the number of points for each element type is as follows:</p>
1402
+ <pre class="programlisting">
1403
+ %CAIRO_PATH_MOVE_TO: 1 point
1404
+ %CAIRO_PATH_LINE_TO: 1 point
1405
+ %CAIRO_PATH_CURVE_TO: 3 points
1406
+ %CAIRO_PATH_CLOSE_PATH: 0 points
1407
+ </pre>
1408
+ <p>The semantics and ordering of the coordinate values are consistent
1409
+ with <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-line-to" title="cairo_line_to ()"><code class="function">cairo_line_to()</code></a>, <a class="link" href="cairo-Paths.html#cairo-curve-to" title="cairo_curve_to ()"><code class="function">cairo_curve_to()</code></a>, and
1410
+ <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a>.</p>
1411
+ <p>Here is sample code for iterating through a <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>:</p>
1412
+ <div class="informalexample"><pre class="programlisting">
1413
+ int i;
1414
+ cairo_path_t *path;
1415
+ cairo_path_data_t *data;
1416
+  
1417
+ path = cairo_copy_path (cr);
1418
+  
1419
+ for (i=0; i &lt; path-&gt;num_data; i += path-&gt;data[i].header.length) {
1420
+ data = &amp;path-&gt;data[i];
1421
+ switch (data-&gt;header.type) {
1422
+ case CAIRO_PATH_MOVE_TO:
1423
+ do_move_to_things (data[1].point.x, data[1].point.y);
1424
+ break;
1425
+ case CAIRO_PATH_LINE_TO:
1426
+ do_line_to_things (data[1].point.x, data[1].point.y);
1427
+ break;
1428
+ case CAIRO_PATH_CURVE_TO:
1429
+ do_curve_to_things (data[1].point.x, data[1].point.y,
1430
+ data[2].point.x, data[2].point.y,
1431
+ data[3].point.x, data[3].point.y);
1432
+ break;
1433
+ case CAIRO_PATH_CLOSE_PATH:
1434
+ do_close_path_things ();
1435
+ break;
1436
+ }
1437
+ }
1438
+ cairo_path_destroy (path);
1439
+ </pre></div>
1440
+ <p>As of cairo 1.4, cairo does not mind if there are more elements in
1441
+ a portion of the path than needed. Such elements can be used by
1442
+ users of the cairo API to hold extra values in the path data
1443
+ structure. For this reason, it is recommended that applications
1444
+ always use <code class="literal">data-&gt;header.length</code> to
1445
+ iterate over the path data, instead of hardcoding the number of
1446
+ elements for each element type.</p>
1447
+ <p class="since">Since 1.0</p>
1448
+ </div>
1449
+ <hr>
1450
+ <div class="refsect2">
1451
+ <a name="cairo-path-data-type-t"></a><h3>enum cairo_path_data_type_t</h3>
1452
+ <p><a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> is used to describe the type of one portion
1453
+ of a path when represented as a <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>.
1454
+ See <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for details.</p>
1455
+ <div class="refsect3">
1456
+ <a name="id-1.3.3.8.4.4"></a><h4>Members</h4>
1457
+ <div class="informaltable"><table width="100%" border="0">
1458
+ <colgroup>
1459
+ <col width="300px" class="enum_members_name">
1460
+ <col class="enum_members_description">
1461
+ <col width="200px" class="enum_members_annotations">
1462
+ </colgroup>
1463
+ <tbody>
1464
+ <tr>
1465
+ <td class="enum_member_name"><p><a name="CAIRO-PATH-MOVE-TO:CAPS"></a>CAIRO_PATH_MOVE_TO</p></td>
1466
+ <td class="enum_member_description">
1467
+ <p>A move-to operation, since 1.0</p>
1468
+ </td>
1469
+ <td class="enum_member_annotations"> </td>
1470
+ </tr>
1471
+ <tr>
1472
+ <td class="enum_member_name"><p><a name="CAIRO-PATH-LINE-TO:CAPS"></a>CAIRO_PATH_LINE_TO</p></td>
1473
+ <td class="enum_member_description">
1474
+ <p>A line-to operation, since 1.0</p>
1475
+ </td>
1476
+ <td class="enum_member_annotations"> </td>
1477
+ </tr>
1478
+ <tr>
1479
+ <td class="enum_member_name"><p><a name="CAIRO-PATH-CURVE-TO:CAPS"></a>CAIRO_PATH_CURVE_TO</p></td>
1480
+ <td class="enum_member_description">
1481
+ <p>A curve-to operation, since 1.0</p>
1482
+ </td>
1483
+ <td class="enum_member_annotations"> </td>
1484
+ </tr>
1485
+ <tr>
1486
+ <td class="enum_member_name"><p><a name="CAIRO-PATH-CLOSE-PATH:CAPS"></a>CAIRO_PATH_CLOSE_PATH</p></td>
1487
+ <td class="enum_member_description">
1488
+ <p>A close-path operation, since 1.0</p>
1489
+ </td>
1490
+ <td class="enum_member_annotations"> </td>
1491
+ </tr>
1492
+ </tbody>
1493
+ </table></div>
1494
+ </div>
1495
+ <p class="since">Since 1.0</p>
1496
+ </div>
1497
+ </div>
1189
1498
  </div>
1190
1499
  <div class="footer">
1191
1500
  <hr>
1192
- Generated by GTK-Doc V1.18</div>
1501
+ Generated by GTK-Doc V1.20</div>
1193
1502
  </body>
1194
1503
  </html>