GNOME.org
 

[gimp-help/gimp-help-2-10] Fix #347 Incorrect change in layer group examples

commit 4d220f05e3610eb9b938312aa1bc71a1f20be7e0
Author: Jacob Boerema <jgboerema gmail com>
Date:   Sat Sep 10 21:40:05 2022 -0400

    Fix #347 Incorrect change in layer group examples
    
    We correct and update the layer groups documentation.
    The layer mode Saturation, used in the example, did not exist anymore.
    We replace it with the closest similar mode HSL Color.
    Also add the xcf used to create the sample images.

 images/C/dialogs/layer-group-mask.png      | Bin 8357 -> 20164 bytes
 images/C/dialogs/layer-group-merge-in.png  | Bin 7985 -> 24128 bytes
 images/C/dialogs/layer-group-merge-out.png | Bin 7917 -> 23952 bytes
 images/C/dialogs/layer-group-original.png  | Bin 2867 -> 4628 bytes
 images/C/dialogs/layer-group.png           | Bin 9673 -> 17390 bytes
 src/concepts/layer-groups.xml              | 100 +++++++++++++++--------------
 src/images/dialogs/layer-groups.xcf        | Bin 0 -> 16626 bytes
 7 files changed, 52 insertions(+), 48 deletions(-)
---
diff --git a/images/C/dialogs/layer-group-mask.png b/images/C/dialogs/layer-group-mask.png
index 81dd9bb39..54c286f63 100644
Binary files a/images/C/dialogs/layer-group-mask.png and b/images/C/dialogs/layer-group-mask.png differ
diff --git a/images/C/dialogs/layer-group-merge-in.png b/images/C/dialogs/layer-group-merge-in.png
index 2af817a72..4ec8acfaf 100644
Binary files a/images/C/dialogs/layer-group-merge-in.png and b/images/C/dialogs/layer-group-merge-in.png 
differ
diff --git a/images/C/dialogs/layer-group-merge-out.png b/images/C/dialogs/layer-group-merge-out.png
index 4e6b2b48f..bf2bf0526 100644
Binary files a/images/C/dialogs/layer-group-merge-out.png and b/images/C/dialogs/layer-group-merge-out.png 
differ
diff --git a/images/C/dialogs/layer-group-original.png b/images/C/dialogs/layer-group-original.png
index 90e0c82a4..8d2514a87 100644
Binary files a/images/C/dialogs/layer-group-original.png and b/images/C/dialogs/layer-group-original.png 
differ
diff --git a/images/C/dialogs/layer-group.png b/images/C/dialogs/layer-group.png
index 4df8c79f3..b6a161396 100644
Binary files a/images/C/dialogs/layer-group.png and b/images/C/dialogs/layer-group.png differ
diff --git a/src/concepts/layer-groups.xml b/src/concepts/layer-groups.xml
index 1b790b7bf..b58d1c10b 100644
--- a/src/concepts/layer-groups.xml
+++ b/src/concepts/layer-groups.xml
@@ -21,12 +21,9 @@
   </indexterm>
 
   <para>
-    This possibility appeared with <acronym>GIMP-2.8</acronym>.
-  </para>
-
-  <para>
-    You can group layers that have similarities in a tree-like way. So, the
-    layer list becomes easier to manage.
+    <quote>Layer Groups</quote> enable you to group layers together in a
+    hierarchical structure. This will make it easier to manage your project
+    if you have many layers.
   </para>
 
   <mediaobject>
@@ -41,12 +38,10 @@
       <term>Create a Layer Group</term>
       <listitem>
         <para>
-          You can create a layer group by clicking on the
-          <guibutton>Create a new layer group</guibutton><guiicon></guiicon>
-          button at the bottom of the layer dialog,
-        </para>
-        <para>
-          through
+          You can create a layer group by clicking the
+          <guibutton>New Layer Group</guibutton> button at the bottom of the
+          <ulink url="gimp-layer-dialog">Layers Dialog</ulink>,
+          by using the menu command
           <menuchoice>
             <guimenu>Layer</guimenu>
             <guimenuitem>New Layer Group</guimenuitem>
@@ -54,16 +49,18 @@
           or through the layer dialog context menu.
         </para>
         <para>
-          This empty layer group appears just above the current layer. It is
-          important to give it an evocative name (double-click or
-          <keycap>F2</keycap> on the name, or use <command>Edit Layer
-          Attributes</command> in the context menu you get by right clicking the
-          Layer dialog, to edit it), else you will get confused when several
-          ones are created.
+          This new empty layer group appears just above the current layer. It is
+          recommended to give it a descriptive name. To change the layer group
+          name, double-click the name, press <keycap>F2</keycap>, or
+          right-click the layer and select
+          <command>Edit Layer Attributes</command> from the context menu.
+          If you don't rename your layer groups, you can get confused when
+          several groups have been created with names such as Layer Group #1,
+          Layer Group #2, etc.
         </para>
         <para>
-          You can create several layer groups and you can
-          <emphasis role= "bold">embbed</emphasis> them, that is include a
+          You can create multiple layer groups and you can
+          <emphasis role="bold">embed</emphasis> them, that is include a
           layer group in another one.
         </para>
       </listitem>
@@ -81,21 +78,21 @@
               before releasing the mouse button.
             </para>
             <para>
-              A thin horizontal line marks where the layer will be laid
-              down.
+              A thin horizontal line marks where the layer will be inserted.
             </para>
           </note>
         </para>
         <para>
           To add a <emphasis>new layer</emphasis> to the current layer
           group,
-          click on the <guibutton>Create a new layer</guibutton> at the
-          bottom of the layer dialog, or use the
-          <guimenuitem>New Layer</guimenuitem> command in the image menu.
+          click the <guibutton>New Layer...</guibutton> button at the
+          bottom of the Layers dialog, use the
+          <guimenuitem>New Layer...</guimenuitem> command in the image menu,
+          or press <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>N</keycap></keycombo>.
         </para>
         <para>
-          When a layer group is not empty, a small <quote>></quote> icon
-          appears. By clicking on it, you can fold/unfold the layer list.
+          When a layer group is not empty, a small icon appears. By clicking
+          it, you can fold or unfold the group.
           <mediaobject>
             <imageobject>
               <imagedata format="PNG"
@@ -105,7 +102,7 @@
         </para>
         <para>
           Layers that belong to a layer group are slightly indented to the
-          right, allowing you know easily which layers are part of the
+          right, allowing you to easily see which layers are part of the
           group.
         </para>
       </listitem>
@@ -190,7 +187,7 @@
         <para>
           When a layer group is activated, you can add another group inside
           it with the <quote>Add New Layer Group</quote> command. There
-          seems to be no limit, excepted memory, to the number of embedded
+          seems to be no limit, except memory, to the number of embedded
           layer groups.
         </para>
       </listitem>
@@ -225,7 +222,7 @@
             <caption>
               <para>
                 We added a white layer <emphasis>in</emphasis> the layer group
-                with saturation mode: only square and triangle are grayed out.
+                with HSL Color mode: only the square and triangle turned gray.
               </para>
             </caption>
           </mediaobject>
@@ -236,16 +233,16 @@
             </imageobject>
             <caption>
               <para>
-                We added a white layer <emphasis>out</emphasis> of the layer
-                group with saturation mode: all layers underneath are grayed
-                out, background layer also.
+                We added a white layer <emphasis>outside</emphasis> and above
+                the layer group with HSL Color mode: all layers underneath
+                changed to gray, including the background layer.
               </para>
             </caption>
           </mediaobject>
         </figure>
         
         <para>
-          Since GIMP-2.10, layer groups have a special layer mode: the 
+          Since <acronym>GIMP</acronym> 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>
@@ -282,15 +279,17 @@
       <term>Layer Mask</term>
       <listitem>
         <para>
-                                       Since GIMP-2.10, masks on layer groups are possible. They work 
similarly to 
-                                       ordinary-layer masks, with the following considerations.
+          Since <acronym>GIMP</acronym> 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).
+          The layer group’s mask size is the same as the combined size of all
+          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>
             <imagedata format="PNG"
@@ -298,10 +297,15 @@
           </imageobject>
           <caption>
             <para>
-              We added a white (Full opacity) layer mask to the triangle layer.
+              We added a black (transparent) layer mask to the layer group,
+              making the layers inside the group transparent (invisible).
             </para>
           </caption>
         </mediaobject>
+        <para>
+          Of course, you still can add a layer mask to a layer in the group to
+          mask a part of the layer.
+        </para>
       </listitem>
     </varlistentry>
     
@@ -310,11 +314,11 @@
       <listitem>
         <para>
           When working with a lot of layers, finding a particular layer in the 
-          list may be difficult. With GIMP-2.10.10, a new 
-          <emphasis>on-canvas layer selection</emphasis> function appeared. 
-          <keycombo><keycap>Alt</keycap><keycap>Middle click</keycap>
+          list can be difficult. Since <acronym>GIMP</acronym> 2.10.10, a new 
+          <emphasis>on-canvas layer selection</emphasis> function is available. 
+          Use <keycombo><keycap>Alt</keycap><keycap>Middle click</keycap>
           </keycombo> on the image element you want to find the layer this 
-          element belongs to: the available layers will be looped through to 
+          element belongs to. The available layers will be looped through to 
           show the new active layer and the layer name will be temporarily 
           displayed in the status bar.
         </para>
@@ -324,9 +328,9 @@
       <term>Layer preview</term>
       <listitem>
         <para>
-          There has been problems with drawable preview rendering in case of 
-          many layers in a large image. This is fixed now, except for layer 
-          groups. You can disable rendering layer group previews in 
+          There have been problems with slow preview rendering of layer
+          groups in case of many layers in a large image. If you are
+          experiencing this, you can disable rendering layer group previews in 
           <menuchoice>
             <guimenu>Edit</guimenu>
             <guisubmenu>Preferences</guisubmenu>
diff --git a/src/images/dialogs/layer-groups.xcf b/src/images/dialogs/layer-groups.xcf
new file mode 100644
index 000000000..516f82c81
Binary files /dev/null and b/src/images/dialogs/layer-groups.xcf differ
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]