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

Imported Upstream version 2.2.13

Browse Source
This commit is contained in:
Ari Pollak
2010-08-11 01:16:57 -04:00
parent c055124f1e
commit 70ad8213cf
243 changed files with 10052 additions and 8795 deletions
Download Patch File Download Diff File Expand all files Collapse all files

292
devel-docs/libgimp/html/libgimp-gimpimage.html
View File

@ -1,3 +1,4 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
@ -7,7 +8,7 @@
<link rel="up" href="libgimp-image.html" title="Manupulating Images and all their Properties">
<link rel="prev" href="libgimp-gimpguides.html" title="gimpguides">
<link rel="next" href="libgimp-gimplayer.html" title="gimplayer">
<meta name="generator" content="GTK-Doc V1.4 (XML mode)">
<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">
@ -19,18 +20,25 @@
<link rel="chapter" href="libgimpui-hierarchy.html" title="Object Hierarchy">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="libgimp-gimpguides.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-gimplayer.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2566891" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2610072" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimp-gimpimage"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle">gimpimage</span></h2>
<h2>
<a name="id2566891"></a><span class="refentrytitle">gimpimage</span>
</h2>
<p>gimpimage &#8212; Operations on complete images.</p>
</td>
<td valign="top" align="right"></td>
@ -205,7 +213,7 @@ void <a href="libgimp-gimpimage.html#gimp-image-attach-new-parasite">gimp
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2601469"></a><h2>Description</h2>
<a name="id2610072"></a><h2>Description</h2>
<p>
Operations on complete images: creation, resizing/rescaling,
and operations involving multiple layers.
@ -213,11 +221,11 @@ and operations involving multiple layers.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2601482"></a><h2>Details</h2>
<a name="id2610090"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2601488"></a><h3>
<a name="id2610100"></a><h3>
<a name="gimp-image-list"></a>gimp_image_list ()</h3>
<a class="indexterm" name="id2601498"></a><pre class="programlisting">gint* gimp_image_list (gint *num_images);</pre>
<a class="indexterm" name="id2610113"></a><pre class="programlisting">gint* gimp_image_list (gint *num_images);</pre>
<p>
Returns the list of images currently open.
</p>
@ -247,9 +255,9 @@ GIMP.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2601563"></a><h3>
<a name="id2610178"></a><h3>
<a name="gimp-image-new"></a>gimp_image_new ()</h3>
<a class="indexterm" name="id2601573"></a><pre class="programlisting">gint32 gimp_image_new (gint width,
<a class="indexterm" name="id2610190"></a><pre class="programlisting">gint32 gimp_image_new (gint width,
gint height,
<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageBaseType"
@ -299,9 +307,9 @@ as an argument will fail. Layers can be created using the
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2601686"></a><h3>
<a name="id2610303"></a><h3>
<a name="gimp-image-duplicate"></a>gimp_image_duplicate ()</h3>
<a class="indexterm" name="id2601695"></a><pre class="programlisting">gint32 gimp_image_duplicate (gint32 image_ID);</pre>
<a class="indexterm" name="id2610314"></a><pre class="programlisting">gint32 gimp_image_duplicate (gint32 image_ID);</pre>
<p>
Duplicate the specified image
</p>
@ -331,9 +339,9 @@ channels, and image information.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2601761"></a><h3>
<a name="id2610381"></a><h3>
<a name="gimp-image-delete"></a>gimp_image_delete ()</h3>
<a class="indexterm" name="id2601771"></a><pre class="programlisting">gboolean gimp_image_delete (gint32 image_ID);</pre>
<a class="indexterm" name="id2610393"></a><pre class="programlisting">gboolean gimp_image_delete (gint32 image_ID);</pre>
<p>
Delete the specified image.
</p>
@ -367,9 +375,9 @@ the image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2601841"></a><h3>
<a name="id2610463"></a><h3>
<a name="gimp-image-base-type"></a>gimp_image_base_type ()</h3>
<a class="indexterm" name="id2601850"></a><pre class="programlisting"><a
<a class="indexterm" name="id2610474"></a><pre class="programlisting"><a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageBaseType"
>GimpImageBaseType</a> gimp_image_base_type (gint32 image_ID);</pre>
<p>
@ -401,9 +409,9 @@ must be of this subtype, but can have an optional alpha channel.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2601916"></a><h3>
<a name="id2610540"></a><h3>
<a name="gimp-image-width"></a>gimp_image_width ()</h3>
<a class="indexterm" name="id2601926"></a><pre class="programlisting">gint gimp_image_width (gint32 image_ID);</pre>
<a class="indexterm" name="id2610553"></a><pre class="programlisting">gint gimp_image_width (gint32 image_ID);</pre>
<p>
Return the width of the image
</p>
@ -433,9 +441,9 @@ of any of the layers in this image. This is the \"canvas\" width.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2601993"></a><h3>
<a name="id2610619"></a><h3>
<a name="gimp-image-height"></a>gimp_image_height ()</h3>
<a class="indexterm" name="id2602003"></a><pre class="programlisting">gint gimp_image_height (gint32 image_ID);</pre>
<a class="indexterm" name="id2610631"></a><pre class="programlisting">gint gimp_image_height (gint32 image_ID);</pre>
<p>
Return the height of the image
</p>
@ -465,9 +473,9 @@ of any of the layers in this image. This is the \"canvas\" height.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602069"></a><h3>
<a name="id2610697"></a><h3>
<a name="gimp-image-free-shadow"></a>gimp_image_free_shadow ()</h3>
<a class="indexterm" name="id2602078"></a><pre class="programlisting">gboolean gimp_image_free_shadow (gint32 image_ID);</pre>
<a class="indexterm" name="id2610709"></a><pre class="programlisting">gboolean gimp_image_free_shadow (gint32 image_ID);</pre>
<p>
Free the specified image's shadow data (if it exists).
</p>
@ -498,9 +506,9 @@ to 'gimp_image_delete'.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602145"></a><h3>
<a name="id2610776"></a><h3>
<a name="gimp-image-flip"></a>gimp_image_flip ()</h3>
<a class="indexterm" name="id2602155"></a><pre class="programlisting">gboolean gimp_image_flip (gint32 image_ID,
<a class="indexterm" name="id2610788"></a><pre class="programlisting">gboolean gimp_image_flip (gint32 image_ID,
<a href="libgimp-gimpenums.html#GimpOrientationType">GimpOrientationType</a> flip_type);</pre>
<p>
Flips the image horizontally or vertically.
@ -536,9 +544,9 @@ This procedure flips (mirrors) the image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602242"></a><h3>
<a name="id2610875"></a><h3>
<a name="gimp-image-rotate"></a>gimp_image_rotate ()</h3>
<a class="indexterm" name="id2602252"></a><pre class="programlisting">gboolean gimp_image_rotate (gint32 image_ID,
<a class="indexterm" name="id2610888"></a><pre class="programlisting">gboolean gimp_image_rotate (gint32 image_ID,
<a href="libgimp-gimpenums.html#GimpRotationType">GimpRotationType</a> rotate_type);</pre>
<p>
Rotates the image by the specified degrees.
@ -574,9 +582,9 @@ This procedure rotates the image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2541354"></a><h3>
<a name="id2610974"></a><h3>
<a name="gimp-image-resize"></a>gimp_image_resize ()</h3>
<a class="indexterm" name="id2602330"></a><pre class="programlisting">gboolean gimp_image_resize (gint32 image_ID,
<a class="indexterm" name="id2610986"></a><pre class="programlisting">gboolean gimp_image_resize (gint32 image_ID,
gint new_width,
gint new_height,
gint offx,
@ -640,9 +648,9 @@ according to the specified offsets.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602474"></a><h3>
<a name="id2611116"></a><h3>
<a name="gimp-image-resize-to-layers"></a>gimp_image_resize_to_layers ()</h3>
<a class="indexterm" name="id2602483"></a><pre class="programlisting">gboolean gimp_image_resize_to_layers (gint32 image_ID);</pre>
<a class="indexterm" name="id2611129"></a><pre class="programlisting">gboolean gimp_image_resize_to_layers (gint32 image_ID);</pre>
<p>
Resize the image to fit all layers.
</p>
@ -677,9 +685,9 @@ image are repositioned to the new image area.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602549"></a><h3>
<a name="id2611195"></a><h3>
<a name="gimp-image-scale"></a>gimp_image_scale ()</h3>
<a class="indexterm" name="id2602558"></a><pre class="programlisting">gboolean gimp_image_scale (gint32 image_ID,
<a class="indexterm" name="id2611205"></a><pre class="programlisting">gboolean gimp_image_scale (gint32 image_ID,
gint new_width,
gint new_height);</pre>
<p>
@ -729,9 +737,9 @@ specified offsets.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602661"></a><h3>
<a name="id2611309"></a><h3>
<a name="gimp-image-crop"></a>gimp_image_crop ()</h3>
<a class="indexterm" name="id2602669"></a><pre class="programlisting">gboolean gimp_image_crop (gint32 image_ID,
<a class="indexterm" name="id2611319"></a><pre class="programlisting">gboolean gimp_image_crop (gint32 image_ID,
gint new_width,
gint new_height,
gint offx,
@ -793,9 +801,9 @@ range, an error is returned.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602812"></a><h3>
<a name="id2611462"></a><h3>
<a name="gimp-image-get-layers"></a>gimp_image_get_layers ()</h3>
<a class="indexterm" name="id2602821"></a><pre class="programlisting">gint* gimp_image_get_layers (gint32 image_ID,
<a class="indexterm" name="id2611473"></a><pre class="programlisting">gint* gimp_image_get_layers (gint32 image_ID,
gint *num_layers);</pre>
<p>
Returns the list of layers contained in the specified image.
@ -832,9 +840,9 @@ image. The order of layers is from topmost to bottommost.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602902"></a><h3>
<a name="id2611554"></a><h3>
<a name="gimp-image-get-channels"></a>gimp_image_get_channels ()</h3>
<a class="indexterm" name="id2602910"></a><pre class="programlisting">gint* gimp_image_get_channels (gint32 image_ID,
<a class="indexterm" name="id2611564"></a><pre class="programlisting">gint* gimp_image_get_channels (gint32 image_ID,
gint *num_channels);</pre>
<p>
Returns the list of channels contained in the specified image.
@ -872,9 +880,9 @@ masks. The order is from topmost to bottommost.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602992"></a><h3>
<a name="id2611646"></a><h3>
<a name="gimp-image-get-active-drawable"></a>gimp_image_get_active_drawable ()</h3>
<a class="indexterm" name="id2603002"></a><pre class="programlisting">gint32 gimp_image_get_active_drawable (gint32 image_ID);</pre>
<a class="indexterm" name="id2611658"></a><pre class="programlisting">gint32 gimp_image_get_active_drawable (gint32 image_ID);</pre>
<p>
Get the image's active drawable
</p>
@ -908,9 +916,9 @@ is the active drawable.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603066"></a><h3>
<a name="id2611722"></a><h3>
<a name="gimp-image-unset-active-channel"></a>gimp_image_unset_active_channel ()</h3>
<a class="indexterm" name="id2603076"></a><pre class="programlisting">gboolean gimp_image_unset_active_channel (gint32 image_ID);</pre>
<a class="indexterm" name="id2611734"></a><pre class="programlisting">gboolean gimp_image_unset_active_channel (gint32 image_ID);</pre>
<p>
Unsets the active channel in the specified image.
</p>
@ -942,9 +950,9 @@ existing active channel.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603138"></a><h3>
<a name="id2611796"></a><h3>
<a name="gimp-image-get-floating-sel"></a>gimp_image_get_floating_sel ()</h3>
<a class="indexterm" name="id2603147"></a><pre class="programlisting">gint32 gimp_image_get_floating_sel (gint32 image_ID);</pre>
<a class="indexterm" name="id2611807"></a><pre class="programlisting">gint32 gimp_image_get_floating_sel (gint32 image_ID);</pre>
<p>
Return the floating selection of the image.
</p>
@ -974,9 +982,9 @@ If it doesn't exist, -1 is returned as the layer ID.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603208"></a><h3>
<a name="id2611867"></a><h3>
<a name="gimp-image-floating-sel-attached-to"></a>gimp_image_floating_sel_attached_to ()</h3>
<a class="indexterm" name="id2603219"></a><pre class="programlisting">gint32 gimp_image_floating_sel_attached_to
<a class="indexterm" name="id2611881"></a><pre class="programlisting">gint32 gimp_image_floating_sel_attached_to
(gint32 image_ID);</pre>
<p>
Return the drawable the floating selection is attached to.
@ -1008,9 +1016,9 @@ the drawable ID.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603281"></a><h3>
<a name="id2611943"></a><h3>
<a name="gimp-image-pick-color"></a>gimp_image_pick_color ()</h3>
<a class="indexterm" name="id2603289"></a><pre class="programlisting">gboolean gimp_image_pick_color (gint32 image_ID,
<a class="indexterm" name="id2611953"></a><pre class="programlisting">gboolean gimp_image_pick_color (gint32 image_ID,
gint32 drawable_ID,
gdouble x,
gdouble y,
@ -1101,9 +1109,9 @@ finding the image it belongs to.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603498"></a><h3>
<a name="id2612162"></a><h3>
<a name="gimp-image-pick-correlate-layer"></a>gimp_image_pick_correlate_layer ()</h3>
<a class="indexterm" name="id2603508"></a><pre class="programlisting">gint32 gimp_image_pick_correlate_layer (gint32 image_ID,
<a class="indexterm" name="id2612174"></a><pre class="programlisting">gint32 gimp_image_pick_correlate_layer (gint32 image_ID,
gint x,
gint y);</pre>
<p>
@ -1150,9 +1158,9 @@ layer is found.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603611"></a><h3>
<a name="id2612277"></a><h3>
<a name="gimp-image-add-layer"></a>gimp_image_add_layer ()</h3>
<a class="indexterm" name="id2603620"></a><pre class="programlisting">gboolean gimp_image_add_layer (gint32 image_ID,
<a class="indexterm" name="id2612287"></a><pre class="programlisting">gboolean gimp_image_add_layer (gint32 image_ID,
gint32 layer_ID,
gint position);</pre>
<p>
@ -1199,9 +1207,9 @@ must be compatible with the image base type.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603720"></a><h3>
<a name="id2612388"></a><h3>
<a name="gimp-image-remove-layer"></a>gimp_image_remove_layer ()</h3>
<a class="indexterm" name="id2603728"></a><pre class="programlisting">gboolean gimp_image_remove_layer (gint32 image_ID,
<a class="indexterm" name="id2612398"></a><pre class="programlisting">gboolean gimp_image_remove_layer (gint32 image_ID,
gint32 layer_ID);</pre>
<p>
Remove the specified layer from the image.
@ -1241,9 +1249,9 @@ layer.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603810"></a><h3>
<a name="id2612479"></a><h3>
<a name="gimp-image-raise-layer"></a>gimp_image_raise_layer ()</h3>
<a class="indexterm" name="id2603818"></a><pre class="programlisting">gboolean gimp_image_raise_layer (gint32 image_ID,
<a class="indexterm" name="id2612490"></a><pre class="programlisting">gboolean gimp_image_raise_layer (gint32 image_ID,
gint32 layer_ID);</pre>
<p>
Raise the specified layer in the image's layer stack
@ -1281,9 +1289,9 @@ it, or the layer has no alpha channel.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603898"></a><h3>
<a name="id2612569"></a><h3>
<a name="gimp-image-lower-layer"></a>gimp_image_lower_layer ()</h3>
<a class="indexterm" name="id2603906"></a><pre class="programlisting">gboolean gimp_image_lower_layer (gint32 image_ID,
<a class="indexterm" name="id2612580"></a><pre class="programlisting">gboolean gimp_image_lower_layer (gint32 image_ID,
gint32 layer_ID);</pre>
<p>
Lower the specified layer in the image's layer stack
@ -1321,9 +1329,9 @@ it, or the layer has no alpha channel.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603986"></a><h3>
<a name="id2612659"></a><h3>
<a name="gimp-image-raise-layer-to-top"></a>gimp_image_raise_layer_to_top ()</h3>
<a class="indexterm" name="id2603996"></a><pre class="programlisting">gboolean gimp_image_raise_layer_to_top (gint32 image_ID,
<a class="indexterm" name="id2612672"></a><pre class="programlisting">gboolean gimp_image_raise_layer_to_top (gint32 image_ID,
gint32 layer_ID);</pre>
<p>
Raise the specified layer in the image's layer stack to top of stack
@ -1361,9 +1369,9 @@ it, or the layer has no alpha channel.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604077"></a><h3>
<a name="id2612753"></a><h3>
<a name="gimp-image-lower-layer-to-bottom"></a>gimp_image_lower_layer_to_bottom ()</h3>
<a class="indexterm" name="id2604087"></a><pre class="programlisting">gboolean gimp_image_lower_layer_to_bottom
<a class="indexterm" name="id2612765"></a><pre class="programlisting">gboolean gimp_image_lower_layer_to_bottom
(gint32 image_ID,
gint32 layer_ID);</pre>
<p>
@ -1403,9 +1411,9 @@ it, or the layer has no alpha channel.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604169"></a><h3>
<a name="id2612847"></a><h3>
<a name="gimp-image-add-channel"></a>gimp_image_add_channel ()</h3>
<a class="indexterm" name="id2604178"></a><pre class="programlisting">gboolean gimp_image_add_channel (gint32 image_ID,
<a class="indexterm" name="id2612858"></a><pre class="programlisting">gboolean gimp_image_add_channel (gint32 image_ID,
gint32 channel_ID,
gint position);</pre>
<p>
@ -1450,9 +1458,9 @@ the top of the channel stack.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604276"></a><h3>
<a name="id2612956"></a><h3>
<a name="gimp-image-remove-channel"></a>gimp_image_remove_channel ()</h3>
<a class="indexterm" name="id2604285"></a><pre class="programlisting">gboolean gimp_image_remove_channel (gint32 image_ID,
<a class="indexterm" name="id2612967"></a><pre class="programlisting">gboolean gimp_image_remove_channel (gint32 image_ID,
gint32 channel_ID);</pre>
<p>
Remove the specified channel from the image.
@ -1489,9 +1497,9 @@ channel doesn't exist, an error is returned.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604363"></a><h3>
<a name="id2613045"></a><h3>
<a name="gimp-image-raise-channel"></a>gimp_image_raise_channel ()</h3>
<a class="indexterm" name="id2604372"></a><pre class="programlisting">gboolean gimp_image_raise_channel (gint32 image_ID,
<a class="indexterm" name="id2613056"></a><pre class="programlisting">gboolean gimp_image_raise_channel (gint32 image_ID,
gint32 channel_ID);</pre>
<p>
Raise the specified channel in the image's channel stack
@ -1529,9 +1537,9 @@ above it.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604451"></a><h3>
<a name="id2613135"></a><h3>
<a name="gimp-image-lower-channel"></a>gimp_image_lower_channel ()</h3>
<a class="indexterm" name="id2604459"></a><pre class="programlisting">gboolean gimp_image_lower_channel (gint32 image_ID,
<a class="indexterm" name="id2613145"></a><pre class="programlisting">gboolean gimp_image_lower_channel (gint32 image_ID,
gint32 layer_ID);</pre>
<p>
Lower the specified layer in the image's layer stack
@ -1569,9 +1577,9 @@ it, or the layer has no alpha channel.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604539"></a><h3>
<a name="id2613225"></a><h3>
<a name="gimp-image-flatten"></a>gimp_image_flatten ()</h3>
<a class="indexterm" name="id2604547"></a><pre class="programlisting">gint32 gimp_image_flatten (gint32 image_ID);</pre>
<a class="indexterm" name="id2613235"></a><pre class="programlisting">gint32 gimp_image_flatten (gint32 image_ID);</pre>
<p>
Flatten all visible layers into a single layer. Discard all
invisible layers.
@ -1603,9 +1611,9 @@ discarded, and the resulting image is stripped of its alpha channel.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604609"></a><h3>
<a name="id2613296"></a><h3>
<a name="gimp-image-merge-visible-layers"></a>gimp_image_merge_visible_layers ()</h3>
<a class="indexterm" name="id2604619"></a><pre class="programlisting">gint32 gimp_image_merge_visible_layers (gint32 image_ID,
<a class="indexterm" name="id2613309"></a><pre class="programlisting">gint32 gimp_image_merge_visible_layers (gint32 image_ID,
<a href="libgimp-gimpenums.html#GimpMergeType">GimpMergeType</a> merge_type);</pre>
<p>
Merge the visible image layers into one.
@ -1646,9 +1654,9 @@ final layer to the size of the bottommost layer.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604702"></a><h3>
<a name="id2613392"></a><h3>
<a name="gimp-image-merge-down"></a>gimp_image_merge_down ()</h3>
<a class="indexterm" name="id2604711"></a><pre class="programlisting">gint32 gimp_image_merge_down (gint32 image_ID,
<a class="indexterm" name="id2613406"></a><pre class="programlisting">gint32 gimp_image_merge_down (gint32 image_ID,
gint32 merge_layer_ID,
<a href="libgimp-gimpenums.html#GimpMergeType">GimpMergeType</a> merge_type);</pre>
<p>
@ -1697,9 +1705,9 @@ bottommost layer.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604823"></a><h3>
<a name="id2613521"></a><h3>
<a name="gimp-image-clean-all"></a>gimp_image_clean_all ()</h3>
<a class="indexterm" name="id2604835"></a><pre class="programlisting">gboolean gimp_image_clean_all (gint32 image_ID);</pre>
<a class="indexterm" name="id2613535"></a><pre class="programlisting">gboolean gimp_image_clean_all (gint32 image_ID);</pre>
<p>
Set the image dirty count to 0.
</p>
@ -1732,9 +1740,9 @@ filled, and installed in the image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604905"></a><h3>
<a name="id2613604"></a><h3>
<a name="gimp-image-is-dirty"></a>gimp_image_is_dirty ()</h3>
<a class="indexterm" name="id2604916"></a><pre class="programlisting">gboolean gimp_image_is_dirty (gint32 image_ID);</pre>
<a class="indexterm" name="id2613618"></a><pre class="programlisting">gboolean gimp_image_is_dirty (gint32 image_ID);</pre>
<p>
Checks if the image has unsaved changes.
</p>
@ -1764,9 +1772,9 @@ needs to be saved.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604982"></a><h3>
<a name="id2613684"></a><h3>
<a name="gimp-image-get-active-layer"></a>gimp_image_get_active_layer ()</h3>
<a class="indexterm" name="id2604994"></a><pre class="programlisting">gint32 gimp_image_get_active_layer (gint32 image_ID);</pre>
<a class="indexterm" name="id2613698"></a><pre class="programlisting">gint32 gimp_image_get_active_layer (gint32 image_ID);</pre>
<p>
Returns the specified image's active layer.
</p>
@ -1797,9 +1805,9 @@ mask is active, then this will return the associated layer.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605062"></a><h3>
<a name="id2613766"></a><h3>
<a name="gimp-image-set-active-layer"></a>gimp_image_set_active_layer ()</h3>
<a class="indexterm" name="id2605074"></a><pre class="programlisting">gboolean gimp_image_set_active_layer (gint32 image_ID,
<a class="indexterm" name="id2613781"></a><pre class="programlisting">gboolean gimp_image_set_active_layer (gint32 image_ID,
gint32 active_layer_ID);</pre>
<p>
Sets the specified image's active layer.
@ -1838,9 +1846,9 @@ procedure will return an execution error.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605164"></a><h3>
<a name="id2613871"></a><h3>
<a name="gimp-image-get-active-channel"></a>gimp_image_get_active_channel ()</h3>
<a class="indexterm" name="id2605176"></a><pre class="programlisting">gint32 gimp_image_get_active_channel (gint32 image_ID);</pre>
<a class="indexterm" name="id2613884"></a><pre class="programlisting">gint32 gimp_image_get_active_channel (gint32 image_ID);</pre>
<p>
Returns the specified image's active channel.
</p>
@ -1870,9 +1878,9 @@ otherwise, -1.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605242"></a><h3>
<a name="id2613951"></a><h3>
<a name="gimp-image-set-active-channel"></a>gimp_image_set_active_channel ()</h3>
<a class="indexterm" name="id2605254"></a><pre class="programlisting">gboolean gimp_image_set_active_channel (gint32 image_ID,
<a class="indexterm" name="id2613965"></a><pre class="programlisting">gboolean gimp_image_set_active_channel (gint32 image_ID,
gint32 active_channel_ID);</pre>
<p>
Sets the specified image's active channel.
@ -1911,9 +1919,9 @@ this procedure will return an execution error.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605345"></a><h3>
<a name="id2614056"></a><h3>
<a name="gimp-image-get-selection"></a>gimp_image_get_selection ()</h3>
<a class="indexterm" name="id2605356"></a><pre class="programlisting">gint32 gimp_image_get_selection (gint32 image_ID);</pre>
<a class="indexterm" name="id2614070"></a><pre class="programlisting">gint32 gimp_image_get_selection (gint32 image_ID);</pre>
<p>
Returns the specified image's selection.
</p>
@ -1943,9 +1951,9 @@ represented as a channel internally.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605423"></a><h3>
<a name="id2614136"></a><h3>
<a name="gimp-image-get-component-active"></a>gimp_image_get_component_active ()</h3>
<a class="indexterm" name="id2605435"></a><pre class="programlisting">gboolean gimp_image_get_component_active (gint32 image_ID,
<a class="indexterm" name="id2614150"></a><pre class="programlisting">gboolean gimp_image_get_component_active (gint32 image_ID,
<a href="libgimp-gimpenums.html#GimpChannelType">GimpChannelType</a> component);</pre>
<p>
Returns if the specified image's image component is active.
@ -1984,9 +1992,9 @@ component is not valid for the image type, an error is returned.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605526"></a><h3>
<a name="id2614242"></a><h3>
<a name="gimp-image-set-component-active"></a>gimp_image_set_component_active ()</h3>
<a class="indexterm" name="id2605538"></a><pre class="programlisting">gboolean gimp_image_set_component_active (gint32 image_ID,
<a class="indexterm" name="id2614255"></a><pre class="programlisting">gboolean gimp_image_set_component_active (gint32 image_ID,
<a href="libgimp-gimpenums.html#GimpChannelType">GimpChannelType</a> component,
gboolean active);</pre>
<p>
@ -2032,9 +2040,9 @@ component is not valid for the image type, an error is returned.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605650"></a><h3>
<a name="id2614368"></a><h3>
<a name="gimp-image-get-component-visible"></a>gimp_image_get_component_visible ()</h3>
<a class="indexterm" name="id2605662"></a><pre class="programlisting">gboolean gimp_image_get_component_visible
<a class="indexterm" name="id2614382"></a><pre class="programlisting">gboolean gimp_image_get_component_visible
(gint32 image_ID,
<a href="libgimp-gimpenums.html#GimpChannelType">GimpChannelType</a> component);</pre>
<p>
@ -2075,9 +2083,9 @@ returned.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605754"></a><h3>
<a name="id2614474"></a><h3>
<a name="gimp-image-set-component-visible"></a>gimp_image_set_component_visible ()</h3>
<a class="indexterm" name="id2605766"></a><pre class="programlisting">gboolean gimp_image_set_component_visible
<a class="indexterm" name="id2614488"></a><pre class="programlisting">gboolean gimp_image_set_component_visible
(gint32 image_ID,
<a href="libgimp-gimpenums.html#GimpChannelType">GimpChannelType</a> component,
gboolean visible);</pre>
@ -2124,9 +2132,9 @@ component is not valid for the image type, an error is returned.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605879"></a><h3>
<a name="id2614601"></a><h3>
<a name="gimp-image-get-filename"></a>gimp_image_get_filename ()</h3>
<a class="indexterm" name="id2605891"></a><pre class="programlisting">gchar* gimp_image_get_filename (gint32 image_ID);</pre>
<a class="indexterm" name="id2614615"></a><pre class="programlisting">gchar* gimp_image_get_filename (gint32 image_ID);</pre>
<p>
Returns the specified image's filename.
</p>
@ -2157,9 +2165,9 @@ or has since been saved. Otherwise, this function returns <code class="literal">
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605965"></a><h3>
<a name="id2614693"></a><h3>
<a name="gimp-image-set-filename"></a>gimp_image_set_filename ()</h3>
<a class="indexterm" name="id2605976"></a><pre class="programlisting">gboolean gimp_image_set_filename (gint32 image_ID,
<a class="indexterm" name="id2614706"></a><pre class="programlisting">gboolean gimp_image_set_filename (gint32 image_ID,
const gchar *filename);</pre>
<p>
Sets the specified image's filename.
@ -2196,9 +2204,9 @@ should be in the filesystem encoding.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606064"></a><h3>
<a name="id2614795"></a><h3>
<a name="gimp-image-get-name"></a>gimp_image_get_name ()</h3>
<a class="indexterm" name="id2606076"></a><pre class="programlisting">gchar* gimp_image_get_name (gint32 image_ID);</pre>
<a class="indexterm" name="id2614809"></a><pre class="programlisting">gchar* gimp_image_get_name (gint32 image_ID);</pre>
<p>
Returns the specified image's name.
</p>
@ -2227,9 +2235,9 @@ This procedure returns the specified image's name.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606141"></a><h3>
<a name="id2614874"></a><h3>
<a name="gimp-image-get-resolution"></a>gimp_image_get_resolution ()</h3>
<a class="indexterm" name="id2606153"></a><pre class="programlisting">gboolean gimp_image_get_resolution (gint32 image_ID,
<a class="indexterm" name="id2614888"></a><pre class="programlisting">gboolean gimp_image_get_resolution (gint32 image_ID,
gdouble *xresolution,
gdouble *yresolution);</pre>
<p>
@ -2273,9 +2281,9 @@ inch. This value is independent of any of the layers in this image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606264"></a><h3>
<a name="id2614998"></a><h3>
<a name="gimp-image-set-resolution"></a>gimp_image_set_resolution ()</h3>
<a class="indexterm" name="id2606276"></a><pre class="programlisting">gboolean gimp_image_set_resolution (gint32 image_ID,
<a class="indexterm" name="id2615013"></a><pre class="programlisting">gboolean gimp_image_set_resolution (gint32 image_ID,
gdouble xresolution,
gdouble yresolution);</pre>
<p>
@ -2320,9 +2328,9 @@ No scaling or resizing is performed.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606387"></a><h3>
<a name="id2615124"></a><h3>
<a name="gimp-image-get-unit"></a>gimp_image_get_unit ()</h3>
<a class="indexterm" name="id2606399"></a><pre class="programlisting"><a
<a class="indexterm" name="id2615138"></a><pre class="programlisting"><a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> gimp_image_get_unit (gint32 image_ID);</pre>
<p>
@ -2356,9 +2364,9 @@ description of the unit system.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606466"></a><h3>
<a name="id2615206"></a><h3>
<a name="gimp-image-set-unit"></a>gimp_image_set_unit ()</h3>
<a class="indexterm" name="id2606478"></a><pre class="programlisting">gboolean gimp_image_set_unit (gint32 image_ID,
<a class="indexterm" name="id2615220"></a><pre class="programlisting">gboolean gimp_image_set_unit (gint32 image_ID,
<a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> unit);</pre>
@ -2399,9 +2407,9 @@ the valid range of unit IDs and a description of the unit system.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606568"></a><h3>
<a name="id2615309"></a><h3>
<a name="gimp-image-set-tattoo-state"></a>gimp_image_set_tattoo_state ()</h3>
<a class="indexterm" name="id2606580"></a><pre class="programlisting">gboolean gimp_image_set_tattoo_state (gint32 image_ID,
<a class="indexterm" name="id2615323"></a><pre class="programlisting">gboolean gimp_image_set_tattoo_state (gint32 image_ID,
gint tattoo_state);</pre>
<p>
Set the tattoo state associated with the image.
@ -2448,9 +2456,9 @@ that all is OK.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606678"></a><h3>
<a name="id2615422"></a><h3>
<a name="gimp-image-get-tattoo-state"></a>gimp_image_get_tattoo_state ()</h3>
<a class="indexterm" name="id2606690"></a><pre class="programlisting">gint gimp_image_get_tattoo_state (gint32 image_ID);</pre>
<a class="indexterm" name="id2615436"></a><pre class="programlisting">gint gimp_image_get_tattoo_state (gint32 image_ID);</pre>
<p>
Returns the tattoo state associated with the image.
</p>
@ -2481,9 +2489,9 @@ Using this function at other times will produce unexpected results.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606758"></a><h3>
<a name="id2615504"></a><h3>
<a name="gimp-image-get-layer-by-tattoo"></a>gimp_image_get_layer_by_tattoo ()</h3>
<a class="indexterm" name="id2606770"></a><pre class="programlisting">gint32 gimp_image_get_layer_by_tattoo (gint32 image_ID,
<a class="indexterm" name="id2615518"></a><pre class="programlisting">gint32 gimp_image_get_layer_by_tattoo (gint32 image_ID,
gint tattoo);</pre>
<p>
Find a layer with a given tattoo in an image.
@ -2520,9 +2528,9 @@ specified image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606858"></a><h3>
<a name="id2615606"></a><h3>
<a name="gimp-image-get-channel-by-tattoo"></a>gimp_image_get_channel_by_tattoo ()</h3>
<a class="indexterm" name="id2606870"></a><pre class="programlisting">gint32 gimp_image_get_channel_by_tattoo
<a class="indexterm" name="id2615621"></a><pre class="programlisting">gint32 gimp_image_get_channel_by_tattoo
(gint32 image_ID,
gint tattoo);</pre>
<p>
@ -2560,9 +2568,9 @@ specified image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606959"></a><h3>
<a name="id2615710"></a><h3>
<a name="gimp-image-get-cmap"></a>gimp_image_get_cmap ()</h3>
<a class="indexterm" name="id2606971"></a><pre class="programlisting">guchar* gimp_image_get_cmap (gint32 image_ID,
<a class="indexterm" name="id2615726"></a><pre class="programlisting">guchar* gimp_image_get_cmap (gint32 image_ID,
gint *num_colors);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
@ -2599,9 +2607,9 @@ This procedure is deprecated! Use <a href="libgimp-gimpimage.html#gimp-image-get
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607076"></a><h3>
<a name="id2615831"></a><h3>
<a name="gimp-image-set-cmap"></a>gimp_image_set_cmap ()</h3>
<a class="indexterm" name="id2607088"></a><pre class="programlisting">gboolean gimp_image_set_cmap (gint32 image_ID,
<a class="indexterm" name="id2615847"></a><pre class="programlisting">gboolean gimp_image_set_cmap (gint32 image_ID,
const guchar *cmap,
gint num_colors);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
@ -2645,9 +2653,9 @@ This procedure is deprecated! Use <a href="libgimp-gimpimage.html#gimp-image-set
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607214"></a><h3>
<a name="id2615974"></a><h3>
<a name="gimp-image-get-colormap"></a>gimp_image_get_colormap ()</h3>
<a class="indexterm" name="id2607225"></a><pre class="programlisting">guchar* gimp_image_get_colormap (gint32 image_ID,
<a class="indexterm" name="id2615987"></a><pre class="programlisting">guchar* gimp_image_get_colormap (gint32 image_ID,
gint *num_colors);</pre>
<p>
Returns the image's colormap
@ -2685,9 +2693,9 @@ is not of base type INDEXED, this pointer will be NULL.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607315"></a><h3>
<a name="id2616077"></a><h3>
<a name="gimp-image-set-colormap"></a>gimp_image_set_colormap ()</h3>
<a class="indexterm" name="id2607327"></a><pre class="programlisting">gboolean gimp_image_set_colormap (gint32 image_ID,
<a class="indexterm" name="id2616091"></a><pre class="programlisting">gboolean gimp_image_set_colormap (gint32 image_ID,
const guchar *colormap,
gint num_colors);</pre>
<p>
@ -2733,9 +2741,9 @@ in the \"cmap\" array.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607439"></a><h3>
<a name="id2616203"></a><h3>
<a name="gimp-image-get-thumbnail-data"></a>gimp_image_get_thumbnail_data ()</h3>
<a class="indexterm" name="id2607451"></a><pre class="programlisting">guchar* gimp_image_get_thumbnail_data (gint32 image_ID,
<a class="indexterm" name="id2616217"></a><pre class="programlisting">guchar* gimp_image_get_thumbnail_data (gint32 image_ID,
gint *width,
gint *height,
gint *bpp);</pre>
@ -2782,9 +2790,9 @@ in the \"cmap\" array.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607571"></a><h3>
<a name="id2616337"></a><h3>
<a name="gimp-image-parasite-find"></a>gimp_image_parasite_find ()</h3>
<a class="indexterm" name="id2607582"></a><pre class="programlisting"><a
<a class="indexterm" name="id2616351"></a><pre class="programlisting"><a
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
>GimpParasite</a>* gimp_image_parasite_find (gint32 image_ID,
const gchar *name);</pre>
@ -2823,9 +2831,9 @@ an image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607670"></a><h3>
<a name="id2616439"></a><h3>
<a name="gimp-image-parasite-list"></a>gimp_image_parasite_list ()</h3>
<a class="indexterm" name="id2607682"></a><pre class="programlisting">gboolean gimp_image_parasite_list (gint32 image_ID,
<a class="indexterm" name="id2616453"></a><pre class="programlisting">gboolean gimp_image_parasite_list (gint32 image_ID,
gint *num_parasites,
gchar ***parasites);</pre>
<p>
@ -2868,9 +2876,9 @@ Returns a list of all currently attached parasites.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607791"></a><h3>
<a name="id2616562"></a><h3>
<a name="gimp-image-parasite-attach"></a>gimp_image_parasite_attach ()</h3>
<a class="indexterm" name="id2607803"></a><pre class="programlisting">gboolean gimp_image_parasite_attach (gint32 image_ID,
<a class="indexterm" name="id2616576"></a><pre class="programlisting">gboolean gimp_image_parasite_attach (gint32 image_ID,
<a
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
>GimpParasite</a> *parasite);</pre>
@ -2909,9 +2917,9 @@ values.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607890"></a><h3>
<a name="id2616664"></a><h3>
<a name="gimp-image-parasite-detach"></a>gimp_image_parasite_detach ()</h3>
<a class="indexterm" name="id2607903"></a><pre class="programlisting">gboolean gimp_image_parasite_detach (gint32 image_ID,
<a class="indexterm" name="id2616678"></a><pre class="programlisting">gboolean gimp_image_parasite_detach (gint32 image_ID,
const gchar *name);</pre>
<p>
Removes a parasite from an image.
@ -2948,9 +2956,9 @@ values.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2607990"></a><h3>
<a name="id2616765"></a><h3>
<a name="gimp-image-attach-new-parasite"></a>gimp_image_attach_new_parasite ()</h3>
<a class="indexterm" name="id2608002"></a><pre class="programlisting">void gimp_image_attach_new_parasite (gint32 image_ID,
<a class="indexterm" name="id2616780"></a><pre class="programlisting">void gimp_image_attach_new_parasite (gint32 image_ID,
const gchar *name,
gint flags,
gint size,
@ -3010,9 +3018,5 @@ href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
</div>
</div>
</div>
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
<td align="left"><a accesskey="p" href="libgimp-gimpguides.html"><b>&lt;&lt;&#160;gimpguides</b></a></td>
<td align="right"><a accesskey="n" href="libgimp-gimplayer.html"><b>gimplayer&#160;&gt;&gt;</b></a></td>
</tr></table>
</body>
</html>