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
@@ -1,1485 +0,0 @@
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>cairo_pattern_t</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-paths.html" title="Paths">
10
- <link rel="next" href="cairo-transformations.html" title="Transformations">
11
- <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
- <link rel="stylesheet" href="style.css" type="text/css">
13
- <link rel="chapter" href="cairo-drawing.html" title="Drawing">
14
- <link rel="chapter" href="cairo-fonts.html" title="Fonts">
15
- <link rel="chapter" href="cairo-surfaces.html" title="Surfaces">
16
- <link rel="chapter" href="cairo-support.html" title="Utilities">
17
- <link rel="index" href="index-all.html" title="Index">
18
- <link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
19
- <link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
20
- <link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
21
- <link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
22
- <link rel="appendix" href="language-bindings.html" title="Appendix A. Creating a language binding for cairo">
23
- </head>
24
- <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
25
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
26
- <tr valign="middle">
27
- <td><a accesskey="p" href="cairo-paths.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
28
- <td><a accesskey="u" href="cairo-drawing.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
29
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
30
- <th width="100%" align="center">Cairo: A Vector Graphics Library</th>
31
- <td><a accesskey="n" href="cairo-transformations.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
32
- </tr>
33
- <tr><td colspan="5" class="shortcuts">
34
- <a href="#cairo-pattern.synopsis" class="shortcut">Top</a>
35
-  | 
36
- <a href="#cairo-pattern.description" class="shortcut">Description</a>
37
- </td></tr>
38
- </table>
39
- <div class="refentry" title="cairo_pattern_t">
40
- <a name="cairo-pattern"></a><div class="titlepage"></div>
41
- <div class="refnamediv"><table width="100%"><tr>
42
- <td valign="top">
43
- <h2><span class="refentrytitle"><a name="cairo-pattern.top_of_page"></a>cairo_pattern_t</span></h2>
44
- <p>cairo_pattern_t — Sources for drawing</p>
45
- </td>
46
- <td valign="top" align="right"></td>
47
- </tr></table></div>
48
- <div class="refsynopsisdiv" title="Synopsis">
49
- <a name="cairo-pattern.synopsis"></a><h2>Synopsis</h2>
50
- <pre class="synopsis">
51
- typedef <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a>;
52
- void <a class="link" href="cairo-pattern.html#cairo-pattern-add-color-stop-rgb" title="cairo_pattern_add_color_stop_rgb ()">cairo_pattern_add_color_stop_rgb</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
53
- double offset,
54
- double red,
55
- double green,
56
- double blue);
57
- void <a class="link" href="cairo-pattern.html#cairo-pattern-add-color-stop-rgba" title="cairo_pattern_add_color_stop_rgba ()">cairo_pattern_add_color_stop_rgba</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
58
- double offset,
59
- double red,
60
- double green,
61
- double blue,
62
- double alpha);
63
- <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-get-color-stop-count" title="cairo_pattern_get_color_stop_count ()">cairo_pattern_get_color_stop_count</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
64
- int *count);
65
- <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-get-color-stop-rgba" title="cairo_pattern_get_color_stop_rgba ()">cairo_pattern_get_color_stop_rgba</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
66
- int index,
67
- double *offset,
68
- double *red,
69
- double *green,
70
- double *blue,
71
- double *alpha);
72
- <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * <a class="link" href="cairo-pattern.html#cairo-pattern-create-rgb" title="cairo_pattern_create_rgb ()">cairo_pattern_create_rgb</a> (double red,
73
- double green,
74
- double blue);
75
- <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * <a class="link" href="cairo-pattern.html#cairo-pattern-create-rgba" title="cairo_pattern_create_rgba ()">cairo_pattern_create_rgba</a> (double red,
76
- double green,
77
- double blue,
78
- double alpha);
79
- <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-get-rgba" title="cairo_pattern_get_rgba ()">cairo_pattern_get_rgba</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
80
- double *red,
81
- double *green,
82
- double *blue,
83
- double *alpha);
84
- <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * <a class="link" href="cairo-pattern.html#cairo-pattern-create-for-surface" title="cairo_pattern_create_for_surface ()">cairo_pattern_create_for_surface</a> (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface);
85
- <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-get-surface" title="cairo_pattern_get_surface ()">cairo_pattern_get_surface</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
86
- <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> **surface);
87
- <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * <a class="link" href="cairo-pattern.html#cairo-pattern-create-linear" title="cairo_pattern_create_linear ()">cairo_pattern_create_linear</a> (double x0,
88
- double y0,
89
- double x1,
90
- double y1);
91
- <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-get-linear-points" title="cairo_pattern_get_linear_points ()">cairo_pattern_get_linear_points</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
92
- double *x0,
93
- double *y0,
94
- double *x1,
95
- double *y1);
96
- <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * <a class="link" href="cairo-pattern.html#cairo-pattern-create-radial" title="cairo_pattern_create_radial ()">cairo_pattern_create_radial</a> (double cx0,
97
- double cy0,
98
- double radius0,
99
- double cx1,
100
- double cy1,
101
- double radius1);
102
- <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-get-radial-circles" title="cairo_pattern_get_radial_circles ()">cairo_pattern_get_radial_circles</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
103
- double *x0,
104
- double *y0,
105
- double *r0,
106
- double *x1,
107
- double *y1,
108
- double *r1);
109
- <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * <a class="link" href="cairo-pattern.html#cairo-pattern-reference" title="cairo_pattern_reference ()">cairo_pattern_reference</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);
110
- void <a class="link" href="cairo-pattern.html#cairo-pattern-destroy" title="cairo_pattern_destroy ()">cairo_pattern_destroy</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);
111
- <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-status" title="cairo_pattern_status ()">cairo_pattern_status</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);
112
- enum <a class="link" href="cairo-pattern.html#cairo-extend-t" title="enum cairo_extend_t">cairo_extend_t</a>;
113
- void <a class="link" href="cairo-pattern.html#cairo-pattern-set-extend" title="cairo_pattern_set_extend ()">cairo_pattern_set_extend</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
114
- <a class="link" href="cairo-pattern.html#cairo-extend-t" title="enum cairo_extend_t">cairo_extend_t</a> extend);
115
- <a class="link" href="cairo-pattern.html#cairo-extend-t" title="enum cairo_extend_t">cairo_extend_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-get-extend" title="cairo_pattern_get_extend ()">cairo_pattern_get_extend</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);
116
- enum <a class="link" href="cairo-pattern.html#cairo-filter-t" title="enum cairo_filter_t">cairo_filter_t</a>;
117
- void <a class="link" href="cairo-pattern.html#cairo-pattern-set-filter" title="cairo_pattern_set_filter ()">cairo_pattern_set_filter</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
118
- <a class="link" href="cairo-pattern.html#cairo-filter-t" title="enum cairo_filter_t">cairo_filter_t</a> filter);
119
- <a class="link" href="cairo-pattern.html#cairo-filter-t" title="enum cairo_filter_t">cairo_filter_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-get-filter" title="cairo_pattern_get_filter ()">cairo_pattern_get_filter</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);
120
- void <a class="link" href="cairo-pattern.html#cairo-pattern-set-matrix" title="cairo_pattern_set_matrix ()">cairo_pattern_set_matrix</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
121
- const <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *matrix);
122
- void <a class="link" href="cairo-pattern.html#cairo-pattern-get-matrix" title="cairo_pattern_get_matrix ()">cairo_pattern_get_matrix</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
123
- <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *matrix);
124
- enum <a class="link" href="cairo-pattern.html#cairo-pattern-type-t" title="enum cairo_pattern_type_t">cairo_pattern_type_t</a>;
125
- <a class="link" href="cairo-pattern.html#cairo-pattern-type-t" title="enum cairo_pattern_type_t">cairo_pattern_type_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-get-type" title="cairo_pattern_get_type ()">cairo_pattern_get_type</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);
126
- unsigned int <a class="link" href="cairo-pattern.html#cairo-pattern-get-reference-count" title="cairo_pattern_get_reference_count ()">cairo_pattern_get_reference_count</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);
127
- <a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> <a class="link" href="cairo-pattern.html#cairo-pattern-set-user-data" title="cairo_pattern_set_user_data ()">cairo_pattern_set_user_data</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
128
- const <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a> *key,
129
- void *user_data,
130
- <a class="link" href="cairo-types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()">cairo_destroy_func_t</a> destroy);
131
- void * <a class="link" href="cairo-pattern.html#cairo-pattern-get-user-data" title="cairo_pattern_get_user_data ()">cairo_pattern_get_user_data</a> (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
132
- const <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a> *key);
133
- </pre>
134
- </div>
135
- <div class="refsect1" title="Description">
136
- <a name="cairo-pattern.description"></a><h2>Description</h2>
137
- <p>
138
- <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> is the paint with which cairo draws.
139
- The primary use of patterns is as the source for all cairo drawing operations,
140
- although they can also be used as masks, that is, as the brush too.
141
- </p>
142
- <p>
143
- A cairo pattern is created by using one of the many constructors,
144
- of the form cairo_pattern_create_<span class="emphasis"><em>type</em></span>()
145
- or implicitly through
146
- cairo_set_source_<span class="emphasis"><em>type</em></span>() functions.
147
- </p>
148
- </div>
149
- <div class="refsect1" title="Details">
150
- <a name="cairo-pattern.details"></a><h2>Details</h2>
151
- <div class="refsect2" title="cairo_pattern_t">
152
- <a name="cairo-pattern-t"></a><h3>cairo_pattern_t</h3>
153
- <pre class="programlisting">typedef struct _cairo_pattern cairo_pattern_t;
154
- </pre>
155
- <p>
156
- A <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> represents a source when drawing onto a
157
- surface. There are different subtypes of <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>,
158
- for different types of sources; for example,
159
- <a class="link" href="cairo-pattern.html#cairo-pattern-create-rgb" title="cairo_pattern_create_rgb ()"><code class="function">cairo_pattern_create_rgb()</code></a> creates a pattern for a solid
160
- opaque color.
161
- </p>
162
- <p>
163
- Other than various cairo_pattern_create_<span class="emphasis"><em>type</em></span>()
164
- functions, some of the pattern types can be implicitly created
165
- using various cairo_set_source_<span class="emphasis"><em>type</em></span>() functions;
166
- for example <a class="link" href="cairo-context.html#cairo-set-source-rgb" title="cairo_set_source_rgb ()"><code class="function">cairo_set_source_rgb()</code></a>.
167
- </p>
168
- <p>
169
- The type of a pattern can be queried with <a class="link" href="cairo-pattern.html#cairo-pattern-get-type" title="cairo_pattern_get_type ()"><code class="function">cairo_pattern_get_type()</code></a>.
170
- </p>
171
- <p>
172
- Memory management of <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> is done with
173
- <a class="link" href="cairo-pattern.html#cairo-pattern-reference" title="cairo_pattern_reference ()"><code class="function">cairo_pattern_reference()</code></a> and <a class="link" href="cairo-pattern.html#cairo-pattern-destroy" title="cairo_pattern_destroy ()"><code class="function">cairo_pattern_destroy()</code></a>.</p>
174
- <p>
175
- </p>
176
- </div>
177
- <hr>
178
- <div class="refsect2" title="cairo_pattern_add_color_stop_rgb ()">
179
- <a name="cairo-pattern-add-color-stop-rgb"></a><h3>cairo_pattern_add_color_stop_rgb ()</h3>
180
- <pre class="programlisting">void cairo_pattern_add_color_stop_rgb (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
181
- double offset,
182
- double red,
183
- double green,
184
- double blue);</pre>
185
- <p>
186
- Adds an opaque color stop to a gradient pattern. The offset
187
- specifies the location along the gradient's control vector. For
188
- example, a linear gradient's control vector is from (x0,y0) to
189
- (x1,y1) while a radial gradient's control vector is from any point
190
- on the start circle to the corresponding point on the end circle.
191
- </p>
192
- <p>
193
- The color is specified in the same way as in <a class="link" href="cairo-context.html#cairo-set-source-rgb" title="cairo_set_source_rgb ()"><code class="function">cairo_set_source_rgb()</code></a>.
194
- </p>
195
- <p>
196
- If two (or more) stops are specified with identical offset values,
197
- they will be sorted according to the order in which the stops are
198
- added, (stops added earlier will compare less than stops added
199
- later). This can be useful for reliably making sharp color
200
- transitions instead of the typical blend.
201
- </p>
202
- <p>
203
- Note: If the pattern is not a gradient pattern, (eg. a linear or
204
- radial pattern), then the pattern will be put into an error status
205
- with a status of <a class="link" href="cairo-error-status.html#CAIRO-STATUS-PATTERN-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</code></a>.</p>
206
- <p>
207
- </p>
208
- <div class="variablelist"><table border="0">
209
- <col align="left" valign="top">
210
- <tbody>
211
- <tr>
212
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
213
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
214
- </td>
215
- </tr>
216
- <tr>
217
- <td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
218
- <td> an offset in the range [0.0 .. 1.0]
219
- </td>
220
- </tr>
221
- <tr>
222
- <td><p><span class="term"><em class="parameter"><code>red</code></em> :</span></p></td>
223
- <td> red component of color
224
- </td>
225
- </tr>
226
- <tr>
227
- <td><p><span class="term"><em class="parameter"><code>green</code></em> :</span></p></td>
228
- <td> green component of color
229
- </td>
230
- </tr>
231
- <tr>
232
- <td><p><span class="term"><em class="parameter"><code>blue</code></em> :</span></p></td>
233
- <td> blue component of color
234
- </td>
235
- </tr>
236
- </tbody>
237
- </table></div>
238
- </div>
239
- <hr>
240
- <div class="refsect2" title="cairo_pattern_add_color_stop_rgba ()">
241
- <a name="cairo-pattern-add-color-stop-rgba"></a><h3>cairo_pattern_add_color_stop_rgba ()</h3>
242
- <pre class="programlisting">void cairo_pattern_add_color_stop_rgba (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
243
- double offset,
244
- double red,
245
- double green,
246
- double blue,
247
- double alpha);</pre>
248
- <p>
249
- Adds a translucent color stop to a gradient pattern. The offset
250
- specifies the location along the gradient's control vector. For
251
- example, a linear gradient's control vector is from (x0,y0) to
252
- (x1,y1) while a radial gradient's control vector is from any point
253
- on the start circle to the corresponding point on the end circle.
254
- </p>
255
- <p>
256
- The color is specified in the same way as in <a class="link" href="cairo-context.html#cairo-set-source-rgba" title="cairo_set_source_rgba ()"><code class="function">cairo_set_source_rgba()</code></a>.
257
- </p>
258
- <p>
259
- If two (or more) stops are specified with identical offset values,
260
- they will be sorted according to the order in which the stops are
261
- added, (stops added earlier will compare less than stops added
262
- later). This can be useful for reliably making sharp color
263
- transitions instead of the typical blend.
264
- </p>
265
- <p>
266
- Note: If the pattern is not a gradient pattern, (eg. a linear or
267
- radial pattern), then the pattern will be put into an error status
268
- with a status of <a class="link" href="cairo-error-status.html#CAIRO-STATUS-PATTERN-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</code></a>.</p>
269
- <p>
270
- </p>
271
- <div class="variablelist"><table border="0">
272
- <col align="left" valign="top">
273
- <tbody>
274
- <tr>
275
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
276
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
277
- </td>
278
- </tr>
279
- <tr>
280
- <td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
281
- <td> an offset in the range [0.0 .. 1.0]
282
- </td>
283
- </tr>
284
- <tr>
285
- <td><p><span class="term"><em class="parameter"><code>red</code></em> :</span></p></td>
286
- <td> red component of color
287
- </td>
288
- </tr>
289
- <tr>
290
- <td><p><span class="term"><em class="parameter"><code>green</code></em> :</span></p></td>
291
- <td> green component of color
292
- </td>
293
- </tr>
294
- <tr>
295
- <td><p><span class="term"><em class="parameter"><code>blue</code></em> :</span></p></td>
296
- <td> blue component of color
297
- </td>
298
- </tr>
299
- <tr>
300
- <td><p><span class="term"><em class="parameter"><code>alpha</code></em> :</span></p></td>
301
- <td> alpha component of color
302
- </td>
303
- </tr>
304
- </tbody>
305
- </table></div>
306
- </div>
307
- <hr>
308
- <div class="refsect2" title="cairo_pattern_get_color_stop_count ()">
309
- <a name="cairo-pattern-get-color-stop-count"></a><h3>cairo_pattern_get_color_stop_count ()</h3>
310
- <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_pattern_get_color_stop_count (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
311
- int *count);</pre>
312
- <p>
313
- Gets the number of color stops specified in the given gradient
314
- pattern.</p>
315
- <p>
316
- </p>
317
- <div class="variablelist"><table border="0">
318
- <col align="left" valign="top">
319
- <tbody>
320
- <tr>
321
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
322
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
323
- </td>
324
- </tr>
325
- <tr>
326
- <td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td>
327
- <td> return value for the number of color stops, or <code class="literal">NULL</code>
328
- </td>
329
- </tr>
330
- <tr>
331
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
332
- <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>, or
333
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-PATTERN-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</code></a> if <em class="parameter"><code>pattern</code></em> is not a gradient
334
- pattern.
335
-
336
- </td>
337
- </tr>
338
- </tbody>
339
- </table></div>
340
- <p class="since">Since 1.4</p>
341
- </div>
342
- <hr>
343
- <div class="refsect2" title="cairo_pattern_get_color_stop_rgba ()">
344
- <a name="cairo-pattern-get-color-stop-rgba"></a><h3>cairo_pattern_get_color_stop_rgba ()</h3>
345
- <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_pattern_get_color_stop_rgba (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
346
- int index,
347
- double *offset,
348
- double *red,
349
- double *green,
350
- double *blue,
351
- double *alpha);</pre>
352
- <p>
353
- Gets the color and offset information at the given <em class="parameter"><code>index</code></em> for a
354
- gradient pattern. Values of <em class="parameter"><code>index</code></em> are 0 to 1 less than the number
355
- returned by <a class="link" href="cairo-pattern.html#cairo-pattern-get-color-stop-count" title="cairo_pattern_get_color_stop_count ()"><code class="function">cairo_pattern_get_color_stop_count()</code></a>.</p>
356
- <p>
357
- </p>
358
- <div class="variablelist"><table border="0">
359
- <col align="left" valign="top">
360
- <tbody>
361
- <tr>
362
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
363
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
364
- </td>
365
- </tr>
366
- <tr>
367
- <td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
368
- <td> index of the stop to return data for
369
- </td>
370
- </tr>
371
- <tr>
372
- <td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
373
- <td> return value for the offset of the stop, or <code class="literal">NULL</code>
374
- </td>
375
- </tr>
376
- <tr>
377
- <td><p><span class="term"><em class="parameter"><code>red</code></em> :</span></p></td>
378
- <td> return value for red component of color, or <code class="literal">NULL</code>
379
- </td>
380
- </tr>
381
- <tr>
382
- <td><p><span class="term"><em class="parameter"><code>green</code></em> :</span></p></td>
383
- <td> return value for green component of color, or <code class="literal">NULL</code>
384
- </td>
385
- </tr>
386
- <tr>
387
- <td><p><span class="term"><em class="parameter"><code>blue</code></em> :</span></p></td>
388
- <td> return value for blue component of color, or <code class="literal">NULL</code>
389
- </td>
390
- </tr>
391
- <tr>
392
- <td><p><span class="term"><em class="parameter"><code>alpha</code></em> :</span></p></td>
393
- <td> return value for alpha component of color, or <code class="literal">NULL</code>
394
- </td>
395
- </tr>
396
- <tr>
397
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
398
- <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>, or <a class="link" href="cairo-error-status.html#CAIRO-STATUS-INVALID-INDEX--CAPS"><code class="literal">CAIRO_STATUS_INVALID_INDEX</code></a>
399
- if <em class="parameter"><code>index</code></em> is not valid for the given pattern. If the pattern is
400
- not a gradient pattern, <a class="link" href="cairo-error-status.html#CAIRO-STATUS-PATTERN-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</code></a> is
401
- returned.
402
-
403
- </td>
404
- </tr>
405
- </tbody>
406
- </table></div>
407
- <p class="since">Since 1.4</p>
408
- </div>
409
- <hr>
410
- <div class="refsect2" title="cairo_pattern_create_rgb ()">
411
- <a name="cairo-pattern-create-rgb"></a><h3>cairo_pattern_create_rgb ()</h3>
412
- <pre class="programlisting"><a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * cairo_pattern_create_rgb (double red,
413
- double green,
414
- double blue);</pre>
415
- <p>
416
- Creates a new <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> corresponding to an opaque color. The
417
- color components are floating point numbers in the range 0 to 1.
418
- If the values passed in are outside that range, they will be
419
- clamped.</p>
420
- <p>
421
- </p>
422
- <div class="variablelist"><table border="0">
423
- <col align="left" valign="top">
424
- <tbody>
425
- <tr>
426
- <td><p><span class="term"><em class="parameter"><code>red</code></em> :</span></p></td>
427
- <td> red component of the color
428
- </td>
429
- </tr>
430
- <tr>
431
- <td><p><span class="term"><em class="parameter"><code>green</code></em> :</span></p></td>
432
- <td> green component of the color
433
- </td>
434
- </tr>
435
- <tr>
436
- <td><p><span class="term"><em class="parameter"><code>blue</code></em> :</span></p></td>
437
- <td> blue component of the color
438
- </td>
439
- </tr>
440
- <tr>
441
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
442
- <td> the newly created <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> if successful, or
443
- an error pattern in case of no memory. The caller owns the
444
- returned object and should call <a class="link" href="cairo-pattern.html#cairo-pattern-destroy" title="cairo_pattern_destroy ()"><code class="function">cairo_pattern_destroy()</code></a> when
445
- finished with it.
446
-
447
- This function will always return a valid pointer, but if an error
448
- occurred the pattern status will be set to an error. To inspect
449
- the status of a pattern use <a class="link" href="cairo-pattern.html#cairo-pattern-status" title="cairo_pattern_status ()"><code class="function">cairo_pattern_status()</code></a>.
450
- </td>
451
- </tr>
452
- </tbody>
453
- </table></div>
454
- </div>
455
- <hr>
456
- <div class="refsect2" title="cairo_pattern_create_rgba ()">
457
- <a name="cairo-pattern-create-rgba"></a><h3>cairo_pattern_create_rgba ()</h3>
458
- <pre class="programlisting"><a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * cairo_pattern_create_rgba (double red,
459
- double green,
460
- double blue,
461
- double alpha);</pre>
462
- <p>
463
- Creates a new <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> corresponding to a translucent color.
464
- The color components are floating point numbers in the range 0 to
465
- 1. If the values passed in are outside that range, they will be
466
- clamped.</p>
467
- <p>
468
- </p>
469
- <div class="variablelist"><table border="0">
470
- <col align="left" valign="top">
471
- <tbody>
472
- <tr>
473
- <td><p><span class="term"><em class="parameter"><code>red</code></em> :</span></p></td>
474
- <td> red component of the color
475
- </td>
476
- </tr>
477
- <tr>
478
- <td><p><span class="term"><em class="parameter"><code>green</code></em> :</span></p></td>
479
- <td> green component of the color
480
- </td>
481
- </tr>
482
- <tr>
483
- <td><p><span class="term"><em class="parameter"><code>blue</code></em> :</span></p></td>
484
- <td> blue component of the color
485
- </td>
486
- </tr>
487
- <tr>
488
- <td><p><span class="term"><em class="parameter"><code>alpha</code></em> :</span></p></td>
489
- <td> alpha component of the color
490
- </td>
491
- </tr>
492
- <tr>
493
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
494
- <td> the newly created <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> if successful, or
495
- an error pattern in case of no memory. The caller owns the
496
- returned object and should call <a class="link" href="cairo-pattern.html#cairo-pattern-destroy" title="cairo_pattern_destroy ()"><code class="function">cairo_pattern_destroy()</code></a> when
497
- finished with it.
498
-
499
- This function will always return a valid pointer, but if an error
500
- occurred the pattern status will be set to an error. To inspect
501
- the status of a pattern use <a class="link" href="cairo-pattern.html#cairo-pattern-status" title="cairo_pattern_status ()"><code class="function">cairo_pattern_status()</code></a>.
502
- </td>
503
- </tr>
504
- </tbody>
505
- </table></div>
506
- </div>
507
- <hr>
508
- <div class="refsect2" title="cairo_pattern_get_rgba ()">
509
- <a name="cairo-pattern-get-rgba"></a><h3>cairo_pattern_get_rgba ()</h3>
510
- <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_pattern_get_rgba (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
511
- double *red,
512
- double *green,
513
- double *blue,
514
- double *alpha);</pre>
515
- <p>
516
- Gets the solid color for a solid color pattern.</p>
517
- <p>
518
- </p>
519
- <div class="variablelist"><table border="0">
520
- <col align="left" valign="top">
521
- <tbody>
522
- <tr>
523
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
524
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
525
- </td>
526
- </tr>
527
- <tr>
528
- <td><p><span class="term"><em class="parameter"><code>red</code></em> :</span></p></td>
529
- <td> return value for red component of color, or <code class="literal">NULL</code>
530
- </td>
531
- </tr>
532
- <tr>
533
- <td><p><span class="term"><em class="parameter"><code>green</code></em> :</span></p></td>
534
- <td> return value for green component of color, or <code class="literal">NULL</code>
535
- </td>
536
- </tr>
537
- <tr>
538
- <td><p><span class="term"><em class="parameter"><code>blue</code></em> :</span></p></td>
539
- <td> return value for blue component of color, or <code class="literal">NULL</code>
540
- </td>
541
- </tr>
542
- <tr>
543
- <td><p><span class="term"><em class="parameter"><code>alpha</code></em> :</span></p></td>
544
- <td> return value for alpha component of color, or <code class="literal">NULL</code>
545
- </td>
546
- </tr>
547
- <tr>
548
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
549
- <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>, or
550
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-PATTERN-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</code></a> if the pattern is not a solid
551
- color pattern.
552
-
553
- </td>
554
- </tr>
555
- </tbody>
556
- </table></div>
557
- <p class="since">Since 1.4</p>
558
- </div>
559
- <hr>
560
- <div class="refsect2" title="cairo_pattern_create_for_surface ()">
561
- <a name="cairo-pattern-create-for-surface"></a><h3>cairo_pattern_create_for_surface ()</h3>
562
- <pre class="programlisting"><a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * cairo_pattern_create_for_surface (<a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface);</pre>
563
- <p>
564
- Create a new <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> for the given surface.</p>
565
- <p>
566
- </p>
567
- <div class="variablelist"><table border="0">
568
- <col align="left" valign="top">
569
- <tbody>
570
- <tr>
571
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
572
- <td> the surface
573
- </td>
574
- </tr>
575
- <tr>
576
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
577
- <td> the newly created <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> if successful, or
578
- an error pattern in case of no memory. The caller owns the
579
- returned object and should call <a class="link" href="cairo-pattern.html#cairo-pattern-destroy" title="cairo_pattern_destroy ()"><code class="function">cairo_pattern_destroy()</code></a> when
580
- finished with it.
581
-
582
- This function will always return a valid pointer, but if an error
583
- occurred the pattern status will be set to an error. To inspect
584
- the status of a pattern use <a class="link" href="cairo-pattern.html#cairo-pattern-status" title="cairo_pattern_status ()"><code class="function">cairo_pattern_status()</code></a>.
585
- </td>
586
- </tr>
587
- </tbody>
588
- </table></div>
589
- </div>
590
- <hr>
591
- <div class="refsect2" title="cairo_pattern_get_surface ()">
592
- <a name="cairo-pattern-get-surface"></a><h3>cairo_pattern_get_surface ()</h3>
593
- <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_pattern_get_surface (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
594
- <a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> **surface);</pre>
595
- <p>
596
- Gets the surface of a surface pattern. The reference returned in
597
- <em class="parameter"><code>surface</code></em> is owned by the pattern; the caller should call
598
- <a class="link" href="cairo-surface.html#cairo-surface-reference" title="cairo_surface_reference ()"><code class="function">cairo_surface_reference()</code></a> if the surface is to be retained.</p>
599
- <p>
600
- </p>
601
- <div class="variablelist"><table border="0">
602
- <col align="left" valign="top">
603
- <tbody>
604
- <tr>
605
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
606
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
607
- </td>
608
- </tr>
609
- <tr>
610
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
611
- <td> return value for surface of pattern, or <code class="literal">NULL</code>
612
- </td>
613
- </tr>
614
- <tr>
615
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
616
- <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>, or
617
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-PATTERN-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</code></a> if the pattern is not a surface
618
- pattern.
619
-
620
- </td>
621
- </tr>
622
- </tbody>
623
- </table></div>
624
- <p class="since">Since 1.4</p>
625
- </div>
626
- <hr>
627
- <div class="refsect2" title="cairo_pattern_create_linear ()">
628
- <a name="cairo-pattern-create-linear"></a><h3>cairo_pattern_create_linear ()</h3>
629
- <pre class="programlisting"><a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * cairo_pattern_create_linear (double x0,
630
- double y0,
631
- double x1,
632
- double y1);</pre>
633
- <p>
634
- Create a new linear gradient <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> along the line defined
635
- by (x0, y0) and (x1, y1). Before using the gradient pattern, a
636
- number of color stops should be defined using
637
- <a class="link" href="cairo-pattern.html#cairo-pattern-add-color-stop-rgb" title="cairo_pattern_add_color_stop_rgb ()"><code class="function">cairo_pattern_add_color_stop_rgb()</code></a> or
638
- <a class="link" href="cairo-pattern.html#cairo-pattern-add-color-stop-rgba" title="cairo_pattern_add_color_stop_rgba ()"><code class="function">cairo_pattern_add_color_stop_rgba()</code></a>.
639
- </p>
640
- <p>
641
- Note: The coordinates here are in pattern space. For a new pattern,
642
- pattern space is identical to user space, but the relationship
643
- between the spaces can be changed with <a class="link" href="cairo-pattern.html#cairo-pattern-set-matrix" title="cairo_pattern_set_matrix ()"><code class="function">cairo_pattern_set_matrix()</code></a>.</p>
644
- <p>
645
- </p>
646
- <div class="variablelist"><table border="0">
647
- <col align="left" valign="top">
648
- <tbody>
649
- <tr>
650
- <td><p><span class="term"><em class="parameter"><code>x0</code></em> :</span></p></td>
651
- <td> x coordinate of the start point
652
- </td>
653
- </tr>
654
- <tr>
655
- <td><p><span class="term"><em class="parameter"><code>y0</code></em> :</span></p></td>
656
- <td> y coordinate of the start point
657
- </td>
658
- </tr>
659
- <tr>
660
- <td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
661
- <td> x coordinate of the end point
662
- </td>
663
- </tr>
664
- <tr>
665
- <td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
666
- <td> y coordinate of the end point
667
- </td>
668
- </tr>
669
- <tr>
670
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
671
- <td> the newly created <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> if successful, or
672
- an error pattern in case of no memory. The caller owns the
673
- returned object and should call <a class="link" href="cairo-pattern.html#cairo-pattern-destroy" title="cairo_pattern_destroy ()"><code class="function">cairo_pattern_destroy()</code></a> when
674
- finished with it.
675
-
676
- This function will always return a valid pointer, but if an error
677
- occurred the pattern status will be set to an error. To inspect
678
- the status of a pattern use <a class="link" href="cairo-pattern.html#cairo-pattern-status" title="cairo_pattern_status ()"><code class="function">cairo_pattern_status()</code></a>.
679
- </td>
680
- </tr>
681
- </tbody>
682
- </table></div>
683
- </div>
684
- <hr>
685
- <div class="refsect2" title="cairo_pattern_get_linear_points ()">
686
- <a name="cairo-pattern-get-linear-points"></a><h3>cairo_pattern_get_linear_points ()</h3>
687
- <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_pattern_get_linear_points (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
688
- double *x0,
689
- double *y0,
690
- double *x1,
691
- double *y1);</pre>
692
- <p>
693
- Gets the gradient endpoints for a linear gradient.</p>
694
- <p>
695
- </p>
696
- <div class="variablelist"><table border="0">
697
- <col align="left" valign="top">
698
- <tbody>
699
- <tr>
700
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
701
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
702
- </td>
703
- </tr>
704
- <tr>
705
- <td><p><span class="term"><em class="parameter"><code>x0</code></em> :</span></p></td>
706
- <td> return value for the x coordinate of the first point, or <code class="literal">NULL</code>
707
- </td>
708
- </tr>
709
- <tr>
710
- <td><p><span class="term"><em class="parameter"><code>y0</code></em> :</span></p></td>
711
- <td> return value for the y coordinate of the first point, or <code class="literal">NULL</code>
712
- </td>
713
- </tr>
714
- <tr>
715
- <td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
716
- <td> return value for the x coordinate of the second point, or <code class="literal">NULL</code>
717
- </td>
718
- </tr>
719
- <tr>
720
- <td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
721
- <td> return value for the y coordinate of the second point, or <code class="literal">NULL</code>
722
- </td>
723
- </tr>
724
- <tr>
725
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
726
- <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>, or
727
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-PATTERN-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</code></a> if <em class="parameter"><code>pattern</code></em> is not a linear
728
- gradient pattern.
729
-
730
- </td>
731
- </tr>
732
- </tbody>
733
- </table></div>
734
- <p class="since">Since 1.4</p>
735
- </div>
736
- <hr>
737
- <div class="refsect2" title="cairo_pattern_create_radial ()">
738
- <a name="cairo-pattern-create-radial"></a><h3>cairo_pattern_create_radial ()</h3>
739
- <pre class="programlisting"><a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * cairo_pattern_create_radial (double cx0,
740
- double cy0,
741
- double radius0,
742
- double cx1,
743
- double cy1,
744
- double radius1);</pre>
745
- <p>
746
- Creates a new radial gradient <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> between the two
747
- circles defined by (cx0, cy0, radius0) and (cx1, cy1, radius1). Before using the
748
- gradient pattern, a number of color stops should be defined using
749
- <a class="link" href="cairo-pattern.html#cairo-pattern-add-color-stop-rgb" title="cairo_pattern_add_color_stop_rgb ()"><code class="function">cairo_pattern_add_color_stop_rgb()</code></a> or
750
- <a class="link" href="cairo-pattern.html#cairo-pattern-add-color-stop-rgba" title="cairo_pattern_add_color_stop_rgba ()"><code class="function">cairo_pattern_add_color_stop_rgba()</code></a>.
751
- </p>
752
- <p>
753
- Note: The coordinates here are in pattern space. For a new pattern,
754
- pattern space is identical to user space, but the relationship
755
- between the spaces can be changed with <a class="link" href="cairo-pattern.html#cairo-pattern-set-matrix" title="cairo_pattern_set_matrix ()"><code class="function">cairo_pattern_set_matrix()</code></a>.</p>
756
- <p>
757
- </p>
758
- <div class="variablelist"><table border="0">
759
- <col align="left" valign="top">
760
- <tbody>
761
- <tr>
762
- <td><p><span class="term"><em class="parameter"><code>cx0</code></em> :</span></p></td>
763
- <td> x coordinate for the center of the start circle
764
- </td>
765
- </tr>
766
- <tr>
767
- <td><p><span class="term"><em class="parameter"><code>cy0</code></em> :</span></p></td>
768
- <td> y coordinate for the center of the start circle
769
- </td>
770
- </tr>
771
- <tr>
772
- <td><p><span class="term"><em class="parameter"><code>radius0</code></em> :</span></p></td>
773
- <td> radius of the start circle
774
- </td>
775
- </tr>
776
- <tr>
777
- <td><p><span class="term"><em class="parameter"><code>cx1</code></em> :</span></p></td>
778
- <td> x coordinate for the center of the end circle
779
- </td>
780
- </tr>
781
- <tr>
782
- <td><p><span class="term"><em class="parameter"><code>cy1</code></em> :</span></p></td>
783
- <td> y coordinate for the center of the end circle
784
- </td>
785
- </tr>
786
- <tr>
787
- <td><p><span class="term"><em class="parameter"><code>radius1</code></em> :</span></p></td>
788
- <td> radius of the end circle
789
- </td>
790
- </tr>
791
- <tr>
792
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
793
- <td> the newly created <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> if successful, or
794
- an error pattern in case of no memory. The caller owns the
795
- returned object and should call <a class="link" href="cairo-pattern.html#cairo-pattern-destroy" title="cairo_pattern_destroy ()"><code class="function">cairo_pattern_destroy()</code></a> when
796
- finished with it.
797
-
798
- This function will always return a valid pointer, but if an error
799
- occurred the pattern status will be set to an error. To inspect
800
- the status of a pattern use <a class="link" href="cairo-pattern.html#cairo-pattern-status" title="cairo_pattern_status ()"><code class="function">cairo_pattern_status()</code></a>.
801
- </td>
802
- </tr>
803
- </tbody>
804
- </table></div>
805
- </div>
806
- <hr>
807
- <div class="refsect2" title="cairo_pattern_get_radial_circles ()">
808
- <a name="cairo-pattern-get-radial-circles"></a><h3>cairo_pattern_get_radial_circles ()</h3>
809
- <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_pattern_get_radial_circles (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
810
- double *x0,
811
- double *y0,
812
- double *r0,
813
- double *x1,
814
- double *y1,
815
- double *r1);</pre>
816
- <p>
817
- Gets the gradient endpoint circles for a radial gradient, each
818
- specified as a center coordinate and a radius.</p>
819
- <p>
820
- </p>
821
- <div class="variablelist"><table border="0">
822
- <col align="left" valign="top">
823
- <tbody>
824
- <tr>
825
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
826
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
827
- </td>
828
- </tr>
829
- <tr>
830
- <td><p><span class="term"><em class="parameter"><code>x0</code></em> :</span></p></td>
831
- <td> return value for the x coordinate of the center of the first circle, or <code class="literal">NULL</code>
832
- </td>
833
- </tr>
834
- <tr>
835
- <td><p><span class="term"><em class="parameter"><code>y0</code></em> :</span></p></td>
836
- <td> return value for the y coordinate of the center of the first circle, or <code class="literal">NULL</code>
837
- </td>
838
- </tr>
839
- <tr>
840
- <td><p><span class="term"><em class="parameter"><code>r0</code></em> :</span></p></td>
841
- <td> return value for the radius of the first circle, or <code class="literal">NULL</code>
842
- </td>
843
- </tr>
844
- <tr>
845
- <td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
846
- <td> return value for the x coordinate of the center of the second circle, or <code class="literal">NULL</code>
847
- </td>
848
- </tr>
849
- <tr>
850
- <td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
851
- <td> return value for the y coordinate of the center of the second circle, or <code class="literal">NULL</code>
852
- </td>
853
- </tr>
854
- <tr>
855
- <td><p><span class="term"><em class="parameter"><code>r1</code></em> :</span></p></td>
856
- <td> return value for the radius of the second circle, or <code class="literal">NULL</code>
857
- </td>
858
- </tr>
859
- <tr>
860
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
861
- <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>, or
862
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-PATTERN-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</code></a> if <em class="parameter"><code>pattern</code></em> is not a radial
863
- gradient pattern.
864
-
865
- </td>
866
- </tr>
867
- </tbody>
868
- </table></div>
869
- <p class="since">Since 1.4</p>
870
- </div>
871
- <hr>
872
- <div class="refsect2" title="cairo_pattern_reference ()">
873
- <a name="cairo-pattern-reference"></a><h3>cairo_pattern_reference ()</h3>
874
- <pre class="programlisting"><a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> * cairo_pattern_reference (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);</pre>
875
- <p>
876
- Increases the reference count on <em class="parameter"><code>pattern</code></em> by one. This prevents
877
- <em class="parameter"><code>pattern</code></em> from being destroyed until a matching call to
878
- <a class="link" href="cairo-pattern.html#cairo-pattern-destroy" title="cairo_pattern_destroy ()"><code class="function">cairo_pattern_destroy()</code></a> is made.
879
- </p>
880
- <p>
881
- The number of references to a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> can be get using
882
- <a class="link" href="cairo-pattern.html#cairo-pattern-get-reference-count" title="cairo_pattern_get_reference_count ()"><code class="function">cairo_pattern_get_reference_count()</code></a>.</p>
883
- <p>
884
- </p>
885
- <div class="variablelist"><table border="0">
886
- <col align="left" valign="top">
887
- <tbody>
888
- <tr>
889
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
890
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
891
- </td>
892
- </tr>
893
- <tr>
894
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
895
- <td> the referenced <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>.
896
- </td>
897
- </tr>
898
- </tbody>
899
- </table></div>
900
- </div>
901
- <hr>
902
- <div class="refsect2" title="cairo_pattern_destroy ()">
903
- <a name="cairo-pattern-destroy"></a><h3>cairo_pattern_destroy ()</h3>
904
- <pre class="programlisting">void cairo_pattern_destroy (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);</pre>
905
- <p>
906
- Decreases the reference count on <em class="parameter"><code>pattern</code></em> by one. If the result is
907
- zero, then <em class="parameter"><code>pattern</code></em> and all associated resources are freed. See
908
- <a class="link" href="cairo-pattern.html#cairo-pattern-reference" title="cairo_pattern_reference ()"><code class="function">cairo_pattern_reference()</code></a>.</p>
909
- <p>
910
- </p>
911
- <div class="variablelist"><table border="0">
912
- <col align="left" valign="top">
913
- <tbody><tr>
914
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
915
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
916
- </td>
917
- </tr></tbody>
918
- </table></div>
919
- </div>
920
- <hr>
921
- <div class="refsect2" title="cairo_pattern_status ()">
922
- <a name="cairo-pattern-status"></a><h3>cairo_pattern_status ()</h3>
923
- <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_pattern_status (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);</pre>
924
- <p>
925
- Checks whether an error has previously occurred for this
926
- pattern.</p>
927
- <p>
928
- </p>
929
- <div class="variablelist"><table border="0">
930
- <col align="left" valign="top">
931
- <tbody>
932
- <tr>
933
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
934
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
935
- </td>
936
- </tr>
937
- <tr>
938
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
939
- <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a>, <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>, or
940
- <a class="link" href="cairo-error-status.html#CAIRO-STATUS-PATTERN-TYPE-MISMATCH--CAPS"><code class="literal">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</code></a>.
941
- </td>
942
- </tr>
943
- </tbody>
944
- </table></div>
945
- </div>
946
- <hr>
947
- <div class="refsect2" title="enum cairo_extend_t">
948
- <a name="cairo-extend-t"></a><h3>enum cairo_extend_t</h3>
949
- <pre class="programlisting">typedef enum _cairo_extend {
950
- CAIRO_EXTEND_NONE,
951
- CAIRO_EXTEND_REPEAT,
952
- CAIRO_EXTEND_REFLECT,
953
- CAIRO_EXTEND_PAD
954
- } cairo_extend_t;
955
- </pre>
956
- <p>
957
- <a class="link" href="cairo-pattern.html#cairo-extend-t" title="enum cairo_extend_t"><span class="type">cairo_extend_t</span></a> is used to describe how pattern color/alpha will be
958
- determined for areas "outside" the pattern's natural area, (for
959
- example, outside the surface bounds or outside the gradient
960
- geometry).
961
- </p>
962
- <p>
963
- The default extend mode is <a class="link" href="cairo-pattern.html#CAIRO-EXTEND-NONE--CAPS"><code class="literal">CAIRO_EXTEND_NONE</code></a> for surface patterns
964
- and <a class="link" href="cairo-pattern.html#CAIRO-EXTEND-PAD--CAPS"><code class="literal">CAIRO_EXTEND_PAD</code></a> for gradient patterns.
965
- </p>
966
- <p>
967
- New entries may be added in future versions.</p>
968
- <p>
969
- </p>
970
- <div class="variablelist"><table border="0">
971
- <col align="left" valign="top">
972
- <tbody>
973
- <tr>
974
- <td><p><a name="CAIRO-EXTEND-NONE--CAPS"></a><span class="term"><code class="literal">CAIRO_EXTEND_NONE</code></span></p></td>
975
- <td> pixels outside of the source pattern
976
- are fully transparent
977
- </td>
978
- </tr>
979
- <tr>
980
- <td><p><a name="CAIRO-EXTEND-REPEAT--CAPS"></a><span class="term"><code class="literal">CAIRO_EXTEND_REPEAT</code></span></p></td>
981
- <td> the pattern is tiled by repeating
982
- </td>
983
- </tr>
984
- <tr>
985
- <td><p><a name="CAIRO-EXTEND-REFLECT--CAPS"></a><span class="term"><code class="literal">CAIRO_EXTEND_REFLECT</code></span></p></td>
986
- <td> the pattern is tiled by reflecting
987
- at the edges (Implemented for surface patterns since 1.6)
988
- </td>
989
- </tr>
990
- <tr>
991
- <td><p><a name="CAIRO-EXTEND-PAD--CAPS"></a><span class="term"><code class="literal">CAIRO_EXTEND_PAD</code></span></p></td>
992
- <td> pixels outside of the pattern copy
993
- the closest pixel from the source (Since 1.2; but only
994
- implemented for surface patterns since 1.6)
995
- </td>
996
- </tr>
997
- </tbody>
998
- </table></div>
999
- </div>
1000
- <hr>
1001
- <div class="refsect2" title="cairo_pattern_set_extend ()">
1002
- <a name="cairo-pattern-set-extend"></a><h3>cairo_pattern_set_extend ()</h3>
1003
- <pre class="programlisting">void cairo_pattern_set_extend (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
1004
- <a class="link" href="cairo-pattern.html#cairo-extend-t" title="enum cairo_extend_t">cairo_extend_t</a> extend);</pre>
1005
- <p>
1006
- Sets the mode to be used for drawing outside the area of a pattern.
1007
- See <a class="link" href="cairo-pattern.html#cairo-extend-t" title="enum cairo_extend_t"><span class="type">cairo_extend_t</span></a> for details on the semantics of each extend
1008
- strategy.
1009
- </p>
1010
- <p>
1011
- The default extend mode is <a class="link" href="cairo-pattern.html#CAIRO-EXTEND-NONE--CAPS"><code class="literal">CAIRO_EXTEND_NONE</code></a> for surface patterns
1012
- and <a class="link" href="cairo-pattern.html#CAIRO-EXTEND-PAD--CAPS"><code class="literal">CAIRO_EXTEND_PAD</code></a> for gradient patterns.</p>
1013
- <p>
1014
- </p>
1015
- <div class="variablelist"><table border="0">
1016
- <col align="left" valign="top">
1017
- <tbody>
1018
- <tr>
1019
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1020
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1021
- </td>
1022
- </tr>
1023
- <tr>
1024
- <td><p><span class="term"><em class="parameter"><code>extend</code></em> :</span></p></td>
1025
- <td> a <a class="link" href="cairo-pattern.html#cairo-extend-t" title="enum cairo_extend_t"><span class="type">cairo_extend_t</span></a> describing how the area outside of the
1026
- pattern will be drawn
1027
- </td>
1028
- </tr>
1029
- </tbody>
1030
- </table></div>
1031
- </div>
1032
- <hr>
1033
- <div class="refsect2" title="cairo_pattern_get_extend ()">
1034
- <a name="cairo-pattern-get-extend"></a><h3>cairo_pattern_get_extend ()</h3>
1035
- <pre class="programlisting"><a class="link" href="cairo-pattern.html#cairo-extend-t" title="enum cairo_extend_t">cairo_extend_t</a> cairo_pattern_get_extend (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);</pre>
1036
- <p>
1037
- Gets the current extend mode for a pattern. See <a class="link" href="cairo-pattern.html#cairo-extend-t" title="enum cairo_extend_t"><span class="type">cairo_extend_t</span></a>
1038
- for details on the semantics of each extend strategy.</p>
1039
- <p>
1040
- </p>
1041
- <div class="variablelist"><table border="0">
1042
- <col align="left" valign="top">
1043
- <tbody>
1044
- <tr>
1045
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1046
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1047
- </td>
1048
- </tr>
1049
- <tr>
1050
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1051
- <td> the current extend strategy used for drawing the
1052
- pattern.
1053
- </td>
1054
- </tr>
1055
- </tbody>
1056
- </table></div>
1057
- </div>
1058
- <hr>
1059
- <div class="refsect2" title="enum cairo_filter_t">
1060
- <a name="cairo-filter-t"></a><h3>enum cairo_filter_t</h3>
1061
- <pre class="programlisting">typedef enum _cairo_filter {
1062
- CAIRO_FILTER_FAST,
1063
- CAIRO_FILTER_GOOD,
1064
- CAIRO_FILTER_BEST,
1065
- CAIRO_FILTER_NEAREST,
1066
- CAIRO_FILTER_BILINEAR,
1067
- CAIRO_FILTER_GAUSSIAN
1068
- } cairo_filter_t;
1069
- </pre>
1070
- <p>
1071
- <a class="link" href="cairo-pattern.html#cairo-filter-t" title="enum cairo_filter_t"><span class="type">cairo_filter_t</span></a> is used to indicate what filtering should be
1072
- applied when reading pixel values from patterns. See
1073
- <code class="function">cairo_pattern_set_source()</code> for indicating the desired filter to be
1074
- used with a particular pattern.</p>
1075
- <p>
1076
- </p>
1077
- <div class="variablelist"><table border="0">
1078
- <col align="left" valign="top">
1079
- <tbody>
1080
- <tr>
1081
- <td><p><a name="CAIRO-FILTER-FAST--CAPS"></a><span class="term"><code class="literal">CAIRO_FILTER_FAST</code></span></p></td>
1082
- <td> A high-performance filter, with quality similar
1083
- to <a class="link" href="cairo-pattern.html#CAIRO-FILTER-NEAREST--CAPS"><code class="literal">CAIRO_FILTER_NEAREST</code></a>
1084
- </td>
1085
- </tr>
1086
- <tr>
1087
- <td><p><a name="CAIRO-FILTER-GOOD--CAPS"></a><span class="term"><code class="literal">CAIRO_FILTER_GOOD</code></span></p></td>
1088
- <td> A reasonable-performance filter, with quality
1089
- similar to <a class="link" href="cairo-pattern.html#CAIRO-FILTER-BILINEAR--CAPS"><code class="literal">CAIRO_FILTER_BILINEAR</code></a>
1090
- </td>
1091
- </tr>
1092
- <tr>
1093
- <td><p><a name="CAIRO-FILTER-BEST--CAPS"></a><span class="term"><code class="literal">CAIRO_FILTER_BEST</code></span></p></td>
1094
- <td> The highest-quality available, performance may
1095
- not be suitable for interactive use.
1096
- </td>
1097
- </tr>
1098
- <tr>
1099
- <td><p><a name="CAIRO-FILTER-NEAREST--CAPS"></a><span class="term"><code class="literal">CAIRO_FILTER_NEAREST</code></span></p></td>
1100
- <td> Nearest-neighbor filtering
1101
- </td>
1102
- </tr>
1103
- <tr>
1104
- <td><p><a name="CAIRO-FILTER-BILINEAR--CAPS"></a><span class="term"><code class="literal">CAIRO_FILTER_BILINEAR</code></span></p></td>
1105
- <td> Linear interpolation in two dimensions
1106
- </td>
1107
- </tr>
1108
- <tr>
1109
- <td><p><a name="CAIRO-FILTER-GAUSSIAN--CAPS"></a><span class="term"><code class="literal">CAIRO_FILTER_GAUSSIAN</code></span></p></td>
1110
- <td> This filter value is currently
1111
- unimplemented, and should not be used in current code.
1112
- </td>
1113
- </tr>
1114
- </tbody>
1115
- </table></div>
1116
- </div>
1117
- <hr>
1118
- <div class="refsect2" title="cairo_pattern_set_filter ()">
1119
- <a name="cairo-pattern-set-filter"></a><h3>cairo_pattern_set_filter ()</h3>
1120
- <pre class="programlisting">void cairo_pattern_set_filter (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
1121
- <a class="link" href="cairo-pattern.html#cairo-filter-t" title="enum cairo_filter_t">cairo_filter_t</a> filter);</pre>
1122
- <p>
1123
- Sets the filter to be used for resizing when using this pattern.
1124
- See <a class="link" href="cairo-pattern.html#cairo-filter-t" title="enum cairo_filter_t"><span class="type">cairo_filter_t</span></a> for details on each filter.
1125
- </p>
1126
- <p>
1127
- * Note that you might want to control filtering even when you do not
1128
- have an explicit <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> object, (for example when using
1129
- <a class="link" href="cairo-context.html#cairo-set-source-surface" title="cairo_set_source_surface ()"><code class="function">cairo_set_source_surface()</code></a>). In these cases, it is convenient to
1130
- use <a class="link" href="cairo-context.html#cairo-get-source" title="cairo_get_source ()"><code class="function">cairo_get_source()</code></a> to get access to the pattern that cairo
1131
- creates implicitly. For example:
1132
- </p>
1133
- <p>
1134
- </p>
1135
- <div class="informalexample"><pre class="programlisting">
1136
- cairo_set_source_surface (cr, image, x, y);
1137
- cairo_pattern_set_filter (cairo_get_source (cr), CAIRO_FILTER_NEAREST);
1138
- </pre></div>
1139
- <p>
1140
- </p>
1141
- <div class="variablelist"><table border="0">
1142
- <col align="left" valign="top">
1143
- <tbody>
1144
- <tr>
1145
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1146
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1147
- </td>
1148
- </tr>
1149
- <tr>
1150
- <td><p><span class="term"><em class="parameter"><code>filter</code></em> :</span></p></td>
1151
- <td> a <a class="link" href="cairo-pattern.html#cairo-filter-t" title="enum cairo_filter_t"><span class="type">cairo_filter_t</span></a> describing the filter to use for resizing
1152
- the pattern
1153
- </td>
1154
- </tr>
1155
- </tbody>
1156
- </table></div>
1157
- </div>
1158
- <hr>
1159
- <div class="refsect2" title="cairo_pattern_get_filter ()">
1160
- <a name="cairo-pattern-get-filter"></a><h3>cairo_pattern_get_filter ()</h3>
1161
- <pre class="programlisting"><a class="link" href="cairo-pattern.html#cairo-filter-t" title="enum cairo_filter_t">cairo_filter_t</a> cairo_pattern_get_filter (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);</pre>
1162
- <p>
1163
- Gets the current filter for a pattern. See <a class="link" href="cairo-pattern.html#cairo-filter-t" title="enum cairo_filter_t"><span class="type">cairo_filter_t</span></a>
1164
- for details on each filter.</p>
1165
- <p>
1166
- </p>
1167
- <div class="variablelist"><table border="0">
1168
- <col align="left" valign="top">
1169
- <tbody>
1170
- <tr>
1171
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1172
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1173
- </td>
1174
- </tr>
1175
- <tr>
1176
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1177
- <td> the current filter used for resizing the pattern.
1178
- </td>
1179
- </tr>
1180
- </tbody>
1181
- </table></div>
1182
- </div>
1183
- <hr>
1184
- <div class="refsect2" title="cairo_pattern_set_matrix ()">
1185
- <a name="cairo-pattern-set-matrix"></a><h3>cairo_pattern_set_matrix ()</h3>
1186
- <pre class="programlisting">void cairo_pattern_set_matrix (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
1187
- const <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *matrix);</pre>
1188
- <p>
1189
- Sets the pattern's transformation matrix to <em class="parameter"><code>matrix</code></em>. This matrix is
1190
- a transformation from user space to pattern space.
1191
- </p>
1192
- <p>
1193
- When a pattern is first created it always has the identity matrix
1194
- for its transformation matrix, which means that pattern space is
1195
- initially identical to user space.
1196
- </p>
1197
- <p>
1198
- Important: Please note that the direction of this transformation
1199
- matrix is from user space to pattern space. This means that if you
1200
- imagine the flow from a pattern to user space (and on to device
1201
- space), then coordinates in that flow will be transformed by the
1202
- inverse of the pattern matrix.
1203
- </p>
1204
- <p>
1205
- For example, if you want to make a pattern appear twice as large as
1206
- it does by default the correct code to use is:
1207
- </p>
1208
- <p>
1209
- </p>
1210
- <div class="informalexample"><pre class="programlisting">
1211
- cairo_matrix_init_scale (&amp;matrix, 0.5, 0.5);
1212
- cairo_pattern_set_matrix (pattern, &amp;matrix);
1213
- </pre></div>
1214
- <p>
1215
- </p>
1216
- <p>
1217
- Meanwhile, using values of 2.0 rather than 0.5 in the code above
1218
- would cause the pattern to appear at half of its default size.
1219
- </p>
1220
- <p>
1221
- Also, please note the discussion of the user-space locking
1222
- semantics of <a class="link" href="cairo-context.html#cairo-set-source" title="cairo_set_source ()"><code class="function">cairo_set_source()</code></a>.</p>
1223
- <p>
1224
- </p>
1225
- <div class="variablelist"><table border="0">
1226
- <col align="left" valign="top">
1227
- <tbody>
1228
- <tr>
1229
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1230
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1231
- </td>
1232
- </tr>
1233
- <tr>
1234
- <td><p><span class="term"><em class="parameter"><code>matrix</code></em> :</span></p></td>
1235
- <td> a <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t"><span class="type">cairo_matrix_t</span></a>
1236
- </td>
1237
- </tr>
1238
- </tbody>
1239
- </table></div>
1240
- </div>
1241
- <hr>
1242
- <div class="refsect2" title="cairo_pattern_get_matrix ()">
1243
- <a name="cairo-pattern-get-matrix"></a><h3>cairo_pattern_get_matrix ()</h3>
1244
- <pre class="programlisting">void cairo_pattern_get_matrix (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
1245
- <a class="link" href="cairo-matrix.html#cairo-matrix-t" title="cairo_matrix_t">cairo_matrix_t</a> *matrix);</pre>
1246
- <p>
1247
- Stores the pattern's transformation matrix into <em class="parameter"><code>matrix</code></em>.</p>
1248
- <p>
1249
- </p>
1250
- <div class="variablelist"><table border="0">
1251
- <col align="left" valign="top">
1252
- <tbody>
1253
- <tr>
1254
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1255
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1256
- </td>
1257
- </tr>
1258
- <tr>
1259
- <td><p><span class="term"><em class="parameter"><code>matrix</code></em> :</span></p></td>
1260
- <td> return value for the matrix
1261
- </td>
1262
- </tr>
1263
- </tbody>
1264
- </table></div>
1265
- </div>
1266
- <hr>
1267
- <div class="refsect2" title="enum cairo_pattern_type_t">
1268
- <a name="cairo-pattern-type-t"></a><h3>enum cairo_pattern_type_t</h3>
1269
- <pre class="programlisting">typedef enum _cairo_pattern_type {
1270
- CAIRO_PATTERN_TYPE_SOLID,
1271
- CAIRO_PATTERN_TYPE_SURFACE,
1272
- CAIRO_PATTERN_TYPE_LINEAR,
1273
- CAIRO_PATTERN_TYPE_RADIAL
1274
- } cairo_pattern_type_t;
1275
- </pre>
1276
- <p>
1277
- <a class="link" href="cairo-pattern.html#cairo-pattern-type-t" title="enum cairo_pattern_type_t"><span class="type">cairo_pattern_type_t</span></a> is used to describe the type of a given pattern.
1278
- </p>
1279
- <p>
1280
- The type of a pattern is determined by the function used to create
1281
- it. The <a class="link" href="cairo-pattern.html#cairo-pattern-create-rgb" title="cairo_pattern_create_rgb ()"><code class="function">cairo_pattern_create_rgb()</code></a> and <a class="link" href="cairo-pattern.html#cairo-pattern-create-rgba" title="cairo_pattern_create_rgba ()"><code class="function">cairo_pattern_create_rgba()</code></a>
1282
- functions create SOLID patterns. The remaining
1283
- cairo_pattern_create functions map to pattern types in obvious
1284
- ways.
1285
- </p>
1286
- <p>
1287
- The pattern type can be queried with <a class="link" href="cairo-pattern.html#cairo-pattern-get-type" title="cairo_pattern_get_type ()"><code class="function">cairo_pattern_get_type()</code></a>
1288
- </p>
1289
- <p>
1290
- Most <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> functions can be called with a pattern of any
1291
- type, (though trying to change the extend or filter for a solid
1292
- pattern will have no effect). A notable exception is
1293
- <a class="link" href="cairo-pattern.html#cairo-pattern-add-color-stop-rgb" title="cairo_pattern_add_color_stop_rgb ()"><code class="function">cairo_pattern_add_color_stop_rgb()</code></a> and
1294
- <a class="link" href="cairo-pattern.html#cairo-pattern-add-color-stop-rgba" title="cairo_pattern_add_color_stop_rgba ()"><code class="function">cairo_pattern_add_color_stop_rgba()</code></a> which must only be called with
1295
- gradient patterns (either LINEAR or RADIAL). Otherwise the pattern
1296
- will be shutdown and put into an error state.
1297
- </p>
1298
- <p>
1299
- New entries may be added in future versions.</p>
1300
- <p>
1301
- </p>
1302
- <div class="variablelist"><table border="0">
1303
- <col align="left" valign="top">
1304
- <tbody>
1305
- <tr>
1306
- <td><p><a name="CAIRO-PATTERN-TYPE-SOLID--CAPS"></a><span class="term"><code class="literal">CAIRO_PATTERN_TYPE_SOLID</code></span></p></td>
1307
- <td> The pattern is a solid (uniform)
1308
- color. It may be opaque or translucent.
1309
- </td>
1310
- </tr>
1311
- <tr>
1312
- <td><p><a name="CAIRO-PATTERN-TYPE-SURFACE--CAPS"></a><span class="term"><code class="literal">CAIRO_PATTERN_TYPE_SURFACE</code></span></p></td>
1313
- <td> The pattern is a based on a surface (an image).
1314
- </td>
1315
- </tr>
1316
- <tr>
1317
- <td><p><a name="CAIRO-PATTERN-TYPE-LINEAR--CAPS"></a><span class="term"><code class="literal">CAIRO_PATTERN_TYPE_LINEAR</code></span></p></td>
1318
- <td> The pattern is a linear gradient.
1319
- </td>
1320
- </tr>
1321
- <tr>
1322
- <td><p><a name="CAIRO-PATTERN-TYPE-RADIAL--CAPS"></a><span class="term"><code class="literal">CAIRO_PATTERN_TYPE_RADIAL</code></span></p></td>
1323
- <td> The pattern is a radial gradient.
1324
- </td>
1325
- </tr>
1326
- </tbody>
1327
- </table></div>
1328
- <p class="since">Since 1.2</p>
1329
- </div>
1330
- <hr>
1331
- <div class="refsect2" title="cairo_pattern_get_type ()">
1332
- <a name="cairo-pattern-get-type"></a><h3>cairo_pattern_get_type ()</h3>
1333
- <pre class="programlisting"><a class="link" href="cairo-pattern.html#cairo-pattern-type-t" title="enum cairo_pattern_type_t">cairo_pattern_type_t</a> cairo_pattern_get_type (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);</pre>
1334
- <p>
1335
- This function returns the type a pattern.
1336
- See <a class="link" href="cairo-pattern.html#cairo-pattern-type-t" title="enum cairo_pattern_type_t"><span class="type">cairo_pattern_type_t</span></a> for available types.</p>
1337
- <p>
1338
- </p>
1339
- <div class="variablelist"><table border="0">
1340
- <col align="left" valign="top">
1341
- <tbody>
1342
- <tr>
1343
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1344
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1345
- </td>
1346
- </tr>
1347
- <tr>
1348
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1349
- <td> The type of <em class="parameter"><code>pattern</code></em>.
1350
-
1351
- </td>
1352
- </tr>
1353
- </tbody>
1354
- </table></div>
1355
- <p class="since">Since 1.2</p>
1356
- </div>
1357
- <hr>
1358
- <div class="refsect2" title="cairo_pattern_get_reference_count ()">
1359
- <a name="cairo-pattern-get-reference-count"></a><h3>cairo_pattern_get_reference_count ()</h3>
1360
- <pre class="programlisting">unsigned int cairo_pattern_get_reference_count (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern);</pre>
1361
- <p>
1362
- Returns the current reference count of <em class="parameter"><code>pattern</code></em>.</p>
1363
- <p>
1364
- </p>
1365
- <div class="variablelist"><table border="0">
1366
- <col align="left" valign="top">
1367
- <tbody>
1368
- <tr>
1369
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1370
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1371
- </td>
1372
- </tr>
1373
- <tr>
1374
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1375
- <td> the current reference count of <em class="parameter"><code>pattern</code></em>. If the
1376
- object is a nil object, 0 will be returned.
1377
-
1378
- </td>
1379
- </tr>
1380
- </tbody>
1381
- </table></div>
1382
- <p class="since">Since 1.4</p>
1383
- </div>
1384
- <hr>
1385
- <div class="refsect2" title="cairo_pattern_set_user_data ()">
1386
- <a name="cairo-pattern-set-user-data"></a><h3>cairo_pattern_set_user_data ()</h3>
1387
- <pre class="programlisting"><a class="link" href="cairo-error-status.html#cairo-status-t" title="enum cairo_status_t">cairo_status_t</a> cairo_pattern_set_user_data (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
1388
- const <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a> *key,
1389
- void *user_data,
1390
- <a class="link" href="cairo-types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()">cairo_destroy_func_t</a> destroy);</pre>
1391
- <p>
1392
- Attach user data to <em class="parameter"><code>pattern</code></em>. To remove user data from a surface,
1393
- call this function with the key that was used to set it and <code class="literal">NULL</code>
1394
- for <em class="parameter"><code>data</code></em>.</p>
1395
- <p>
1396
- </p>
1397
- <div class="variablelist"><table border="0">
1398
- <col align="left" valign="top">
1399
- <tbody>
1400
- <tr>
1401
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1402
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1403
- </td>
1404
- </tr>
1405
- <tr>
1406
- <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1407
- <td> the address of a <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> to attach the user data to
1408
- </td>
1409
- </tr>
1410
- <tr>
1411
- <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1412
- <td> the user data to attach to the <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1413
- </td>
1414
- </tr>
1415
- <tr>
1416
- <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1417
- <td> a <a class="link" href="cairo-types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> which will be called when the
1418
- <a class="link" href="cairo-context.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> is destroyed or when new user data is attached using the
1419
- same key.
1420
- </td>
1421
- </tr>
1422
- <tr>
1423
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1424
- <td> <a class="link" href="cairo-error-status.html#CAIRO-STATUS-SUCCESS--CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a> if a
1425
- slot could not be allocated for the user data.
1426
-
1427
- </td>
1428
- </tr>
1429
- </tbody>
1430
- </table></div>
1431
- <p class="since">Since 1.4</p>
1432
- </div>
1433
- <hr>
1434
- <div class="refsect2" title="cairo_pattern_get_user_data ()">
1435
- <a name="cairo-pattern-get-user-data"></a><h3>cairo_pattern_get_user_data ()</h3>
1436
- <pre class="programlisting">void * cairo_pattern_get_user_data (<a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t">cairo_pattern_t</a> *pattern,
1437
- const <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t">cairo_user_data_key_t</a> *key);</pre>
1438
- <p>
1439
- Return user data previously attached to <em class="parameter"><code>pattern</code></em> using the
1440
- specified key. If no user data has been attached with the given
1441
- key this function returns <code class="literal">NULL</code>.</p>
1442
- <p>
1443
- </p>
1444
- <div class="variablelist"><table border="0">
1445
- <col align="left" valign="top">
1446
- <tbody>
1447
- <tr>
1448
- <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1449
- <td> a <a class="link" href="cairo-pattern.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
1450
- </td>
1451
- </tr>
1452
- <tr>
1453
- <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1454
- <td> the address of the <a class="link" href="cairo-types.html#cairo-user-data-key-t" title="cairo_user_data_key_t"><span class="type">cairo_user_data_key_t</span></a> the user data was
1455
- attached to
1456
- </td>
1457
- </tr>
1458
- <tr>
1459
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1460
- <td> the user data previously attached or <code class="literal">NULL</code>.
1461
-
1462
- </td>
1463
- </tr>
1464
- </tbody>
1465
- </table></div>
1466
- <p class="since">Since 1.4</p>
1467
- </div>
1468
- </div>
1469
- <div class="refsect1" title="See Also">
1470
- <a name="cairo-pattern.see-also"></a><h2>See Also</h2>
1471
- <p>
1472
- </p>
1473
- <div class="itemizedlist"><ul class="itemizedlist" type="disc">
1474
- <li class="listitem"><a class="link" href="cairo-context.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a></li>
1475
- <li class="listitem"><a class="link" href="cairo-surface.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></li>
1476
- </ul></div>
1477
- <p>
1478
- </p>
1479
- </div>
1480
- </div>
1481
- <div class="footer">
1482
- <hr>
1483
- Generated by GTK-Doc V1.11</div>
1484
- </body>
1485
- </html>