Imported Upstream version 2.4.0~rc2

This commit is contained in:
Ari Pollak
2010-08-11 01:22:44 -04:00
parent d884b2912c
commit 4be5597e32
576 changed files with 70261 additions and 80724 deletions

View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gimpselection</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="index.html" title="GIMP Library Reference Manual">
<link rel="up" href="libgimp-image.html" title="Manupulating Images and their Properties">
<link rel="prev" href="libgimp-gimpregioniterator.html" title="gimpregioniterator">
@ -31,16 +31,16 @@
<th width="100%" align="center">GIMP Library Reference Manual</th>
<td><a accesskey="n" href="libgimp-gimptexttool.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2596356" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2586286" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2650870" class="shortcut">Description</a></nobr></td></tr>
<a href="#id2682406" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimp-gimpselection"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2596356"></a><span class="refentrytitle">gimpselection</span>
<a name="id2586286"></a><span class="refentrytitle">gimpselection</span>
</h2>
<p>gimpselection &#8212; Functions for manipulating selections.</p>
</td>
@ -52,181 +52,63 @@
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-bounds">gimp_selection_bounds</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> *non_empty,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *x1,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *y1,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *x2,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *y2);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-all">gimp_selection_all</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-none">gimp_selection_none</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-clear">gimp_selection_clear</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-is-empty">gimp_selection_is_empty</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> <a href="libgimp-gimpselection.html#gimp-selection-float">gimp_selection_float</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> drawable_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> offx,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> offy);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-load">gimp_selection_load</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> channel_ID);
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> <a href="libgimp-gimpselection.html#gimp-selection-save">gimp_selection_save</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> <a href="libgimp-gimpselection.html#gimp-selection-value">gimp_selection_value</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-grow">gimp_selection_grow</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> steps);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-shrink">gimp_selection_shrink</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> steps);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-invert">gimp_selection_invert</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-feather">gimp_selection_feather</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> radius);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-sharpen">gimp_selection_sharpen</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-border">gimp_selection_border</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> radius);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-translate">gimp_selection_translate</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> offx,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> offy);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-layer-alpha">gimp_selection_layer_alpha</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> layer_ID);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimp-gimpselection.html#gimp-selection-combine">gimp_selection_combine</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> channel_ID,
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-bounds">gimp_selection_bounds</a> (gint32 image_ID,
gboolean *non_empty,
gint *x1,
gint *y1,
gint *x2,
gint *y2);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-all">gimp_selection_all</a> (gint32 image_ID);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-none">gimp_selection_none</a> (gint32 image_ID);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-clear">gimp_selection_clear</a> (gint32 image_ID);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-is-empty">gimp_selection_is_empty</a> (gint32 image_ID);
gint32 <a class="link" href="libgimp-gimpselection.html#gimp-selection-float">gimp_selection_float</a> (gint32 image_ID,
gint32 drawable_ID,
gint offx,
gint offy);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-load">gimp_selection_load</a> (gint32 channel_ID);
gint32 <a class="link" href="libgimp-gimpselection.html#gimp-selection-save">gimp_selection_save</a> (gint32 image_ID);
gint <a class="link" href="libgimp-gimpselection.html#gimp-selection-value">gimp_selection_value</a> (gint32 image_ID,
gint x,
gint y);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-grow">gimp_selection_grow</a> (gint32 image_ID,
gint steps);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-shrink">gimp_selection_shrink</a> (gint32 image_ID,
gint steps);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-invert">gimp_selection_invert</a> (gint32 image_ID);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-feather">gimp_selection_feather</a> (gint32 image_ID,
gdouble radius);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-sharpen">gimp_selection_sharpen</a> (gint32 image_ID);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-border">gimp_selection_border</a> (gint32 image_ID,
gint radius);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-translate">gimp_selection_translate</a> (gint32 image_ID,
gint offx,
gint offy);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-layer-alpha">gimp_selection_layer_alpha</a> (gint32 layer_ID);
gboolean <a class="link" href="libgimp-gimpselection.html#gimp-selection-combine">gimp_selection_combine</a> (gint32 channel_ID,
<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpChannelOps"
>GimpChannelOps</a> operation);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2650870"></a><h2>Description</h2>
<a name="id2682406"></a><h2>Description</h2>
<p>
Functions for manipulating selections.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2650885"></a><h2>Details</h2>
<a name="id2682421"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2650896"></a><h3>
<a name="id2682432"></a><h3>
<a name="gimp-selection-bounds"></a>gimp_selection_bounds ()</h3>
<a class="indexterm" name="id2650907"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_bounds (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> *non_empty,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *x1,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *y1,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *x2,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *y2);</pre>
<a class="indexterm" name="id2682443"></a><pre class="programlisting">gboolean gimp_selection_bounds (gint32 image_ID,
gboolean *non_empty,
gint *x1,
gint *y1,
gint *x2,
gint *y2);</pre>
<p>
Find the bounding box of the current selection.
</p>
@ -246,37 +128,37 @@ pixel. This means the width of the selection can be calculated as
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>non_empty</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>non_empty</code></em>&#160;:</span></p></td>
<td> TRUE if there is a selection.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x1</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>x1</code></em>&#160;:</span></p></td>
<td> x coordinate of upper left corner of selection bounds.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y1</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>y1</code></em>&#160;:</span></p></td>
<td> y coordinate of upper left corner of selection bounds.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x2</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>x2</code></em>&#160;:</span></p></td>
<td> x coordinate of lower right corner of selection bounds.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y2</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>y2</code></em>&#160;:</span></p></td>
<td> y coordinate of lower right corner of selection bounds.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -285,13 +167,9 @@ pixel. This means the width of the selection can be calculated as
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2649850"></a><h3>
<a name="id2666985"></a><h3>
<a name="gimp-selection-all"></a>gimp_selection_all ()</h3>
<a class="indexterm" name="id2649862"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_all (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);</pre>
<a class="indexterm" name="id2666997"></a><pre class="programlisting">gboolean gimp_selection_all (gint32 image_ID);</pre>
<p>
Select all of the image.
</p>
@ -305,12 +183,12 @@ image. Every pixel in the selection channel is set to 255.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -319,13 +197,9 @@ image. Every pixel in the selection channel is set to 255.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2649928"></a><h3>
<a name="id2667063"></a><h3>
<a name="gimp-selection-none"></a>gimp_selection_none ()</h3>
<a class="indexterm" name="id2649941"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_none (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);</pre>
<a class="indexterm" name="id2667076"></a><pre class="programlisting">gboolean gimp_selection_none (gint32 image_ID);</pre>
<p>
Deselect the entire image.
</p>
@ -339,12 +213,12 @@ selection channel is set to 0.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -353,19 +227,15 @@ selection channel is set to 0.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2650006"></a><h3>
<a name="id2667141"></a><h3>
<a name="gimp-selection-clear"></a>gimp_selection_clear ()</h3>
<a class="indexterm" name="id2650019"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_clear (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);</pre>
<a class="indexterm" name="id2667154"></a><pre class="programlisting">gboolean gimp_selection_clear (gint32 image_ID);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gimp_selection_clear</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This procedure is deprecated! Use <a href="libgimp-gimpselection.html#gimp-selection-none"><code class="function">gimp_selection_none()</code></a> instead.</p>
This procedure is deprecated! Use <a class="link" href="libgimp-gimpselection.html#gimp-selection-none"><code class="function">gimp_selection_none()</code></a> instead.</p>
<p>
</p>
@ -373,12 +243,12 @@ This procedure is deprecated! Use <a href="libgimp-gimpselection.html#gimp-selec
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -387,19 +257,15 @@ This procedure is deprecated! Use <a href="libgimp-gimpselection.html#gimp-selec
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2666551"></a><h3>
<a name="id2683710"></a><h3>
<a name="gimp-selection-is-empty"></a>gimp_selection_is_empty ()</h3>
<a class="indexterm" name="id2666562"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_is_empty (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);</pre>
<a class="indexterm" name="id2683720"></a><pre class="programlisting">gboolean gimp_selection_is_empty (gint32 image_ID);</pre>
<p>
Determine whether the selection is empty.
</p>
<p>
This procedure returns TRUE if the selection for the specified image
is not empty.</p>
is empty.</p>
<p>
</p>
@ -407,12 +273,12 @@ is not empty.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> Is the selection empty?
</td>
</tr>
@ -421,22 +287,12 @@ is not empty.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2666620"></a><h3>
<a name="id2683778"></a><h3>
<a name="gimp-selection-float"></a>gimp_selection_float ()</h3>
<a class="indexterm" name="id2666630"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> gimp_selection_float (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> drawable_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> offx,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> offy);</pre>
<a class="indexterm" name="id2683789"></a><pre class="programlisting">gint32 gimp_selection_float (gint32 image_ID,
gint32 drawable_ID,
gint offx,
gint offy);</pre>
<p>
Float the selection from the specified drawable with initial offsets
as specified.
@ -454,27 +310,27 @@ positioning of the new floating selection.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> ignored
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></p></td>
<td> The drawable from which to float selection.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>offx</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>offx</code></em>&#160;:</span></p></td>
<td> x offset for translation.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>offy</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>offy</code></em>&#160;:</span></p></td>
<td> y offset for translation.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The floated layer.
</td>
</tr>
@ -483,13 +339,9 @@ positioning of the new floating selection.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2666752"></a><h3>
<a name="id2683911"></a><h3>
<a name="gimp-selection-load"></a>gimp_selection_load ()</h3>
<a class="indexterm" name="id2666763"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_load (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> channel_ID);</pre>
<a class="indexterm" name="id2683921"></a><pre class="programlisting">gboolean gimp_selection_load (gint32 channel_ID);</pre>
<p>
Transfer the specified channel to the selection mask.
</p>
@ -502,12 +354,12 @@ This procedure loads the specified channel into the selection mask.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>channel_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>channel_ID</code></em>&#160;:</span></p></td>
<td> The channel.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -516,13 +368,9 @@ This procedure loads the specified channel into the selection mask.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2666822"></a><h3>
<a name="id2683980"></a><h3>
<a name="gimp-selection-save"></a>gimp_selection_save ()</h3>
<a class="indexterm" name="id2666832"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> gimp_selection_save (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);</pre>
<a class="indexterm" name="id2683990"></a><pre class="programlisting">gint32 gimp_selection_save (gint32 image_ID);</pre>
<p>
Copy the selection mask to a new channel.
</p>
@ -537,12 +385,12 @@ image's list of channels.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The new channel.
</td>
</tr>
@ -551,19 +399,11 @@ image's list of channels.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2666892"></a><h3>
<a name="id2684050"></a><h3>
<a name="gimp-selection-value"></a>gimp_selection_value ()</h3>
<a class="indexterm" name="id2666902"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> gimp_selection_value (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y);</pre>
<a class="indexterm" name="id2684060"></a><pre class="programlisting">gint gimp_selection_value (gint32 image_ID,
gint x,
gint y);</pre>
<p>
Find the value of the selection at the specified coordinates.
</p>
@ -577,22 +417,22 @@ coordinates. If the coordinates lie out of bounds, 0 is returned.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></p></td>
<td> x coordinate of value.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></p></td>
<td> y coordinate of value.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> Value of the selection.
</td>
</tr>
@ -601,16 +441,10 @@ coordinates. If the coordinates lie out of bounds, 0 is returned.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2667001"></a><h3>
<a name="id2684159"></a><h3>
<a name="gimp-selection-grow"></a>gimp_selection_grow ()</h3>
<a class="indexterm" name="id2667011"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_grow (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> steps);</pre>
<a class="indexterm" name="id2684169"></a><pre class="programlisting">gboolean gimp_selection_grow (gint32 image_ID,
gint steps);</pre>
<p>
Grow the image's selection
</p>
@ -624,17 +458,17 @@ boundary in all directions by the specified pixel amount.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>steps</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>steps</code></em>&#160;:</span></p></td>
<td> Steps of grow (in pixels).
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -643,16 +477,10 @@ boundary in all directions by the specified pixel amount.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2667089"></a><h3>
<a name="id2684248"></a><h3>
<a name="gimp-selection-shrink"></a>gimp_selection_shrink ()</h3>
<a class="indexterm" name="id2667100"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_shrink (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> steps);</pre>
<a class="indexterm" name="id2684258"></a><pre class="programlisting">gboolean gimp_selection_shrink (gint32 image_ID,
gint steps);</pre>
<p>
Shrink the image's selection
</p>
@ -667,17 +495,17 @@ of pixels.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>steps</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>steps</code></em>&#160;:</span></p></td>
<td> Steps of shrink (in pixels).
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -686,13 +514,9 @@ of pixels.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2667178"></a><h3>
<a name="id2684336"></a><h3>
<a name="gimp-selection-invert"></a>gimp_selection_invert ()</h3>
<a class="indexterm" name="id2667188"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_invert (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);</pre>
<a class="indexterm" name="id2684347"></a><pre class="programlisting">gboolean gimp_selection_invert (gint32 image_ID);</pre>
<p>
Invert the selection mask.
</p>
@ -706,12 +530,12 @@ selection channel, its new value is calculated as (255 - old-value).</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -720,16 +544,10 @@ selection channel, its new value is calculated as (255 - old-value).</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2667247"></a><h3>
<a name="id2684406"></a><h3>
<a name="gimp-selection-feather"></a>gimp_selection_feather ()</h3>
<a class="indexterm" name="id2667258"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_feather (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> radius);</pre>
<a class="indexterm" name="id2684416"></a><pre class="programlisting">gboolean gimp_selection_feather (gint32 image_ID,
gdouble radius);</pre>
<p>
Feather the image's selection
</p>
@ -743,17 +561,17 @@ using a gaussian blur.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>radius</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>radius</code></em>&#160;:</span></p></td>
<td> Radius of feather (in pixels).
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -762,13 +580,9 @@ using a gaussian blur.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2667335"></a><h3>
<a name="id2684494"></a><h3>
<a name="gimp-selection-sharpen"></a>gimp_selection_sharpen ()</h3>
<a class="indexterm" name="id2667346"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_sharpen (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID);</pre>
<a class="indexterm" name="id2684504"></a><pre class="programlisting">gboolean gimp_selection_sharpen (gint32 image_ID);</pre>
<p>
Sharpen the selection mask.
</p>
@ -784,12 +598,12 @@ might exist in the selection mask's boundary.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -798,16 +612,10 @@ might exist in the selection mask's boundary.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2667406"></a><h3>
<a name="id2684565"></a><h3>
<a name="gimp-selection-border"></a>gimp_selection_border ()</h3>
<a class="indexterm" name="id2667417"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_border (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> radius);</pre>
<a class="indexterm" name="id2684575"></a><pre class="programlisting">gboolean gimp_selection_border (gint32 image_ID,
gint radius);</pre>
<p>
Border the image's selection
</p>
@ -822,17 +630,17 @@ selection at every point within the specified radius.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>radius</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>radius</code></em>&#160;:</span></p></td>
<td> Radius of border (in pixels).
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -841,19 +649,11 @@ selection at every point within the specified radius.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2667496"></a><h3>
<a name="id2684654"></a><h3>
<a name="gimp-selection-translate"></a>gimp_selection_translate ()</h3>
<a class="indexterm" name="id2667506"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_translate (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> offx,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> offy);</pre>
<a class="indexterm" name="id2684665"></a><pre class="programlisting">gboolean gimp_selection_translate (gint32 image_ID,
gint offx,
gint offy);</pre>
<p>
Translate the selection by the specified offsets.
</p>
@ -870,22 +670,22 @@ because of this call are lost.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>offx</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>offx</code></em>&#160;:</span></p></td>
<td> x offset for translation.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>offy</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>offy</code></em>&#160;:</span></p></td>
<td> y offset for translation.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -894,13 +694,9 @@ because of this call are lost.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2667607"></a><h3>
<a name="id2684766"></a><h3>
<a name="gimp-selection-layer-alpha"></a>gimp_selection_layer_alpha ()</h3>
<a class="indexterm" name="id2667618"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_layer_alpha (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> layer_ID);</pre>
<a class="indexterm" name="id2684776"></a><pre class="programlisting">gboolean gimp_selection_layer_alpha (gint32 layer_ID);</pre>
<p>
Transfer the specified layer's alpha channel to the selection mask.
</p>
@ -918,12 +714,12 @@ selection mask value is set to 0.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></p></td>
<td> Layer with alpha.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>
@ -932,13 +728,9 @@ selection mask value is set to 0.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2667682"></a><h3>
<a name="id2684840"></a><h3>
<a name="gimp-selection-combine"></a>gimp_selection_combine ()</h3>
<a class="indexterm" name="id2667692"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_selection_combine (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> channel_ID,
<a class="indexterm" name="id2684850"></a><pre class="programlisting">gboolean gimp_selection_combine (gint32 channel_ID,
<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpChannelOps"
>GimpChannelOps</a> operation);</pre>
@ -955,17 +747,17 @@ mask.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>channel_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>channel_ID</code></em>&#160;:</span></p></td>
<td> The channel.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>operation</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>operation</code></em>&#160;:</span></p></td>
<td> The selection operation.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> TRUE on success.
</td>
</tr>