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

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.

This version of cairo might be problematic. Click here for more details.

Files changed (215) hide show
  1. checksums.yaml +4 -4
  2. data/NEWS +21 -0
  3. data/Rakefile +17 -6
  4. data/ext/cairo/cairo.def +1 -0
  5. data/ext/cairo/extconf.rb +23 -10
  6. data/ext/cairo/rb_cairo.c +3 -0
  7. data/ext/cairo/rb_cairo.h +3 -3
  8. data/ext/cairo/rb_cairo_context.c +1 -1
  9. data/ext/cairo/rb_cairo_io.c +4 -0
  10. data/ext/cairo/rb_cairo_io.h +2 -0
  11. data/ext/cairo/rb_cairo_pattern.c +4 -4
  12. data/ext/cairo/rb_cairo_private.h +2 -0
  13. data/ext/cairo/rb_cairo_surface.c +64 -232
  14. data/lib/2.0/cairo.so +0 -0
  15. data/lib/2.1/cairo.so +0 -0
  16. data/lib/2.2/cairo.so +0 -0
  17. data/lib/cairo.rb +20 -19
  18. data/lib/cairo/region.rb +14 -0
  19. data/test/test_region.rb +26 -0
  20. data/vendor/local/bin/fc-cache.exe +0 -0
  21. data/vendor/local/bin/fc-cat.exe +0 -0
  22. data/vendor/local/bin/fc-list.exe +0 -0
  23. data/vendor/local/bin/fc-match.exe +0 -0
  24. data/vendor/local/bin/fc-pattern.exe +0 -0
  25. data/vendor/local/bin/fc-query.exe +0 -0
  26. data/vendor/local/bin/fc-scan.exe +0 -0
  27. data/vendor/local/bin/fc-validate.exe +0 -0
  28. data/vendor/local/bin/freetype-config +2 -2
  29. data/vendor/local/bin/libcairo-2.dll +0 -0
  30. data/vendor/local/bin/libcairo-gobject-2.dll +0 -0
  31. data/vendor/local/bin/libcairo-script-interpreter-2.dll +0 -0
  32. data/vendor/local/bin/libfontconfig-1.dll +0 -0
  33. data/vendor/local/bin/libfreetype-6.dll +0 -0
  34. data/vendor/local/bin/libgcc_s_seh-1.dll +0 -0
  35. data/vendor/local/bin/libpixman-1-0.dll +0 -0
  36. data/vendor/local/bin/libpng-config +1 -1
  37. data/vendor/local/bin/libpng16-16.dll +0 -0
  38. data/vendor/local/bin/libpng16-config +1 -1
  39. data/vendor/local/bin/libstdc++-6.dll +0 -0
  40. data/vendor/local/bin/libwinpthread-1.dll +0 -0
  41. data/vendor/local/bin/libxml2-2.dll +0 -0
  42. data/vendor/local/bin/png-fix-itxt.exe +0 -0
  43. data/vendor/local/bin/pngfix.exe +0 -0
  44. data/vendor/local/bin/xmlcatalog.exe +0 -0
  45. data/vendor/local/bin/xmllint.exe +0 -0
  46. data/vendor/local/bin/zlib1.dll +0 -0
  47. data/vendor/local/include/cairo/cairo-version.h +1 -1
  48. data/vendor/local/include/freetype2/config/ftconfig.h +19 -2
  49. data/vendor/local/include/freetype2/config/ftheader.h +7 -5
  50. data/vendor/local/include/freetype2/config/ftoption.h +9 -22
  51. data/vendor/local/include/freetype2/config/ftstdlib.h +2 -3
  52. data/vendor/local/include/freetype2/freetype.h +38 -17
  53. data/vendor/local/include/freetype2/ft2build.h +1 -1
  54. data/vendor/local/include/freetype2/ftadvanc.h +2 -2
  55. data/vendor/local/include/freetype2/ftautoh.h +50 -2
  56. data/vendor/local/include/freetype2/ftbbox.h +1 -1
  57. data/vendor/local/include/freetype2/ftbdf.h +1 -1
  58. data/vendor/local/include/freetype2/ftbitmap.h +11 -3
  59. data/vendor/local/include/freetype2/ftbzip2.h +1 -1
  60. data/vendor/local/include/freetype2/ftcache.h +3 -3
  61. data/vendor/local/include/freetype2/ftcffdrv.h +1 -1
  62. data/vendor/local/include/freetype2/ftcid.h +2 -1
  63. data/vendor/local/include/freetype2/fterrdef.h +1 -1
  64. data/vendor/local/include/freetype2/fterrors.h +1 -1
  65. data/vendor/local/include/freetype2/{ftxf86.h → ftfntfmt.h} +22 -14
  66. data/vendor/local/include/freetype2/ftgasp.h +1 -1
  67. data/vendor/local/include/freetype2/ftglyph.h +1 -1
  68. data/vendor/local/include/freetype2/ftgxval.h +1 -1
  69. data/vendor/local/include/freetype2/ftgzip.h +1 -1
  70. data/vendor/local/include/freetype2/ftimage.h +7 -13
  71. data/vendor/local/include/freetype2/ftincrem.h +1 -1
  72. data/vendor/local/include/freetype2/ftlcdfil.h +2 -2
  73. data/vendor/local/include/freetype2/ftlist.h +1 -1
  74. data/vendor/local/include/freetype2/ftlzw.h +1 -1
  75. data/vendor/local/include/freetype2/ftmac.h +1 -1
  76. data/vendor/local/include/freetype2/ftmm.h +17 -11
  77. data/vendor/local/include/freetype2/ftmodapi.h +4 -2
  78. data/vendor/local/include/freetype2/ftmoderr.h +1 -1
  79. data/vendor/local/include/freetype2/ftotval.h +1 -1
  80. data/vendor/local/include/freetype2/ftoutln.h +1 -1
  81. data/vendor/local/include/freetype2/ftpfr.h +1 -1
  82. data/vendor/local/include/freetype2/ftrender.h +3 -8
  83. data/vendor/local/include/freetype2/ftsizes.h +1 -1
  84. data/vendor/local/include/freetype2/ftsnames.h +1 -1
  85. data/vendor/local/include/freetype2/ftstroke.h +1 -1
  86. data/vendor/local/include/freetype2/ftsynth.h +5 -3
  87. data/vendor/local/include/freetype2/ftsystem.h +10 -1
  88. data/vendor/local/include/freetype2/fttrigon.h +1 -1
  89. data/vendor/local/include/freetype2/ftttdrv.h +85 -22
  90. data/vendor/local/include/freetype2/fttypes.h +1 -1
  91. data/vendor/local/include/freetype2/ftwinfnt.h +3 -3
  92. data/vendor/local/include/freetype2/t1tables.h +4 -3
  93. data/vendor/local/include/freetype2/ttnameid.h +116 -116
  94. data/vendor/local/include/freetype2/tttables.h +2 -2
  95. data/vendor/local/include/freetype2/tttags.h +1 -1
  96. data/vendor/local/include/freetype2/ttunpat.h +1 -1
  97. data/vendor/local/include/libpng16/png.h +63 -80
  98. data/vendor/local/include/libpng16/pngconf.h +8 -30
  99. data/vendor/local/include/libpng16/pnglibconf.h +10 -4
  100. data/vendor/local/include/png.h +63 -80
  101. data/vendor/local/include/pngconf.h +8 -30
  102. data/vendor/local/include/pnglibconf.h +10 -4
  103. data/vendor/local/lib/libcairo-gobject.a +0 -0
  104. data/vendor/local/lib/libcairo-gobject.dll.a +0 -0
  105. data/vendor/local/lib/libcairo-gobject.la +2 -2
  106. data/vendor/local/lib/libcairo-script-interpreter.a +0 -0
  107. data/vendor/local/lib/libcairo-script-interpreter.dll.a +0 -0
  108. data/vendor/local/lib/libcairo-script-interpreter.la +2 -2
  109. data/vendor/local/lib/libcairo.a +0 -0
  110. data/vendor/local/lib/libcairo.dll.a +0 -0
  111. data/vendor/local/lib/libcairo.la +2 -2
  112. data/vendor/local/lib/libfontconfig.dll.a +0 -0
  113. data/vendor/local/lib/libfreetype.a +0 -0
  114. data/vendor/local/lib/libfreetype.dll.a +0 -0
  115. data/vendor/local/lib/libfreetype.la +4 -4
  116. data/vendor/local/lib/libpixman-1.a +0 -0
  117. data/vendor/local/lib/libpixman-1.dll.a +0 -0
  118. data/vendor/local/lib/libpng.a +0 -0
  119. data/vendor/local/lib/libpng.dll.a +0 -0
  120. data/vendor/local/lib/libpng.la +4 -4
  121. data/vendor/local/lib/libpng16.a +0 -0
  122. data/vendor/local/lib/libpng16.dll.a +0 -0
  123. data/vendor/local/lib/libpng16.la +4 -4
  124. data/vendor/local/lib/libxml2.a +0 -0
  125. data/vendor/local/lib/libxml2.dll.a +0 -0
  126. data/vendor/local/lib/libz.a +0 -0
  127. data/vendor/local/lib/libz.dll.a +0 -0
  128. data/vendor/local/lib/pkgconfig/cairo-fc.pc +1 -1
  129. data/vendor/local/lib/pkgconfig/cairo-ft.pc +1 -1
  130. data/vendor/local/lib/pkgconfig/cairo-gobject.pc +1 -1
  131. data/vendor/local/lib/pkgconfig/cairo-pdf.pc +1 -1
  132. data/vendor/local/lib/pkgconfig/cairo-png.pc +1 -1
  133. data/vendor/local/lib/pkgconfig/cairo-ps.pc +1 -1
  134. data/vendor/local/lib/pkgconfig/cairo-script.pc +1 -1
  135. data/vendor/local/lib/pkgconfig/cairo-svg.pc +1 -1
  136. data/vendor/local/lib/pkgconfig/cairo-win32-font.pc +1 -1
  137. data/vendor/local/lib/pkgconfig/cairo-win32.pc +1 -1
  138. data/vendor/local/lib/pkgconfig/cairo.pc +1 -1
  139. data/vendor/local/lib/pkgconfig/freetype2.pc +1 -1
  140. data/vendor/local/lib/pkgconfig/libpng.pc +1 -1
  141. data/vendor/local/lib/pkgconfig/libpng16.pc +1 -1
  142. data/vendor/local/share/aclocal/freetype2.m4 +1 -1
  143. data/vendor/local/share/gtk-doc/html/cairo/bindings-errors.html +12 -12
  144. data/vendor/local/share/gtk-doc/html/cairo/bindings-fonts.html +12 -12
  145. data/vendor/local/share/gtk-doc/html/cairo/bindings-memory.html +12 -12
  146. data/vendor/local/share/gtk-doc/html/cairo/bindings-overloading.html +13 -13
  147. data/vendor/local/share/gtk-doc/html/cairo/bindings-path.html +12 -12
  148. data/vendor/local/share/gtk-doc/html/cairo/bindings-patterns.html +35 -35
  149. data/vendor/local/share/gtk-doc/html/cairo/bindings-return-values.html +10 -10
  150. data/vendor/local/share/gtk-doc/html/cairo/bindings-streams.html +11 -11
  151. data/vendor/local/share/gtk-doc/html/cairo/bindings-surfaces.html +13 -13
  152. data/vendor/local/share/gtk-doc/html/cairo/cairo-Error-handling.html +294 -225
  153. data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +387 -269
  154. data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +432 -302
  155. data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html +325 -217
  156. data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html +298 -193
  157. data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html +1121 -812
  158. data/vendor/local/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html +513 -383
  159. data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-(CGFont)-Fonts.html +126 -83
  160. data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-Surfaces.html +172 -119
  161. data/vendor/local/share/gtk-doc/html/cairo/cairo-Raster-Sources.html +581 -372
  162. data/vendor/local/share/gtk-doc/html/cairo/cairo-Recording-Surfaces.html +179 -130
  163. data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html +888 -539
  164. data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +287 -192
  165. data/vendor/local/share/gtk-doc/html/cairo/cairo-Script-Surfaces.html +374 -231
  166. data/vendor/local/share/gtk-doc/html/cairo/cairo-Transformations.html +395 -219
  167. data/vendor/local/share/gtk-doc/html/cairo/cairo-Types.html +125 -75
  168. data/vendor/local/share/gtk-doc/html/cairo/cairo-User-Fonts.html +630 -464
  169. data/vendor/local/share/gtk-doc/html/cairo/cairo-Version-Information.html +225 -200
  170. data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +336 -214
  171. data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +277 -186
  172. data/vendor/local/share/gtk-doc/html/cairo/cairo-XCB-Surfaces.html +495 -350
  173. data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html +557 -362
  174. data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-XRender-Backend.html +158 -111
  175. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html +655 -441
  176. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +389 -280
  177. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html +667 -451
  178. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html +579 -351
  179. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html +2006 -1545
  180. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html +892 -618
  181. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +1624 -1188
  182. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-t.html +2903 -2104
  183. data/vendor/local/share/gtk-doc/html/cairo/cairo-drawing.html +13 -13
  184. data/vendor/local/share/gtk-doc/html/cairo/cairo-fonts.html +13 -13
  185. data/vendor/local/share/gtk-doc/html/cairo/cairo-support.html +13 -13
  186. data/vendor/local/share/gtk-doc/html/cairo/cairo-surfaces.html +13 -13
  187. data/vendor/local/share/gtk-doc/html/cairo/cairo-text.html +1115 -758
  188. data/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp2 +419 -604
  189. data/vendor/local/share/gtk-doc/html/cairo/home.png +0 -0
  190. data/vendor/local/share/gtk-doc/html/cairo/index-1.10.html +56 -56
  191. data/vendor/local/share/gtk-doc/html/cairo/index-1.12.html +70 -70
  192. data/vendor/local/share/gtk-doc/html/cairo/index-1.2.html +58 -58
  193. data/vendor/local/share/gtk-doc/html/cairo/index-1.4.html +39 -39
  194. data/vendor/local/share/gtk-doc/html/cairo/index-1.6.html +30 -30
  195. data/vendor/local/share/gtk-doc/html/cairo/index-1.8.html +38 -38
  196. data/vendor/local/share/gtk-doc/html/cairo/index-all.html +426 -426
  197. data/vendor/local/share/gtk-doc/html/cairo/index.html +6 -6
  198. data/vendor/local/share/gtk-doc/html/cairo/index.sgml +234 -325
  199. data/vendor/local/share/gtk-doc/html/cairo/language-bindings.html +12 -12
  200. data/vendor/local/share/gtk-doc/html/cairo/left-insensitive.png +0 -0
  201. data/vendor/local/share/gtk-doc/html/cairo/left.png +0 -0
  202. data/vendor/local/share/gtk-doc/html/cairo/right-insensitive.png +0 -0
  203. data/vendor/local/share/gtk-doc/html/cairo/right.png +0 -0
  204. data/vendor/local/share/gtk-doc/html/cairo/style.css +221 -26
  205. data/vendor/local/share/gtk-doc/html/cairo/up-insensitive.png +0 -0
  206. data/vendor/local/share/gtk-doc/html/cairo/up.png +0 -0
  207. data/vendor/local/share/license/cairo/README +1 -1
  208. data/vendor/local/share/license/freetype/README +6 -6
  209. data/vendor/local/share/license/freetype/README.git +1 -1
  210. data/vendor/local/share/license/libpng/README +2 -2
  211. data/vendor/local/share/man/man1/freetype-config.1 +1 -1
  212. data/vendor/local/share/man/man3/libpng.3 +85 -92
  213. data/vendor/local/share/man/man3/libpngpf.3 +2 -2
  214. data/vendor/local/share/man/man5/png.5 +1 -1
  215. metadata +23 -19
data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html CHANGED
@@ -2,30 +2,27 @@
2
2
  <html>
3
3
  <head>
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
- <title>Image Surfaces</title>
6
- <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
5
+ <title>Cairo: A Vector Graphics Library: Image Surfaces</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
  <link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
8
8
  <link rel="up" href="cairo-surfaces.html" title="Surfaces">
9
9
  <link rel="prev" href="cairo-cairo-surface-t.html" title="cairo_surface_t">
10
10
  <link rel="next" href="cairo-PDF-Surfaces.html" title="PDF Surfaces">
11
- <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.20 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
14
  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="cairo-cairo-surface-t.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="cairo-surfaces.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">Cairo: A Vector Graphics Library</th>
21
- <td><a accesskey="n" href="cairo-PDF-Surfaces.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#cairo-Image-Surfaces.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#cairo-Image-Surfaces.description" class="shortcut">Description</a>
27
- </td></tr>
28
- </table>
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
+ <td width="100%" align="left" class="shortcuts">
17
+ <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
18
+ <a href="#cairo-Image-Surfaces.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19
+ <a href="#cairo-Image-Surfaces.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
20
+ </td>
21
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22
+ <td><a accesskey="u" href="cairo-surfaces.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23
+ <td><a accesskey="p" href="cairo-cairo-surface-t.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24
+ <td><a accesskey="n" href="cairo-PDF-Surfaces.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
25
+ </tr></table>
29
26
  <div class="refentry">
30
27
  <a name="cairo-Image-Surfaces"></a><div class="titlepage"></div>
31
28
  <div class="refnamediv"><table width="100%"><tr>
@@ -33,138 +30,122 @@
33
30
  <h2><span class="refentrytitle"><a name="cairo-Image-Surfaces.top_of_page"></a>Image Surfaces</span></h2>
34
31
  <p>Image Surfaces — Rendering to memory buffers</p>
35
32
  </td>
36
- <td valign="top" align="right"></td>
33
+ <td class="gallery_image" valign="top" align="right"></td>
37
34
  </tr></table></div>
38
- <div class="refsynopsisdiv">
39
- <a name="cairo-Image-Surfaces.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">#define <a class="link" href="cairo-Image-Surfaces.html#CAIRO-HAS-IMAGE-SURFACE:CAPS" title="CAIRO_HAS_IMAGE_SURFACE">CAIRO_HAS_IMAGE_SURFACE</a>
41
- enum <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t">cairo_format_t</a>;
42
- <span class="returnvalue">int</span> <a class="link" href="cairo-Image-Surfaces.html#cairo-format-stride-for-width" title="cairo_format_stride_for_width ()">cairo_format_stride_for_width</a> (<em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
43
- <em class="parameter"><code><span class="type">int</span> width</code></em>);
44
- <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> * <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-create" title="cairo_image_surface_create ()">cairo_image_surface_create</a> (<em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
45
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
46
- <em class="parameter"><code><span class="type">int</span> height</code></em>);
47
- <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> * <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-create-for-data" title="cairo_image_surface_create_for_data ()">cairo_image_surface_create_for_data</a> (<em class="parameter"><code>unsigned <span class="type">char</span> *data</code></em>,
48
- <em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
49
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
50
- <em class="parameter"><code><span class="type">int</span> height</code></em>,
51
- <em class="parameter"><code><span class="type">int</span> stride</code></em>);
52
- unsigned <span class="returnvalue">char</span> * <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-data" title="cairo_image_surface_get_data ()">cairo_image_surface_get_data</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);
53
- <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="returnvalue">cairo_format_t</span></a> <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-format" title="cairo_image_surface_get_format ()">cairo_image_surface_get_format</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);
54
- <span class="returnvalue">int</span> <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-width" title="cairo_image_surface_get_width ()">cairo_image_surface_get_width</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);
55
- <span class="returnvalue">int</span> <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-height" title="cairo_image_surface_get_height ()">cairo_image_surface_get_height</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);
56
- <span class="returnvalue">int</span> <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-stride" title="cairo_image_surface_get_stride ()">cairo_image_surface_get_stride</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);
57
- </pre>
58
- </div>
59
35
  <div class="refsect1">
60
- <a name="cairo-Image-Surfaces.description"></a><h2>Description</h2>
61
- <p>
62
- Image surfaces provide the ability to render to memory buffers
63
- either allocated by cairo or by the calling code. The supported
64
- image formats are those defined in <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a>.
65
- </p>
66
- </div>
67
- <div class="refsect1">
68
- <a name="cairo-Image-Surfaces.details"></a><h2>Details</h2>
69
- <div class="refsect2">
70
- <a name="CAIRO-HAS-IMAGE-SURFACE:CAPS"></a><h3>CAIRO_HAS_IMAGE_SURFACE</h3>
71
- <pre class="programlisting">#define CAIRO_HAS_IMAGE_SURFACE 1
72
- </pre>
73
- <p>
74
- Defined if the image surface backend is available.
75
- The image surface backend is always built in.
76
- This macro was added for completeness in cairo 1.8.
77
- </p>
78
- <p class="since">Since 1.8</p>
79
- </div>
80
- <hr>
81
- <div class="refsect2">
82
- <a name="cairo-format-t"></a><h3>enum cairo_format_t</h3>
83
- <pre class="programlisting">typedef enum {
84
- CAIRO_FORMAT_INVALID = -1,
85
- CAIRO_FORMAT_ARGB32 = 0,
86
- CAIRO_FORMAT_RGB24 = 1,
87
- CAIRO_FORMAT_A8 = 2,
88
- CAIRO_FORMAT_A1 = 3,
89
- CAIRO_FORMAT_RGB16_565 = 4,
90
- CAIRO_FORMAT_RGB30 = 5
91
- } cairo_format_t;
92
- </pre>
93
- <p>
94
- <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> is used to identify the memory format of
95
- image data.
96
- </p>
97
- <p>
98
- New entries may be added in future versions.
99
- </p>
100
- <div class="variablelist"><table border="0">
101
- <col align="left" valign="top">
36
+ <a name="cairo-Image-Surfaces.functions"></a><h2>Functions</h2>
37
+ <div class="informaltable"><table width="100%" border="0">
38
+ <colgroup>
39
+ <col width="150px" class="functions_return">
40
+ <col class="functions_name">
41
+ </colgroup>
102
42
  <tbody>
103
43
  <tr>
104
- <td><p><a name="CAIRO-FORMAT-INVALID:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_INVALID</code></span></p></td>
105
- <td>no such format exists or is supported.
44
+ <td class="function_type">
45
+ <span class="returnvalue">int</span>
46
+ </td>
47
+ <td class="function_name">
48
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-format-stride-for-width" title="cairo_format_stride_for_width ()">cairo_format_stride_for_width</a> <span class="c_punctuation">()</span>
106
49
  </td>
107
50
  </tr>
108
51
  <tr>
109
- <td><p><a name="CAIRO-FORMAT-ARGB32:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_ARGB32</code></span></p></td>
110
- <td>each pixel is a 32-bit quantity, with
111
- alpha in the upper 8 bits, then red, then green, then blue.
112
- The 32-bit quantities are stored native-endian. Pre-multiplied
113
- alpha is used. (That is, 50% transparent red is 0x80800000,
114
- not 0x80ff0000.) (Since 1.0)
52
+ <td class="function_type">
53
+ <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
54
+ </td>
55
+ <td class="function_name">
56
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-create" title="cairo_image_surface_create ()">cairo_image_surface_create</a> <span class="c_punctuation">()</span>
115
57
  </td>
116
58
  </tr>
117
59
  <tr>
118
- <td><p><a name="CAIRO-FORMAT-RGB24:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_RGB24</code></span></p></td>
119
- <td>each pixel is a 32-bit quantity, with
120
- the upper 8 bits unused. Red, Green, and Blue are stored
121
- in the remaining 24 bits in that order. (Since 1.0)
60
+ <td class="function_type">
61
+ <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
62
+ </td>
63
+ <td class="function_name">
64
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-create-for-data" title="cairo_image_surface_create_for_data ()">cairo_image_surface_create_for_data</a> <span class="c_punctuation">()</span>
122
65
  </td>
123
66
  </tr>
124
67
  <tr>
125
- <td><p><a name="CAIRO-FORMAT-A8:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_A8</code></span></p></td>
126
- <td>each pixel is a 8-bit quantity holding
127
- an alpha value. (Since 1.0)
68
+ <td class="function_type">unsigned <span class="returnvalue">char</span> *
69
+ </td>
70
+ <td class="function_name">
71
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-data" title="cairo_image_surface_get_data ()">cairo_image_surface_get_data</a> <span class="c_punctuation">()</span>
128
72
  </td>
129
73
  </tr>
130
74
  <tr>
131
- <td><p><a name="CAIRO-FORMAT-A1:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_A1</code></span></p></td>
132
- <td>each pixel is a 1-bit quantity holding
133
- an alpha value. Pixels are packed together into 32-bit
134
- quantities. The ordering of the bits matches the
135
- endianess of the platform. On a big-endian machine, the
136
- first pixel is in the uppermost bit, on a little-endian
137
- machine the first pixel is in the least-significant bit. (Since 1.0)
75
+ <td class="function_type">
76
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="returnvalue">cairo_format_t</span></a>
77
+ </td>
78
+ <td class="function_name">
79
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-format" title="cairo_image_surface_get_format ()">cairo_image_surface_get_format</a> <span class="c_punctuation">()</span>
138
80
  </td>
139
81
  </tr>
140
82
  <tr>
141
- <td><p><a name="CAIRO-FORMAT-RGB16-565:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_RGB16_565</code></span></p></td>
142
- <td>each pixel is a 16-bit quantity
143
- with red in the upper 5 bits, then green in the middle
144
- 6 bits, and blue in the lower 5 bits. (Since 1.2)
83
+ <td class="function_type">
84
+ <span class="returnvalue">int</span>
85
+ </td>
86
+ <td class="function_name">
87
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-width" title="cairo_image_surface_get_width ()">cairo_image_surface_get_width</a> <span class="c_punctuation">()</span>
88
+ </td>
89
+ </tr>
90
+ <tr>
91
+ <td class="function_type">
92
+ <span class="returnvalue">int</span>
93
+ </td>
94
+ <td class="function_name">
95
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-height" title="cairo_image_surface_get_height ()">cairo_image_surface_get_height</a> <span class="c_punctuation">()</span>
145
96
  </td>
146
97
  </tr>
147
98
  <tr>
148
- <td><p><a name="CAIRO-FORMAT-RGB30:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_RGB30</code></span></p></td>
149
- <td>like RGB24 but with 10bpc. (Since 1.12)
99
+ <td class="function_type">
100
+ <span class="returnvalue">int</span>
101
+ </td>
102
+ <td class="function_name">
103
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-stride" title="cairo_image_surface_get_stride ()">cairo_image_surface_get_stride</a> <span class="c_punctuation">()</span>
150
104
  </td>
151
105
  </tr>
152
106
  </tbody>
153
107
  </table></div>
154
- <p class="since">Since 1.0</p>
155
108
  </div>
156
- <hr>
109
+ <div class="refsect1">
110
+ <a name="cairo-Image-Surfaces.other"></a><h2>Types and Values</h2>
111
+ <div class="informaltable"><table width="100%" border="0">
112
+ <colgroup>
113
+ <col width="150px" class="name">
114
+ <col class="description">
115
+ </colgroup>
116
+ <tbody>
117
+ <tr>
118
+ <td class="define_keyword">#define</td>
119
+ <td class="function_name"><a class="link" href="cairo-Image-Surfaces.html#CAIRO-HAS-IMAGE-SURFACE:CAPS" title="CAIRO_HAS_IMAGE_SURFACE">CAIRO_HAS_IMAGE_SURFACE</a></td>
120
+ </tr>
121
+ <tr>
122
+ <td class="datatype_keyword">enum</td>
123
+ <td class="function_name"><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t">cairo_format_t</a></td>
124
+ </tr>
125
+ </tbody>
126
+ </table></div>
127
+ </div>
128
+ <div class="refsect1">
129
+ <a name="cairo-Image-Surfaces.object-hierarchy"></a><h2>Object Hierarchy</h2>
130
+ <pre class="screen">
131
+ </pre>
132
+ </div>
133
+ <div class="refsect1">
134
+ <a name="cairo-Image-Surfaces.description"></a><h2>Description</h2>
135
+ <p>Image surfaces provide the ability to render to memory buffers
136
+ either allocated by cairo or by the calling code. The supported
137
+ image formats are those defined in <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a>.</p>
138
+ </div>
139
+ <div class="refsect1">
140
+ <a name="cairo-Image-Surfaces.functions_details"></a><h2>Functions</h2>
157
141
  <div class="refsect2">
158
- <a name="cairo-format-stride-for-width"></a><h3>cairo_format_stride_for_width ()</h3>
159
- <pre class="programlisting"><span class="returnvalue">int</span> cairo_format_stride_for_width (<em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
160
- <em class="parameter"><code><span class="type">int</span> width</code></em>);</pre>
161
- <p>
162
- This function provides a stride value that will respect all
142
+ <a name="cairo-format-stride-for-width"></a><h3>cairo_format_stride_for_width ()</h3>
143
+ <pre class="programlisting"><span class="returnvalue">int</span>
144
+ cairo_format_stride_for_width (<em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
145
+ <em class="parameter"><code><span class="type">int</span> width</code></em>);</pre>
146
+ <p>This function provides a stride value that will respect all
163
147
  alignment requirements of the accelerated image-rendering code
164
- within cairo. Typical usage will be of the form:
165
- </p>
166
- <p>
167
- </p>
148
+ within cairo. Typical usage will be of the form:</p>
168
149
  <div class="informalexample"><pre class="programlisting">
169
150
  int stride;
170
151
  unsigned char *data;
@@ -176,277 +157,426 @@ surface = cairo_image_surface_create_for_data (data, format,
176
157
  width, height,
177
158
  stride);
178
159
  </pre></div>
179
- <p>
180
- </p>
181
- <div class="variablelist"><table border="0">
182
- <col align="left" valign="top">
160
+ <div class="refsect3">
161
+ <a name="id-1.5.4.7.2.6"></a><h4>Parameters</h4>
162
+ <div class="informaltable"><table width="100%" border="0">
163
+ <colgroup>
164
+ <col width="150px" class="parameters_name">
165
+ <col class="parameters_description">
166
+ <col width="200px" class="parameters_annotations">
167
+ </colgroup>
183
168
  <tbody>
184
169
  <tr>
185
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
186
- <td>A <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> value</td>
170
+ <td class="parameter_name"><p>format</p></td>
171
+ <td class="parameter_description"><p>A <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> value</p></td>
172
+ <td class="parameter_annotations"> </td>
187
173
  </tr>
188
174
  <tr>
189
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
190
- <td>The desired width of an image surface to be created.</td>
191
- </tr>
192
- <tr>
193
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
194
- <td>the appropriate stride to use given the desired
195
- format and width, or -1 if either the format is invalid or the width
196
- too large.</td>
175
+ <td class="parameter_name"><p>width</p></td>
176
+ <td class="parameter_description"><p>The desired width of an image surface to be created.</p></td>
177
+ <td class="parameter_annotations"> </td>
197
178
  </tr>
198
179
  </tbody>
199
180
  </table></div>
181
+ </div>
182
+ <div class="refsect3">
183
+ <a name="id-1.5.4.7.2.7"></a><h4>Returns</h4>
184
+ <p> the appropriate stride to use given the desired
185
+ format and width, or -1 if either the format is invalid or the width
186
+ too large.</p>
187
+ <p></p>
188
+ </div>
200
189
  <p class="since">Since 1.6</p>
201
190
  </div>
202
191
  <hr>
203
192
  <div class="refsect2">
204
- <a name="cairo-image-surface-create"></a><h3>cairo_image_surface_create ()</h3>
205
- <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> * cairo_image_surface_create (<em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
206
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
207
- <em class="parameter"><code><span class="type">int</span> height</code></em>);</pre>
208
- <p>
209
- Creates an image surface of the specified format and
210
- dimensions. Initially the surface contents are all
211
- 0. (Specifically, within each pixel, each color or alpha channel
193
+ <a name="cairo-image-surface-create"></a><h3>cairo_image_surface_create ()</h3>
194
+ <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
195
+ cairo_image_surface_create (<em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
196
+ <em class="parameter"><code><span class="type">int</span> width</code></em>,
197
+ <em class="parameter"><code><span class="type">int</span> height</code></em>);</pre>
198
+ <p>Creates an image surface of the specified format and
199
+ dimensions. Initially the surface contents are all</p>
200
+ <div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>(Specifically, within each pixel, each color or alpha channel
212
201
  belonging to format will be 0. The contents of bits within a pixel,
213
- but not belonging to the given format are undefined).
214
- </p>
215
- <div class="variablelist"><table border="0">
216
- <col align="left" valign="top">
202
+ but not belonging to the given format are undefined).</p></li></ol></div>
203
+ <div class="refsect3">
204
+ <a name="id-1.5.4.7.3.6"></a><h4>Parameters</h4>
205
+ <div class="informaltable"><table width="100%" border="0">
206
+ <colgroup>
207
+ <col width="150px" class="parameters_name">
208
+ <col class="parameters_description">
209
+ <col width="200px" class="parameters_annotations">
210
+ </colgroup>
217
211
  <tbody>
218
212
  <tr>
219
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
220
- <td>format of pixels in the surface to create</td>
221
- </tr>
222
- <tr>
223
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
224
- <td>width of the surface, in pixels</td>
213
+ <td class="parameter_name"><p>format</p></td>
214
+ <td class="parameter_description"><p>format of pixels in the surface to create</p></td>
215
+ <td class="parameter_annotations"> </td>
225
216
  </tr>
226
217
  <tr>
227
- <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
228
- <td>height of the surface, in pixels</td>
218
+ <td class="parameter_name"><p>width</p></td>
219
+ <td class="parameter_description"><p>width of the surface, in pixels</p></td>
220
+ <td class="parameter_annotations"> </td>
229
221
  </tr>
230
222
  <tr>
231
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
232
- <td>a pointer to the newly created surface. The caller
233
- owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
234
- with it.
235
- This function always returns a valid pointer, but it will return a
236
- pointer to a "nil" surface if an error such as out of memory
237
- occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.</td>
223
+ <td class="parameter_name"><p>height</p></td>
224
+ <td class="parameter_description"><p>height of the surface, in pixels</p></td>
225
+ <td class="parameter_annotations"> </td>
238
226
  </tr>
239
227
  </tbody>
240
228
  </table></div>
229
+ </div>
230
+ <div class="refsect3">
231
+ <a name="id-1.5.4.7.3.7"></a><h4>Returns</h4>
232
+ <p> a pointer to the newly created surface. The caller
233
+ owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
234
+ with it.</p>
235
+ <p>This function always returns a valid pointer, but it will return a
236
+ pointer to a "nil" surface if an error such as out of memory
237
+ occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.</p>
238
+ <p></p>
239
+ </div>
241
240
  <p class="since">Since 1.0</p>
242
241
  </div>
243
242
  <hr>
244
243
  <div class="refsect2">
245
- <a name="cairo-image-surface-create-for-data"></a><h3>cairo_image_surface_create_for_data ()</h3>
246
- <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> * cairo_image_surface_create_for_data (<em class="parameter"><code>unsigned <span class="type">char</span> *data</code></em>,
247
- <em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
248
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
249
- <em class="parameter"><code><span class="type">int</span> height</code></em>,
250
- <em class="parameter"><code><span class="type">int</span> stride</code></em>);</pre>
251
- <p>
252
- Creates an image surface for the provided pixel data. The output
244
+ <a name="cairo-image-surface-create-for-data"></a><h3>cairo_image_surface_create_for_data ()</h3>
245
+ <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
246
+ cairo_image_surface_create_for_data (<em class="parameter"><code>unsigned <span class="type">char</span> *data</code></em>,
247
+ <em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
248
+ <em class="parameter"><code><span class="type">int</span> width</code></em>,
249
+ <em class="parameter"><code><span class="type">int</span> height</code></em>,
250
+ <em class="parameter"><code><span class="type">int</span> stride</code></em>);</pre>
251
+ <p>Creates an image surface for the provided pixel data. The output
253
252
  buffer must be kept around until the <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> is destroyed
254
- or <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-finish" title="cairo_surface_finish ()"><code class="function">cairo_surface_finish()</code></a> is called on the surface. The initial
255
- contents of <em class="parameter"><code>data</code></em> will be used as the initial image contents; you
253
+ or <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-finish" title="cairo_surface_finish ()"><code class="function">cairo_surface_finish()</code></a> is called on the surface. The initial
254
+ contents of <em class="parameter"><code>data</code></em>
255
+ will be used as the initial image contents; you
256
256
  must explicitly clear the buffer, using, for example,
257
- <a class="link" href="cairo-Paths.html#cairo-rectangle" title="cairo_rectangle ()"><code class="function">cairo_rectangle()</code></a> and <a class="link" href="cairo-cairo-t.html#cairo-fill" title="cairo_fill ()"><code class="function">cairo_fill()</code></a> if you want it cleared.
258
- </p>
259
- <p>
260
- Note that the stride may be larger than
257
+ <a class="link" href="cairo-Paths.html#cairo-rectangle" title="cairo_rectangle ()"><code class="function">cairo_rectangle()</code></a> and <a class="link" href="cairo-cairo-t.html#cairo-fill" title="cairo_fill ()"><code class="function">cairo_fill()</code></a> if you want it cleared.</p>
258
+ <p>Note that the stride may be larger than
261
259
  width*bytes_per_pixel to provide proper alignment for each pixel
262
260
  and row. This alignment is required to allow high-performance rendering
263
261
  within cairo. The correct way to obtain a legal stride value is to
264
- call <a class="link" href="cairo-Image-Surfaces.html#cairo-format-stride-for-width" title="cairo_format_stride_for_width ()"><code class="function">cairo_format_stride_for_width()</code></a> with the desired format and
262
+ call <a class="link" href="cairo-Image-Surfaces.html#cairo-format-stride-for-width" title="cairo_format_stride_for_width ()"><code class="function">cairo_format_stride_for_width()</code></a> with the desired format and
265
263
  maximum image width value, and then use the resulting stride value
266
264
  to allocate the data and to create the image surface. See
267
- <a class="link" href="cairo-Image-Surfaces.html#cairo-format-stride-for-width" title="cairo_format_stride_for_width ()"><code class="function">cairo_format_stride_for_width()</code></a> for example code.
268
- </p>
269
- <div class="variablelist"><table border="0">
270
- <col align="left" valign="top">
265
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-format-stride-for-width" title="cairo_format_stride_for_width ()"><code class="function">cairo_format_stride_for_width()</code></a> for example code.</p>
266
+ <div class="refsect3">
267
+ <a name="id-1.5.4.7.4.6"></a><h4>Parameters</h4>
268
+ <div class="informaltable"><table width="100%" border="0">
269
+ <colgroup>
270
+ <col width="150px" class="parameters_name">
271
+ <col class="parameters_description">
272
+ <col width="200px" class="parameters_annotations">
273
+ </colgroup>
271
274
  <tbody>
272
275
  <tr>
273
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
274
- <td>a pointer to a buffer supplied by the application in which
276
+ <td class="parameter_name"><p>data</p></td>
277
+ <td class="parameter_description"><p>a pointer to a buffer supplied by the application in which
275
278
  to write contents. This pointer must be suitably aligned for any
276
- kind of variable, (for example, a pointer returned by malloc).</td>
279
+ kind of variable, (for example, a pointer returned by malloc).</p></td>
280
+ <td class="parameter_annotations"> </td>
277
281
  </tr>
278
282
  <tr>
279
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
280
- <td>the format of pixels in the buffer</td>
283
+ <td class="parameter_name"><p>format</p></td>
284
+ <td class="parameter_description"><p>the format of pixels in the buffer</p></td>
285
+ <td class="parameter_annotations"> </td>
281
286
  </tr>
282
287
  <tr>
283
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
284
- <td>the width of the image to be stored in the buffer</td>
288
+ <td class="parameter_name"><p>width</p></td>
289
+ <td class="parameter_description"><p>the width of the image to be stored in the buffer</p></td>
290
+ <td class="parameter_annotations"> </td>
285
291
  </tr>
286
292
  <tr>
287
- <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
288
- <td>the height of the image to be stored in the buffer</td>
293
+ <td class="parameter_name"><p>height</p></td>
294
+ <td class="parameter_description"><p>the height of the image to be stored in the buffer</p></td>
295
+ <td class="parameter_annotations"> </td>
289
296
  </tr>
290
297
  <tr>
291
- <td><p><span class="term"><em class="parameter"><code>stride</code></em> :</span></p></td>
292
- <td>the number of bytes between the start of rows in the
298
+ <td class="parameter_name"><p>stride</p></td>
299
+ <td class="parameter_description"><p>the number of bytes between the start of rows in the
293
300
  buffer as allocated. This value should always be computed by
294
- <a class="link" href="cairo-Image-Surfaces.html#cairo-format-stride-for-width" title="cairo_format_stride_for_width ()"><code class="function">cairo_format_stride_for_width()</code></a> before allocating the data
295
- buffer.</td>
301
+ <a class="link" href="cairo-Image-Surfaces.html#cairo-format-stride-for-width" title="cairo_format_stride_for_width ()"><code class="function">cairo_format_stride_for_width()</code></a> before allocating the data
302
+ buffer.</p></td>
303
+ <td class="parameter_annotations"> </td>
296
304
  </tr>
297
- <tr>
298
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
299
- <td>a pointer to the newly created surface. The caller
300
- owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
301
- with it.
302
- This function always returns a valid pointer, but it will return a
305
+ </tbody>
306
+ </table></div>
307
+ </div>
308
+ <div class="refsect3">
309
+ <a name="id-1.5.4.7.4.7"></a><h4>Returns</h4>
310
+ <p> a pointer to the newly created surface. The caller
311
+ owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
312
+ with it.</p>
313
+ <p>This function always returns a valid pointer, but it will return a
303
314
  pointer to a "nil" surface in the case of an error such as out of
304
315
  memory or an invalid stride value. In case of invalid stride value
305
316
  the error status of the returned surface will be
306
317
  <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-INVALID-STRIDE:CAPS"><code class="literal">CAIRO_STATUS_INVALID_STRIDE</code></a>. You can use
307
- <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.
308
- See <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-set-user-data" title="cairo_surface_set_user_data ()"><code class="function">cairo_surface_set_user_data()</code></a> for a means of attaching a
309
- destroy-notification fallback to the surface if necessary.</td>
310
- </tr>
311
- </tbody>
312
- </table></div>
318
+ <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.</p>
319
+ <p>See <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-set-user-data" title="cairo_surface_set_user_data ()"><code class="function">cairo_surface_set_user_data()</code></a> for a means of attaching a
320
+ destroy-notification fallback to the surface if necessary.</p>
321
+ <p></p>
322
+ </div>
313
323
  <p class="since">Since 1.0</p>
314
324
  </div>
315
325
  <hr>
316
326
  <div class="refsect2">
317
- <a name="cairo-image-surface-get-data"></a><h3>cairo_image_surface_get_data ()</h3>
318
- <pre class="programlisting">unsigned <span class="returnvalue">char</span> * cairo_image_surface_get_data (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
319
- <p>
320
- Get a pointer to the data of the image surface, for direct
321
- inspection or modification.
322
- </p>
323
- <p>
324
- A call to <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-flush" title="cairo_surface_flush ()"><code class="function">cairo_surface_flush()</code></a> is required before accessing the
327
+ <a name="cairo-image-surface-get-data"></a><h3>cairo_image_surface_get_data ()</h3>
328
+ <pre class="programlisting">unsigned <span class="returnvalue">char</span> *
329
+ cairo_image_surface_get_data (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
330
+ <p>Get a pointer to the data of the image surface, for direct
331
+ inspection or modification.</p>
332
+ <p>A call to <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-flush" title="cairo_surface_flush ()"><code class="function">cairo_surface_flush()</code></a> is required before accessing the
325
333
  pixel data to ensure that all pending drawing operations are
326
- finished. A call to <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-mark-dirty" title="cairo_surface_mark_dirty ()"><code class="function">cairo_surface_mark_dirty()</code></a> is required after
327
- the data is modified.
328
- </p>
329
- <div class="variablelist"><table border="0">
330
- <col align="left" valign="top">
331
- <tbody>
332
- <tr>
333
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
334
- <td>a <span class="type">cairo_image_surface_t</span>
335
- </td>
336
- </tr>
337
- <tr>
338
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
339
- <td>a pointer to the image data of this surface or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
340
- if <em class="parameter"><code>surface</code></em> is not an image surface, or if <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-finish" title="cairo_surface_finish ()"><code class="function">cairo_surface_finish()</code></a>
341
- has been called.</td>
342
- </tr>
343
- </tbody>
334
+ finished. A call to <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-mark-dirty" title="cairo_surface_mark_dirty ()"><code class="function">cairo_surface_mark_dirty()</code></a> is required after
335
+ the data is modified.</p>
336
+ <div class="refsect3">
337
+ <a name="id-1.5.4.7.5.6"></a><h4>Parameters</h4>
338
+ <div class="informaltable"><table width="100%" border="0">
339
+ <colgroup>
340
+ <col width="150px" class="parameters_name">
341
+ <col class="parameters_description">
342
+ <col width="200px" class="parameters_annotations">
343
+ </colgroup>
344
+ <tbody><tr>
345
+ <td class="parameter_name"><p>surface</p></td>
346
+ <td class="parameter_description"><p>a <span class="type">cairo_image_surface_t</span></p></td>
347
+ <td class="parameter_annotations"> </td>
348
+ </tr></tbody>
344
349
  </table></div>
350
+ </div>
351
+ <div class="refsect3">
352
+ <a name="id-1.5.4.7.5.7"></a><h4>Returns</h4>
353
+ <p> a pointer to the image data of this surface or <code class="literal">NULL</code>
354
+ if <em class="parameter"><code>surface</code></em>
355
+ is not an image surface, or if <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-finish" title="cairo_surface_finish ()"><code class="function">cairo_surface_finish()</code></a>
356
+ has been called.</p>
357
+ <p></p>
358
+ </div>
345
359
  <p class="since">Since 1.2</p>
346
360
  </div>
347
361
  <hr>
348
362
  <div class="refsect2">
349
- <a name="cairo-image-surface-get-format"></a><h3>cairo_image_surface_get_format ()</h3>
350
- <pre class="programlisting"><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="returnvalue">cairo_format_t</span></a> cairo_image_surface_get_format (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
351
- <p>
352
- Get the format of the surface.
353
- </p>
354
- <div class="variablelist"><table border="0">
355
- <col align="left" valign="top">
356
- <tbody>
357
- <tr>
358
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
359
- <td>a <span class="type">cairo_image_surface_t</span>
360
- </td>
361
- </tr>
362
- <tr>
363
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
364
- <td>the format of the surface</td>
365
- </tr>
366
- </tbody>
363
+ <a name="cairo-image-surface-get-format"></a><h3>cairo_image_surface_get_format ()</h3>
364
+ <pre class="programlisting"><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="returnvalue">cairo_format_t</span></a>
365
+ cairo_image_surface_get_format (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
366
+ <p>Get the format of the surface.</p>
367
+ <div class="refsect3">
368
+ <a name="id-1.5.4.7.6.5"></a><h4>Parameters</h4>
369
+ <div class="informaltable"><table width="100%" border="0">
370
+ <colgroup>
371
+ <col width="150px" class="parameters_name">
372
+ <col class="parameters_description">
373
+ <col width="200px" class="parameters_annotations">
374
+ </colgroup>
375
+ <tbody><tr>
376
+ <td class="parameter_name"><p>surface</p></td>
377
+ <td class="parameter_description"><p>a <span class="type">cairo_image_surface_t</span></p></td>
378
+ <td class="parameter_annotations"> </td>
379
+ </tr></tbody>
367
380
  </table></div>
381
+ </div>
382
+ <div class="refsect3">
383
+ <a name="id-1.5.4.7.6.6"></a><h4>Returns</h4>
384
+ <p> the format of the surface</p>
385
+ <p></p>
386
+ </div>
368
387
  <p class="since">Since 1.2</p>
369
388
  </div>
370
389
  <hr>
371
390
  <div class="refsect2">
372
- <a name="cairo-image-surface-get-width"></a><h3>cairo_image_surface_get_width ()</h3>
373
- <pre class="programlisting"><span class="returnvalue">int</span> cairo_image_surface_get_width (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
374
- <p>
375
- Get the width of the image surface in pixels.
376
- </p>
377
- <div class="variablelist"><table border="0">
378
- <col align="left" valign="top">
379
- <tbody>
380
- <tr>
381
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
382
- <td>a <span class="type">cairo_image_surface_t</span>
383
- </td>
384
- </tr>
385
- <tr>
386
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
387
- <td>the width of the surface in pixels.</td>
388
- </tr>
389
- </tbody>
391
+ <a name="cairo-image-surface-get-width"></a><h3>cairo_image_surface_get_width ()</h3>
392
+ <pre class="programlisting"><span class="returnvalue">int</span>
393
+ cairo_image_surface_get_width (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
394
+ <p>Get the width of the image surface in pixels.</p>
395
+ <div class="refsect3">
396
+ <a name="id-1.5.4.7.7.5"></a><h4>Parameters</h4>
397
+ <div class="informaltable"><table width="100%" border="0">
398
+ <colgroup>
399
+ <col width="150px" class="parameters_name">
400
+ <col class="parameters_description">
401
+ <col width="200px" class="parameters_annotations">
402
+ </colgroup>
403
+ <tbody><tr>
404
+ <td class="parameter_name"><p>surface</p></td>
405
+ <td class="parameter_description"><p>a <span class="type">cairo_image_surface_t</span></p></td>
406
+ <td class="parameter_annotations"> </td>
407
+ </tr></tbody>
390
408
  </table></div>
409
+ </div>
410
+ <div class="refsect3">
411
+ <a name="id-1.5.4.7.7.6"></a><h4>Returns</h4>
412
+ <p> the width of the surface in pixels.</p>
413
+ <p></p>
414
+ </div>
391
415
  <p class="since">Since 1.0</p>
392
416
  </div>
393
417
  <hr>
394
418
  <div class="refsect2">
395
- <a name="cairo-image-surface-get-height"></a><h3>cairo_image_surface_get_height ()</h3>
396
- <pre class="programlisting"><span class="returnvalue">int</span> cairo_image_surface_get_height (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
397
- <p>
398
- Get the height of the image surface in pixels.
399
- </p>
400
- <div class="variablelist"><table border="0">
401
- <col align="left" valign="top">
402
- <tbody>
403
- <tr>
404
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
405
- <td>a <span class="type">cairo_image_surface_t</span>
406
- </td>
407
- </tr>
408
- <tr>
409
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
410
- <td>the height of the surface in pixels.</td>
411
- </tr>
412
- </tbody>
419
+ <a name="cairo-image-surface-get-height"></a><h3>cairo_image_surface_get_height ()</h3>
420
+ <pre class="programlisting"><span class="returnvalue">int</span>
421
+ cairo_image_surface_get_height (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
422
+ <p>Get the height of the image surface in pixels.</p>
423
+ <div class="refsect3">
424
+ <a name="id-1.5.4.7.8.5"></a><h4>Parameters</h4>
425
+ <div class="informaltable"><table width="100%" border="0">
426
+ <colgroup>
427
+ <col width="150px" class="parameters_name">
428
+ <col class="parameters_description">
429
+ <col width="200px" class="parameters_annotations">
430
+ </colgroup>
431
+ <tbody><tr>
432
+ <td class="parameter_name"><p>surface</p></td>
433
+ <td class="parameter_description"><p>a <span class="type">cairo_image_surface_t</span></p></td>
434
+ <td class="parameter_annotations"> </td>
435
+ </tr></tbody>
413
436
  </table></div>
437
+ </div>
438
+ <div class="refsect3">
439
+ <a name="id-1.5.4.7.8.6"></a><h4>Returns</h4>
440
+ <p> the height of the surface in pixels.</p>
441
+ <p></p>
442
+ </div>
414
443
  <p class="since">Since 1.0</p>
415
444
  </div>
416
445
  <hr>
417
446
  <div class="refsect2">
418
- <a name="cairo-image-surface-get-stride"></a><h3>cairo_image_surface_get_stride ()</h3>
419
- <pre class="programlisting"><span class="returnvalue">int</span> cairo_image_surface_get_stride (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
420
- <p>
421
- Get the stride of the image surface in bytes
422
- </p>
423
- <div class="variablelist"><table border="0">
424
- <col align="left" valign="top">
447
+ <a name="cairo-image-surface-get-stride"></a><h3>cairo_image_surface_get_stride ()</h3>
448
+ <pre class="programlisting"><span class="returnvalue">int</span>
449
+ cairo_image_surface_get_stride (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
450
+ <p>Get the stride of the image surface in bytes</p>
451
+ <div class="refsect3">
452
+ <a name="id-1.5.4.7.9.5"></a><h4>Parameters</h4>
453
+ <div class="informaltable"><table width="100%" border="0">
454
+ <colgroup>
455
+ <col width="150px" class="parameters_name">
456
+ <col class="parameters_description">
457
+ <col width="200px" class="parameters_annotations">
458
+ </colgroup>
459
+ <tbody><tr>
460
+ <td class="parameter_name"><p>surface</p></td>
461
+ <td class="parameter_description"><p>a <span class="type">cairo_image_surface_t</span></p></td>
462
+ <td class="parameter_annotations"> </td>
463
+ </tr></tbody>
464
+ </table></div>
465
+ </div>
466
+ <div class="refsect3">
467
+ <a name="id-1.5.4.7.9.6"></a><h4>Returns</h4>
468
+ <p> the stride of the image surface in bytes (or 0 if
469
+ <em class="parameter"><code>surface</code></em>
470
+ is not an image surface). The stride is the distance in
471
+ bytes from the beginning of one row of the image data to the
472
+ beginning of the next row.</p>
473
+ <p></p>
474
+ </div>
475
+ <p class="since">Since 1.2</p>
476
+ </div>
477
+ </div>
478
+ <div class="refsect1">
479
+ <a name="cairo-Image-Surfaces.other_details"></a><h2>Types and Values</h2>
480
+ <div class="refsect2">
481
+ <a name="CAIRO-HAS-IMAGE-SURFACE:CAPS"></a><h3>CAIRO_HAS_IMAGE_SURFACE</h3>
482
+ <pre class="programlisting">#define CAIRO_HAS_IMAGE_SURFACE 1
483
+ </pre>
484
+ <p>Defined if the image surface backend is available.
485
+ The image surface backend is always built in.
486
+ This macro was added for completeness in cairo 1.8.</p>
487
+ <p class="since">Since 1.8</p>
488
+ </div>
489
+ <hr>
490
+ <div class="refsect2">
491
+ <a name="cairo-format-t"></a><h3>enum cairo_format_t</h3>
492
+ <p><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> is used to identify the memory format of
493
+ image data.</p>
494
+ <p>New entries may be added in future versions.</p>
495
+ <div class="refsect3">
496
+ <a name="id-1.5.4.8.3.5"></a><h4>Members</h4>
497
+ <div class="informaltable"><table width="100%" border="0">
498
+ <colgroup>
499
+ <col width="300px" class="enum_members_name">
500
+ <col class="enum_members_description">
501
+ <col width="200px" class="enum_members_annotations">
502
+ </colgroup>
425
503
  <tbody>
426
504
  <tr>
427
- <td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
428
- <td>a <span class="type">cairo_image_surface_t</span>
505
+ <td class="enum_member_name"><p><a name="CAIRO-FORMAT-INVALID:CAPS"></a>CAIRO_FORMAT_INVALID</p></td>
506
+ <td class="enum_member_description">
507
+ <p>no such format exists or is supported.</p>
429
508
  </td>
509
+ <td class="enum_member_annotations"> </td>
430
510
  </tr>
431
511
  <tr>
432
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
433
- <td>the stride of the image surface in bytes (or 0 if
434
- <em class="parameter"><code>surface</code></em> is not an image surface). The stride is the distance in
435
- bytes from the beginning of one row of the image data to the
436
- beginning of the next row.</td>
512
+ <td class="enum_member_name"><p><a name="CAIRO-FORMAT-ARGB32:CAPS"></a>CAIRO_FORMAT_ARGB32</p></td>
513
+ <td class="enum_member_description">
514
+ <p>each pixel is a 32-bit quantity, with
515
+ alpha in the upper 8 bits, then red, then green, then blue.
516
+ The 32-bit quantities are stored native-endian. Pre-multiplied
517
+ alpha is used. (That is, 50% transparent red is 0x80800000,
518
+ not 0x80ff0000.) (Since 1.0)</p>
519
+ </td>
520
+ <td class="enum_member_annotations"> </td>
521
+ </tr>
522
+ <tr>
523
+ <td class="enum_member_name"><p><a name="CAIRO-FORMAT-RGB24:CAPS"></a>CAIRO_FORMAT_RGB24</p></td>
524
+ <td class="enum_member_description">
525
+ <p>each pixel is a 32-bit quantity, with
526
+ the upper 8 bits unused. Red, Green, and Blue are stored
527
+ in the remaining 24 bits in that order. (Since 1.0)</p>
528
+ </td>
529
+ <td class="enum_member_annotations"> </td>
530
+ </tr>
531
+ <tr>
532
+ <td class="enum_member_name"><p><a name="CAIRO-FORMAT-A8:CAPS"></a>CAIRO_FORMAT_A8</p></td>
533
+ <td class="enum_member_description">
534
+ <p>each pixel is a 8-bit quantity holding
535
+ an alpha value. (Since 1.0)</p>
536
+ </td>
537
+ <td class="enum_member_annotations"> </td>
538
+ </tr>
539
+ <tr>
540
+ <td class="enum_member_name"><p><a name="CAIRO-FORMAT-A1:CAPS"></a>CAIRO_FORMAT_A1</p></td>
541
+ <td class="enum_member_description">
542
+ <p>each pixel is a 1-bit quantity holding
543
+ an alpha value. Pixels are packed together into 32-bit
544
+ quantities. The ordering of the bits matches the
545
+ endianess of the platform. On a big-endian machine, the
546
+ first pixel is in the uppermost bit, on a little-endian
547
+ machine the first pixel is in the least-significant bit. (Since 1.0)</p>
548
+ </td>
549
+ <td class="enum_member_annotations"> </td>
550
+ </tr>
551
+ <tr>
552
+ <td class="enum_member_name"><p><a name="CAIRO-FORMAT-RGB16-565:CAPS"></a>CAIRO_FORMAT_RGB16_565</p></td>
553
+ <td class="enum_member_description">
554
+ <p>each pixel is a 16-bit quantity
555
+ with red in the upper 5 bits, then green in the middle
556
+ 6 bits, and blue in the lower 5 bits. (Since 1.2)</p>
557
+ </td>
558
+ <td class="enum_member_annotations"> </td>
559
+ </tr>
560
+ <tr>
561
+ <td class="enum_member_name"><p><a name="CAIRO-FORMAT-RGB30:CAPS"></a>CAIRO_FORMAT_RGB30</p></td>
562
+ <td class="enum_member_description">
563
+ <p>like RGB24 but with 10bpc. (Since 1.12)</p>
564
+ </td>
565
+ <td class="enum_member_annotations"> </td>
437
566
  </tr>
438
567
  </tbody>
439
568
  </table></div>
440
- <p class="since">Since 1.2</p>
569
+ </div>
570
+ <p class="since">Since 1.0</p>
441
571
  </div>
442
572
  </div>
443
573
  <div class="refsect1">
444
574
  <a name="cairo-Image-Surfaces.see-also"></a><h2>See Also</h2>
445
- <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
575
+ <p><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a></p>
446
576
  </div>
447
577
  </div>
448
578
  <div class="footer">
449
579
  <hr>
450
- Generated by GTK-Doc V1.18</div>
580
+ Generated by GTK-Doc V1.20</div>
451
581
  </body>
452
582
  </html>