[gimp-help] Add 3D-transform.xml



commit c24f0f704e0d518718cb5698466be89d56ccf9f8
Author: Julien Hardelin <jhardlin orange fr>
Date:   Thu Mar 19 18:43:02 2020 +0100

    Add 3D-transform.xml

 images/C/toolbox/3DTransf-linked.jpg      | Bin 0 -> 58634 bytes
 images/C/toolbox/3DTransf-no.jpg          | Bin 0 -> 16891 bytes
 images/C/toolbox/3DTransf-orig.jpg        | Bin 0 -> 22405 bytes
 images/C/toolbox/3DTransf-with.jpg        | Bin 0 -> 16730 bytes
 images/C/toolbox/3DTransform-dialog.png   | Bin 0 -> 30722 bytes
 src/appendix/history-2.10.xml             |  97 +++++++++++++---
 src/introduction/whats-new.xml            |  11 +-
 src/toolbox/intro.xml                     |   4 +
 src/toolbox/transform-tools.xml           |   2 +
 src/toolbox/transform/3D-transform.xml    | 186 ++++++++++++++++++++++++++++++
 src/toolbox/transform/common-features.xml | 119 ++++++++++++++++++-
 11 files changed, 392 insertions(+), 27 deletions(-)
---
diff --git a/images/C/toolbox/3DTransf-linked.jpg b/images/C/toolbox/3DTransf-linked.jpg
new file mode 100644
index 000000000..7eeb88195
Binary files /dev/null and b/images/C/toolbox/3DTransf-linked.jpg differ
diff --git a/images/C/toolbox/3DTransf-no.jpg b/images/C/toolbox/3DTransf-no.jpg
new file mode 100644
index 000000000..3721b3bca
Binary files /dev/null and b/images/C/toolbox/3DTransf-no.jpg differ
diff --git a/images/C/toolbox/3DTransf-orig.jpg b/images/C/toolbox/3DTransf-orig.jpg
new file mode 100644
index 000000000..9a0863868
Binary files /dev/null and b/images/C/toolbox/3DTransf-orig.jpg differ
diff --git a/images/C/toolbox/3DTransf-with.jpg b/images/C/toolbox/3DTransf-with.jpg
new file mode 100644
index 000000000..8ff366819
Binary files /dev/null and b/images/C/toolbox/3DTransf-with.jpg differ
diff --git a/images/C/toolbox/3DTransform-dialog.png b/images/C/toolbox/3DTransform-dialog.png
new file mode 100644
index 000000000..79c009ecd
Binary files /dev/null and b/images/C/toolbox/3DTransform-dialog.png differ
diff --git a/src/appendix/history-2.10.xml b/src/appendix/history-2.10.xml
index 28729c23b..f09d06d66 100644
--- a/src/appendix/history-2.10.xml
+++ b/src/appendix/history-2.10.xml
@@ -20,6 +20,8 @@
 
  <variablelist id="gimp-introduction-whats-new-ui">
     <title>Updated user interface and initial HiDPI support</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       One thing immediately noticeable about GIMP 2.10 is the new dark theme and
       symbolic icons enabled by default. This is meant to somewhat dim the
@@ -48,10 +50,14 @@
       <emphasis>Contributors:</emphasis> Benoit Touchette, Klaus Staedtler,
       Ville Pätsi, Aryeom Han, Jehan Pagès, Alexandre Prokoudine…
     </para>
+    </listitem>
+    </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-gegl-port">
     <title>GEGL port, high bit depth support, multi-threading, and more</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       The ultimate goal for v2.10 was completing the port to GEGL image
       processing library, started with v2.6 when we introduced optional use of
@@ -97,10 +103,14 @@
       <emphasis>Contributors:</emphasis> Michael Natterer, Øyvind Kolås, Ell,
       Jehan Pagès…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-linear-color-space-workflow">
     <title>Linear color space workflow</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       Another benefit of using GEGL is being able to work on images in a linear
       RGB color space as opposed to gamma-corrected (perceptual) RGB color space.
@@ -168,16 +178,20 @@
     <para>
       <emphasis>Contributors:</emphasis> Michael Natterer, Øyvind Kolås, Ell…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-cms">
     <title>Color management revamped</title>
-    <para>
-      Color management is now a core feature of GIMP rather than a plug-in. This
-      made it possible, in particular, to introduce color management to all
-      custom widgets we could think of: image previews, color and pattern
-      previews etc.
-    </para>
+    <varlistentry><term> </term>
+    <listitem>
+      <para>
+        Color management is now a core feature of GIMP rather than a plug-in. This
+        made it possible, in particular, to introduce color management to all
+        custom widgets we could think of: image previews, color and pattern
+        previews etc.
+      </para>
 <!--         <figure>
       <title>FIXME</title>
       <mediaobject>
@@ -187,20 +201,24 @@
         </imageobject>
       </mediaobject>
     </figure> -->
-    <para>
-      GIMP now uses LittleCMS v2, which allows it to use ICC v4 color profiles.
-      It also partially relies on the babl library for handling color
-      transforms, since babl is simply up to 10 times faster than LCMS2 for the
-      cases we tested both of them on. Eventually babl could replace LittleCMS
-      in GIMP.
-    </para>
-    <para>
-      <emphasis>Contributors:</emphasis> Michael Natterer, Øyvind Kolås…
-    </para>
+      <para>
+        GIMP now uses LittleCMS v2, which allows it to use ICC v4 color profiles.
+        It also partially relies on the babl library for handling color
+        transforms, since babl is simply up to 10 times faster than LCMS2 for the
+        cases we tested both of them on. Eventually babl could replace LittleCMS
+        in GIMP.
+      </para>
+      <para>
+        <emphasis>Contributors:</emphasis> Michael Natterer, Øyvind Kolås…
+      </para>
+    </listitem>
+    </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-layers-masks">
     <title>Layers and masks</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       GIMP now ships with two groups of blending modes: legacy (perceptual,
       mostly to make old XCF files look exactly as before) and default (mostly
@@ -272,10 +290,14 @@
         </imageobject>
       </mediaobject>
     </figure> -->
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-lab-lch">
     <title>More use for CIE LAB and CIE LCH</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       With GIMP 2.10, we introduced a number of features that make use of CIE
       LAB and CIE LCH color spaces:
@@ -314,11 +336,12 @@
     <para>
       <emphasis>Contributors:</emphasis> Michael Natterer, Elle Stone, Ell…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-tools">
     <title>New and improved tools</title>
-
     <varlistentry id="gimp-introduction-whats-new-tools-unified-transform">
       <term>Unified Transform</term>
       <listitem>
@@ -593,6 +616,8 @@ selections of foreground objects, particularly things like find hairs.</title>
 
   <variablelist id="gimp-introduction-whats-new-painting">
     <title>Digital painting improvements</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       GIMP 2.10 ships with a number of improvements requested by digital
       painters. One of the most interesting new additions here is the
@@ -653,10 +678,14 @@ selections of foreground objects, particularly things like find hairs.</title>
       <emphasis>Contributors:</emphasis> Michael Natterer, Alexia Death, Daniel
       Sabo, shark0r, Jehan Pagès, Ell, Jose Americo Gobbo, Aryeom Han…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-photography">
     <title>Digital photography improvements</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       Some of the new GEGL-based filters are specifically targeted at
       photographers: <emphasis>Exposure</emphasis>,
@@ -705,10 +734,14 @@ selections of foreground objects, particularly things like find hairs.</title>
       <emphasis>Contributors:</emphasis> Michael Natterer, Ell, Thomas Manni,
       Tobias Ellinghaus, Øyvind Kolås, Jehan Pagès, Alberto Griggio…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-effects">
     <title>Effects</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       GIMP now ships with over <emphasis>80</emphasis> GEGL-based filters. A lot
       of those are former GIMP effects.  Here is why GEGL-based implementations
@@ -760,10 +793,14 @@ selections of foreground objects, particularly things like find hairs.</title>
       <emphasis>Contributors:</emphasis> Michael Natterer, Øyvind Kolås, Thomas
       Manni…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-usability">
     <title>Usability improvements</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       While working with active users, we got rid of quite a few usability
       issues. Here are just some of these changes:
@@ -814,10 +851,14 @@ selections of foreground objects, particularly things like find hairs.</title>
       <emphasis>Contributors:</emphasis> Michael Natterer, Daniel Sabo, Benoit
       Touchette, Massimo Valentini, Jehan Pagès…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-file-formats">
     <title>File formats support</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       GIMP is now capable of reading and writing TIFF, PNG, PSD, and FITS files
       with up to 32-bit per channel precision where applicable.
@@ -847,10 +888,14 @@ selections of foreground objects, particularly things like find hairs.</title>
       <emphasis>Contributors:</emphasis> Michael Natterer, Mukund Sivamaran,
       Ell, Jehan Pagès, Lionel N, Darshan Kadu…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-metadata">
     <title>Metadata viewing, editing, and preservation</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       GIMP now ships with plug-ins for viewing and editing Exif, XMP, IPTC, GPS,
       and DICOM metadata. They are available via the
@@ -884,10 +929,14 @@ selections of foreground objects, particularly things like find hairs.</title>
       <emphasis>Contributors:</emphasis> Benoit Touchette, Michael Natterer,
       Jehan Pagès…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-painting-on-canvas-interaction">
     <title>On-canvas interaction</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       GIMP 2.10 ships with a new feature that allows some GEGL-based filters to
       render on-canvas controls. For now, this applies to just three filters:
@@ -907,10 +956,14 @@ selections of foreground objects, particularly things like find hairs.</title>
     <para>
       <emphasis>Contributors:</emphasis> Michael Natterer, Ell…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-bug-reporting-recovery">
     <title>Simplified bug reporting and crash recovery</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       We need good bug reports to make GIMP better for you, so we introduced a
       new feature to watch and intercept critical errors and crashes, then
@@ -961,10 +1014,14 @@ selections of foreground objects, particularly things like find hairs.</title>
     <para>
       <emphasis>Contributors:</emphasis> Jehan Pagès…
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-api">
     <title>API changes</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       Over the course of this development cycle, we deprecated a lot of API,
       providing a compatibility layer for 3rd party developers who write scripts
@@ -975,10 +1032,14 @@ selections of foreground objects, particularly things like find hairs.</title>
       <ulink url="https://wiki.gimp.org/wiki/Release:2.10_changelog#API_Changes";>see the wiki</ulink>.
       This ChangeLog page also has a verbose list of all other changes in 2.10.
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 
   <variablelist id="gimp-introduction-whats-new-roadmap">
     <title>Roadmap and what's next</title>
+    <varlistentry><term> </term>
+    <listitem>
     <para>
       We maintain a <ulink url="http://wiki.gimp.org/index.php/Roadmap";>roadmap
       for GIMP development</ulink> that outlines the order of features to be
@@ -999,5 +1060,7 @@ selections of foreground objects, particularly things like find hairs.</title>
     <para>
       All the new features from 2.10.x will be part of 3.0 as well.
     </para>
+  </listitem>
+  </varlistentry>
   </variablelist>
 </sect1>
diff --git a/src/introduction/whats-new.xml b/src/introduction/whats-new.xml
index d739801da..55a3d7425 100644
--- a/src/introduction/whats-new.xml
+++ b/src/introduction/whats-new.xml
@@ -14,18 +14,20 @@
     <itemizedlist>
       <listitem>
         <para>
-          Tools are now grouped in the toolbox by default.
+          Tools are now grouped in the toolbox by default: 
+            <xref linkend="gimp-toolbox-icons"/>.
         </para>
       </listitem>
       <listitem>
         <para>
-          Sliders now use a compact style with improved user interaction: refer to 
+          Sliders now use a compact style with improved user interaction: 
             <xref linkend="sliders"/>.
         </para>
       </listitem>
       <listitem>
         <para>
-          Vastly improved user experience for the transformation preview.
+          Vastly improved user experience for the transformation preview:
+          <xref linkend="composited-preview"/>.
         </para>
       </listitem>
       <listitem>
@@ -35,7 +37,8 @@
       </listitem>
       <listitem>
         <para>
-          New 3D Transform tool to rotate and pan items.
+          New 3D Transform tool to rotate and pan items: 
+            <xref linkend="gimp-tool-3Dtransform"/>.
         </para>
       </listitem>
       <listitem>
diff --git a/src/toolbox/intro.xml b/src/toolbox/intro.xml
index 698c784d7..44a40ff9d 100644
--- a/src/toolbox/intro.xml
+++ b/src/toolbox/intro.xml
@@ -11,6 +11,10 @@
   <indexterm>
     <primary>Toolbox</primary>
   </indexterm>
+  <indexterm>
+    <primary>Tools</primary>
+    <secondary>Tool groups</secondary>
+  </indexterm>
 
   <sect2 id="gimp-toolbox-introduction">
     <title>Introduction</title>
diff --git a/src/toolbox/transform-tools.xml b/src/toolbox/transform-tools.xml
index f1107bd2a..481eeebf4 100644
--- a/src/toolbox/transform-tools.xml
+++ b/src/toolbox/transform-tools.xml
@@ -2,6 +2,7 @@
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
+  2020-03-16 j.h: add 3D Transform
   2017-05-06 j.h: add Unified transform
   2017-06-18 j.h: add Warp transform
   2017-07-22 j.h: add Handle Transform
@@ -31,6 +32,7 @@
   <xi:include href="transform/scale.xml"/>
   <xi:include href="transform/shear.xml"/>
   <xi:include href="transform/perspective.xml"/>
+  <xi:include href="transform/3D-transform.xml"/>
   <xi:include href="transform/unified-transform.xml"/>
   <xi:include href="transform/handle-transform.xml"/>
   <xi:include href="transform/flip.xml"/>
diff --git a/src/toolbox/transform/3D-transform.xml b/src/toolbox/transform/3D-transform.xml
new file mode 100644
index 000000000..a389674a6
--- /dev/null
+++ b/src/toolbox/transform/3D-transform.xml
@@ -0,0 +1,186 @@
+<?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:
+  2020-03-10 j.h: Fist version
+ -->
+
+<sect2 id="gimp-tool-3Dtransform">
+  <title>3D Transform</title>
+
+  <indexterm>
+    <primary>Tools</primary>
+    <secondary>3D Transform</secondary>
+  </indexterm>
+  <indexterm><primary>3D Transform</primary></indexterm>
+
+  <para>
+    The 3D Transform tool allows you to change the perspective of a layer and 
+    to move it in 3D space. You can set a vanishing point, then rotate the 
+    layer in X, Y, an Z axes.
+  </para>
+  <para>
+    It offers the usual option dialog under Toolbox and an on-canvas settings 
+    dialog.
+  </para>
+  
+  <sect3>
+    <title>
+      <phrase>Activating the Tool</phrase>
+    </title>
+
+    <para>
+      There are different possibilities to activate the tool:
+    </para>
+
+    <itemizedlist>
+      <listitem>
+        <para>
+          From the image-menu:
+          <menuchoice>
+            <guimenu>Tools</guimenu>
+            <guisubmenu>Transform Tools</guisubmenu>
+            <guimenuitem>3D Transform</guimenuitem>
+          </menuchoice>
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          The Tool can also be called by clicking the tool icon in Toolbox:
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject>
+                <imagedata 
+                fileref="images/toolbox/3DTransform-icon.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon>
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          or by clicking on the 
+          <keycombo><keycap>Shift</keycap><keycap>W</keycap></keycombo> 
+          keyboard shortcut.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+  
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title>3D Transform Tool Options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/toolbox/3DTransform-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+
+    <para>
+      The available tool options can be accessed by double clicking the
+      Unified Transform tool icon:
+      <guiicon>
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata 
+            fileref="images/toolbox/3DTransform-icon.png"/>
+          </imageobject>
+        </inlinemediaobject>
+      </guiicon>
+    </para>
+      
+    <variablelist>
+      <varlistentry>
+        <term>Shared options</term>
+        <listitem>
+          <note>
+            <para>
+              See <xref linkend="gimp-tool-transform" /> for a description of 
+              tool options that apply to many or all transform tools:
+              <itemizedlist>
+                <listitem>
+                  <para>
+                    <link linkend="transform-option">Transform</link>
+                  </para>
+                </listitem>
+                <listitem>
+                  <para>
+                    <link linkend="direction-option">Direction</link>
+                  </para>
+                </listitem>
+                <listitem>
+                  <para>
+            <link linkend="gimp-tool-interpolation-methods">Interpolation</link>
+                  </para>
+                </listitem>
+                <listitem>
+                  <para>
+                    <link linkend="clipping-option">Clipping</link>
+                  </para>
+                </listitem>
+                <listitem>
+                  <para>
+                    <link linkend="preview-option">Direction</link>
+                  </para>
+                </listitem>
+                <listitem>
+                  <para>
+                    <link linkend="composited-preview">Composited preview</link>
+                  </para>
+                </listitem>
+                <listitem>
+                  <para>
+                    <link linkend="gimp-tool-transform-guides">Guides</link>
+                  </para>
+                </listitem>
+              </itemizedlist>
+            </para>
+          </note>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Unified interaction</term>
+        <listitem>
+          <para>
+            This option allows shifting the vanishing, as well as panning and 
+            rotating without switching between tabs on the on-canvas settings 
+            dialog.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Constrain axis (Shift)</term>
+        <listitem>
+          <para>
+            When you press <keycap>Shift</keycap>, the present transformation axis 
+            becomes fixed in preview.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Z axis (Ctrl)</term>
+        <listitem>
+          <para>
+            When you press <keycap>Ctrl</keycap>, transformation is done around 
+            the Z axis.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Local frame (Alt)</term>
+        <listitem>
+          <para>
+            This option allows controlling the transformation in the layer local 
+            frame of reference (the current layer), instead of the global one (all 
+            layers).
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
diff --git a/src/toolbox/transform/common-features.xml b/src/toolbox/transform/common-features.xml
index 5b2444b8c..01d1c07ae 100644
--- a/src/toolbox/transform/common-features.xml
+++ b/src/toolbox/transform/common-features.xml
@@ -21,7 +21,7 @@
       them here. More specific options will be described with their tool.
     </para>
     <variablelist>
-      <varlistentry>
+      <varlistentry id="transform-option">
         <term>Transform</term>
         <listitem>
           <para>
@@ -111,7 +111,7 @@
           </itemizedlist>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      <varlistentry id="direction-option">
         <term>Direction</term>
         <listitem>
           <para>
@@ -234,7 +234,8 @@
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      
+      <varlistentry id="clipping-option">
         <term>Clipping</term>
         <listitem>
           <indexterm>
@@ -395,19 +396,125 @@
           </variablelist>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      
+      <varlistentry id="preview-option">
         <term>Show image preview</term>
         <listitem>
           <indexterm>
             <primary>Preview</primary>
             <secondary>Transformation tools</secondary>
-          </indexterm>         
+          </indexterm>
           <para>
             If this is marked, which is the default setting, the transformed
             image will be visible on top of the original image or layer. There 
             will also be a slider with which you may select the preview opacity.
           </para>
-        </listitem>    
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="composited-preview">
+        <term>Composited preview</term>
+        <listitem>
+          <indexterm>
+            <primary>Preview</primary>
+            <secondary>Composited preview</secondary>
+          </indexterm> 
+          <para>
+          <para>
+            <subscript>
+              Inspired from 
+              <ulink                   
+    url="https://libregraphicsworld.org/blog/entry/gimp-2-10-18-full-review"/>
+            </subscript>
+          </para>
+          </para>
+          <para>
+            <emphasis>Show preview as part of the image composition</emphasis>: 
+            when you have multiple layers, each one with its own blending mode   
+            and opacity, transforming it means it pops up right above every 
+            other layer. So in a complex layers composition you can't align 
+            this layer against other layers without much trial and error.
+          </para>
+          <para>
+            The new Composited Preview option removes this problem in favor 
+            of rendering the preview of the transformed layer exactly where it 
+            is in the layers stack, exactly with the opacity and blending mode 
+            of choice.
+          </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="images/toolbox/3DTransf-orig.jpg" 
+    format="JPEG"/>
+            </imageobject>
+            <caption>
+              <para>Original image: red layer opacity is 50%</para>
+            </caption>
+          </mediaobject>
+          <figure>
+            <title>Composited Preview Example</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata fileref="images/toolbox/3DTransf-no.jpg" 
+      format="JPEG"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Composited option unchecked: in preview, red layer is above 
+                  all other layers.
+                </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata fileref="images/toolbox/3DTransf-with.jpg" 
+      format="JPEG"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Composited option checked: in preview, red layer is at its 
+                  right place, like in layer stack.
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>
+          <para>
+            Two sub options are available:
+            <itemizedlist>
+              <listitem>
+                <para>
+                  <guilabel>Preview linked items</guilabel>: display 
+                  transformation of all linked layers rather than the currently 
+                  selected one.
+                </para>
+                <mediaobject>
+                  <imageobject>
+                    <imagedata fileref="images/toolbox/3DTransf-linked.jpg" 
+          format="JPEG"/>
+                  </imageobject>
+                  <caption>
+                    <para>Two layers linked</para>
+                  </caption>
+                </mediaobject>
+              </listitem>
+              <listitem>
+                <para>
+                  <guilabel>Synchronous preview</guilabel>: this option is 
+                  experimental. The idea is to render the preview as soon as 
+                  you change the transform. So instead of waiting for the mouse 
+                  to stop moving, it renders the result immediately. If GIMP 
+                  can render everything fast enough, this means a much smoother 
+                  and more instant feedback.
+                </para>
+                <para>
+                  But this option also blocks everything until the preview is 
+                  done rendering. This means, GIMP can become much less 
+                  responsive, usually when the layer is very large. That's why 
+                  this is disabled by default.
+                </para>
+              </listitem>
+            </itemizedlist>
+          </para>
+        </listitem>
       </varlistentry>
       
       <varlistentry id="gimp-tool-transform-guides">


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