callisto-debian/gimp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Imported Upstream version 2.2.14

Browse Source
This commit is contained in:
Ari Pollak
2010-08-11 01:17:12 -04:00
parent 70ad8213cf
commit a2f097051e
490 changed files with 35329 additions and 58398 deletions
Download Patch File Download Diff File Expand all files Collapse all files

363
devel-docs/libgimp/html/libgimp-gimplayer.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gimplayer</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<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-gimpimage.html" title="gimpimage">
@ -28,16 +28,16 @@
<th width="100%" align="center">GIMP Library Reference Manual</th>
<td><a accesskey="n" href="libgimp-gimppaths.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="#id2541211" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2585484" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2600017" class="shortcut">Description</a></nobr></td></tr>
<a href="#id2633411" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimp-gimplayer"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2541211"></a><span class="refentrytitle">gimplayer</span>
<a name="id2585484"></a><span class="refentrytitle">gimplayer</span>
</h2>
<p>gimplayer &#8212; Operations on a single layer.</p>
</td>
@ -108,18 +108,18 @@ gboolean <a href="libgimp-gimplayer.html#gimp-layer-is-floating-sel">gimp_lay
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2600017"></a><h2>Description</h2>
<a name="id2633411"></a><h2>Description</h2>
<p>
Operations on a single layer.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2600033"></a><h2>Details</h2>
<a name="id2633427"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2600044"></a><h3>
<a name="id2633438"></a><h3>
<a name="gimp-layer-new"></a>gimp_layer_new ()</h3>
<a class="indexterm" name="id2600056"></a><pre class="programlisting">gint32 gimp_layer_new (gint32 image_ID,
<a class="indexterm" name="id2633450"></a><pre class="programlisting">gint32 gimp_layer_new (gint32 image_ID,
const gchar *name,
gint width,
gint height,
@ -145,50 +145,42 @@ should be set with explicit procedure calls.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td> The image to which to add the layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></td>
<td> The layer name.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>width</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>width</code></em>&#160;:</span></td>
<td> The layer width.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>height</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>height</code></em>&#160;:</span></td>
<td> The layer height.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></td>
<td> The layer type.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>opacity</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>opacity</code></em>&#160;:</span></td>
<td> The layer opacity.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mode</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>mode</code></em>&#160;:</span></td>
<td> The layer combination mode.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly created layer.
</td>
</tr>
@ -197,9 +189,9 @@ should be set with explicit procedure calls.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605170"></a><h3>
<a name="id2638146"></a><h3>
<a name="gimp-layer-copy"></a>gimp_layer_copy ()</h3>
<a class="indexterm" name="id2605183"></a><pre class="programlisting">gint32 gimp_layer_copy (gint32 layer_ID);</pre>
<a class="indexterm" name="id2638158"></a><pre class="programlisting">gint32 gimp_layer_copy (gint32 layer_ID);</pre>
<p>
Copy a layer.
</p>
@ -216,14 +208,12 @@ before you add the new layer to the image.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer to copy.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly copied layer.
</td>
</tr>
@ -232,9 +222,9 @@ before you add the new layer to the image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605251"></a><h3>
<a name="id2638226"></a><h3>
<a name="gimp-layer-scale"></a>gimp_layer_scale ()</h3>
<a class="indexterm" name="id2605263"></a><pre class="programlisting">gboolean gimp_layer_scale (gint32 layer_ID,
<a class="indexterm" name="id2638238"></a><pre class="programlisting">gboolean gimp_layer_scale (gint32 layer_ID,
gint new_width,
gint new_height,
gboolean local_origin);</pre>
@ -254,32 +244,27 @@ to an image.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>new_width</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>new_width</code></em>&#160;:</span></td>
<td> New layer width.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>new_height</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>new_height</code></em>&#160;:</span></td>
<td> New layer height.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>local_origin</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>local_origin</code></em>&#160;:</span></td>
<td> Use a local origin (as opposed to the image origin).
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -288,9 +273,9 @@ to an image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605396"></a><h3>
<a name="id2638371"></a><h3>
<a name="gimp-layer-resize"></a>gimp_layer_resize ()</h3>
<a class="indexterm" name="id2605408"></a><pre class="programlisting">gboolean gimp_layer_resize (gint32 layer_ID,
<a class="indexterm" name="id2638383"></a><pre class="programlisting">gboolean gimp_layer_resize (gint32 layer_ID,
gint new_width,
gint new_height,
gint offx,
@ -310,38 +295,32 @@ operation only works if the layer has been added to an image.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>new_width</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>new_width</code></em>&#160;:</span></td>
<td> New layer width.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>new_height</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>new_height</code></em>&#160;:</span></td>
<td> New layer height.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>offx</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>offx</code></em>&#160;:</span></td>
<td> x offset between upper left corner of old and new layers: (old - new).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>offy</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>offy</code></em>&#160;:</span></td>
<td> y offset between upper left corner of old and new layers: (old - new).
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -350,9 +329,9 @@ operation only works if the layer has been added to an image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605563"></a><h3>
<a name="id2638538"></a><h3>
<a name="gimp-layer-resize-to-image-size"></a>gimp_layer_resize_to_image_size ()</h3>
<a class="indexterm" name="id2605574"></a><pre class="programlisting">gboolean gimp_layer_resize_to_image_size (gint32 layer_ID);</pre>
<a class="indexterm" name="id2638549"></a><pre class="programlisting">gboolean gimp_layer_resize_to_image_size (gint32 layer_ID);</pre>
<p>
Resize a layer to the image size.
</p>
@ -366,14 +345,12 @@ are equal to the width and height of its image container.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer to resize.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -382,9 +359,9 @@ are equal to the width and height of its image container.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605640"></a><h3>
<a name="id2638614"></a><h3>
<a name="gimp-layer-translate"></a>gimp_layer_translate ()</h3>
<a class="indexterm" name="id2605651"></a><pre class="programlisting">gboolean gimp_layer_translate (gint32 layer_ID,
<a class="indexterm" name="id2638625"></a><pre class="programlisting">gboolean gimp_layer_translate (gint32 layer_ID,
gint offx,
gint offy);</pre>
<p>
@ -404,26 +381,22 @@ the specified offsets.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>offx</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>offx</code></em>&#160;:</span></td>
<td> Offset in x direction.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>offy</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>offy</code></em>&#160;:</span></td>
<td> Offset in y direction.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -432,9 +405,9 @@ the specified offsets.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605763"></a><h3>
<a name="id2638738"></a><h3>
<a name="gimp-layer-add-alpha"></a>gimp_layer_add_alpha ()</h3>
<a class="indexterm" name="id2605774"></a><pre class="programlisting">gboolean gimp_layer_add_alpha (gint32 layer_ID);</pre>
<a class="indexterm" name="id2638749"></a><pre class="programlisting">gboolean gimp_layer_add_alpha (gint32 layer_ID);</pre>
<p>
Add an alpha channel to the layer if it doesn't already have one.
</p>
@ -452,14 +425,12 @@ and INDEXED to INDEXEDA.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -468,9 +439,9 @@ and INDEXED to INDEXEDA.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605845"></a><h3>
<a name="id2638819"></a><h3>
<a name="gimp-layer-set-offsets"></a>gimp_layer_set_offsets ()</h3>
<a class="indexterm" name="id2605856"></a><pre class="programlisting">gboolean gimp_layer_set_offsets (gint32 layer_ID,
<a class="indexterm" name="id2638831"></a><pre class="programlisting">gboolean gimp_layer_set_offsets (gint32 layer_ID,
gint offx,
gint offy);</pre>
<p>
@ -487,26 +458,22 @@ operation is valid only on layers which have been added to an image.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>offx</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>offx</code></em>&#160;:</span></td>
<td> Offset in x direction.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>offy</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>offy</code></em>&#160;:</span></td>
<td> Offset in y direction.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -515,9 +482,9 @@ operation is valid only on layers which have been added to an image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605964"></a><h3>
<a name="id2638939"></a><h3>
<a name="gimp-layer-create-mask"></a>gimp_layer_create_mask ()</h3>
<a class="indexterm" name="id2605976"></a><pre class="programlisting">gint32 gimp_layer_create_mask (gint32 layer_ID,
<a class="indexterm" name="id2638950"></a><pre class="programlisting">gint32 gimp_layer_create_mask (gint32 layer_ID,
<a href="libgimp-gimpenums.html#GimpAddMaskType">GimpAddMaskType</a> mask_type);</pre>
<p>
Create a layer mask for the specified specified layer.
@ -540,20 +507,17 @@ to 'gimp_layer_add_mask'.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer to which to add the mask.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mask_type</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>mask_type</code></em>&#160;:</span></td>
<td> The type of mask.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly created mask.
</td>
</tr>
@ -562,9 +526,9 @@ to 'gimp_layer_add_mask'.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606037"></a><h3>
<a name="id2639008"></a><h3>
<a name="gimp-layer-from-mask"></a>gimp_layer_from_mask ()</h3>
<a class="indexterm" name="id2606050"></a><pre class="programlisting">gint32 gimp_layer_from_mask (gint32 mask_ID);</pre>
<a class="indexterm" name="id2639021"></a><pre class="programlisting">gint32 gimp_layer_from_mask (gint32 mask_ID);</pre>
<p>
Get the specified mask's layer.
</p>
@ -578,14 +542,12 @@ exists.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>mask_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>mask_ID</code></em>&#160;:</span></td>
<td> Mask for which to return the layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The mask's layer.
</td>
@ -597,9 +559,9 @@ exists.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606120"></a><h3>
<a name="id2639091"></a><h3>
<a name="gimp-layer-get-mask"></a>gimp_layer_get_mask ()</h3>
<a class="indexterm" name="id2606132"></a><pre class="programlisting">gint32 gimp_layer_get_mask (gint32 layer_ID);</pre>
<a class="indexterm" name="id2639103"></a><pre class="programlisting">gint32 gimp_layer_get_mask (gint32 layer_ID);</pre>
<p>
Get the specified layer's mask if it exists.
</p>
@ -613,14 +575,12 @@ exists.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The layer mask.
</td>
</tr>
@ -629,9 +589,9 @@ exists.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606198"></a><h3>
<a name="id2639169"></a><h3>
<a name="gimp-layer-add-mask"></a>gimp_layer_add_mask ()</h3>
<a class="indexterm" name="id2606210"></a><pre class="programlisting">gboolean gimp_layer_add_mask (gint32 layer_ID,
<a class="indexterm" name="id2639181"></a><pre class="programlisting">gboolean gimp_layer_add_mask (gint32 layer_ID,
gint32 mask_ID);</pre>
<p>
Add a layer mask to the specified layer.
@ -650,20 +610,17 @@ have been created for use with the specified image.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer to receive the mask.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mask_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>mask_ID</code></em>&#160;:</span></td>
<td> The mask to add to the layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -672,9 +629,9 @@ have been created for use with the specified image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606301"></a><h3>
<a name="id2639272"></a><h3>
<a name="gimp-layer-remove-mask"></a>gimp_layer_remove_mask ()</h3>
<a class="indexterm" name="id2606312"></a><pre class="programlisting">gboolean gimp_layer_remove_mask (gint32 layer_ID,
<a class="indexterm" name="id2639284"></a><pre class="programlisting">gboolean gimp_layer_remove_mask (gint32 layer_ID,
<a href="libgimp-gimpenums.html#GimpMaskApplyMode">GimpMaskApplyMode</a> mode);</pre>
<p>
Remove the specified layer mask from the layer.
@ -689,20 +646,17 @@ the mask doesn't exist, an error is returned.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer from which to remove mask.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mode</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>mode</code></em>&#160;:</span></td>
<td> Removal mode.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -711,9 +665,9 @@ the mask doesn't exist, an error is returned.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606401"></a><h3>
<a name="id2639372"></a><h3>
<a name="gimp-layer-new-from-drawable"></a>gimp_layer_new_from_drawable ()</h3>
<a class="indexterm" name="id2606412"></a><pre class="programlisting">gint32 gimp_layer_new_from_drawable (gint32 drawable_ID,
<a class="indexterm" name="id2639384"></a><pre class="programlisting">gint32 gimp_layer_new_from_drawable (gint32 drawable_ID,
gint32 dest_image_ID);</pre>
<p>
Create a new layer by copying an existing drawable.
@ -731,20 +685,17 @@ modes, and offsets should be set with explicit procedure calls.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
<td> The source drawable from where the new layer is copied.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>dest_image_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>dest_image_ID</code></em>&#160;:</span></td>
<td> The destination image to which to add the layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly copied layer.
</td>
</tr>
@ -753,9 +704,9 @@ modes, and offsets should be set with explicit procedure calls.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606504"></a><h3>
<a name="id2639476"></a><h3>
<a name="gimp-layer-get-preserve-trans"></a>gimp_layer_get_preserve_trans ()</h3>
<a class="indexterm" name="id2606518"></a><pre class="programlisting">gboolean gimp_layer_get_preserve_trans (gint32 layer_ID);</pre>
<a class="indexterm" name="id2639489"></a><pre class="programlisting">gboolean gimp_layer_get_preserve_trans (gint32 layer_ID);</pre>
<p>
Get the preserve transperancy setting of the specified layer.
</p>
@ -769,14 +720,12 @@ setting.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The layer's preserve transperancy setting.
</td>
</tr>
@ -785,9 +734,9 @@ setting.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606585"></a><h3>
<a name="id2639557"></a><h3>
<a name="gimp-layer-set-preserve-trans"></a>gimp_layer_set_preserve_trans ()</h3>
<a class="indexterm" name="id2606598"></a><pre class="programlisting">gboolean gimp_layer_set_preserve_trans (gint32 layer_ID,
<a class="indexterm" name="id2639570"></a><pre class="programlisting">gboolean gimp_layer_set_preserve_trans (gint32 layer_ID,
gboolean preserve_trans);</pre>
<p>
Set the preserve transperancy setting of the specified layer.
@ -802,20 +751,17 @@ setting.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>preserve_trans</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>preserve_trans</code></em>&#160;:</span></td>
<td> The new layer's preserve transperancy setting.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -824,9 +770,9 @@ setting.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606687"></a><h3>
<a name="id2639658"></a><h3>
<a name="gimp-layer-get-apply-mask"></a>gimp_layer_get_apply_mask ()</h3>
<a class="indexterm" name="id2606698"></a><pre class="programlisting">gboolean gimp_layer_get_apply_mask (gint32 layer_ID);</pre>
<a class="indexterm" name="id2639670"></a><pre class="programlisting">gboolean gimp_layer_get_apply_mask (gint32 layer_ID);</pre>
<p>
Get the apply mask of the specified layer.
</p>
@ -841,14 +787,12 @@ being composited with the layer's alpha channel.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The layer apply mask.
</td>
</tr>
@ -857,9 +801,9 @@ being composited with the layer's alpha channel.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606766"></a><h3>
<a name="id2639737"></a><h3>
<a name="gimp-layer-set-apply-mask"></a>gimp_layer_set_apply_mask ()</h3>
<a class="indexterm" name="id2606777"></a><pre class="programlisting">gboolean gimp_layer_set_apply_mask (gint32 layer_ID,
<a class="indexterm" name="id2639749"></a><pre class="programlisting">gboolean gimp_layer_set_apply_mask (gint32 layer_ID,
gboolean apply_mask);</pre>
<p>
Set the apply mask of the specified layer.
@ -875,20 +819,17 @@ If there is no layer mask, this function will return an error.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>apply_mask</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>apply_mask</code></em>&#160;:</span></td>
<td> The new layer apply mask.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -897,9 +838,9 @@ If there is no layer mask, this function will return an error.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606866"></a><h3>
<a name="id2639838"></a><h3>
<a name="gimp-layer-get-show-mask"></a>gimp_layer_get_show_mask ()</h3>
<a class="indexterm" name="id2606877"></a><pre class="programlisting">gboolean gimp_layer_get_show_mask (gint32 layer_ID);</pre>
<a class="indexterm" name="id2639849"></a><pre class="programlisting">gboolean gimp_layer_get_show_mask (gint32 layer_ID);</pre>
<p>
Get the show mask of the specified layer.
</p>
@ -914,14 +855,12 @@ shown instead of the layer.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The layer show mask.
</td>
</tr>
@ -930,9 +869,9 @@ shown instead of the layer.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606944"></a><h3>
<a name="id2639916"></a><h3>
<a name="gimp-layer-set-show-mask"></a>gimp_layer_set_show_mask ()</h3>
<a class="indexterm" name="id2606955"></a><pre class="programlisting">gboolean gimp_layer_set_show_mask (gint32 layer_ID,
<a class="indexterm" name="id2639927"></a><pre class="programlisting">gboolean gimp_layer_set_show_mask (gint32 layer_ID,
gboolean show_mask);</pre>
<p>
Set the show mask of the specified layer.
@ -949,20 +888,17 @@ function returns an error.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>show_mask</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>show_mask</code></em>&#160;:</span></td>
<td> The new layer show mask.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -971,9 +907,9 @@ function returns an error.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607044"></a><h3>
<a name="id2640016"></a><h3>
<a name="gimp-layer-get-edit-mask"></a>gimp_layer_get_edit_mask ()</h3>
<a class="indexterm" name="id2607055"></a><pre class="programlisting">gboolean gimp_layer_get_edit_mask (gint32 layer_ID);</pre>
<a class="indexterm" name="id2640027"></a><pre class="programlisting">gboolean gimp_layer_get_edit_mask (gint32 layer_ID);</pre>
<p>
Get the show mask of the specified layer.
</p>
@ -988,14 +924,12 @@ and not the layer.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The layer show mask.
</td>
</tr>
@ -1004,9 +938,9 @@ and not the layer.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607122"></a><h3>
<a name="id2640094"></a><h3>
<a name="gimp-layer-set-edit-mask"></a>gimp_layer_set_edit_mask ()</h3>
<a class="indexterm" name="id2607133"></a><pre class="programlisting">gboolean gimp_layer_set_edit_mask (gint32 layer_ID,
<a class="indexterm" name="id2640105"></a><pre class="programlisting">gboolean gimp_layer_set_edit_mask (gint32 layer_ID,
gboolean edit_mask);</pre>
<p>
Set the show mask of the specified layer.
@ -1023,20 +957,17 @@ return an error.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>edit_mask</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>edit_mask</code></em>&#160;:</span></td>
<td> The new layer show mask.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -1045,9 +976,9 @@ return an error.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607222"></a><h3>
<a name="id2640194"></a><h3>
<a name="gimp-layer-get-opacity"></a>gimp_layer_get_opacity ()</h3>
<a class="indexterm" name="id2607233"></a><pre class="programlisting">gdouble gimp_layer_get_opacity (gint32 layer_ID);</pre>
<a class="indexterm" name="id2640205"></a><pre class="programlisting">gdouble gimp_layer_get_opacity (gint32 layer_ID);</pre>
<p>
Get the opacity of the specified layer.
</p>
@ -1060,14 +991,12 @@ This procedure returns the specified layer's opacity.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The layer opacity.
</td>
</tr>
@ -1076,9 +1005,9 @@ This procedure returns the specified layer's opacity.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607298"></a><h3>
<a name="id2640270"></a><h3>
<a name="gimp-layer-set-opacity"></a>gimp_layer_set_opacity ()</h3>
<a class="indexterm" name="id2607309"></a><pre class="programlisting">gboolean gimp_layer_set_opacity (gint32 layer_ID,
<a class="indexterm" name="id2640281"></a><pre class="programlisting">gboolean gimp_layer_set_opacity (gint32 layer_ID,
gdouble opacity);</pre>
<p>
Set the opacity of the specified layer.
@ -1092,20 +1021,17 @@ This procedure sets the specified layer's opacity.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>opacity</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>opacity</code></em>&#160;:</span></td>
<td> The new layer opacity.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -1114,9 +1040,9 @@ This procedure sets the specified layer's opacity.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607395"></a><h3>
<a name="id2640367"></a><h3>
<a name="gimp-layer-get-mode"></a>gimp_layer_get_mode ()</h3>
<a class="indexterm" name="id2607407"></a><pre class="programlisting"><a href="libgimp-gimpenums.html#GimpLayerModeEffects">GimpLayerModeEffects</a> gimp_layer_get_mode (gint32 layer_ID);</pre>
<a class="indexterm" name="id2640379"></a><pre class="programlisting"><a href="libgimp-gimpenums.html#GimpLayerModeEffects">GimpLayerModeEffects</a> gimp_layer_get_mode (gint32 layer_ID);</pre>
<p>
Get the combination mode of the specified layer.
</p>
@ -1129,14 +1055,12 @@ This procedure returns the specified layer's combination mode.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The layer combination mode.
</td>
</tr>
@ -1145,9 +1069,9 @@ This procedure returns the specified layer's combination mode.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607472"></a><h3>
<a name="id2640444"></a><h3>
<a name="gimp-layer-set-mode"></a>gimp_layer_set_mode ()</h3>
<a class="indexterm" name="id2607484"></a><pre class="programlisting">gboolean gimp_layer_set_mode (gint32 layer_ID,
<a class="indexterm" name="id2640456"></a><pre class="programlisting">gboolean gimp_layer_set_mode (gint32 layer_ID,
<a href="libgimp-gimpenums.html#GimpLayerModeEffects">GimpLayerModeEffects</a> mode);</pre>
<p>
Set the combination mode of the specified layer.
@ -1161,20 +1085,17 @@ This procedure sets the specified layer's combination mode.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mode</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>mode</code></em>&#160;:</span></td>
<td> The new layer combination mode.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
@ -1183,9 +1104,9 @@ This procedure sets the specified layer's combination mode.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607571"></a><h3>
<a name="id2640542"></a><h3>
<a name="gimp-layer-is-floating-sel"></a>gimp_layer_is_floating_sel ()</h3>
<a class="indexterm" name="id2607582"></a><pre class="programlisting">gboolean gimp_layer_is_floating_sel (gint32 layer_ID);</pre>
<a class="indexterm" name="id2640554"></a><pre class="programlisting">gboolean gimp_layer_is_floating_sel (gint32 layer_ID);</pre>
<p>
Is the specified layer a floating selection?
</p>
@ -1200,14 +1121,12 @@ to a specific drawable.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>layer_ID</code></em>&#160;:</span></td>
<td> The layer.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> Non-zero if the layer is a floating selection.
</td>
</tr>