GNOME.org
 

[gimp-help-2] Updated some transform sections to 2.8

commit f26988d808ae79e3f14148f32dc41beb0e1297ee
Author: kolbjoern <kolbjoern git gnome org>
Date:   Mon Dec 10 20:07:20 2012 +0100

    Updated some transform sections to 2.8

 images/C/toolbox/clip-4a.png                  |  Bin 0 -> 18257 bytes
 images/C/toolbox/clip-4b.png                  |  Bin 0 -> 23011 bytes
 images/C/toolbox/clip-4c.png                  |  Bin 0 -> 16306 bytes
 images/C/toolbox/tool-options-perspective.png |  Bin 15488 -> 5908 bytes
 images/C/toolbox/tool-options-rotate.png      |  Bin 16159 -> 5939 bytes
 images/C/toolbox/tool-options-scale.png       |  Bin 16413 -> 6212 bytes
 images/C/toolbox/tool-options-shear.png       |  Bin 15392 -> 5815 bytes
 images/C/toolbox/transform-guides.png         |  Bin 0 -> 21844 bytes
 images/C/toolbox/transform-tools.png          |  Bin 8672 -> 9983 bytes
 src/toolbox/transform/common-features.xml     |  135 ++++++++++++++++++-------
 src/toolbox/transform/perspective.xml         |    2 +-
 src/toolbox/transform/rotate.xml              |   24 ++++-
 src/toolbox/transform/scale.xml               |    2 +-
 src/toolbox/transform/shear.xml               |    2 +-
 14 files changed, 120 insertions(+), 45 deletions(-)
---
diff --git a/images/C/toolbox/clip-4a.png b/images/C/toolbox/clip-4a.png
new file mode 100755
index 0000000..c461ff0
Binary files /dev/null and b/images/C/toolbox/clip-4a.png differ
diff --git a/images/C/toolbox/clip-4b.png b/images/C/toolbox/clip-4b.png
new file mode 100755
index 0000000..7972cf1
Binary files /dev/null and b/images/C/toolbox/clip-4b.png differ
diff --git a/images/C/toolbox/clip-4c.png b/images/C/toolbox/clip-4c.png
new file mode 100755
index 0000000..f25b441
Binary files /dev/null and b/images/C/toolbox/clip-4c.png differ
diff --git a/images/C/toolbox/tool-options-perspective.png b/images/C/toolbox/tool-options-perspective.png
index bc3bb81..f31ad66 100644
Binary files a/images/C/toolbox/tool-options-perspective.png and b/images/C/toolbox/tool-options-perspective.png differ
diff --git a/images/C/toolbox/tool-options-rotate.png b/images/C/toolbox/tool-options-rotate.png
index ba312db..cc578b3 100644
Binary files a/images/C/toolbox/tool-options-rotate.png and b/images/C/toolbox/tool-options-rotate.png differ
diff --git a/images/C/toolbox/tool-options-scale.png b/images/C/toolbox/tool-options-scale.png
index fcc1088..7145a66 100644
Binary files a/images/C/toolbox/tool-options-scale.png and b/images/C/toolbox/tool-options-scale.png differ
diff --git a/images/C/toolbox/tool-options-shear.png b/images/C/toolbox/tool-options-shear.png
index 66682ef..812dc14 100644
Binary files a/images/C/toolbox/tool-options-shear.png and b/images/C/toolbox/tool-options-shear.png differ
diff --git a/images/C/toolbox/transform-guides.png b/images/C/toolbox/transform-guides.png
new file mode 100755
index 0000000..df41bd8
Binary files /dev/null and b/images/C/toolbox/transform-guides.png differ
diff --git a/images/C/toolbox/transform-tools.png b/images/C/toolbox/transform-tools.png
index bf891eb..236b475 100644
Binary files a/images/C/toolbox/transform-tools.png and b/images/C/toolbox/transform-tools.png differ
diff --git a/src/toolbox/transform/common-features.xml b/src/toolbox/transform/common-features.xml
old mode 100644
new mode 100755
index f189108..538841a
--- a/src/toolbox/transform/common-features.xml
+++ b/src/toolbox/transform/common-features.xml
@@ -149,7 +149,7 @@
                 <para>
                   The color of each pixel is computed as the average color of
                   the eight closest pixels in the original image. This usually
-                  gives the best result, but it naturally takes more time.
+                  gives a good result, but it naturally takes more time.
                   Sometimes this method is called <quote>Bicubic</quote>.
                 </para>
               </listitem>
@@ -159,7 +159,9 @@
               <listitem>
                 <para>
                   The Lanczos3 method uses the Sinc mathematical function and
-                  performs a high quality interpolation.
+                  performs a high quality interpolation. This is usually the
+                  best method but if you are not satisfied with the result,
+                  you may give <quote>Cubic</quote> a try.
                 </para>
               </listitem>
             </varlistentry>
@@ -287,18 +289,34 @@
             <varlistentry>
               <term>Crop with aspect</term>
               <listitem>
-<!--                <figure>
+                <figure>
                   <title>Example for Crop with aspect</title>
                   <mediaobject>
                     <imageobject>
-                      <imagedata fileref="images/toolbox/clip-4.png" format="PNG"/>
+                      <imagedata fileref="images/toolbox/clip-4a.png" format="PNG"/>
                     </imageobject>
                     <caption>
-                      <para>Crop with aspect</para>
+                      <para>Original image</para>
                     </caption>
                   </mediaobject>
+                  <mediaobject>
+                    <imageobject>
+                      <imagedata fileref="images/toolbox/clip-4b.png" format="PNG"/>
+                    </imageobject>
+                    <caption>
+                      <para>Rotation -22Â</para>
+                    </caption>
+                  </mediaobject>
+                  <mediaobject>
+                    <imageobject>
+                      <imagedata fileref="images/toolbox/clip-4c.png" format="PNG"/>
+                    </imageobject>
+                    <caption>
+                      <para>The rotated image</para>
+                    </caption>
+                  </mediaobject>                    
                 </figure>
-Commented until somebody finds a valid example-->
+
                 <para>
                   This option works like the one described before, but makes
                   sure, that the aspect ratio is maintained.
@@ -314,64 +332,107 @@ Commented until somebody finds a valid example-->
           <indexterm>
             <primary>Preview</primary>
             <secondary>Transformation tools</secondary>
-          </indexterm>
+          </indexterm>         
           <variablelist>
             <para>
-              <acronym>GIMP</acronym> lets you select among four Preview
-              possibilities:
+              If this is marked, which is the default setting, the transformed
+              image will be visible above the original image or layer. There 
+              will also be a slider with which you may select the visibility of 
+              the preview.
             </para>
+          </variablelist>  
+        </listitem>    
+      </varlistentry>
+      
+      <varlistentry>
+        <term>Guides</term>
+        <listitem>
+          <para>
+            This is a drop down list where you select the type of guide lines 
+            which suits your transforming. All the guides uses a frame to mark 
+            the image's outline in addition to the lines used by the different 
+            selections. 
+          </para>
+          <variablelist>
             <varlistentry>
-              <term>Outline</term>
+              <term>No guides</term>
               <listitem>
                 <para>
-                  Puts a frame to mark the image outline, with a handle on
-                  each corner. Movements will affect this frame only on the
-                  Preview, but the result of the transformation will concern
-                  either the content or the boundaries of the selection
-                  according to the selected Affect mode.
+                  As the name tells you, there are no guides used.
                 </para>
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term>Grid</term>
+              <term>Center lines</term>
+                <listitem>
+                  <para>
+                    Uses one vertical line and one horizontal line crossing each 
+                    other in the center of the image or layer.
+                  </para>
+                </listitem>
+            </varlistentry>        
+            <varlistentry>
+              <term>Rule of thirds</term>
               <listitem>
                 <para>
-                  Puts a grid on the image, with four handles. Movements will
-                  affect this grid only on the Preview, but the result of the
-                  transformation will concern either the content or the
-                  boundaries of the selection according to the selected
-                  Transform mode.
+                  Divides the transforming area in nine equal parts by adding 
+                  two horizontal lines and two vertical lines equally spaced. 
+                  According to this rule the most interesting parts of the image 
+                  should be placed at the intersection points.              
+                </para>
+              </listitem>
+            </varlistentry>        
+            <varlistentry>
+              <term>Rule of fifths</term>
+              <listitem>
+                <para>
+                  Just as the <quote>Rules of thirds</quote> but divides the area in five by 
+                  five parts.
                 </para>
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term>Image</term>
+              <term>Golden sections</term>
               <listitem>
                 <para>
-                  Here, the preview is a copy of the image superimposed on the
-                  image, with an outline. Movements affect this copy and the
-                  underlying image appears.
+                  Also called <quote>The Golden Ratio</quote>. This divides the 
+                  transforming area in nine parts using a mathematical formula 
+                  proportioning the parts to each others and to the area to be
+                  transformed.
+                </para>
+              </listitem>
+            </varlistentry> 
+            <varlistentry>
+              <term>Diagonal lines</term>
+              <listitem>
+                <para>
+                  Divide the transforming area using diagonally lines.
                 </para>
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term>Grid+Image</term>
+              <term>Number of lines</term>
               <listitem>
-                <para>Both turn at the same time.</para>
+                <para>
+                  Puts a rectangular grid with equal numbers of vertically 
+                  and horizontally lines. The number of lines is set in the 
+                  slider popping up when this guide is selected.
+                </para>
+              </listitem>
+            </varlistentry> 
+            <varlistentry>
+              <term>Line spacing</term>
+              <listitem>
+                <para>
+                  Puts a rectangular grid on the transforming area using the 
+                  spacing between the lines set in the slider.
+                </para>
               </listitem>
             </varlistentry>
           </variablelist>
-          <para>
-            Options with grid activate a drop-list with two options:
-            <guilabel>Number of Grid Lines</guilabel> will allow control
-            over the total number of displayed grid lines. Use the
-            slider to set the number of grid lines.
-            <guilabel>Grid Line Spacing</guilabel> allows control over
-            the distance between the grid lines. Use the slider to set
-            the distance.
-          </para>
-        </listitem>
+        </listitem>        
       </varlistentry>
+
       <varlistentry>
         <term>Opacity</term>
         <listitem>
diff --git a/src/toolbox/transform/perspective.xml b/src/toolbox/transform/perspective.xml
index ede69d5..2bb6409 100644
--- a/src/toolbox/transform/perspective.xml
+++ b/src/toolbox/transform/perspective.xml
@@ -100,7 +100,7 @@
     <variablelist>
       <varlistentry>
         <term>
-          Transform; Interpolation; Direction; Clipping; Preview
+          Transform; Interpolation; Direction; Clipping; Preview; Guides
         </term>
         <listitem>
           <xi:include href="about-common-transform-options.xml"/>
diff --git a/src/toolbox/transform/rotate.xml b/src/toolbox/transform/rotate.xml
index 5231e78..1c43282 100644
--- a/src/toolbox/transform/rotate.xml
+++ b/src/toolbox/transform/rotate.xml
@@ -113,7 +113,7 @@
     <variablelist>
       <varlistentry>
         <term>
-          Transform; Direction, Interpolation; Clipping; Preview
+          Transform; Direction, Interpolation; Clipping; Preview; Guides
         </term>
         <listitem>
           <xi:include href="about-common-transform-options.xml"/>
@@ -177,11 +177,25 @@
         <listitem>
           <para>
             This option allows you to set the position of the rotation center,
-            represented by a large point in the image. A click-and-drag on
-            this point also allows you to move this center. Default unit of
-            measurement is pixel, but you can change it by using the drop-down
-            list.
+            represented by a cross surrounded by a circle in the image. A 
+            click-and-drag on this point also allows you to move this center 
+            even outside the image. Default unit of measurement is pixel, but 
+            you can change it by using the drop-down list.
           </para>
+          <figure>
+            <title>The rotating center</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata fileref="images/toolbox/transform-guides.png" format="PNG"/>
+              </imageobject>
+              <caption>
+                <para>
+                  The layer rotated around the rotating center outside the 
+                  image
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>      
         </listitem>
       </varlistentry>
     </variablelist>
diff --git a/src/toolbox/transform/scale.xml b/src/toolbox/transform/scale.xml
index d13be45..940182a 100644
--- a/src/toolbox/transform/scale.xml
+++ b/src/toolbox/transform/scale.xml
@@ -125,7 +125,7 @@
     <variablelist>
       <varlistentry>
         <term>
-          Transform; Interpolation; Direction; Clipping; Preview
+          Transform; Interpolation; Direction; Clipping; Preview; Guides 
         </term>
         <listitem>
           <xi:include href="about-common-transform-options.xml"/>
diff --git a/src/toolbox/transform/shear.xml b/src/toolbox/transform/shear.xml
index 3261398..9984649 100644
--- a/src/toolbox/transform/shear.xml
+++ b/src/toolbox/transform/shear.xml
@@ -110,7 +110,7 @@
     <variablelist>
       <varlistentry>
         <term>
-          Transform Direction; Interpolation; Clippping; Preview
+          Transform Direction; Interpolation; Clippping; Preview; Guides
         </term>
         <listitem>
           <xi:include href="about-common-transform-options.xml"/>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]