comparison CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/gtk-doc/html/cairo/cairo-Regions.html @ 68:5028fdace37b

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