GNOME.org
 

[gimp-help-2] Add handle-transform.xml

commit 1bc0d17edd7fae7e5ff198621a212afbd1a2b736
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Jul 23 08:00:36 2017 +0200

    Add handle-transform.xml

 docs/templates/tool_template.xml                   |    4 +-
 images/C/toolbox/handle-transform-ex-move.gif      |  Bin 0 -> 15845 bytes
 .../C/toolbox/handle-transform-ex-perspective.gif  |  Bin 0 -> 12701 bytes
 images/C/toolbox/handle-transform-ex-rotate.gif    |  Bin 0 -> 264276 bytes
 images/C/toolbox/handle-transform-ex-shear.gif     |  Bin 0 -> 6049 bytes
 images/C/toolbox/handle-transform-icon.png         |  Bin 0 -> 2720 bytes
 images/C/toolbox/handle-transform-options.png      |  Bin 0 -> 32242 bytes
 images/C/toolbox/handle-transform.png              |  Bin 0 -> 35076 bytes
 src/toolbox/transform-tools.xml                    |    2 +
 src/toolbox/transform/handle-transform.xml         |  236 ++++++++++++++++++++
 10 files changed, 240 insertions(+), 2 deletions(-)
---
diff --git a/docs/templates/tool_template.xml b/docs/templates/tool_template.xml
index 4b5ad3f..b55f667 100644
--- a/docs/templates/tool_template.xml
+++ b/docs/templates/tool_template.xml
@@ -3,7 +3,7 @@
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 
 <sect2 id="gimp-tool-toolname">
-  <title><!-- tool name --></title>
+  <title><!--tool name--></title>
 
   <indexterm>
     <primary>Tools</primary>
@@ -126,7 +126,7 @@ images -->
           warp-dialog-options.png for the the tool options dialog
           warp-list-methods.png for the method drop-down list
           warp-list-abyss.png for abyss drop-down list
-          warp ex-shrink-1.png for the first shrink example
+          warp-ex-shrink-1.png for the first shrink example
             -->
           <imagedata format="PNG"
             fileref="images/toolbox/tool-options-name.png"/>
diff --git a/images/C/toolbox/handle-transform-ex-move.gif b/images/C/toolbox/handle-transform-ex-move.gif
new file mode 100644
index 0000000..3d1d954
Binary files /dev/null and b/images/C/toolbox/handle-transform-ex-move.gif differ
diff --git a/images/C/toolbox/handle-transform-ex-perspective.gif 
b/images/C/toolbox/handle-transform-ex-perspective.gif
new file mode 100644
index 0000000..5f16303
Binary files /dev/null and b/images/C/toolbox/handle-transform-ex-perspective.gif differ
diff --git a/images/C/toolbox/handle-transform-ex-rotate.gif b/images/C/toolbox/handle-transform-ex-rotate.gif
new file mode 100644
index 0000000..2034489
Binary files /dev/null and b/images/C/toolbox/handle-transform-ex-rotate.gif differ
diff --git a/images/C/toolbox/handle-transform-ex-shear.gif b/images/C/toolbox/handle-transform-ex-shear.gif
new file mode 100644
index 0000000..183e463
Binary files /dev/null and b/images/C/toolbox/handle-transform-ex-shear.gif differ
diff --git a/images/C/toolbox/handle-transform-icon.png b/images/C/toolbox/handle-transform-icon.png
new file mode 100644
index 0000000..cffdb97
Binary files /dev/null and b/images/C/toolbox/handle-transform-icon.png differ
diff --git a/images/C/toolbox/handle-transform-options.png b/images/C/toolbox/handle-transform-options.png
new file mode 100644
index 0000000..53bc896
Binary files /dev/null and b/images/C/toolbox/handle-transform-options.png differ
diff --git a/images/C/toolbox/handle-transform.png b/images/C/toolbox/handle-transform.png
new file mode 100644
index 0000000..7f99651
Binary files /dev/null and b/images/C/toolbox/handle-transform.png differ
diff --git a/src/toolbox/transform-tools.xml b/src/toolbox/transform-tools.xml
index 84eb994..4819b1f 100644
--- a/src/toolbox/transform-tools.xml
+++ b/src/toolbox/transform-tools.xml
@@ -4,6 +4,7 @@
 <!-- section history:
   2017-05-06 j.h: add Unified transform
   2017-06-18 j.h: add Warp transform
+  2017-07-22 j.h: add Handle Transform
  -->
 <sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tools-transform">
   <title>Transform Tools</title>
@@ -34,4 +35,5 @@
   <xi:include href="transform/cage.xml"/>
   <xi:include href="transform/unified-transform.xml"/>
   <xi:include href="transform/warp-transform.xml"/>
+  <xi:include href="transform/handle-transform.xml"/>
 </sect1>
diff --git a/src/toolbox/transform/handle-transform.xml b/src/toolbox/transform/handle-transform.xml
new file mode 100644
index 0000000..54f419c
--- /dev/null
+++ b/src/toolbox/transform/handle-transform.xml
@@ -0,0 +1,236 @@
+<?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";>
+
+<sect2 id="gimp-tool-handle-transform">
+  <title>Handle Transform</title>
+
+  <indexterm>
+    <primary>Tools</primary>
+    <secondary>Handle Transform</secondary>
+  </indexterm>
+  <indexterm><primary>Handle Transform</primary></indexterm>
+
+  <figure>
+    <title>Handle Transform tool</title>
+    <mediaobject>
+      <imageobject>
+        <imagedata format="PNG"
+          fileref="images/toolbox/handle-transform.png"/>
+      </imageobject>
+    </mediaobject>
+  </figure>
+
+  <para>
+    This tool allows you to apply moving, rotating, shearing, perspective and 
+    scaling corrections using handles placed on canvas.
+  </para>
+  
+  <para>
+    You can use 1 to 4 handles, and the effect depends on the number of 
+    handles. The tool acts on a selection, or, if there is no selection, on the 
+    whole layer. The active handle is bigger than the others. When the mouse 
+    pointer is on a handle, it goes with a small icon that represents the 
+    active action.  
+  </para>
+  
+  <para>
+    When you click and drag a handle, a transformation is applied, 
+    and the other handles stay at their place:
+    <itemizedlist>
+      <listitem>
+        <para>
+          <emphasis role="bold">With 1 handle</emphasis>: click and drag the 
+          handle to <emphasis>move</emphasis> all pixels of the selection.
+          <figure>
+            <title>Example for 1 handle (Move)</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/toolbox/handle-transform-ex-move.gif"/>
+              </imageobject>
+            </mediaobject>
+          </figure>
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          <emphasis role="bold">With 2 handles</emphasis>: when you click and 
+            drag a handle, you <emphasis>rotate</emphasis> around the other 
+            handle as a center, and you <emphasis>scale</emphasis> the 
+            selection, keeping the aspect ratio.
+          <figure>
+            <title>Example for 2 handles (Rotate and scale)</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/toolbox/handle-transform-ex-rotate.gif"/>
+              </imageobject>
+            </mediaobject>
+          </figure>
+        </para>
+      </listitem>
+      
+      <listitem>
+        <para>
+          <emphasis role="bold">With 3 handles</emphasis>: when you click and 
+            drag a handle, you <emphasis>shear</emphasis> and 
+            <emphasis>scale</emphasis> the selection, aspect ratio is not kept.
+          <figure>
+            <title>Example for 3 handles (Shear and scale)</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/toolbox/handle-transform-ex-shear.gif"/>
+              </imageobject>
+            </mediaobject>
+          </figure>
+        </para>
+      </listitem>
+      
+      <listitem>
+        <para>
+          <emphasis role="bold">With 4 handles</emphasis>: when you click and 
+            drag a handle, you <emphasis>change perspective</emphasis> and 
+            <emphasis>scale</emphasis> the selection, aspect ratio is not kept.
+          <figure>
+            <title>Example for 4 handles (Change perspective and scale)</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/toolbox/handle-transform-ex-perspective.gif"/>
+              </imageobject>
+            </mediaobject>
+          </figure>
+        </para>
+      </listitem>
+    </itemizedlist>
+  </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>Handle Transform</guimenuitem>
+          </menuchoice>
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          The Tool can also be called by clicking the tool icon:
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject>
+                <imagedata fileref="images/toolbox/handle-transform-icon.png" />
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon>
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          or by clicking on the        
+          <keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>H</keycap>         
+          keyboard shortcut.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3>
+    <title>Key modifiers</title>
+    <variablelist>
+      <varlistentry>
+        <term><keycap>Shift</keycap></term>
+        <listitem>
+          <para>
+            Press <keycap>Shift</keycap> and click on a handle to 
+            <emphasis>move</emphasis> it.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><keycap>Ctrl</keycap></term>
+        <listitem>
+          <para>
+           Press <keycap>Ctrl</keycap> and click on a handle to 
+            <emphasis>remove</emphasis> it. 
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title>Handle Transform Tool options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/toolbox/handle-transform-options.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+
+    <para>
+      The available tool options can be accessed by double clicking the
+      Handle Transform tool icon.
+      <guiicon>
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/toolbox/handle-transform-toolbox.png" />
+          </imageobject>
+        </inlinemediaobject>
+      </guiicon>
+    </para>
+
+    <variablelist>
+      <varlistentry>
+        <term>Transform, Direction, Interpolation, Clipping, Guides</term>
+        <listitem>
+          <note>
+            <para>
+              See <xref linkend="gimp-tool-transform" /> for a description of 
+              tool options that apply to many or all transformation tools.
+            </para>
+          </note>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Image opacity</term>
+        <listitem>
+          <para>
+            To set the opacity of the preview
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Handle mode</term>
+        <listitem>
+          <para>
+            These options are describes in key modifiers section.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+ </sect3>
+</sect2>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]