<td> a <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>src2</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>dest</code></em>&#160;:</span></p></td><td> return location for the intersection of <em class="parameter"><code>src1</code></em> and <em class="parameter"><code>src2</code></em>, or <ahref="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the rectangles intersect.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3080156"></a><h3><a name="gdk-rectangle-union"></a>gdk_rectangle_union ()</h3><a class="indexterm" name="id3080169"></a><pre class="programlisting">void                gdk_rectangle_union                 (<a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *src1,                                                         <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *src2,                                                         <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *dest);</pre><p>Calculates the union of two rectangles.The union of rectangles <em class="parameter"><code>src1</code></em> and <em class="parameter"><code>src2</code></em> is the smallest rectangle whichincludes both <em class="parameter"><code>src1</code></em> and <em class="parameter"><code>src2</code></em> within it.It is allowed for <em class="parameter"><code>dest</code></em> to be the same as either <em class="parameter"><code>src1</code></em> or <em class="parameter"><code>src2</code></em>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>src1</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>src2</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>dest</code></em>&#160;:</span></p></td><td> return location for the union of <em class="parameter"><code>src1</code></em> and <em class="parameter"><code>src2</code></em></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3080335"></a><h3><a name="GdkRegion"></a>GdkRegion</h3><a class="indexterm" name="id3080348"></a><pre class="programlisting">typedef struct _GdkRegion GdkRegion;</pre><p>A GdkRegion represents a set of pixels on the screen.</p></div><hr><div class="refsect2" lang="en"><a name="id3080364"></a><h3><a name="gdk-region-new"></a>gdk_region_new ()</h3><a class="indexterm" name="id3080377"></a><pre class="programlisting"><a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion">GdkRegion</a>*          gdk_region_new                      (void);</pre><p>Creates a new empty <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion"><span class="type">GdkRegion</span></a>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> a new empty <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion"><span class="type">GdkRegion</span></a></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3080432"></a><h3><a name="gdk-region-polygon"></a>gdk_region_polygon ()</h3><a class="indexterm" name="id3080445"></a><pre class="programlisting"><a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion">GdkRegion</a>*          gdk_region_polygon                  (<a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkPoint">GdkPoint</a> *points,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> npoints,                                                         <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkFillRule">GdkFillRule</a> fill_rule);</pre><p>Creates a new <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion"><span class="type">GdkRegion</span></a> using the polygon defined by a number of points.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>points</code></em>&#160;:</span></p></td><td> an array of <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkPoint"><span class="type">GdkPoint</span></a> structs</td></tr><tr><td><p><span class="term"><em class="parameter"><code>npoints</code></em>&#160;:</span></p></td><td> the number of elements in the <em class="parameter"><code>points</code></em> array</td></tr><tr><td><p><span class="term"><em class="parameter"><code>fill_rule</code></em>&#160;:</span></p></td><td> specifies which pixels are included in the region when the     polygon overlaps itself.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> a new <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion"><span class="type">GdkRegion</span></a> based on the given polygon</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3080582"></a><h3><a name="GdkFillRule"></a>enum GdkFillRule</h3><a class="indexterm" name="id3080594"></a><pre class="programlisting">typedef enum{  GDK_EVEN_ODD_RULE,  GDK_WINDING_RULE} GdkFillRule;</pre><p>The method for determining which pixels are included in a region, whencreating a <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion"><span class="type">GdkRegion</span></a> from a polygon.The fill rule is only relevant for polygons which overlap themselves.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><a name="GDK-EVEN-ODD-RULE:CAPS"></a><code class="literal">GDK_EVEN_ODD_RULE</code></span></p></td><td>areas which are overlapped an odd number of times areincluded in the region, while areas overlapped an even number of times are not.</td></tr><tr><td><p><span class="term"><a name="GDK-WINDING-RULE:CAPS"></a><code class="literal">GDK_WINDING_RULE</code></span></p></td><td>overlapping areas are always included.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3080672"></a><h3><a name="gdk-region-copy"></a>gdk_region_copy ()</h3><a class="indexterm" name="id3080685"></a><pre class="programlisting"><a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion">GdkRegion</a>*          gdk_region_copy                     (<a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion">GdkRegion</a> *region);</pre><p>Copies <em class="parameter"><code>region</code></em>, creating an identical new region.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>region</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion"><span class="type">GdkRegion</span></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> a new region identical to <em class="parameter"><code>region</code></em></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3080765"></a><h3><a name="gdk-region-rectangle"></a>gdk_region_rectangle ()</h3><a class="indexterm" name="id3080777"></a><pre class="programlisting"><a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion">GdkRegion</a>*          gdk_region_rectangle                (<a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *rectangle);</pre><p>Creates a new region containing the area <em class="parameter"><code>rectangle</code></em>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>rectangle</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> a new region</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3080852"></a><h3><a name="gdk-region-destroy"></a>gdk_region_destroy ()</h3><a class="indexterm" name="id3080866"></a><pre class="programlisting">void                gdk_region_destroy                  (<a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion">GdkRegion</a> *region);</pre><p>Destroys a <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion"><span class="type">GdkRegion</span></a>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>region</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion"><span class="type">GdkRegion</span></a></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3080931"></a><h3><a name="gdk-region-get-clipbox"></a>gdk_region_get_clipbox ()</h3><a class="indexterm" name="id3080944"></a><pre class="programlisting">void                gdk_region_get_clipbox              (<a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion">GdkRegion</a> *region,                                                         <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *rectangle);</pre><p>Obtains the smallest rectangle which includes the entire <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion"><span class="type">GdkRegion</span></a>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>region</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion"><span class="type">GdkRegion</span></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>rectangle</code></em>&#160;:</span></p></td><td> return location for the clipbox</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3081033"></a><h3><a name="gdk-region-get-rectangles"></a>gdk_region_get_rectangles ()</h3><a class="indexterm" name="id3081047"></a><pre class="programlisting">void                gdk_region_get_rectangles           (<a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRegion">GdkRegion</a> *region,                                                         <a class="link" href="gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> **rectangles,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *n_rectangles);</pre><p>Obtains the area covered by the region as a list of rectangles.The array returned in <em class="parameter"><code>rectangles</code></em> must be freed with <ahref="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p><p>