[gimp-help-2] Update layer groups
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Update layer groups
- Date: Wed, 23 May 2018 05:48:18 +0000 (UTC)
commit f6e3d6ac2b06b3fd8952ec0ad2e35d1e4227049c
Author: Julien Hardelin <jhardlin orange fr>
Date: Wed May 23 07:47:43 2018 +0200
Update layer groups
docs/templates/dialog_template.xml | 26 +++---
docs/xcf images/layer-groups-pass-through-ex1.xcf | Bin 0 -> 101875 bytes
docs/xcf images/layer-groups-pass-through-ex2.xcf | Bin 0 -> 116975 bytes
docs/xcf images/layer-groups-pass-through-ex3.xcf | Bin 0 -> 111610 bytes
docs/xcf images/layer-groups-pass-through-ex4.xcf | Bin 0 -> 128322 bytes
docs/xcf images/layer-groups-pass-through-ex5.xcf | Bin 0 -> 140508 bytes
docs/xcf images/layer-groups-pass-through-ex6.xcf | Bin 0 -> 134459 bytes
.../examples/layer-groups-pass-through-ex1.png | Bin 0 -> 29036 bytes
.../examples/layer-groups-pass-through-ex2.png | Bin 0 -> 30601 bytes
.../examples/layer-groups-pass-through-ex3.png | Bin 0 -> 27895 bytes
.../examples/layer-groups-pass-through-ex4.png | Bin 0 -> 31107 bytes
.../examples/layer-groups-pass-through-ex5.png | Bin 0 -> 32129 bytes
.../examples/layer-groups-pass-through-ex6.png | Bin 0 -> 29651 bytes
src/concepts/layer-groups.xml | 63 ++++++++++-
src/glossary/glossary.xml | 114 ++++++++++++++++++++
15 files changed, 185 insertions(+), 18 deletions(-)
---
diff --git a/docs/templates/dialog_template.xml b/docs/templates/dialog_template.xml
index d783cfe..616043b 100644
--- a/docs/templates/dialog_template.xml
+++ b/docs/templates/dialog_template.xml
@@ -3,41 +3,41 @@
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<sect2 id="gimp-document-dialog">
- <title>Symmetry Painting dialog</title>
+ <title><!-- dialog name --> dialog</title>
<indexterm>
<primary>Dialog</primary>
- <secondary>Symmetry Painting</secondary>
+ <secondary><!-- dialog name --></secondary>
</indexterm>
<indexterm>
- <primary>Symmetry Painting</primary>
+ <primary><!-- dialog name --></primary>
</indexterm>
<figure>
- <title>Symmetry Painting dialog</title>
+ <title><!-- dialog name --> dialog</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/dialogs/symmetry-painting.png"
+ <imagedata fileref="images/dialogs/name.png"
format="PNG" />
</imageobject>
</mediaobject>
</figure>
+
<para>
- Symmetry Painting is a new painting feature in GIMP-2.10, supported by
- brush-based tools (Pencil, Paintbrush, Eraser, Airbrush, MyPaint brush,
- Clone, Smudge, Dodge) as well the Ink tool. There are several kinds of
- symmetry, all configurable.
- </para>
- <para>
- With these feature, GIMP's digital painting possibilities are increased.
+ <!--
+ General description of what the dialog is good for and how it
+ can be used in the creative process
+ -->
</para>
+
+ <!-- description of how to activate the dialog -->
<sect3>
<title>Activating the Dialog</title>
<para>
- The dialog <quote>Symmetry Painting</quote>
+ The dialog <quote><!-- dialog name --></quote>
is dockable. Read <xref linkend="gimp-concepts-docks" /> to learn more
about the concept of dockability. You can access this dialog in
different ways:
diff --git a/docs/xcf images/layer-groups-pass-through-ex1.xcf b/docs/xcf
images/layer-groups-pass-through-ex1.xcf
new file mode 100644
index 0000000..5bf07bd
Binary files /dev/null and b/docs/xcf images/layer-groups-pass-through-ex1.xcf differ
diff --git a/docs/xcf images/layer-groups-pass-through-ex2.xcf b/docs/xcf
images/layer-groups-pass-through-ex2.xcf
new file mode 100644
index 0000000..4833cf0
Binary files /dev/null and b/docs/xcf images/layer-groups-pass-through-ex2.xcf differ
diff --git a/docs/xcf images/layer-groups-pass-through-ex3.xcf b/docs/xcf
images/layer-groups-pass-through-ex3.xcf
new file mode 100644
index 0000000..bc76a39
Binary files /dev/null and b/docs/xcf images/layer-groups-pass-through-ex3.xcf differ
diff --git a/docs/xcf images/layer-groups-pass-through-ex4.xcf b/docs/xcf
images/layer-groups-pass-through-ex4.xcf
new file mode 100644
index 0000000..b50222c
Binary files /dev/null and b/docs/xcf images/layer-groups-pass-through-ex4.xcf differ
diff --git a/docs/xcf images/layer-groups-pass-through-ex5.xcf b/docs/xcf
images/layer-groups-pass-through-ex5.xcf
new file mode 100644
index 0000000..d5b901d
Binary files /dev/null and b/docs/xcf images/layer-groups-pass-through-ex5.xcf differ
diff --git a/docs/xcf images/layer-groups-pass-through-ex6.xcf b/docs/xcf
images/layer-groups-pass-through-ex6.xcf
new file mode 100644
index 0000000..67e8fe5
Binary files /dev/null and b/docs/xcf images/layer-groups-pass-through-ex6.xcf differ
diff --git a/images/C/dialogs/examples/layer-groups-pass-through-ex1.png
b/images/C/dialogs/examples/layer-groups-pass-through-ex1.png
new file mode 100644
index 0000000..eaa6de5
Binary files /dev/null and b/images/C/dialogs/examples/layer-groups-pass-through-ex1.png differ
diff --git a/images/C/dialogs/examples/layer-groups-pass-through-ex2.png
b/images/C/dialogs/examples/layer-groups-pass-through-ex2.png
new file mode 100644
index 0000000..193bc38
Binary files /dev/null and b/images/C/dialogs/examples/layer-groups-pass-through-ex2.png differ
diff --git a/images/C/dialogs/examples/layer-groups-pass-through-ex3.png
b/images/C/dialogs/examples/layer-groups-pass-through-ex3.png
new file mode 100644
index 0000000..69e96d7
Binary files /dev/null and b/images/C/dialogs/examples/layer-groups-pass-through-ex3.png differ
diff --git a/images/C/dialogs/examples/layer-groups-pass-through-ex4.png
b/images/C/dialogs/examples/layer-groups-pass-through-ex4.png
new file mode 100644
index 0000000..e4730d3
Binary files /dev/null and b/images/C/dialogs/examples/layer-groups-pass-through-ex4.png differ
diff --git a/images/C/dialogs/examples/layer-groups-pass-through-ex5.png
b/images/C/dialogs/examples/layer-groups-pass-through-ex5.png
new file mode 100644
index 0000000..369fa68
Binary files /dev/null and b/images/C/dialogs/examples/layer-groups-pass-through-ex5.png differ
diff --git a/images/C/dialogs/examples/layer-groups-pass-through-ex6.png
b/images/C/dialogs/examples/layer-groups-pass-through-ex6.png
new file mode 100644
index 0000000..37e7884
Binary files /dev/null and b/images/C/dialogs/examples/layer-groups-pass-through-ex6.png differ
diff --git a/src/concepts/layer-groups.xml b/src/concepts/layer-groups.xml
old mode 100755
new mode 100644
index e182ef1..c902ee2
--- a/src/concepts/layer-groups.xml
+++ b/src/concepts/layer-groups.xml
@@ -9,6 +9,13 @@
<sect1 id="gimp-layer-groups">
<title>Layer Groups</title>
+
+ <indexterm>
+ <primary>Layer groups</primary>
+ </indexterm>
+ <indexterm>
+ <primary>Pass Through</primary>
+ </indexterm>
<para>
This possibility appeared with <acronym>GIMP-2.8</acronym>.
@@ -100,7 +107,26 @@
</para>
</listitem>
</varlistentry>
-
+
+ <varlistentry>
+ <term>Visibility</term>
+ <listitem>
+ <para>
+ If a layer group is made invisible using the eye icon but still open
+ (so that the layers inside the group are shown in the list), there is
+ a struck out eye shown besides the layers that are inside the
+ group to indicate that these layers are not displayed in the final
+ projection of the image, but theoretically visible in the layer group.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/dialogs/layer-group-visibility.png"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term>Raise and Lower Layer Groups</term>
<listitem>
@@ -213,7 +239,29 @@
</para>
</caption>
</mediaobject>
- </figure>
+ </figure>
+
+ <para>
+ Since GIMP-2.10, layer groups have a special layer mode: the
+ <guilabel>Pass Through</guilabel> mode. This mode exists only if a
+ layer group is active.
+ </para>
+ <para>
+ When this mode is used instead of any other one, layers inside the
+ layer group will behave as if they were a part of the layer stack,
+ not belonging to the group. Layers within the group blend with layers
+ below, inside and outside the group.
+ </para>
+ <para>
+ While with Normal mode, layers within a group are treated as if they
+ were a single layer, which is then blended with other layers below in
+ the stack; a modifier on a layer inside the group blends layers below
+ in the group only.
+ </para>
+ <para>
+ More details about Pass Through in
+ <xref linkend="glossary-pass-through"/>.
+ </para>
</listitem>
</varlistentry>
@@ -231,9 +279,14 @@
<term>Layer Mask</term>
<listitem>
<para>
- You cannot add a layer mask to a layer group (the corresponding
- option is grayed out). But, as with normal layers, you can add a layer
- mask to a layer in the group to mask a part of the layer.
+ Since GIMP-2.10, masks on layer groups are possible. They work
similarly to
+ ordinary-layer masks, with the following considerations.
+ </para>
+ <para>
+ The group’s mask size is the same as group’s size (i.e., the bounding
box of its children) at all times. When the group’s size changes, the mask is cropped to the new size — areas
of the mask that fall outside of the new bounds are discarded, and newly added areas are filled with black
(and hence are transparent by default).
+ </para>
+ <para>
+ Of course, you still can add a layer mask to a layer in the group to
mask a part of the layer:
</para>
<mediaobject>
<imageobject>
diff --git a/src/glossary/glossary.xml b/src/glossary/glossary.xml
index c6e12c8..c8bc9c4 100644
--- a/src/glossary/glossary.xml
+++ b/src/glossary/glossary.xml
@@ -1637,6 +1637,120 @@ https://git.gnome.org/browse/gimp-help-2/tree/docs folder-->
</para>
</glossdef>
</glossentry>
+
+ <glossentry id="glossary-pass-through">
+ <glossterm>
+ <phrase>Pass-through</phrase>
+ </glossterm>
+ <glossdef>
+ <para>
+ Normally, the layers inside a layer group are isolated from the rest of
+ the image -- the layer group is essentially a separate sub-image,
+ living inside the bigger image; you can merge the group into a single
+ layer, replace the original group with it, and the result would be the
+ same.
+ </para>
+ <para>
+ In following examples, the names of the relevant layers in the images
+ specify the layer mode, with the composite mode in parentheses where
+ applicable, and the layer's opacity.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+fileref="images/dialogs/examples/layer-groups-pass-through-ex1.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ In this example, the group uses Normal mode; note that the
green
+ and blue layers don't affect the red layer: the green layer's
color
+ isn't added to the the red layer's color, and the blue layer
only
+ erases the green layer.
+ </para>
+ </caption>
+ </mediaobject>
+
+ <para>
+ Layer groups using Pass-through mode are different: the layers inside
+ them <quote>see</quote> the layers below the group, and interact with
+ them according to their layer mode.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+fileref="images/dialogs/examples/layer-groups-pass-through-ex2.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ In this example, the group uses Pass-through mode. Note that
the
+ green layer's color <emphasis>is</emphasis> added to the red
+ layer's color, and the blue layer erases both the green and
the red
+ layers.
+ </para>
+ </caption>
+ </mediaobject>
+
+ <para>
+ In simple cases, pass-through groups behave as though there is no group
+ involved at all.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+fileref="images/dialogs/examples/layer-groups-pass-through-ex3.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ The green and blue layers are not inside a group, and the
result is
+ the same as in the preceding example.
+ </para>
+ </caption>
+ </mediaobject>
+ <para>
+ In these cases, the group is primarily an organizational tool: it
+ allows you to group together several layers, achieving some desired
+ effect, and handle them as a unit.
+ </para>
+
+ <para>
+ However, in general, pass-through groups are not equivalent to having
+ no group at all. For example, when the group's opacity is less than
+ 100%, pass-through groups still behave as a single unit, applying the
+ opacity to the group as a whole (like a normal group would) rather than
+ to the individual layers, while still letting the group layers interact
+ with the background layers.
+ </para>
+ <figure><title>Three images</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+fileref="images/dialogs/examples/layer-groups-pass-through-ex4.png"/>
+ </imageobject>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+fileref="images/dialogs/examples/layer-groups-pass-through-ex5.png"/>
+ </imageobject>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+fileref="images/dialogs/examples/layer-groups-pass-through-ex6.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Compare these three images, which demonstrate the same compositions as
+ above, with the group (or the individual layers, in the last example)
+ having an opacity of 50%. When using pass-through groups to group
+ together several layers achieving a collective effect, the group's
+ opacity essentially lets you control the <quote>strength</quote> of the
+ effect, which can't be achieved using either normal groups, or
+ individual layers.
+ </para>
+ </glossdef>
+ </glossentry>
<glossentry id="glossary-path">
<glossterm>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
