[gimp-help-2] Add layer-groups.xml



commit b8478e84d554edf8272dc077938eb31ff0629a36
Author: Julien Hardelin <jm hard wanadoo fr>
Date:   Thu Mar 8 07:44:37 2012 +0100

    Add layer-groups.xml

 images/C/dialogs/fold-unfold.png           |  Bin 0 -> 2112 bytes
 images/C/dialogs/layer-group-mask.png      |  Bin 0 -> 24305 bytes
 images/C/dialogs/layer-group-merge-in.png  |  Bin 0 -> 22542 bytes
 images/C/dialogs/layer-group-merge-out.png |  Bin 0 -> 22264 bytes
 images/C/dialogs/layer-group-original.png  |  Bin 0 -> 4680 bytes
 images/C/dialogs/layer-group.png           |  Bin 0 -> 27179 bytes
 src/concepts/layer-groups.xml              |  254 ++++++++++++++++++++++++++++
 src/gimp.xml                               |    3 +-
 8 files changed, 256 insertions(+), 1 deletions(-)
---
diff --git a/images/C/dialogs/fold-unfold.png b/images/C/dialogs/fold-unfold.png
new file mode 100755
index 0000000..5e59047
Binary files /dev/null and b/images/C/dialogs/fold-unfold.png differ
diff --git a/images/C/dialogs/layer-group-mask.png b/images/C/dialogs/layer-group-mask.png
new file mode 100755
index 0000000..72b3432
Binary files /dev/null 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
new file mode 100755
index 0000000..9b644d0
Binary files /dev/null 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
new file mode 100755
index 0000000..ad4c21b
Binary files /dev/null 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
new file mode 100755
index 0000000..b5a85dc
Binary files /dev/null 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
new file mode 100755
index 0000000..65dd5f9
Binary files /dev/null and b/images/C/dialogs/layer-group.png differ
diff --git a/src/concepts/layer-groups.xml b/src/concepts/layer-groups.xml
new file mode 100755
index 0000000..8fe818a
--- /dev/null
+++ b/src/concepts/layer-groups.xml
@@ -0,0 +1,254 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+
+<!--Section History
+  2012-03-06 j.h: created
+-->
+
+<sect1 id="gimp-layer-groups">
+  <title>Layer Groups</title>
+
+  <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. You can merge layer modes to the
+    group and make new creative effect possible.
+  </para>
+
+  <mediaobject>
+    <imageobject>
+      <imagedata format="PNG"
+        fileref="images/dialogs/layer-group.png"/>
+    </imageobject>
+  </mediaobject>
+
+  <variablelist>
+    <varlistentry>
+      <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
+          <menuchoice>
+            <guimenu>Layer</guimenu>
+            <guimenuitem>New Layer Group</guimenuitem>
+          </menuchoice>,
+          or through the layer dialog context menu.
+        </para>
+        <para>
+          This empty layer group appears just above the current layer. It is
+          important to name it (double-click on the name to edit it), else
+          you will get confused when several ones are created.
+        </para>
+        <para>
+          You can create several layer groups and you can
+          <emphasis role= "bold">embbed</emphasis> them, that is include a
+          layer group in another one.
+        </para>
+      </listitem>
+    </varlistentry>
+
+    <varlistentry>
+      <term>Adding Layers to a Layer Group</term>
+      <listitem>
+        <para>
+          You can add <emphasis>existing layers</emphasis> to a layer group
+          by click-and-dragging them.
+          <note>
+            <para>
+              The hand representing the mouse pointer must turn smaller
+              before releasing the mouse button.
+            </para>
+            <para>
+              A thin horizontal line marks where the layer will be laid
+              down.
+            </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.
+        </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.
+          <mediaobject>
+            <imageobject>
+              <imagedata format="PNG"
+                fileref="images/dialogs/fold-unfold.png"/>
+            </imageobject>
+          </mediaobject>
+        </para>
+        <para>
+          You can put layers to be added together to a layer group by making
+          them, them only, visible, and using the <quote>New From Visible
+          </quote> command. All visible layers, outside and inside layer
+          groups, will be added to the active layer group.
+        </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
+          group.
+        </para>
+      </listitem>
+    </varlistentry>
+
+    <varlistentry>
+      <term>Raise and Lower Layer Groups</term>
+      <listitem>
+        <para>
+          You can raise and lower layer groups in the layer dialog as you do
+          with normal layers: click-and-dragging, using arrow up and down
+          keys at the bottom of the layer dialog.
+        </para>
+      </listitem>
+    </varlistentry>
+
+    <varlistentry>
+      <term>Duplicate a Layer Group</term>
+      <listitem>
+        <para>
+          You can duplicate a layer group: click on the
+          <guibutton>Create a duplicate of the layer</guibutton> button or
+          right-click and select the <command>Duplicate Layer</command>
+          command in the pop up context menu.
+        </para>
+      </listitem>
+    </varlistentry>
+
+    <varlistentry>
+      <term>Move Layer Groups</term>
+      <listitem>
+        <para>
+          You can <emphasis role="bold">move a layer group to another image
+          </emphasis> by click-and-dragging.
+          You can also copy-paste it using Ctrl-C and Ctrl-V: then, you get
+          a floating selection that you must anchor (anchor button at the
+          bottom of the layer dialog).
+        </para>
+        <para>
+          You can also <emphasis role="bold">move and duplicate a layer group
+          inside the canvas</emphasis>: chain all layers in the layer group,
+          activate the Move tool, click-and-drag an element of the layer
+          group in the image. That's a way to multiply objects in an image.
+        </para>
+      </listitem>
+    </varlistentry>
+    
+    <varlistentry>
+      <term>Delete a Layer Group</term>
+      <listitem>
+        <para>
+          To delete a layer group, click on the red cross button at the
+          bottom of the layer dialog or right-click and select <command>
+          Delete layer</command>.
+        </para>
+      </listitem>
+    </varlistentry>
+
+    <varlistentry>
+      <term>Embedd Layer Groups</term>
+      <listitem>
+        <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
+          layer groups.
+        </para>
+      </listitem>
+    </varlistentry>
+
+    <varlistentry>
+      <term>Layer Modes and Groups</term>
+      <listitem>
+        <para>
+          A layer inside a layer group acts on layers that are in this group
+          only. A layer above a layer group acts on all layers underneath,
+          outside and inside the layer groups.
+        </para>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/dialogs/layer-group-original.png"/>
+          </imageobject>
+          <caption>
+            <para>
+              Original image
+            </para>
+          </caption>
+        </mediaobject>
+        <figure>
+          <title>Layer Mode in or out Layer Group</title>
+          <mediaobject>
+            <imageobject>
+              <imagedata format="PNG"
+                fileref="images/dialogs/layer-group-merge-in.png"/>
+            </imageobject>
+            <caption>
+              <para>
+                We added a white layer <emphasis>in</emphasis> the layer group
+                with saturation mode: only square and triangle are grayed out.
+              </para>
+            </caption>
+          </mediaobject>
+          <mediaobject>
+            <imageobject>
+              <imagedata format="PNG"
+                fileref="images/dialogs/layer-group-merge-out.png"/>
+            </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.
+              </para>
+            </caption>
+          </mediaobject>
+        </figure>        
+      </listitem>
+    </varlistentry>
+
+    <varlistentry>
+      <term>Opacity</term>
+      <listitem>
+        <para>
+          When a layer group is activated, opacity changes are applied to all
+          the layers of the group.
+        </para>
+      </listitem>
+    </varlistentry>
+
+    <varlistentry>
+      <term>Layer Mask</term>
+      <listitem>
+        <para>
+          As with normal layers, you can add a layer mask to a layer in the
+          group to mask a part of the image.
+        </para>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/dialogs/layer-group-mask.png"/>
+          </imageobject>
+          <caption>
+            <para>
+              We added a white (Full opacity) layer mask to the triangle layer.
+            </para>
+          </caption>
+        </mediaobject>
+      </listitem>
+    </varlistentry>
+  </variablelist>
+
+</sect1>
diff --git a/src/gimp.xml b/src/gimp.xml
index 6e202ae..8ec61aa 100644
--- a/src/gimp.xml
+++ b/src/gimp.xml
@@ -2,6 +2,7 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!--  section history:
+  2012-03-06 j.h: add layer-groups.xml
   2009-02-21 j.h: removed using/docks.xml
   2009-02-15 ude: removed menu-xtns.xml
   2008-12-28 j.h: added menus-windows.xml
@@ -12,7 +13,6 @@
   2007-05-28 lexa: resolved the last issues from the reorganization
   2007-02-28 lexa: did a major reorganization of part I and II
   2007-01-07 lexa: updated copyright to 2007
-  2006-05-27 added norwegian translation by KoSt
   2006-03-12 lexa: made section docbook compliant
   2005-12-18 slightly reordered the introduction by lexa
   2005-12-12 moved GIMP history from introduction to appendix by lexa
@@ -123,6 +123,7 @@
       <xi:include href="concepts/layers.xml"/>
       <xi:include href="concepts/layer-modes.xml"/>
       <xi:include href="using/layers.xml"/>
+      <xi:include href="concepts/layer-groups.xml"/>
       <xi:include href="concepts/fonts-and-text.xml"/>
       <xi:include href="using/fonts-and-text.xml"/>
     </chapter>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]