cairo 1.14.1-x86-mingw32 → 1.14.2-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of cairo might be problematic. Click here for more details.
- checksums.yaml +4 -4
- data/NEWS +21 -0
- data/Rakefile +18 -7
- data/ext/cairo/cairo.def +1 -0
- data/ext/cairo/extconf.rb +23 -10
- data/ext/cairo/rb_cairo.c +3 -0
- data/ext/cairo/rb_cairo.h +3 -3
- data/ext/cairo/rb_cairo_context.c +1 -1
- data/ext/cairo/rb_cairo_io.c +4 -0
- data/ext/cairo/rb_cairo_io.h +2 -0
- data/ext/cairo/rb_cairo_pattern.c +4 -4
- data/ext/cairo/rb_cairo_private.h +2 -0
- data/ext/cairo/rb_cairo_surface.c +64 -232
- data/lib/2.0/cairo.so +0 -0
- data/lib/2.1/cairo.so +0 -0
- data/lib/2.2/cairo.so +0 -0
- data/lib/cairo.rb +20 -19
- data/lib/cairo/region.rb +14 -0
- data/test/test_region.rb +26 -0
- data/vendor/local/bin/fc-cache.exe +0 -0
- data/vendor/local/bin/fc-cat.exe +0 -0
- data/vendor/local/bin/fc-list.exe +0 -0
- data/vendor/local/bin/fc-match.exe +0 -0
- data/vendor/local/bin/fc-pattern.exe +0 -0
- data/vendor/local/bin/fc-query.exe +0 -0
- data/vendor/local/bin/fc-scan.exe +0 -0
- data/vendor/local/bin/fc-validate.exe +0 -0
- data/vendor/local/bin/freetype-config +2 -2
- data/vendor/local/bin/libcairo-2.dll +0 -0
- data/vendor/local/bin/libcairo-gobject-2.dll +0 -0
- data/vendor/local/bin/libcairo-script-interpreter-2.dll +0 -0
- data/vendor/local/bin/libfontconfig-1.dll +0 -0
- data/vendor/local/bin/libfreetype-6.dll +0 -0
- data/vendor/local/bin/libgcc_s_sjlj-1.dll +0 -0
- data/vendor/local/bin/libpixman-1-0.dll +0 -0
- data/vendor/local/bin/libpng-config +1 -1
- data/vendor/local/bin/libpng16-16.dll +0 -0
- data/vendor/local/bin/libpng16-config +1 -1
- data/vendor/local/bin/libstdc++-6.dll +0 -0
- data/vendor/local/bin/libwinpthread-1.dll +0 -0
- data/vendor/local/bin/libxml2-2.dll +0 -0
- data/vendor/local/bin/png-fix-itxt.exe +0 -0
- data/vendor/local/bin/pngfix.exe +0 -0
- data/vendor/local/bin/xmlcatalog.exe +0 -0
- data/vendor/local/bin/xmllint.exe +0 -0
- data/vendor/local/bin/zlib1.dll +0 -0
- data/vendor/local/include/cairo/cairo-version.h +1 -1
- data/vendor/local/include/freetype2/config/ftconfig.h +19 -2
- data/vendor/local/include/freetype2/config/ftheader.h +7 -5
- data/vendor/local/include/freetype2/config/ftoption.h +9 -22
- data/vendor/local/include/freetype2/config/ftstdlib.h +2 -3
- data/vendor/local/include/freetype2/freetype.h +38 -17
- data/vendor/local/include/freetype2/ft2build.h +1 -1
- data/vendor/local/include/freetype2/ftadvanc.h +2 -2
- data/vendor/local/include/freetype2/ftautoh.h +50 -2
- data/vendor/local/include/freetype2/ftbbox.h +1 -1
- data/vendor/local/include/freetype2/ftbdf.h +1 -1
- data/vendor/local/include/freetype2/ftbitmap.h +11 -3
- data/vendor/local/include/freetype2/ftbzip2.h +1 -1
- data/vendor/local/include/freetype2/ftcache.h +3 -3
- data/vendor/local/include/freetype2/ftcffdrv.h +1 -1
- data/vendor/local/include/freetype2/ftcid.h +2 -1
- data/vendor/local/include/freetype2/fterrdef.h +1 -1
- data/vendor/local/include/freetype2/fterrors.h +1 -1
- data/vendor/local/include/freetype2/{ftxf86.h → ftfntfmt.h} +22 -14
- data/vendor/local/include/freetype2/ftgasp.h +1 -1
- data/vendor/local/include/freetype2/ftglyph.h +1 -1
- data/vendor/local/include/freetype2/ftgxval.h +1 -1
- data/vendor/local/include/freetype2/ftgzip.h +1 -1
- data/vendor/local/include/freetype2/ftimage.h +7 -13
- data/vendor/local/include/freetype2/ftincrem.h +1 -1
- data/vendor/local/include/freetype2/ftlcdfil.h +2 -2
- data/vendor/local/include/freetype2/ftlist.h +1 -1
- data/vendor/local/include/freetype2/ftlzw.h +1 -1
- data/vendor/local/include/freetype2/ftmac.h +1 -1
- data/vendor/local/include/freetype2/ftmm.h +17 -11
- data/vendor/local/include/freetype2/ftmodapi.h +4 -2
- data/vendor/local/include/freetype2/ftmoderr.h +1 -1
- data/vendor/local/include/freetype2/ftotval.h +1 -1
- data/vendor/local/include/freetype2/ftoutln.h +1 -1
- data/vendor/local/include/freetype2/ftpfr.h +1 -1
- data/vendor/local/include/freetype2/ftrender.h +3 -8
- data/vendor/local/include/freetype2/ftsizes.h +1 -1
- data/vendor/local/include/freetype2/ftsnames.h +1 -1
- data/vendor/local/include/freetype2/ftstroke.h +1 -1
- data/vendor/local/include/freetype2/ftsynth.h +5 -3
- data/vendor/local/include/freetype2/ftsystem.h +10 -1
- data/vendor/local/include/freetype2/fttrigon.h +1 -1
- data/vendor/local/include/freetype2/ftttdrv.h +85 -22
- data/vendor/local/include/freetype2/fttypes.h +1 -1
- data/vendor/local/include/freetype2/ftwinfnt.h +3 -3
- data/vendor/local/include/freetype2/t1tables.h +4 -3
- data/vendor/local/include/freetype2/ttnameid.h +116 -116
- data/vendor/local/include/freetype2/tttables.h +2 -2
- data/vendor/local/include/freetype2/tttags.h +1 -1
- data/vendor/local/include/freetype2/ttunpat.h +1 -1
- data/vendor/local/include/libpng16/png.h +63 -80
- data/vendor/local/include/libpng16/pngconf.h +8 -30
- data/vendor/local/include/libpng16/pnglibconf.h +10 -4
- data/vendor/local/include/png.h +63 -80
- data/vendor/local/include/pngconf.h +8 -30
- data/vendor/local/include/pnglibconf.h +10 -4
- data/vendor/local/lib/libcairo-gobject.a +0 -0
- data/vendor/local/lib/libcairo-gobject.dll.a +0 -0
- data/vendor/local/lib/libcairo-gobject.la +2 -2
- data/vendor/local/lib/libcairo-script-interpreter.a +0 -0
- data/vendor/local/lib/libcairo-script-interpreter.dll.a +0 -0
- data/vendor/local/lib/libcairo-script-interpreter.la +2 -2
- data/vendor/local/lib/libcairo.a +0 -0
- data/vendor/local/lib/libcairo.dll.a +0 -0
- data/vendor/local/lib/libcairo.la +2 -2
- data/vendor/local/lib/libfontconfig.dll.a +0 -0
- data/vendor/local/lib/libfreetype.a +0 -0
- data/vendor/local/lib/libfreetype.dll.a +0 -0
- data/vendor/local/lib/libfreetype.la +4 -4
- data/vendor/local/lib/libpixman-1.a +0 -0
- data/vendor/local/lib/libpixman-1.dll.a +0 -0
- data/vendor/local/lib/libpng.a +0 -0
- data/vendor/local/lib/libpng.dll.a +0 -0
- data/vendor/local/lib/libpng.la +4 -4
- data/vendor/local/lib/libpng16.a +0 -0
- data/vendor/local/lib/libpng16.dll.a +0 -0
- data/vendor/local/lib/libpng16.la +4 -4
- data/vendor/local/lib/libxml2.a +0 -0
- data/vendor/local/lib/libxml2.dll.a +0 -0
- data/vendor/local/lib/libz.a +0 -0
- data/vendor/local/lib/libz.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/cairo-fc.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-ft.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-gobject.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-pdf.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-png.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-ps.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-script.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-svg.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-win32-font.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-win32.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo.pc +1 -1
- data/vendor/local/lib/pkgconfig/freetype2.pc +1 -1
- data/vendor/local/lib/pkgconfig/libpng.pc +1 -1
- data/vendor/local/lib/pkgconfig/libpng16.pc +1 -1
- data/vendor/local/share/aclocal/freetype2.m4 +1 -1
- data/vendor/local/share/gtk-doc/html/cairo/bindings-errors.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-fonts.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-memory.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-overloading.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/bindings-path.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/bindings-patterns.html +35 -35
- data/vendor/local/share/gtk-doc/html/cairo/bindings-return-values.html +10 -10
- data/vendor/local/share/gtk-doc/html/cairo/bindings-streams.html +11 -11
- data/vendor/local/share/gtk-doc/html/cairo/bindings-surfaces.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Error-handling.html +294 -225
- data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +387 -269
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +432 -302
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html +325 -217
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html +298 -193
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html +1121 -812
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html +513 -383
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-(CGFont)-Fonts.html +126 -83
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-Surfaces.html +172 -119
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Raster-Sources.html +581 -372
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Recording-Surfaces.html +179 -130
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html +888 -539
- data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +287 -192
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Script-Surfaces.html +374 -231
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Transformations.html +395 -219
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Types.html +125 -75
- data/vendor/local/share/gtk-doc/html/cairo/cairo-User-Fonts.html +630 -464
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Version-Information.html +225 -200
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +336 -214
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +277 -186
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XCB-Surfaces.html +495 -350
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html +557 -362
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-XRender-Backend.html +158 -111
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html +655 -441
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +389 -280
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html +667 -451
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html +579 -351
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html +2006 -1545
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html +892 -618
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +1624 -1188
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-t.html +2903 -2104
- data/vendor/local/share/gtk-doc/html/cairo/cairo-drawing.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-fonts.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-support.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-surfaces.html +13 -13
- data/vendor/local/share/gtk-doc/html/cairo/cairo-text.html +1115 -758
- data/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp2 +419 -604
- data/vendor/local/share/gtk-doc/html/cairo/home.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/index-1.10.html +56 -56
- data/vendor/local/share/gtk-doc/html/cairo/index-1.12.html +70 -70
- data/vendor/local/share/gtk-doc/html/cairo/index-1.2.html +58 -58
- data/vendor/local/share/gtk-doc/html/cairo/index-1.4.html +39 -39
- data/vendor/local/share/gtk-doc/html/cairo/index-1.6.html +30 -30
- data/vendor/local/share/gtk-doc/html/cairo/index-1.8.html +38 -38
- data/vendor/local/share/gtk-doc/html/cairo/index-all.html +426 -426
- data/vendor/local/share/gtk-doc/html/cairo/index.html +6 -6
- data/vendor/local/share/gtk-doc/html/cairo/index.sgml +234 -325
- data/vendor/local/share/gtk-doc/html/cairo/language-bindings.html +12 -12
- data/vendor/local/share/gtk-doc/html/cairo/left-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/left.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/right-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/right.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/style.css +221 -26
- data/vendor/local/share/gtk-doc/html/cairo/up-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/cairo/up.png +0 -0
- data/vendor/local/share/license/cairo/README +1 -1
- data/vendor/local/share/license/freetype/README +6 -6
- data/vendor/local/share/license/freetype/README.git +1 -1
- data/vendor/local/share/license/libpng/README +2 -2
- data/vendor/local/share/man/man1/freetype-config.1 +1 -1
- data/vendor/local/share/man/man3/libpng.3 +85 -92
- data/vendor/local/share/man/man3/libpngpf.3 +2 -2
- data/vendor/local/share/man/man5/png.5 +1 -1
- metadata +23 -19
@@ -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>Raster Sources</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.
|
5
|
+
<title>Cairo: A Vector Graphics Library: Raster Sources</title>
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
|
7
7
|
<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
|
8
8
|
<link rel="up" href="cairo-drawing.html" title="Drawing">
|
9
9
|
<link rel="prev" href="cairo-text.html" title="text">
|
10
10
|
<link rel="next" href="cairo-fonts.html" title="Fonts">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
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="
|
16
|
-
<
|
17
|
-
<
|
18
|
-
<
|
19
|
-
<
|
20
|
-
|
21
|
-
<td><a accesskey="
|
22
|
-
|
23
|
-
<
|
24
|
-
<a href="
|
25
|
-
|
26
|
-
<a href="#cairo-Raster-Sources.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-Raster-Sources.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
19
|
+
<a href="#cairo-Raster-Sources.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
|
20
|
+
</td>
|
21
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
22
|
+
<td><a accesskey="u" href="cairo-drawing.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
23
|
+
<td><a accesskey="p" href="cairo-text.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
24
|
+
<td><a accesskey="n" href="cairo-fonts.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-Raster-Sources"></a><div class="titlepage"></div>
|
31
28
|
<div class="refnamediv"><table width="100%"><tr>
|
@@ -33,568 +30,780 @@
|
|
33
30
|
<h2><span class="refentrytitle"><a name="cairo-Raster-Sources.top_of_page"></a>Raster Sources</span></h2>
|
34
31
|
<p>Raster Sources — Supplying arbitrary image data</p>
|
35
32
|
</td>
|
36
|
-
<td valign="top" align="right"></td>
|
33
|
+
<td class="gallery_image" valign="top" align="right"></td>
|
37
34
|
</tr></table></div>
|
38
|
-
<div class="
|
39
|
-
<a name="cairo-Raster-Sources.
|
40
|
-
<
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
<
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
<
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
<
|
68
|
-
|
69
|
-
|
70
|
-
<
|
71
|
-
|
72
|
-
<
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
86
|
-
|
87
|
-
<
|
88
|
-
|
89
|
-
|
35
|
+
<div class="refsect1">
|
36
|
+
<a name="cairo-Raster-Sources.functions"></a><h2>Functions</h2>
|
37
|
+
<div class="informaltable"><table width="100%" border="0">
|
38
|
+
<colgroup>
|
39
|
+
<col width="150px" class="functions_return">
|
40
|
+
<col class="functions_name">
|
41
|
+
</colgroup>
|
42
|
+
<tbody>
|
43
|
+
<tr>
|
44
|
+
<td class="function_type">
|
45
|
+
<a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="returnvalue">cairo_pattern_t</span></a> *
|
46
|
+
</td>
|
47
|
+
<td class="function_name">
|
48
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-pattern-create-raster-source" title="cairo_pattern_create_raster_source ()">cairo_pattern_create_raster_source</a> <span class="c_punctuation">()</span>
|
49
|
+
</td>
|
50
|
+
</tr>
|
51
|
+
<tr>
|
52
|
+
<td class="function_type">
|
53
|
+
<span class="returnvalue">void</span>
|
54
|
+
</td>
|
55
|
+
<td class="function_name">
|
56
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-pattern-set-callback-data" title="cairo_raster_source_pattern_set_callback_data ()">cairo_raster_source_pattern_set_callback_data</a> <span class="c_punctuation">()</span>
|
57
|
+
</td>
|
58
|
+
</tr>
|
59
|
+
<tr>
|
60
|
+
<td class="function_type">
|
61
|
+
<span class="returnvalue">void</span> *
|
62
|
+
</td>
|
63
|
+
<td class="function_name">
|
64
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-pattern-get-callback-data" title="cairo_raster_source_pattern_get_callback_data ()">cairo_raster_source_pattern_get_callback_data</a> <span class="c_punctuation">()</span>
|
65
|
+
</td>
|
66
|
+
</tr>
|
67
|
+
<tr>
|
68
|
+
<td class="function_type">
|
69
|
+
<span class="returnvalue">void</span>
|
70
|
+
</td>
|
71
|
+
<td class="function_name">
|
72
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-pattern-set-acquire" title="cairo_raster_source_pattern_set_acquire ()">cairo_raster_source_pattern_set_acquire</a> <span class="c_punctuation">()</span>
|
73
|
+
</td>
|
74
|
+
</tr>
|
75
|
+
<tr>
|
76
|
+
<td class="function_type">
|
77
|
+
<span class="returnvalue">void</span>
|
78
|
+
</td>
|
79
|
+
<td class="function_name">
|
80
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-pattern-get-acquire" title="cairo_raster_source_pattern_get_acquire ()">cairo_raster_source_pattern_get_acquire</a> <span class="c_punctuation">()</span>
|
81
|
+
</td>
|
82
|
+
</tr>
|
83
|
+
<tr>
|
84
|
+
<td class="function_type">
|
85
|
+
<span class="returnvalue">void</span>
|
86
|
+
</td>
|
87
|
+
<td class="function_name">
|
88
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-pattern-set-snapshot" title="cairo_raster_source_pattern_set_snapshot ()">cairo_raster_source_pattern_set_snapshot</a> <span class="c_punctuation">()</span>
|
89
|
+
</td>
|
90
|
+
</tr>
|
91
|
+
<tr>
|
92
|
+
<td class="function_type">
|
93
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-snapshot-func-t" title="cairo_raster_source_snapshot_func_t ()"><span class="returnvalue">cairo_raster_source_snapshot_func_t</span></a>
|
94
|
+
</td>
|
95
|
+
<td class="function_name">
|
96
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-pattern-get-snapshot" title="cairo_raster_source_pattern_get_snapshot ()">cairo_raster_source_pattern_get_snapshot</a> <span class="c_punctuation">()</span>
|
97
|
+
</td>
|
98
|
+
</tr>
|
99
|
+
<tr>
|
100
|
+
<td class="function_type">
|
101
|
+
<span class="returnvalue">void</span>
|
102
|
+
</td>
|
103
|
+
<td class="function_name">
|
104
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-pattern-set-copy" title="cairo_raster_source_pattern_set_copy ()">cairo_raster_source_pattern_set_copy</a> <span class="c_punctuation">()</span>
|
105
|
+
</td>
|
106
|
+
</tr>
|
107
|
+
<tr>
|
108
|
+
<td class="function_type">
|
109
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-copy-func-t" title="cairo_raster_source_copy_func_t ()"><span class="returnvalue">cairo_raster_source_copy_func_t</span></a>
|
110
|
+
</td>
|
111
|
+
<td class="function_name">
|
112
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-pattern-get-copy" title="cairo_raster_source_pattern_get_copy ()">cairo_raster_source_pattern_get_copy</a> <span class="c_punctuation">()</span>
|
113
|
+
</td>
|
114
|
+
</tr>
|
115
|
+
<tr>
|
116
|
+
<td class="function_type">
|
117
|
+
<span class="returnvalue">void</span>
|
118
|
+
</td>
|
119
|
+
<td class="function_name">
|
120
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-pattern-set-finish" title="cairo_raster_source_pattern_set_finish ()">cairo_raster_source_pattern_set_finish</a> <span class="c_punctuation">()</span>
|
121
|
+
</td>
|
122
|
+
</tr>
|
123
|
+
<tr>
|
124
|
+
<td class="function_type">
|
125
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-finish-func-t" title="cairo_raster_source_finish_func_t ()"><span class="returnvalue">cairo_raster_source_finish_func_t</span></a>
|
126
|
+
</td>
|
127
|
+
<td class="function_name">
|
128
|
+
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-pattern-get-finish" title="cairo_raster_source_pattern_get_finish ()">cairo_raster_source_pattern_get_finish</a> <span class="c_punctuation">()</span>
|
129
|
+
</td>
|
130
|
+
</tr>
|
131
|
+
<tr>
|
132
|
+
<td class="function_type">
|
133
|
+
<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a>
|
134
|
+
</td>
|
135
|
+
<td class="function_name">
|
136
|
+
<span class="c_punctuation">(</span><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-acquire-func-t" title="cairo_raster_source_acquire_func_t ()">*cairo_raster_source_acquire_func_t</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
137
|
+
</td>
|
138
|
+
</tr>
|
139
|
+
<tr>
|
140
|
+
<td class="function_type">
|
141
|
+
<span class="returnvalue">void</span>
|
142
|
+
</td>
|
143
|
+
<td class="function_name">
|
144
|
+
<span class="c_punctuation">(</span><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-release-func-t" title="cairo_raster_source_release_func_t ()">*cairo_raster_source_release_func_t</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
145
|
+
</td>
|
146
|
+
</tr>
|
147
|
+
<tr>
|
148
|
+
<td class="function_type">
|
149
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
150
|
+
</td>
|
151
|
+
<td class="function_name">
|
152
|
+
<span class="c_punctuation">(</span><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-snapshot-func-t" title="cairo_raster_source_snapshot_func_t ()">*cairo_raster_source_snapshot_func_t</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
153
|
+
</td>
|
154
|
+
</tr>
|
155
|
+
<tr>
|
156
|
+
<td class="function_type">
|
157
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
158
|
+
</td>
|
159
|
+
<td class="function_name">
|
160
|
+
<span class="c_punctuation">(</span><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-copy-func-t" title="cairo_raster_source_copy_func_t ()">*cairo_raster_source_copy_func_t</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
161
|
+
</td>
|
162
|
+
</tr>
|
163
|
+
<tr>
|
164
|
+
<td class="function_type">
|
165
|
+
<span class="returnvalue">void</span>
|
166
|
+
</td>
|
167
|
+
<td class="function_name">
|
168
|
+
<span class="c_punctuation">(</span><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-finish-func-t" title="cairo_raster_source_finish_func_t ()">*cairo_raster_source_finish_func_t</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
169
|
+
</td>
|
170
|
+
</tr>
|
171
|
+
</tbody>
|
172
|
+
</table></div>
|
173
|
+
</div>
|
174
|
+
<div class="refsect1">
|
175
|
+
<a name="cairo-Raster-Sources.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
176
|
+
<pre class="screen">
|
90
177
|
</pre>
|
91
178
|
</div>
|
92
179
|
<div class="refsect1">
|
93
180
|
<a name="cairo-Raster-Sources.description"></a><h2>Description</h2>
|
94
|
-
<p>
|
95
|
-
The raster source provides the ability to supply arbitrary pixel data
|
181
|
+
<p>The raster source provides the ability to supply arbitrary pixel data
|
96
182
|
whilst rendering. The pixels are queried at the time of rasterisation
|
97
183
|
by means of user callback functions, allowing for the ultimate
|
98
184
|
flexibility. For example, in handling compressed image sources, you
|
99
185
|
may keep a MRU cache of decompressed images and decompress sources on the
|
100
|
-
fly and discard old ones to conserve memory
|
101
|
-
|
102
|
-
<p>
|
103
|
-
For the raster source to be effective, you must at least specify
|
186
|
+
fly and discard old ones to conserve memory.</p>
|
187
|
+
<p>For the raster source to be effective, you must at least specify
|
104
188
|
the acquire and release callbacks which are used to retrieve the pixel
|
105
189
|
data for the region of interest and demark when it can be freed afterwards.
|
106
190
|
Other callbacks are provided for when the pattern is copied temporarily
|
107
191
|
during rasterisation, or more permanently as a snapshot in order to keep
|
108
|
-
the pixel data available for printing
|
109
|
-
</p>
|
192
|
+
the pixel data available for printing.</p>
|
110
193
|
</div>
|
111
194
|
<div class="refsect1">
|
112
|
-
<a name="cairo-Raster-Sources.
|
195
|
+
<a name="cairo-Raster-Sources.functions_details"></a><h2>Functions</h2>
|
113
196
|
<div class="refsect2">
|
114
|
-
<a name="cairo-pattern-create-raster-source"></a><h3>cairo_pattern_create_raster_source
|
115
|
-
<pre class="programlisting"><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="returnvalue">cairo_pattern_t</span></a>
|
116
|
-
|
117
|
-
|
118
|
-
|
119
|
-
<
|
120
|
-
Creates a new user pattern for providing pixel data
|
121
|
-
|
122
|
-
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
<
|
127
|
-
<col
|
197
|
+
<a name="cairo-pattern-create-raster-source"></a><h3>cairo_pattern_create_raster_source ()</h3>
|
198
|
+
<pre class="programlisting"><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="returnvalue">cairo_pattern_t</span></a> *
|
199
|
+
cairo_pattern_create_raster_source (<em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
|
200
|
+
<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-content-t" title="enum cairo_content_t"><span class="type">cairo_content_t</span></a> content</code></em>,
|
201
|
+
<em class="parameter"><code><span class="type">int</span> width</code></em>,
|
202
|
+
<em class="parameter"><code><span class="type">int</span> height</code></em>);</pre>
|
203
|
+
<p>Creates a new user pattern for providing pixel data.</p>
|
204
|
+
<p>Use the setter functions to associate callbacks with the returned
|
205
|
+
pattern. The only mandatory callback is acquire.</p>
|
206
|
+
<div class="refsect3">
|
207
|
+
<a name="id-1.3.8.6.2.6"></a><h4>Parameters</h4>
|
208
|
+
<div class="informaltable"><table width="100%" border="0">
|
209
|
+
<colgroup>
|
210
|
+
<col width="150px" class="parameters_name">
|
211
|
+
<col class="parameters_description">
|
212
|
+
<col width="200px" class="parameters_annotations">
|
213
|
+
</colgroup>
|
128
214
|
<tbody>
|
129
215
|
<tr>
|
130
|
-
<td
|
131
|
-
<td>the user data to be passed to all callbacks</td>
|
216
|
+
<td class="parameter_name"><p>user_data</p></td>
|
217
|
+
<td class="parameter_description"><p>the user data to be passed to all callbacks</p></td>
|
218
|
+
<td class="parameter_annotations"> </td>
|
132
219
|
</tr>
|
133
220
|
<tr>
|
134
|
-
<td
|
135
|
-
<td>content type for the pixel data that will be returned. Knowing
|
221
|
+
<td class="parameter_name"><p>content</p></td>
|
222
|
+
<td class="parameter_description"><p>content type for the pixel data that will be returned. Knowing
|
136
223
|
the content type ahead of time is used for analysing the operation and
|
137
|
-
picking the appropriate rendering path.</td>
|
138
|
-
</
|
139
|
-
<tr>
|
140
|
-
<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
|
141
|
-
<td>maximum size of the sample area</td>
|
224
|
+
picking the appropriate rendering path.</p></td>
|
225
|
+
<td class="parameter_annotations"> </td>
|
142
226
|
</tr>
|
143
227
|
<tr>
|
144
|
-
<td
|
145
|
-
<td>maximum size of the sample area</td>
|
228
|
+
<td class="parameter_name"><p>width</p></td>
|
229
|
+
<td class="parameter_description"><p>maximum size of the sample area</p></td>
|
230
|
+
<td class="parameter_annotations"> </td>
|
146
231
|
</tr>
|
147
232
|
<tr>
|
148
|
-
<td
|
149
|
-
<td
|
150
|
-
<
|
233
|
+
<td class="parameter_name"><p>height</p></td>
|
234
|
+
<td class="parameter_description"><p>maximum size of the sample area</p></td>
|
235
|
+
<td class="parameter_annotations"> </td>
|
151
236
|
</tr>
|
152
237
|
</tbody>
|
153
238
|
</table></div>
|
239
|
+
</div>
|
240
|
+
<div class="refsect3">
|
241
|
+
<a name="id-1.3.8.6.2.7"></a><h4>Returns</h4>
|
242
|
+
<p> a newly created <a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>. Free with
|
243
|
+
<a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-destroy" title="cairo_pattern_destroy ()"><code class="function">cairo_pattern_destroy()</code></a> when you are done using it.</p>
|
244
|
+
<p></p>
|
245
|
+
</div>
|
154
246
|
<p class="since">Since 1.12</p>
|
155
247
|
</div>
|
156
248
|
<hr>
|
157
249
|
<div class="refsect2">
|
158
|
-
<a name="cairo-raster-source-pattern-set-callback-data"></a><h3>cairo_raster_source_pattern_set_callback_data
|
159
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
160
|
-
|
161
|
-
|
162
|
-
<
|
163
|
-
Updates the user data that is provided to all callbacks
|
164
|
-
|
165
|
-
<
|
166
|
-
<
|
250
|
+
<a name="cairo-raster-source-pattern-set-callback-data"></a><h3>cairo_raster_source_pattern_set_callback_data ()</h3>
|
251
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
252
|
+
cairo_raster_source_pattern_set_callback_data
|
253
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
254
|
+
<em class="parameter"><code><span class="type">void</span> *data</code></em>);</pre>
|
255
|
+
<p>Updates the user data that is provided to all callbacks.</p>
|
256
|
+
<div class="refsect3">
|
257
|
+
<a name="id-1.3.8.6.3.5"></a><h4>Parameters</h4>
|
258
|
+
<div class="informaltable"><table width="100%" border="0">
|
259
|
+
<colgroup>
|
260
|
+
<col width="150px" class="parameters_name">
|
261
|
+
<col class="parameters_description">
|
262
|
+
<col width="200px" class="parameters_annotations">
|
263
|
+
</colgroup>
|
167
264
|
<tbody>
|
168
265
|
<tr>
|
169
|
-
<td
|
170
|
-
<td>the pattern to update</td>
|
266
|
+
<td class="parameter_name"><p>pattern</p></td>
|
267
|
+
<td class="parameter_description"><p>the pattern to update</p></td>
|
268
|
+
<td class="parameter_annotations"> </td>
|
171
269
|
</tr>
|
172
270
|
<tr>
|
173
|
-
<td
|
174
|
-
<td>the user data to be passed to all callbacks</td>
|
271
|
+
<td class="parameter_name"><p>data</p></td>
|
272
|
+
<td class="parameter_description"><p>the user data to be passed to all callbacks</p></td>
|
273
|
+
<td class="parameter_annotations"> </td>
|
175
274
|
</tr>
|
176
275
|
</tbody>
|
177
276
|
</table></div>
|
277
|
+
</div>
|
178
278
|
<p class="since">Since 1.12</p>
|
179
279
|
</div>
|
180
280
|
<hr>
|
181
281
|
<div class="refsect2">
|
182
|
-
<a name="cairo-raster-source-pattern-get-callback-data"></a><h3>cairo_raster_source_pattern_get_callback_data
|
183
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
184
|
-
|
185
|
-
<
|
186
|
-
Queries the current user data
|
187
|
-
|
188
|
-
<
|
189
|
-
<
|
190
|
-
<
|
191
|
-
<
|
192
|
-
<
|
193
|
-
<
|
194
|
-
</
|
195
|
-
<tr>
|
196
|
-
<td
|
197
|
-
<td>the
|
198
|
-
</
|
199
|
-
</tbody>
|
282
|
+
<a name="cairo-raster-source-pattern-get-callback-data"></a><h3>cairo_raster_source_pattern_get_callback_data ()</h3>
|
283
|
+
<pre class="programlisting"><span class="returnvalue">void</span> *
|
284
|
+
cairo_raster_source_pattern_get_callback_data
|
285
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>);</pre>
|
286
|
+
<p>Queries the current user data.</p>
|
287
|
+
<div class="refsect3">
|
288
|
+
<a name="id-1.3.8.6.4.5"></a><h4>Parameters</h4>
|
289
|
+
<div class="informaltable"><table width="100%" border="0">
|
290
|
+
<colgroup>
|
291
|
+
<col width="150px" class="parameters_name">
|
292
|
+
<col class="parameters_description">
|
293
|
+
<col width="200px" class="parameters_annotations">
|
294
|
+
</colgroup>
|
295
|
+
<tbody><tr>
|
296
|
+
<td class="parameter_name"><p>pattern</p></td>
|
297
|
+
<td class="parameter_description"><p>the pattern to update</p></td>
|
298
|
+
<td class="parameter_annotations"> </td>
|
299
|
+
</tr></tbody>
|
200
300
|
</table></div>
|
301
|
+
</div>
|
302
|
+
<div class="refsect3">
|
303
|
+
<a name="id-1.3.8.6.4.6"></a><h4>Returns</h4>
|
304
|
+
<p> the current user-data passed to each callback</p>
|
305
|
+
<p></p>
|
306
|
+
</div>
|
201
307
|
<p class="since">Since 1.12</p>
|
202
308
|
</div>
|
203
309
|
<hr>
|
204
310
|
<div class="refsect2">
|
205
|
-
<a name="cairo-raster-source-pattern-set-acquire"></a><h3>cairo_raster_source_pattern_set_acquire
|
206
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
207
|
-
|
208
|
-
|
209
|
-
|
210
|
-
<
|
211
|
-
Specifies the callbacks used to generate the image surface for a rendering
|
212
|
-
operation (acquire) and the function used to cleanup that surface afterwards
|
213
|
-
|
214
|
-
|
215
|
-
The <em class="parameter"><code>acquire</code></em> callback should create a surface (preferably an image
|
311
|
+
<a name="cairo-raster-source-pattern-set-acquire"></a><h3>cairo_raster_source_pattern_set_acquire ()</h3>
|
312
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
313
|
+
cairo_raster_source_pattern_set_acquire
|
314
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
315
|
+
<em class="parameter"><code><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-acquire-func-t" title="cairo_raster_source_acquire_func_t ()"><span class="type">cairo_raster_source_acquire_func_t</span></a> acquire</code></em>,
|
316
|
+
<em class="parameter"><code><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-release-func-t" title="cairo_raster_source_release_func_t ()"><span class="type">cairo_raster_source_release_func_t</span></a> release</code></em>);</pre>
|
317
|
+
<p>Specifies the callbacks used to generate the image surface for a rendering
|
318
|
+
operation (acquire) and the function used to cleanup that surface afterwards.</p>
|
319
|
+
<p>The <em class="parameter"><code>acquire</code></em>
|
320
|
+
callback should create a surface (preferably an image
|
216
321
|
surface created to match the target using
|
217
|
-
<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-create-similar-image" title="cairo_surface_create_similar_image
|
322
|
+
<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-create-similar-image" title="cairo_surface_create_similar_image ()"><code class="function">cairo_surface_create_similar_image()</code></a>) that defines at least the region
|
218
323
|
of interest specified by extents. The surface is allowed to be the entire
|
219
324
|
sample area, but if it does contain a subsection of the sample area,
|
220
325
|
the surface extents should be provided by setting the device offset (along
|
221
|
-
with its width and height) using <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-set-device-offset" title="cairo_surface_set_device_offset
|
222
|
-
|
223
|
-
<
|
224
|
-
<
|
326
|
+
with its width and height) using <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-set-device-offset" title="cairo_surface_set_device_offset ()"><code class="function">cairo_surface_set_device_offset()</code></a>.</p>
|
327
|
+
<div class="refsect3">
|
328
|
+
<a name="id-1.3.8.6.5.6"></a><h4>Parameters</h4>
|
329
|
+
<div class="informaltable"><table width="100%" border="0">
|
330
|
+
<colgroup>
|
331
|
+
<col width="150px" class="parameters_name">
|
332
|
+
<col class="parameters_description">
|
333
|
+
<col width="200px" class="parameters_annotations">
|
334
|
+
</colgroup>
|
225
335
|
<tbody>
|
226
336
|
<tr>
|
227
|
-
<td
|
228
|
-
<td>the pattern to update</td>
|
337
|
+
<td class="parameter_name"><p>pattern</p></td>
|
338
|
+
<td class="parameter_description"><p>the pattern to update</p></td>
|
339
|
+
<td class="parameter_annotations"> </td>
|
229
340
|
</tr>
|
230
341
|
<tr>
|
231
|
-
<td
|
232
|
-
<td>acquire callback</td>
|
342
|
+
<td class="parameter_name"><p>acquire</p></td>
|
343
|
+
<td class="parameter_description"><p>acquire callback</p></td>
|
344
|
+
<td class="parameter_annotations"> </td>
|
233
345
|
</tr>
|
234
346
|
<tr>
|
235
|
-
<td
|
236
|
-
<td>release callback</td>
|
347
|
+
<td class="parameter_name"><p>release</p></td>
|
348
|
+
<td class="parameter_description"><p>release callback</p></td>
|
349
|
+
<td class="parameter_annotations"> </td>
|
237
350
|
</tr>
|
238
351
|
</tbody>
|
239
352
|
</table></div>
|
353
|
+
</div>
|
240
354
|
<p class="since">Since 1.12</p>
|
241
355
|
</div>
|
242
356
|
<hr>
|
243
357
|
<div class="refsect2">
|
244
|
-
<a name="cairo-raster-source-pattern-get-acquire"></a><h3>cairo_raster_source_pattern_get_acquire
|
245
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
246
|
-
|
247
|
-
|
248
|
-
|
249
|
-
<
|
250
|
-
Queries the current acquire and release callbacks
|
251
|
-
|
252
|
-
<
|
253
|
-
<
|
358
|
+
<a name="cairo-raster-source-pattern-get-acquire"></a><h3>cairo_raster_source_pattern_get_acquire ()</h3>
|
359
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
360
|
+
cairo_raster_source_pattern_get_acquire
|
361
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
362
|
+
<em class="parameter"><code><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-acquire-func-t" title="cairo_raster_source_acquire_func_t ()"><span class="type">cairo_raster_source_acquire_func_t</span></a> *acquire</code></em>,
|
363
|
+
<em class="parameter"><code><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-release-func-t" title="cairo_raster_source_release_func_t ()"><span class="type">cairo_raster_source_release_func_t</span></a> *release</code></em>);</pre>
|
364
|
+
<p>Queries the current acquire and release callbacks.</p>
|
365
|
+
<div class="refsect3">
|
366
|
+
<a name="id-1.3.8.6.6.5"></a><h4>Parameters</h4>
|
367
|
+
<div class="informaltable"><table width="100%" border="0">
|
368
|
+
<colgroup>
|
369
|
+
<col width="150px" class="parameters_name">
|
370
|
+
<col class="parameters_description">
|
371
|
+
<col width="200px" class="parameters_annotations">
|
372
|
+
</colgroup>
|
254
373
|
<tbody>
|
255
374
|
<tr>
|
256
|
-
<td
|
257
|
-
<td>the pattern to query</td>
|
375
|
+
<td class="parameter_name"><p>pattern</p></td>
|
376
|
+
<td class="parameter_description"><p>the pattern to query</p></td>
|
377
|
+
<td class="parameter_annotations"> </td>
|
258
378
|
</tr>
|
259
379
|
<tr>
|
260
|
-
<td
|
261
|
-
<td>return value for the current acquire callback</td>
|
380
|
+
<td class="parameter_name"><p>acquire</p></td>
|
381
|
+
<td class="parameter_description"><p>return value for the current acquire callback</p></td>
|
382
|
+
<td class="parameter_annotations"> </td>
|
262
383
|
</tr>
|
263
384
|
<tr>
|
264
|
-
<td
|
265
|
-
<td>return value for the current release callback</td>
|
385
|
+
<td class="parameter_name"><p>release</p></td>
|
386
|
+
<td class="parameter_description"><p>return value for the current release callback</p></td>
|
387
|
+
<td class="parameter_annotations"> </td>
|
266
388
|
</tr>
|
267
389
|
</tbody>
|
268
390
|
</table></div>
|
391
|
+
</div>
|
269
392
|
<p class="since">Since 1.12</p>
|
270
393
|
</div>
|
271
394
|
<hr>
|
272
395
|
<div class="refsect2">
|
273
|
-
<a name="cairo-raster-source-pattern-set-snapshot"></a><h3>cairo_raster_source_pattern_set_snapshot
|
274
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
275
|
-
|
276
|
-
|
277
|
-
<
|
278
|
-
Sets the callback that will be used whenever a snapshot is taken of the
|
396
|
+
<a name="cairo-raster-source-pattern-set-snapshot"></a><h3>cairo_raster_source_pattern_set_snapshot ()</h3>
|
397
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
398
|
+
cairo_raster_source_pattern_set_snapshot
|
399
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
400
|
+
<em class="parameter"><code><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-snapshot-func-t" title="cairo_raster_source_snapshot_func_t ()"><span class="type">cairo_raster_source_snapshot_func_t</span></a> snapshot</code></em>);</pre>
|
401
|
+
<p>Sets the callback that will be used whenever a snapshot is taken of the
|
279
402
|
pattern, that is whenever the current contents of the pattern should be
|
280
|
-
preserved for later use. This is typically invoked whilst printing
|
281
|
-
|
282
|
-
<
|
283
|
-
<
|
403
|
+
preserved for later use. This is typically invoked whilst printing.</p>
|
404
|
+
<div class="refsect3">
|
405
|
+
<a name="id-1.3.8.6.7.5"></a><h4>Parameters</h4>
|
406
|
+
<div class="informaltable"><table width="100%" border="0">
|
407
|
+
<colgroup>
|
408
|
+
<col width="150px" class="parameters_name">
|
409
|
+
<col class="parameters_description">
|
410
|
+
<col width="200px" class="parameters_annotations">
|
411
|
+
</colgroup>
|
284
412
|
<tbody>
|
285
413
|
<tr>
|
286
|
-
<td
|
287
|
-
<td>the pattern to update</td>
|
414
|
+
<td class="parameter_name"><p>pattern</p></td>
|
415
|
+
<td class="parameter_description"><p>the pattern to update</p></td>
|
416
|
+
<td class="parameter_annotations"> </td>
|
288
417
|
</tr>
|
289
418
|
<tr>
|
290
|
-
<td
|
291
|
-
<td>snapshot callback</td>
|
419
|
+
<td class="parameter_name"><p>snapshot</p></td>
|
420
|
+
<td class="parameter_description"><p>snapshot callback</p></td>
|
421
|
+
<td class="parameter_annotations"> </td>
|
292
422
|
</tr>
|
293
423
|
</tbody>
|
294
424
|
</table></div>
|
425
|
+
</div>
|
295
426
|
<p class="since">Since 1.12</p>
|
296
427
|
</div>
|
297
428
|
<hr>
|
298
429
|
<div class="refsect2">
|
299
|
-
<a name="cairo-raster-source-pattern-get-snapshot"></a><h3>cairo_raster_source_pattern_get_snapshot
|
300
|
-
<pre class="programlisting"><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-snapshot-func-t" title="cairo_raster_source_snapshot_func_t
|
301
|
-
|
302
|
-
<
|
303
|
-
Queries the current snapshot callback
|
304
|
-
|
305
|
-
<
|
306
|
-
<
|
307
|
-
<
|
308
|
-
<
|
309
|
-
<
|
310
|
-
<
|
311
|
-
</
|
312
|
-
<tr>
|
313
|
-
<td
|
314
|
-
<td>the
|
315
|
-
</
|
316
|
-
</tbody>
|
430
|
+
<a name="cairo-raster-source-pattern-get-snapshot"></a><h3>cairo_raster_source_pattern_get_snapshot ()</h3>
|
431
|
+
<pre class="programlisting"><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-snapshot-func-t" title="cairo_raster_source_snapshot_func_t ()"><span class="returnvalue">cairo_raster_source_snapshot_func_t</span></a>
|
432
|
+
cairo_raster_source_pattern_get_snapshot
|
433
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>);</pre>
|
434
|
+
<p>Queries the current snapshot callback.</p>
|
435
|
+
<div class="refsect3">
|
436
|
+
<a name="id-1.3.8.6.8.5"></a><h4>Parameters</h4>
|
437
|
+
<div class="informaltable"><table width="100%" border="0">
|
438
|
+
<colgroup>
|
439
|
+
<col width="150px" class="parameters_name">
|
440
|
+
<col class="parameters_description">
|
441
|
+
<col width="200px" class="parameters_annotations">
|
442
|
+
</colgroup>
|
443
|
+
<tbody><tr>
|
444
|
+
<td class="parameter_name"><p>pattern</p></td>
|
445
|
+
<td class="parameter_description"><p>the pattern to query</p></td>
|
446
|
+
<td class="parameter_annotations"> </td>
|
447
|
+
</tr></tbody>
|
317
448
|
</table></div>
|
449
|
+
</div>
|
450
|
+
<div class="refsect3">
|
451
|
+
<a name="id-1.3.8.6.8.6"></a><h4>Returns</h4>
|
452
|
+
<p> the current snapshot callback</p>
|
453
|
+
<p></p>
|
454
|
+
</div>
|
318
455
|
<p class="since">Since 1.12</p>
|
319
456
|
</div>
|
320
457
|
<hr>
|
321
458
|
<div class="refsect2">
|
322
|
-
<a name="cairo-raster-source-pattern-set-copy"></a><h3>cairo_raster_source_pattern_set_copy
|
323
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
324
|
-
|
325
|
-
|
326
|
-
<p>
|
327
|
-
|
328
|
-
|
329
|
-
</
|
330
|
-
<div class="
|
331
|
-
<
|
459
|
+
<a name="cairo-raster-source-pattern-set-copy"></a><h3>cairo_raster_source_pattern_set_copy ()</h3>
|
460
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
461
|
+
cairo_raster_source_pattern_set_copy (<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
462
|
+
<em class="parameter"><code><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-copy-func-t" title="cairo_raster_source_copy_func_t ()"><span class="type">cairo_raster_source_copy_func_t</span></a> copy</code></em>);</pre>
|
463
|
+
<p>Updates the copy callback which is used whenever a temporary copy of the
|
464
|
+
pattern is taken.</p>
|
465
|
+
<div class="refsect3">
|
466
|
+
<a name="id-1.3.8.6.9.5"></a><h4>Parameters</h4>
|
467
|
+
<div class="informaltable"><table width="100%" border="0">
|
468
|
+
<colgroup>
|
469
|
+
<col width="150px" class="parameters_name">
|
470
|
+
<col class="parameters_description">
|
471
|
+
<col width="200px" class="parameters_annotations">
|
472
|
+
</colgroup>
|
332
473
|
<tbody>
|
333
474
|
<tr>
|
334
|
-
<td
|
335
|
-
<td>the pattern to update</td>
|
475
|
+
<td class="parameter_name"><p>pattern</p></td>
|
476
|
+
<td class="parameter_description"><p>the pattern to update</p></td>
|
477
|
+
<td class="parameter_annotations"> </td>
|
336
478
|
</tr>
|
337
479
|
<tr>
|
338
|
-
<td
|
339
|
-
<td>the copy callback</td>
|
480
|
+
<td class="parameter_name"><p>copy</p></td>
|
481
|
+
<td class="parameter_description"><p>the copy callback</p></td>
|
482
|
+
<td class="parameter_annotations"> </td>
|
340
483
|
</tr>
|
341
484
|
</tbody>
|
342
485
|
</table></div>
|
486
|
+
</div>
|
343
487
|
<p class="since">Since 1.12</p>
|
344
488
|
</div>
|
345
489
|
<hr>
|
346
490
|
<div class="refsect2">
|
347
|
-
<a name="cairo-raster-source-pattern-get-copy"></a><h3>cairo_raster_source_pattern_get_copy
|
348
|
-
<pre class="programlisting"><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-copy-func-t" title="cairo_raster_source_copy_func_t
|
349
|
-
|
350
|
-
<p>
|
351
|
-
|
352
|
-
</
|
353
|
-
<div class="
|
354
|
-
<
|
355
|
-
<
|
356
|
-
<
|
357
|
-
<
|
358
|
-
|
359
|
-
|
360
|
-
<
|
361
|
-
<td
|
362
|
-
<td>
|
363
|
-
</tr>
|
364
|
-
</tbody>
|
491
|
+
<a name="cairo-raster-source-pattern-get-copy"></a><h3>cairo_raster_source_pattern_get_copy ()</h3>
|
492
|
+
<pre class="programlisting"><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-copy-func-t" title="cairo_raster_source_copy_func_t ()"><span class="returnvalue">cairo_raster_source_copy_func_t</span></a>
|
493
|
+
cairo_raster_source_pattern_get_copy (<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>);</pre>
|
494
|
+
<p>Queries the current copy callback.</p>
|
495
|
+
<div class="refsect3">
|
496
|
+
<a name="id-1.3.8.6.10.5"></a><h4>Parameters</h4>
|
497
|
+
<div class="informaltable"><table width="100%" border="0">
|
498
|
+
<colgroup>
|
499
|
+
<col width="150px" class="parameters_name">
|
500
|
+
<col class="parameters_description">
|
501
|
+
<col width="200px" class="parameters_annotations">
|
502
|
+
</colgroup>
|
503
|
+
<tbody><tr>
|
504
|
+
<td class="parameter_name"><p>pattern</p></td>
|
505
|
+
<td class="parameter_description"><p>the pattern to query</p></td>
|
506
|
+
<td class="parameter_annotations"> </td>
|
507
|
+
</tr></tbody>
|
365
508
|
</table></div>
|
509
|
+
</div>
|
510
|
+
<div class="refsect3">
|
511
|
+
<a name="id-1.3.8.6.10.6"></a><h4>Returns</h4>
|
512
|
+
<p> the current copy callback</p>
|
513
|
+
<p></p>
|
514
|
+
</div>
|
366
515
|
<p class="since">Since 1.12</p>
|
367
516
|
</div>
|
368
517
|
<hr>
|
369
518
|
<div class="refsect2">
|
370
|
-
<a name="cairo-raster-source-pattern-set-finish"></a><h3>cairo_raster_source_pattern_set_finish
|
371
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
372
|
-
|
373
|
-
|
374
|
-
<
|
375
|
-
Updates the finish callback which is used whenever a pattern (or a copy
|
376
|
-
thereof) will no longer be used
|
377
|
-
|
378
|
-
<
|
379
|
-
<
|
519
|
+
<a name="cairo-raster-source-pattern-set-finish"></a><h3>cairo_raster_source_pattern_set_finish ()</h3>
|
520
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
521
|
+
cairo_raster_source_pattern_set_finish
|
522
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
523
|
+
<em class="parameter"><code><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-finish-func-t" title="cairo_raster_source_finish_func_t ()"><span class="type">cairo_raster_source_finish_func_t</span></a> finish</code></em>);</pre>
|
524
|
+
<p>Updates the finish callback which is used whenever a pattern (or a copy
|
525
|
+
thereof) will no longer be used.</p>
|
526
|
+
<div class="refsect3">
|
527
|
+
<a name="id-1.3.8.6.11.5"></a><h4>Parameters</h4>
|
528
|
+
<div class="informaltable"><table width="100%" border="0">
|
529
|
+
<colgroup>
|
530
|
+
<col width="150px" class="parameters_name">
|
531
|
+
<col class="parameters_description">
|
532
|
+
<col width="200px" class="parameters_annotations">
|
533
|
+
</colgroup>
|
380
534
|
<tbody>
|
381
535
|
<tr>
|
382
|
-
<td
|
383
|
-
<td>the pattern to update</td>
|
536
|
+
<td class="parameter_name"><p>pattern</p></td>
|
537
|
+
<td class="parameter_description"><p>the pattern to update</p></td>
|
538
|
+
<td class="parameter_annotations"> </td>
|
384
539
|
</tr>
|
385
540
|
<tr>
|
386
|
-
<td
|
387
|
-
<td>the finish callback</td>
|
541
|
+
<td class="parameter_name"><p>finish</p></td>
|
542
|
+
<td class="parameter_description"><p>the finish callback</p></td>
|
543
|
+
<td class="parameter_annotations"> </td>
|
388
544
|
</tr>
|
389
545
|
</tbody>
|
390
546
|
</table></div>
|
547
|
+
</div>
|
391
548
|
<p class="since">Since 1.12</p>
|
392
549
|
</div>
|
393
550
|
<hr>
|
394
551
|
<div class="refsect2">
|
395
|
-
<a name="cairo-raster-source-pattern-get-finish"></a><h3>cairo_raster_source_pattern_get_finish
|
396
|
-
<pre class="programlisting"><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-finish-func-t" title="cairo_raster_source_finish_func_t
|
397
|
-
|
398
|
-
<
|
399
|
-
Queries the current finish callback
|
400
|
-
|
401
|
-
<
|
402
|
-
<
|
403
|
-
<
|
404
|
-
<
|
405
|
-
<
|
406
|
-
<
|
407
|
-
</
|
408
|
-
<tr>
|
409
|
-
<td
|
410
|
-
<td>the
|
411
|
-
</
|
412
|
-
</tbody>
|
552
|
+
<a name="cairo-raster-source-pattern-get-finish"></a><h3>cairo_raster_source_pattern_get_finish ()</h3>
|
553
|
+
<pre class="programlisting"><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-finish-func-t" title="cairo_raster_source_finish_func_t ()"><span class="returnvalue">cairo_raster_source_finish_func_t</span></a>
|
554
|
+
cairo_raster_source_pattern_get_finish
|
555
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>);</pre>
|
556
|
+
<p>Queries the current finish callback.</p>
|
557
|
+
<div class="refsect3">
|
558
|
+
<a name="id-1.3.8.6.12.5"></a><h4>Parameters</h4>
|
559
|
+
<div class="informaltable"><table width="100%" border="0">
|
560
|
+
<colgroup>
|
561
|
+
<col width="150px" class="parameters_name">
|
562
|
+
<col class="parameters_description">
|
563
|
+
<col width="200px" class="parameters_annotations">
|
564
|
+
</colgroup>
|
565
|
+
<tbody><tr>
|
566
|
+
<td class="parameter_name"><p>pattern</p></td>
|
567
|
+
<td class="parameter_description"><p>the pattern to query</p></td>
|
568
|
+
<td class="parameter_annotations"> </td>
|
569
|
+
</tr></tbody>
|
413
570
|
</table></div>
|
571
|
+
</div>
|
572
|
+
<div class="refsect3">
|
573
|
+
<a name="id-1.3.8.6.12.6"></a><h4>Returns</h4>
|
574
|
+
<p> the current finish callback</p>
|
575
|
+
<p></p>
|
576
|
+
</div>
|
414
577
|
<p class="since">Since 1.12</p>
|
415
578
|
</div>
|
416
579
|
<hr>
|
417
580
|
<div class="refsect2">
|
418
|
-
<a name="cairo-raster-source-acquire-func-t"></a><h3>cairo_raster_source_acquire_func_t
|
419
|
-
<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>
|
420
|
-
|
421
|
-
|
422
|
-
|
423
|
-
|
424
|
-
<p>
|
425
|
-
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-acquire-func-t" title="cairo_raster_source_acquire_func_t ()"><span class="type">cairo_raster_source_acquire_func_t</span></a> is the type of function which is
|
581
|
+
<a name="cairo-raster-source-acquire-func-t"></a><h3>cairo_raster_source_acquire_func_t ()</h3>
|
582
|
+
<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>
|
583
|
+
<span class="c_punctuation">(</span>*cairo_raster_source_acquire_func_t<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
584
|
+
<em class="parameter"><code><span class="type">void</span> *callback_data</code></em>,
|
585
|
+
<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> *target</code></em>,
|
586
|
+
<em class="parameter"><code>const <a class="link" href="cairo-Types.html#cairo-rectangle-int-t" title="cairo_rectangle_int_t"><span class="type">cairo_rectangle_int_t</span></a> *extents</code></em>);</pre>
|
587
|
+
<p><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-acquire-func-t" title="cairo_raster_source_acquire_func_t ()"><span class="type">cairo_raster_source_acquire_func_t</span></a> is the type of function which is
|
426
588
|
called when a pattern is being rendered from. It should create a surface
|
427
589
|
that provides the pixel data for the region of interest as defined by
|
428
590
|
extents, though the surface itself does not have to be limited to that
|
429
591
|
area. For convenience the surface should probably be of image type,
|
430
|
-
created with <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-create-similar-image" title="cairo_surface_create_similar_image
|
592
|
+
created with <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-create-similar-image" title="cairo_surface_create_similar_image ()"><code class="function">cairo_surface_create_similar_image()</code></a> for the target (which
|
431
593
|
enables the number of copies to be reduced during transfer to the
|
432
594
|
device). Another option, might be to return a similar surface to the
|
433
595
|
target for explicit handling by the application of a set of cached sources
|
434
596
|
on the device. The region of sample data provided should be defined using
|
435
|
-
<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-set-device-offset" title="cairo_surface_set_device_offset
|
436
|
-
sample data (along with width and height of the surface)
|
437
|
-
|
438
|
-
<
|
439
|
-
<
|
597
|
+
<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-set-device-offset" title="cairo_surface_set_device_offset ()"><code class="function">cairo_surface_set_device_offset()</code></a> to specify the top-left corner of the
|
598
|
+
sample data (along with width and height of the surface).</p>
|
599
|
+
<div class="refsect3">
|
600
|
+
<a name="id-1.3.8.6.13.5"></a><h4>Parameters</h4>
|
601
|
+
<div class="informaltable"><table width="100%" border="0">
|
602
|
+
<colgroup>
|
603
|
+
<col width="150px" class="parameters_name">
|
604
|
+
<col class="parameters_description">
|
605
|
+
<col width="200px" class="parameters_annotations">
|
606
|
+
</colgroup>
|
440
607
|
<tbody>
|
441
608
|
<tr>
|
442
|
-
<td
|
443
|
-
<td>the pattern being rendered from</td>
|
444
|
-
</
|
445
|
-
<tr>
|
446
|
-
<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
|
447
|
-
<td>the user data supplied during creation</td>
|
609
|
+
<td class="parameter_name"><p>pattern</p></td>
|
610
|
+
<td class="parameter_description"><p>the pattern being rendered from</p></td>
|
611
|
+
<td class="parameter_annotations"> </td>
|
448
612
|
</tr>
|
449
613
|
<tr>
|
450
|
-
<td
|
451
|
-
<td>the
|
614
|
+
<td class="parameter_name"><p>callback_data</p></td>
|
615
|
+
<td class="parameter_description"><p>the user data supplied during creation</p></td>
|
616
|
+
<td class="parameter_annotations"> </td>
|
452
617
|
</tr>
|
453
618
|
<tr>
|
454
|
-
<td
|
455
|
-
<td>
|
619
|
+
<td class="parameter_name"><p>target</p></td>
|
620
|
+
<td class="parameter_description"><p>the rendering target surface</p></td>
|
621
|
+
<td class="parameter_annotations"> </td>
|
456
622
|
</tr>
|
457
623
|
<tr>
|
458
|
-
<td
|
459
|
-
<td
|
460
|
-
</td>
|
624
|
+
<td class="parameter_name"><p>extents</p></td>
|
625
|
+
<td class="parameter_description"><p>rectangular region of interest in pixels in sample space</p></td>
|
626
|
+
<td class="parameter_annotations"> </td>
|
461
627
|
</tr>
|
462
628
|
</tbody>
|
463
629
|
</table></div>
|
630
|
+
</div>
|
631
|
+
<div class="refsect3">
|
632
|
+
<a name="id-1.3.8.6.13.6"></a><h4>Returns</h4>
|
633
|
+
<p> a <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>
|
634
|
+
<p></p>
|
635
|
+
</div>
|
464
636
|
<p class="since">Since 1.12</p>
|
465
637
|
</div>
|
466
638
|
<hr>
|
467
639
|
<div class="refsect2">
|
468
|
-
<a name="cairo-raster-source-release-func-t"></a><h3>cairo_raster_source_release_func_t
|
469
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
470
|
-
|
471
|
-
|
472
|
-
|
473
|
-
<p>
|
474
|
-
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-release-func-t" title="cairo_raster_source_release_func_t ()"><span class="type">cairo_raster_source_release_func_t</span></a> is the type of function which is
|
640
|
+
<a name="cairo-raster-source-release-func-t"></a><h3>cairo_raster_source_release_func_t ()</h3>
|
641
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
642
|
+
<span class="c_punctuation">(</span>*cairo_raster_source_release_func_t<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
643
|
+
<em class="parameter"><code><span class="type">void</span> *callback_data</code></em>,
|
644
|
+
<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>
|
645
|
+
<p><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-release-func-t" title="cairo_raster_source_release_func_t ()"><span class="type">cairo_raster_source_release_func_t</span></a> is the type of function which is
|
475
646
|
called when the pixel data is no longer being access by the pattern
|
476
647
|
for the rendering operation. Typically this function will simply
|
477
|
-
destroy the surface created during acquire
|
478
|
-
|
479
|
-
<
|
480
|
-
<
|
648
|
+
destroy the surface created during acquire.</p>
|
649
|
+
<div class="refsect3">
|
650
|
+
<a name="id-1.3.8.6.14.5"></a><h4>Parameters</h4>
|
651
|
+
<div class="informaltable"><table width="100%" border="0">
|
652
|
+
<colgroup>
|
653
|
+
<col width="150px" class="parameters_name">
|
654
|
+
<col class="parameters_description">
|
655
|
+
<col width="200px" class="parameters_annotations">
|
656
|
+
</colgroup>
|
481
657
|
<tbody>
|
482
658
|
<tr>
|
483
|
-
<td
|
484
|
-
<td>the pattern being rendered from</td>
|
659
|
+
<td class="parameter_name"><p>pattern</p></td>
|
660
|
+
<td class="parameter_description"><p>the pattern being rendered from</p></td>
|
661
|
+
<td class="parameter_annotations"> </td>
|
485
662
|
</tr>
|
486
663
|
<tr>
|
487
|
-
<td
|
488
|
-
<td>the user data supplied during creation</td>
|
664
|
+
<td class="parameter_name"><p>callback_data</p></td>
|
665
|
+
<td class="parameter_description"><p>the user data supplied during creation</p></td>
|
666
|
+
<td class="parameter_annotations"> </td>
|
489
667
|
</tr>
|
490
668
|
<tr>
|
491
|
-
<td
|
492
|
-
<td>the surface created during acquire</td>
|
669
|
+
<td class="parameter_name"><p>surface</p></td>
|
670
|
+
<td class="parameter_description"><p>the surface created during acquire</p></td>
|
671
|
+
<td class="parameter_annotations"> </td>
|
493
672
|
</tr>
|
494
673
|
</tbody>
|
495
674
|
</table></div>
|
675
|
+
</div>
|
496
676
|
<p class="since">Since 1.12</p>
|
497
677
|
</div>
|
498
678
|
<hr>
|
499
679
|
<div class="refsect2">
|
500
|
-
<a name="cairo-raster-source-snapshot-func-t"></a><h3>cairo_raster_source_snapshot_func_t
|
501
|
-
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
502
|
-
|
503
|
-
|
504
|
-
<
|
505
|
-
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-snapshot-func-t" title="cairo_raster_source_snapshot_func_t
|
680
|
+
<a name="cairo-raster-source-snapshot-func-t"></a><h3>cairo_raster_source_snapshot_func_t ()</h3>
|
681
|
+
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
682
|
+
<span class="c_punctuation">(</span>*cairo_raster_source_snapshot_func_t<span class="c_punctuation">)</span>
|
683
|
+
(<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
684
|
+
<em class="parameter"><code><span class="type">void</span> *callback_data</code></em>);</pre>
|
685
|
+
<p><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-snapshot-func-t" title="cairo_raster_source_snapshot_func_t ()"><span class="type">cairo_raster_source_snapshot_func_t</span></a> is the type of function which is
|
506
686
|
called when the pixel data needs to be preserved for later use
|
507
687
|
during printing. This pattern will be accessed again later, and it
|
508
688
|
is expected to provide the pixel data that was current at the time
|
509
|
-
of snapshotting
|
510
|
-
|
511
|
-
<
|
512
|
-
<
|
689
|
+
of snapshotting.</p>
|
690
|
+
<div class="refsect3">
|
691
|
+
<a name="id-1.3.8.6.15.5"></a><h4>Parameters</h4>
|
692
|
+
<div class="informaltable"><table width="100%" border="0">
|
693
|
+
<colgroup>
|
694
|
+
<col width="150px" class="parameters_name">
|
695
|
+
<col class="parameters_description">
|
696
|
+
<col width="200px" class="parameters_annotations">
|
697
|
+
</colgroup>
|
513
698
|
<tbody>
|
514
699
|
<tr>
|
515
|
-
<td
|
516
|
-
<td>the pattern being rendered from</td>
|
517
|
-
</
|
518
|
-
<tr>
|
519
|
-
<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
|
520
|
-
<td>the user data supplied during creation</td>
|
700
|
+
<td class="parameter_name"><p>pattern</p></td>
|
701
|
+
<td class="parameter_description"><p>the pattern being rendered from</p></td>
|
702
|
+
<td class="parameter_annotations"> </td>
|
521
703
|
</tr>
|
522
704
|
<tr>
|
523
|
-
<td
|
524
|
-
<td>
|
525
|
-
<
|
705
|
+
<td class="parameter_name"><p>callback_data</p></td>
|
706
|
+
<td class="parameter_description"><p>the user data supplied during creation</p></td>
|
707
|
+
<td class="parameter_annotations"> </td>
|
526
708
|
</tr>
|
527
709
|
</tbody>
|
528
710
|
</table></div>
|
711
|
+
</div>
|
712
|
+
<div class="refsect3">
|
713
|
+
<a name="id-1.3.8.6.15.6"></a><h4>Returns</h4>
|
714
|
+
<p> CAIRO_STATUS_SUCCESS on success, or one of the
|
715
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="type">cairo_status_t</span></a> error codes for failure.</p>
|
716
|
+
<p></p>
|
717
|
+
</div>
|
529
718
|
<p class="since">Since 1.12</p>
|
530
719
|
</div>
|
531
720
|
<hr>
|
532
721
|
<div class="refsect2">
|
533
|
-
<a name="cairo-raster-source-copy-func-t"></a><h3>cairo_raster_source_copy_func_t
|
534
|
-
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
535
|
-
|
536
|
-
|
537
|
-
<
|
538
|
-
<a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-copy-func-t" title="cairo_raster_source_copy_func_t
|
539
|
-
called when the pattern gets copied as a normal part of rendering
|
540
|
-
|
541
|
-
<
|
542
|
-
<
|
722
|
+
<a name="cairo-raster-source-copy-func-t"></a><h3>cairo_raster_source_copy_func_t ()</h3>
|
723
|
+
<pre class="programlisting"><a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
724
|
+
<span class="c_punctuation">(</span>*cairo_raster_source_copy_func_t<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
725
|
+
<em class="parameter"><code><span class="type">void</span> *callback_data</code></em>,
|
726
|
+
<em class="parameter"><code>const <a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *other</code></em>);</pre>
|
727
|
+
<p><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-copy-func-t" title="cairo_raster_source_copy_func_t ()"><span class="type">cairo_raster_source_copy_func_t</span></a> is the type of function which is
|
728
|
+
called when the pattern gets copied as a normal part of rendering.</p>
|
729
|
+
<div class="refsect3">
|
730
|
+
<a name="id-1.3.8.6.16.5"></a><h4>Parameters</h4>
|
731
|
+
<div class="informaltable"><table width="100%" border="0">
|
732
|
+
<colgroup>
|
733
|
+
<col width="150px" class="parameters_name">
|
734
|
+
<col class="parameters_description">
|
735
|
+
<col width="200px" class="parameters_annotations">
|
736
|
+
</colgroup>
|
543
737
|
<tbody>
|
544
738
|
<tr>
|
545
|
-
<td
|
546
|
-
<td>the <a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> that was copied to</td>
|
547
|
-
</
|
548
|
-
<tr>
|
549
|
-
<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
|
550
|
-
<td>the user data supplied during creation</td>
|
739
|
+
<td class="parameter_name"><p>pattern</p></td>
|
740
|
+
<td class="parameter_description"><p>the <a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> that was copied to</p></td>
|
741
|
+
<td class="parameter_annotations"> </td>
|
551
742
|
</tr>
|
552
743
|
<tr>
|
553
|
-
<td
|
554
|
-
<td
|
744
|
+
<td class="parameter_name"><p>callback_data</p></td>
|
745
|
+
<td class="parameter_description"><p>the user data supplied during creation</p></td>
|
746
|
+
<td class="parameter_annotations"> </td>
|
555
747
|
</tr>
|
556
748
|
<tr>
|
557
|
-
<td
|
558
|
-
<td>
|
559
|
-
<
|
749
|
+
<td class="parameter_name"><p>other</p></td>
|
750
|
+
<td class="parameter_description"><p>the <a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> being used as the source for the copy</p></td>
|
751
|
+
<td class="parameter_annotations"> </td>
|
560
752
|
</tr>
|
561
753
|
</tbody>
|
562
754
|
</table></div>
|
755
|
+
</div>
|
756
|
+
<div class="refsect3">
|
757
|
+
<a name="id-1.3.8.6.16.6"></a><h4>Returns</h4>
|
758
|
+
<p> CAIRO_STATUS_SUCCESS on success, or one of the
|
759
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="type">cairo_status_t</span></a> error codes for failure.</p>
|
760
|
+
<p></p>
|
761
|
+
</div>
|
563
762
|
<p class="since">Since 1.12</p>
|
564
763
|
</div>
|
565
764
|
<hr>
|
566
765
|
<div class="refsect2">
|
567
|
-
<a name="cairo-raster-source-finish-func-t"></a><h3>cairo_raster_source_finish_func_t
|
568
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
569
|
-
|
570
|
-
|
571
|
-
<p>
|
572
|
-
|
573
|
-
|
574
|
-
</
|
575
|
-
<div class="
|
576
|
-
<
|
766
|
+
<a name="cairo-raster-source-finish-func-t"></a><h3>cairo_raster_source_finish_func_t ()</h3>
|
767
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
768
|
+
<span class="c_punctuation">(</span>*cairo_raster_source_finish_func_t<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>,
|
769
|
+
<em class="parameter"><code><span class="type">void</span> *callback_data</code></em>);</pre>
|
770
|
+
<p><a class="link" href="cairo-Raster-Sources.html#cairo-raster-source-finish-func-t" title="cairo_raster_source_finish_func_t ()"><span class="type">cairo_raster_source_finish_func_t</span></a> is the type of function which is
|
771
|
+
called when the pattern (or a copy thereof) is no longer required.</p>
|
772
|
+
<div class="refsect3">
|
773
|
+
<a name="id-1.3.8.6.17.5"></a><h4>Parameters</h4>
|
774
|
+
<div class="informaltable"><table width="100%" border="0">
|
775
|
+
<colgroup>
|
776
|
+
<col width="150px" class="parameters_name">
|
777
|
+
<col class="parameters_description">
|
778
|
+
<col width="200px" class="parameters_annotations">
|
779
|
+
</colgroup>
|
577
780
|
<tbody>
|
578
781
|
<tr>
|
579
|
-
<td
|
580
|
-
<td>the pattern being rendered from</td>
|
782
|
+
<td class="parameter_name"><p>pattern</p></td>
|
783
|
+
<td class="parameter_description"><p>the pattern being rendered from</p></td>
|
784
|
+
<td class="parameter_annotations"> </td>
|
581
785
|
</tr>
|
582
786
|
<tr>
|
583
|
-
<td
|
584
|
-
<td>the user data supplied during creation</td>
|
787
|
+
<td class="parameter_name"><p>callback_data</p></td>
|
788
|
+
<td class="parameter_description"><p>the user data supplied during creation</p></td>
|
789
|
+
<td class="parameter_annotations"> </td>
|
585
790
|
</tr>
|
586
791
|
</tbody>
|
587
792
|
</table></div>
|
793
|
+
</div>
|
588
794
|
<p class="since">Since 1.12</p>
|
589
795
|
</div>
|
590
796
|
</div>
|
591
797
|
<div class="refsect1">
|
798
|
+
<a name="cairo-Raster-Sources.other_details"></a><h2>Types and Values</h2>
|
799
|
+
</div>
|
800
|
+
<div class="refsect1">
|
592
801
|
<a name="cairo-Raster-Sources.see-also"></a><h2>See Also</h2>
|
593
|
-
<a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>
|
802
|
+
<p><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a></p>
|
594
803
|
</div>
|
595
804
|
</div>
|
596
805
|
<div class="footer">
|
597
806
|
<hr>
|
598
|
-
Generated by GTK-Doc V1.
|
807
|
+
Generated by GTK-Doc V1.20</div>
|
599
808
|
</body>
|
600
809
|
</html>
|