cairo 1.8.5-x86-mingw32 → 1.10.0-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 (450) hide show
  1. data/NEWS +2 -2
  2. data/Rakefile +44 -7
  3. data/ext/cairo/cairo.def +28 -1
  4. data/ext/cairo/extconf.rb +14 -16
  5. data/ext/cairo/rb_cairo.c +4 -1
  6. data/ext/cairo/rb_cairo.h +65 -1
  7. data/ext/cairo/rb_cairo_constants.c +150 -3
  8. data/ext/cairo/rb_cairo_context.c +17 -0
  9. data/ext/cairo/rb_cairo_device.c +406 -0
  10. data/ext/cairo/rb_cairo_exception.c +83 -32
  11. data/ext/cairo/rb_cairo_io.c +166 -0
  12. data/ext/cairo/rb_cairo_io.h +44 -0
  13. data/ext/cairo/rb_cairo_matrix.c +1 -1
  14. data/ext/cairo/rb_cairo_private.h +3 -0
  15. data/ext/cairo/rb_cairo_region.c +385 -0
  16. data/ext/cairo/rb_cairo_surface.c +674 -199
  17. data/lib/1.8/cairo.so +0 -0
  18. data/lib/1.9/cairo.so +0 -0
  19. data/samples/blur.rb +2 -3
  20. data/samples/{pac2.rb → pac-nomralize.rb} +5 -6
  21. data/samples/pac-tee.rb +170 -0
  22. data/samples/pac.rb +2 -3
  23. data/samples/png.rb +2 -3
  24. data/samples/scalable.rb +2 -3
  25. data/samples/text-on-path.rb +2 -3
  26. data/samples/text2.rb +2 -3
  27. data/test/cairo-test-utils.rb +15 -0
  28. data/test/run-test.rb +5 -4
  29. data/test/test_context.rb +4 -4
  30. data/test/test_font_face.rb +34 -21
  31. data/test/test_recording_surface.rb +18 -0
  32. data/test/test_region.rb +102 -0
  33. data/test/test_script_device.rb +46 -0
  34. data/test/test_script_surface.rb +13 -0
  35. data/test/test_surface.rb +14 -4
  36. data/test/test_tee_surface.rb +32 -0
  37. data/test/test_xml_device.rb +22 -0
  38. data/test/test_xml_surface.rb +32 -0
  39. data/tmp/i386-mingw32/cairo/1.9.2/rbconfig.rb +1 -1
  40. data/vendor/local/bin/libcairo-2.dll +0 -0
  41. data/vendor/local/include/cairo/cairo-deprecated.h +1 -16
  42. data/vendor/local/include/cairo/cairo-features.h +7 -0
  43. data/vendor/local/include/cairo/cairo-ft.h +16 -9
  44. data/vendor/local/include/cairo/cairo-gobject.h +186 -0
  45. data/vendor/local/include/cairo/cairo-pdf.h +27 -1
  46. data/vendor/local/include/cairo/cairo-ps.h +1 -1
  47. data/vendor/local/include/cairo/cairo-script-interpreter.h +117 -0
  48. data/vendor/local/include/cairo/cairo-svg.h +1 -1
  49. data/vendor/local/include/cairo/cairo-version.h +2 -2
  50. data/vendor/local/include/cairo/cairo-win32.h +1 -1
  51. data/vendor/local/include/cairo/cairo.h +382 -26
  52. data/vendor/local/lib/cairo.def +44 -0
  53. data/vendor/local/lib/cairo.lib +0 -0
  54. data/vendor/local/lib/libcairo.dll.a +0 -0
  55. data/vendor/local/lib/pkgconfig/cairo-fc.pc +12 -0
  56. data/vendor/local/lib/pkgconfig/cairo-ft.pc +4 -4
  57. data/vendor/local/lib/pkgconfig/cairo-gobject.pc +12 -0
  58. data/vendor/local/lib/pkgconfig/cairo-pdf.pc +3 -3
  59. data/vendor/local/lib/pkgconfig/cairo-png.pc +3 -3
  60. data/vendor/local/lib/pkgconfig/cairo-ps.pc +3 -3
  61. data/vendor/local/lib/pkgconfig/cairo-svg.pc +3 -3
  62. data/vendor/local/lib/pkgconfig/cairo-win32-font.pc +3 -3
  63. data/vendor/local/lib/pkgconfig/cairo-win32.pc +3 -3
  64. data/vendor/local/lib/pkgconfig/cairo.pc +4 -4
  65. data/vendor/local/manifest/{cairo-dev_1.8.10-4_win32.mft → cairo-dev_1.10.0-1_win32.mft} +34 -27
  66. data/vendor/local/manifest/cairo_1.10.0-1_win32.mft +5 -0
  67. data/vendor/local/share/doc/{cairo_1.8.10-4_win32 → cairo_1.10.0-1_win32}/COPYING +9 -8
  68. data/vendor/local/share/doc/{cairo_1.8.10-4_win32 → cairo_1.10.0-1_win32}/COPYING-LGPL-2.1 +2 -2
  69. data/vendor/local/share/doc/{cairo_1.8.10-4_win32 → cairo_1.10.0-1_win32}/COPYING-MPL-1.1 +0 -0
  70. data/vendor/local/share/gtk-doc/html/cairo/bindings-errors.html +4 -14
  71. data/vendor/local/share/gtk-doc/html/cairo/bindings-fonts.html +5 -15
  72. data/vendor/local/share/gtk-doc/html/cairo/bindings-memory.html +7 -17
  73. data/vendor/local/share/gtk-doc/html/cairo/bindings-overloading.html +6 -16
  74. data/vendor/local/share/gtk-doc/html/cairo/bindings-path.html +6 -16
  75. data/vendor/local/share/gtk-doc/html/cairo/bindings-patterns.html +23 -28
  76. data/vendor/local/share/gtk-doc/html/cairo/bindings-return-values.html +3 -13
  77. data/vendor/local/share/gtk-doc/html/cairo/bindings-streams.html +3 -13
  78. data/vendor/local/share/gtk-doc/html/cairo/bindings-surfaces.html +7 -17
  79. data/vendor/local/share/gtk-doc/html/cairo/cairo-Error-handling.html +373 -0
  80. data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +330 -0
  81. data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +478 -0
  82. data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html +344 -0
  83. data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html +320 -0
  84. data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html +1291 -0
  85. data/vendor/local/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html +622 -0
  86. data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-(CGFont)-Fonts.html +134 -0
  87. data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-Surfaces.html +210 -0
  88. data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html +834 -0
  89. data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +318 -0
  90. data/vendor/local/share/gtk-doc/html/cairo/cairo-Transformations.html +410 -0
  91. data/vendor/local/share/gtk-doc/html/cairo/cairo-Types.html +169 -0
  92. data/vendor/local/share/gtk-doc/html/cairo/cairo-User-Fonts.html +715 -0
  93. data/vendor/local/share/gtk-doc/html/cairo/cairo-Version-Information.html +410 -0
  94. data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +335 -0
  95. data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +291 -0
  96. data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html +470 -0
  97. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html +595 -0
  98. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +384 -0
  99. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html +644 -0
  100. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html +574 -0
  101. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html +1457 -0
  102. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html +1076 -0
  103. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +1396 -0
  104. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-t.html +2743 -0
  105. data/vendor/local/share/gtk-doc/html/cairo/cairo-drawing.html +13 -20
  106. data/vendor/local/share/gtk-doc/html/cairo/cairo-fonts.html +13 -23
  107. data/vendor/local/share/gtk-doc/html/cairo/cairo-support.html +11 -21
  108. data/vendor/local/share/gtk-doc/html/cairo/cairo-surfaces.html +19 -26
  109. data/vendor/local/share/gtk-doc/html/cairo/cairo-text.html +279 -326
  110. data/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp +411 -355
  111. data/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp2 +579 -480
  112. data/vendor/local/share/gtk-doc/html/cairo/index-1.10.html +147 -0
  113. data/vendor/local/share/gtk-doc/html/cairo/index-1.2.html +88 -65
  114. data/vendor/local/share/gtk-doc/html/cairo/index-1.4.html +72 -47
  115. data/vendor/local/share/gtk-doc/html/cairo/index-1.6.html +43 -32
  116. data/vendor/local/share/gtk-doc/html/cairo/index-1.8.html +42 -41
  117. data/vendor/local/share/gtk-doc/html/cairo/index-all.html +542 -345
  118. data/vendor/local/share/gtk-doc/html/cairo/index.html +36 -39
  119. data/vendor/local/share/gtk-doc/html/cairo/index.sgml +674 -444
  120. data/vendor/local/share/gtk-doc/html/cairo/language-bindings.html +6 -16
  121. data/vendor/local/share/gtk-doc/html/cairo/style.css +152 -54
  122. data/vendor/local/src/tml/packaging/cairo_1.10.0-1_win32.log +1262 -0
  123. data/vendor/local/src/tml/packaging/{cairo_1.8.10-4_win32.sh → cairo_1.10.0-1_win32.sh} +3 -3
  124. metadata +137 -389
  125. data/doc/doc.css +0 -91
  126. data/doc/en/cairo-antialias.html +0 -38
  127. data/doc/en/cairo-clip-not-representable-error.html +0 -47
  128. data/doc/en/cairo-color-base.html +0 -69
  129. data/doc/en/cairo-color-cmyk.html +0 -157
  130. data/doc/en/cairo-color-hsv.html +0 -137
  131. data/doc/en/cairo-color-rgb.html +0 -142
  132. data/doc/en/cairo-color-x11.html +0 -173
  133. data/doc/en/cairo-color.html +0 -238
  134. data/doc/en/cairo-content.html +0 -37
  135. data/doc/en/cairo-context-blur.html +0 -39
  136. data/doc/en/cairo-context-circle.html +0 -39
  137. data/doc/en/cairo-context-color.html +0 -39
  138. data/doc/en/cairo-context-path.html +0 -44
  139. data/doc/en/cairo-context-rectangle.html +0 -39
  140. data/doc/en/cairo-context-triangle.html +0 -39
  141. data/doc/en/cairo-context.html +0 -643
  142. data/doc/en/cairo-error.html +0 -44
  143. data/doc/en/cairo-extend.html +0 -38
  144. data/doc/en/cairo-file-not-found.html +0 -47
  145. data/doc/en/cairo-fill-rule.html +0 -36
  146. data/doc/en/cairo-filter.html +0 -40
  147. data/doc/en/cairo-font-extents.html +0 -129
  148. data/doc/en/cairo-font-face.html +0 -38
  149. data/doc/en/cairo-font-options.html +0 -139
  150. data/doc/en/cairo-font-slant.html +0 -37
  151. data/doc/en/cairo-font-type-mismatch.html +0 -47
  152. data/doc/en/cairo-font-weight.html +0 -36
  153. data/doc/en/cairo-format.html +0 -46
  154. data/doc/en/cairo-glyph.html +0 -99
  155. data/doc/en/cairo-gradient-pattern.html +0 -74
  156. data/doc/en/cairo-hint-metrics.html +0 -37
  157. data/doc/en/cairo-hint-style.html +0 -39
  158. data/doc/en/cairo-image-surface.html +0 -82
  159. data/doc/en/cairo-invalid-clusters.html +0 -47
  160. data/doc/en/cairo-invalid-content-error.html +0 -47
  161. data/doc/en/cairo-invalid-dash-error.html +0 -47
  162. data/doc/en/cairo-invalid-dsc-comment-error.html +0 -47
  163. data/doc/en/cairo-invalid-format-error.html +0 -47
  164. data/doc/en/cairo-invalid-index-error.html +0 -47
  165. data/doc/en/cairo-invalid-matrix-error.html +0 -47
  166. data/doc/en/cairo-invalid-path-data-error.html +0 -47
  167. data/doc/en/cairo-invalid-pop-group-error.html +0 -47
  168. data/doc/en/cairo-invalid-restore-error.html +0 -47
  169. data/doc/en/cairo-invalid-slant.html +0 -47
  170. data/doc/en/cairo-invalid-status-error.html +0 -47
  171. data/doc/en/cairo-invalid-stride-error.html +0 -47
  172. data/doc/en/cairo-invalid-string-error.html +0 -47
  173. data/doc/en/cairo-invalid-visual-error.html +0 -47
  174. data/doc/en/cairo-invalid-weight.html +0 -47
  175. data/doc/en/cairo-line-cap.html +0 -37
  176. data/doc/en/cairo-line-join.html +0 -37
  177. data/doc/en/cairo-linear-pattern.html +0 -60
  178. data/doc/en/cairo-matrix.html +0 -259
  179. data/doc/en/cairo-negative-count.html +0 -47
  180. data/doc/en/cairo-no-current-point-error.html +0 -47
  181. data/doc/en/cairo-null-pointer-error.html +0 -47
  182. data/doc/en/cairo-operator.html +0 -48
  183. data/doc/en/cairo-paper-parse-error.html +0 -47
  184. data/doc/en/cairo-paper-unknown-paper-name.html +0 -66
  185. data/doc/en/cairo-paper-unknown-unit.html +0 -66
  186. data/doc/en/cairo-paper-unrecognized-paper-description.html +0 -66
  187. data/doc/en/cairo-paper.html +0 -184
  188. data/doc/en/cairo-path-close-path.html +0 -49
  189. data/doc/en/cairo-path-curve-to.html +0 -49
  190. data/doc/en/cairo-path-data-type.html +0 -38
  191. data/doc/en/cairo-path-data.html +0 -98
  192. data/doc/en/cairo-path-line-to.html +0 -49
  193. data/doc/en/cairo-path-move-to.html +0 -49
  194. data/doc/en/cairo-path.html +0 -155
  195. data/doc/en/cairo-pattern-type-mismatch-error.html +0 -47
  196. data/doc/en/cairo-pattern.html +0 -99
  197. data/doc/en/cairo-pdf-surface.html +0 -57
  198. data/doc/en/cairo-point.html +0 -74
  199. data/doc/en/cairo-ps-level.html +0 -49
  200. data/doc/en/cairo-ps-surface.html +0 -92
  201. data/doc/en/cairo-quartz-image-surface.html +0 -57
  202. data/doc/en/cairo-quartz-surface.html +0 -57
  203. data/doc/en/cairo-radial-pattern.html +0 -60
  204. data/doc/en/cairo-read-error.html +0 -47
  205. data/doc/en/cairo-rectangle.html +0 -89
  206. data/doc/en/cairo-scaled-font.html +0 -94
  207. data/doc/en/cairo-solid-pattern.html +0 -62
  208. data/doc/en/cairo-subpixel-order.html +0 -39
  209. data/doc/en/cairo-surface-finished-error.html +0 -47
  210. data/doc/en/cairo-surface-pattern.html +0 -57
  211. data/doc/en/cairo-surface-type-mismatch-error.html +0 -47
  212. data/doc/en/cairo-surface.html +0 -121
  213. data/doc/en/cairo-svg-surface.html +0 -77
  214. data/doc/en/cairo-svg-version.html +0 -49
  215. data/doc/en/cairo-temp-file-error.html +0 -47
  216. data/doc/en/cairo-text-cluster-flag.html +0 -35
  217. data/doc/en/cairo-text-cluster.html +0 -84
  218. data/doc/en/cairo-text-extents.html +0 -144
  219. data/doc/en/cairo-toy-font-face.html +0 -67
  220. data/doc/en/cairo-user-font-error.html +0 -47
  221. data/doc/en/cairo-user-font-face-text-to-glyphs-data.html +0 -94
  222. data/doc/en/cairo-user-font-face.html +0 -72
  223. data/doc/en/cairo-user-font-immutable.html +0 -47
  224. data/doc/en/cairo-win32-printing-surface.html +0 -57
  225. data/doc/en/cairo-win32-surface.html +0 -62
  226. data/doc/en/cairo-write-error.html +0 -47
  227. data/doc/en/cairo.html +0 -131
  228. data/doc/en/index.html +0 -1154
  229. data/doc/index.html +0 -18
  230. data/doc/ja/cairo-antialias.html +0 -57
  231. data/doc/ja/cairo-clip-not-representable-error.html +0 -56
  232. data/doc/ja/cairo-color-base.html +0 -75
  233. data/doc/ja/cairo-color-cmyk.html +0 -152
  234. data/doc/ja/cairo-color-hsv.html +0 -135
  235. data/doc/ja/cairo-color-rgb.html +0 -145
  236. data/doc/ja/cairo-color-x11.html +0 -183
  237. data/doc/ja/cairo-color.html +0 -317
  238. data/doc/ja/cairo-content.html +0 -51
  239. data/doc/ja/cairo-context-blur.html +0 -53
  240. data/doc/ja/cairo-context-circle.html +0 -54
  241. data/doc/ja/cairo-context-color.html +0 -52
  242. data/doc/ja/cairo-context-path.html +0 -77
  243. data/doc/ja/cairo-context-rectangle.html +0 -60
  244. data/doc/ja/cairo-context-triangle.html +0 -47
  245. data/doc/ja/cairo-context.html +0 -1542
  246. data/doc/ja/cairo-error.html +0 -56
  247. data/doc/ja/cairo-extend.html +0 -56
  248. data/doc/ja/cairo-file-not-found.html +0 -51
  249. data/doc/ja/cairo-fill-rule.html +0 -58
  250. data/doc/ja/cairo-filter.html +0 -43
  251. data/doc/ja/cairo-font-extents.html +0 -164
  252. data/doc/ja/cairo-font-face.html +0 -55
  253. data/doc/ja/cairo-font-options.html +0 -189
  254. data/doc/ja/cairo-font-slant.html +0 -50
  255. data/doc/ja/cairo-font-type-mismatch.html +0 -52
  256. data/doc/ja/cairo-font-weight.html +0 -47
  257. data/doc/ja/cairo-format.html +0 -81
  258. data/doc/ja/cairo-glyph.html +0 -115
  259. data/doc/ja/cairo-gradient-pattern.html +0 -119
  260. data/doc/ja/cairo-hint-metrics.html +0 -57
  261. data/doc/ja/cairo-hint-style.html +0 -64
  262. data/doc/ja/cairo-image-surface.html +0 -131
  263. data/doc/ja/cairo-invalid-clusters.html +0 -55
  264. data/doc/ja/cairo-invalid-content-error.html +0 -54
  265. data/doc/ja/cairo-invalid-dash-error.html +0 -54
  266. data/doc/ja/cairo-invalid-dsc-comment-error.html +0 -54
  267. data/doc/ja/cairo-invalid-format-error.html +0 -54
  268. data/doc/ja/cairo-invalid-index-error.html +0 -54
  269. data/doc/ja/cairo-invalid-matrix-error.html +0 -54
  270. data/doc/ja/cairo-invalid-path-data-error.html +0 -54
  271. data/doc/ja/cairo-invalid-pop-group-error.html +0 -54
  272. data/doc/ja/cairo-invalid-restore-error.html +0 -55
  273. data/doc/ja/cairo-invalid-slant.html +0 -57
  274. data/doc/ja/cairo-invalid-status-error.html +0 -55
  275. data/doc/ja/cairo-invalid-stride-error.html +0 -55
  276. data/doc/ja/cairo-invalid-string-error.html +0 -54
  277. data/doc/ja/cairo-invalid-visual-error.html +0 -57
  278. data/doc/ja/cairo-invalid-weight.html +0 -57
  279. data/doc/ja/cairo-line-cap.html +0 -50
  280. data/doc/ja/cairo-line-join.html +0 -53
  281. data/doc/ja/cairo-linear-pattern.html +0 -87
  282. data/doc/ja/cairo-matrix.html +0 -354
  283. data/doc/ja/cairo-negative-count.html +0 -52
  284. data/doc/ja/cairo-no-current-point-error.html +0 -54
  285. data/doc/ja/cairo-null-pointer-error.html +0 -54
  286. data/doc/ja/cairo-operator.html +0 -51
  287. data/doc/ja/cairo-paper-parse-error.html +0 -55
  288. data/doc/ja/cairo-paper-unknown-paper-name.html +0 -76
  289. data/doc/ja/cairo-paper-unknown-unit.html +0 -75
  290. data/doc/ja/cairo-paper-unrecognized-paper-description.html +0 -76
  291. data/doc/ja/cairo-paper.html +0 -357
  292. data/doc/ja/cairo-path-close-path.html +0 -57
  293. data/doc/ja/cairo-path-curve-to.html +0 -70
  294. data/doc/ja/cairo-path-data-type.html +0 -53
  295. data/doc/ja/cairo-path-data.html +0 -127
  296. data/doc/ja/cairo-path-line-to.html +0 -62
  297. data/doc/ja/cairo-path-move-to.html +0 -62
  298. data/doc/ja/cairo-path.html +0 -144
  299. data/doc/ja/cairo-pattern-type-mismatch-error.html +0 -56
  300. data/doc/ja/cairo-pattern.html +0 -128
  301. data/doc/ja/cairo-pdf-surface.html +0 -86
  302. data/doc/ja/cairo-point.html +0 -90
  303. data/doc/ja/cairo-ps-level.html +0 -62
  304. data/doc/ja/cairo-ps-surface.html +0 -214
  305. data/doc/ja/cairo-quartz-image-surface.html +0 -75
  306. data/doc/ja/cairo-quartz-surface.html +0 -93
  307. data/doc/ja/cairo-radial-pattern.html +0 -93
  308. data/doc/ja/cairo-read-error.html +0 -55
  309. data/doc/ja/cairo-rectangle.html +0 -109
  310. data/doc/ja/cairo-scaled-font.html +0 -180
  311. data/doc/ja/cairo-solid-pattern.html +0 -87
  312. data/doc/ja/cairo-subpixel-order.html +0 -57
  313. data/doc/ja/cairo-surface-finished-error.html +0 -54
  314. data/doc/ja/cairo-surface-pattern.html +0 -68
  315. data/doc/ja/cairo-surface-type-mismatch-error.html +0 -56
  316. data/doc/ja/cairo-surface.html +0 -213
  317. data/doc/ja/cairo-svg-surface.html +0 -114
  318. data/doc/ja/cairo-svg-version.html +0 -66
  319. data/doc/ja/cairo-temp-file-error.html +0 -50
  320. data/doc/ja/cairo-text-cluster-flag.html +0 -46
  321. data/doc/ja/cairo-text-cluster.html +0 -102
  322. data/doc/ja/cairo-text-extents.html +0 -163
  323. data/doc/ja/cairo-toy-font-face.html +0 -107
  324. data/doc/ja/cairo-user-font-error.html +0 -55
  325. data/doc/ja/cairo-user-font-face-text-to-glyphs-data.html +0 -156
  326. data/doc/ja/cairo-user-font-face.html +0 -268
  327. data/doc/ja/cairo-user-font-immutable.html +0 -54
  328. data/doc/ja/cairo-win32-printing-surface.html +0 -80
  329. data/doc/ja/cairo-win32-surface.html +0 -100
  330. data/doc/ja/cairo-write-error.html +0 -55
  331. data/doc/ja/cairo.html +0 -177
  332. data/doc/ja/index.html +0 -1156
  333. data/pkg-config.rb +0 -313
  334. data/test-unit/Rakefile +0 -30
  335. data/test-unit/bin/testrb +0 -5
  336. data/test-unit/lib/test/unit.rb +0 -280
  337. data/test-unit/lib/test/unit/assertionfailederror.rb +0 -14
  338. data/test-unit/lib/test/unit/assertions.rb +0 -722
  339. data/test-unit/lib/test/unit/attribute.rb +0 -125
  340. data/test-unit/lib/test/unit/autorunner.rb +0 -254
  341. data/test-unit/lib/test/unit/collector.rb +0 -43
  342. data/test-unit/lib/test/unit/collector/descendant.rb +0 -23
  343. data/test-unit/lib/test/unit/collector/dir.rb +0 -108
  344. data/test-unit/lib/test/unit/collector/load.rb +0 -135
  345. data/test-unit/lib/test/unit/collector/objectspace.rb +0 -34
  346. data/test-unit/lib/test/unit/color.rb +0 -61
  347. data/test-unit/lib/test/unit/diff.rb +0 -524
  348. data/test-unit/lib/test/unit/error.rb +0 -124
  349. data/test-unit/lib/test/unit/exceptionhandler.rb +0 -39
  350. data/test-unit/lib/test/unit/failure.rb +0 -110
  351. data/test-unit/lib/test/unit/fixture.rb +0 -185
  352. data/test-unit/lib/test/unit/notification.rb +0 -125
  353. data/test-unit/lib/test/unit/omission.rb +0 -143
  354. data/test-unit/lib/test/unit/pending.rb +0 -146
  355. data/test-unit/lib/test/unit/priority.rb +0 -146
  356. data/test-unit/lib/test/unit/runner/console.rb +0 -46
  357. data/test-unit/lib/test/unit/runner/emacs.rb +0 -8
  358. data/test-unit/lib/test/unit/testcase.rb +0 -281
  359. data/test-unit/lib/test/unit/testresult.rb +0 -89
  360. data/test-unit/lib/test/unit/testsuite.rb +0 -110
  361. data/test-unit/lib/test/unit/ui/console/outputlevel.rb +0 -14
  362. data/test-unit/lib/test/unit/ui/console/testrunner.rb +0 -195
  363. data/test-unit/lib/test/unit/ui/emacs/testrunner.rb +0 -49
  364. data/test-unit/lib/test/unit/ui/testrunner.rb +0 -20
  365. data/test-unit/lib/test/unit/ui/testrunnermediator.rb +0 -77
  366. data/test-unit/lib/test/unit/ui/testrunnerutilities.rb +0 -41
  367. data/test-unit/lib/test/unit/util/backtracefilter.rb +0 -41
  368. data/test-unit/lib/test/unit/util/observable.rb +0 -90
  369. data/test-unit/lib/test/unit/util/procwrapper.rb +0 -48
  370. data/test-unit/lib/test/unit/version.rb +0 -7
  371. data/test-unit/sample/adder.rb +0 -13
  372. data/test-unit/sample/subtracter.rb +0 -12
  373. data/test-unit/sample/tc_adder.rb +0 -18
  374. data/test-unit/sample/tc_subtracter.rb +0 -18
  375. data/test-unit/sample/ts_examples.rb +0 -7
  376. data/test-unit/test/collector/test_descendant.rb +0 -135
  377. data/test-unit/test/collector/test_dir.rb +0 -406
  378. data/test-unit/test/collector/test_load.rb +0 -333
  379. data/test-unit/test/collector/test_objectspace.rb +0 -98
  380. data/test-unit/test/run-test.rb +0 -13
  381. data/test-unit/test/test_assertions.rb +0 -693
  382. data/test-unit/test/test_attribute.rb +0 -86
  383. data/test-unit/test/test_color.rb +0 -37
  384. data/test-unit/test/test_diff.rb +0 -477
  385. data/test-unit/test/test_emacs_runner.rb +0 -60
  386. data/test-unit/test/test_error.rb +0 -26
  387. data/test-unit/test/test_failure.rb +0 -33
  388. data/test-unit/test/test_fixture.rb +0 -252
  389. data/test-unit/test/test_notification.rb +0 -33
  390. data/test-unit/test/test_omission.rb +0 -81
  391. data/test-unit/test/test_pending.rb +0 -70
  392. data/test-unit/test/test_priority.rb +0 -89
  393. data/test-unit/test/test_testcase.rb +0 -430
  394. data/test-unit/test/test_testresult.rb +0 -113
  395. data/test-unit/test/test_testsuite.rb +0 -129
  396. data/test-unit/test/testunit_test_util.rb +0 -14
  397. data/test-unit/test/ui/test_testrunmediator.rb +0 -20
  398. data/test-unit/test/util/test_backtracefilter.rb +0 -41
  399. data/test-unit/test/util/test_observable.rb +0 -102
  400. data/test-unit/test/util/test_procwrapper.rb +0 -36
  401. data/test/test_pkg_config.rb +0 -123
  402. data/vendor/local/include/libpng14/png.h +0 -2701
  403. data/vendor/local/include/libpng14/pngconf.h +0 -1525
  404. data/vendor/local/include/png.h +0 -2701
  405. data/vendor/local/include/pngconf.h +0 -1525
  406. data/vendor/local/include/zconf.h +0 -461
  407. data/vendor/local/include/zlib.h +0 -1589
  408. data/vendor/local/lib/libpng.def +0 -192
  409. data/vendor/local/lib/libpng.lib +0 -0
  410. data/vendor/local/lib/libpng14.dll.a +0 -0
  411. data/vendor/local/lib/libz.dll.a +0 -0
  412. data/vendor/local/lib/pkgconfig/libpng.pc +0 -11
  413. data/vendor/local/lib/pkgconfig/libpng14.pc +0 -11
  414. data/vendor/local/lib/zdll.lib +0 -0
  415. data/vendor/local/lib/zlib.def +0 -67
  416. data/vendor/local/manifest/cairo_1.8.10-4_win32.mft +0 -5
  417. data/vendor/local/manifest/libpng-dev_1.4.3-1_win32.mft +0 -15
  418. data/vendor/local/manifest/zlib-dev_1.2.5-2_win32.mft +0 -8
  419. data/vendor/local/share/gtk-doc/html/cairo/cairo-context.html +0 -2643
  420. data/vendor/local/share/gtk-doc/html/cairo/cairo-error-status.html +0 -360
  421. data/vendor/local/share/gtk-doc/html/cairo/cairo-font-face.html +0 -408
  422. data/vendor/local/share/gtk-doc/html/cairo/cairo-font-options.html +0 -678
  423. data/vendor/local/share/gtk-doc/html/cairo/cairo-ft-font.html +0 -319
  424. data/vendor/local/share/gtk-doc/html/cairo/cairo-image-surface.html +0 -473
  425. data/vendor/local/share/gtk-doc/html/cairo/cairo-matrix.html +0 -596
  426. data/vendor/local/share/gtk-doc/html/cairo/cairo-paths.html +0 -1274
  427. data/vendor/local/share/gtk-doc/html/cairo/cairo-pattern.html +0 -1485
  428. data/vendor/local/share/gtk-doc/html/cairo/cairo-pdf-surface.html +0 -238
  429. data/vendor/local/share/gtk-doc/html/cairo/cairo-png-functions.html +0 -341
  430. data/vendor/local/share/gtk-doc/html/cairo/cairo-ps-surface.html +0 -622
  431. data/vendor/local/share/gtk-doc/html/cairo/cairo-quartz-font.html +0 -151
  432. data/vendor/local/share/gtk-doc/html/cairo/cairo-quartz-surface.html +0 -219
  433. data/vendor/local/share/gtk-doc/html/cairo/cairo-scaled-font.html +0 -1023
  434. data/vendor/local/share/gtk-doc/html/cairo/cairo-surface.html +0 -1026
  435. data/vendor/local/share/gtk-doc/html/cairo/cairo-svg-surface.html +0 -321
  436. data/vendor/local/share/gtk-doc/html/cairo/cairo-transformations.html +0 -436
  437. data/vendor/local/share/gtk-doc/html/cairo/cairo-types.html +0 -133
  438. data/vendor/local/share/gtk-doc/html/cairo/cairo-user-font.html +0 -735
  439. data/vendor/local/share/gtk-doc/html/cairo/cairo-version-info.html +0 -345
  440. data/vendor/local/share/gtk-doc/html/cairo/cairo-win32-font.html +0 -358
  441. data/vendor/local/share/gtk-doc/html/cairo/cairo-win32-surface.html +0 -312
  442. data/vendor/local/share/gtk-doc/html/cairo/cairo-xlib-surface.html +0 -492
  443. data/vendor/local/share/man/man3/libpng.3 +0 -4455
  444. data/vendor/local/share/man/man3/libpngpf.3 +0 -808
  445. data/vendor/local/share/man/man5/png.5 +0 -74
  446. data/vendor/local/src/tml/packaging/cairo_1.8.10-4_win32.log +0 -920
  447. data/vendor/local/src/tml/packaging/libpng_1.4.3-1_win32.log +0 -272
  448. data/vendor/local/src/tml/packaging/libpng_1.4.3-1_win32.sh +0 -71
  449. data/vendor/local/src/tml/packaging/zlib_1.2.5-2_win32.log +0 -42
  450. data/vendor/local/src/tml/packaging/zlib_1.2.5-2_win32.sh +0 -189
data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html ADDED
@@ -0,0 +1,1291 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html>
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <title>Paths</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
+ <link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
8
+ <link rel="up" href="cairo-drawing.html" title="Drawing">
9
+ <link rel="prev" href="cairo-cairo-t.html" title="cairo_t">
10
+ <link rel="next" href="cairo-cairo-pattern-t.html" title="cairo_pattern_t">
11
+ <meta name="generator" content="GTK-Doc V1.15 (XML mode)">
12
+ <link rel="stylesheet" href="style.css" type="text/css">
13
+ </head>
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>
29
+ <div class="refentry" title="Paths">
30
+ <a name="cairo-Paths"></a><div class="titlepage"></div>
31
+ <div class="refnamediv"><table width="100%"><tr>
32
+ <td valign="top">
33
+ <h2><span class="refentrytitle"><a name="cairo-Paths.top_of_page"></a>Paths</span></h2>
34
+ <p>Paths — Creating paths and manipulating path data</p>
35
+ </td>
36
+ <td valign="top" align="right"></td>
37
+ </tr></table></div>
38
+ <div class="refsynopsisdiv" title="Synopsis">
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" title="Description">
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
+ <div class="refsect1" title="Details">
118
+ <a name="cairo-Paths.details"></a><h2>Details</h2>
119
+ <div class="refsect2" title="cairo_path_t">
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">
145
+ <tbody>
146
+ <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
149
+ </td>
150
+ </tr>
151
+ <tr>
152
+ <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>
153
+ <td>the elements in the path
154
+ </td>
155
+ </tr>
156
+ <tr>
157
+ <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>
158
+ <td>the number of elements in the data array
159
+ </td>
160
+ </tr>
161
+ </tbody>
162
+ </table></div>
163
+ </div>
164
+ <hr>
165
+ <div class="refsect2" title="union cairo_path_data_t">
166
+ <a name="cairo-path-data-t"></a><h3>union cairo_path_data_t</h3>
167
+ <pre class="programlisting"></pre>
168
+ <p>
169
+ <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
170
+ <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>.
171
+ </p>
172
+ <p>
173
+ The data structure is designed to try to balance the demands of
174
+ efficiency and ease-of-use. A path is represented as an array of
175
+ <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.
176
+ </p>
177
+ <p>
178
+ Each portion of the path is represented by one or more elements in
179
+ the array, (one header followed by 0 or more points). The length
180
+ value of the header is the number of array elements for the current
181
+ portion including the header, (ie. length == 1 + # of points), and
182
+ where the number of points for each element type is as follows:
183
+ </p>
184
+ <p>
185
+ </p>
186
+ <pre class="programlisting">
187
+ %CAIRO_PATH_MOVE_TO: 1 point
188
+ %CAIRO_PATH_LINE_TO: 1 point
189
+ %CAIRO_PATH_CURVE_TO: 3 points
190
+ %CAIRO_PATH_CLOSE_PATH: 0 points
191
+ </pre>
192
+ <p>
193
+ </p>
194
+ <p>
195
+ The semantics and ordering of the coordinate values are consistent
196
+ 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
197
+ <a class="link" href="cairo-Paths.html#cairo-close-path" title="cairo_close_path ()"><code class="function">cairo_close_path()</code></a>.
198
+ </p>
199
+ <p>
200
+ 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>:
201
+ </p>
202
+ <p>
203
+ </p>
204
+ <div class="informalexample">
205
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
206
+ <tbody>
207
+ <tr>
208
+ <td class="listing_lines" align="right"><pre>1
209
+ 2
210
+ 3
211
+ 4
212
+ 5
213
+ 6
214
+ 7
215
+ 8
216
+ 9
217
+ 10
218
+ 11
219
+ 12
220
+ 13
221
+ 14
222
+ 15
223
+ 16
224
+ 17
225
+ 18
226
+ 19
227
+ 20
228
+ 21
229
+ 22
230
+ 23
231
+ 24
232
+ 25
233
+ 26</pre></td>
234
+ <td class="listing_code"><pre class="programlisting"><span class="type">int</span><span class="normal"> i</span><span class="symbol">;</span>
235
+ <span class="usertype">cairo_path_t</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">path</span><span class="symbol">;</span>
236
+ <span class="usertype">cairo_path_data_t</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data</span><span class="symbol">;</span>
237
+ <span class="normal"> </span>
238
+ <span class="normal">path </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#cairo-copy-path">cairo_copy_path</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">);</span>
239
+ <span class="normal"> </span>
240
+ <span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i</span><span class="symbol">=</span><span class="number">0</span><span class="symbol">;</span><span class="normal"> i </span><span class="symbol">&lt;</span><span class="normal"> path</span><span class="symbol">-&gt;</span><span class="normal">num_data</span><span class="symbol">;</span><span class="normal"> i </span><span class="symbol">+=</span><span class="normal"> path</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="normal">i</span><span class="symbol">].</span><span class="normal">header</span><span class="symbol">.</span><span class="normal">length</span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
241
+ <span class="normal"> data </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">path</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">[</span><span class="normal">i</span><span class="symbol">];</span>
242
+ <span class="normal"> </span><span class="keyword">switch</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">-&gt;</span><span class="normal">header</span><span class="symbol">.</span><span class="normal">type</span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
243
+ <span class="normal"> </span><span class="keyword">case</span><span class="normal"> <a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#CAIRO-PATH-MOVE-TO:CAPS">CAIRO_PATH_MOVE_TO</a></span><span class="symbol">:</span>
244
+ <span class="normal"> </span><span class="function">do_move_to_things</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">[</span><span class="number">1</span><span class="symbol">].</span><span class="normal">point</span><span class="symbol">.</span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">[</span><span class="number">1</span><span class="symbol">].</span><span class="normal">point</span><span class="symbol">.</span><span class="normal">y</span><span class="symbol">);</span>
245
+ <span class="normal"> </span><span class="keyword">break</span><span class="symbol">;</span>
246
+ <span class="normal"> </span><span class="keyword">case</span><span class="normal"> <a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#CAIRO-PATH-LINE-TO:CAPS">CAIRO_PATH_LINE_TO</a></span><span class="symbol">:</span>
247
+ <span class="normal"> </span><span class="function">do_line_to_things</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">[</span><span class="number">1</span><span class="symbol">].</span><span class="normal">point</span><span class="symbol">.</span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">[</span><span class="number">1</span><span class="symbol">].</span><span class="normal">point</span><span class="symbol">.</span><span class="normal">y</span><span class="symbol">);</span>
248
+ <span class="normal"> </span><span class="keyword">break</span><span class="symbol">;</span>
249
+ <span class="normal"> </span><span class="keyword">case</span><span class="normal"> <a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#CAIRO-PATH-CURVE-TO:CAPS">CAIRO_PATH_CURVE_TO</a></span><span class="symbol">:</span>
250
+ <span class="normal"> </span><span class="function">do_curve_to_things</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">[</span><span class="number">1</span><span class="symbol">].</span><span class="normal">point</span><span class="symbol">.</span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">[</span><span class="number">1</span><span class="symbol">].</span><span class="normal">point</span><span class="symbol">.</span><span class="normal">y</span><span class="symbol">,</span>
251
+ <span class="normal"> data</span><span class="symbol">[</span><span class="number">2</span><span class="symbol">].</span><span class="normal">point</span><span class="symbol">.</span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">[</span><span class="number">2</span><span class="symbol">].</span><span class="normal">point</span><span class="symbol">.</span><span class="normal">y</span><span class="symbol">,</span>
252
+ <span class="normal"> data</span><span class="symbol">[</span><span class="number">3</span><span class="symbol">].</span><span class="normal">point</span><span class="symbol">.</span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">[</span><span class="number">3</span><span class="symbol">].</span><span class="normal">point</span><span class="symbol">.</span><span class="normal">y</span><span class="symbol">);</span>
253
+ <span class="normal"> </span><span class="keyword">break</span><span class="symbol">;</span>
254
+ <span class="normal"> </span><span class="keyword">case</span><span class="normal"> <a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#CAIRO-PATH-CLOSE-PATH:CAPS">CAIRO_PATH_CLOSE_PATH</a></span><span class="symbol">:</span>
255
+ <span class="normal"> </span><span class="function">do_close_path_things</span><span class="normal"> </span><span class="symbol">();</span>
256
+ <span class="normal"> </span><span class="keyword">break</span><span class="symbol">;</span>
257
+ <span class="normal"> </span><span class="cbracket">}</span>
258
+ <span class="cbracket">}</span>
259
+ <span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#cairo-path-destroy">cairo_path_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">path</span><span class="symbol">);</span></pre></td>
260
+ </tr>
261
+ </tbody>
262
+ </table>
263
+ </div>
264
+
265
+ <p>
266
+ </p>
267
+ <p>
268
+ As of cairo 1.4, cairo does not mind if there are more elements in
269
+ a portion of the path than needed. Such elements can be used by
270
+ users of the cairo API to hold extra values in the path data
271
+ structure. For this reason, it is recommended that applications
272
+ always use <code class="literal">data-&gt;header.length</code> to
273
+ iterate over the path data, instead of hardcoding the number of
274
+ elements for each element type.
275
+ </p>
276
+ </div>
277
+ <hr>
278
+ <div class="refsect2" title="enum cairo_path_data_type_t">
279
+ <a name="cairo-path-data-type-t"></a><h3>enum cairo_path_data_type_t</h3>
280
+ <pre class="programlisting">typedef enum _cairo_path_data_type {
281
+ CAIRO_PATH_MOVE_TO,
282
+ CAIRO_PATH_LINE_TO,
283
+ CAIRO_PATH_CURVE_TO,
284
+ CAIRO_PATH_CLOSE_PATH
285
+ } cairo_path_data_type_t;
286
+ </pre>
287
+ <p>
288
+ <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
289
+ 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>.
290
+ 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.
291
+ </p>
292
+ <div class="variablelist"><table border="0">
293
+ <col align="left" valign="top">
294
+ <tbody>
295
+ <tr>
296
+ <td><p><a name="CAIRO-PATH-MOVE-TO:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_MOVE_TO</code></span></p></td>
297
+ <td>A move-to operation
298
+ </td>
299
+ </tr>
300
+ <tr>
301
+ <td><p><a name="CAIRO-PATH-LINE-TO:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_LINE_TO</code></span></p></td>
302
+ <td>A line-to operation
303
+ </td>
304
+ </tr>
305
+ <tr>
306
+ <td><p><a name="CAIRO-PATH-CURVE-TO:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_CURVE_TO</code></span></p></td>
307
+ <td>A curve-to operation
308
+ </td>
309
+ </tr>
310
+ <tr>
311
+ <td><p><a name="CAIRO-PATH-CLOSE-PATH:CAPS"></a><span class="term"><code class="literal">CAIRO_PATH_CLOSE_PATH</code></span></p></td>
312
+ <td>A close-path operation
313
+ </td>
314
+ </tr>
315
+ </tbody>
316
+ </table></div>
317
+ </div>
318
+ <hr>
319
+ <div class="refsect2" title="cairo_copy_path ()">
320
+ <a name="cairo-copy-path"></a><h3>cairo_copy_path ()</h3>
321
+ <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>
322
+ <p>
323
+ Creates a copy of the current path and returns it to the user as a
324
+ <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
325
+ over the returned data structure.
326
+ </p>
327
+ <p>
328
+ This function will always return a valid pointer, but the result
329
+ 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
330
+ <code class="literal">num_data==0</code>), if either of the following
331
+ conditions hold:
332
+ </p>
333
+ <p>
334
+ </p>
335
+ <div class="orderedlist"><ol class="orderedlist" type="1">
336
+ <li class="listitem">If there is insufficient memory to copy the path. In this
337
+ case <code class="literal">path-&gt;status</code> will be set to
338
+ <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>.</li>
339
+ <li class="listitem">If <em class="parameter"><code>cr</code></em> is already in an error state. In this case
340
+ <code class="literal">path-&gt;status</code> will contain the same status that
341
+ 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>
342
+ </ol></div>
343
+ <p>
344
+ </p>
345
+ <div class="variablelist"><table border="0">
346
+ <col align="left" valign="top">
347
+ <tbody>
348
+ <tr>
349
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
350
+ <td>a cairo context
351
+ </td>
352
+ </tr>
353
+ <tr>
354
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
355
+ <td> the copy of the current path. The caller owns the
356
+ 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
357
+ with it.
358
+ </td>
359
+ </tr>
360
+ </tbody>
361
+ </table></div>
362
+ </div>
363
+ <hr>
364
+ <div class="refsect2" title="cairo_copy_path_flat ()">
365
+ <a name="cairo-copy-path-flat"></a><h3>cairo_copy_path_flat ()</h3>
366
+ <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>
367
+ <p>
368
+ Gets a flattened copy of the current path and returns it to the
369
+ 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
370
+ how to iterate over the returned data structure.
371
+ </p>
372
+ <p>
373
+ 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
374
+ in the path will be approximated with piecewise-linear
375
+ approximations, (accurate to within the current tolerance
376
+ value). That is, the result is guaranteed to not have any elements
377
+ 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
378
+ series of <a class="link" href="cairo-Paths.html#CAIRO-PATH-LINE-TO:CAPS"><code class="literal">CAIRO_PATH_LINE_TO</code></a> elements.
379
+ </p>
380
+ <p>
381
+ This function will always return a valid pointer, but the result
382
+ 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
383
+ <code class="literal">num_data==0</code>), if either of the following
384
+ conditions hold:
385
+ </p>
386
+ <p>
387
+ </p>
388
+ <div class="orderedlist"><ol class="orderedlist" type="1">
389
+ <li class="listitem">If there is insufficient memory to copy the path. In this
390
+ case <code class="literal">path-&gt;status</code> will be set to
391
+ <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>.</li>
392
+ <li class="listitem">If <em class="parameter"><code>cr</code></em> is already in an error state. In this case
393
+ <code class="literal">path-&gt;status</code> will contain the same status that
394
+ 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>
395
+ </ol></div>
396
+ <p>
397
+ </p>
398
+ <div class="variablelist"><table border="0">
399
+ <col align="left" valign="top">
400
+ <tbody>
401
+ <tr>
402
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
403
+ <td>a cairo context
404
+ </td>
405
+ </tr>
406
+ <tr>
407
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
408
+ <td> the copy of the current path. The caller owns the
409
+ 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
410
+ with it.
411
+ </td>
412
+ </tr>
413
+ </tbody>
414
+ </table></div>
415
+ </div>
416
+ <hr>
417
+ <div class="refsect2" title="cairo_path_destroy ()">
418
+ <a name="cairo-path-destroy"></a><h3>cairo_path_destroy ()</h3>
419
+ <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>
420
+ <p>
421
+ Immediately releases all memory associated with <em class="parameter"><code>path</code></em>. After a call
422
+ 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
423
+ should not be used further.
424
+ </p>
425
+ <p>
426
+ 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
427
+ 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
428
+ that is created manually (ie. outside of cairo) should be destroyed
429
+ manually as well.
430
+ </p>
431
+ <div class="variablelist"><table border="0">
432
+ <col align="left" valign="top">
433
+ <tbody><tr>
434
+ <td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
435
+ <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
436
+ <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>.
437
+ </td>
438
+ </tr></tbody>
439
+ </table></div>
440
+ </div>
441
+ <hr>
442
+ <div class="refsect2" title="cairo_append_path ()">
443
+ <a name="cairo-append-path"></a><h3>cairo_append_path ()</h3>
444
+ <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>,
445
+ <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>
446
+ <p>
447
+ 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
448
+ 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
449
+ <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
450
+ <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
451
+ initialized, and note that <code class="literal">path-&gt;status</code> must be
452
+ initialized to <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>.
453
+ </p>
454
+ <div class="variablelist"><table border="0">
455
+ <col align="left" valign="top">
456
+ <tbody>
457
+ <tr>
458
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
459
+ <td>a cairo context
460
+ </td>
461
+ </tr>
462
+ <tr>
463
+ <td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
464
+ <td>path to be appended
465
+ </td>
466
+ </tr>
467
+ </tbody>
468
+ </table></div>
469
+ </div>
470
+ <hr>
471
+ <div class="refsect2" title="cairo_has_current_point ()">
472
+ <a name="cairo-has-current-point"></a><h3>cairo_has_current_point ()</h3>
473
+ <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>
474
+ <p>
475
+ Returns whether a current point is defined on the current path.
476
+ 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.
477
+ </p>
478
+ <div class="variablelist"><table border="0">
479
+ <col align="left" valign="top">
480
+ <tbody>
481
+ <tr>
482
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
483
+ <td>a cairo context
484
+ </td>
485
+ </tr>
486
+ <tr>
487
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
488
+ <td> whether a current point is defined.
489
+
490
+ </td>
491
+ </tr>
492
+ </tbody>
493
+ </table></div>
494
+ <p class="since">Since 1.6</p>
495
+ </div>
496
+ <hr>
497
+ <div class="refsect2" title="cairo_get_current_point ()">
498
+ <a name="cairo-get-current-point"></a><h3>cairo_get_current_point ()</h3>
499
+ <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>,
500
+ <em class="parameter"><code><span class="type">double</span> *x</code></em>,
501
+ <em class="parameter"><code><span class="type">double</span> *y</code></em>);</pre>
502
+ <p>
503
+ Gets the current point of the current path, which is
504
+ conceptually the final point reached by the path so far.
505
+ </p>
506
+ <p>
507
+ The current point is returned in the user-space coordinate
508
+ system. If there is no defined current point or if <em class="parameter"><code>cr</code></em> is in an
509
+ 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
510
+ 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>.
511
+ </p>
512
+ <p>
513
+ Most path construction functions alter the current point. See the
514
+ following for details on how they affect the current point:
515
+ <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>,
516
+ <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>,
517
+ <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>,
518
+ <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>,
519
+ <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>,
520
+ <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>.
521
+ </p>
522
+ <p>
523
+ Some functions use and alter the current point but do not
524
+ otherwise change current path:
525
+ <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.
526
+ </p>
527
+ <p>
528
+ Some functions unset the current path and as a result, current point:
529
+ <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>.
530
+ </p>
531
+ <div class="variablelist"><table border="0">
532
+ <col align="left" valign="top">
533
+ <tbody>
534
+ <tr>
535
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
536
+ <td>a cairo context
537
+ </td>
538
+ </tr>
539
+ <tr>
540
+ <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
541
+ <td>return value for X coordinate of the current point
542
+ </td>
543
+ </tr>
544
+ <tr>
545
+ <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
546
+ <td>return value for Y coordinate of the current point
547
+ </td>
548
+ </tr>
549
+ </tbody>
550
+ </table></div>
551
+ </div>
552
+ <hr>
553
+ <div class="refsect2" title="cairo_new_path ()">
554
+ <a name="cairo-new-path"></a><h3>cairo_new_path ()</h3>
555
+ <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>
556
+ <p>
557
+ Clears the current path. After this call there will be no path and
558
+ no current point.
559
+ </p>
560
+ <div class="variablelist"><table border="0">
561
+ <col align="left" valign="top">
562
+ <tbody><tr>
563
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
564
+ <td>a cairo context
565
+ </td>
566
+ </tr></tbody>
567
+ </table></div>
568
+ </div>
569
+ <hr>
570
+ <div class="refsect2" title="cairo_new_sub_path ()">
571
+ <a name="cairo-new-sub-path"></a><h3>cairo_new_sub_path ()</h3>
572
+ <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>
573
+ <p>
574
+ Begin a new sub-path. Note that the existing path is not
575
+ affected. After this call there will be no current point.
576
+ </p>
577
+ <p>
578
+ In many cases, this call is not needed since new sub-paths are
579
+ 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>.
580
+ </p>
581
+ <p>
582
+ 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
583
+ 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
584
+ makes things easier as it is no longer necessary to manually
585
+ compute the arc's initial coordinates for a call to
586
+ <a class="link" href="cairo-Paths.html#cairo-move-to" title="cairo_move_to ()"><code class="function">cairo_move_to()</code></a>.
587
+ </p>
588
+ <div class="variablelist"><table border="0">
589
+ <col align="left" valign="top">
590
+ <tbody><tr>
591
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
592
+ <td>a cairo context
593
+ </td>
594
+ </tr></tbody>
595
+ </table></div>
596
+ <p class="since">Since 1.2</p>
597
+ </div>
598
+ <hr>
599
+ <div class="refsect2" title="cairo_close_path ()">
600
+ <a name="cairo-close-path"></a><h3>cairo_close_path ()</h3>
601
+ <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>
602
+ <p>
603
+ Adds a line segment to the path from the current point to the
604
+ beginning of the current sub-path, (the most recent point passed to
605
+ <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
606
+ current point will be at the joined endpoint of the sub-path.
607
+ </p>
608
+ <p>
609
+ 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
610
+ <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
611
+ stroking. When a closed sub-path is stroked, there are no caps on
612
+ the ends of the sub-path. Instead, there is a line join connecting
613
+ the final and initial segments of the sub-path.
614
+ </p>
615
+ <p>
616
+ 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>,
617
+ this function will have no effect.
618
+ </p>
619
+ <p>
620
+ 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
621
+ place an explicit MOVE_TO element into the path immediately after
622
+ 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
623
+ example). This can simplify path processing in some cases as it may
624
+ not be necessary to save the "last move_to point" during processing
625
+ as the MOVE_TO immediately after the CLOSE_PATH will provide that
626
+ point.
627
+ </p>
628
+ <div class="variablelist"><table border="0">
629
+ <col align="left" valign="top">
630
+ <tbody><tr>
631
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
632
+ <td>a cairo context
633
+ </td>
634
+ </tr></tbody>
635
+ </table></div>
636
+ </div>
637
+ <hr>
638
+ <div class="refsect2" title="cairo_arc ()">
639
+ <a name="cairo-arc"></a><h3>cairo_arc ()</h3>
640
+ <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>,
641
+ <em class="parameter"><code><span class="type">double</span> xc</code></em>,
642
+ <em class="parameter"><code><span class="type">double</span> yc</code></em>,
643
+ <em class="parameter"><code><span class="type">double</span> radius</code></em>,
644
+ <em class="parameter"><code><span class="type">double</span> angle1</code></em>,
645
+ <em class="parameter"><code><span class="type">double</span> angle2</code></em>);</pre>
646
+ <p>
647
+ Adds a circular arc of the given <em class="parameter"><code>radius</code></em> to the current path. The
648
+ 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
649
+ the direction of increasing angles to end at <em class="parameter"><code>angle2</code></em>. If <em class="parameter"><code>angle2</code></em> is
650
+ less than <em class="parameter"><code>angle1</code></em> it will be progressively increased by 2*M_PI
651
+ until it is greater than <em class="parameter"><code>angle1</code></em>.
652
+ </p>
653
+ <p>
654
+ If there is a current point, an initial line segment will be added
655
+ to the path to connect the current point to the beginning of the
656
+ arc. If this initial line is undesired, it can be avoided by
657
+ 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>.
658
+ </p>
659
+ <p>
660
+ Angles are measured in radians. An angle of 0.0 is in the direction
661
+ of the positive X axis (in user space). An angle of <code class="literal">M_PI</code>/2.0 radians
662
+ (90 degrees) is in the direction of the positive Y axis (in
663
+ user space). Angles increase in the direction from the positive X
664
+ axis toward the positive Y axis. So with the default transformation
665
+ matrix, angles increase in a clockwise direction.
666
+ </p>
667
+ <p>
668
+ (To convert from degrees to radians, use <code class="literal">degrees * (M_PI /
669
+ 180.)</code>.)
670
+ </p>
671
+ <p>
672
+ This function gives the arc in the direction of increasing angles;
673
+ 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
674
+ decreasing angles.
675
+ </p>
676
+ <p>
677
+ The arc is circular in user space. To achieve an elliptical arc,
678
+ you can scale the current transformation matrix by different
679
+ amounts in the X and Y directions. For example, to draw an ellipse
680
+ 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>:
681
+ </p>
682
+ <p>
683
+ </p>
684
+ <div class="informalexample">
685
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
686
+ <tbody>
687
+ <tr>
688
+ <td class="listing_lines" align="right"><pre>1
689
+ 2
690
+ 3
691
+ 4
692
+ 5</pre></td>
693
+ <td class="listing_code"><pre class="programlisting"><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-save">cairo_save</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">);</span>
694
+ <span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Transformations.html#cairo-translate">cairo_translate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> x </span><span class="symbol">+</span><span class="normal"> width </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">.,</span><span class="normal"> y </span><span class="symbol">+</span><span class="normal"> height </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">.);</span>
695
+ <span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Transformations.html#cairo-scale">cairo_scale</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> width </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">.,</span><span class="normal"> height </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">.);</span>
696
+ <span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#cairo-arc">cairo_arc</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">.,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">.,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">.,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">.,</span><span class="normal"> </span><span class="number">2</span><span class="normal"> </span><span class="symbol">*</span><span class="normal"> M_PI</span><span class="symbol">);</span>
697
+ <span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-restore">cairo_restore</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">);</span></pre></td>
698
+ </tr>
699
+ </tbody>
700
+ </table>
701
+ </div>
702
+
703
+ <p>
704
+ </p>
705
+ <div class="variablelist"><table border="0">
706
+ <col align="left" valign="top">
707
+ <tbody>
708
+ <tr>
709
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
710
+ <td>a cairo context
711
+ </td>
712
+ </tr>
713
+ <tr>
714
+ <td><p><span class="term"><em class="parameter"><code>xc</code></em> :</span></p></td>
715
+ <td>X position of the center of the arc
716
+ </td>
717
+ </tr>
718
+ <tr>
719
+ <td><p><span class="term"><em class="parameter"><code>yc</code></em> :</span></p></td>
720
+ <td>Y position of the center of the arc
721
+ </td>
722
+ </tr>
723
+ <tr>
724
+ <td><p><span class="term"><em class="parameter"><code>radius</code></em> :</span></p></td>
725
+ <td>the radius of the arc
726
+ </td>
727
+ </tr>
728
+ <tr>
729
+ <td><p><span class="term"><em class="parameter"><code>angle1</code></em> :</span></p></td>
730
+ <td>the start angle, in radians
731
+ </td>
732
+ </tr>
733
+ <tr>
734
+ <td><p><span class="term"><em class="parameter"><code>angle2</code></em> :</span></p></td>
735
+ <td>the end angle, in radians
736
+ </td>
737
+ </tr>
738
+ </tbody>
739
+ </table></div>
740
+ </div>
741
+ <hr>
742
+ <div class="refsect2" title="cairo_arc_negative ()">
743
+ <a name="cairo-arc-negative"></a><h3>cairo_arc_negative ()</h3>
744
+ <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>,
745
+ <em class="parameter"><code><span class="type">double</span> xc</code></em>,
746
+ <em class="parameter"><code><span class="type">double</span> yc</code></em>,
747
+ <em class="parameter"><code><span class="type">double</span> radius</code></em>,
748
+ <em class="parameter"><code><span class="type">double</span> angle1</code></em>,
749
+ <em class="parameter"><code><span class="type">double</span> angle2</code></em>);</pre>
750
+ <p>
751
+ Adds a circular arc of the given <em class="parameter"><code>radius</code></em> to the current path. The
752
+ 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
753
+ the direction of decreasing angles to end at <em class="parameter"><code>angle2</code></em>. If <em class="parameter"><code>angle2</code></em> is
754
+ greater than <em class="parameter"><code>angle1</code></em> it will be progressively decreased by 2*M_PI
755
+ until it is less than <em class="parameter"><code>angle1</code></em>.
756
+ </p>
757
+ <p>
758
+ 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
759
+ direction of the arc between the two angles.
760
+ </p>
761
+ <div class="variablelist"><table border="0">
762
+ <col align="left" valign="top">
763
+ <tbody>
764
+ <tr>
765
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
766
+ <td>a cairo context
767
+ </td>
768
+ </tr>
769
+ <tr>
770
+ <td><p><span class="term"><em class="parameter"><code>xc</code></em> :</span></p></td>
771
+ <td>X position of the center of the arc
772
+ </td>
773
+ </tr>
774
+ <tr>
775
+ <td><p><span class="term"><em class="parameter"><code>yc</code></em> :</span></p></td>
776
+ <td>Y position of the center of the arc
777
+ </td>
778
+ </tr>
779
+ <tr>
780
+ <td><p><span class="term"><em class="parameter"><code>radius</code></em> :</span></p></td>
781
+ <td>the radius of the arc
782
+ </td>
783
+ </tr>
784
+ <tr>
785
+ <td><p><span class="term"><em class="parameter"><code>angle1</code></em> :</span></p></td>
786
+ <td>the start angle, in radians
787
+ </td>
788
+ </tr>
789
+ <tr>
790
+ <td><p><span class="term"><em class="parameter"><code>angle2</code></em> :</span></p></td>
791
+ <td>the end angle, in radians
792
+ </td>
793
+ </tr>
794
+ </tbody>
795
+ </table></div>
796
+ </div>
797
+ <hr>
798
+ <div class="refsect2" title="cairo_curve_to ()">
799
+ <a name="cairo-curve-to"></a><h3>cairo_curve_to ()</h3>
800
+ <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>,
801
+ <em class="parameter"><code><span class="type">double</span> x1</code></em>,
802
+ <em class="parameter"><code><span class="type">double</span> y1</code></em>,
803
+ <em class="parameter"><code><span class="type">double</span> x2</code></em>,
804
+ <em class="parameter"><code><span class="type">double</span> y2</code></em>,
805
+ <em class="parameter"><code><span class="type">double</span> x3</code></em>,
806
+ <em class="parameter"><code><span class="type">double</span> y3</code></em>);</pre>
807
+ <p>
808
+ Adds a cubic Bézier spline to the path from the current point to
809
+ 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
810
+ (<em class="parameter"><code>x2</code></em>, <em class="parameter"><code>y2</code></em>) as the control points. After this call the current point
811
+ will be (<em class="parameter"><code>x3</code></em>, <em class="parameter"><code>y3</code></em>).
812
+ </p>
813
+ <p>
814
+ 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>
815
+ this function will behave as if preceded by a call to
816
+ cairo_move_to(<em class="parameter"><code>cr</code></em>, <em class="parameter"><code>x1</code></em>, <em class="parameter"><code>y1</code></em>).
817
+ </p>
818
+ <div class="variablelist"><table border="0">
819
+ <col align="left" valign="top">
820
+ <tbody>
821
+ <tr>
822
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
823
+ <td>a cairo context
824
+ </td>
825
+ </tr>
826
+ <tr>
827
+ <td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
828
+ <td>the X coordinate of the first control point
829
+ </td>
830
+ </tr>
831
+ <tr>
832
+ <td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
833
+ <td>the Y coordinate of the first control point
834
+ </td>
835
+ </tr>
836
+ <tr>
837
+ <td><p><span class="term"><em class="parameter"><code>x2</code></em> :</span></p></td>
838
+ <td>the X coordinate of the second control point
839
+ </td>
840
+ </tr>
841
+ <tr>
842
+ <td><p><span class="term"><em class="parameter"><code>y2</code></em> :</span></p></td>
843
+ <td>the Y coordinate of the second control point
844
+ </td>
845
+ </tr>
846
+ <tr>
847
+ <td><p><span class="term"><em class="parameter"><code>x3</code></em> :</span></p></td>
848
+ <td>the X coordinate of the end of the curve
849
+ </td>
850
+ </tr>
851
+ <tr>
852
+ <td><p><span class="term"><em class="parameter"><code>y3</code></em> :</span></p></td>
853
+ <td>the Y coordinate of the end of the curve
854
+ </td>
855
+ </tr>
856
+ </tbody>
857
+ </table></div>
858
+ </div>
859
+ <hr>
860
+ <div class="refsect2" title="cairo_line_to ()">
861
+ <a name="cairo-line-to"></a><h3>cairo_line_to ()</h3>
862
+ <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>,
863
+ <em class="parameter"><code><span class="type">double</span> x</code></em>,
864
+ <em class="parameter"><code><span class="type">double</span> y</code></em>);</pre>
865
+ <p>
866
+ 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>)
867
+ in user-space coordinates. After this call the current point
868
+ will be (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>).
869
+ </p>
870
+ <p>
871
+ 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>
872
+ 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>).
873
+ </p>
874
+ <div class="variablelist"><table border="0">
875
+ <col align="left" valign="top">
876
+ <tbody>
877
+ <tr>
878
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
879
+ <td>a cairo context
880
+ </td>
881
+ </tr>
882
+ <tr>
883
+ <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
884
+ <td>the X coordinate of the end of the new line
885
+ </td>
886
+ </tr>
887
+ <tr>
888
+ <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
889
+ <td>the Y coordinate of the end of the new line
890
+ </td>
891
+ </tr>
892
+ </tbody>
893
+ </table></div>
894
+ </div>
895
+ <hr>
896
+ <div class="refsect2" title="cairo_move_to ()">
897
+ <a name="cairo-move-to"></a><h3>cairo_move_to ()</h3>
898
+ <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>,
899
+ <em class="parameter"><code><span class="type">double</span> x</code></em>,
900
+ <em class="parameter"><code><span class="type">double</span> y</code></em>);</pre>
901
+ <p>
902
+ Begin a new sub-path. After this call the current point will be (<em class="parameter"><code>x</code></em>,
903
+ <em class="parameter"><code>y</code></em>).
904
+ </p>
905
+ <div class="variablelist"><table border="0">
906
+ <col align="left" valign="top">
907
+ <tbody>
908
+ <tr>
909
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
910
+ <td>a cairo context
911
+ </td>
912
+ </tr>
913
+ <tr>
914
+ <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
915
+ <td>the X coordinate of the new position
916
+ </td>
917
+ </tr>
918
+ <tr>
919
+ <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
920
+ <td>the Y coordinate of the new position
921
+ </td>
922
+ </tr>
923
+ </tbody>
924
+ </table></div>
925
+ </div>
926
+ <hr>
927
+ <div class="refsect2" title="cairo_rectangle ()">
928
+ <a name="cairo-rectangle"></a><h3>cairo_rectangle ()</h3>
929
+ <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>,
930
+ <em class="parameter"><code><span class="type">double</span> x</code></em>,
931
+ <em class="parameter"><code><span class="type">double</span> y</code></em>,
932
+ <em class="parameter"><code><span class="type">double</span> width</code></em>,
933
+ <em class="parameter"><code><span class="type">double</span> height</code></em>);</pre>
934
+ <p>
935
+ Adds a closed sub-path rectangle of the given size to the current
936
+ path at position (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>) in user-space coordinates.
937
+ </p>
938
+ <p>
939
+ This function is logically equivalent to:
940
+ </p>
941
+ <div class="informalexample">
942
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
943
+ <tbody>
944
+ <tr>
945
+ <td class="listing_lines" align="right"><pre>1
946
+ 2
947
+ 3
948
+ 4
949
+ 5</pre></td>
950
+ <td class="listing_code"><pre class="programlisting"><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#cairo-move-to">cairo_move_to</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> x</span><span class="symbol">,</span><span class="normal"> y</span><span class="symbol">);</span>
951
+ <span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#cairo-rel-line-to">cairo_rel_line_to</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> width</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
952
+ <span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#cairo-rel-line-to">cairo_rel_line_to</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> height</span><span class="symbol">);</span>
953
+ <span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#cairo-rel-line-to">cairo_rel_line_to</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">-</span><span class="normal">width</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
954
+ <span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#cairo-close-path">cairo_close_path</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">);</span></pre></td>
955
+ </tr>
956
+ </tbody>
957
+ </table>
958
+ </div>
959
+
960
+ <p>
961
+ </p>
962
+ <div class="variablelist"><table border="0">
963
+ <col align="left" valign="top">
964
+ <tbody>
965
+ <tr>
966
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
967
+ <td>a cairo context
968
+ </td>
969
+ </tr>
970
+ <tr>
971
+ <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
972
+ <td>the X coordinate of the top left corner of the rectangle
973
+ </td>
974
+ </tr>
975
+ <tr>
976
+ <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
977
+ <td>the Y coordinate to the top left corner of the rectangle
978
+ </td>
979
+ </tr>
980
+ <tr>
981
+ <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
982
+ <td>the width of the rectangle
983
+ </td>
984
+ </tr>
985
+ <tr>
986
+ <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
987
+ <td>the height of the rectangle
988
+ </td>
989
+ </tr>
990
+ </tbody>
991
+ </table></div>
992
+ </div>
993
+ <hr>
994
+ <div class="refsect2" title="cairo_glyph_path ()">
995
+ <a name="cairo-glyph-path"></a><h3>cairo_glyph_path ()</h3>
996
+ <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>,
997
+ <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>,
998
+ <em class="parameter"><code><span class="type">int</span> num_glyphs</code></em>);</pre>
999
+ <p>
1000
+ Adds closed paths for the glyphs to the current path. The generated
1001
+ path if filled, achieves an effect similar to that of
1002
+ <a class="link" href="cairo-text.html#cairo-show-glyphs" title="cairo_show_glyphs ()"><code class="function">cairo_show_glyphs()</code></a>.
1003
+ </p>
1004
+ <div class="variablelist"><table border="0">
1005
+ <col align="left" valign="top">
1006
+ <tbody>
1007
+ <tr>
1008
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
1009
+ <td>a cairo context
1010
+ </td>
1011
+ </tr>
1012
+ <tr>
1013
+ <td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
1014
+ <td>array of glyphs to show
1015
+ </td>
1016
+ </tr>
1017
+ <tr>
1018
+ <td><p><span class="term"><em class="parameter"><code>num_glyphs</code></em> :</span></p></td>
1019
+ <td>number of glyphs to show
1020
+ </td>
1021
+ </tr>
1022
+ </tbody>
1023
+ </table></div>
1024
+ </div>
1025
+ <hr>
1026
+ <div class="refsect2" title="cairo_text_path ()">
1027
+ <a name="cairo-text-path"></a><h3>cairo_text_path ()</h3>
1028
+ <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>,
1029
+ <em class="parameter"><code>const <span class="type">char</span> *utf8</code></em>);</pre>
1030
+ <p>
1031
+ Adds closed paths for text to the current path. The generated
1032
+ path if filled, achieves an effect similar to that of
1033
+ <a class="link" href="cairo-text.html#cairo-show-text" title="cairo_show_text ()"><code class="function">cairo_show_text()</code></a>.
1034
+ </p>
1035
+ <p>
1036
+ 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>.
1037
+ </p>
1038
+ <p>
1039
+ 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
1040
+ moved to the origin of where the next glyph would be placed in
1041
+ this same progression. That is, the current point will be at
1042
+ the origin of the final glyph offset by its advance values.
1043
+ 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>
1044
+ without having to set current point in between.
1045
+ </p>
1046
+ <p>
1047
+ 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
1048
+ designers call the "toy" text API. It is convenient for short demos
1049
+ and simple programs, but it is not expected to be adequate for
1050
+ 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
1051
+ "real" text path API in cairo.
1052
+ </p>
1053
+ <div class="variablelist"><table border="0">
1054
+ <col align="left" valign="top">
1055
+ <tbody>
1056
+ <tr>
1057
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
1058
+ <td>a cairo context
1059
+ </td>
1060
+ </tr>
1061
+ <tr>
1062
+ <td><p><span class="term"><em class="parameter"><code>utf8</code></em> :</span></p></td>
1063
+ <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>
1064
+ </td>
1065
+ </tr>
1066
+ </tbody>
1067
+ </table></div>
1068
+ </div>
1069
+ <hr>
1070
+ <div class="refsect2" title="cairo_rel_curve_to ()">
1071
+ <a name="cairo-rel-curve-to"></a><h3>cairo_rel_curve_to ()</h3>
1072
+ <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>,
1073
+ <em class="parameter"><code><span class="type">double</span> dx1</code></em>,
1074
+ <em class="parameter"><code><span class="type">double</span> dy1</code></em>,
1075
+ <em class="parameter"><code><span class="type">double</span> dx2</code></em>,
1076
+ <em class="parameter"><code><span class="type">double</span> dy2</code></em>,
1077
+ <em class="parameter"><code><span class="type">double</span> dx3</code></em>,
1078
+ <em class="parameter"><code><span class="type">double</span> dy3</code></em>);</pre>
1079
+ <p>
1080
+ 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
1081
+ relative to the current point. Adds a cubic Bézier spline to the
1082
+ path from the current point to a point offset from the current
1083
+ 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
1084
+ (<em class="parameter"><code>dx2</code></em>, <em class="parameter"><code>dy2</code></em>) as the control points. After this call the current
1085
+ point will be offset by (<em class="parameter"><code>dx3</code></em>, <em class="parameter"><code>dy3</code></em>).
1086
+ </p>
1087
+ <p>
1088
+ 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>,
1089
+ <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
1090
+ 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>).
1091
+ </p>
1092
+ <p>
1093
+ It is an error to call this function with no current point. Doing
1094
+ so will cause <em class="parameter"><code>cr</code></em> to shutdown with a status of
1095
+ <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.
1096
+ </p>
1097
+ <div class="variablelist"><table border="0">
1098
+ <col align="left" valign="top">
1099
+ <tbody>
1100
+ <tr>
1101
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
1102
+ <td>a cairo context
1103
+ </td>
1104
+ </tr>
1105
+ <tr>
1106
+ <td><p><span class="term"><em class="parameter"><code>dx1</code></em> :</span></p></td>
1107
+ <td>the X offset to the first control point
1108
+ </td>
1109
+ </tr>
1110
+ <tr>
1111
+ <td><p><span class="term"><em class="parameter"><code>dy1</code></em> :</span></p></td>
1112
+ <td>the Y offset to the first control point
1113
+ </td>
1114
+ </tr>
1115
+ <tr>
1116
+ <td><p><span class="term"><em class="parameter"><code>dx2</code></em> :</span></p></td>
1117
+ <td>the X offset to the second control point
1118
+ </td>
1119
+ </tr>
1120
+ <tr>
1121
+ <td><p><span class="term"><em class="parameter"><code>dy2</code></em> :</span></p></td>
1122
+ <td>the Y offset to the second control point
1123
+ </td>
1124
+ </tr>
1125
+ <tr>
1126
+ <td><p><span class="term"><em class="parameter"><code>dx3</code></em> :</span></p></td>
1127
+ <td>the X offset to the end of the curve
1128
+ </td>
1129
+ </tr>
1130
+ <tr>
1131
+ <td><p><span class="term"><em class="parameter"><code>dy3</code></em> :</span></p></td>
1132
+ <td>the Y offset to the end of the curve
1133
+ </td>
1134
+ </tr>
1135
+ </tbody>
1136
+ </table></div>
1137
+ </div>
1138
+ <hr>
1139
+ <div class="refsect2" title="cairo_rel_line_to ()">
1140
+ <a name="cairo-rel-line-to"></a><h3>cairo_rel_line_to ()</h3>
1141
+ <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>,
1142
+ <em class="parameter"><code><span class="type">double</span> dx</code></em>,
1143
+ <em class="parameter"><code><span class="type">double</span> dy</code></em>);</pre>
1144
+ <p>
1145
+ 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
1146
+ path from the current point to a point that is offset from the
1147
+ current point by (<em class="parameter"><code>dx</code></em>, <em class="parameter"><code>dy</code></em>) in user space. After this call the
1148
+ current point will be offset by (<em class="parameter"><code>dx</code></em>, <em class="parameter"><code>dy</code></em>).
1149
+ </p>
1150
+ <p>
1151
+ 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>)
1152
+ 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>).
1153
+ </p>
1154
+ <p>
1155
+ It is an error to call this function with no current point. Doing
1156
+ so will cause <em class="parameter"><code>cr</code></em> to shutdown with a status of
1157
+ <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.
1158
+ </p>
1159
+ <div class="variablelist"><table border="0">
1160
+ <col align="left" valign="top">
1161
+ <tbody>
1162
+ <tr>
1163
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
1164
+ <td>a cairo context
1165
+ </td>
1166
+ </tr>
1167
+ <tr>
1168
+ <td><p><span class="term"><em class="parameter"><code>dx</code></em> :</span></p></td>
1169
+ <td>the X offset to the end of the new line
1170
+ </td>
1171
+ </tr>
1172
+ <tr>
1173
+ <td><p><span class="term"><em class="parameter"><code>dy</code></em> :</span></p></td>
1174
+ <td>the Y offset to the end of the new line
1175
+ </td>
1176
+ </tr>
1177
+ </tbody>
1178
+ </table></div>
1179
+ </div>
1180
+ <hr>
1181
+ <div class="refsect2" title="cairo_rel_move_to ()">
1182
+ <a name="cairo-rel-move-to"></a><h3>cairo_rel_move_to ()</h3>
1183
+ <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>,
1184
+ <em class="parameter"><code><span class="type">double</span> dx</code></em>,
1185
+ <em class="parameter"><code><span class="type">double</span> dy</code></em>);</pre>
1186
+ <p>
1187
+ Begin a new sub-path. After this call the current point will offset
1188
+ by (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>).
1189
+ </p>
1190
+ <p>
1191
+ 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>)
1192
+ 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>).
1193
+ </p>
1194
+ <p>
1195
+ It is an error to call this function with no current point. Doing
1196
+ so will cause <em class="parameter"><code>cr</code></em> to shutdown with a status of
1197
+ <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-CURRENT-POINT:CAPS"><code class="literal">CAIRO_STATUS_NO_CURRENT_POINT</code></a>.
1198
+ </p>
1199
+ <div class="variablelist"><table border="0">
1200
+ <col align="left" valign="top">
1201
+ <tbody>
1202
+ <tr>
1203
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
1204
+ <td>a cairo context
1205
+ </td>
1206
+ </tr>
1207
+ <tr>
1208
+ <td><p><span class="term"><em class="parameter"><code>dx</code></em> :</span></p></td>
1209
+ <td>the X offset
1210
+ </td>
1211
+ </tr>
1212
+ <tr>
1213
+ <td><p><span class="term"><em class="parameter"><code>dy</code></em> :</span></p></td>
1214
+ <td>the Y offset
1215
+ </td>
1216
+ </tr>
1217
+ </tbody>
1218
+ </table></div>
1219
+ </div>
1220
+ <hr>
1221
+ <div class="refsect2" title="cairo_path_extents ()">
1222
+ <a name="cairo-path-extents"></a><h3>cairo_path_extents ()</h3>
1223
+ <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>,
1224
+ <em class="parameter"><code><span class="type">double</span> *x1</code></em>,
1225
+ <em class="parameter"><code><span class="type">double</span> *y1</code></em>,
1226
+ <em class="parameter"><code><span class="type">double</span> *x2</code></em>,
1227
+ <em class="parameter"><code><span class="type">double</span> *y2</code></em>);</pre>
1228
+ <p>
1229
+ Computes a bounding box in user-space coordinates covering the
1230
+ points on the current path. If the current path is empty, returns
1231
+ an empty rectangle ((0,0), (0,0)). Stroke parameters, fill rule,
1232
+ surface dimensions and clipping are not taken into account.
1233
+ </p>
1234
+ <p>
1235
+ 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
1236
+ return the extents of only the area that would be "inked" by
1237
+ the corresponding drawing operations.
1238
+ </p>
1239
+ <p>
1240
+ 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
1241
+ 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
1242
+ line width approaches 0.0, (but never reaching the empty-rectangle
1243
+ 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).
1244
+ </p>
1245
+ <p>
1246
+ Specifically, this means that zero-area sub-paths such as
1247
+ <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
1248
+ where the coordinates to both calls are identical), will be
1249
+ considered as contributing to the extents. However, a lone
1250
+ <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
1251
+ <a class="link" href="cairo-Paths.html#cairo-path-extents" title="cairo_path_extents ()"><code class="function">cairo_path_extents()</code></a>.
1252
+ </p>
1253
+ <div class="variablelist"><table border="0">
1254
+ <col align="left" valign="top">
1255
+ <tbody>
1256
+ <tr>
1257
+ <td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
1258
+ <td>a cairo context
1259
+ </td>
1260
+ </tr>
1261
+ <tr>
1262
+ <td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
1263
+ <td>left of the resulting extents
1264
+ </td>
1265
+ </tr>
1266
+ <tr>
1267
+ <td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
1268
+ <td>top of the resulting extents
1269
+ </td>
1270
+ </tr>
1271
+ <tr>
1272
+ <td><p><span class="term"><em class="parameter"><code>x2</code></em> :</span></p></td>
1273
+ <td>right of the resulting extents
1274
+ </td>
1275
+ </tr>
1276
+ <tr>
1277
+ <td><p><span class="term"><em class="parameter"><code>y2</code></em> :</span></p></td>
1278
+ <td>bottom of the resulting extents
1279
+ </td>
1280
+ </tr>
1281
+ </tbody>
1282
+ </table></div>
1283
+ <p class="since">Since 1.6</p>
1284
+ </div>
1285
+ </div>
1286
+ </div>
1287
+ <div class="footer">
1288
+ <hr>
1289
+ Generated by GTK-Doc V1.15</div>
1290
+ </body>
1291
+ </html>