[gimp-help-2] Updates in layers
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Updates in layers
- Date: Wed, 16 May 2018 05:51:13 +0000 (UTC)
commit 2514604d36316dbb72bcd730d587e845632d8c0e
Author: Julien Hardelin <jhardlin orange fr>
Date: Wed May 16 07:50:38 2018 +0200
Updates in layers
images/C/dialogs/edit-layer-attributes.png | Bin 0 -> 66355 bytes
.../layer/composite-mode-clip-to-backdrop.png | Bin 0 -> 31779 bytes
.../C/menus/layer/composite-mode-clip-to-layer.png | Bin 0 -> 31816 bytes
.../C/menus/layer/composite-mode-intersection.png | Bin 0 -> 14379 bytes
images/C/menus/layer/composite-mode-union.png | Bin 0 -> 41306 bytes
images/C/menus/layer/new.png | Bin 6818 -> 54244 bytes
...nd-repeat-none.png => gradient-repeat-none.png} | Bin 24436 -> 24436 bytes
...t-sawtooth.png => gradient-repeat-sawtooth.png} | Bin 35764 -> 35764 bytes
...iangular.png => gradient-repeat-triangular.png} | Bin 37874 -> 37874 bytes
...t-truncate.png => gradient-repeat-truncate.png} | Bin 19457 -> 19457 bytes
src/concepts/layers.xml | 103 +++-------
src/dialogs/layer-dialog.xml | 137 +++++++++----
src/menus/layer/new.xml | 217 +++++++++++++++++++-
src/toolbox/transform/move.xml | 26 +--
14 files changed, 341 insertions(+), 142 deletions(-)
---
diff --git a/images/C/dialogs/edit-layer-attributes.png b/images/C/dialogs/edit-layer-attributes.png
new file mode 100644
index 0000000..d1d5d2b
Binary files /dev/null and b/images/C/dialogs/edit-layer-attributes.png differ
diff --git a/images/C/menus/layer/composite-mode-clip-to-backdrop.png
b/images/C/menus/layer/composite-mode-clip-to-backdrop.png
new file mode 100644
index 0000000..15dbad2
Binary files /dev/null and b/images/C/menus/layer/composite-mode-clip-to-backdrop.png differ
diff --git a/images/C/menus/layer/composite-mode-clip-to-layer.png
b/images/C/menus/layer/composite-mode-clip-to-layer.png
new file mode 100644
index 0000000..827f3ec
Binary files /dev/null and b/images/C/menus/layer/composite-mode-clip-to-layer.png differ
diff --git a/images/C/menus/layer/composite-mode-intersection.png
b/images/C/menus/layer/composite-mode-intersection.png
new file mode 100644
index 0000000..b0fd7dc
Binary files /dev/null and b/images/C/menus/layer/composite-mode-intersection.png differ
diff --git a/images/C/menus/layer/composite-mode-union.png b/images/C/menus/layer/composite-mode-union.png
new file mode 100644
index 0000000..3f4c9ec
Binary files /dev/null and b/images/C/menus/layer/composite-mode-union.png differ
diff --git a/images/C/menus/layer/new.png b/images/C/menus/layer/new.png
index 704bec6..29a331b 100644
Binary files a/images/C/menus/layer/new.png and b/images/C/menus/layer/new.png differ
diff --git a/src/concepts/layers.xml b/src/concepts/layers.xml
index aa24ac2..8875b62 100644
--- a/src/concepts/layers.xml
+++ b/src/concepts/layers.xml
@@ -22,13 +22,37 @@
</indexterm>
<para>
- A good way to visualize a <acronym>GIMP</acronym> image is as a stack of
- transparencies: in <acronym>GIMP</acronym> terminology, each
- individual transparency is called a
- <emphasis>layer</emphasis>. There is no limit, in principle, to the number
- of layers an image can have: only the amount of memory available on the
- system. It is not uncommon for advanced users to work with images
- containing dozens of layers.
+ You can think of layers as a stack of slides. Using layers, you can
+ construct an image of several conceptual parts, each of which can be
+ manipulated without affecting any other part of the image. Layers are
+ stacked on top of each other. The bottom layer is the background of the
+ image, and the components in the foreground of the image come above it.
+ </para>
+ <figure>
+ <title>An image with layers</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/layers_overview.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>Layers of the image</para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/layers_example.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>Resulting image</para>
+ </caption>
+ </mediaobject>
+ </figure>
+ <para>
+ There is no limit, in principle, to the number of layers an image can
+ have: only the amount of memory available on the system. It is not
+ uncommon for advanced users to work with images containing dozens of
+ layers. You can group layers to make your work easier, and you have many
+ commands to handle layers.
</para>
<para>
The organization of layers in an image is shown by the Layers dialog,
@@ -423,71 +447,6 @@
</para>
</listitem>
</varlistentry>
-
- <varlistentry>
- <term><quote>Lock pixels</quote> setting</term>
- <listitem>
- <para>
- This toggle button enables and disables protection from painting
- over the currently selected layer. When the button is pressed
- down, you cannot use any brush-based tool (Paintbrush, Pencil,
- Eraser etc.), the Airbrush or the Ink tool on the currently
- selected layer.
- </para>
- <figure>
- <title>Lock pixels</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/dialogs/lock-pixels.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><quote>Lock position and size</quote> setting</term>
- <listitem>
- <para>
- This toggle button enables and disables protection of layers from
- moving them around or transforming them. When the button is
- pressed down, you cannot use any transform tool (Rotate, Shear,
- Perspective and others) or move it.
- </para>
- <figure>
- <title>Lock position and size</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/dialogs/lock-position-size.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><quote>Lock alpha channel</quote> setting</term>
- <listitem>
- <para>
- This toggle button controls the <quote>Lock</quote> setting for
- the transparency of the layer (see the figure below). If this is
- checked, then the alpha channel for the layer is locked, and no
- manipulation has any effect on it. In particular, nothing that
- you do to a transparent part of the layer will have any effect.
- </para>
- <figure>
- <title>Lock Alpha channel</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/dialogs/lock-alpha.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </listitem>
- </varlistentry>
</variablelist>
</sect2>
</sect1>
diff --git a/src/dialogs/layer-dialog.xml b/src/dialogs/layer-dialog.xml
index f0f04af..aa9cb66 100755
--- a/src/dialogs/layer-dialog.xml
+++ b/src/dialogs/layer-dialog.xml
@@ -29,32 +29,8 @@
</figure>
<para>
The <quote>Layers</quote> dialog is the main interface to edit, modify
- and manage your layers. You can think of layers as a stack of slides or
- clothes on your body. Using layers, you can construct an image of several
- conceptual parts, each of which can be manipulated without affecting any
- other part of the image. Layers are stacked on top of each other. The
- bottom layer is the background of the image, and the components in the
- foreground of the image come above it.
+ and manage your layers.
</para>
- <figure>
- <title>An image with layers</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/dialogs/layers_overview.png" format="PNG"/>
- </imageobject>
- <caption>
- <para>Layers of the image</para>
- </caption>
- </mediaobject>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/dialogs/layers_example.png" format="PNG"/>
- </imageobject>
- <caption>
- <para>Resulting image</para>
- </caption>
- </mediaobject>
- </figure>
<sect3 id="gimp-layer-dialog-activate">
<title>Activating the dialog</title>
@@ -203,10 +179,9 @@
<para>
The main attribute is the name of the layer. You can edit
this by a double-click on the name of the layer. You can
- also use the <quote>Edit Layer Attributes</quote> dialog you
- get by double-clicking on the thumbnail (or the mask), or
- through right-click on the layer and select <quote>Edit Layer
- Attributes...</quote>.
+ also use the <quote>Edit Layer Attributes</quote> dialog you
+ can find in the context menu that you get by through a
+ right-click on the layer.
</para>
</listitem>
</varlistentry>
@@ -284,24 +259,65 @@
<primary>Lock pixels</primary>
</indexterm>
<para>
- You have two possibilities:
+ You have three possibilities:
</para>
<itemizedlist>
<listitem>
<para>
- <emphasis role="bold">Lock pixels</emphasis>: when this
- option is checked, you can't modify layer pixels. This
- may be necessary to protect them from unwanted changes.
+ <emphasis role="bold">Lock pixels</emphasis>:
+ When the button is pressed down, you cannot use any
+ brush-based tool (Paintbrush, Pencil, Eraser etc.), the
+ Airbrush or the Ink tool on the currently selected layer.
+ This may be necessary to protect them from unwanted
+ changes.
+ </para>
+ <figure>
+ <title>Lock pixels</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/dialogs/lock-pixels.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">Lock position and size</emphasis>:
+ This toggle button enables and disables protection of
+ layers from moving them around or transforming them. When
+ the button is pressed down, you cannot use any transform
+ tool (Rotate, Shear, Perspective and others) or move it.
</para>
+ <figure>
+ <title>Lock position and size</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/dialogs/lock-position-size.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
</listitem>
<listitem>
<para>
- <emphasis role="bold">Lock alpha channel</emphasis>: if
- you check this option the transparent areas of the layer
- will be kept, even if you have checked the
- <guilabel>Fill transparent areas</guilabel>
- option for the Bucket fill tool.
+ <emphasis role="bold">Lock alpha channel</emphasis>:
+ This toggle button controls the <quote>Lock</quote>
+ setting for the transparency of the layer . If this is
+ pressed down, then the alpha channel for the layer is
+ locked, and no manipulation has any effect on it. In
+ particular, nothing that you do to a transparent part of
+ the layer will have any effect.
</para>
+ <figure>
+ <title>Lock Alpha channel</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/dialogs/lock-alpha.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
</listitem>
</itemizedlist>
<figure>
@@ -363,19 +379,45 @@
</imageobject>
</inlinemediaobject>
</guiicon>
- <phrase>New layer</phrase>
+ <phrase>New Layer</phrase>
+ </term>
+ <listitem>
+ <para>
+ Here you can create a new layer. A dialog is opened, which
+ is described in
+ <link linkend="gimp-layer-new">New Layer</link>.
+ </para>
+ <para>
+ Press the <keycap>Shift</keycap> key to open a new layer with
+ last used values.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="gimp-layer-new-group">
+ <term>
+ <guiicon>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/dialogs/dialogs-icon-new-group.png"/>
+ </imageobject>
+ </inlinemediaobject>
+ </guiicon>
+ <phrase>New Layer Group</phrase>
</term>
<listitem>
<para>
- Here you can create a new layer. A dialog is opened where
- you can enter the <guilabel>Layer name</guilabel>,
- perhaps change the default <guilabel>Height</guilabel>
- and <guilabel>Width</guilabel>, and choose the
- <guilabel>Layer fill type</guilabel>
- that will be the new layer's background.
+ Here you can create a new layer group. A new layer is
+ created, where you can put layers down.
+ </para>
+ <para>
+ Layer groups are described in
+ <link linkend="gimp-layer-groups">Layer groups</link>.
</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term>
<guiicon>
@@ -396,6 +438,7 @@
</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term>
<guiicon>
@@ -425,6 +468,7 @@
</tip>
</listitem>
</varlistentry>
+
<varlistentry>
<term>
<guiicon>
@@ -444,6 +488,7 @@
</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term>
<guiicon>
@@ -472,6 +517,7 @@
</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term>
<guiicon>
@@ -507,6 +553,7 @@
</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term>Clicking-and-dragging layers</term>
<listitem>
diff --git a/src/menus/layer/new.xml b/src/menus/layer/new.xml
index cb3127d..2033874 100644
--- a/src/menus/layer/new.xml
+++ b/src/menus/layer/new.xml
@@ -2,10 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2008-02-17: ude: renamed id: gimp-new-layer-dialog -> gimp-layer-new
- 2007-02-21: adde Norwegian by KoSt
- 2007-02-15: added Spanish translation by manuq
- 2005-11-03: split of from menu-layer.xml by axel.wernicke
+ 2010-05-10 j.h: Update to v2.10
-->
<sect2 id="gimp-layer-new">
<title>New Layer</title>
@@ -23,8 +20,6 @@
The <guimenuitem>New Layer…</guimenuitem> command opens the <quote>Create
a New Layer</quote> dialog that allows you to add a new, empty
layer to the layer stack of the image, just above the active layer.
- The command displays a dialog in which you can specify the size of
- the new layer.
</para>
<sect3>
@@ -36,7 +31,8 @@
<menuchoice>
<guimenu>Layer</guimenu>
<guimenuitem>New Layer…</guimenuitem>
- </menuchoice>.
+ </menuchoice>,
+ or by clicking on the dedicated button in the layer dialog.
</para>
</listitem>
</itemizedlist>
@@ -73,6 +69,183 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>Color tag</term>
+ <listitem>
+ <para>
+ If you click on one of these color buttons, the "Eye" icon box
+ of the created layer will have this color. This is interesting
+ when you have many layers in the image.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Mode</term>
+ <listitem>
+ <para>
+ Default is <quote>Normal</quote>. The drop-down list offers all
+ layer blend modes. On the right, another drop-down list to select
+ between <quote>Default</quote> or <quote>Legacy</quote> group
+ of modes.
+ </para>
+ <para>
+ Layer blend modes are described in
+ <link linkend="gimp-concepts-layer-modes">Layer Modes</link>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Blend space</term>
+ <listitem>
+ <para>
+ The space used by the layer mode. This option is not activated.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry >
+ <term>Composite mode</term>
+ <listitem>
+ <para>
+ The <emphasis role="bold">layer's mode</emphasis> (sometimes
+ referred to as its <quote>blend mode</quote>: Normal, Multiply,
+ etc.) determines how the <emphasis>color values</emphasis> of the
+ layer and its backdrop are combined, while the <emphasis>
+ role="bold">layer's composite mode</emphasis> determines how the
+ <emphasis>alpha values</emphasis> of the layer and its backdrop
+ are combined. (The layer's backdrop is the content against which
+ the layer is composited; namely, it's the combination of the layers
+ below it.)
+ </para>
+ <para>
+ There are two regions of interest when compositing the layer
+ against its backdrop: the opaque region of the backdrop, and the
+ opaque region of the layer. The layer's blend mode determines how
+ to combine the colors of the <emphasis>intersection</emphasis> of
+ these two regions: i.e., the common opaque region of both
+ the backdrop and the layer (pixels belonging to only one of these
+ regions don't need to be combined with anything, and retain their
+ original color.). The layer's composite mode determines which part
+ of these regions to keep, and which to discard.
+ </para>
+ <para>
+ The example images below show the composition of two layers -- the
+ bottom layer containing a red feathered circle, and the top layer
+ containing a green feathered circle -- using
+ <quote>Addition</quote> mode, and different composite modes
+ (applied to the top layer).
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Union</guilabel>:
+ keeps the opaque regions of both the layer and its backdrop,
+ i.e their union.
+ </para>
+ <figure>
+ <title><quote>Union</quote> option example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+format="PNG" fileref="images/menus/layer/composite-mode-union.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Clip to backdrop</guilabel>:
+ keeps only the opaque regions of the backdrop (this includes
+ the common opaque region to both the backdrop and the layer i.e
+ their intersection).
+ </para>
+ <figure>
+ <title><quote>Clip to backdrop</quote> option example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/menus/layer/composite-mode-clip-to-backdrop.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Clip to layer</guilabel>:
+ keeps only the opaque region of the layer (this includes
+ the common opaque region to both the backdrop and the layer,
+ i.e their intersection).
+ </para>
+ <figure>
+ <title><quote>Clip to layer</quote> option example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/menus/layer/composite-mode-clip-to-layer.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Intersection</guilabel>:
+ keeps only the opaque region to both the backdrop and the
+ layer, i.e their intersection.
+ </para>
+ <figure>
+ <title><quote>Intersection</quote> option example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/menus/layer/composite-mode-intersection.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Auto</guilabel>:
+ <quote>Auto</quote> mode is not a separate composite mode, but
+ rather corresponds to one of the other composite modes,
+ depending on the layer's blend mode: for <quote>Normal</quote>,
+ <quote>Dissolve</quote>, and <quote>Merge</quote>, it
+ corresponds to <quote>Union</quote>, and for the other modes
+ (that support different composite modes) it corresponds to
+ <quote>Clip to Backdrop</quote>.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Composite space</term>
+ <listitem>
+ <para>
+ Default is <quote>Auto</quote>. In the drop-down list, you can
+ choose between <quote>RGB linear</quote> and <quote>RGB
+ perceptual</quote>.
+ </para>
+ <para>
+ Channel encodings are described in
+ <link linkend="glossary-channel-encoding">Glossary</link>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Opacity</term>
+ <listitem>
+ <para>
+ Sets the opacity of painting on the layer. Default is 100%.
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term>Width; Height</term>
<listitem>
@@ -84,15 +257,37 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>Offset X; Y</term>
+ <listitem>
+ <para>
+ The origin of the new layer is the upper left corner of the
+ image. Here, you can set precisely the position of layers smaller
+ than the canvas, especially text layers.
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
- <term>Layer Fill Type</term>
+ <term>Fill With</term>
<listitem>
<para>
- There are four options for the solid color that fills the layer:
+ There are five options for the solid color that fills the layer:
the current <guilabel>Foreground color</guilabel>,
the current <guilabel>Background color</guilabel>,
- <guilabel>White</guilabel> and
- <guilabel>Transparency</guilabel>.
+ <guilabel>White</guilabel>, <guilabel>Transparency</guilabel>, and
+ <guilabel>Pattern</guilabel>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Switches</term>
+ <listitem>
+ <para>
+ These switches reproduce options described in the
+ <link linkend="gimp-layer-characteristics">Layer Dialog</link>.
</para>
</listitem>
</varlistentry>
diff --git a/src/toolbox/transform/move.xml b/src/toolbox/transform/move.xml
index 35c1316..dfe48c2 100644
--- a/src/toolbox/transform/move.xml
+++ b/src/toolbox/transform/move.xml
@@ -2,17 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2009-03-14 j.h: updated to v2.6. Added central cross in selections and using
- arrow keys.
- 2008-01-18 ude: updated 'de'
- 2008-01-11 j.h: updated to v2.4 'en;fr'
- 2007-06-13 kost: added 'no'
- 2007-04-17 Adde Spanish translation by AntI
- 2006-06-14 warning added in Affect section by j.h
- 2006-02-15 en;fr revised by j.h; added section for Default Behaviour
- 2005-12-06 replaced simplesect by sect3 by lexa
- 2005-12-06 replaced informalfigure by figure by lexa
- 050526 de reviewed and restructured by axel.wernicke
+
-->
<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-move">
<title>Move</title>
@@ -158,10 +148,18 @@
<term>Move the active layer</term>
<listitem>
<para>
- Only the current layer will be moved. This may be useful if
- you want to move a layer with transparent areas, where you
- can easily pick the wrong layer.
+ Only the current layer will be moved (if smaller than
+ canvas). This may be useful if you want to move a layer with
+ transparent areas, where you can easily pick the wrong layer
+ through these transparent areas.
</para>
+ <note>
+ <para>
+ You also can move the active layer by setting its offset in
+ the Edit Layer Attributes dialog.
+ <!--gimphelp-id does not exist-->
+ </para>
+ </note>
</listitem>
</varlistentry>
</variablelist>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
