~ubuntu-branches/ubuntu/saucy/gimp/saucy

« back to all changes in this revision

Viewing changes to devel-docs/libgimp/html/libgimp-gimplayer.html

  • Committer: Package Import Robot
  • Author(s): Micah Gersten
  • Date: 2012-05-20 19:21:01 UTC
  • mfrom: (1.1.26) (0.4.16 sid)
  • Revision ID: package-import@ubuntu.com-20120520192101-bs7zetx8ffoq2nfv
Tags: 2.8.0-2ubuntu1
* Merge from Debian unstable (LP: #908472). Remaining Changes:
  - debian/patches/02_help-message.patch,
    debian/patches/03_gimp.desktop.in.in.patch:
    + Update some strings for Ubuntu
  - debian/control:
    + Update description
  - debian/rules:
    + Set gettext domain and update translation templates
* Drop the following patches that were applied upstream:
  - debian/patches/ghost-cursor.patch: fix Wacom tablet cursor events
  - debian/patches/embed-page-setup-dialog.patch

Show diffs side-by-side

added added

removed removed

Lines of Context:
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
7
<link rel="home" href="index.html" title="GIMP Library Reference Manual">
8
8
<link rel="up" href="libgimp-image.html" title="Manupulating Images and their Properties">
9
 
<link rel="prev" href="libgimp-gimpimage.html" title="gimpimage">
 
9
<link rel="prev" href="libgimp-gimpitemtransform.html" title="gimpitemtransform">
10
10
<link rel="next" href="libgimp-gimppaths.html" title="gimppaths">
11
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
16
<tr valign="middle">
17
 
<td><a accesskey="p" href="libgimp-gimpimage.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
17
<td><a accesskey="p" href="libgimp-gimpitemtransform.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
18
<td><a accesskey="u" href="libgimp-image.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
20
<th width="100%" align="center">GIMP Library Reference Manual</th>
37
37
</tr></table></div>
38
38
<div class="refsynopsisdiv">
39
39
<a name="libgimp-gimplayer.synopsis"></a><h2>Synopsis</h2>
40
 
<pre class="synopsis"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-new" title="gimp_layer_new ()">gimp_layer_new</a>                      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> image_ID</code></em>,
41
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
42
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
43
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
44
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"><span class="type">GimpImageType</span></a> type</code></em>,
45
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> opacity</code></em>,
 
40
<pre class="synopsis"><span class="returnvalue">gint32</span>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-new" title="gimp_layer_new ()">gimp_layer_new</a>                      (<em class="parameter"><code><span class="type">gint32</span> image_ID</code></em>,
 
41
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
 
42
                                                         <em class="parameter"><code><span class="type">gint</span> width</code></em>,
 
43
                                                         <em class="parameter"><code><span class="type">gint</span> height</code></em>,
 
44
                                                         <em class="parameter"><code><a href="/local/head/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"><span class="type">GimpImageType</span></a> type</code></em>,
 
45
                                                         <em class="parameter"><code><span class="type">gdouble</span> opacity</code></em>,
46
46
                                                         <em class="parameter"><code><a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects" title="enum GimpLayerModeEffects"><span class="type">GimpLayerModeEffects</span></a> mode</code></em>);
47
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-new-from-drawable" title="gimp_layer_new_from_drawable ()">gimp_layer_new_from_drawable</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> drawable_ID</code></em>,
48
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> dest_image_ID</code></em>);
49
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-new-from-visible" title="gimp_layer_new_from_visible ()">gimp_layer_new_from_visible</a>         (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> image_ID</code></em>,
50
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> dest_image_ID</code></em>,
51
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
52
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-copy" title="gimp_layer_copy ()">gimp_layer_copy</a>                     (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
53
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-scale" title="gimp_layer_scale ()">gimp_layer_scale</a>                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
54
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_width</code></em>,
55
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_height</code></em>,
56
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_origin</code></em>);
57
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-scale-full" title="gimp_layer_scale_full ()">gimp_layer_scale_full</a>               (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
58
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_width</code></em>,
59
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_height</code></em>,
60
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_origin</code></em>,
61
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpInterpolationType"><span class="type">GimpInterpolationType</span></a> interpolation</code></em>);
62
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-resize" title="gimp_layer_resize ()">gimp_layer_resize</a>                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
63
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_width</code></em>,
64
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_height</code></em>,
65
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offx</code></em>,
66
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offy</code></em>);
67
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-resize-to-image-size" title="gimp_layer_resize_to_image_size ()">gimp_layer_resize_to_image_size</a>     (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
68
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-translate" title="gimp_layer_translate ()">gimp_layer_translate</a>                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
69
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offx</code></em>,
70
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offy</code></em>);
71
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-add-alpha" title="gimp_layer_add_alpha ()">gimp_layer_add_alpha</a>                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
72
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-flatten" title="gimp_layer_flatten ()">gimp_layer_flatten</a>                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
73
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-offsets" title="gimp_layer_set_offsets ()">gimp_layer_set_offsets</a>              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
74
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offx</code></em>,
75
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offy</code></em>);
76
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-create-mask" title="gimp_layer_create_mask ()">gimp_layer_create_mask</a>              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
77
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpAddMaskType"><span class="type">GimpAddMaskType</span></a> mask_type</code></em>);
78
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-from-mask" title="gimp_layer_from_mask ()">gimp_layer_from_mask</a>                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> mask_ID</code></em>);
79
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-mask" title="gimp_layer_get_mask ()">gimp_layer_get_mask</a>                 (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
80
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-add-mask" title="gimp_layer_add_mask ()">gimp_layer_add_mask</a>                 (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
81
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> mask_ID</code></em>);
82
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-remove-mask" title="gimp_layer_remove_mask ()">gimp_layer_remove_mask</a>              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
 
47
<span class="returnvalue">gint32</span>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-new-from-drawable" title="gimp_layer_new_from_drawable ()">gimp_layer_new_from_drawable</a>        (<em class="parameter"><code><span class="type">gint32</span> drawable_ID</code></em>,
 
48
                                                         <em class="parameter"><code><span class="type">gint32</span> dest_image_ID</code></em>);
 
49
<span class="returnvalue">gint32</span>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-new-from-visible" title="gimp_layer_new_from_visible ()">gimp_layer_new_from_visible</a>         (<em class="parameter"><code><span class="type">gint32</span> image_ID</code></em>,
 
50
                                                         <em class="parameter"><code><span class="type">gint32</span> dest_image_ID</code></em>,
 
51
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
 
52
<span class="returnvalue">gint32</span>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-new-from-pixbuf" title="gimp_layer_new_from_pixbuf ()">gimp_layer_new_from_pixbuf</a>          (<em class="parameter"><code><span class="type">gint32</span> image_ID</code></em>,
 
53
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
 
54
                                                         <em class="parameter"><code><span class="type">GdkPixbuf</span> *pixbuf</code></em>,
 
55
                                                         <em class="parameter"><code><span class="type">gdouble</span> opacity</code></em>,
 
56
                                                         <em class="parameter"><code><a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects" title="enum GimpLayerModeEffects"><span class="type">GimpLayerModeEffects</span></a> mode</code></em>,
 
57
                                                         <em class="parameter"><code><span class="type">gdouble</span> progress_start</code></em>,
 
58
                                                         <em class="parameter"><code><span class="type">gdouble</span> progress_end</code></em>);
 
59
<span class="returnvalue">gint32</span>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-new-from-surface" title="gimp_layer_new_from_surface ()">gimp_layer_new_from_surface</a>         (<em class="parameter"><code><span class="type">gint32</span> image_ID</code></em>,
 
60
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
 
61
                                                         <em class="parameter"><code><span class="type">cairo_surface_t</span> *surface</code></em>,
 
62
                                                         <em class="parameter"><code><span class="type">gdouble</span> progress_start</code></em>,
 
63
                                                         <em class="parameter"><code><span class="type">gdouble</span> progress_end</code></em>);
 
64
<span class="returnvalue">gint32</span>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-group-new" title="gimp_layer_group_new ()">gimp_layer_group_new</a>                (<em class="parameter"><code><span class="type">gint32</span> image_ID</code></em>);
 
65
<span class="returnvalue">gint32</span>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-copy" title="gimp_layer_copy ()">gimp_layer_copy</a>                     (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
66
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-scale" title="gimp_layer_scale ()">gimp_layer_scale</a>                    (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
67
                                                         <em class="parameter"><code><span class="type">gint</span> new_width</code></em>,
 
68
                                                         <em class="parameter"><code><span class="type">gint</span> new_height</code></em>,
 
69
                                                         <em class="parameter"><code><span class="type">gboolean</span> local_origin</code></em>);
 
70
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-scale-full" title="gimp_layer_scale_full ()">gimp_layer_scale_full</a>               (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
71
                                                         <em class="parameter"><code><span class="type">gint</span> new_width</code></em>,
 
72
                                                         <em class="parameter"><code><span class="type">gint</span> new_height</code></em>,
 
73
                                                         <em class="parameter"><code><span class="type">gboolean</span> local_origin</code></em>,
 
74
                                                         <em class="parameter"><code><a href="/local/head/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpInterpolationType"><span class="type">GimpInterpolationType</span></a> interpolation</code></em>);
 
75
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-resize" title="gimp_layer_resize ()">gimp_layer_resize</a>                   (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
76
                                                         <em class="parameter"><code><span class="type">gint</span> new_width</code></em>,
 
77
                                                         <em class="parameter"><code><span class="type">gint</span> new_height</code></em>,
 
78
                                                         <em class="parameter"><code><span class="type">gint</span> offx</code></em>,
 
79
                                                         <em class="parameter"><code><span class="type">gint</span> offy</code></em>);
 
80
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-resize-to-image-size" title="gimp_layer_resize_to_image_size ()">gimp_layer_resize_to_image_size</a>     (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
81
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-translate" title="gimp_layer_translate ()">gimp_layer_translate</a>                (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
82
                                                         <em class="parameter"><code><span class="type">gint</span> offx</code></em>,
 
83
                                                         <em class="parameter"><code><span class="type">gint</span> offy</code></em>);
 
84
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-add-alpha" title="gimp_layer_add_alpha ()">gimp_layer_add_alpha</a>                (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
85
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-flatten" title="gimp_layer_flatten ()">gimp_layer_flatten</a>                  (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
86
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-offsets" title="gimp_layer_set_offsets ()">gimp_layer_set_offsets</a>              (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
87
                                                         <em class="parameter"><code><span class="type">gint</span> offx</code></em>,
 
88
                                                         <em class="parameter"><code><span class="type">gint</span> offy</code></em>);
 
89
<span class="returnvalue">gint32</span>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-create-mask" title="gimp_layer_create_mask ()">gimp_layer_create_mask</a>              (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
90
                                                         <em class="parameter"><code><a href="/local/head/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpAddMaskType"><span class="type">GimpAddMaskType</span></a> mask_type</code></em>);
 
91
<span class="returnvalue">gint32</span>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-from-mask" title="gimp_layer_from_mask ()">gimp_layer_from_mask</a>                (<em class="parameter"><code><span class="type">gint32</span> mask_ID</code></em>);
 
92
<span class="returnvalue">gint32</span>              <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-mask" title="gimp_layer_get_mask ()">gimp_layer_get_mask</a>                 (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
93
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-add-mask" title="gimp_layer_add_mask ()">gimp_layer_add_mask</a>                 (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
94
                                                         <em class="parameter"><code><span class="type">gint32</span> mask_ID</code></em>);
 
95
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-remove-mask" title="gimp_layer_remove_mask ()">gimp_layer_remove_mask</a>              (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
83
96
                                                         <em class="parameter"><code><a class="link" href="libgimp-gimpenums.html#GimpMaskApplyMode" title="enum GimpMaskApplyMode"><span class="type">GimpMaskApplyMode</span></a> mode</code></em>);
84
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-lock-alpha" title="gimp_layer_get_lock_alpha ()">gimp_layer_get_lock_alpha</a>           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
85
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-lock-alpha" title="gimp_layer_set_lock_alpha ()">gimp_layer_set_lock_alpha</a>           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
86
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> lock_alpha</code></em>);
87
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-preserve-trans" title="gimp_layer_get_preserve_trans ()">gimp_layer_get_preserve_trans</a>       (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
88
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-preserve-trans" title="gimp_layer_set_preserve_trans ()">gimp_layer_set_preserve_trans</a>       (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
89
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_trans</code></em>);
90
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-apply-mask" title="gimp_layer_get_apply_mask ()">gimp_layer_get_apply_mask</a>           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
91
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-apply-mask" title="gimp_layer_set_apply_mask ()">gimp_layer_set_apply_mask</a>           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
92
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> apply_mask</code></em>);
93
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-show-mask" title="gimp_layer_get_show_mask ()">gimp_layer_get_show_mask</a>            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
94
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-show-mask" title="gimp_layer_set_show_mask ()">gimp_layer_set_show_mask</a>            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
95
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_mask</code></em>);
96
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-edit-mask" title="gimp_layer_get_edit_mask ()">gimp_layer_get_edit_mask</a>            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
97
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-edit-mask" title="gimp_layer_set_edit_mask ()">gimp_layer_set_edit_mask</a>            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
98
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> edit_mask</code></em>);
99
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-opacity" title="gimp_layer_get_opacity ()">gimp_layer_get_opacity</a>              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
100
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-opacity" title="gimp_layer_set_opacity ()">gimp_layer_set_opacity</a>              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
101
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> opacity</code></em>);
102
 
<a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects" title="enum GimpLayerModeEffects"><span class="returnvalue">GimpLayerModeEffects</span></a> <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-mode" title="gimp_layer_get_mode ()">gimp_layer_get_mode</a>                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
103
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-mode" title="gimp_layer_set_mode ()">gimp_layer_set_mode</a>                 (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
 
97
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-lock-alpha" title="gimp_layer_get_lock_alpha ()">gimp_layer_get_lock_alpha</a>           (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
98
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-lock-alpha" title="gimp_layer_set_lock_alpha ()">gimp_layer_set_lock_alpha</a>           (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
99
                                                         <em class="parameter"><code><span class="type">gboolean</span> lock_alpha</code></em>);
 
100
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-preserve-trans" title="gimp_layer_get_preserve_trans ()">gimp_layer_get_preserve_trans</a>       (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
101
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-preserve-trans" title="gimp_layer_set_preserve_trans ()">gimp_layer_set_preserve_trans</a>       (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
102
                                                         <em class="parameter"><code><span class="type">gboolean</span> preserve_trans</code></em>);
 
103
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-apply-mask" title="gimp_layer_get_apply_mask ()">gimp_layer_get_apply_mask</a>           (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
104
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-apply-mask" title="gimp_layer_set_apply_mask ()">gimp_layer_set_apply_mask</a>           (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
105
                                                         <em class="parameter"><code><span class="type">gboolean</span> apply_mask</code></em>);
 
106
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-show-mask" title="gimp_layer_get_show_mask ()">gimp_layer_get_show_mask</a>            (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
107
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-show-mask" title="gimp_layer_set_show_mask ()">gimp_layer_set_show_mask</a>            (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
108
                                                         <em class="parameter"><code><span class="type">gboolean</span> show_mask</code></em>);
 
109
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-edit-mask" title="gimp_layer_get_edit_mask ()">gimp_layer_get_edit_mask</a>            (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
110
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-edit-mask" title="gimp_layer_set_edit_mask ()">gimp_layer_set_edit_mask</a>            (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
111
                                                         <em class="parameter"><code><span class="type">gboolean</span> edit_mask</code></em>);
 
112
<span class="returnvalue">gdouble</span>             <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-opacity" title="gimp_layer_get_opacity ()">gimp_layer_get_opacity</a>              (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
113
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-opacity" title="gimp_layer_set_opacity ()">gimp_layer_set_opacity</a>              (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
114
                                                         <em class="parameter"><code><span class="type">gdouble</span> opacity</code></em>);
 
115
<a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects" title="enum GimpLayerModeEffects"><span class="returnvalue">GimpLayerModeEffects</span></a> <a class="link" href="libgimp-gimplayer.html#gimp-layer-get-mode" title="gimp_layer_get_mode ()">gimp_layer_get_mode</a>                (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
 
116
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-set-mode" title="gimp_layer_set_mode ()">gimp_layer_set_mode</a>                 (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
104
117
                                                         <em class="parameter"><code><a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects" title="enum GimpLayerModeEffects"><span class="type">GimpLayerModeEffects</span></a> mode</code></em>);
105
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-is-floating-sel" title="gimp_layer_is_floating_sel ()">gimp_layer_is_floating_sel</a>          (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);
 
118
<span class="returnvalue">gboolean</span>            <a class="link" href="libgimp-gimplayer.html#gimp-layer-is-floating-sel" title="gimp_layer_is_floating_sel ()">gimp_layer_is_floating_sel</a>          (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);
106
119
</pre>
107
120
</div>
108
121
<div class="refsect1">
115
128
<a name="libgimp-gimplayer.details"></a><h2>Details</h2>
116
129
<div class="refsect2">
117
130
<a name="gimp-layer-new"></a><h3>gimp_layer_new ()</h3>
118
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              gimp_layer_new                      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> image_ID</code></em>,
119
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
120
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
121
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
122
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"><span class="type">GimpImageType</span></a> type</code></em>,
123
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> opacity</code></em>,
 
131
<pre class="programlisting"><span class="returnvalue">gint32</span>              gimp_layer_new                      (<em class="parameter"><code><span class="type">gint32</span> image_ID</code></em>,
 
132
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
 
133
                                                         <em class="parameter"><code><span class="type">gint</span> width</code></em>,
 
134
                                                         <em class="parameter"><code><span class="type">gint</span> height</code></em>,
 
135
                                                         <em class="parameter"><code><a href="/local/head/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"><span class="type">GimpImageType</span></a> type</code></em>,
 
136
                                                         <em class="parameter"><code><span class="type">gdouble</span> opacity</code></em>,
124
137
                                                         <em class="parameter"><code><a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects" title="enum GimpLayerModeEffects"><span class="type">GimpLayerModeEffects</span></a> mode</code></em>);</pre>
125
138
<p>
126
139
Create a new layer.
129
142
This procedure creates a new layer with the specified width, height,
130
143
and type. Name, opacity, and mode are also supplied parameters. The
131
144
new layer still needs to be added to the image, as this is not
132
 
automatic. Add the new layer with the 'gimp_image_add_layer'
 
145
automatic. Add the new layer with the <a class="link" href="libgimp-gimpimage.html#gimp-image-insert-layer" title="gimp_image_insert_layer ()"><code class="function">gimp_image_insert_layer()</code></a>
133
146
command. Other attributes such as layer mask modes, and offsets
134
147
should be set with explicit procedure calls.
135
148
</p>
174
187
<hr>
175
188
<div class="refsect2">
176
189
<a name="gimp-layer-new-from-drawable"></a><h3>gimp_layer_new_from_drawable ()</h3>
177
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              gimp_layer_new_from_drawable        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> drawable_ID</code></em>,
178
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> dest_image_ID</code></em>);</pre>
 
190
<pre class="programlisting"><span class="returnvalue">gint32</span>              gimp_layer_new_from_drawable        (<em class="parameter"><code><span class="type">gint32</span> drawable_ID</code></em>,
 
191
                                                         <em class="parameter"><code><span class="type">gint32</span> dest_image_ID</code></em>);</pre>
179
192
<p>
180
193
Create a new layer by copying an existing drawable.
181
194
</p>
183
196
This procedure creates a new layer as a copy of the specified
184
197
drawable. The new layer still needs to be added to the image, as
185
198
this is not automatic. Add the new layer with the
186
 
<a class="link" href="libgimp-gimpimage.html#gimp-image-add-layer" title="gimp_image_add_layer ()"><code class="function">gimp_image_add_layer()</code></a> command. Other attributes such as layer mask
187
 
modes, and offsets should be set with explicit procedure calls.
 
199
<a class="link" href="libgimp-gimpimage.html#gimp-image-insert-layer" title="gimp_image_insert_layer ()"><code class="function">gimp_image_insert_layer()</code></a> command. Other attributes such as layer
 
200
mask modes, and offsets should be set with explicit procedure calls.
188
201
</p>
189
202
<div class="variablelist"><table border="0">
190
203
<col align="left" valign="top">
207
220
<hr>
208
221
<div class="refsect2">
209
222
<a name="gimp-layer-new-from-visible"></a><h3>gimp_layer_new_from_visible ()</h3>
210
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              gimp_layer_new_from_visible         (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> image_ID</code></em>,
211
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> dest_image_ID</code></em>,
212
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 
223
<pre class="programlisting"><span class="returnvalue">gint32</span>              gimp_layer_new_from_visible         (<em class="parameter"><code><span class="type">gint32</span> image_ID</code></em>,
 
224
                                                         <em class="parameter"><code><span class="type">gint32</span> dest_image_ID</code></em>,
 
225
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
213
226
<p>
214
227
Create a new layer from what is visible in an image.
215
228
</p>
217
230
This procedure creates a new layer from what is visible in the given
218
231
image. The new layer still needs to be added to the destination
219
232
image, as this is not automatic. Add the new layer with the
220
 
<a class="link" href="libgimp-gimpimage.html#gimp-image-add-layer" title="gimp_image_add_layer ()"><code class="function">gimp_image_add_layer()</code></a> command. Other attributes such as layer mask
221
 
modes, and offsets should be set with explicit procedure calls.
 
233
<a class="link" href="libgimp-gimpimage.html#gimp-image-insert-layer" title="gimp_image_insert_layer ()"><code class="function">gimp_image_insert_layer()</code></a> command. Other attributes such as layer
 
234
mask modes, and offsets should be set with explicit procedure calls.
222
235
</p>
223
236
<div class="variablelist"><table border="0">
224
237
<col align="left" valign="top">
245
258
</div>
246
259
<hr>
247
260
<div class="refsect2">
 
261
<a name="gimp-layer-new-from-pixbuf"></a><h3>gimp_layer_new_from_pixbuf ()</h3>
 
262
<pre class="programlisting"><span class="returnvalue">gint32</span>              gimp_layer_new_from_pixbuf          (<em class="parameter"><code><span class="type">gint32</span> image_ID</code></em>,
 
263
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
 
264
                                                         <em class="parameter"><code><span class="type">GdkPixbuf</span> *pixbuf</code></em>,
 
265
                                                         <em class="parameter"><code><span class="type">gdouble</span> opacity</code></em>,
 
266
                                                         <em class="parameter"><code><a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects" title="enum GimpLayerModeEffects"><span class="type">GimpLayerModeEffects</span></a> mode</code></em>,
 
267
                                                         <em class="parameter"><code><span class="type">gdouble</span> progress_start</code></em>,
 
268
                                                         <em class="parameter"><code><span class="type">gdouble</span> progress_end</code></em>);</pre>
 
269
<p>
 
270
Create a new layer from a <code class="literal">GdkPixbuf</code>.
 
271
</p>
 
272
<p>
 
273
This procedure creates a new layer from the given <code class="literal">GdkPixbuf</code>.  The
 
274
image has to be an RGB image and just like with <a class="link" href="libgimp-gimplayer.html#gimp-layer-new" title="gimp_layer_new ()"><code class="function">gimp_layer_new()</code></a>
 
275
you will still need to add the layer to it.
 
276
</p>
 
277
<p>
 
278
If you pass <em class="parameter"><code>progress_end</code></em> &gt; <em class="parameter"><code>progress_start</code></em> to this function,
 
279
<a class="link" href="libgimp-gimpprogress.html#gimp-progress-update" title="gimp_progress_update ()"><code class="function">gimp_progress_update()</code></a> will be called for. You have to call
 
280
<a class="link" href="libgimp-gimpprogress.html#gimp-progress-init" title="gimp_progress_init ()"><code class="function">gimp_progress_init()</code></a> beforehand then.
 
281
</p>
 
282
<div class="variablelist"><table border="0">
 
283
<col align="left" valign="top">
 
284
<tbody>
 
285
<tr>
 
286
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
 
287
<td>The RGB image to which to add the layer.</td>
 
288
</tr>
 
289
<tr>
 
290
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 
291
<td>The layer name.</td>
 
292
</tr>
 
293
<tr>
 
294
<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
 
295
<td>A GdkPixbuf.</td>
 
296
</tr>
 
297
<tr>
 
298
<td><p><span class="term"><em class="parameter"><code>opacity</code></em> :</span></p></td>
 
299
<td>The layer opacity.</td>
 
300
</tr>
 
301
<tr>
 
302
<td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
 
303
<td>The layer combination mode.</td>
 
304
</tr>
 
305
<tr>
 
306
<td><p><span class="term"><em class="parameter"><code>progress_start</code></em> :</span></p></td>
 
307
<td>start of progress</td>
 
308
</tr>
 
309
<tr>
 
310
<td><p><span class="term"><em class="parameter"><code>progress_end</code></em> :</span></p></td>
 
311
<td>end of progress</td>
 
312
</tr>
 
313
<tr>
 
314
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
315
<td>The newly created layer.</td>
 
316
</tr>
 
317
</tbody>
 
318
</table></div>
 
319
<p class="since">Since GIMP 2.4</p>
 
320
</div>
 
321
<hr>
 
322
<div class="refsect2">
 
323
<a name="gimp-layer-new-from-surface"></a><h3>gimp_layer_new_from_surface ()</h3>
 
324
<pre class="programlisting"><span class="returnvalue">gint32</span>              gimp_layer_new_from_surface         (<em class="parameter"><code><span class="type">gint32</span> image_ID</code></em>,
 
325
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
 
326
                                                         <em class="parameter"><code><span class="type">cairo_surface_t</span> *surface</code></em>,
 
327
                                                         <em class="parameter"><code><span class="type">gdouble</span> progress_start</code></em>,
 
328
                                                         <em class="parameter"><code><span class="type">gdouble</span> progress_end</code></em>);</pre>
 
329
<p>
 
330
Create a new layer from a <span class="type">cairo_surface_t</span>.
 
331
</p>
 
332
<p>
 
333
This procedure creates a new layer from the given
 
334
<span class="type">cairo_surface_t</span>. The image has to be an RGB image and just like
 
335
with <a class="link" href="libgimp-gimplayer.html#gimp-layer-new" title="gimp_layer_new ()"><code class="function">gimp_layer_new()</code></a> you will still need to add the layer to it.
 
336
</p>
 
337
<p>
 
338
If you pass <em class="parameter"><code>progress_end</code></em> &gt; <em class="parameter"><code>progress_start</code></em> to this function,
 
339
<a class="link" href="libgimp-gimpprogress.html#gimp-progress-update" title="gimp_progress_update ()"><code class="function">gimp_progress_update()</code></a> will be called for. You have to call
 
340
<a class="link" href="libgimp-gimpprogress.html#gimp-progress-init" title="gimp_progress_init ()"><code class="function">gimp_progress_init()</code></a> beforehand then.
 
341
</p>
 
342
<div class="variablelist"><table border="0">
 
343
<col align="left" valign="top">
 
344
<tbody>
 
345
<tr>
 
346
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
 
347
<td>The RGB image to which to add the layer.</td>
 
348
</tr>
 
349
<tr>
 
350
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 
351
<td>The layer name.</td>
 
352
</tr>
 
353
<tr>
 
354
<td><p><span class="term"><em class="parameter"><code>surface</code></em> :</span></p></td>
 
355
<td>A Cairo image surface.</td>
 
356
</tr>
 
357
<tr>
 
358
<td><p><span class="term"><em class="parameter"><code>progress_start</code></em> :</span></p></td>
 
359
<td>start of progress</td>
 
360
</tr>
 
361
<tr>
 
362
<td><p><span class="term"><em class="parameter"><code>progress_end</code></em> :</span></p></td>
 
363
<td>end of progress</td>
 
364
</tr>
 
365
<tr>
 
366
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
367
<td>The newly created layer.</td>
 
368
</tr>
 
369
</tbody>
 
370
</table></div>
 
371
<p class="since">Since GIMP 2.8</p>
 
372
</div>
 
373
<hr>
 
374
<div class="refsect2">
 
375
<a name="gimp-layer-group-new"></a><h3>gimp_layer_group_new ()</h3>
 
376
<pre class="programlisting"><span class="returnvalue">gint32</span>              gimp_layer_group_new                (<em class="parameter"><code><span class="type">gint32</span> image_ID</code></em>);</pre>
 
377
<p>
 
378
Create a new layer group.
 
379
</p>
 
380
<p>
 
381
This procedure creates a new layer group. Attributes such as layer
 
382
mode and opacity should be set with explicit procedure calls. Add
 
383
the new layer group (which is a kind of layer) with the
 
384
<a class="link" href="libgimp-gimpimage.html#gimp-image-insert-layer" title="gimp_image_insert_layer ()"><code class="function">gimp_image_insert_layer()</code></a> command.
 
385
</p>
 
386
<div class="variablelist"><table border="0">
 
387
<col align="left" valign="top">
 
388
<tbody>
 
389
<tr>
 
390
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></p></td>
 
391
<td>The image to which to add the layer group.</td>
 
392
</tr>
 
393
<tr>
 
394
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
395
<td>The newly created layer group.</td>
 
396
</tr>
 
397
</tbody>
 
398
</table></div>
 
399
<p class="since">Since GIMP 2.8</p>
 
400
</div>
 
401
<hr>
 
402
<div class="refsect2">
248
403
<a name="gimp-layer-copy"></a><h3>gimp_layer_copy ()</h3>
249
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              gimp_layer_copy                     (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
404
<pre class="programlisting"><span class="returnvalue">gint32</span>              gimp_layer_copy                     (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
250
405
<p>
251
406
Copy a layer.
252
407
</p>
272
427
<hr>
273
428
<div class="refsect2">
274
429
<a name="gimp-layer-scale"></a><h3>gimp_layer_scale ()</h3>
275
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_scale                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
276
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_width</code></em>,
277
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_height</code></em>,
278
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_origin</code></em>);</pre>
 
430
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_scale                    (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
431
                                                         <em class="parameter"><code><span class="type">gint</span> new_width</code></em>,
 
432
                                                         <em class="parameter"><code><span class="type">gint</span> new_height</code></em>,
 
433
                                                         <em class="parameter"><code><span class="type">gboolean</span> local_origin</code></em>);</pre>
279
434
<p>
280
435
Scale the layer using the default interpolation method.
281
436
</p>
284
439
equal to the supplied parameters. The 'local-origin' parameter
285
440
specifies whether to scale from the center of the layer, or from the
286
441
image origin. This operation only works if the layer has been added
287
 
to an image. The default interpolation method is used for scaling.
 
442
to an image. The interpolation method used can be set with
 
443
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-interpolation" title="gimp_context_set_interpolation ()"><code class="function">gimp_context_set_interpolation()</code></a>.
288
444
</p>
289
445
<div class="variablelist"><table border="0">
290
446
<col align="left" valign="top">
315
471
<hr>
316
472
<div class="refsect2">
317
473
<a name="gimp-layer-scale-full"></a><h3>gimp_layer_scale_full ()</h3>
318
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_scale_full               (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
319
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_width</code></em>,
320
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_height</code></em>,
321
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_origin</code></em>,
322
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpInterpolationType"><span class="type">GimpInterpolationType</span></a> interpolation</code></em>);</pre>
323
 
<p>
324
 
Scale the layer using a specific interpolation method.
325
 
</p>
326
 
<p>
327
 
This procedure scales the layer so that its new width and height are
328
 
equal to the supplied parameters. The 'local-origin' parameter
329
 
specifies whether to scale from the center of the layer, or from the
330
 
image origin. This operation only works if the layer has been added
331
 
to an image. This procedure allows you to specify the interpolation
332
 
method explicitly.
333
 
</p>
 
474
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_scale_full               (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
475
                                                         <em class="parameter"><code><span class="type">gint</span> new_width</code></em>,
 
476
                                                         <em class="parameter"><code><span class="type">gint</span> new_height</code></em>,
 
477
                                                         <em class="parameter"><code><span class="type">gboolean</span> local_origin</code></em>,
 
478
                                                         <em class="parameter"><code><a href="/local/head/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpInterpolationType"><span class="type">GimpInterpolationType</span></a> interpolation</code></em>);</pre>
 
479
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
480
<h3 class="title">Warning</h3>
 
481
<p><code class="literal">gimp_layer_scale_full</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="libgimp-gimplayer.html#gimp-layer-scale" title="gimp_layer_scale ()"><code class="function">gimp_layer_scale()</code></a> instead.</p>
 
482
</div>
334
483
<div class="variablelist"><table border="0">
335
484
<col align="left" valign="top">
336
485
<tbody>
365
514
<hr>
366
515
<div class="refsect2">
367
516
<a name="gimp-layer-resize"></a><h3>gimp_layer_resize ()</h3>
368
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_resize                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
369
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_width</code></em>,
370
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_height</code></em>,
371
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offx</code></em>,
372
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offy</code></em>);</pre>
 
517
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_resize                   (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
518
                                                         <em class="parameter"><code><span class="type">gint</span> new_width</code></em>,
 
519
                                                         <em class="parameter"><code><span class="type">gint</span> new_height</code></em>,
 
520
                                                         <em class="parameter"><code><span class="type">gint</span> offx</code></em>,
 
521
                                                         <em class="parameter"><code><span class="type">gint</span> offy</code></em>);</pre>
373
522
<p>
374
523
Resize the layer to the specified extents.
375
524
</p>
412
561
<hr>
413
562
<div class="refsect2">
414
563
<a name="gimp-layer-resize-to-image-size"></a><h3>gimp_layer_resize_to_image_size ()</h3>
415
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_resize_to_image_size     (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
564
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_resize_to_image_size     (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
416
565
<p>
417
566
Resize a layer to the image size.
418
567
</p>
437
586
<hr>
438
587
<div class="refsect2">
439
588
<a name="gimp-layer-translate"></a><h3>gimp_layer_translate ()</h3>
440
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_translate                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
441
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offx</code></em>,
442
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offy</code></em>);</pre>
 
589
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_translate                (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
590
                                                         <em class="parameter"><code><span class="type">gint</span> offx</code></em>,
 
591
                                                         <em class="parameter"><code><span class="type">gint</span> offy</code></em>);</pre>
443
592
<p>
444
593
Translate the layer by the specified offsets.
445
594
</p>
476
625
<hr>
477
626
<div class="refsect2">
478
627
<a name="gimp-layer-add-alpha"></a><h3>gimp_layer_add_alpha ()</h3>
479
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_add_alpha                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
628
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_add_alpha                (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
480
629
<p>
481
630
Add an alpha channel to the layer if it doesn't already have one.
482
631
</p>
504
653
<hr>
505
654
<div class="refsect2">
506
655
<a name="gimp-layer-flatten"></a><h3>gimp_layer_flatten ()</h3>
507
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_flatten                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
656
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_flatten                  (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
508
657
<p>
509
658
Remove the alpha channel from the layer if it has one.
510
659
</p>
532
681
<hr>
533
682
<div class="refsect2">
534
683
<a name="gimp-layer-set-offsets"></a><h3>gimp_layer_set_offsets ()</h3>
535
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_set_offsets              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
536
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offx</code></em>,
537
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offy</code></em>);</pre>
 
684
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_set_offsets              (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
685
                                                         <em class="parameter"><code><span class="type">gint</span> offx</code></em>,
 
686
                                                         <em class="parameter"><code><span class="type">gint</span> offy</code></em>);</pre>
538
687
<p>
539
688
Set the layer offsets.
540
689
</p>
568
717
<hr>
569
718
<div class="refsect2">
570
719
<a name="gimp-layer-create-mask"></a><h3>gimp_layer_create_mask ()</h3>
571
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              gimp_layer_create_mask              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
572
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpAddMaskType"><span class="type">GimpAddMaskType</span></a> mask_type</code></em>);</pre>
 
720
<pre class="programlisting"><span class="returnvalue">gint32</span>              gimp_layer_create_mask              (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
721
                                                         <em class="parameter"><code><a href="/local/head/share/gtk-doc/html/libgimpbase/libgimpbase-gimpbaseenums.html#GimpAddMaskType"><span class="type">GimpAddMaskType</span></a> mask_type</code></em>);</pre>
573
722
<p>
574
723
Create a layer mask for the specified specified layer.
575
724
</p>
606
755
<hr>
607
756
<div class="refsect2">
608
757
<a name="gimp-layer-from-mask"></a><h3>gimp_layer_from_mask ()</h3>
609
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              gimp_layer_from_mask                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> mask_ID</code></em>);</pre>
 
758
<pre class="programlisting"><span class="returnvalue">gint32</span>              gimp_layer_from_mask                (<em class="parameter"><code><span class="type">gint32</span> mask_ID</code></em>);</pre>
610
759
<p>
611
760
Get the specified mask's layer.
612
761
</p>
632
781
<hr>
633
782
<div class="refsect2">
634
783
<a name="gimp-layer-get-mask"></a><h3>gimp_layer_get_mask ()</h3>
635
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="returnvalue">gint32</span></a>              gimp_layer_get_mask                 (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
784
<pre class="programlisting"><span class="returnvalue">gint32</span>              gimp_layer_get_mask                 (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
636
785
<p>
637
786
Get the specified layer's mask if it exists.
638
787
</p>
657
806
<hr>
658
807
<div class="refsect2">
659
808
<a name="gimp-layer-add-mask"></a><h3>gimp_layer_add_mask ()</h3>
660
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_add_mask                 (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
661
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> mask_ID</code></em>);</pre>
 
809
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_add_mask                 (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
810
                                                         <em class="parameter"><code><span class="type">gint32</span> mask_ID</code></em>);</pre>
662
811
<p>
663
812
Add a layer mask to the specified layer.
664
813
</p>
692
841
<hr>
693
842
<div class="refsect2">
694
843
<a name="gimp-layer-remove-mask"></a><h3>gimp_layer_remove_mask ()</h3>
695
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_remove_mask              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
 
844
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_remove_mask              (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
696
845
                                                         <em class="parameter"><code><a class="link" href="libgimp-gimpenums.html#GimpMaskApplyMode" title="enum GimpMaskApplyMode"><span class="type">GimpMaskApplyMode</span></a> mode</code></em>);</pre>
697
846
<p>
698
847
Remove the specified layer mask from the layer.
722
871
<hr>
723
872
<div class="refsect2">
724
873
<a name="gimp-layer-get-lock-alpha"></a><h3>gimp_layer_get_lock_alpha ()</h3>
725
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_get_lock_alpha           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
874
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_get_lock_alpha           (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
726
875
<p>
727
876
Get the lock alpha channel setting of the specified layer.
728
877
</p>
747
896
<hr>
748
897
<div class="refsect2">
749
898
<a name="gimp-layer-set-lock-alpha"></a><h3>gimp_layer_set_lock_alpha ()</h3>
750
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_set_lock_alpha           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
751
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> lock_alpha</code></em>);</pre>
 
899
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_set_lock_alpha           (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
900
                                                         <em class="parameter"><code><span class="type">gboolean</span> lock_alpha</code></em>);</pre>
752
901
<p>
753
902
Set the lock alpha channel setting of the specified layer.
754
903
</p>
777
926
<hr>
778
927
<div class="refsect2">
779
928
<a name="gimp-layer-get-preserve-trans"></a><h3>gimp_layer_get_preserve_trans ()</h3>
780
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_get_preserve_trans       (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
929
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_get_preserve_trans       (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
781
930
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
782
931
<h3 class="title">Warning</h3>
783
932
<p><code class="literal">gimp_layer_get_preserve_trans</code> is deprecated and should not be used in newly-written code.</p>
802
951
<hr>
803
952
<div class="refsect2">
804
953
<a name="gimp-layer-set-preserve-trans"></a><h3>gimp_layer_set_preserve_trans ()</h3>
805
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_set_preserve_trans       (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
806
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_trans</code></em>);</pre>
 
954
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_set_preserve_trans       (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
955
                                                         <em class="parameter"><code><span class="type">gboolean</span> preserve_trans</code></em>);</pre>
807
956
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
808
957
<h3 class="title">Warning</h3>
809
958
<p><code class="literal">gimp_layer_set_preserve_trans</code> is deprecated and should not be used in newly-written code.</p>
832
981
<hr>
833
982
<div class="refsect2">
834
983
<a name="gimp-layer-get-apply-mask"></a><h3>gimp_layer_get_apply_mask ()</h3>
835
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_get_apply_mask           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
984
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_get_apply_mask           (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
836
985
<p>
837
986
Get the apply mask setting of the specified layer.
838
987
</p>
858
1007
<hr>
859
1008
<div class="refsect2">
860
1009
<a name="gimp-layer-set-apply-mask"></a><h3>gimp_layer_set_apply_mask ()</h3>
861
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_set_apply_mask           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
862
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> apply_mask</code></em>);</pre>
 
1010
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_set_apply_mask           (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
1011
                                                         <em class="parameter"><code><span class="type">gboolean</span> apply_mask</code></em>);</pre>
863
1012
<p>
864
1013
Set the apply mask setting of the specified layer.
865
1014
</p>
890
1039
<hr>
891
1040
<div class="refsect2">
892
1041
<a name="gimp-layer-get-show-mask"></a><h3>gimp_layer_get_show_mask ()</h3>
893
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_get_show_mask            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
1042
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_get_show_mask            (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
894
1043
<p>
895
1044
Get the show mask setting of the specified layer.
896
1045
</p>
917
1066
<hr>
918
1067
<div class="refsect2">
919
1068
<a name="gimp-layer-set-show-mask"></a><h3>gimp_layer_set_show_mask ()</h3>
920
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_set_show_mask            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
921
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_mask</code></em>);</pre>
 
1069
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_set_show_mask            (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
1070
                                                         <em class="parameter"><code><span class="type">gboolean</span> show_mask</code></em>);</pre>
922
1071
<p>
923
1072
Set the show mask setting of the specified layer.
924
1073
</p>
949
1098
<hr>
950
1099
<div class="refsect2">
951
1100
<a name="gimp-layer-get-edit-mask"></a><h3>gimp_layer_get_edit_mask ()</h3>
952
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_get_edit_mask            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
1101
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_get_edit_mask            (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
953
1102
<p>
954
1103
Get the edit mask setting of the specified layer.
955
1104
</p>
975
1124
<hr>
976
1125
<div class="refsect2">
977
1126
<a name="gimp-layer-set-edit-mask"></a><h3>gimp_layer_set_edit_mask ()</h3>
978
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_set_edit_mask            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
979
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> edit_mask</code></em>);</pre>
 
1127
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_set_edit_mask            (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
1128
                                                         <em class="parameter"><code><span class="type">gboolean</span> edit_mask</code></em>);</pre>
980
1129
<p>
981
1130
Set the edit mask setting of the specified layer.
982
1131
</p>
1007
1156
<hr>
1008
1157
<div class="refsect2">
1009
1158
<a name="gimp-layer-get-opacity"></a><h3>gimp_layer_get_opacity ()</h3>
1010
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             gimp_layer_get_opacity              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
1159
<pre class="programlisting"><span class="returnvalue">gdouble</span>             gimp_layer_get_opacity              (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
1011
1160
<p>
1012
1161
Get the opacity of the specified layer.
1013
1162
</p>
1031
1180
<hr>
1032
1181
<div class="refsect2">
1033
1182
<a name="gimp-layer-set-opacity"></a><h3>gimp_layer_set_opacity ()</h3>
1034
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_set_opacity              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
1035
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> opacity</code></em>);</pre>
 
1183
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_set_opacity              (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
 
1184
                                                         <em class="parameter"><code><span class="type">gdouble</span> opacity</code></em>);</pre>
1036
1185
<p>
1037
1186
Set the opacity of the specified layer.
1038
1187
</p>
1060
1209
<hr>
1061
1210
<div class="refsect2">
1062
1211
<a name="gimp-layer-get-mode"></a><h3>gimp_layer_get_mode ()</h3>
1063
 
<pre class="programlisting"><a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects" title="enum GimpLayerModeEffects"><span class="returnvalue">GimpLayerModeEffects</span></a> gimp_layer_get_mode                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
1212
<pre class="programlisting"><a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects" title="enum GimpLayerModeEffects"><span class="returnvalue">GimpLayerModeEffects</span></a> gimp_layer_get_mode                (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
1064
1213
<p>
1065
1214
Get the combination mode of the specified layer.
1066
1215
</p>
1084
1233
<hr>
1085
1234
<div class="refsect2">
1086
1235
<a name="gimp-layer-set-mode"></a><h3>gimp_layer_set_mode ()</h3>
1087
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_set_mode                 (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>,
 
1236
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_set_mode                 (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>,
1088
1237
                                                         <em class="parameter"><code><a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects" title="enum GimpLayerModeEffects"><span class="type">GimpLayerModeEffects</span></a> mode</code></em>);</pre>
1089
1238
<p>
1090
1239
Set the combination mode of the specified layer.
1113
1262
<hr>
1114
1263
<div class="refsect2">
1115
1264
<a name="gimp-layer-is-floating-sel"></a><h3>gimp_layer_is_floating_sel ()</h3>
1116
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gimp_layer_is_floating_sel          (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> layer_ID</code></em>);</pre>
 
1265
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gimp_layer_is_floating_sel          (<em class="parameter"><code><span class="type">gint32</span> layer_ID</code></em>);</pre>
1117
1266
<p>
1118
1267
Is the specified layer a floating selection?
1119
1268
</p>