1194 lines
77 KiB
HTML
1194 lines
77 KiB
HTML
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>gimpdrawable</title><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"><link rel="start" href="index.html" title="GIMP Library Reference Manual"><link rel="up" href="libgimp-image.html" title="Manupulating Images and all their Properties"><link rel="prev" href="libgimp-gimpdisplay.html" title="gimpdisplay"><link rel="next" href="libgimp-gimpdrawabletransform.html" title="gimpdrawabletransform"><meta name="generator" content="GTK-Doc V1.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="gimpdefinitions.html" title="Part I. GIMP Constants"><link rel="part" href="libgimp.html" title="Part II. GIMP Library"><link rel="chapter" href="libgimp-general.html" title="Functions not Related to Specific Images"><link rel="chapter" href="libgimp-image.html" title="Manupulating Images and all their Properties"><link rel="chapter" href="libgimp-data.html" title="Data Objects"><link rel="chapter" href="libgimp-selectors.html" title="Controlling the Core's Selection Dialogs"><link rel="part" href="libgimpui.html" title="Part III. GIMP User Interface Library"><link rel="chapter" href="libgimpui-hierarchy.html" title="Object Hierarchy"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libgimp-gimpdisplay.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-gimpdrawabletransform.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry" lang="en"><a name="libgimp-gimpdrawable"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><span class="refentrytitle">gimpdrawable</span></h2><p>gimpdrawable — Functions to manipulate drawables.</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
|
||
|
||
|
||
|
||
<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a>;
|
||
<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a>* <a href="libgimp-gimpdrawable.html#gimp-drawable-get">gimp_drawable_get</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
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);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-delete">gimp_drawable_delete</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a>* <a href="libgimp-gimpdrawable.html#gimp-drawable-get-name">gimp_drawable_get_name</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-set-name">gimp_drawable_set_name</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
const <a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *name);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-get-visible">gimp_drawable_get_visible</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-set-visible">gimp_drawable_set_visible</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> visible);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-get-linked">gimp_drawable_get_linked</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-set-linked">gimp_drawable_set_linked</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> linked);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-get-tattoo">gimp_drawable_get_tattoo</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-set-tattoo">gimp_drawable_set_tattoo</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> tattoo);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#guint8"
|
||
>guint8</a>* <a href="libgimp-gimpdrawable.html#gimp-drawable-get-pixel">gimp_drawable_get_pixel</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> x_coord,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> y_coord,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *num_channels);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-set-pixel">gimp_drawable_set_pixel</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> x_coord,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> y_coord,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> num_channels,
|
||
const <a
|
||
href="../glib/glib-Basic-Types.html#guint8"
|
||
>guint8</a> *pixel);
|
||
<a href="libgimp-gimptile.html#GimpTile">GimpTile</a>* <a href="libgimp-gimpdrawable.html#gimp-drawable-get-tile">gimp_drawable_get_tile</a> (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> shadow,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> row,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> col);
|
||
<a href="libgimp-gimptile.html#GimpTile">GimpTile</a>* <a href="libgimp-gimpdrawable.html#gimp-drawable-get-tile2">gimp_drawable_get_tile2</a> (<a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a> *drawable,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> shadow,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> y);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#guchar"
|
||
>guchar</a>* <a href="libgimp-gimpdrawable.html#gimp-drawable-get-thumbnail-data">gimp_drawable_get_thumbnail_data</a>
|
||
(<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *width,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *height,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *bpp);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#guchar"
|
||
>guchar</a>* <a href="libgimp-gimpdrawable.html#gimp-drawable-get-sub-thumbnail-data">gimp_drawable_get_sub_thumbnail_data</a>
|
||
(<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> src_x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> src_y,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> src_width,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> src_height,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *dest_width,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *dest_height,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *bpp);
|
||
void <a href="libgimp-gimpdrawable.html#gimp-drawable-get-color-uchar">gimp_drawable_get_color_uchar</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
const <a
|
||
href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"
|
||
>GimpRGB</a> *color,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#guchar"
|
||
>guchar</a> *color_uchar);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-merge-shadow">gimp_drawable_merge_shadow</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> undo);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-fill">gimp_drawable_fill</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a href="libgimp-gimpenums.html#GimpFillType">GimpFillType</a> fill_type);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-update">gimp_drawable_update</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> y,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> width,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> height);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-mask-bounds">gimp_drawable_mask_bounds</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *x1,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *y1,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *x2,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *y2);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-mask-intersect">gimp_drawable_mask_intersect</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *y,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *width,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *height);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-get-image">gimp_drawable_get_image</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-set-image">gimp_drawable_set_image</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> image_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-has-alpha">gimp_drawable_has_alpha</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
|
||
>GimpImageType</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-type-with-alpha">gimp_drawable_type_with_alpha</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
|
||
>GimpImageType</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-type">gimp_drawable_type</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-is-rgb">gimp_drawable_is_rgb</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-is-gray">gimp_drawable_is_gray</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-is-indexed">gimp_drawable_is_indexed</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-bpp">gimp_drawable_bpp</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-width">gimp_drawable_width</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-height">gimp_drawable_height</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-offsets">gimp_drawable_offsets</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *offset_x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *offset_y);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-is-layer">gimp_drawable_is_layer</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-is-layer-mask">gimp_drawable_is_layer_mask</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-is-channel">gimp_drawable_is_channel</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-offset">gimp_drawable_offset</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> wrap_around,
|
||
<a href="libgimp-gimpenums.html#GimpOffsetType">GimpOffsetType</a> fill_type,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> offset_x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> offset_y);
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
|
||
>GimpParasite</a>* <a href="libgimp-gimpdrawable.html#gimp-drawable-parasite-find">gimp_drawable_parasite_find</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
const <a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *name);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-parasite-list">gimp_drawable_parasite_list</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *num_parasites,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> ***parasites);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-parasite-attach">gimp_drawable_parasite_attach</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
|
||
>GimpParasite</a> *parasite);
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> <a href="libgimp-gimpdrawable.html#gimp-drawable-parasite-detach">gimp_drawable_parasite_detach</a> (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
const <a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *name);
|
||
void <a href="libgimp-gimpdrawable.html#gimp-drawable-attach-new-parasite">gimp_drawable_attach_new_parasite</a>
|
||
(<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
const <a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *name,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> flags,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> size,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gconstpointer"
|
||
>gconstpointer</a> data);
|
||
</pre></div><div class="refsect1" lang="en"><a name="id2602702"></a><h2>Description</h2><p>
|
||
Functions to manipulate drawables.
|
||
|
||
</p></div><div class="refsect1" lang="en"><a name="id2602712"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2602717"></a><h3><a name="GimpDrawable"></a>GimpDrawable</h3><a class="indexterm" name="id2602726"></a><pre class="programlisting">typedef struct {
|
||
gint32 drawable_id; /* drawable ID */
|
||
guint width; /* width of drawble */
|
||
guint height; /* height of drawble */
|
||
guint bpp; /* bytes per pixel of drawable */
|
||
guint ntile_rows; /* # of tile rows */
|
||
guint ntile_cols; /* # of tile columns */
|
||
GimpTile *tiles; /* the normal tiles */
|
||
GimpTile *shadow_tiles; /* the shadow tiles */
|
||
} GimpDrawable;
|
||
</pre><p>
|
||
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2602743"></a><h3><a name="gimp-drawable-get"></a>gimp_drawable_get ()</h3><a class="indexterm" name="id2602751"></a><pre class="programlisting"><a href="libgimp-gimpdrawable.html#GimpDrawable">GimpDrawable</a>* gimp_drawable_get (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> 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 <i class="parameter"><tt>drawable_ID</tt></i>. The returned structure
|
||
contains some basic information about the drawable and can also
|
||
hold tile data for transfer to and from the core.
|
||
</p><p>
|
||
Note that the name of this function is somewhat misleading, because
|
||
it suggests that it simply returns a handle. This is not the case:
|
||
if the function is called multiple times, it creates separate tile
|
||
lists each time, which will usually produce undesired results.
|
||
</p><p>
|
||
When a plug-in has finished working with a drawable, before exiting
|
||
it should call <a href="libgimp-gimpdrawable.html#gimp-drawable-detach"><tt class="function">gimp_drawable_detach()</tt></a> to make sure that all tile data is
|
||
transferred back to the core.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> the ID of the drawable
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a new <a href="libgimp-gimpdrawable.html#GimpDrawable"><span class="type">GimpDrawable</span></a> wrapper
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2602838"></a><h3><a name="gimp-drawable-detach"></a>gimp_drawable_detach ()</h3><a class="indexterm" name="id2602846"></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
|
||
list of the <a href="libgimp-gimpdrawable.html#GimpDrawable"><span class="type">GimpDrawable</span></a> to be transferred to the core, and
|
||
then frees all associated memory. You must not access the
|
||
<i class="parameter"><tt>drawable</tt></i> after having called <a href="libgimp-gimpdrawable.html#gimp-drawable-detach"><tt class="function">gimp_drawable_detach()</tt></a>.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable</tt></i> :</span></td><td> The <a href="libgimp-gimpdrawable.html#GimpDrawable"><span class="type">GimpDrawable</span></a> to detach from the core
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2602909"></a><h3><a name="gimp-drawable-flush"></a>gimp_drawable_flush ()</h3><a class="indexterm" name="id2602917"></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 <i class="parameter"><tt>drawable</tt></i> to be
|
||
transferred to the core. It is usually called in situations where a
|
||
plug-in acts on a drawable, and then needs to read the results of its
|
||
actions. Data transferred back from the core will not generally be valid
|
||
unless <a href="libgimp-gimpdrawable.html#gimp-drawable-flush"><tt class="function">gimp_drawable_flush()</tt></a> has been called beforehand.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable</tt></i> :</span></td><td> The <a href="libgimp-gimpdrawable.html#GimpDrawable"><span class="type">GimpDrawable</span></a> whose tile data is to be transferred
|
||
to the core.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2602977"></a><h3><a name="gimp-drawable-delete"></a>gimp_drawable_delete ()</h3><a class="indexterm" name="id2602986"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_delete (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Delete a drawable.
|
||
</p><p>
|
||
This procedure deletes the specified drawable. This must not be done
|
||
if the gimage containing this drawable was already deleted or if the
|
||
drawable was already removed from the image. The only case in which
|
||
this procedure is useful is if you want to get rid of a drawable
|
||
which has not yet been added to an image.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable to delete.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603042"></a><h3><a name="gimp-drawable-get-name"></a>gimp_drawable_get_name ()</h3><a class="indexterm" name="id2603050"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a>* gimp_drawable_get_name (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Get the name of the specified drawable.
|
||
</p><p>
|
||
This procedure returns the specified drawable's name.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The drawable name.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603102"></a><h3><a name="gimp-drawable-set-name"></a>gimp_drawable_set_name ()</h3><a class="indexterm" name="id2603111"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_set_name (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
const <a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *name);</pre><p>
|
||
Set the name of the specified drawable.
|
||
</p><p>
|
||
This procedure sets the specified drawable's name.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>name</tt></i> :</span></td><td> The new drawable name.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603180"></a><h3><a name="gimp-drawable-get-visible"></a>gimp_drawable_get_visible ()</h3><a class="indexterm" name="id2603189"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_get_visible (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Get the visibility of the specified drawable.
|
||
</p><p>
|
||
This procedure returns the specified drawable's visibility.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The drawable visibility.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603242"></a><h3><a name="gimp-drawable-set-visible"></a>gimp_drawable_set_visible ()</h3><a class="indexterm" name="id2603251"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_set_visible (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> visible);</pre><p>
|
||
Set the visibility of the specified drawable.
|
||
</p><p>
|
||
This procedure sets the specified drawable's visibility.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>visible</tt></i> :</span></td><td> The new drawable visibility.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603321"></a><h3><a name="gimp-drawable-get-linked"></a>gimp_drawable_get_linked ()</h3><a class="indexterm" name="id2603329"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_get_linked (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Get the linked state of the specified drawable.
|
||
</p><p>
|
||
This procedure returns the specified drawable's linked state.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The drawable linked state (for moves).
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603383"></a><h3><a name="gimp-drawable-set-linked"></a>gimp_drawable_set_linked ()</h3><a class="indexterm" name="id2603391"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_set_linked (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> linked);</pre><p>
|
||
Set the linked state of the specified drawable.
|
||
</p><p>
|
||
This procedure sets the specified drawable's linked state.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>linked</tt></i> :</span></td><td> The new drawable linked state.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603461"></a><h3><a name="gimp-drawable-get-tattoo"></a>gimp_drawable_get_tattoo ()</h3><a class="indexterm" name="id2603470"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> gimp_drawable_get_tattoo (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Get the tattoo of the specified drawable.
|
||
</p><p>
|
||
This procedure returns the specified drawable's tattoo. A tattoo is
|
||
a unique and permanent identifier attached to a drawable that can be
|
||
used to uniquely identify a drawable within an image even between
|
||
sessions</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The drawable tattoo.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603525"></a><h3><a name="gimp-drawable-set-tattoo"></a>gimp_drawable_set_tattoo ()</h3><a class="indexterm" name="id2603533"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_set_tattoo (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> tattoo);</pre><p>
|
||
Set the tattoo of the specified drawable.
|
||
</p><p>
|
||
This procedure sets the specified drawable's tattoo. A tattoo is a
|
||
unique and permanent identifier attached to a drawable that can be
|
||
used to uniquely identify a drawable within an image even between
|
||
sessions</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>tattoo</tt></i> :</span></td><td> The new drawable tattoo.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603561"></a><h3><a name="gimp-drawable-get-pixel"></a>gimp_drawable_get_pixel ()</h3><a class="indexterm" name="id2603568"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#guint8"
|
||
>guint8</a>* gimp_drawable_get_pixel (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> x_coord,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> y_coord,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *num_channels);</pre><p>
|
||
Gets the value of the pixel at the specified coordinates.
|
||
</p><p>
|
||
This procedure gets the pixel value at the specified coordinates.
|
||
The 'num_channels' argument must always be equal to the
|
||
bytes-per-pixel value for the specified drawable.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>x_coord</tt></i> :</span></td><td> The x coordinate.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>y_coord</tt></i> :</span></td><td> The y coordinate.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>num_channels</tt></i> :</span></td><td> The number of channels for the pixel.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The pixel value.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603667"></a><h3><a name="gimp-drawable-set-pixel"></a>gimp_drawable_set_pixel ()</h3><a class="indexterm" name="id2603675"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_set_pixel (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> x_coord,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> y_coord,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> num_channels,
|
||
const <a
|
||
href="../glib/glib-Basic-Types.html#guint8"
|
||
>guint8</a> *pixel);</pre><p>
|
||
Sets the value of the pixel at the specified coordinates.
|
||
</p><p>
|
||
This procedure sets the pixel value at the specified coordinates.
|
||
The 'num_channels' argument must always be equal to the
|
||
bytes-per-pixel value for the spec ified drawable. Note that this
|
||
function is not undoable, you should use it only on drawables you
|
||
just created yourself.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>x_coord</tt></i> :</span></td><td> The x coordinate.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>y_coord</tt></i> :</span></td><td> The y coordinate.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>num_channels</tt></i> :</span></td><td> The number of channels for the pixel.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>pixel</tt></i> :</span></td><td> The pixel value.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603792"></a><h3><a name="gimp-drawable-get-tile"></a>gimp_drawable_get_tile ()</h3><a class="indexterm" name="id2603799"></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
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> shadow,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> row,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> col);</pre><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>shadow</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>row</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>col</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>
|
||
|
||
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603887"></a><h3><a name="gimp-drawable-get-tile2"></a>gimp_drawable_get_tile2 ()</h3><a class="indexterm" name="id2603895"></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
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> shadow,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> y);</pre><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>shadow</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>x</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>y</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>
|
||
|
||
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2603989"></a><h3><a name="gimp-drawable-get-thumbnail-data"></a>gimp_drawable_get_thumbnail_data ()</h3><a class="indexterm" name="id2603997"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#guchar"
|
||
>guchar</a>* gimp_drawable_get_thumbnail_data
|
||
(<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *width,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *height,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *bpp);</pre><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>width</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>height</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>bpp</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>
|
||
|
||
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2604093"></a><h3><a name="gimp-drawable-get-sub-thumbnail-data"></a>gimp_drawable_get_sub_thumbnail_data ()</h3><a class="indexterm" name="id2604102"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#guchar"
|
||
>guchar</a>* gimp_drawable_get_sub_thumbnail_data
|
||
(<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> src_x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> src_y,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> src_width,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> src_height,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *dest_width,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *dest_height,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *bpp);</pre><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>src_x</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>src_y</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>src_width</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>src_height</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>dest_width</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>dest_height</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>bpp</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>
|
||
|
||
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2604265"></a><h3><a name="gimp-drawable-get-color-uchar"></a>gimp_drawable_get_color_uchar ()</h3><a class="indexterm" name="id2604274"></a><pre class="programlisting">void gimp_drawable_get_color_uchar (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
const <a
|
||
href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"
|
||
>GimpRGB</a> *color,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#guchar"
|
||
>guchar</a> *color_uchar);</pre><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>color</tt></i> :</span></td><td>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>color_uchar</tt></i> :</span></td><td>
|
||
|
||
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2604341"></a><h3><a name="gimp-drawable-merge-shadow"></a>gimp_drawable_merge_shadow ()</h3><a class="indexterm" name="id2604350"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_merge_shadow (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> undo);</pre><p>
|
||
Merge the shadow buffer with the specified drawable.
|
||
</p><p>
|
||
This procedure combines the contents of the image's shadow buffer
|
||
(for temporary processing) with the specified drawable. The \"undo\"
|
||
parameter specifies whether to add an undo step for the operation.
|
||
Requesting no undo is useful for such applications as 'auto-apply'.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>undo</tt></i> :</span></td><td> Push merge to undo stack?
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2604422"></a><h3><a name="gimp-drawable-fill"></a>gimp_drawable_fill ()</h3><a class="indexterm" name="id2604430"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_fill (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a href="libgimp-gimpenums.html#GimpFillType">GimpFillType</a> fill_type);</pre><p>
|
||
Fill the drawable with the specified fill mode.
|
||
</p><p>
|
||
This procedure fills the drawable with the fill mode. If the fill
|
||
mode is foreground the current foreground color is used. If the fill
|
||
mode is background, the current background color is used. If the
|
||
fill type is white, then white is used. Transparent fill only
|
||
affects layers with an alpha channel, in which case the alpha
|
||
channel is set to transparent. If the drawable has no alpha channel,
|
||
it is filled to white. No fill leaves the drawable's contents
|
||
undefined. This procedure is unlike the bucket fill tool because it
|
||
fills regardless of a selection</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>fill_type</tt></i> :</span></td><td> The type of fill.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2604507"></a><h3><a name="gimp-drawable-update"></a>gimp_drawable_update ()</h3><a class="indexterm" name="id2604516"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_update (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> y,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> width,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> height);</pre><p>
|
||
Update the specified region of the drawable.
|
||
</p><p>
|
||
This procedure updates the specified region of the drawable. The (x,
|
||
y) coordinate pair is relative to the drawable's origin, not to the
|
||
image origin. Therefore, the entire drawable can be updated using
|
||
(0, 0, width, height).</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>x</tt></i> :</span></td><td> x coordinate of upper left corner of update region.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>y</tt></i> :</span></td><td> y coordinate of upper left corner of update region.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>width</tt></i> :</span></td><td> Width of update region.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>height</tt></i> :</span></td><td> Height of update region.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2604640"></a><h3><a name="gimp-drawable-mask-bounds"></a>gimp_drawable_mask_bounds ()</h3><a class="indexterm" name="id2604648"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_mask_bounds (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *x1,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *y1,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *x2,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *y2);</pre><p>
|
||
Find the bounding box of the current selection in relation to the
|
||
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
|
||
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
|
||
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).
|
||
Note that the returned boolean does NOT correspond with the returned
|
||
region being empty or not, it always returns whether the selection
|
||
is non_empty. See <a href="libgimp-gimpdrawable.html#gimp-drawable-mask-intersect"><tt class="function">gimp_drawable_mask_intersect()</tt></a> for a boolean
|
||
return value which is more useful in most cases.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>x1</tt></i> :</span></td><td> x coordinate of the upper left corner of selection bounds.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>y1</tt></i> :</span></td><td> y coordinate of the upper left corner of selection bounds.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>x2</tt></i> :</span></td><td> x coordinate of the lower right corner of selection bounds.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>y2</tt></i> :</span></td><td> y coordinate of the lower right corner of selection bounds.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE if there is a selection.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2604791"></a><h3><a name="gimp-drawable-mask-intersect"></a>gimp_drawable_mask_intersect ()</h3><a class="indexterm" name="id2604799"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_mask_intersect (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *y,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *width,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *height);</pre><p>
|
||
Find the bounding box of the current selection in relation to the
|
||
specified drawable.
|
||
</p><p>
|
||
This procedure returns whether there is an intersection between the
|
||
drawable and the selection. Unlike <a href="libgimp-gimpdrawable.html#gimp-drawable-mask-bounds"><tt class="function">gimp_drawable_mask_bounds()</tt></a>, the
|
||
intersection's bounds are returned as x, y, width, height. If there
|
||
is no selection this function returns TRUE and the returned bounds
|
||
are the extents of the whole drawable.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>x</tt></i> :</span></td><td> x coordinate of the upper left corner of the intersection.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>y</tt></i> :</span></td><td> y coordinate of the upper left corner of the intersection.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>width</tt></i> :</span></td><td> width of the intersection.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>height</tt></i> :</span></td><td> height of the intersection.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE if the returned area is not empty.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2604936"></a><h3><a name="gimp-drawable-get-image"></a>gimp_drawable_get_image ()</h3><a class="indexterm" name="id2604944"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> gimp_drawable_get_image (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns the drawable's image.
|
||
</p><p>
|
||
This procedure returns the drawable's image.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The drawable's image.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2604995"></a><h3><a name="gimp-drawable-set-image"></a>gimp_drawable_set_image ()</h3><a class="indexterm" name="id2605003"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_set_image (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> image_ID);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt class="literal">gimp_drawable_set_image</tt> is deprecated and should not be used in newly-written code.</p></div><p>
|
||
This procedure is deprecated!</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>image_ID</tt></i> :</span></td><td> The image.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605076"></a><h3><a name="gimp-drawable-has-alpha"></a>gimp_drawable_has_alpha ()</h3><a class="indexterm" name="id2605085"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_has_alpha (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns non-zero if the drawable has an alpha channel.
|
||
</p><p>
|
||
This procedure returns whether the specified drawable has an alpha
|
||
channel. This can only be true for layers, and the associated type
|
||
will be one of: { RGBA , GRAYA, INDEXEDA }.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> Does the drawable have an alpha channel?
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605138"></a><h3><a name="gimp-drawable-type-with-alpha"></a>gimp_drawable_type_with_alpha ()</h3><a class="indexterm" name="id2605147"></a><pre class="programlisting"><a
|
||
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
|
||
>GimpImageType</a> gimp_drawable_type_with_alpha (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns the drawable's type with alpha.
|
||
</p><p>
|
||
This procedure returns the drawable's type as if had an alpha
|
||
channel. If the type is currently Gray, for instance, the returned
|
||
type would be GrayA. If the drawable already has an alpha channel,
|
||
the drawable's type is simply returned.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The drawable's type with alpha.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605201"></a><h3><a name="gimp-drawable-type"></a>gimp_drawable_type ()</h3><a class="indexterm" name="id2605209"></a><pre class="programlisting"><a
|
||
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
|
||
>GimpImageType</a> gimp_drawable_type (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns the drawable's type.
|
||
</p><p>
|
||
This procedure returns the drawable's type.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The drawable's type.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605260"></a><h3><a name="gimp-drawable-is-rgb"></a>gimp_drawable_is_rgb ()</h3><a class="indexterm" name="id2605268"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_is_rgb (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns whether the drawable is an RGB type.
|
||
</p><p>
|
||
This procedure returns non-zero if the specified drawable is of type
|
||
{ RGB, RGBA }.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> non-zero if the drawable is an RGB type.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605320"></a><h3><a name="gimp-drawable-is-gray"></a>gimp_drawable_is_gray ()</h3><a class="indexterm" name="id2605329"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_is_gray (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns whether the drawable is a grayscale type.
|
||
</p><p>
|
||
This procedure returns non-zero if the specified drawable is of type
|
||
{ Gray, GrayA }.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> non-zero if the drawable is a grayscale type.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605382"></a><h3><a name="gimp-drawable-is-indexed"></a>gimp_drawable_is_indexed ()</h3><a class="indexterm" name="id2605390"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_is_indexed (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns whether the drawable is an indexed type.
|
||
</p><p>
|
||
This procedure returns non-zero if the specified drawable is of type
|
||
{ Indexed, IndexedA }.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> non-zero if the drawable is an indexed type.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605444"></a><h3><a name="gimp-drawable-bpp"></a>gimp_drawable_bpp ()</h3><a class="indexterm" name="id2605452"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> gimp_drawable_bpp (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns the bytes per pixel.
|
||
</p><p>
|
||
This procedure returns the number of bytes per pixel (or the number
|
||
of channels) for the specified drawable.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> Bytes per pixel.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605504"></a><h3><a name="gimp-drawable-width"></a>gimp_drawable_width ()</h3><a class="indexterm" name="id2605512"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> gimp_drawable_width (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns the width of the drawable.
|
||
</p><p>
|
||
This procedure returns the specified drawable's width in pixels.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> Width of drawable.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605563"></a><h3><a name="gimp-drawable-height"></a>gimp_drawable_height ()</h3><a class="indexterm" name="id2605572"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> gimp_drawable_height (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns the height of the drawable.
|
||
</p><p>
|
||
This procedure returns the specified drawable's height in pixels.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> Height of drawable.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605623"></a><h3><a name="gimp-drawable-offsets"></a>gimp_drawable_offsets ()</h3><a class="indexterm" name="id2605631"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_offsets (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *offset_x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *offset_y);</pre><p>
|
||
Returns the offsets for the drawable.
|
||
</p><p>
|
||
This procedure returns the specified drawable's offsets. This only
|
||
makes sense if the drawable is a layer since channels are anchored.
|
||
The offsets of a channel will be returned as 0.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>offset_x</tt></i> :</span></td><td> x offset of drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>offset_y</tt></i> :</span></td><td> y offset of drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605718"></a><h3><a name="gimp-drawable-is-layer"></a>gimp_drawable_is_layer ()</h3><a class="indexterm" name="id2605726"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_is_layer (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns whether the drawable is a layer.
|
||
</p><p>
|
||
This procedure returns non-zero if the specified drawable is a
|
||
layer.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> Non-zero if the drawable is a layer.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605777"></a><h3><a name="gimp-drawable-is-layer-mask"></a>gimp_drawable_is_layer_mask ()</h3><a class="indexterm" name="id2605786"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_is_layer_mask (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns whether the drawable is a layer mask.
|
||
</p><p>
|
||
This procedure returns non-zero if the specified drawable is a layer
|
||
mask.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> Non-zero if the drawable is a layer mask.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605839"></a><h3><a name="gimp-drawable-is-channel"></a>gimp_drawable_is_channel ()</h3><a class="indexterm" name="id2605848"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_is_channel (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID);</pre><p>
|
||
Returns whether the drawable is a channel.
|
||
</p><p>
|
||
This procedure returns non-zero if the specified drawable is a
|
||
channel.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> Non-zero if the drawable is a channel.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2605901"></a><h3><a name="gimp-drawable-offset"></a>gimp_drawable_offset ()</h3><a class="indexterm" name="id2605910"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_offset (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> wrap_around,
|
||
<a href="libgimp-gimpenums.html#GimpOffsetType">GimpOffsetType</a> fill_type,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> offset_x,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> offset_y);</pre><p>
|
||
Offset the drawable by the specified amounts in the X and Y
|
||
directions
|
||
</p><p>
|
||
This procedure offsets the specified drawable by the amounts
|
||
specified by 'offset_x' and 'offset_y'. If 'wrap_around' is set to
|
||
TRUE, then portions of the drawable which are offset out of bounds
|
||
are wrapped around. Alternatively, the undefined regions of the
|
||
drawable can be filled with transparency or the background color, as
|
||
specified by the 'fill_type' parameter.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable to offset.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>wrap_around</tt></i> :</span></td><td> wrap image around or fill vacated regions.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>fill_type</tt></i> :</span></td><td> fill vacated regions of drawable with background or transparent.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>offset_x</tt></i> :</span></td><td> offset by this amount in X direction.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>offset_y</tt></i> :</span></td><td> offset by this amount in Y direction.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2606039"></a><h3><a name="gimp-drawable-parasite-find"></a>gimp_drawable_parasite_find ()</h3><a class="indexterm" name="id2606048"></a><pre class="programlisting"><a
|
||
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
|
||
>GimpParasite</a>* gimp_drawable_parasite_find (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
const <a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *name);</pre><p>
|
||
Finds the named parasite in a drawable
|
||
</p><p>
|
||
Finds and returns the named parasite that was previously attached to
|
||
a drawable.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>name</tt></i> :</span></td><td> The name of the parasite to find.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The found parasite.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2606119"></a><h3><a name="gimp-drawable-parasite-list"></a>gimp_drawable_parasite_list ()</h3><a class="indexterm" name="id2606128"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_parasite_list (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> *num_parasites,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> ***parasites);</pre><p>
|
||
List all parasites.
|
||
</p><p>
|
||
Returns a list of all currently attached parasites.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>num_parasites</tt></i> :</span></td><td> The number of attached parasites.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>parasites</tt></i> :</span></td><td> The names of currently attached parasites.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2606215"></a><h3><a name="gimp-drawable-parasite-attach"></a>gimp_drawable_parasite_attach ()</h3><a class="indexterm" name="id2606226"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_parasite_attach (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
|
||
>GimpParasite</a> *parasite);</pre><p>
|
||
Add a parasite to a drawable.
|
||
</p><p>
|
||
This procedure attaches a parasite to a drawable. It has no return
|
||
values.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>parasite</tt></i> :</span></td><td> The parasite to attach to a drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2606297"></a><h3><a name="gimp-drawable-parasite-detach"></a>gimp_drawable_parasite_detach ()</h3><a class="indexterm" name="id2606308"></a><pre class="programlisting"><a
|
||
href="../glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> gimp_drawable_parasite_detach (<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
const <a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *name);</pre><p>
|
||
Removes a parasite from a drawable.
|
||
</p><p>
|
||
This procedure detaches a parasite from a drawable. It has no return
|
||
values.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> The drawable.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>name</tt></i> :</span></td><td> The name of the parasite to detach from a drawable.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE on success.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2606380"></a><h3><a name="gimp-drawable-attach-new-parasite"></a>gimp_drawable_attach_new_parasite ()</h3><a class="indexterm" name="id2606392"></a><pre class="programlisting">void gimp_drawable_attach_new_parasite
|
||
(<a
|
||
href="../glib/glib-Basic-Types.html#gint32"
|
||
>gint32</a> drawable_ID,
|
||
const <a
|
||
href="../glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *name,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> flags,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gint"
|
||
>gint</a> size,
|
||
<a
|
||
href="../glib/glib-Basic-Types.html#gconstpointer"
|
||
>gconstpointer</a> data);</pre><p>
|
||
Convenience function that creates a parasite and attaches it
|
||
to the GIMP.
|
||
</p><p>
|
||
See Also: <a href="libgimp-gimpdrawable.html#gimp-drawable-parasite-attach"><tt class="function">gimp_drawable_parasite_attach()</tt></a></p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>drawable_ID</tt></i> :</span></td><td> the ID of the <a href="libgimp-gimpdrawable.html#GimpDrawable"><span class="type">GimpDrawable</span></a> to attach the <a
|
||
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
|
||
><span class="type">GimpParasite</span></a> to.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>name</tt></i> :</span></td><td> the name of the <a
|
||
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
|
||
><span class="type">GimpParasite</span></a> to create and attach.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>flags</tt></i> :</span></td><td> the flags set on the <a
|
||
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
|
||
><span class="type">GimpParasite</span></a>.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>size</tt></i> :</span></td><td> the size of the parasite data in bytes.
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>data</tt></i> :</span></td><td> a pointer to the data attached with the <a
|
||
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
|
||
><span class="type">GimpParasite</span></a>.
|
||
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libgimp-gimpdisplay.html"><b><< gimpdisplay</b></a></td><td align="right"><a accesskey="n" href="libgimp-gimpdrawabletransform.html"><b>gimpdrawabletransform >></b></a></td></tr></table></body></html>
|