gdk-points-rectangles-and-regions.html

最新gtk中文资料集

<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 <a
href="/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> <a
href="/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 which
includes 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,
                                                         <a
href="/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, when
creating 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 are
included 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,
                                                         <a
href="/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 <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a>.</p>
<p>