984 lines
35 KiB
HTML
984 lines
35 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
|
<title>gimpselection</title>
|
|
<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">
|
|
<link rel="next" href="libgimp-gimptexttool.html" title="gimptexttool">
|
|
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
|
|
<link rel="stylesheet" href="style.css" type="text/css">
|
|
<link rel="part" href="libgimp.html" title="Part I. 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 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 II. GIMP User Interface Library">
|
|
<link rel="chapter" href="libgimpui-hierarchy.html" title="Object Hierarchy">
|
|
<link rel="index" href="libgimp-index.html" title="Index">
|
|
<link rel="index" href="libgimp-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
|
|
<link rel="index" href="libgimp-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
|
|
<link rel="index" href="libgimp-index-deprecated.html" title="Index of deprecated symbols">
|
|
</head>
|
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
<table class="navigation" id="top" 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>
|
|
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2599495" class="shortcut">Top</a>
|
|
 | 
|
|
<a href="#id2679990" 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="id2599495"></a><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">
|
|
|
|
|
|
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-bounds">gimp_selection_bounds</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> *non_empty,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> *x1,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> *y1,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> *x2,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> *y2);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-all">gimp_selection_all</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-none">gimp_selection_none</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-clear">gimp_selection_clear</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-is-empty">gimp_selection_is_empty</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-float">gimp_selection_float</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> drawable_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> offx,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> offy);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-load">gimp_selection_load</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> channel_ID);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-save">gimp_selection_save</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-value">gimp_selection_value</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> x,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> y);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-grow">gimp_selection_grow</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> steps);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-shrink">gimp_selection_shrink</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> steps);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-invert">gimp_selection_invert</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-feather">gimp_selection_feather</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
|
>gdouble</a> radius);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-sharpen">gimp_selection_sharpen</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-border">gimp_selection_border</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> radius);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-translate">gimp_selection_translate</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> offx,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> offy);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-layer-alpha">gimp_selection_layer_alpha</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> layer_ID);
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimp-gimpselection.html#gimp-selection-combine">gimp_selection_combine</a> (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> channel_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpChannelOps"
|
|
>GimpChannelOps</a> operation);
|
|
</pre>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="id2679990"></a><h2>Description</h2>
|
|
<p>
|
|
Functions for manipulating selections.
|
|
|
|
</p>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="id2680006"></a><h2>Details</h2>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2680017"></a><h3>
|
|
<a name="gimp-selection-bounds"></a>gimp_selection_bounds ()</h3>
|
|
<a class="indexterm" name="id2667592"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_bounds (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> *non_empty,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> *x1,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> *y1,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> *x2,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> *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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>non_empty</code></em> :</span></p></td>
|
|
<td> TRUE if there is a selection.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
|
|
<td> x coordinate of upper left corner of selection bounds.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
|
|
<td> y coordinate of upper left corner of selection bounds.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>x2</code></em> :</span></p></td>
|
|
<td> x coordinate of lower right corner of selection bounds.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>y2</code></em> :</span></p></td>
|
|
<td> y coordinate of lower right corner of selection bounds.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2667774"></a><h3>
|
|
<a name="gimp-selection-all"></a>gimp_selection_all ()</h3>
|
|
<a class="indexterm" name="id2667787"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_all (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2667852"></a><h3>
|
|
<a name="gimp-selection-none"></a>gimp_selection_none ()</h3>
|
|
<a class="indexterm" name="id2667865"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_none (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2667930"></a><h3>
|
|
<a name="gimp-selection-clear"></a>gimp_selection_clear ()</h3>
|
|
<a class="indexterm" name="id2667943"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_clear (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> 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 class="link" href="libgimp-gimpselection.html#gimp-selection-none"><code class="function">gimp_selection_none()</code></a> instead.</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>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2684388"></a><h3>
|
|
<a name="gimp-selection-is-empty"></a>gimp_selection_is_empty ()</h3>
|
|
<a class="indexterm" name="id2684399"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_is_empty (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID);</pre>
|
|
<p>
|
|
Determine whether the selection is empty.
|
|
</p>
|
|
<p>
|
|
This procedure returns TRUE if the selection for the specified image
|
|
is empty.</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>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> Is the selection empty?
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2684457"></a><h3>
|
|
<a name="gimp-selection-float"></a>gimp_selection_float ()</h3>
|
|
<a class="indexterm" name="id2684467"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> gimp_selection_float (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> drawable_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> offx,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> ignored
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></p></td>
|
|
<td> The drawable from which to float selection.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>offx</code></em> :</span></p></td>
|
|
<td> x offset for translation.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>offy</code></em> :</span></p></td>
|
|
<td> y offset for translation.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> The floated layer.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2684589"></a><h3>
|
|
<a name="gimp-selection-load"></a>gimp_selection_load ()</h3>
|
|
<a class="indexterm" name="id2684600"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_load (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> 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><p><span class="term"><em class="parameter"><code>channel_ID</code></em> :</span></p></td>
|
|
<td> The channel.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2684659"></a><h3>
|
|
<a name="gimp-selection-save"></a>gimp_selection_save ()</h3>
|
|
<a class="indexterm" name="id2684669"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> gimp_selection_save (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> The new channel.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2684728"></a><h3>
|
|
<a name="gimp-selection-value"></a>gimp_selection_value ()</h3>
|
|
<a class="indexterm" name="id2684739"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> gimp_selection_value (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> x,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
|
|
<td> x coordinate of value.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
|
|
<td> y coordinate of value.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> Value of the selection.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2684838"></a><h3>
|
|
<a name="gimp-selection-grow"></a>gimp_selection_grow ()</h3>
|
|
<a class="indexterm" name="id2684848"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_grow (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>steps</code></em> :</span></p></td>
|
|
<td> Steps of grow (in pixels).
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2684926"></a><h3>
|
|
<a name="gimp-selection-shrink"></a>gimp_selection_shrink ()</h3>
|
|
<a class="indexterm" name="id2684936"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_shrink (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> steps);</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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>steps</code></em> :</span></p></td>
|
|
<td> Steps of shrink (in pixels).
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2685015"></a><h3>
|
|
<a name="gimp-selection-invert"></a>gimp_selection_invert ()</h3>
|
|
<a class="indexterm" name="id2685025"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_invert (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2685084"></a><h3>
|
|
<a name="gimp-selection-feather"></a>gimp_selection_feather ()</h3>
|
|
<a class="indexterm" name="id2685095"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_feather (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
|
>gdouble</a> 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>radius</code></em> :</span></p></td>
|
|
<td> Radius of feather (in pixels).
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2685172"></a><h3>
|
|
<a name="gimp-selection-sharpen"></a>gimp_selection_sharpen ()</h3>
|
|
<a class="indexterm" name="id2685183"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_sharpen (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> 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 > 127, 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2685243"></a><h3>
|
|
<a name="gimp-selection-border"></a>gimp_selection_border ()</h3>
|
|
<a class="indexterm" name="id2685254"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_border (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>radius</code></em> :</span></p></td>
|
|
<td> Radius of border (in pixels).
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2685333"></a><h3>
|
|
<a name="gimp-selection-translate"></a>gimp_selection_translate ()</h3>
|
|
<a class="indexterm" name="id2685343"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_translate (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> image_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> offx,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
|
>gint</a> 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><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
|
|
<td> The image.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>offx</code></em> :</span></p></td>
|
|
<td> x offset for translation.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>offy</code></em> :</span></p></td>
|
|
<td> y offset for translation.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2685444"></a><h3>
|
|
<a name="gimp-selection-layer-alpha"></a>gimp_selection_layer_alpha ()</h3>
|
|
<a class="indexterm" name="id2685454"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_layer_alpha (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> 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><p><span class="term"><em class="parameter"><code>layer_ID</code></em> :</span></p></td>
|
|
<td> Layer with alpha.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2685519"></a><h3>
|
|
<a name="gimp-selection-combine"></a>gimp_selection_combine ()</h3>
|
|
<a class="indexterm" name="id2685529"></a><pre class="programlisting"><a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_selection_combine (<a
|
|
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint32"
|
|
>gint32</a> channel_ID,
|
|
<a
|
|
href="/usr/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.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><p><span class="term"><em class="parameter"><code>channel_ID</code></em> :</span></p></td>
|
|
<td> The channel.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>operation</code></em> :</span></p></td>
|
|
<td> The selection operation.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> TRUE on success.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="id2685608"></a><div class="refsect2" lang="en"><a name="id2685609"></a></div>
|
|
<hr>
|
|
<div class="refsect2" lang="en"><a name="id2685610"></a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|