Imported Upstream version 2.3.14

This commit is contained in:
Ari Pollak
2010-08-11 01:20:46 -04:00
parent bbd6d9844c
commit aca02f7697
2412 changed files with 114847 additions and 56535 deletions

View File

@ -5,18 +5,17 @@
<title>gimpdrawable</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.71.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="up" href="libgimp-image.html" title="Manupulating Images and their Properties">
<link rel="prev" href="libgimp-gimpdisplay.html" title="gimpdisplay">
<link rel="next" href="libgimp-gimpdrawabletransform.html" title="gimpdrawabletransform">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gimpdefinitions.html" title="Part&#160;I.&#160;GIMP Constants">
<link rel="part" href="libgimp.html" title="Part&#160;II.&#160;GIMP Library">
<link rel="part" href="libgimp.html" title="Part&#160;I.&#160;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-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&#160;III.&#160;GIMP User Interface Library">
<link rel="part" href="libgimpui.html" title="Part&#160;II.&#160;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">
@ -32,16 +31,16 @@
<th width="100%" align="center">GIMP Library Reference Manual</th>
<td><a accesskey="n" href="libgimp-gimpdrawabletransform.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="#id2557087" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2559480" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2617312" class="shortcut">Description</a></nobr></td></tr>
<a href="#id2617478" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimp-gimpdrawable"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2557087"></a><span class="refentrytitle">gimpdrawable</span>
<a name="id2559480"></a><span class="refentrytitle">gimpdrawable</span>
</h2>
<p>gimpdrawable &#8212; Functions to manipulate drawables.</p>
</td>
@ -58,6 +57,7 @@
void <a href="libgimp-gimpdrawable.html#gimp-drawable-detach">gimp_drawable_detach</a> (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable);
void <a href="libgimp-gimpdrawable.html#gimp-drawable-flush">gimp_drawable_flush</a> (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable);
gboolean <a href="libgimp-gimpdrawable.html#gimp-drawable-delete">gimp_drawable_delete</a> (gint32 drawable_ID);
gboolean <a href="libgimp-gimpdrawable.html#gimp-drawable-is-valid">gimp_drawable_is_valid</a> (gint32 drawable_ID);
gchar* <a href="libgimp-gimpdrawable.html#gimp-drawable-get-name">gimp_drawable_get_name</a> (gint32 drawable_ID);
gboolean <a href="libgimp-gimpdrawable.html#gimp-drawable-set-name">gimp_drawable_set_name</a> (gint32 drawable_ID,
const gchar *name);
@ -180,18 +180,18 @@ gboolean <a href="libgimp-gimpdrawable.html#gimp-drawable-attach-new-parasite
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2617312"></a><h2>Description</h2>
<a name="id2617478"></a><h2>Description</h2>
<p>
Functions to manipulate drawables.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2617325"></a><h2>Details</h2>
<a name="id2617492"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2617335"></a><h3>
<a name="id2617501"></a><h3>
<a name="GimpDrawable"></a>GimpDrawable</h3>
<a class="indexterm" name="id2617345"></a><pre class="programlisting">typedef struct {
<a class="indexterm" name="id2617511"></a><pre class="programlisting">typedef struct {
gint32 drawable_id; /* drawable ID */
guint width; /* width of drawble */
guint height; /* height of drawble */
@ -208,9 +208,9 @@ Functions to manipulate drawables.
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617366"></a><h3>
<a name="id2617532"></a><h3>
<a name="gimp-drawable-get"></a>gimp_drawable_get ()</h3>
<a class="indexterm" name="id2617376"></a><pre class="programlisting"><a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a>* gimp_drawable_get (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2617543"></a><pre class="programlisting"><a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a>* gimp_drawable_get (gint32 drawable_ID);</pre>
<p>
This function creates a <a href="libgimp-gimpdrawable.html#GimpDrawable"><span class="type">GimpDrawable</span></a> structure for the core
drawable identified by <em class="parameter"><code>drawable_ID</code></em>. The returned structure
@ -248,9 +248,9 @@ transferred back to the core.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617472"></a><h3>
<a name="id2617638"></a><h3>
<a name="gimp-drawable-detach"></a>gimp_drawable_detach ()</h3>
<a class="indexterm" name="id2617482"></a><pre class="programlisting">void gimp_drawable_detach (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable);</pre>
<a class="indexterm" name="id2617649"></a><pre class="programlisting">void gimp_drawable_detach (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable);</pre>
<p>
This function is called when a plug-in is finished working
with a drawable. It forces all tile data held in the tile
@ -271,9 +271,9 @@ then frees all associated memory. You must not access the
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617555"></a><h3>
<a name="id2617722"></a><h3>
<a name="gimp-drawable-flush"></a>gimp_drawable_flush ()</h3>
<a class="indexterm" name="id2617566"></a><pre class="programlisting">void gimp_drawable_flush (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable);</pre>
<a class="indexterm" name="id2617732"></a><pre class="programlisting">void gimp_drawable_flush (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable);</pre>
<p>
This function causes all tile data in the tile list of <em class="parameter"><code>drawable</code></em> to be
transferred to the core. It is usually called in situations where a
@ -295,9 +295,9 @@ to the core.
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617634"></a><h3>
<a name="id2617801"></a><h3>
<a name="gimp-drawable-delete"></a>gimp_drawable_delete ()</h3>
<a class="indexterm" name="id2617645"></a><pre class="programlisting">gboolean gimp_drawable_delete (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2617811"></a><pre class="programlisting">gboolean gimp_drawable_delete (gint32 drawable_ID);</pre>
<p>
Delete a drawable.
</p>
@ -328,9 +328,42 @@ which has not yet been added to an image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617706"></a><h3>
<a name="id2617872"></a><h3>
<a name="gimp-drawable-is-valid"></a>gimp_drawable_is_valid ()</h3>
<a class="indexterm" name="id2617884"></a><pre class="programlisting">gboolean gimp_drawable_is_valid (gint32 drawable_ID);</pre>
<p>
Returns TRUE if the drawable is valid.
</p>
<p>
This procedure checks if the given drawable ID is valid and refers
to an existing drawable.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
<td> The drawable to check.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> Whether the drawable ID is valid.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617946"></a><h3>
<a name="gimp-drawable-get-name"></a>gimp_drawable_get_name ()</h3>
<a class="indexterm" name="id2617716"></a><pre class="programlisting">gchar* gimp_drawable_get_name (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2617956"></a><pre class="programlisting">gchar* gimp_drawable_get_name (gint32 drawable_ID);</pre>
<p>
Get the name of the specified drawable.
</p>
@ -357,9 +390,9 @@ This procedure returns the specified drawable's name.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617773"></a><h3>
<a name="id2618014"></a><h3>
<a name="gimp-drawable-set-name"></a>gimp_drawable_set_name ()</h3>
<a class="indexterm" name="id2617783"></a><pre class="programlisting">gboolean gimp_drawable_set_name (gint32 drawable_ID,
<a class="indexterm" name="id2618024"></a><pre class="programlisting">gboolean gimp_drawable_set_name (gint32 drawable_ID,
const gchar *name);</pre>
<p>
Set the name of the specified drawable.
@ -392,9 +425,9 @@ This procedure sets the specified drawable's name.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617859"></a><h3>
<a name="id2618102"></a><h3>
<a name="gimp-drawable-get-visible"></a>gimp_drawable_get_visible ()</h3>
<a class="indexterm" name="id2617870"></a><pre class="programlisting">gboolean gimp_drawable_get_visible (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2618112"></a><pre class="programlisting">gboolean gimp_drawable_get_visible (gint32 drawable_ID);</pre>
<p>
Get the visibility of the specified drawable.
</p>
@ -421,9 +454,9 @@ This procedure returns the specified drawable's visibility.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617927"></a><h3>
<a name="id2618171"></a><h3>
<a name="gimp-drawable-set-visible"></a>gimp_drawable_set_visible ()</h3>
<a class="indexterm" name="id2617938"></a><pre class="programlisting">gboolean gimp_drawable_set_visible (gint32 drawable_ID,
<a class="indexterm" name="id2618181"></a><pre class="programlisting">gboolean gimp_drawable_set_visible (gint32 drawable_ID,
gboolean visible);</pre>
<p>
Set the visibility of the specified drawable.
@ -456,9 +489,9 @@ This procedure sets the specified drawable's visibility.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618016"></a><h3>
<a name="id2618259"></a><h3>
<a name="gimp-drawable-get-linked"></a>gimp_drawable_get_linked ()</h3>
<a class="indexterm" name="id2618026"></a><pre class="programlisting">gboolean gimp_drawable_get_linked (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2618270"></a><pre class="programlisting">gboolean gimp_drawable_get_linked (gint32 drawable_ID);</pre>
<p>
Get the linked state of the specified drawable.
</p>
@ -485,9 +518,9 @@ This procedure returns the specified drawable's linked state.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618086"></a><h3>
<a name="id2618329"></a><h3>
<a name="gimp-drawable-set-linked"></a>gimp_drawable_set_linked ()</h3>
<a class="indexterm" name="id2618096"></a><pre class="programlisting">gboolean gimp_drawable_set_linked (gint32 drawable_ID,
<a class="indexterm" name="id2618340"></a><pre class="programlisting">gboolean gimp_drawable_set_linked (gint32 drawable_ID,
gboolean linked);</pre>
<p>
Set the linked state of the specified drawable.
@ -520,9 +553,9 @@ This procedure sets the specified drawable's linked state.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618174"></a><h3>
<a name="id2618418"></a><h3>
<a name="gimp-drawable-get-tattoo"></a>gimp_drawable_get_tattoo ()</h3>
<a class="indexterm" name="id2618185"></a><pre class="programlisting">gint gimp_drawable_get_tattoo (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2618428"></a><pre class="programlisting">gint gimp_drawable_get_tattoo (gint32 drawable_ID);</pre>
<p>
Get the tattoo of the specified drawable.
</p>
@ -552,9 +585,9 @@ sessions.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618246"></a><h3>
<a name="id2618489"></a><h3>
<a name="gimp-drawable-set-tattoo"></a>gimp_drawable_set_tattoo ()</h3>
<a class="indexterm" name="id2618256"></a><pre class="programlisting">gboolean gimp_drawable_set_tattoo (gint32 drawable_ID,
<a class="indexterm" name="id2618500"></a><pre class="programlisting">gboolean gimp_drawable_set_tattoo (gint32 drawable_ID,
gint tattoo);</pre>
<p>
Set the tattoo of the specified drawable.
@ -590,9 +623,9 @@ sessions.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618336"></a><h3>
<a name="id2618580"></a><h3>
<a name="gimp-drawable-get-pixel"></a>gimp_drawable_get_pixel ()</h3>
<a class="indexterm" name="id2618346"></a><pre class="programlisting">guint8* gimp_drawable_get_pixel (gint32 drawable_ID,
<a class="indexterm" name="id2618590"></a><pre class="programlisting">guint8* gimp_drawable_get_pixel (gint32 drawable_ID,
gint x_coord,
gint y_coord,
gint *num_channels);</pre>
@ -639,9 +672,9 @@ bytes-per-pixel value for the specified drawable.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618465"></a><h3>
<a name="id2618708"></a><h3>
<a name="gimp-drawable-set-pixel"></a>gimp_drawable_set_pixel ()</h3>
<a class="indexterm" name="id2618475"></a><pre class="programlisting">gboolean gimp_drawable_set_pixel (gint32 drawable_ID,
<a class="indexterm" name="id2618719"></a><pre class="programlisting">gboolean gimp_drawable_set_pixel (gint32 drawable_ID,
gint x_coord,
gint y_coord,
gint num_channels,
@ -696,9 +729,9 @@ just created yourself.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618614"></a><h3>
<a name="id2618858"></a><h3>
<a name="gimp-drawable-get-tile"></a>gimp_drawable_get_tile ()</h3>
<a class="indexterm" name="id2618625"></a><pre class="programlisting"><a href="libgimp-gimptile.html#GimpTile">GimpTile</a>* gimp_drawable_get_tile (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable,
<a class="indexterm" name="id2618868"></a><pre class="programlisting"><a href="libgimp-gimptile.html#GimpTile">GimpTile</a>* gimp_drawable_get_tile (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable,
gboolean shadow,
gint row,
gint col);</pre>
@ -740,9 +773,9 @@ just created yourself.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618731"></a><h3>
<a name="id2618975"></a><h3>
<a name="gimp-drawable-get-tile2"></a>gimp_drawable_get_tile2 ()</h3>
<a class="indexterm" name="id2618742"></a><pre class="programlisting"><a href="libgimp-gimptile.html#GimpTile">GimpTile</a>* gimp_drawable_get_tile2 (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable,
<a class="indexterm" name="id2618985"></a><pre class="programlisting"><a href="libgimp-gimptile.html#GimpTile">GimpTile</a>* gimp_drawable_get_tile2 (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable,
gboolean shadow,
gint x,
gint y);</pre>
@ -784,9 +817,9 @@ just created yourself.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618849"></a><h3>
<a name="id2619092"></a><h3>
<a name="gimp-drawable-get-thumbnail-data"></a>gimp_drawable_get_thumbnail_data ()</h3>
<a class="indexterm" name="id2618861"></a><pre class="programlisting">guchar* gimp_drawable_get_thumbnail_data
<a class="indexterm" name="id2619104"></a><pre class="programlisting">guchar* gimp_drawable_get_thumbnail_data
(gint32 drawable_ID,
gint *width,
gint *height,
@ -829,9 +862,9 @@ just created yourself.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618969"></a><h3>
<a name="id2619213"></a><h3>
<a name="gimp-drawable-get-sub-thumbnail-data"></a>gimp_drawable_get_sub_thumbnail_data ()</h3>
<a class="indexterm" name="id2618982"></a><pre class="programlisting">guchar* gimp_drawable_get_sub_thumbnail_data
<a class="indexterm" name="id2619226"></a><pre class="programlisting">guchar* gimp_drawable_get_sub_thumbnail_data
(gint32 drawable_ID,
gint src_x,
gint src_y,
@ -898,9 +931,9 @@ just created yourself.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619167"></a><h3>
<a name="id2619410"></a><h3>
<a name="gimp-drawable-get-color-uchar"></a>gimp_drawable_get_color_uchar ()</h3>
<a class="indexterm" name="id2619179"></a><pre class="programlisting">void gimp_drawable_get_color_uchar (gint32 drawable_ID,
<a class="indexterm" name="id2619422"></a><pre class="programlisting">void gimp_drawable_get_color_uchar (gint32 drawable_ID,
const <a
href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"
>GimpRGB</a> *color,
@ -933,9 +966,9 @@ href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619258"></a><h3>
<a name="id2619502"></a><h3>
<a name="gimp-drawable-merge-shadow"></a>gimp_drawable_merge_shadow ()</h3>
<a class="indexterm" name="id2619269"></a><pre class="programlisting">gboolean gimp_drawable_merge_shadow (gint32 drawable_ID,
<a class="indexterm" name="id2619516"></a><pre class="programlisting">gboolean gimp_drawable_merge_shadow (gint32 drawable_ID,
gboolean undo);</pre>
<p>
Merge the shadow buffer with the specified drawable.
@ -971,9 +1004,9 @@ Requesting no undo is useful for such applications as 'auto-apply'.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619350"></a><h3>
<a name="id2619607"></a><h3>
<a name="gimp-drawable-fill"></a>gimp_drawable_fill ()</h3>
<a class="indexterm" name="id2619361"></a><pre class="programlisting">gboolean gimp_drawable_fill (gint32 drawable_ID,
<a class="indexterm" name="id2619621"></a><pre class="programlisting">gboolean gimp_drawable_fill (gint32 drawable_ID,
<a href="libgimp-gimpenums.html#GimpFillType">GimpFillType</a> fill_type);</pre>
<p>
Fill the drawable with the specified fill mode.
@ -1015,9 +1048,9 @@ before adding it to the image. This operation cannot be undone.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619450"></a><h3>
<a name="id2619718"></a><h3>
<a name="gimp-drawable-update"></a>gimp_drawable_update ()</h3>
<a class="indexterm" name="id2619463"></a><pre class="programlisting">gboolean gimp_drawable_update (gint32 drawable_ID,
<a class="indexterm" name="id2619731"></a><pre class="programlisting">gboolean gimp_drawable_update (gint32 drawable_ID,
gint x,
gint y,
gint width,
@ -1071,9 +1104,9 @@ image origin. Therefore, the entire drawable can be updated using
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619618"></a><h3>
<a name="id2619886"></a><h3>
<a name="gimp-drawable-mask-bounds"></a>gimp_drawable_mask_bounds ()</h3>
<a class="indexterm" name="id2619633"></a><pre class="programlisting">gboolean gimp_drawable_mask_bounds (gint32 drawable_ID,
<a class="indexterm" name="id2619900"></a><pre class="programlisting">gboolean gimp_drawable_mask_bounds (gint32 drawable_ID,
gint *x1,
gint *y1,
gint *x2,
@ -1084,10 +1117,10 @@ specified drawable.
</p>
<p>
This procedure returns whether there is a selection. If there is
one, the upper left and lower righthand corners of its bounding box
one, the upper left and lower right-hand corners of its bounding box
are returned. These coordinates are specified relative to the
drawable's origin, and bounded by the drawable's extents. Please
note that the pixel specified by the lower righthand coordinate of
note that the pixel specified by the lower right-hand 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).
@ -1136,9 +1169,9 @@ return value which is more useful in most cases.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619808"></a><h3>
<a name="id2620076"></a><h3>
<a name="gimp-drawable-mask-intersect"></a>gimp_drawable_mask_intersect ()</h3>
<a class="indexterm" name="id2619824"></a><pre class="programlisting">gboolean gimp_drawable_mask_intersect (gint32 drawable_ID,
<a class="indexterm" name="id2620092"></a><pre class="programlisting">gboolean gimp_drawable_mask_intersect (gint32 drawable_ID,
gint *x,
gint *y,
gint *width,
@ -1197,9 +1230,9 @@ are the extents of the whole drawable.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619996"></a><h3>
<a name="id2620264"></a><h3>
<a name="gimp-drawable-get-image"></a>gimp_drawable_get_image ()</h3>
<a class="indexterm" name="id2620010"></a><pre class="programlisting">gint32 gimp_drawable_get_image (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2620278"></a><pre class="programlisting">gint32 gimp_drawable_get_image (gint32 drawable_ID);</pre>
<p>
Returns the drawable's image.
</p>
@ -1226,9 +1259,9 @@ This procedure returns the drawable's image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620076"></a><h3>
<a name="id2620344"></a><h3>
<a name="gimp-drawable-set-image"></a>gimp_drawable_set_image ()</h3>
<a class="indexterm" name="id2620092"></a><pre class="programlisting">gboolean gimp_drawable_set_image (gint32 drawable_ID,
<a class="indexterm" name="id2620360"></a><pre class="programlisting">gboolean gimp_drawable_set_image (gint32 drawable_ID,
gint32 image_ID);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
@ -1262,9 +1295,9 @@ This procedure is deprecated!</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620187"></a><h3>
<a name="id2620455"></a><h3>
<a name="gimp-drawable-has-alpha"></a>gimp_drawable_has_alpha ()</h3>
<a class="indexterm" name="id2620200"></a><pre class="programlisting">gboolean gimp_drawable_has_alpha (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2620468"></a><pre class="programlisting">gboolean gimp_drawable_has_alpha (gint32 drawable_ID);</pre>
<p>
Returns TRUE if the drawable has an alpha channel.
</p>
@ -1293,9 +1326,9 @@ will be one of: { RGBA , GRAYA, INDEXEDA }.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620269"></a><h3>
<a name="id2620537"></a><h3>
<a name="gimp-drawable-type-with-alpha"></a>gimp_drawable_type_with_alpha ()</h3>
<a class="indexterm" name="id2620283"></a><pre class="programlisting"><a
<a class="indexterm" name="id2620551"></a><pre class="programlisting"><a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
>GimpImageType</a> gimp_drawable_type_with_alpha (gint32 drawable_ID);</pre>
<p>
@ -1327,9 +1360,9 @@ the drawable's type is simply returned.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620353"></a><h3>
<a name="id2620621"></a><h3>
<a name="gimp-drawable-type"></a>gimp_drawable_type ()</h3>
<a class="indexterm" name="id2620366"></a><pre class="programlisting"><a
<a class="indexterm" name="id2620634"></a><pre class="programlisting"><a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
>GimpImageType</a> gimp_drawable_type (gint32 drawable_ID);</pre>
<p>
@ -1358,9 +1391,9 @@ This procedure returns the drawable's type.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620432"></a><h3>
<a name="id2620699"></a><h3>
<a name="gimp-drawable-is-rgb"></a>gimp_drawable_is_rgb ()</h3>
<a class="indexterm" name="id2620445"></a><pre class="programlisting">gboolean gimp_drawable_is_rgb (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2620713"></a><pre class="programlisting">gboolean gimp_drawable_is_rgb (gint32 drawable_ID);</pre>
<p>
Returns whether the drawable is an RGB type.
</p>
@ -1388,9 +1421,9 @@ RGB, RGBA }.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620512"></a><h3>
<a name="id2620780"></a><h3>
<a name="gimp-drawable-is-gray"></a>gimp_drawable_is_gray ()</h3>
<a class="indexterm" name="id2620526"></a><pre class="programlisting">gboolean gimp_drawable_is_gray (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2620793"></a><pre class="programlisting">gboolean gimp_drawable_is_gray (gint32 drawable_ID);</pre>
<p>
Returns whether the drawable is a grayscale type.
</p>
@ -1418,9 +1451,9 @@ Gray, GrayA }.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620592"></a><h3>
<a name="id2620860"></a><h3>
<a name="gimp-drawable-is-indexed"></a>gimp_drawable_is_indexed ()</h3>
<a class="indexterm" name="id2620606"></a><pre class="programlisting">gboolean gimp_drawable_is_indexed (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2620874"></a><pre class="programlisting">gboolean gimp_drawable_is_indexed (gint32 drawable_ID);</pre>
<p>
Returns whether the drawable is an indexed type.
</p>
@ -1448,9 +1481,9 @@ Indexed, IndexedA }.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620673"></a><h3>
<a name="id2620941"></a><h3>
<a name="gimp-drawable-bpp"></a>gimp_drawable_bpp ()</h3>
<a class="indexterm" name="id2620687"></a><pre class="programlisting">gint gimp_drawable_bpp (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2620955"></a><pre class="programlisting">gint gimp_drawable_bpp (gint32 drawable_ID);</pre>
<p>
Returns the bytes per pixel.
</p>
@ -1478,9 +1511,9 @@ of channels) for the specified drawable.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620753"></a><h3>
<a name="id2621021"></a><h3>
<a name="gimp-drawable-width"></a>gimp_drawable_width ()</h3>
<a class="indexterm" name="id2620767"></a><pre class="programlisting">gint gimp_drawable_width (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2621035"></a><pre class="programlisting">gint gimp_drawable_width (gint32 drawable_ID);</pre>
<p>
Returns the width of the drawable.
</p>
@ -1507,9 +1540,9 @@ This procedure returns the specified drawable's width in pixels.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620832"></a><h3>
<a name="id2621100"></a><h3>
<a name="gimp-drawable-height"></a>gimp_drawable_height ()</h3>
<a class="indexterm" name="id2620846"></a><pre class="programlisting">gint gimp_drawable_height (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2621114"></a><pre class="programlisting">gint gimp_drawable_height (gint32 drawable_ID);</pre>
<p>
Returns the height of the drawable.
</p>
@ -1536,9 +1569,9 @@ This procedure returns the specified drawable's height in pixels.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2620912"></a><h3>
<a name="id2621180"></a><h3>
<a name="gimp-drawable-offsets"></a>gimp_drawable_offsets ()</h3>
<a class="indexterm" name="id2620926"></a><pre class="programlisting">gboolean gimp_drawable_offsets (gint32 drawable_ID,
<a class="indexterm" name="id2621194"></a><pre class="programlisting">gboolean gimp_drawable_offsets (gint32 drawable_ID,
gint *offset_x,
gint *offset_y);</pre>
<p>
@ -1579,9 +1612,9 @@ The offsets of a channel will be returned as 0.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2621036"></a><h3>
<a name="id2621304"></a><h3>
<a name="gimp-drawable-is-layer"></a>gimp_drawable_is_layer ()</h3>
<a class="indexterm" name="id2621050"></a><pre class="programlisting">gboolean gimp_drawable_is_layer (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2621318"></a><pre class="programlisting">gboolean gimp_drawable_is_layer (gint32 drawable_ID);</pre>
<p>
Returns whether the drawable is a layer.
</p>
@ -1608,9 +1641,9 @@ This procedure returns TRUE if the specified drawable is a layer.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2621116"></a><h3>
<a name="id2621384"></a><h3>
<a name="gimp-drawable-is-layer-mask"></a>gimp_drawable_is_layer_mask ()</h3>
<a class="indexterm" name="id2621130"></a><pre class="programlisting">gboolean gimp_drawable_is_layer_mask (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2621398"></a><pre class="programlisting">gboolean gimp_drawable_is_layer_mask (gint32 drawable_ID);</pre>
<p>
Returns whether the drawable is a layer mask.
</p>
@ -1638,9 +1671,9 @@ mask.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2621197"></a><h3>
<a name="id2621464"></a><h3>
<a name="gimp-drawable-is-channel"></a>gimp_drawable_is_channel ()</h3>
<a class="indexterm" name="id2621210"></a><pre class="programlisting">gboolean gimp_drawable_is_channel (gint32 drawable_ID);</pre>
<a class="indexterm" name="id2621478"></a><pre class="programlisting">gboolean gimp_drawable_is_channel (gint32 drawable_ID);</pre>
<p>
Returns whether the drawable is a channel.
</p>
@ -1667,9 +1700,9 @@ This procedure returns TRUE if the specified drawable is a channel.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2621277"></a><h3>
<a name="id2621545"></a><h3>
<a name="gimp-drawable-offset"></a>gimp_drawable_offset ()</h3>
<a class="indexterm" name="id2621291"></a><pre class="programlisting">gboolean gimp_drawable_offset (gint32 drawable_ID,
<a class="indexterm" name="id2621559"></a><pre class="programlisting">gboolean gimp_drawable_offset (gint32 drawable_ID,
gboolean wrap_around,
<a href="libgimp-gimpenums.html#GimpOffsetType">GimpOffsetType</a> fill_type,
gint offset_x,
@ -1726,9 +1759,9 @@ specified by the 'fill-type' parameter.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2621450"></a><h3>
<a name="id2621718"></a><h3>
<a name="gimp-drawable-foreground-extract"></a>gimp_drawable_foreground_extract ()</h3>
<a class="indexterm" name="id2621466"></a><pre class="programlisting">gboolean gimp_drawable_foreground_extract
<a class="indexterm" name="id2621734"></a><pre class="programlisting">gboolean gimp_drawable_foreground_extract
(gint32 drawable_ID,
<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpForegroundExtractMode"
@ -1774,18 +1807,18 @@ http://www.inf.fu-berlin.de/inst/pubs/tr-b-05-07.pdf</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2621581"></a><h3>
<a name="id2621849"></a><h3>
<a name="gimp-drawable-parasite-find"></a>gimp_drawable_parasite_find ()</h3>
<a class="indexterm" name="id2621596"></a><pre class="programlisting"><a
<a class="indexterm" name="id2621864"></a><pre class="programlisting"><a
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
>GimpParasite</a>* gimp_drawable_parasite_find (gint32 drawable_ID,
const gchar *name);</pre>
<p>
Finds the named parasite in a drawable
Look up a parasite in a drawable
</p>
<p>
Finds and returns the named parasite that was previously attached to
a drawable.</p>
Finds and returns the parasite that was previously attached to a
drawable.</p>
<p>
</p>
@ -1812,9 +1845,9 @@ a drawable.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2621683"></a><h3>
<a name="id2621951"></a><h3>
<a name="gimp-drawable-parasite-list"></a>gimp_drawable_parasite_list ()</h3>
<a class="indexterm" name="id2621698"></a><pre class="programlisting">gboolean gimp_drawable_parasite_list (gint32 drawable_ID,
<a class="indexterm" name="id2621966"></a><pre class="programlisting">gboolean gimp_drawable_parasite_list (gint32 drawable_ID,
gint *num_parasites,
gchar ***parasites);</pre>
<p>
@ -1853,9 +1886,9 @@ Returns a list of all currently attached parasites.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2621806"></a><h3>
<a name="id2622074"></a><h3>
<a name="gimp-drawable-parasite-attach"></a>gimp_drawable_parasite_attach ()</h3>
<a class="indexterm" name="id2621821"></a><pre class="programlisting">gboolean gimp_drawable_parasite_attach (gint32 drawable_ID,
<a class="indexterm" name="id2622088"></a><pre class="programlisting">gboolean gimp_drawable_parasite_attach (gint32 drawable_ID,
const <a
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
>GimpParasite</a> *parasite);</pre>
@ -1891,9 +1924,9 @@ values.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2621909"></a><h3>
<a name="id2622176"></a><h3>
<a name="gimp-drawable-parasite-detach"></a>gimp_drawable_parasite_detach ()</h3>
<a class="indexterm" name="id2621923"></a><pre class="programlisting">gboolean gimp_drawable_parasite_detach (gint32 drawable_ID,
<a class="indexterm" name="id2622191"></a><pre class="programlisting">gboolean gimp_drawable_parasite_detach (gint32 drawable_ID,
const gchar *name);</pre>
<p>
Removes a parasite from a drawable.
@ -1927,9 +1960,9 @@ values.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2622011"></a><h3>
<a name="id2622279"></a><h3>
<a name="gimp-drawable-attach-new-parasite"></a>gimp_drawable_attach_new_parasite ()</h3>
<a class="indexterm" name="id2622026"></a><pre class="programlisting">gboolean gimp_drawable_attach_new_parasite
<a class="indexterm" name="id2622294"></a><pre class="programlisting">gboolean gimp_drawable_attach_new_parasite
(gint32 drawable_ID,
const gchar *name,
gint flags,