240 lines
25 KiB
HTML
240 lines
25 KiB
HTML
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>gimpselection</title><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"><link rel="start" href="index.html" title="GIMP Library Reference Manual"><link rel="up" href="libgimp-image.html" title="Manupulating Images and all their Properties"><link rel="prev" href="libgimp-gimpregioniterator.html" title="gimpregioniterator"><link rel="next" href="libgimp-gimptexttool.html" title="gimptexttool"><meta name="generator" content="GTK-Doc V1.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="gimpdefinitions.html" title="Part I. GIMP Constants"><link rel="part" href="libgimp.html" title="Part II. GIMP Library"><link rel="chapter" href="libgimp-general.html" title="Functions not Related to Specific Images"><link rel="chapter" href="libgimp-image.html" title="Manupulating Images and all their Properties"><link rel="chapter" href="libgimp-data.html" title="Data Objects"><link rel="chapter" href="libgimp-selectors.html" title="Controlling the Core's Selection Dialogs"><link rel="part" href="libgimpui.html" title="Part III. GIMP User Interface Library"><link rel="chapter" href="libgimpui-hierarchy.html" title="Object Hierarchy"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libgimp-gimpregioniterator.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="libgimp-image.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><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></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><span class="refentrytitle">gimpselection</span></h2><p>gimpselection — Functions for manipulating selections.</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
|
||
|
||
|
||
|
||
gboolean <a 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 href="libgimp-gimpselection.html#gimp-selection-all">gimp_selection_all</a> (gint32 image_ID);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-none">gimp_selection_none</a> (gint32 image_ID);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-clear">gimp_selection_clear</a> (gint32 image_ID);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-is-empty">gimp_selection_is_empty</a> (gint32 image_ID);
|
||
gint32 <a href="libgimp-gimpselection.html#gimp-selection-float">gimp_selection_float</a> (gint32 image_ID,
|
||
gint32 drawable_ID,
|
||
gint offx,
|
||
gint offy);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-load">gimp_selection_load</a> (gint32 channel_ID);
|
||
gint32 <a href="libgimp-gimpselection.html#gimp-selection-save">gimp_selection_save</a> (gint32 image_ID);
|
||
gint <a href="libgimp-gimpselection.html#gimp-selection-value">gimp_selection_value</a> (gint32 image_ID,
|
||
gint x,
|
||
gint y);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-grow">gimp_selection_grow</a> (gint32 image_ID,
|
||
gint steps);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-shrink">gimp_selection_shrink</a> (gint32 image_ID,
|
||
gint radius);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-invert">gimp_selection_invert</a> (gint32 image_ID);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-feather">gimp_selection_feather</a> (gint32 image_ID,
|
||
gdouble radius);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-sharpen">gimp_selection_sharpen</a> (gint32 image_ID);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-border">gimp_selection_border</a> (gint32 image_ID,
|
||
gint radius);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-translate">gimp_selection_translate</a> (gint32 image_ID,
|
||
gint offx,
|
||
gint offy);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-layer-alpha">gimp_selection_layer_alpha</a> (gint32 layer_ID);
|
||
gboolean <a href="libgimp-gimpselection.html#gimp-selection-combine">gimp_selection_combine</a> (gint32 channel_ID,
|
||
<a href="libgimp-gimpenums.html#GimpChannelOps">GimpChannelOps</a> operation);
|
||
</pre></div><div class="refsect1" lang="en"><a name="id2635194"></a><h2>Description</h2><p>
|
||
Functions for manipulating selections.
|
||
|
||
</p></div><div class="refsect1" lang="en"><a name="id2635204"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2635209"></a><h3><a name="gimp-selection-bounds"></a>gimp_selection_bounds ()</h3><a class="indexterm" name="id2635217"></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><p>
|
||
This procedure returns whether there is a selection for the
|
||
specified image. If there is one, the upper left and lower right
|
||
corners of the bounding box are returned. These coordinates are
|
||
relative to the image. Please note that the pixel specified by the
|
||
lower righthand coordinate of the bounding box is not part of the
|
||
selection. The selection ends at the upper left corner of this
|
||
pixel. This means the width of the selection can be calculated as
|
||
(x2 - x1), its height as (y2 - y1).</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>non_empty</tt></i> :</span></td><td> True if there is a selection.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>x1</tt></i> :</span></td><td> x coordinate of upper left corner of selection bounds.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>y1</tt></i> :</span></td><td> y coordinate of upper left corner of selection bounds.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>x2</tt></i> :</span></td><td> x coordinate of lower right corner of selection bounds.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>y2</tt></i> :</span></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> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2616428"></a><h3><a name="gimp-selection-all"></a>gimp_selection_all ()</h3><a class="indexterm" name="id2616436"></a><pre class="programlisting">gboolean gimp_selection_all (gint32 image_ID);</pre><p>
|
||
Select all of the image.
|
||
</p><p>
|
||
This procedure sets the selection mask to completely encompass the
|
||
image. Every pixel in the selection channel is set to 255.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2616488"></a><h3><a name="gimp-selection-none"></a>gimp_selection_none ()</h3><a class="indexterm" name="id2616496"></a><pre class="programlisting">gboolean gimp_selection_none (gint32 image_ID);</pre><p>
|
||
Deselect the entire image.
|
||
</p><p>
|
||
This procedure deselects the entire image. Every pixel in the
|
||
selection channel is set to 0.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2616549"></a><h3><a name="gimp-selection-clear"></a>gimp_selection_clear ()</h3><a class="indexterm" name="id2616557"></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><tt class="literal">gimp_selection_clear</tt> 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"><tt class="function">gimp_selection_none()</tt></a> instead.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2616620"></a><h3><a name="gimp-selection-is-empty"></a>gimp_selection_is_empty ()</h3><a class="indexterm" name="id2616629"></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 non-zero if the selection for the specified
|
||
image is not empty.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> Is the selection empty?
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2616682"></a><h3><a name="gimp-selection-float"></a>gimp_selection_float ()</h3><a class="indexterm" name="id2616690"></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.
|
||
</p><p>
|
||
This procedure determines the region of the specified drawable that
|
||
lies beneath the current selection. The region is then cut from the
|
||
drawable and the resulting data is made into a new layer which is
|
||
instantiated as a floating selection. The offsets allow initial
|
||
positioning of the new floating selection.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> ignored
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable from which to float selection.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>offx</tt></i> :</span></td><td> x offset for translation.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>offy</tt></i> :</span></td><td> y offset for translation.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The floated layer.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2639986"></a><h3><a name="gimp-selection-load"></a>gimp_selection_load ()</h3><a class="indexterm" name="id2639993"></a><pre class="programlisting">gboolean gimp_selection_load (gint32 channel_ID);</pre><p>
|
||
Transfer the specified channel to the selection mask.
|
||
</p><p>
|
||
This procedure loads the specified channel into the selection mask.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>channel_ID</tt></i> :</span></td><td> The channel.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640042"></a><h3><a name="gimp-selection-save"></a>gimp_selection_save ()</h3><a class="indexterm" name="id2640050"></a><pre class="programlisting">gint32 gimp_selection_save (gint32 image_ID);</pre><p>
|
||
Copy the selection mask to a new channel.
|
||
</p><p>
|
||
This procedure copies the selection mask and stores the content in a
|
||
new channel. The new channel is automatically inserted into the
|
||
image's list of channels.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The new channel.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640100"></a><h3><a name="gimp-selection-value"></a>gimp_selection_value ()</h3><a class="indexterm" name="id2640107"></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><p>
|
||
This procedure returns the value of the selection at the specified
|
||
coordinates. If the coordinates lie out of bounds, 0 is returned.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>x</tt></i> :</span></td><td> x coordinate of value.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>y</tt></i> :</span></td><td> y coordinate of value.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> Value of the selection.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640189"></a><h3><a name="gimp-selection-grow"></a>gimp_selection_grow ()</h3><a class="indexterm" name="id2640198"></a><pre class="programlisting">gboolean gimp_selection_grow (gint32 image_ID,
|
||
gint steps);</pre><p>
|
||
Grow the image's selection
|
||
</p><p>
|
||
This procedure grows the selection. Growing involves expanding the
|
||
boundary in all directions by the specified pixel amount.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>steps</tt></i> :</span></td><td> Steps of grow (in pixels).
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640267"></a><h3><a name="gimp-selection-shrink"></a>gimp_selection_shrink ()</h3><a class="indexterm" name="id2640275"></a><pre class="programlisting">gboolean gimp_selection_shrink (gint32 image_ID,
|
||
gint radius);</pre><p>
|
||
Shrink the image's selection
|
||
</p><p>
|
||
This procedure shrinks the selection. Shrinking invovles trimming
|
||
the existing selection boundary on all sides by the specified number
|
||
of pixels.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>radius</tt></i> :</span></td><td> Radius of shrink (in pixels).
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640344"></a><h3><a name="gimp-selection-invert"></a>gimp_selection_invert ()</h3><a class="indexterm" name="id2640353"></a><pre class="programlisting">gboolean gimp_selection_invert (gint32 image_ID);</pre><p>
|
||
Invert the selection mask.
|
||
</p><p>
|
||
This procedure inverts the selection mask. For every pixel in the
|
||
selection channel, its new value is calculated as (255 - old_value).</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640405"></a><h3><a name="gimp-selection-feather"></a>gimp_selection_feather ()</h3><a class="indexterm" name="id2640413"></a><pre class="programlisting">gboolean gimp_selection_feather (gint32 image_ID,
|
||
gdouble radius);</pre><p>
|
||
Feather the image's selection
|
||
</p><p>
|
||
This procedure feathers the selection. Feathering is implemented
|
||
using a gaussian blur.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>radius</tt></i> :</span></td><td> Radius of feather (in pixels).
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640482"></a><h3><a name="gimp-selection-sharpen"></a>gimp_selection_sharpen ()</h3><a class="indexterm" name="id2640490"></a><pre class="programlisting">gboolean gimp_selection_sharpen (gint32 image_ID);</pre><p>
|
||
Sharpen the selection mask.
|
||
</p><p>
|
||
This procedure sharpens the selection mask. For every pixel in the
|
||
selection channel, if the value is > 0, the new pixel is assigned
|
||
a value of 255. This removes any \"anti-aliasing\" that might exist
|
||
in the selection mask's boundary.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640544"></a><h3><a name="gimp-selection-border"></a>gimp_selection_border ()</h3><a class="indexterm" name="id2640552"></a><pre class="programlisting">gboolean gimp_selection_border (gint32 image_ID,
|
||
gint radius);</pre><p>
|
||
Border the image's selection
|
||
</p><p>
|
||
This procedure borders the selection. Bordering creates a new
|
||
selection which is defined along the boundary of the previous
|
||
selection at every point within the specified radius.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>radius</tt></i> :</span></td><td> Radius of border (in pixels).
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640622"></a><h3><a name="gimp-selection-translate"></a>gimp_selection_translate ()</h3><a class="indexterm" name="id2640630"></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><p>
|
||
This procedure actually translates the selection for the specified
|
||
image by the specified offsets. Regions that are translated from
|
||
beyond the bounds of the image are set to empty. Valid regions of
|
||
the selection which are translated beyond the bounds of the image
|
||
because of this call are lost.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>offx</tt></i> :</span></td><td> x offset for translation.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>offy</tt></i> :</span></td><td> y offset for translation.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640720"></a><h3><a name="gimp-selection-layer-alpha"></a>gimp_selection_layer_alpha ()</h3><a class="indexterm" name="id2640728"></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><p>
|
||
This procedure requires a layer with an alpha channel. The alpha
|
||
channel information is used to create a selection mask such that for
|
||
any pixel in the image defined in the specified layer, that layer
|
||
pixel's alpha value is transferred to the selection mask. If the
|
||
layer is undefined at a particular image pixel, the associated
|
||
selection mask value is set to 0.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>layer_ID</tt></i> :</span></td><td> Layer with alpha.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2640785"></a><h3><a name="gimp-selection-combine"></a>gimp_selection_combine ()</h3><a class="indexterm" name="id2640794"></a><pre class="programlisting">gboolean gimp_selection_combine (gint32 channel_ID,
|
||
<a href="libgimp-gimpenums.html#GimpChannelOps">GimpChannelOps</a> operation);</pre><p>
|
||
Combines the specified channel with the selection mask.
|
||
</p><p>
|
||
This procedure combines the specified channel into the selection
|
||
mask.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>channel_ID</tt></i> :</span></td><td> The channel.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>operation</tt></i> :</span></td><td> The selection operation.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libgimp-gimpregioniterator.html"><b><< gimpregioniterator</b></a></td><td align="right"><a accesskey="n" href="libgimp-gimptexttool.html"><b>gimptexttool >></b></a></td></tr></table></body></html>
|