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>Recording Surfaces</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.
|
5
|
+
<title>Cairo: A Vector Graphics Library: Recording 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-PostScript-Surfaces.html" title="PostScript Surfaces">
|
10
10
|
<link rel="next" href="cairo-Win32-Surfaces.html" title="Win32 Surfaces">
|
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-Recording-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-Recording-Surfaces.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
19
|
+
<a href="#cairo-Recording-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-PostScript-Surfaces.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
24
|
+
<td><a accesskey="n" href="cairo-Win32-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-Recording-Surfaces"></a><div class="titlepage"></div>
|
31
28
|
<div class="refnamediv"><table width="100%"><tr>
|
@@ -33,37 +30,72 @@
|
|
33
30
|
<h2><span class="refentrytitle"><a name="cairo-Recording-Surfaces.top_of_page"></a>Recording Surfaces</span></h2>
|
34
31
|
<p>Recording Surfaces — Records all drawing operations</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-Recording-Surfaces.
|
40
|
-
<
|
41
|
-
<
|
42
|
-
|
43
|
-
<
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
<a class="link" href="cairo-
|
49
|
-
|
35
|
+
<div class="refsect1">
|
36
|
+
<a name="cairo-Recording-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>
|
42
|
+
<tbody>
|
43
|
+
<tr>
|
44
|
+
<td class="function_type">
|
45
|
+
<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
|
46
|
+
</td>
|
47
|
+
<td class="function_name">
|
48
|
+
<a class="link" href="cairo-Recording-Surfaces.html#cairo-recording-surface-create" title="cairo_recording_surface_create ()">cairo_recording_surface_create</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-Recording-Surfaces.html#cairo-recording-surface-ink-extents" title="cairo_recording_surface_ink_extents ()">cairo_recording_surface_ink_extents</a> <span class="c_punctuation">()</span>
|
57
|
+
</td>
|
58
|
+
</tr>
|
59
|
+
<tr>
|
60
|
+
<td class="function_type">
|
61
|
+
<a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
62
|
+
</td>
|
63
|
+
<td class="function_name">
|
64
|
+
<a class="link" href="cairo-Recording-Surfaces.html#cairo-recording-surface-get-extents" title="cairo_recording_surface_get_extents ()">cairo_recording_surface_get_extents</a> <span class="c_punctuation">()</span>
|
65
|
+
</td>
|
66
|
+
</tr>
|
67
|
+
</tbody>
|
68
|
+
</table></div>
|
69
|
+
</div>
|
70
|
+
<div class="refsect1">
|
71
|
+
<a name="cairo-Recording-Surfaces.other"></a><h2>Types and Values</h2>
|
72
|
+
<div class="informaltable"><table width="100%" border="0">
|
73
|
+
<colgroup>
|
74
|
+
<col width="150px" class="name">
|
75
|
+
<col class="description">
|
76
|
+
</colgroup>
|
77
|
+
<tbody><tr>
|
78
|
+
<td class="define_keyword">#define</td>
|
79
|
+
<td class="function_name"><a class="link" href="cairo-Recording-Surfaces.html#CAIRO-HAS-RECORDING-SURFACE:CAPS" title="CAIRO_HAS_RECORDING_SURFACE">CAIRO_HAS_RECORDING_SURFACE</a></td>
|
80
|
+
</tr></tbody>
|
81
|
+
</table></div>
|
82
|
+
</div>
|
83
|
+
<div class="refsect1">
|
84
|
+
<a name="cairo-Recording-Surfaces.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
85
|
+
<pre class="screen">
|
50
86
|
</pre>
|
51
87
|
</div>
|
52
88
|
<div class="refsect1">
|
53
89
|
<a name="cairo-Recording-Surfaces.description"></a><h2>Description</h2>
|
54
|
-
<p>
|
55
|
-
A recording surface is a surface that records all drawing operations at
|
90
|
+
<p>A recording surface is a surface that records all drawing operations at
|
56
91
|
the highest level of the surface backend interface, (that is, the
|
57
92
|
level of paint, mask, stroke, fill, and show_text_glyphs). The recording
|
58
93
|
surface can then be "replayed" against any target surface by using it
|
59
|
-
as a source surface
|
60
|
-
|
61
|
-
<p>
|
62
|
-
If you want to replay a surface so that the results in target will be
|
94
|
+
as a source surface.</p>
|
95
|
+
<p>If you want to replay a surface so that the results in target will be
|
63
96
|
identical to the results that would have been obtained if the original
|
64
97
|
operations applied to the recording surface had instead been applied to the
|
65
|
-
target surface, you can use code like this
|
66
|
-
</p>
|
98
|
+
target surface, you can use code like this:</p>
|
67
99
|
<div class="informalexample"><pre class="programlisting">
|
68
100
|
cairo_t *cr;
|
69
101
|
|
@@ -72,155 +104,172 @@ cairo_set_source_surface (cr, recording_surface, 0.0, 0.0);
|
|
72
104
|
cairo_paint (cr);
|
73
105
|
cairo_destroy (cr);
|
74
106
|
</pre></div>
|
75
|
-
<p>
|
76
|
-
</p>
|
77
|
-
<p>
|
78
|
-
A recording surface is logically unbounded, i.e. it has no implicit constraint
|
107
|
+
<p>A recording surface is logically unbounded, i.e. it has no implicit constraint
|
79
108
|
on the size of the drawing surface. However, in practice this is rarely
|
80
109
|
useful as you wish to replay against a particular target surface with
|
81
110
|
known bounds. For this case, it is more efficient to specify the target
|
82
|
-
extents to the recording surface upon creation
|
83
|
-
|
84
|
-
<p>
|
85
|
-
The recording phase of the recording surface is careful to snapshot all
|
111
|
+
extents to the recording surface upon creation.</p>
|
112
|
+
<p>The recording phase of the recording surface is careful to snapshot all
|
86
113
|
necessary objects (paths, patterns, etc.), in order to achieve
|
87
114
|
accurate replay. The efficiency of the recording surface could be
|
88
115
|
improved by improving the implementation of snapshot for the
|
89
116
|
various objects. For example, it would be nice to have a
|
90
|
-
copy-on-write implementation for _cairo_surface_snapshot
|
91
|
-
</p>
|
117
|
+
copy-on-write implementation for _cairo_surface_snapshot.</p>
|
92
118
|
</div>
|
93
119
|
<div class="refsect1">
|
94
|
-
<a name="cairo-Recording-Surfaces.
|
95
|
-
<div class="refsect2">
|
96
|
-
<a name="CAIRO-HAS-RECORDING-SURFACE:CAPS"></a><h3>CAIRO_HAS_RECORDING_SURFACE</h3>
|
97
|
-
<pre class="programlisting">#define CAIRO_HAS_RECORDING_SURFACE 1
|
98
|
-
</pre>
|
99
|
-
<p>
|
100
|
-
Defined if the recording surface backend is available.
|
101
|
-
The recording surface backend is always built in.
|
102
|
-
This macro was added for completeness in cairo 1.10.
|
103
|
-
</p>
|
104
|
-
<p class="since">Since 1.10</p>
|
105
|
-
</div>
|
106
|
-
<hr>
|
120
|
+
<a name="cairo-Recording-Surfaces.functions_details"></a><h2>Functions</h2>
|
107
121
|
<div class="refsect2">
|
108
|
-
<a name="cairo-recording-surface-create"></a><h3>cairo_recording_surface_create
|
109
|
-
<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>
|
110
|
-
|
111
|
-
<
|
112
|
-
Creates a recording-surface which can be used to record all drawing operations
|
122
|
+
<a name="cairo-recording-surface-create"></a><h3>cairo_recording_surface_create ()</h3>
|
123
|
+
<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> *
|
124
|
+
cairo_recording_surface_create (<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>,
|
125
|
+
<em class="parameter"><code>const <a class="link" href="cairo-cairo-t.html#cairo-rectangle-t" title="cairo_rectangle_t"><span class="type">cairo_rectangle_t</span></a> *extents</code></em>);</pre>
|
126
|
+
<p>Creates a recording-surface which can be used to record all drawing operations
|
113
127
|
at the highest level (that is, the level of paint, mask, stroke, fill
|
114
128
|
and show_text_glyphs). The recording surface can then be "replayed" against
|
115
|
-
any target surface by using it as a source to drawing operations
|
116
|
-
|
117
|
-
<p>
|
118
|
-
The recording phase of the recording surface is careful to snapshot all
|
129
|
+
any target surface by using it as a source to drawing operations.</p>
|
130
|
+
<p>The recording phase of the recording surface is careful to snapshot all
|
119
131
|
necessary objects (paths, patterns, etc.), in order to achieve
|
120
|
-
accurate replay
|
121
|
-
|
122
|
-
<
|
123
|
-
<
|
132
|
+
accurate replay.</p>
|
133
|
+
<div class="refsect3">
|
134
|
+
<a name="id-1.5.8.7.2.6"></a><h4>Parameters</h4>
|
135
|
+
<div class="informaltable"><table width="100%" border="0">
|
136
|
+
<colgroup>
|
137
|
+
<col width="150px" class="parameters_name">
|
138
|
+
<col class="parameters_description">
|
139
|
+
<col width="200px" class="parameters_annotations">
|
140
|
+
</colgroup>
|
124
141
|
<tbody>
|
125
142
|
<tr>
|
126
|
-
<td
|
127
|
-
<td>the content of the recording surface</td>
|
128
|
-
</
|
129
|
-
<tr>
|
130
|
-
<td><p><span class="term"><em class="parameter"><code>extents</code></em> :</span></p></td>
|
131
|
-
<td>the extents to record in pixels, can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to record
|
132
|
-
unbounded operations.</td>
|
143
|
+
<td class="parameter_name"><p>content</p></td>
|
144
|
+
<td class="parameter_description"><p>the content of the recording surface</p></td>
|
145
|
+
<td class="parameter_annotations"> </td>
|
133
146
|
</tr>
|
134
147
|
<tr>
|
135
|
-
<td
|
136
|
-
<td>
|
137
|
-
|
138
|
-
|
148
|
+
<td class="parameter_name"><p>extents</p></td>
|
149
|
+
<td class="parameter_description"><p>the extents to record in pixels, can be <code class="literal">NULL</code> to record
|
150
|
+
unbounded operations.</p></td>
|
151
|
+
<td class="parameter_annotations"> </td>
|
139
152
|
</tr>
|
140
153
|
</tbody>
|
141
154
|
</table></div>
|
155
|
+
</div>
|
156
|
+
<div class="refsect3">
|
157
|
+
<a name="id-1.5.8.7.2.7"></a><h4>Returns</h4>
|
158
|
+
<p> a pointer to the newly created surface. The caller
|
159
|
+
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
|
160
|
+
with it.</p>
|
161
|
+
<p></p>
|
162
|
+
</div>
|
142
163
|
<p class="since">Since 1.10</p>
|
143
164
|
</div>
|
144
165
|
<hr>
|
145
166
|
<div class="refsect2">
|
146
|
-
<a name="cairo-recording-surface-ink-extents"></a><h3>cairo_recording_surface_ink_extents
|
147
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
148
|
-
|
149
|
-
|
150
|
-
|
151
|
-
|
152
|
-
<
|
153
|
-
Measures the extents of the operations stored within the recording-surface.
|
167
|
+
<a name="cairo-recording-surface-ink-extents"></a><h3>cairo_recording_surface_ink_extents ()</h3>
|
168
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
169
|
+
cairo_recording_surface_ink_extents (<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>,
|
170
|
+
<em class="parameter"><code><span class="type">double</span> *x0</code></em>,
|
171
|
+
<em class="parameter"><code><span class="type">double</span> *y0</code></em>,
|
172
|
+
<em class="parameter"><code><span class="type">double</span> *width</code></em>,
|
173
|
+
<em class="parameter"><code><span class="type">double</span> *height</code></em>);</pre>
|
174
|
+
<p>Measures the extents of the operations stored within the recording-surface.
|
154
175
|
This is useful to compute the required size of an image surface (or
|
155
|
-
equivalent) into which to replay the full sequence of drawing operations
|
156
|
-
|
157
|
-
<
|
158
|
-
<
|
176
|
+
equivalent) into which to replay the full sequence of drawing operations.</p>
|
177
|
+
<div class="refsect3">
|
178
|
+
<a name="id-1.5.8.7.3.5"></a><h4>Parameters</h4>
|
179
|
+
<div class="informaltable"><table width="100%" border="0">
|
180
|
+
<colgroup>
|
181
|
+
<col width="150px" class="parameters_name">
|
182
|
+
<col class="parameters_description">
|
183
|
+
<col width="200px" class="parameters_annotations">
|
184
|
+
</colgroup>
|
159
185
|
<tbody>
|
160
186
|
<tr>
|
161
|
-
<td
|
162
|
-
<td>a <span class="type">cairo_recording_surface_t</span>
|
163
|
-
</td>
|
187
|
+
<td class="parameter_name"><p>surface</p></td>
|
188
|
+
<td class="parameter_description"><p>a <span class="type">cairo_recording_surface_t</span></p></td>
|
189
|
+
<td class="parameter_annotations"> </td>
|
164
190
|
</tr>
|
165
191
|
<tr>
|
166
|
-
<td
|
167
|
-
<td>the x-coordinate of the top-left of the ink bounding box</td>
|
192
|
+
<td class="parameter_name"><p>x0</p></td>
|
193
|
+
<td class="parameter_description"><p>the x-coordinate of the top-left of the ink bounding box</p></td>
|
194
|
+
<td class="parameter_annotations"> </td>
|
168
195
|
</tr>
|
169
196
|
<tr>
|
170
|
-
<td
|
171
|
-
<td>the y-coordinate of the top-left of the ink bounding box</td>
|
197
|
+
<td class="parameter_name"><p>y0</p></td>
|
198
|
+
<td class="parameter_description"><p>the y-coordinate of the top-left of the ink bounding box</p></td>
|
199
|
+
<td class="parameter_annotations"> </td>
|
172
200
|
</tr>
|
173
201
|
<tr>
|
174
|
-
<td
|
175
|
-
<td>the width of the ink bounding box</td>
|
202
|
+
<td class="parameter_name"><p>width</p></td>
|
203
|
+
<td class="parameter_description"><p>the width of the ink bounding box</p></td>
|
204
|
+
<td class="parameter_annotations"> </td>
|
176
205
|
</tr>
|
177
206
|
<tr>
|
178
|
-
<td
|
179
|
-
<td>the height of the ink bounding box</td>
|
207
|
+
<td class="parameter_name"><p>height</p></td>
|
208
|
+
<td class="parameter_description"><p>the height of the ink bounding box</p></td>
|
209
|
+
<td class="parameter_annotations"> </td>
|
180
210
|
</tr>
|
181
211
|
</tbody>
|
182
212
|
</table></div>
|
213
|
+
</div>
|
183
214
|
<p class="since">Since 1.10</p>
|
184
215
|
</div>
|
185
216
|
<hr>
|
186
217
|
<div class="refsect2">
|
187
|
-
<a name="cairo-recording-surface-get-extents"></a><h3>cairo_recording_surface_get_extents
|
188
|
-
<pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
189
|
-
|
190
|
-
<
|
191
|
-
Get the extents of the recording-surface
|
192
|
-
|
193
|
-
<
|
194
|
-
<
|
218
|
+
<a name="cairo-recording-surface-get-extents"></a><h3>cairo_recording_surface_get_extents ()</h3>
|
219
|
+
<pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
220
|
+
cairo_recording_surface_get_extents (<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>,
|
221
|
+
<em class="parameter"><code><a class="link" href="cairo-cairo-t.html#cairo-rectangle-t" title="cairo_rectangle_t"><span class="type">cairo_rectangle_t</span></a> *extents</code></em>);</pre>
|
222
|
+
<p>Get the extents of the recording-surface.</p>
|
223
|
+
<div class="refsect3">
|
224
|
+
<a name="id-1.5.8.7.4.5"></a><h4>Parameters</h4>
|
225
|
+
<div class="informaltable"><table width="100%" border="0">
|
226
|
+
<colgroup>
|
227
|
+
<col width="150px" class="parameters_name">
|
228
|
+
<col class="parameters_description">
|
229
|
+
<col width="200px" class="parameters_annotations">
|
230
|
+
</colgroup>
|
195
231
|
<tbody>
|
196
232
|
<tr>
|
197
|
-
<td
|
198
|
-
<td>a <span class="type">cairo_recording_surface_t</span>
|
199
|
-
</td>
|
200
|
-
</tr>
|
201
|
-
<tr>
|
202
|
-
<td><p><span class="term"><em class="parameter"><code>extents</code></em> :</span></p></td>
|
203
|
-
<td>the <a class="link" href="cairo-cairo-t.html#cairo-rectangle-t" title="cairo_rectangle_t"><span class="type">cairo_rectangle_t</span></a> to be assigned the extents</td>
|
233
|
+
<td class="parameter_name"><p>surface</p></td>
|
234
|
+
<td class="parameter_description"><p>a <span class="type">cairo_recording_surface_t</span></p></td>
|
235
|
+
<td class="parameter_annotations"> </td>
|
204
236
|
</tr>
|
205
237
|
<tr>
|
206
|
-
<td
|
207
|
-
<td>
|
208
|
-
<
|
209
|
-
not in an error state, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
|
210
|
-
</td>
|
238
|
+
<td class="parameter_name"><p>extents</p></td>
|
239
|
+
<td class="parameter_description"><p>the <a class="link" href="cairo-cairo-t.html#cairo-rectangle-t" title="cairo_rectangle_t"><span class="type">cairo_rectangle_t</span></a> to be assigned the extents</p></td>
|
240
|
+
<td class="parameter_annotations"> </td>
|
211
241
|
</tr>
|
212
242
|
</tbody>
|
213
243
|
</table></div>
|
244
|
+
</div>
|
245
|
+
<div class="refsect3">
|
246
|
+
<a name="id-1.5.8.7.4.6"></a><h4>Returns</h4>
|
247
|
+
<p> <code class="literal">TRUE</code> if the surface is bounded, of recording type, and
|
248
|
+
not in an error state, otherwise <code class="literal">FALSE</code></p>
|
249
|
+
<p></p>
|
250
|
+
</div>
|
214
251
|
<p class="since">Since 1.12</p>
|
215
252
|
</div>
|
216
253
|
</div>
|
217
254
|
<div class="refsect1">
|
255
|
+
<a name="cairo-Recording-Surfaces.other_details"></a><h2>Types and Values</h2>
|
256
|
+
<div class="refsect2">
|
257
|
+
<a name="CAIRO-HAS-RECORDING-SURFACE:CAPS"></a><h3>CAIRO_HAS_RECORDING_SURFACE</h3>
|
258
|
+
<pre class="programlisting">#define CAIRO_HAS_RECORDING_SURFACE 1
|
259
|
+
</pre>
|
260
|
+
<p>Defined if the recording surface backend is available.
|
261
|
+
The recording surface backend is always built in.
|
262
|
+
This macro was added for completeness in cairo 1.10.</p>
|
263
|
+
<p class="since">Since 1.10</p>
|
264
|
+
</div>
|
265
|
+
</div>
|
266
|
+
<div class="refsect1">
|
218
267
|
<a name="cairo-Recording-Surfaces.see-also"></a><h2>See Also</h2>
|
219
|
-
<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
|
268
|
+
<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>
|
220
269
|
</div>
|
221
270
|
</div>
|
222
271
|
<div class="footer">
|
223
272
|
<hr>
|
224
|
-
Generated by GTK-Doc V1.
|
273
|
+
Generated by GTK-Doc V1.20</div>
|
225
274
|
</body>
|
226
275
|
</html>
|
@@ -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>Regions</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.
|
5
|
+
<title>Cairo: A Vector Graphics Library: Regions</title>
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
|
7
7
|
<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
|
8
8
|
<link rel="up" href="cairo-drawing.html" title="Drawing">
|
9
9
|
<link rel="prev" href="cairo-cairo-pattern-t.html" title="cairo_pattern_t">
|
10
10
|
<link rel="next" href="cairo-Transformations.html" title="Transformations">
|
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-Regions.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-Regions.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
19
|
+
<a href="#cairo-Regions.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
|
20
|
+
</td>
|
21
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
22
|
+
<td><a accesskey="u" href="cairo-drawing.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
23
|
+
<td><a accesskey="p" href="cairo-cairo-pattern-t.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
24
|
+
<td><a accesskey="n" href="cairo-Transformations.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-Regions"></a><div class="titlepage"></div>
|
31
28
|
<div class="refnamediv"><table width="100%"><tr>
|
@@ -33,778 +30,1130 @@
|
|
33
30
|
<h2><span class="refentrytitle"><a name="cairo-Regions.top_of_page"></a>Regions</span></h2>
|
34
31
|
<p>Regions — Representing a pixel-aligned area</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-Regions.
|
40
|
-
<
|
41
|
-
<
|
42
|
-
<
|
43
|
-
<
|
44
|
-
|
45
|
-
<
|
46
|
-
<
|
47
|
-
<
|
48
|
-
<a class="link" href="cairo-
|
49
|
-
|
50
|
-
|
51
|
-
<
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
<
|
56
|
-
<a class="link" href="cairo-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
<
|
63
|
-
|
64
|
-
<
|
65
|
-
|
66
|
-
|
67
|
-
<a class="link" href="cairo-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
<
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
<a class="link" href="cairo-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
<
|
80
|
-
|
81
|
-
|
82
|
-
|
35
|
+
<div class="refsect1">
|
36
|
+
<a name="cairo-Regions.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-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a> *
|
46
|
+
</td>
|
47
|
+
<td class="function_name">
|
48
|
+
<a class="link" href="cairo-Regions.html#cairo-region-create" title="cairo_region_create ()">cairo_region_create</a> <span class="c_punctuation">()</span>
|
49
|
+
</td>
|
50
|
+
</tr>
|
51
|
+
<tr>
|
52
|
+
<td class="function_type">
|
53
|
+
<a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a> *
|
54
|
+
</td>
|
55
|
+
<td class="function_name">
|
56
|
+
<a class="link" href="cairo-Regions.html#cairo-region-create-rectangle" title="cairo_region_create_rectangle ()">cairo_region_create_rectangle</a> <span class="c_punctuation">()</span>
|
57
|
+
</td>
|
58
|
+
</tr>
|
59
|
+
<tr>
|
60
|
+
<td class="function_type">
|
61
|
+
<a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a> *
|
62
|
+
</td>
|
63
|
+
<td class="function_name">
|
64
|
+
<a class="link" href="cairo-Regions.html#cairo-region-create-rectangles" title="cairo_region_create_rectangles ()">cairo_region_create_rectangles</a> <span class="c_punctuation">()</span>
|
65
|
+
</td>
|
66
|
+
</tr>
|
67
|
+
<tr>
|
68
|
+
<td class="function_type">
|
69
|
+
<a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a> *
|
70
|
+
</td>
|
71
|
+
<td class="function_name">
|
72
|
+
<a class="link" href="cairo-Regions.html#cairo-region-copy" title="cairo_region_copy ()">cairo_region_copy</a> <span class="c_punctuation">()</span>
|
73
|
+
</td>
|
74
|
+
</tr>
|
75
|
+
<tr>
|
76
|
+
<td class="function_type">
|
77
|
+
<a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a> *
|
78
|
+
</td>
|
79
|
+
<td class="function_name">
|
80
|
+
<a class="link" href="cairo-Regions.html#cairo-region-reference" title="cairo_region_reference ()">cairo_region_reference</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-Regions.html#cairo-region-destroy" title="cairo_region_destroy ()">cairo_region_destroy</a> <span class="c_punctuation">()</span>
|
89
|
+
</td>
|
90
|
+
</tr>
|
91
|
+
<tr>
|
92
|
+
<td class="function_type">
|
93
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
94
|
+
</td>
|
95
|
+
<td class="function_name">
|
96
|
+
<a class="link" href="cairo-Regions.html#cairo-region-status" title="cairo_region_status ()">cairo_region_status</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-Regions.html#cairo-region-get-extents" title="cairo_region_get_extents ()">cairo_region_get_extents</a> <span class="c_punctuation">()</span>
|
105
|
+
</td>
|
106
|
+
</tr>
|
107
|
+
<tr>
|
108
|
+
<td class="function_type">
|
109
|
+
<span class="returnvalue">int</span>
|
110
|
+
</td>
|
111
|
+
<td class="function_name">
|
112
|
+
<a class="link" href="cairo-Regions.html#cairo-region-num-rectangles" title="cairo_region_num_rectangles ()">cairo_region_num_rectangles</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-Regions.html#cairo-region-get-rectangle" title="cairo_region_get_rectangle ()">cairo_region_get_rectangle</a> <span class="c_punctuation">()</span>
|
121
|
+
</td>
|
122
|
+
</tr>
|
123
|
+
<tr>
|
124
|
+
<td class="function_type">
|
125
|
+
<a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
126
|
+
</td>
|
127
|
+
<td class="function_name">
|
128
|
+
<a class="link" href="cairo-Regions.html#cairo-region-is-empty" title="cairo_region_is_empty ()">cairo_region_is_empty</a> <span class="c_punctuation">()</span>
|
129
|
+
</td>
|
130
|
+
</tr>
|
131
|
+
<tr>
|
132
|
+
<td class="function_type">
|
133
|
+
<a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
134
|
+
</td>
|
135
|
+
<td class="function_name">
|
136
|
+
<a class="link" href="cairo-Regions.html#cairo-region-contains-point" title="cairo_region_contains_point ()">cairo_region_contains_point</a> <span class="c_punctuation">()</span>
|
137
|
+
</td>
|
138
|
+
</tr>
|
139
|
+
<tr>
|
140
|
+
<td class="function_type">
|
141
|
+
<a class="link" href="cairo-Regions.html#cairo-region-overlap-t" title="enum cairo_region_overlap_t"><span class="returnvalue">cairo_region_overlap_t</span></a>
|
142
|
+
</td>
|
143
|
+
<td class="function_name">
|
144
|
+
<a class="link" href="cairo-Regions.html#cairo-region-contains-rectangle" title="cairo_region_contains_rectangle ()">cairo_region_contains_rectangle</a> <span class="c_punctuation">()</span>
|
145
|
+
</td>
|
146
|
+
</tr>
|
147
|
+
<tr>
|
148
|
+
<td class="function_type">
|
149
|
+
<a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
150
|
+
</td>
|
151
|
+
<td class="function_name">
|
152
|
+
<a class="link" href="cairo-Regions.html#cairo-region-equal" title="cairo_region_equal ()">cairo_region_equal</a> <span class="c_punctuation">()</span>
|
153
|
+
</td>
|
154
|
+
</tr>
|
155
|
+
<tr>
|
156
|
+
<td class="function_type">
|
157
|
+
<span class="returnvalue">void</span>
|
158
|
+
</td>
|
159
|
+
<td class="function_name">
|
160
|
+
<a class="link" href="cairo-Regions.html#cairo-region-translate" title="cairo_region_translate ()">cairo_region_translate</a> <span class="c_punctuation">()</span>
|
161
|
+
</td>
|
162
|
+
</tr>
|
163
|
+
<tr>
|
164
|
+
<td class="function_type">
|
165
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
166
|
+
</td>
|
167
|
+
<td class="function_name">
|
168
|
+
<a class="link" href="cairo-Regions.html#cairo-region-intersect" title="cairo_region_intersect ()">cairo_region_intersect</a> <span class="c_punctuation">()</span>
|
169
|
+
</td>
|
170
|
+
</tr>
|
171
|
+
<tr>
|
172
|
+
<td class="function_type">
|
173
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
174
|
+
</td>
|
175
|
+
<td class="function_name">
|
176
|
+
<a class="link" href="cairo-Regions.html#cairo-region-intersect-rectangle" title="cairo_region_intersect_rectangle ()">cairo_region_intersect_rectangle</a> <span class="c_punctuation">()</span>
|
177
|
+
</td>
|
178
|
+
</tr>
|
179
|
+
<tr>
|
180
|
+
<td class="function_type">
|
181
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
182
|
+
</td>
|
183
|
+
<td class="function_name">
|
184
|
+
<a class="link" href="cairo-Regions.html#cairo-region-subtract" title="cairo_region_subtract ()">cairo_region_subtract</a> <span class="c_punctuation">()</span>
|
185
|
+
</td>
|
186
|
+
</tr>
|
187
|
+
<tr>
|
188
|
+
<td class="function_type">
|
189
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
190
|
+
</td>
|
191
|
+
<td class="function_name">
|
192
|
+
<a class="link" href="cairo-Regions.html#cairo-region-subtract-rectangle" title="cairo_region_subtract_rectangle ()">cairo_region_subtract_rectangle</a> <span class="c_punctuation">()</span>
|
193
|
+
</td>
|
194
|
+
</tr>
|
195
|
+
<tr>
|
196
|
+
<td class="function_type">
|
197
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
198
|
+
</td>
|
199
|
+
<td class="function_name">
|
200
|
+
<a class="link" href="cairo-Regions.html#cairo-region-union" title="cairo_region_union ()">cairo_region_union</a> <span class="c_punctuation">()</span>
|
201
|
+
</td>
|
202
|
+
</tr>
|
203
|
+
<tr>
|
204
|
+
<td class="function_type">
|
205
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
206
|
+
</td>
|
207
|
+
<td class="function_name">
|
208
|
+
<a class="link" href="cairo-Regions.html#cairo-region-union-rectangle" title="cairo_region_union_rectangle ()">cairo_region_union_rectangle</a> <span class="c_punctuation">()</span>
|
209
|
+
</td>
|
210
|
+
</tr>
|
211
|
+
<tr>
|
212
|
+
<td class="function_type">
|
213
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
214
|
+
</td>
|
215
|
+
<td class="function_name">
|
216
|
+
<a class="link" href="cairo-Regions.html#cairo-region-xor" title="cairo_region_xor ()">cairo_region_xor</a> <span class="c_punctuation">()</span>
|
217
|
+
</td>
|
218
|
+
</tr>
|
219
|
+
<tr>
|
220
|
+
<td class="function_type">
|
221
|
+
<a class="link" href="cairo-Error-handling.html#cairo-status-t" title="enum cairo_status_t"><span class="returnvalue">cairo_status_t</span></a>
|
222
|
+
</td>
|
223
|
+
<td class="function_name">
|
224
|
+
<a class="link" href="cairo-Regions.html#cairo-region-xor-rectangle" title="cairo_region_xor_rectangle ()">cairo_region_xor_rectangle</a> <span class="c_punctuation">()</span>
|
225
|
+
</td>
|
226
|
+
</tr>
|
227
|
+
</tbody>
|
228
|
+
</table></div>
|
229
|
+
</div>
|
230
|
+
<div class="refsect1">
|
231
|
+
<a name="cairo-Regions.other"></a><h2>Types and Values</h2>
|
232
|
+
<div class="informaltable"><table width="100%" border="0">
|
233
|
+
<colgroup>
|
234
|
+
<col width="150px" class="name">
|
235
|
+
<col class="description">
|
236
|
+
</colgroup>
|
237
|
+
<tbody>
|
238
|
+
<tr>
|
239
|
+
<td class="typedef_keyword">typedef</td>
|
240
|
+
<td class="function_name"><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t">cairo_region_t</a></td>
|
241
|
+
</tr>
|
242
|
+
<tr>
|
243
|
+
<td class="datatype_keyword">enum</td>
|
244
|
+
<td class="function_name"><a class="link" href="cairo-Regions.html#cairo-region-overlap-t" title="enum cairo_region_overlap_t">cairo_region_overlap_t</a></td>
|
245
|
+
</tr>
|
246
|
+
</tbody>
|
247
|
+
</table></div>
|
248
|
+
</div>
|
249
|
+
<div class="refsect1">
|
250
|
+
<a name="cairo-Regions.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
251
|
+
<pre class="screen">
|
83
252
|
</pre>
|
84
253
|
</div>
|
85
254
|
<div class="refsect1">
|
86
255
|
<a name="cairo-Regions.description"></a><h2>Description</h2>
|
87
|
-
<p>
|
88
|
-
Regions are a simple graphical data type representing an area of
|
256
|
+
<p>Regions are a simple graphical data type representing an area of
|
89
257
|
integer-aligned rectangles. They are often used on raster surfaces
|
90
|
-
to track areas of interest, such as change or clip areas
|
91
|
-
</p>
|
258
|
+
to track areas of interest, such as change or clip areas.</p>
|
92
259
|
</div>
|
93
260
|
<div class="refsect1">
|
94
|
-
<a name="cairo-Regions.
|
261
|
+
<a name="cairo-Regions.functions_details"></a><h2>Functions</h2>
|
95
262
|
<div class="refsect2">
|
96
|
-
<a name="cairo-region-
|
97
|
-
<pre class="programlisting"
|
98
|
-
</pre>
|
99
|
-
<p>
|
100
|
-
|
101
|
-
</
|
102
|
-
<p>
|
103
|
-
|
104
|
-
|
105
|
-
|
106
|
-
<p>
|
107
|
-
|
108
|
-
|
109
|
-
</p>
|
263
|
+
<a name="cairo-region-create"></a><h3>cairo_region_create ()</h3>
|
264
|
+
<pre class="programlisting"><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a> *
|
265
|
+
cairo_region_create (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
266
|
+
<p>Allocates a new empty region object.</p>
|
267
|
+
<div class="refsect3">
|
268
|
+
<a name="id-1.3.5.7.2.5"></a><h4>Returns</h4>
|
269
|
+
<p> A newly allocated <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>. Free with
|
270
|
+
<a class="link" href="cairo-Regions.html#cairo-region-destroy" title="cairo_region_destroy ()"><code class="function">cairo_region_destroy()</code></a>. This function always returns a
|
271
|
+
valid pointer; if memory cannot be allocated, then a special
|
272
|
+
error object is returned where all operations on the object do nothing.
|
273
|
+
You can check for this with <a class="link" href="cairo-Regions.html#cairo-region-status" title="cairo_region_status ()"><code class="function">cairo_region_status()</code></a>.</p>
|
274
|
+
<p></p>
|
275
|
+
</div>
|
110
276
|
<p class="since">Since 1.10</p>
|
111
277
|
</div>
|
112
278
|
<hr>
|
113
279
|
<div class="refsect2">
|
114
|
-
<a name="cairo-region-create"></a><h3>
|
115
|
-
<pre class="programlisting"><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a>
|
116
|
-
<
|
117
|
-
Allocates a new
|
118
|
-
|
119
|
-
<div class="
|
120
|
-
<
|
280
|
+
<a name="cairo-region-create-rectangle"></a><h3>cairo_region_create_rectangle ()</h3>
|
281
|
+
<pre class="programlisting"><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a> *
|
282
|
+
cairo_region_create_rectangle (<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> *rectangle</code></em>);</pre>
|
283
|
+
<p>Allocates a new region object containing <em class="parameter"><code>rectangle</code></em>
|
284
|
+
.</p>
|
285
|
+
<div class="refsect3">
|
286
|
+
<a name="id-1.3.5.7.3.5"></a><h4>Parameters</h4>
|
287
|
+
<div class="informaltable"><table width="100%" border="0">
|
288
|
+
<colgroup>
|
289
|
+
<col width="150px" class="parameters_name">
|
290
|
+
<col class="parameters_description">
|
291
|
+
<col width="200px" class="parameters_annotations">
|
292
|
+
</colgroup>
|
121
293
|
<tbody><tr>
|
122
|
-
<td
|
123
|
-
<td>
|
124
|
-
<
|
125
|
-
valid pointer; if memory cannot be allocated, then a special
|
126
|
-
error object is returned where all operations on the object do nothing.
|
127
|
-
You can check for this with <a class="link" href="cairo-Regions.html#cairo-region-status" title="cairo_region_status ()"><code class="function">cairo_region_status()</code></a>.</td>
|
294
|
+
<td class="parameter_name"><p>rectangle</p></td>
|
295
|
+
<td class="parameter_description"><p>a <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></p></td>
|
296
|
+
<td class="parameter_annotations"> </td>
|
128
297
|
</tr></tbody>
|
129
298
|
</table></div>
|
130
|
-
<p class="since">Since 1.10</p>
|
131
299
|
</div>
|
132
|
-
<
|
133
|
-
<
|
134
|
-
<a
|
135
|
-
<
|
136
|
-
<p>
|
137
|
-
Allocates a new region object containing <em class="parameter"><code>rectangle</code></em>.
|
138
|
-
</p>
|
139
|
-
<div class="variablelist"><table border="0">
|
140
|
-
<col align="left" valign="top">
|
141
|
-
<tbody>
|
142
|
-
<tr>
|
143
|
-
<td><p><span class="term"><em class="parameter"><code>rectangle</code></em> :</span></p></td>
|
144
|
-
<td>a <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>
|
145
|
-
</td>
|
146
|
-
</tr>
|
147
|
-
<tr>
|
148
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
149
|
-
<td>A newly allocated <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>. Free with
|
150
|
-
<a class="link" href="cairo-Regions.html#cairo-region-destroy" title="cairo_region_destroy ()"><code class="function">cairo_region_destroy()</code></a>. This function always returns a
|
300
|
+
<div class="refsect3">
|
301
|
+
<a name="id-1.3.5.7.3.6"></a><h4>Returns</h4>
|
302
|
+
<p> A newly allocated <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>. Free with
|
303
|
+
<a class="link" href="cairo-Regions.html#cairo-region-destroy" title="cairo_region_destroy ()"><code class="function">cairo_region_destroy()</code></a>. This function always returns a
|
151
304
|
valid pointer; if memory cannot be allocated, then a special
|
152
305
|
error object is returned where all operations on the object do nothing.
|
153
|
-
You can check for this with <a class="link" href="cairo-Regions.html#cairo-region-status" title="cairo_region_status
|
154
|
-
|
155
|
-
</
|
156
|
-
</table></div>
|
306
|
+
You can check for this with <a class="link" href="cairo-Regions.html#cairo-region-status" title="cairo_region_status ()"><code class="function">cairo_region_status()</code></a>.</p>
|
307
|
+
<p></p>
|
308
|
+
</div>
|
157
309
|
<p class="since">Since 1.10</p>
|
158
310
|
</div>
|
159
311
|
<hr>
|
160
312
|
<div class="refsect2">
|
161
|
-
<a name="cairo-region-create-rectangles"></a><h3>cairo_region_create_rectangles
|
162
|
-
<pre class="programlisting"><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a>
|
163
|
-
|
164
|
-
<
|
165
|
-
Allocates a new region object containing the union of all given <em class="parameter"><code>rects</code></em
|
166
|
-
|
167
|
-
<div class="
|
168
|
-
<
|
313
|
+
<a name="cairo-region-create-rectangles"></a><h3>cairo_region_create_rectangles ()</h3>
|
314
|
+
<pre class="programlisting"><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a> *
|
315
|
+
cairo_region_create_rectangles (<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> *rects</code></em>,
|
316
|
+
<em class="parameter"><code><span class="type">int</span> count</code></em>);</pre>
|
317
|
+
<p>Allocates a new region object containing the union of all given <em class="parameter"><code>rects</code></em>
|
318
|
+
.</p>
|
319
|
+
<div class="refsect3">
|
320
|
+
<a name="id-1.3.5.7.4.5"></a><h4>Parameters</h4>
|
321
|
+
<div class="informaltable"><table width="100%" border="0">
|
322
|
+
<colgroup>
|
323
|
+
<col width="150px" class="parameters_name">
|
324
|
+
<col class="parameters_description">
|
325
|
+
<col width="200px" class="parameters_annotations">
|
326
|
+
</colgroup>
|
169
327
|
<tbody>
|
170
328
|
<tr>
|
171
|
-
<td
|
172
|
-
<td>an array of <em class="parameter"><code>count</code></em>
|
173
|
-
</
|
174
|
-
<
|
175
|
-
<td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td>
|
176
|
-
<td>number of rectangles</td>
|
329
|
+
<td class="parameter_name"><p>rects</p></td>
|
330
|
+
<td class="parameter_description"><p>an array of <em class="parameter"><code>count</code></em>
|
331
|
+
rectangles</p></td>
|
332
|
+
<td class="parameter_annotations"> </td>
|
177
333
|
</tr>
|
178
334
|
<tr>
|
179
|
-
<td
|
180
|
-
<td
|
181
|
-
<
|
182
|
-
valid pointer; if memory cannot be allocated, then a special
|
183
|
-
error object is returned where all operations on the object do nothing.
|
184
|
-
You can check for this with <a class="link" href="cairo-Regions.html#cairo-region-status" title="cairo_region_status ()"><code class="function">cairo_region_status()</code></a>.</td>
|
335
|
+
<td class="parameter_name"><p>count</p></td>
|
336
|
+
<td class="parameter_description"><p>number of rectangles</p></td>
|
337
|
+
<td class="parameter_annotations"> </td>
|
185
338
|
</tr>
|
186
339
|
</tbody>
|
187
340
|
</table></div>
|
341
|
+
</div>
|
342
|
+
<div class="refsect3">
|
343
|
+
<a name="id-1.3.5.7.4.6"></a><h4>Returns</h4>
|
344
|
+
<p> A newly allocated <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>. Free with
|
345
|
+
<a class="link" href="cairo-Regions.html#cairo-region-destroy" title="cairo_region_destroy ()"><code class="function">cairo_region_destroy()</code></a>. This function always returns a
|
346
|
+
valid pointer; if memory cannot be allocated, then a special
|
347
|
+
error object is returned where all operations on the object do nothing.
|
348
|
+
You can check for this with <a class="link" href="cairo-Regions.html#cairo-region-status" title="cairo_region_status ()"><code class="function">cairo_region_status()</code></a>.</p>
|
349
|
+
<p></p>
|
350
|
+
</div>
|
188
351
|
<p class="since">Since 1.10</p>
|
189
352
|
</div>
|
190
353
|
<hr>
|
191
354
|
<div class="refsect2">
|
192
|
-
<a name="cairo-region-copy"></a><h3>cairo_region_copy
|
193
|
-
<pre class="programlisting"><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a>
|
194
|
-
<
|
195
|
-
Allocates a new region object copying the area from <em class="parameter"><code>original</code></em
|
196
|
-
|
197
|
-
<div class="
|
198
|
-
<
|
199
|
-
<
|
200
|
-
<
|
201
|
-
<
|
202
|
-
<
|
203
|
-
|
204
|
-
</
|
205
|
-
<tr>
|
206
|
-
<td
|
207
|
-
<td>
|
208
|
-
<
|
355
|
+
<a name="cairo-region-copy"></a><h3>cairo_region_copy ()</h3>
|
356
|
+
<pre class="programlisting"><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a> *
|
357
|
+
cairo_region_copy (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *original</code></em>);</pre>
|
358
|
+
<p>Allocates a new region object copying the area from <em class="parameter"><code>original</code></em>
|
359
|
+
.</p>
|
360
|
+
<div class="refsect3">
|
361
|
+
<a name="id-1.3.5.7.5.5"></a><h4>Parameters</h4>
|
362
|
+
<div class="informaltable"><table width="100%" border="0">
|
363
|
+
<colgroup>
|
364
|
+
<col width="150px" class="parameters_name">
|
365
|
+
<col class="parameters_description">
|
366
|
+
<col width="200px" class="parameters_annotations">
|
367
|
+
</colgroup>
|
368
|
+
<tbody><tr>
|
369
|
+
<td class="parameter_name"><p>original</p></td>
|
370
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
371
|
+
<td class="parameter_annotations"> </td>
|
372
|
+
</tr></tbody>
|
373
|
+
</table></div>
|
374
|
+
</div>
|
375
|
+
<div class="refsect3">
|
376
|
+
<a name="id-1.3.5.7.5.6"></a><h4>Returns</h4>
|
377
|
+
<p> A newly allocated <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>. Free with
|
378
|
+
<a class="link" href="cairo-Regions.html#cairo-region-destroy" title="cairo_region_destroy ()"><code class="function">cairo_region_destroy()</code></a>. This function always returns a
|
209
379
|
valid pointer; if memory cannot be allocated, then a special
|
210
380
|
error object is returned where all operations on the object do nothing.
|
211
|
-
You can check for this with <a class="link" href="cairo-Regions.html#cairo-region-status" title="cairo_region_status
|
212
|
-
|
213
|
-
</
|
214
|
-
</table></div>
|
381
|
+
You can check for this with <a class="link" href="cairo-Regions.html#cairo-region-status" title="cairo_region_status ()"><code class="function">cairo_region_status()</code></a>.</p>
|
382
|
+
<p></p>
|
383
|
+
</div>
|
215
384
|
<p class="since">Since 1.10</p>
|
216
385
|
</div>
|
217
386
|
<hr>
|
218
387
|
<div class="refsect2">
|
219
|
-
<a name="cairo-region-reference"></a><h3>cairo_region_reference
|
220
|
-
<pre class="programlisting"><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a>
|
221
|
-
<
|
222
|
-
Increases the reference count on <em class="parameter"><code>region</code></em>
|
223
|
-
|
224
|
-
<
|
225
|
-
|
226
|
-
<
|
227
|
-
<
|
228
|
-
<
|
229
|
-
<
|
230
|
-
<
|
231
|
-
<
|
232
|
-
|
233
|
-
|
234
|
-
|
235
|
-
<
|
236
|
-
<td
|
237
|
-
</
|
238
|
-
</
|
388
|
+
<a name="cairo-region-reference"></a><h3>cairo_region_reference ()</h3>
|
389
|
+
<pre class="programlisting"><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="returnvalue">cairo_region_t</span></a> *
|
390
|
+
cairo_region_reference (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *region</code></em>);</pre>
|
391
|
+
<p>Increases the reference count on <em class="parameter"><code>region</code></em>
|
392
|
+
by one. This prevents
|
393
|
+
<em class="parameter"><code>region</code></em>
|
394
|
+
from being destroyed until a matching call to
|
395
|
+
<a class="link" href="cairo-Regions.html#cairo-region-destroy" title="cairo_region_destroy ()"><code class="function">cairo_region_destroy()</code></a> is made.</p>
|
396
|
+
<div class="refsect3">
|
397
|
+
<a name="id-1.3.5.7.6.5"></a><h4>Parameters</h4>
|
398
|
+
<div class="informaltable"><table width="100%" border="0">
|
399
|
+
<colgroup>
|
400
|
+
<col width="150px" class="parameters_name">
|
401
|
+
<col class="parameters_description">
|
402
|
+
<col width="200px" class="parameters_annotations">
|
403
|
+
</colgroup>
|
404
|
+
<tbody><tr>
|
405
|
+
<td class="parameter_name"><p>region</p></td>
|
406
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
407
|
+
<td class="parameter_annotations"> </td>
|
408
|
+
</tr></tbody>
|
239
409
|
</table></div>
|
410
|
+
</div>
|
411
|
+
<div class="refsect3">
|
412
|
+
<a name="id-1.3.5.7.6.6"></a><h4>Returns</h4>
|
413
|
+
<p> the referenced <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>.</p>
|
414
|
+
<p></p>
|
415
|
+
</div>
|
240
416
|
<p class="since">Since 1.10</p>
|
241
417
|
</div>
|
242
418
|
<hr>
|
243
419
|
<div class="refsect2">
|
244
|
-
<a name="cairo-region-destroy"></a><h3>cairo_region_destroy
|
245
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
246
|
-
<
|
247
|
-
Destroys a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> object created with
|
248
|
-
<a class="link" href="cairo-Regions.html#cairo-region-create" title="cairo_region_create
|
249
|
-
or <a class="link" href="cairo-Regions.html#cairo-region-create-rectangle" title="cairo_region_create_rectangle
|
250
|
-
|
251
|
-
<
|
252
|
-
<
|
420
|
+
<a name="cairo-region-destroy"></a><h3>cairo_region_destroy ()</h3>
|
421
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
422
|
+
cairo_region_destroy (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *region</code></em>);</pre>
|
423
|
+
<p>Destroys a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> object created with
|
424
|
+
<a class="link" href="cairo-Regions.html#cairo-region-create" title="cairo_region_create ()"><code class="function">cairo_region_create()</code></a>, <a class="link" href="cairo-Regions.html#cairo-region-copy" title="cairo_region_copy ()"><code class="function">cairo_region_copy()</code></a>, or
|
425
|
+
or <a class="link" href="cairo-Regions.html#cairo-region-create-rectangle" title="cairo_region_create_rectangle ()"><code class="function">cairo_region_create_rectangle()</code></a>.</p>
|
426
|
+
<div class="refsect3">
|
427
|
+
<a name="id-1.3.5.7.7.5"></a><h4>Parameters</h4>
|
428
|
+
<div class="informaltable"><table width="100%" border="0">
|
429
|
+
<colgroup>
|
430
|
+
<col width="150px" class="parameters_name">
|
431
|
+
<col class="parameters_description">
|
432
|
+
<col width="200px" class="parameters_annotations">
|
433
|
+
</colgroup>
|
253
434
|
<tbody><tr>
|
254
|
-
<td
|
255
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
256
|
-
</td>
|
435
|
+
<td class="parameter_name"><p>region</p></td>
|
436
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
437
|
+
<td class="parameter_annotations"> </td>
|
257
438
|
</tr></tbody>
|
258
439
|
</table></div>
|
440
|
+
</div>
|
259
441
|
<p class="since">Since 1.10</p>
|
260
442
|
</div>
|
261
443
|
<hr>
|
262
444
|
<div class="refsect2">
|
263
|
-
<a name="cairo-region-status"></a><h3>cairo_region_status
|
264
|
-
<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>
|
265
|
-
<
|
266
|
-
Checks whether an error has previous occurred for this
|
267
|
-
region object
|
268
|
-
|
269
|
-
<
|
270
|
-
<
|
271
|
-
<
|
272
|
-
<
|
273
|
-
<
|
274
|
-
<
|
275
|
-
</
|
276
|
-
|
277
|
-
<
|
278
|
-
<td><p
|
279
|
-
<td>
|
280
|
-
|
281
|
-
</td>
|
282
|
-
</tr>
|
283
|
-
</tbody>
|
445
|
+
<a name="cairo-region-status"></a><h3>cairo_region_status ()</h3>
|
446
|
+
<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>
|
447
|
+
cairo_region_status (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *region</code></em>);</pre>
|
448
|
+
<p>Checks whether an error has previous occurred for this
|
449
|
+
region object.</p>
|
450
|
+
<div class="refsect3">
|
451
|
+
<a name="id-1.3.5.7.8.5"></a><h4>Parameters</h4>
|
452
|
+
<div class="informaltable"><table width="100%" border="0">
|
453
|
+
<colgroup>
|
454
|
+
<col width="150px" class="parameters_name">
|
455
|
+
<col class="parameters_description">
|
456
|
+
<col width="200px" class="parameters_annotations">
|
457
|
+
</colgroup>
|
458
|
+
<tbody><tr>
|
459
|
+
<td class="parameter_name"><p>region</p></td>
|
460
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
461
|
+
<td class="parameter_annotations"> </td>
|
462
|
+
</tr></tbody>
|
284
463
|
</table></div>
|
464
|
+
</div>
|
465
|
+
<div class="refsect3">
|
466
|
+
<a name="id-1.3.5.7.8.6"></a><h4>Returns</h4>
|
467
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a></p>
|
468
|
+
<p></p>
|
469
|
+
</div>
|
285
470
|
<p class="since">Since 1.10</p>
|
286
471
|
</div>
|
287
472
|
<hr>
|
288
473
|
<div class="refsect2">
|
289
|
-
<a name="cairo-region-get-extents"></a><h3>cairo_region_get_extents
|
290
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
291
|
-
|
292
|
-
<
|
293
|
-
Gets the bounding rectangle of <em class="parameter"><code>region</code></em>
|
294
|
-
</p>
|
295
|
-
<div class="
|
296
|
-
<
|
474
|
+
<a name="cairo-region-get-extents"></a><h3>cairo_region_get_extents ()</h3>
|
475
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
476
|
+
cairo_region_get_extents (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *region</code></em>,
|
477
|
+
<em class="parameter"><code><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>
|
478
|
+
<p>Gets the bounding rectangle of <em class="parameter"><code>region</code></em>
|
479
|
+
as a <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></p>
|
480
|
+
<div class="refsect3">
|
481
|
+
<a name="id-1.3.5.7.9.5"></a><h4>Parameters</h4>
|
482
|
+
<div class="informaltable"><table width="100%" border="0">
|
483
|
+
<colgroup>
|
484
|
+
<col width="150px" class="parameters_name">
|
485
|
+
<col class="parameters_description">
|
486
|
+
<col width="200px" class="parameters_annotations">
|
487
|
+
</colgroup>
|
297
488
|
<tbody>
|
298
489
|
<tr>
|
299
|
-
<td
|
300
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
301
|
-
</td>
|
490
|
+
<td class="parameter_name"><p>region</p></td>
|
491
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
492
|
+
<td class="parameter_annotations"> </td>
|
302
493
|
</tr>
|
303
494
|
<tr>
|
304
|
-
<td
|
305
|
-
<td>rectangle into which to store the extents</td>
|
495
|
+
<td class="parameter_name"><p>extents</p></td>
|
496
|
+
<td class="parameter_description"><p>rectangle into which to store the extents</p></td>
|
497
|
+
<td class="parameter_annotations"> </td>
|
306
498
|
</tr>
|
307
499
|
</tbody>
|
308
500
|
</table></div>
|
501
|
+
</div>
|
309
502
|
<p class="since">Since 1.10</p>
|
310
503
|
</div>
|
311
504
|
<hr>
|
312
505
|
<div class="refsect2">
|
313
|
-
<a name="cairo-region-num-rectangles"></a><h3>cairo_region_num_rectangles
|
314
|
-
<pre class="programlisting"><span class="returnvalue">int</span>
|
315
|
-
<
|
316
|
-
Returns the number of rectangles contained in <em class="parameter"><code>region</code></em
|
317
|
-
|
318
|
-
<div class="
|
319
|
-
<
|
320
|
-
<
|
321
|
-
<
|
322
|
-
<
|
323
|
-
<
|
324
|
-
|
325
|
-
</
|
326
|
-
<tr>
|
327
|
-
<td
|
328
|
-
<td>
|
329
|
-
</
|
330
|
-
</tbody>
|
506
|
+
<a name="cairo-region-num-rectangles"></a><h3>cairo_region_num_rectangles ()</h3>
|
507
|
+
<pre class="programlisting"><span class="returnvalue">int</span>
|
508
|
+
cairo_region_num_rectangles (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *region</code></em>);</pre>
|
509
|
+
<p>Returns the number of rectangles contained in <em class="parameter"><code>region</code></em>
|
510
|
+
.</p>
|
511
|
+
<div class="refsect3">
|
512
|
+
<a name="id-1.3.5.7.10.5"></a><h4>Parameters</h4>
|
513
|
+
<div class="informaltable"><table width="100%" border="0">
|
514
|
+
<colgroup>
|
515
|
+
<col width="150px" class="parameters_name">
|
516
|
+
<col class="parameters_description">
|
517
|
+
<col width="200px" class="parameters_annotations">
|
518
|
+
</colgroup>
|
519
|
+
<tbody><tr>
|
520
|
+
<td class="parameter_name"><p>region</p></td>
|
521
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
522
|
+
<td class="parameter_annotations"> </td>
|
523
|
+
</tr></tbody>
|
331
524
|
</table></div>
|
525
|
+
</div>
|
526
|
+
<div class="refsect3">
|
527
|
+
<a name="id-1.3.5.7.10.6"></a><h4>Returns</h4>
|
528
|
+
<p> The number of rectangles contained in <em class="parameter"><code>region</code></em>
|
529
|
+
.</p>
|
530
|
+
<p></p>
|
531
|
+
</div>
|
332
532
|
<p class="since">Since 1.10</p>
|
333
533
|
</div>
|
334
534
|
<hr>
|
335
535
|
<div class="refsect2">
|
336
|
-
<a name="cairo-region-get-rectangle"></a><h3>cairo_region_get_rectangle
|
337
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
338
|
-
|
339
|
-
|
340
|
-
<
|
341
|
-
Stores the <em class="parameter"><code>nth</code></em>
|
342
|
-
</
|
343
|
-
|
344
|
-
<
|
536
|
+
<a name="cairo-region-get-rectangle"></a><h3>cairo_region_get_rectangle ()</h3>
|
537
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
538
|
+
cairo_region_get_rectangle (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *region</code></em>,
|
539
|
+
<em class="parameter"><code><span class="type">int</span> nth</code></em>,
|
540
|
+
<em class="parameter"><code><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> *rectangle</code></em>);</pre>
|
541
|
+
<p>Stores the <em class="parameter"><code>nth</code></em>
|
542
|
+
rectangle from the region in <em class="parameter"><code>rectangle</code></em>
|
543
|
+
.</p>
|
544
|
+
<div class="refsect3">
|
545
|
+
<a name="id-1.3.5.7.11.5"></a><h4>Parameters</h4>
|
546
|
+
<div class="informaltable"><table width="100%" border="0">
|
547
|
+
<colgroup>
|
548
|
+
<col width="150px" class="parameters_name">
|
549
|
+
<col class="parameters_description">
|
550
|
+
<col width="200px" class="parameters_annotations">
|
551
|
+
</colgroup>
|
345
552
|
<tbody>
|
346
553
|
<tr>
|
347
|
-
<td
|
348
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
349
|
-
</td>
|
554
|
+
<td class="parameter_name"><p>region</p></td>
|
555
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
556
|
+
<td class="parameter_annotations"> </td>
|
350
557
|
</tr>
|
351
558
|
<tr>
|
352
|
-
<td
|
353
|
-
<td>a number indicating which rectangle should be returned</td>
|
559
|
+
<td class="parameter_name"><p>nth</p></td>
|
560
|
+
<td class="parameter_description"><p>a number indicating which rectangle should be returned</p></td>
|
561
|
+
<td class="parameter_annotations"> </td>
|
354
562
|
</tr>
|
355
563
|
<tr>
|
356
|
-
<td
|
357
|
-
<td>return location for a <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>
|
358
|
-
</td>
|
564
|
+
<td class="parameter_name"><p>rectangle</p></td>
|
565
|
+
<td class="parameter_description"><p>return location for a <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></p></td>
|
566
|
+
<td class="parameter_annotations"> </td>
|
359
567
|
</tr>
|
360
568
|
</tbody>
|
361
569
|
</table></div>
|
570
|
+
</div>
|
362
571
|
<p class="since">Since 1.10</p>
|
363
572
|
</div>
|
364
573
|
<hr>
|
365
574
|
<div class="refsect2">
|
366
|
-
<a name="cairo-region-is-empty"></a><h3>cairo_region_is_empty
|
367
|
-
<pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
368
|
-
<
|
369
|
-
Checks whether <em class="parameter"><code>region</code></em>
|
370
|
-
|
371
|
-
<div class="
|
372
|
-
<
|
373
|
-
<
|
374
|
-
<
|
375
|
-
<
|
376
|
-
<
|
377
|
-
|
378
|
-
</
|
379
|
-
<tr>
|
380
|
-
<td
|
381
|
-
<td>
|
382
|
-
<
|
383
|
-
</tr>
|
384
|
-
</tbody>
|
575
|
+
<a name="cairo-region-is-empty"></a><h3>cairo_region_is_empty ()</h3>
|
576
|
+
<pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
577
|
+
cairo_region_is_empty (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *region</code></em>);</pre>
|
578
|
+
<p>Checks whether <em class="parameter"><code>region</code></em>
|
579
|
+
is empty.</p>
|
580
|
+
<div class="refsect3">
|
581
|
+
<a name="id-1.3.5.7.12.5"></a><h4>Parameters</h4>
|
582
|
+
<div class="informaltable"><table width="100%" border="0">
|
583
|
+
<colgroup>
|
584
|
+
<col width="150px" class="parameters_name">
|
585
|
+
<col class="parameters_description">
|
586
|
+
<col width="200px" class="parameters_annotations">
|
587
|
+
</colgroup>
|
588
|
+
<tbody><tr>
|
589
|
+
<td class="parameter_name"><p>region</p></td>
|
590
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
591
|
+
<td class="parameter_annotations"> </td>
|
592
|
+
</tr></tbody>
|
385
593
|
</table></div>
|
594
|
+
</div>
|
595
|
+
<div class="refsect3">
|
596
|
+
<a name="id-1.3.5.7.12.6"></a><h4>Returns</h4>
|
597
|
+
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>region</code></em>
|
598
|
+
is empty, <code class="literal">FALSE</code> if it isn't.</p>
|
599
|
+
<p></p>
|
600
|
+
</div>
|
386
601
|
<p class="since">Since 1.10</p>
|
387
602
|
</div>
|
388
603
|
<hr>
|
389
604
|
<div class="refsect2">
|
390
|
-
<a name="cairo-region-contains-point"></a><h3>cairo_region_contains_point
|
391
|
-
<pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
392
|
-
|
393
|
-
|
394
|
-
<
|
395
|
-
Checks whether (<em class="parameter"><code>x</code></em
|
396
|
-
</
|
397
|
-
<
|
398
|
-
|
605
|
+
<a name="cairo-region-contains-point"></a><h3>cairo_region_contains_point ()</h3>
|
606
|
+
<pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
607
|
+
cairo_region_contains_point (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *region</code></em>,
|
608
|
+
<em class="parameter"><code><span class="type">int</span> x</code></em>,
|
609
|
+
<em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
|
610
|
+
<p>Checks whether (<em class="parameter"><code>x</code></em>
|
611
|
+
, <em class="parameter"><code>y</code></em>
|
612
|
+
) is contained in <em class="parameter"><code>region</code></em>
|
613
|
+
.</p>
|
614
|
+
<div class="refsect3">
|
615
|
+
<a name="id-1.3.5.7.13.5"></a><h4>Parameters</h4>
|
616
|
+
<div class="informaltable"><table width="100%" border="0">
|
617
|
+
<colgroup>
|
618
|
+
<col width="150px" class="parameters_name">
|
619
|
+
<col class="parameters_description">
|
620
|
+
<col width="200px" class="parameters_annotations">
|
621
|
+
</colgroup>
|
399
622
|
<tbody>
|
400
623
|
<tr>
|
401
|
-
<td
|
402
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
403
|
-
</td>
|
624
|
+
<td class="parameter_name"><p>region</p></td>
|
625
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
626
|
+
<td class="parameter_annotations"> </td>
|
404
627
|
</tr>
|
405
628
|
<tr>
|
406
|
-
<td
|
407
|
-
<td>the x coordinate of a point</td>
|
629
|
+
<td class="parameter_name"><p>x</p></td>
|
630
|
+
<td class="parameter_description"><p>the x coordinate of a point</p></td>
|
631
|
+
<td class="parameter_annotations"> </td>
|
408
632
|
</tr>
|
409
633
|
<tr>
|
410
|
-
<td
|
411
|
-
<td>the y coordinate of a point</td>
|
412
|
-
</
|
413
|
-
<tr>
|
414
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
415
|
-
<td>
|
416
|
-
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>) is contained in <em class="parameter"><code>region</code></em>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it is not.</td>
|
634
|
+
<td class="parameter_name"><p>y</p></td>
|
635
|
+
<td class="parameter_description"><p>the y coordinate of a point</p></td>
|
636
|
+
<td class="parameter_annotations"> </td>
|
417
637
|
</tr>
|
418
638
|
</tbody>
|
419
639
|
</table></div>
|
640
|
+
</div>
|
641
|
+
<div class="refsect3">
|
642
|
+
<a name="id-1.3.5.7.13.6"></a><h4>Returns</h4>
|
643
|
+
<p> <code class="literal">TRUE</code> if (<em class="parameter"><code>x</code></em>
|
644
|
+
, <em class="parameter"><code>y</code></em>
|
645
|
+
) is contained in <em class="parameter"><code>region</code></em>
|
646
|
+
, <code class="literal">FALSE</code> if it is not.</p>
|
647
|
+
<p></p>
|
648
|
+
</div>
|
420
649
|
<p class="since">Since 1.10</p>
|
421
650
|
</div>
|
422
651
|
<hr>
|
423
652
|
<div class="refsect2">
|
424
|
-
<a name="cairo-region-
|
425
|
-
<pre class="programlisting"
|
426
|
-
|
427
|
-
|
428
|
-
|
429
|
-
|
430
|
-
</
|
431
|
-
<p>
|
432
|
-
Used as the return value for <a class="link" href="cairo-Regions.html#cairo-region-contains-rectangle" title="cairo_region_contains_rectangle ()"><code class="function">cairo_region_contains_rectangle()</code></a>.
|
653
|
+
<a name="cairo-region-contains-rectangle"></a><h3>cairo_region_contains_rectangle ()</h3>
|
654
|
+
<pre class="programlisting"><a class="link" href="cairo-Regions.html#cairo-region-overlap-t" title="enum cairo_region_overlap_t"><span class="returnvalue">cairo_region_overlap_t</span></a>
|
655
|
+
cairo_region_contains_rectangle (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *region</code></em>,
|
656
|
+
<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> *rectangle</code></em>);</pre>
|
657
|
+
<p>Checks whether <em class="parameter"><code>rectangle</code></em>
|
658
|
+
is inside, outside or partially contained
|
659
|
+
in <em class="parameter"><code>region</code></em>
|
433
660
|
</p>
|
434
|
-
<div class="
|
435
|
-
<
|
661
|
+
<div class="refsect3">
|
662
|
+
<a name="id-1.3.5.7.14.5"></a><h4>Parameters</h4>
|
663
|
+
<div class="informaltable"><table width="100%" border="0">
|
664
|
+
<colgroup>
|
665
|
+
<col width="150px" class="parameters_name">
|
666
|
+
<col class="parameters_description">
|
667
|
+
<col width="200px" class="parameters_annotations">
|
668
|
+
</colgroup>
|
436
669
|
<tbody>
|
437
670
|
<tr>
|
438
|
-
<td
|
439
|
-
<td>
|
440
|
-
</td>
|
671
|
+
<td class="parameter_name"><p>region</p></td>
|
672
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
673
|
+
<td class="parameter_annotations"> </td>
|
441
674
|
</tr>
|
442
675
|
<tr>
|
443
|
-
<td
|
444
|
-
<td>
|
445
|
-
</td>
|
446
|
-
</tr>
|
447
|
-
<tr>
|
448
|
-
<td><p><a name="CAIRO-REGION-OVERLAP-PART:CAPS"></a><span class="term"><code class="literal">CAIRO_REGION_OVERLAP_PART</code></span></p></td>
|
449
|
-
<td>The contents are partially inside and
|
450
|
-
partially outside the region. (Since 1.10)
|
451
|
-
</td>
|
676
|
+
<td class="parameter_name"><p>rectangle</p></td>
|
677
|
+
<td class="parameter_description"><p>a <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></p></td>
|
678
|
+
<td class="parameter_annotations"> </td>
|
452
679
|
</tr>
|
453
680
|
</tbody>
|
454
681
|
</table></div>
|
682
|
+
</div>
|
683
|
+
<div class="refsect3">
|
684
|
+
<a name="id-1.3.5.7.14.6"></a><h4>Returns</h4>
|
685
|
+
<p> <a class="link" href="cairo-Regions.html#CAIRO-REGION-OVERLAP-IN:CAPS"><code class="literal">CAIRO_REGION_OVERLAP_IN</code></a> if <em class="parameter"><code>rectangle</code></em>
|
686
|
+
is entirely inside <em class="parameter"><code>region</code></em>
|
687
|
+
,
|
688
|
+
<a class="link" href="cairo-Regions.html#CAIRO-REGION-OVERLAP-OUT:CAPS"><code class="literal">CAIRO_REGION_OVERLAP_OUT</code></a> if <em class="parameter"><code>rectangle</code></em>
|
689
|
+
is entirely outside <em class="parameter"><code>region</code></em>
|
690
|
+
, or
|
691
|
+
<a class="link" href="cairo-Regions.html#CAIRO-REGION-OVERLAP-PART:CAPS"><code class="literal">CAIRO_REGION_OVERLAP_PART</code></a> if <em class="parameter"><code>rectangle</code></em>
|
692
|
+
is partially inside and partially outside <em class="parameter"><code>region</code></em>
|
693
|
+
.</p>
|
694
|
+
<p></p>
|
695
|
+
</div>
|
455
696
|
<p class="since">Since 1.10</p>
|
456
697
|
</div>
|
457
698
|
<hr>
|
458
699
|
<div class="refsect2">
|
459
|
-
<a name="cairo-region-
|
460
|
-
<pre class="programlisting"><a class="link" href="cairo-
|
461
|
-
|
462
|
-
<
|
463
|
-
|
464
|
-
|
465
|
-
|
466
|
-
<
|
467
|
-
<
|
700
|
+
<a name="cairo-region-equal"></a><h3>cairo_region_equal ()</h3>
|
701
|
+
<pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>
|
702
|
+
cairo_region_equal (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *a</code></em>,
|
703
|
+
<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *b</code></em>);</pre>
|
704
|
+
<p>Compares whether region_a is equivalent to region_b. <code class="literal">NULL</code> as an argument
|
705
|
+
is equal to itself, but not to any non-<code class="literal">NULL</code> region.</p>
|
706
|
+
<div class="refsect3">
|
707
|
+
<a name="id-1.3.5.7.15.5"></a><h4>Parameters</h4>
|
708
|
+
<div class="informaltable"><table width="100%" border="0">
|
709
|
+
<colgroup>
|
710
|
+
<col width="150px" class="parameters_name">
|
711
|
+
<col class="parameters_description">
|
712
|
+
<col width="200px" class="parameters_annotations">
|
713
|
+
</colgroup>
|
468
714
|
<tbody>
|
469
715
|
<tr>
|
470
|
-
<td
|
471
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
472
|
-
</td>
|
473
|
-
</tr>
|
474
|
-
<tr>
|
475
|
-
<td><p><span class="term"><em class="parameter"><code>rectangle</code></em> :</span></p></td>
|
476
|
-
<td>a <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>
|
477
|
-
</td>
|
716
|
+
<td class="parameter_name"><p>a</p></td>
|
717
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> or <code class="literal">NULL</code></p></td>
|
718
|
+
<td class="parameter_annotations"> </td>
|
478
719
|
</tr>
|
479
720
|
<tr>
|
480
|
-
<td
|
481
|
-
<td>
|
482
|
-
<
|
483
|
-
<a class="link" href="cairo-Regions.html#CAIRO-REGION-OVERLAP-OUT:CAPS"><code class="literal">CAIRO_REGION_OVERLAP_OUT</code></a> if <em class="parameter"><code>rectangle</code></em> is entirely outside <em class="parameter"><code>region</code></em>, or
|
484
|
-
<a class="link" href="cairo-Regions.html#CAIRO-REGION-OVERLAP-PART:CAPS"><code class="literal">CAIRO_REGION_OVERLAP_PART</code></a> if <em class="parameter"><code>rectangle</code></em> is partially inside and partially outside <em class="parameter"><code>region</code></em>.</td>
|
721
|
+
<td class="parameter_name"><p>b</p></td>
|
722
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> or <code class="literal">NULL</code></p></td>
|
723
|
+
<td class="parameter_annotations"> </td>
|
485
724
|
</tr>
|
486
725
|
</tbody>
|
487
726
|
</table></div>
|
727
|
+
</div>
|
728
|
+
<div class="refsect3">
|
729
|
+
<a name="id-1.3.5.7.15.6"></a><h4>Returns</h4>
|
730
|
+
<p> <code class="literal">TRUE</code> if both regions contained the same coverage,
|
731
|
+
<code class="literal">FALSE</code> if it is not or any region is in an error status.</p>
|
732
|
+
<p></p>
|
733
|
+
</div>
|
488
734
|
<p class="since">Since 1.10</p>
|
489
735
|
</div>
|
490
736
|
<hr>
|
491
737
|
<div class="refsect2">
|
492
|
-
<a name="cairo-region-
|
493
|
-
<pre class="programlisting"><
|
494
|
-
|
495
|
-
<
|
496
|
-
|
497
|
-
|
498
|
-
</
|
499
|
-
<
|
500
|
-
|
738
|
+
<a name="cairo-region-translate"></a><h3>cairo_region_translate ()</h3>
|
739
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
740
|
+
cairo_region_translate (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *region</code></em>,
|
741
|
+
<em class="parameter"><code><span class="type">int</span> dx</code></em>,
|
742
|
+
<em class="parameter"><code><span class="type">int</span> dy</code></em>);</pre>
|
743
|
+
<p>Translates <em class="parameter"><code>region</code></em>
|
744
|
+
by (<em class="parameter"><code>dx</code></em>
|
745
|
+
, <em class="parameter"><code>dy</code></em>
|
746
|
+
).</p>
|
747
|
+
<div class="refsect3">
|
748
|
+
<a name="id-1.3.5.7.16.5"></a><h4>Parameters</h4>
|
749
|
+
<div class="informaltable"><table width="100%" border="0">
|
750
|
+
<colgroup>
|
751
|
+
<col width="150px" class="parameters_name">
|
752
|
+
<col class="parameters_description">
|
753
|
+
<col width="200px" class="parameters_annotations">
|
754
|
+
</colgroup>
|
501
755
|
<tbody>
|
502
756
|
<tr>
|
503
|
-
<td
|
504
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a
|
505
|
-
</td>
|
757
|
+
<td class="parameter_name"><p>region</p></td>
|
758
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
759
|
+
<td class="parameter_annotations"> </td>
|
506
760
|
</tr>
|
507
761
|
<tr>
|
508
|
-
<td
|
509
|
-
<td
|
510
|
-
</td>
|
762
|
+
<td class="parameter_name"><p>dx</p></td>
|
763
|
+
<td class="parameter_description"><p>Amount to translate in the x direction</p></td>
|
764
|
+
<td class="parameter_annotations"> </td>
|
511
765
|
</tr>
|
512
766
|
<tr>
|
513
|
-
<td
|
514
|
-
<td>
|
515
|
-
<
|
516
|
-
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it is not or any region is in an error status.</td>
|
767
|
+
<td class="parameter_name"><p>dy</p></td>
|
768
|
+
<td class="parameter_description"><p>Amount to translate in the y direction</p></td>
|
769
|
+
<td class="parameter_annotations"> </td>
|
517
770
|
</tr>
|
518
771
|
</tbody>
|
519
772
|
</table></div>
|
773
|
+
</div>
|
520
774
|
<p class="since">Since 1.10</p>
|
521
775
|
</div>
|
522
776
|
<hr>
|
523
777
|
<div class="refsect2">
|
524
|
-
<a name="cairo-region-
|
525
|
-
<pre class="programlisting"><
|
526
|
-
|
527
|
-
|
528
|
-
<p>
|
529
|
-
|
778
|
+
<a name="cairo-region-intersect"></a><h3>cairo_region_intersect ()</h3>
|
779
|
+
<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>
|
780
|
+
cairo_region_intersect (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *dst</code></em>,
|
781
|
+
<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *other</code></em>);</pre>
|
782
|
+
<p>Computes the intersection of <em class="parameter"><code>dst</code></em>
|
783
|
+
with <em class="parameter"><code>other</code></em>
|
784
|
+
and places the result in <em class="parameter"><code>dst</code></em>
|
530
785
|
</p>
|
531
|
-
<div class="
|
532
|
-
<
|
786
|
+
<div class="refsect3">
|
787
|
+
<a name="id-1.3.5.7.17.5"></a><h4>Parameters</h4>
|
788
|
+
<div class="informaltable"><table width="100%" border="0">
|
789
|
+
<colgroup>
|
790
|
+
<col width="150px" class="parameters_name">
|
791
|
+
<col class="parameters_description">
|
792
|
+
<col width="200px" class="parameters_annotations">
|
793
|
+
</colgroup>
|
533
794
|
<tbody>
|
534
795
|
<tr>
|
535
|
-
<td
|
536
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
537
|
-
</td>
|
538
|
-
</tr>
|
539
|
-
<tr>
|
540
|
-
<td><p><span class="term"><em class="parameter"><code>dx</code></em> :</span></p></td>
|
541
|
-
<td>Amount to translate in the x direction</td>
|
796
|
+
<td class="parameter_name"><p>dst</p></td>
|
797
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
798
|
+
<td class="parameter_annotations"> </td>
|
542
799
|
</tr>
|
543
800
|
<tr>
|
544
|
-
<td
|
545
|
-
<td>
|
801
|
+
<td class="parameter_name"><p>other</p></td>
|
802
|
+
<td class="parameter_description"><p>another <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
803
|
+
<td class="parameter_annotations"> </td>
|
546
804
|
</tr>
|
547
805
|
</tbody>
|
548
806
|
</table></div>
|
807
|
+
</div>
|
808
|
+
<div class="refsect3">
|
809
|
+
<a name="id-1.3.5.7.17.6"></a><h4>Returns</h4>
|
810
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a></p>
|
811
|
+
<p></p>
|
812
|
+
</div>
|
549
813
|
<p class="since">Since 1.10</p>
|
550
814
|
</div>
|
551
815
|
<hr>
|
552
816
|
<div class="refsect2">
|
553
|
-
<a name="cairo-region-intersect"></a><h3>
|
554
|
-
<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>
|
555
|
-
|
556
|
-
<
|
557
|
-
Computes the intersection of <em class="parameter"><code>dst</code></em>
|
817
|
+
<a name="cairo-region-intersect-rectangle"></a><h3>cairo_region_intersect_rectangle ()</h3>
|
818
|
+
<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>
|
819
|
+
cairo_region_intersect_rectangle (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *dst</code></em>,
|
820
|
+
<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> *rectangle</code></em>);</pre>
|
821
|
+
<p>Computes the intersection of <em class="parameter"><code>dst</code></em>
|
822
|
+
with <em class="parameter"><code>rectangle</code></em>
|
823
|
+
and places the
|
824
|
+
result in <em class="parameter"><code>dst</code></em>
|
558
825
|
</p>
|
559
|
-
<div class="
|
560
|
-
<
|
826
|
+
<div class="refsect3">
|
827
|
+
<a name="id-1.3.5.7.18.5"></a><h4>Parameters</h4>
|
828
|
+
<div class="informaltable"><table width="100%" border="0">
|
829
|
+
<colgroup>
|
830
|
+
<col width="150px" class="parameters_name">
|
831
|
+
<col class="parameters_description">
|
832
|
+
<col width="200px" class="parameters_annotations">
|
833
|
+
</colgroup>
|
561
834
|
<tbody>
|
562
835
|
<tr>
|
563
|
-
<td
|
564
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
565
|
-
</td>
|
566
|
-
</tr>
|
567
|
-
<tr>
|
568
|
-
<td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
|
569
|
-
<td>another <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
570
|
-
</td>
|
836
|
+
<td class="parameter_name"><p>dst</p></td>
|
837
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
838
|
+
<td class="parameter_annotations"> </td>
|
571
839
|
</tr>
|
572
840
|
<tr>
|
573
|
-
<td
|
574
|
-
<td>
|
575
|
-
<
|
576
|
-
</td>
|
841
|
+
<td class="parameter_name"><p>rectangle</p></td>
|
842
|
+
<td class="parameter_description"><p>a <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></p></td>
|
843
|
+
<td class="parameter_annotations"> </td>
|
577
844
|
</tr>
|
578
845
|
</tbody>
|
579
846
|
</table></div>
|
847
|
+
</div>
|
848
|
+
<div class="refsect3">
|
849
|
+
<a name="id-1.3.5.7.18.6"></a><h4>Returns</h4>
|
850
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a></p>
|
851
|
+
<p></p>
|
852
|
+
</div>
|
580
853
|
<p class="since">Since 1.10</p>
|
581
854
|
</div>
|
582
855
|
<hr>
|
583
856
|
<div class="refsect2">
|
584
|
-
<a name="cairo-region-
|
585
|
-
<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>
|
586
|
-
|
587
|
-
<
|
588
|
-
|
589
|
-
|
857
|
+
<a name="cairo-region-subtract"></a><h3>cairo_region_subtract ()</h3>
|
858
|
+
<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>
|
859
|
+
cairo_region_subtract (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *dst</code></em>,
|
860
|
+
<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *other</code></em>);</pre>
|
861
|
+
<p>Subtracts <em class="parameter"><code>other</code></em>
|
862
|
+
from <em class="parameter"><code>dst</code></em>
|
863
|
+
and places the result in <em class="parameter"><code>dst</code></em>
|
590
864
|
</p>
|
591
|
-
<div class="
|
592
|
-
<
|
865
|
+
<div class="refsect3">
|
866
|
+
<a name="id-1.3.5.7.19.5"></a><h4>Parameters</h4>
|
867
|
+
<div class="informaltable"><table width="100%" border="0">
|
868
|
+
<colgroup>
|
869
|
+
<col width="150px" class="parameters_name">
|
870
|
+
<col class="parameters_description">
|
871
|
+
<col width="200px" class="parameters_annotations">
|
872
|
+
</colgroup>
|
593
873
|
<tbody>
|
594
874
|
<tr>
|
595
|
-
<td
|
596
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
597
|
-
</td>
|
598
|
-
</tr>
|
599
|
-
<tr>
|
600
|
-
<td><p><span class="term"><em class="parameter"><code>rectangle</code></em> :</span></p></td>
|
601
|
-
<td>a <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>
|
602
|
-
</td>
|
875
|
+
<td class="parameter_name"><p>dst</p></td>
|
876
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
877
|
+
<td class="parameter_annotations"> </td>
|
603
878
|
</tr>
|
604
879
|
<tr>
|
605
|
-
<td
|
606
|
-
<td>
|
607
|
-
<
|
608
|
-
</td>
|
880
|
+
<td class="parameter_name"><p>other</p></td>
|
881
|
+
<td class="parameter_description"><p>another <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
882
|
+
<td class="parameter_annotations"> </td>
|
609
883
|
</tr>
|
610
884
|
</tbody>
|
611
885
|
</table></div>
|
886
|
+
</div>
|
887
|
+
<div class="refsect3">
|
888
|
+
<a name="id-1.3.5.7.19.6"></a><h4>Returns</h4>
|
889
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a></p>
|
890
|
+
<p></p>
|
891
|
+
</div>
|
612
892
|
<p class="since">Since 1.10</p>
|
613
893
|
</div>
|
614
894
|
<hr>
|
615
895
|
<div class="refsect2">
|
616
|
-
<a name="cairo-region-subtract"></a><h3>
|
617
|
-
<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>
|
618
|
-
|
619
|
-
<
|
620
|
-
|
896
|
+
<a name="cairo-region-subtract-rectangle"></a><h3>cairo_region_subtract_rectangle ()</h3>
|
897
|
+
<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>
|
898
|
+
cairo_region_subtract_rectangle (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *dst</code></em>,
|
899
|
+
<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> *rectangle</code></em>);</pre>
|
900
|
+
<p>Subtracts <em class="parameter"><code>rectangle</code></em>
|
901
|
+
from <em class="parameter"><code>dst</code></em>
|
902
|
+
and places the result in <em class="parameter"><code>dst</code></em>
|
621
903
|
</p>
|
622
|
-
<div class="
|
623
|
-
<
|
904
|
+
<div class="refsect3">
|
905
|
+
<a name="id-1.3.5.7.20.5"></a><h4>Parameters</h4>
|
906
|
+
<div class="informaltable"><table width="100%" border="0">
|
907
|
+
<colgroup>
|
908
|
+
<col width="150px" class="parameters_name">
|
909
|
+
<col class="parameters_description">
|
910
|
+
<col width="200px" class="parameters_annotations">
|
911
|
+
</colgroup>
|
624
912
|
<tbody>
|
625
913
|
<tr>
|
626
|
-
<td
|
627
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
628
|
-
</td>
|
629
|
-
</tr>
|
630
|
-
<tr>
|
631
|
-
<td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
|
632
|
-
<td>another <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
633
|
-
</td>
|
914
|
+
<td class="parameter_name"><p>dst</p></td>
|
915
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
916
|
+
<td class="parameter_annotations"> </td>
|
634
917
|
</tr>
|
635
918
|
<tr>
|
636
|
-
<td
|
637
|
-
<td>
|
638
|
-
<
|
639
|
-
</td>
|
919
|
+
<td class="parameter_name"><p>rectangle</p></td>
|
920
|
+
<td class="parameter_description"><p>a <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></p></td>
|
921
|
+
<td class="parameter_annotations"> </td>
|
640
922
|
</tr>
|
641
923
|
</tbody>
|
642
924
|
</table></div>
|
925
|
+
</div>
|
926
|
+
<div class="refsect3">
|
927
|
+
<a name="id-1.3.5.7.20.6"></a><h4>Returns</h4>
|
928
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a></p>
|
929
|
+
<p></p>
|
930
|
+
</div>
|
643
931
|
<p class="since">Since 1.10</p>
|
644
932
|
</div>
|
645
933
|
<hr>
|
646
934
|
<div class="refsect2">
|
647
|
-
<a name="cairo-region-
|
648
|
-
<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>
|
649
|
-
|
650
|
-
<
|
651
|
-
|
935
|
+
<a name="cairo-region-union"></a><h3>cairo_region_union ()</h3>
|
936
|
+
<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>
|
937
|
+
cairo_region_union (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *dst</code></em>,
|
938
|
+
<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *other</code></em>);</pre>
|
939
|
+
<p>Computes the union of <em class="parameter"><code>dst</code></em>
|
940
|
+
with <em class="parameter"><code>other</code></em>
|
941
|
+
and places the result in <em class="parameter"><code>dst</code></em>
|
652
942
|
</p>
|
653
|
-
<div class="
|
654
|
-
<
|
943
|
+
<div class="refsect3">
|
944
|
+
<a name="id-1.3.5.7.21.5"></a><h4>Parameters</h4>
|
945
|
+
<div class="informaltable"><table width="100%" border="0">
|
946
|
+
<colgroup>
|
947
|
+
<col width="150px" class="parameters_name">
|
948
|
+
<col class="parameters_description">
|
949
|
+
<col width="200px" class="parameters_annotations">
|
950
|
+
</colgroup>
|
655
951
|
<tbody>
|
656
952
|
<tr>
|
657
|
-
<td
|
658
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
659
|
-
</td>
|
953
|
+
<td class="parameter_name"><p>dst</p></td>
|
954
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
955
|
+
<td class="parameter_annotations"> </td>
|
660
956
|
</tr>
|
661
957
|
<tr>
|
662
|
-
<td
|
663
|
-
<td>
|
664
|
-
</td>
|
665
|
-
</tr>
|
666
|
-
<tr>
|
667
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
668
|
-
<td>
|
669
|
-
<a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>
|
670
|
-
</td>
|
958
|
+
<td class="parameter_name"><p>other</p></td>
|
959
|
+
<td class="parameter_description"><p>another <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
960
|
+
<td class="parameter_annotations"> </td>
|
671
961
|
</tr>
|
672
962
|
</tbody>
|
673
963
|
</table></div>
|
964
|
+
</div>
|
965
|
+
<div class="refsect3">
|
966
|
+
<a name="id-1.3.5.7.21.6"></a><h4>Returns</h4>
|
967
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a></p>
|
968
|
+
<p></p>
|
969
|
+
</div>
|
674
970
|
<p class="since">Since 1.10</p>
|
675
971
|
</div>
|
676
972
|
<hr>
|
677
973
|
<div class="refsect2">
|
678
|
-
<a name="cairo-region-union"></a><h3>
|
679
|
-
<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>
|
680
|
-
|
681
|
-
<
|
682
|
-
Computes the union of <em class="parameter"><code>dst</code></em>
|
683
|
-
</
|
684
|
-
<
|
685
|
-
|
974
|
+
<a name="cairo-region-union-rectangle"></a><h3>cairo_region_union_rectangle ()</h3>
|
975
|
+
<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>
|
976
|
+
cairo_region_union_rectangle (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *dst</code></em>,
|
977
|
+
<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> *rectangle</code></em>);</pre>
|
978
|
+
<p>Computes the union of <em class="parameter"><code>dst</code></em>
|
979
|
+
with <em class="parameter"><code>rectangle</code></em>
|
980
|
+
and places the result in <em class="parameter"><code>dst</code></em>
|
981
|
+
.</p>
|
982
|
+
<div class="refsect3">
|
983
|
+
<a name="id-1.3.5.7.22.5"></a><h4>Parameters</h4>
|
984
|
+
<div class="informaltable"><table width="100%" border="0">
|
985
|
+
<colgroup>
|
986
|
+
<col width="150px" class="parameters_name">
|
987
|
+
<col class="parameters_description">
|
988
|
+
<col width="200px" class="parameters_annotations">
|
989
|
+
</colgroup>
|
686
990
|
<tbody>
|
687
991
|
<tr>
|
688
|
-
<td
|
689
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
690
|
-
</td>
|
691
|
-
</tr>
|
692
|
-
<tr>
|
693
|
-
<td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
|
694
|
-
<td>another <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
695
|
-
</td>
|
992
|
+
<td class="parameter_name"><p>dst</p></td>
|
993
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
994
|
+
<td class="parameter_annotations"> </td>
|
696
995
|
</tr>
|
697
996
|
<tr>
|
698
|
-
<td
|
699
|
-
<td>
|
700
|
-
<
|
701
|
-
</td>
|
997
|
+
<td class="parameter_name"><p>rectangle</p></td>
|
998
|
+
<td class="parameter_description"><p>a <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></p></td>
|
999
|
+
<td class="parameter_annotations"> </td>
|
702
1000
|
</tr>
|
703
1001
|
</tbody>
|
704
1002
|
</table></div>
|
1003
|
+
</div>
|
1004
|
+
<div class="refsect3">
|
1005
|
+
<a name="id-1.3.5.7.22.6"></a><h4>Returns</h4>
|
1006
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a></p>
|
1007
|
+
<p></p>
|
1008
|
+
</div>
|
705
1009
|
<p class="since">Since 1.10</p>
|
706
1010
|
</div>
|
707
1011
|
<hr>
|
708
1012
|
<div class="refsect2">
|
709
|
-
<a name="cairo-region-
|
710
|
-
<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>
|
711
|
-
|
712
|
-
<
|
713
|
-
Computes the
|
714
|
-
</
|
715
|
-
|
716
|
-
<
|
1013
|
+
<a name="cairo-region-xor"></a><h3>cairo_region_xor ()</h3>
|
1014
|
+
<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>
|
1015
|
+
cairo_region_xor (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *dst</code></em>,
|
1016
|
+
<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *other</code></em>);</pre>
|
1017
|
+
<p>Computes the exclusive difference of <em class="parameter"><code>dst</code></em>
|
1018
|
+
with <em class="parameter"><code>other</code></em>
|
1019
|
+
and places the
|
1020
|
+
result in <em class="parameter"><code>dst</code></em>
|
1021
|
+
. That is, <em class="parameter"><code>dst</code></em>
|
1022
|
+
will be set to contain all areas that
|
1023
|
+
are either in <em class="parameter"><code>dst</code></em>
|
1024
|
+
or in <em class="parameter"><code>other</code></em>
|
1025
|
+
, but not in both.</p>
|
1026
|
+
<div class="refsect3">
|
1027
|
+
<a name="id-1.3.5.7.23.5"></a><h4>Parameters</h4>
|
1028
|
+
<div class="informaltable"><table width="100%" border="0">
|
1029
|
+
<colgroup>
|
1030
|
+
<col width="150px" class="parameters_name">
|
1031
|
+
<col class="parameters_description">
|
1032
|
+
<col width="200px" class="parameters_annotations">
|
1033
|
+
</colgroup>
|
717
1034
|
<tbody>
|
718
1035
|
<tr>
|
719
|
-
<td
|
720
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
721
|
-
</td>
|
722
|
-
</tr>
|
723
|
-
<tr>
|
724
|
-
<td><p><span class="term"><em class="parameter"><code>rectangle</code></em> :</span></p></td>
|
725
|
-
<td>a <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>
|
726
|
-
</td>
|
1036
|
+
<td class="parameter_name"><p>dst</p></td>
|
1037
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
1038
|
+
<td class="parameter_annotations"> </td>
|
727
1039
|
</tr>
|
728
1040
|
<tr>
|
729
|
-
<td
|
730
|
-
<td>
|
731
|
-
<
|
732
|
-
</td>
|
1041
|
+
<td class="parameter_name"><p>other</p></td>
|
1042
|
+
<td class="parameter_description"><p>another <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
1043
|
+
<td class="parameter_annotations"> </td>
|
733
1044
|
</tr>
|
734
1045
|
</tbody>
|
735
1046
|
</table></div>
|
1047
|
+
</div>
|
1048
|
+
<div class="refsect3">
|
1049
|
+
<a name="id-1.3.5.7.23.6"></a><h4>Returns</h4>
|
1050
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a></p>
|
1051
|
+
<p></p>
|
1052
|
+
</div>
|
736
1053
|
<p class="since">Since 1.10</p>
|
737
1054
|
</div>
|
738
1055
|
<hr>
|
739
1056
|
<div class="refsect2">
|
740
|
-
<a name="cairo-region-xor"></a><h3>
|
741
|
-
<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>
|
742
|
-
|
743
|
-
<
|
744
|
-
Computes the exclusive difference of <em class="parameter"><code>dst</code></em>
|
745
|
-
|
746
|
-
|
747
|
-
</
|
748
|
-
<
|
749
|
-
|
1057
|
+
<a name="cairo-region-xor-rectangle"></a><h3>cairo_region_xor_rectangle ()</h3>
|
1058
|
+
<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>
|
1059
|
+
cairo_region_xor_rectangle (<em class="parameter"><code><a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *dst</code></em>,
|
1060
|
+
<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> *rectangle</code></em>);</pre>
|
1061
|
+
<p>Computes the exclusive difference of <em class="parameter"><code>dst</code></em>
|
1062
|
+
with <em class="parameter"><code>rectangle</code></em>
|
1063
|
+
and places the
|
1064
|
+
result in <em class="parameter"><code>dst</code></em>
|
1065
|
+
. That is, <em class="parameter"><code>dst</code></em>
|
1066
|
+
will be set to contain all areas that are
|
1067
|
+
either in <em class="parameter"><code>dst</code></em>
|
1068
|
+
or in <em class="parameter"><code>rectangle</code></em>
|
1069
|
+
, but not in both.</p>
|
1070
|
+
<div class="refsect3">
|
1071
|
+
<a name="id-1.3.5.7.24.5"></a><h4>Parameters</h4>
|
1072
|
+
<div class="informaltable"><table width="100%" border="0">
|
1073
|
+
<colgroup>
|
1074
|
+
<col width="150px" class="parameters_name">
|
1075
|
+
<col class="parameters_description">
|
1076
|
+
<col width="200px" class="parameters_annotations">
|
1077
|
+
</colgroup>
|
750
1078
|
<tbody>
|
751
1079
|
<tr>
|
752
|
-
<td
|
753
|
-
<td>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
754
|
-
</td>
|
755
|
-
</tr>
|
756
|
-
<tr>
|
757
|
-
<td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
|
758
|
-
<td>another <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a>
|
759
|
-
</td>
|
1080
|
+
<td class="parameter_name"><p>dst</p></td>
|
1081
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a></p></td>
|
1082
|
+
<td class="parameter_annotations"> </td>
|
760
1083
|
</tr>
|
761
1084
|
<tr>
|
762
|
-
<td
|
763
|
-
<td>
|
764
|
-
<
|
765
|
-
</td>
|
1085
|
+
<td class="parameter_name"><p>rectangle</p></td>
|
1086
|
+
<td class="parameter_description"><p>a <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></p></td>
|
1087
|
+
<td class="parameter_annotations"> </td>
|
766
1088
|
</tr>
|
767
1089
|
</tbody>
|
768
1090
|
</table></div>
|
1091
|
+
</div>
|
1092
|
+
<div class="refsect3">
|
1093
|
+
<a name="id-1.3.5.7.24.6"></a><h4>Returns</h4>
|
1094
|
+
<p> <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS"><code class="literal">CAIRO_STATUS_SUCCESS</code></a> or <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-NO-MEMORY:CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a></p>
|
1095
|
+
<p></p>
|
1096
|
+
</div>
|
1097
|
+
<p class="since">Since 1.10</p>
|
1098
|
+
</div>
|
1099
|
+
</div>
|
1100
|
+
<div class="refsect1">
|
1101
|
+
<a name="cairo-Regions.other_details"></a><h2>Types and Values</h2>
|
1102
|
+
<div class="refsect2">
|
1103
|
+
<a name="cairo-region-t"></a><h3>cairo_region_t</h3>
|
1104
|
+
<pre class="programlisting">typedef struct _cairo_region cairo_region_t;
|
1105
|
+
</pre>
|
1106
|
+
<p>A <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> represents a set of integer-aligned rectangles.</p>
|
1107
|
+
<p>It allows set-theoretical operations like <a class="link" href="cairo-Regions.html#cairo-region-union" title="cairo_region_union ()"><code class="function">cairo_region_union()</code></a> and
|
1108
|
+
<a class="link" href="cairo-Regions.html#cairo-region-intersect" title="cairo_region_intersect ()"><code class="function">cairo_region_intersect()</code></a> to be performed on them.</p>
|
1109
|
+
<p>Memory management of <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> is done with
|
1110
|
+
<a class="link" href="cairo-Regions.html#cairo-region-reference" title="cairo_region_reference ()"><code class="function">cairo_region_reference()</code></a> and <a class="link" href="cairo-Regions.html#cairo-region-destroy" title="cairo_region_destroy ()"><code class="function">cairo_region_destroy()</code></a>.</p>
|
769
1111
|
<p class="since">Since 1.10</p>
|
770
1112
|
</div>
|
771
1113
|
<hr>
|
772
1114
|
<div class="refsect2">
|
773
|
-
<a name="cairo-region-
|
774
|
-
<
|
775
|
-
|
776
|
-
<
|
777
|
-
|
778
|
-
|
779
|
-
|
780
|
-
|
781
|
-
<
|
782
|
-
|
1115
|
+
<a name="cairo-region-overlap-t"></a><h3>enum cairo_region_overlap_t</h3>
|
1116
|
+
<p>Used as the return value for <a class="link" href="cairo-Regions.html#cairo-region-contains-rectangle" title="cairo_region_contains_rectangle ()"><code class="function">cairo_region_contains_rectangle()</code></a>.</p>
|
1117
|
+
<div class="refsect3">
|
1118
|
+
<a name="id-1.3.5.8.3.4"></a><h4>Members</h4>
|
1119
|
+
<div class="informaltable"><table width="100%" border="0">
|
1120
|
+
<colgroup>
|
1121
|
+
<col width="300px" class="enum_members_name">
|
1122
|
+
<col class="enum_members_description">
|
1123
|
+
<col width="200px" class="enum_members_annotations">
|
1124
|
+
</colgroup>
|
783
1125
|
<tbody>
|
784
1126
|
<tr>
|
785
|
-
<td
|
786
|
-
<td
|
1127
|
+
<td class="enum_member_name"><p><a name="CAIRO-REGION-OVERLAP-IN:CAPS"></a>CAIRO_REGION_OVERLAP_IN</p></td>
|
1128
|
+
<td class="enum_member_description">
|
1129
|
+
<p>The contents are entirely inside the region. (Since 1.10)</p>
|
787
1130
|
</td>
|
1131
|
+
<td class="enum_member_annotations"> </td>
|
788
1132
|
</tr>
|
789
1133
|
<tr>
|
790
|
-
<td
|
791
|
-
<td
|
1134
|
+
<td class="enum_member_name"><p><a name="CAIRO-REGION-OVERLAP-OUT:CAPS"></a>CAIRO_REGION_OVERLAP_OUT</p></td>
|
1135
|
+
<td class="enum_member_description">
|
1136
|
+
<p>The contents are entirely outside the region. (Since 1.10)</p>
|
792
1137
|
</td>
|
1138
|
+
<td class="enum_member_annotations"> </td>
|
793
1139
|
</tr>
|
794
1140
|
<tr>
|
795
|
-
<td
|
796
|
-
<td>
|
797
|
-
<
|
1141
|
+
<td class="enum_member_name"><p><a name="CAIRO-REGION-OVERLAP-PART:CAPS"></a>CAIRO_REGION_OVERLAP_PART</p></td>
|
1142
|
+
<td class="enum_member_description">
|
1143
|
+
<p>The contents are partially inside and
|
1144
|
+
partially outside the region. (Since 1.10)</p>
|
798
1145
|
</td>
|
1146
|
+
<td class="enum_member_annotations"> </td>
|
799
1147
|
</tr>
|
800
1148
|
</tbody>
|
801
1149
|
</table></div>
|
1150
|
+
</div>
|
802
1151
|
<p class="since">Since 1.10</p>
|
803
1152
|
</div>
|
804
1153
|
</div>
|
805
1154
|
</div>
|
806
1155
|
<div class="footer">
|
807
1156
|
<hr>
|
808
|
-
Generated by GTK-Doc V1.
|
1157
|
+
Generated by GTK-Doc V1.20</div>
|
809
1158
|
</body>
|
810
1159
|
</html>
|