[gimp-help] Updates in transform tools

[Julien Hardlin <jhardlin src gnome org>]

commit cb4757e659a43393bf9621bac07eb083ed0f841b
Author: Julien Hardelin <jhardlin orange fr>
Date:   Mon Nov 25 18:40:41 2019 +0100

    Updates in transform tools

 images/C/tool-options/affect-image.png        | Bin 0 -> 1764 bytes
 images/C/tool-options/affect-layer.png        | Bin 0 -> 1692 bytes
 images/C/tool-options/affect-path.png         | Bin 0 -> 1656 bytes
 images/C/tool-options/affect-selection.png    | Bin 0 -> 1720 bytes
 images/C/toolbox/flip-dialog.png              | Bin 8589 -> 8768 bytes
 images/C/toolbox/handle_transform-dialog.png  | Bin 0 -> 27934 bytes
 images/C/toolbox/perspective-dialog.png       | Bin 19976 -> 24785 bytes
 images/C/toolbox/rotate-dialog.png            | Bin 18403 -> 22640 bytes
 images/C/toolbox/scale-dialog.png             | Bin 20244 -> 25182 bytes
 images/C/toolbox/shear-dialog.png             | Bin 5815 -> 20167 bytes
 images/C/toolbox/transform-image-ex1.jpg      | Bin 0 -> 28158 bytes
 images/C/toolbox/transform-image-ex2.jpg      | Bin 0 -> 41576 bytes
 images/C/toolbox/transform-tools.png          | Bin 9983 -> 14033 bytes
 images/C/toolbox/unified_transform-dialog.png | Bin 0 -> 35675 bytes
 src/toolbox/transform/common-features.xml     |  47 ++++++++++++++++++++++++--
 15 files changed, 44 insertions(+), 3 deletions(-)
---
diff --git a/images/C/tool-options/affect-image.png b/images/C/tool-options/affect-image.png
new file mode 100644
index 000000000..7f470e155
Binary files /dev/null and b/images/C/tool-options/affect-image.png differ
diff --git a/images/C/tool-options/affect-layer.png b/images/C/tool-options/affect-layer.png
new file mode 100644
index 000000000..41bfc1647
Binary files /dev/null and b/images/C/tool-options/affect-layer.png differ
diff --git a/images/C/tool-options/affect-path.png b/images/C/tool-options/affect-path.png
new file mode 100644
index 000000000..df1b4380e
Binary files /dev/null and b/images/C/tool-options/affect-path.png differ
diff --git a/images/C/tool-options/affect-selection.png b/images/C/tool-options/affect-selection.png
new file mode 100644
index 000000000..c971db89e
Binary files /dev/null and b/images/C/tool-options/affect-selection.png differ
diff --git a/images/C/toolbox/flip-dialog.png b/images/C/toolbox/flip-dialog.png
index 7b994c773..9b8388b1e 100644
Binary files a/images/C/toolbox/flip-dialog.png and b/images/C/toolbox/flip-dialog.png differ
diff --git a/images/C/toolbox/handle_transform-dialog.png b/images/C/toolbox/handle_transform-dialog.png
new file mode 100644
index 000000000..7837148c8
Binary files /dev/null and b/images/C/toolbox/handle_transform-dialog.png differ
diff --git a/images/C/toolbox/perspective-dialog.png b/images/C/toolbox/perspective-dialog.png
index a5b703d13..d19d9ad4d 100644
Binary files a/images/C/toolbox/perspective-dialog.png and b/images/C/toolbox/perspective-dialog.png differ
diff --git a/images/C/toolbox/rotate-dialog.png b/images/C/toolbox/rotate-dialog.png
index 4d09f61ea..746eb97d4 100644
Binary files a/images/C/toolbox/rotate-dialog.png and b/images/C/toolbox/rotate-dialog.png differ
diff --git a/images/C/toolbox/scale-dialog.png b/images/C/toolbox/scale-dialog.png
index 32efa87e1..448f89d88 100644
Binary files a/images/C/toolbox/scale-dialog.png and b/images/C/toolbox/scale-dialog.png differ
diff --git a/images/C/toolbox/shear-dialog.png b/images/C/toolbox/shear-dialog.png
index 812dc1497..92b3a6572 100644
Binary files a/images/C/toolbox/shear-dialog.png and b/images/C/toolbox/shear-dialog.png differ
diff --git a/images/C/toolbox/transform-image-ex1.jpg b/images/C/toolbox/transform-image-ex1.jpg
new file mode 100644
index 000000000..1c7391e4b
Binary files /dev/null and b/images/C/toolbox/transform-image-ex1.jpg differ
diff --git a/images/C/toolbox/transform-image-ex2.jpg b/images/C/toolbox/transform-image-ex2.jpg
new file mode 100644
index 000000000..47426d4eb
Binary files /dev/null and b/images/C/toolbox/transform-image-ex2.jpg differ
diff --git a/images/C/toolbox/transform-tools.png b/images/C/toolbox/transform-tools.png
index 236b475ef..df24d2bc2 100644
Binary files a/images/C/toolbox/transform-tools.png and b/images/C/toolbox/transform-tools.png differ
diff --git a/images/C/toolbox/unified_transform-dialog.png b/images/C/toolbox/unified_transform-dialog.png
new file mode 100644
index 000000000..796cb19e9
Binary files /dev/null and b/images/C/toolbox/unified_transform-dialog.png differ
diff --git a/src/toolbox/transform/common-features.xml b/src/toolbox/transform/common-features.xml
index 9f41dcdd4..5b2444b8c 100644
--- a/src/toolbox/transform/common-features.xml
+++ b/src/toolbox/transform/common-features.xml
@@ -40,7 +40,7 @@
                 When you activate the first button
                 <guiicon>
                   <inlinegraphic
-                    fileref="images/tool-options/rotate-affect-layer.png"/>
+                    fileref="images/tool-options/affect-layer.png"/>
                 </guiicon>
                 the tool works on the active layer. If no selection exists in
                 this layer, the whole layer will be transformed.
@@ -51,7 +51,7 @@
                 When you activate the second button
                 <guiicon>
                   <inlinegraphic
-                      fileref="images/tool-options/rotate-affect-selection.png"/>
+                      fileref="images/tool-options/affect-selection.png"/>
                 </guiicon>
                 the tool works on the selection contour only (the whole layer
                 contour if no selection).
@@ -62,11 +62,52 @@
                 When you activate the third button,
                 <guiicon>
                   <inlinegraphic
-                        fileref="images/tool-options/rotate-affect-path.png"/>
+                        fileref="images/tool-options/affect-path.png"/>
                 </guiicon>
                 the tool works on the path only.
               </para>
             </listitem>
+            <listitem>
+              <para>
+                When you activate the fourth button, new in GIMP-2.10.14, 
+                <guiicon>
+                  <inlinegraphic
+                        fileref="images/tool-options/affect-image.png"/>
+                </guiicon>
+                the transformation is applied to all layers.
+              </para>
+              <figure>
+                <title>Example with Rotate</title>
+                <mediaobject>
+                  <imageobject>
+                    <imagedata format="JPG"
+                      fileref="images/toolbox/transform-image-ex1.jpg"/>
+                  </imageobject>
+                  <caption>
+                    <para>
+                      Two layers, the red one being smaller. View/Show All 
+                      option checked.
+                    </para>
+                  </caption>
+                </mediaobject>
+                <mediaobject>
+                  <imageobject>
+                    <imagedata format="JPG"
+                      fileref="images/toolbox/transform-image-ex2.jpg"/>
+                  </imageobject>
+                  <caption>
+                    <para>
+                      Fourth button pressed, Rotate tool applied. Note the 
+                      adaptation of layer sizes.
+                    </para>
+                  </caption>
+                </mediaobject>
+              </figure>
+              <para>
+                Of course, you can get the same result linking layers, but 
+                this new option is easier to use.
+              </para>
+            </listitem>
           </itemizedlist>
         </listitem>
       </varlistentry>