[gimp-help-2] Minor changes to Map filters



commit 20d6c02df83cd20d03b1f8cdd2efb9ea75d35f01
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date:   Mon Jul 19 19:08:23 2010 +0200

    Minor changes to Map filters
    
    Also, replace a Warp example image with a new one that uses a grayscale
    map, as proposed in the text.

 images/C/filters/examples/example-map-warp7.png |  Bin 5837 -> 3050 bytes
 src/filters/map/bumpmap.xml                     |   65 ++++---
 src/filters/map/displace.xml                    |   73 ++++---
 src/filters/map/fractal-trace.xml               |    8 +-
 src/filters/map/illusion.xml                    |   12 +-
 src/filters/map/map-object.xml                  |  242 +++++++++++++----------
 src/filters/map/papertile.xml                   |  183 ++++++++++--------
 src/filters/map/smalltiles.xml                  |   78 ++++----
 src/filters/map/tile.xml                        |   18 +-
 src/filters/map/warp.xml                        |  184 ++++++++++-------
 10 files changed, 496 insertions(+), 367 deletions(-)
---
diff --git a/images/C/filters/examples/example-map-warp7.png b/images/C/filters/examples/example-map-warp7.png
index 50d6c3b..95f8b0c 100644
Binary files a/images/C/filters/examples/example-map-warp7.png and b/images/C/filters/examples/example-map-warp7.png differ
diff --git a/src/filters/map/bumpmap.xml b/src/filters/map/bumpmap.xml
index e180c77..b398106 100644
--- a/src/filters/map/bumpmap.xml
+++ b/src/filters/map/bumpmap.xml
@@ -82,13 +82,13 @@
         <term>Preview</term>
         <listitem>
           <para>
-            Parameter setting results are interactively displayed in preview.
-            Scroll bars allow you to move around the image.
+            If checked, parameter setting results are interactively displayed
+            in preview.  Scroll bars allow you to move around the image.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Bump Map</term>
+        <term>Bump map</term>
         <listitem>
           <para>
             This drop-down list allows you to select the image that will be
@@ -99,32 +99,38 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Map Type</term>
+        <term>Map type</term>
         <listitem>
           <para>
             This option allows you to define the method that will be used
             when creating the map image:
           </para>
-          <itemizedlist>
-            <listitem>
-              <para>
-                <guilabel>Linear</guilabel>: bump height is a direct
-                function of luminosity.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Sinusoidal</guilabel>: bump height
-                is a sinusoidal function of luminosity.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Spheric</guilabel>: bump height is
-                a spheric function of luminosity.
-              </para>
-            </listitem>
-          </itemizedlist>
+          <variablelist>
+            <varlistentry>
+              <term><guilabel>Linear</guilabel></term>
+              <listitem>
+                <para>
+                  Bump height is a direct function of luminosity.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Sinusoidal</guilabel></term>
+              <listitem>
+                <para>
+                  Bump height is a sinusoidal function of luminosity.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Spheric</guilabel></term>
+              <listitem>
+                <para>
+                  Bump height is a spheric function of luminosity.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -137,7 +143,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Invert bump-map</term>
+        <term>Invert bumpmap</term>
         <listitem>
           <para>
             Bright pixels default to bumps and dark pixels to hollows. You can
@@ -146,7 +152,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Tile bump-map</term>
+        <term>Tile bumpmap</term>
         <listitem>
           <para>
             If you check this option, there will be no relief break if
@@ -184,7 +190,8 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>X/Y offsets</term>
+        <term>X offset</term>
+        <term>Y offset</term>
         <listitem>
           <para>
             With this slider, you can adjust the map image position
@@ -194,7 +201,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Sea Level</term>
+        <term>Waterlevel</term>
         <listitem>
           <para>
             If your image has transparent areas, they will be treated like
@@ -202,7 +209,7 @@
             slider, you can reduce hollows as if sea level was raising. This
             hollows will disappear when sea level value reaches 255. If the
             Invert bump-map option is checked, transparent areas will be
-            treated as bright areas, and then Sea Level slider will plane
+            treated as bright areas, and then Waterlevel slider will plane
             bumps down.
           </para>
         </listitem>
diff --git a/src/filters/map/displace.xml b/src/filters/map/displace.xml
index 37cdd71..e423d73 100644
--- a/src/filters/map/displace.xml
+++ b/src/filters/map/displace.xml
@@ -1,7 +1,8 @@
 <?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";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-10-14 KoSt: updatet no to v2.4
+  2007-10-14 KoSt: updated no to v2.4
   2007-09-06 AntI: added 'es'
   2007-08-19 alex falappa: new sections for 2.4 and torough review
   2007-08-07 alex falappa: ude's fix to 'it', polar mode
@@ -114,10 +115,10 @@
         <listitem>
           <para>
             You can choose working in
-            <link linkend="plug-in-displace-cartesian">cartesian</link>
+            <link linkend="plug-in-displace-cartesian">Cartesian</link>
             coordinates, where pixels are displaced in X or Y direction, or
             working in
-            <link linkend="plug-in-displace-polar">polar</link> coordinates,
+            <link linkend="plug-in-displace-polar">Polar</link> coordinates,
             where the image is pinched and whirled by displacing pixels in
             radial or tangent direction.
           </para>
@@ -133,27 +134,36 @@
             These options allows you to set displacement behaviour on active
             layer or selection edges:
           </para>
-          <itemizedlist>
-            <listitem>
-              <para><guilabel>Wrap</guilabel>:
-                With this option, what disappears on one edge reappears on
-                the opposite edge.
-              </para>
-            </listitem>
-            <listitem>
-              <para><guilabel>Smear</guilabel>:
-                With this option, pixels vacated by displacement are
-                replaced with pixels stretched from the adjacent part of the
-                image.
-              </para>
-            </listitem>
-            <listitem>
-              <para><guilabel>Black</guilabel>:
-                With this option, pixels vacated by displacement are replaced
-                with black.
-              </para>
-            </listitem>
-          </itemizedlist>
+          <variablelist>
+            <varlistentry>
+              <term><guilabel>Wrap</guilabel></term>
+              <listitem>
+                <para>
+                  With this option, what disappears on one edge reappears on
+                  the opposite edge.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Smear</guilabel></term>
+              <listitem>
+                <para>
+                  With this option, pixels vacated by displacement are
+                  replaced with pixels stretched from the adjacent part of the
+                  image.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Black</guilabel></term>
+              <listitem>
+                <para>
+                  With this option, pixels vacated by displacement are
+                  replaced with black.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
         </listitem>
       </varlistentry>
     </variablelist>
@@ -164,8 +174,8 @@
         <title>Displace filter options (Cartesian)</title>
         <mediaobject>
           <imageobject>
-            <imagedata fileref="images/filters/options-map-displace-cartesian.png"
-              format="PNG"/>
+            <imagedata format="PNG"
+              fileref="images/filters/options-map-displace-cartesian.png"/>
           </imageobject>
           <caption>
             <para>Displacement Mode: Cartesian</para>
@@ -185,7 +195,8 @@
       </para>
       <variablelist>
         <varlistentry>
-          <term>X/Y Displacements</term>
+          <term>X displacement</term>
+          <term>Y displacement</term>
           <listitem>
             <para>
               If the respective option is activated, image pixels
@@ -243,8 +254,8 @@
         <title>Displace filter options (Polar)</title>
         <mediaobject>
           <imageobject>
-            <imagedata fileref="images/filters/options-map-displace-polar.png"
-              format="PNG"/>
+            <imagedata format="PNG"
+              fileref="images/filters/options-map-displace-polar.png"/>
           </imageobject>
           <caption>
             <para>Displacement Mode: Polar</para>
@@ -265,7 +276,7 @@
             </para>
             <para>
               For the values and the displacement map see above
-              (<quote>X/Y Displacements</quote>).
+              (<quote>X/Y displacement</quote>).
             </para>
             <para>
               The displacement is independent from the polar distance, all
diff --git a/src/filters/map/fractal-trace.xml b/src/filters/map/fractal-trace.xml
index a935ed4..a060e6e 100644
--- a/src/filters/map/fractal-trace.xml
+++ b/src/filters/map/fractal-trace.xml
@@ -75,7 +75,11 @@
     <variablelist>
       <title>Mandelbrot parameters</title>
       <varlistentry>
-        <term>X1, X2, Y1, Y2, Depth</term>
+        <term>X1</term>
+        <term>X2</term>
+        <term>Y1</term>
+        <term>Y2</term>
+        <term>Depth</term>
         <listitem>
           <para>
             These parameters are similar to X/YMIN, X/YMAX and ITER
@@ -87,7 +91,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Outside type</term>
+        <term>Outside Type</term>
         <listitem>
           <para>
             Mapping image to fractal may reveal empty areas. You can select
diff --git a/src/filters/map/illusion.xml b/src/filters/map/illusion.xml
index 3beea7d..9ec04d1 100644
--- a/src/filters/map/illusion.xml
+++ b/src/filters/map/illusion.xml
@@ -76,6 +76,15 @@
     </figure>
     <variablelist>
       <varlistentry>
+        <term>Preview</term>
+        <listitem>
+          <para>
+            If checked, parameter setting results are interactively displayed
+            in preview.  Scroll bars allow you to move around the image.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
         <term>Divisions</term>
         <listitem>
           <para>
@@ -86,7 +95,8 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Modes</term>
+        <term>Mode 1</term>
+        <term>Mode 2</term>
         <listitem>
           <para>
             You have two arrangement modes for copies in image:
diff --git a/src/filters/map/map-object.xml b/src/filters/map/map-object.xml
index bc42cc1..390f529 100644
--- a/src/filters/map/map-object.xml
+++ b/src/filters/map/map-object.xml
@@ -72,16 +72,16 @@
     <title>Options</title>
 
     <sect4>
-      <title>Preview domain</title>
+      <title>Preview</title>
       <para>This preview has several possibilities:</para>
       <variablelist>
         <varlistentry>
           <term>Preview!</term>
           <listitem>
             <para>
-              <guibutton>Preview!</guibutton>: Preview is automatic for some
-              options but you will have to press this button to update Preview
-              after modifying many other parameters.
+              Preview is automatic for some options but you will have to press
+              this button to update Preview after modifying many other
+              parameters.
             </para>
             <para>
               When mouse pointer is on Preview and the Light tab is selected,
@@ -94,21 +94,22 @@
           </listitem>
         </varlistentry>
         <varlistentry>
-          <term>Zoom buttons</term>
+          <term>Zoom out</term>
+          <term>Zoom in</term>
           <listitem>
             <para>
-              <guibutton>Zoom buttons</guibutton> allow you to enlarge or to
-              reduce image in Preview. Their action is limited, but may be
-              useful in case of a large image.
+              Zoom buttons allow you to enlarge or to reduce image in Preview.
+              Their action is limited, but may be useful in case of a large
+              image.
             </para>
           </listitem>
         </varlistentry>
         <varlistentry>
-          <term>Show Preview Wireframe</term>
+          <term>Show preview wireframe</term>
           <listitem>
-            <para><guilabel>Show Preview Wireframe</guilabel>: Puts a grid over
-              the preview to make displacements and rotations more easy. Works
-              well on a plan.
+            <para>
+              Puts a grid over the preview to make displacements and rotations
+              more easy. Works well on a plan.
             </para>
           </listitem>
         </varlistentry>
@@ -116,9 +117,9 @@
     </sect4>
 
     <sect4>
-      <title>General Options tab</title>
+      <title>General Options</title>
       <figure>
-        <title><quote>Map Object</quote> general options tab</title>
+        <title><quote>Map Object</quote> options (General)</title>
         <mediaobject>
           <imageobject>
             <imagedata format="PNG"
@@ -180,30 +181,36 @@
               Check this option to conceal this unpleasant aliasing effect
               on borders. When checked, this option lets appear two settings:
             </para>
-            <itemizedlist>
-              <listitem>
-                <para>
-                  <guilabel>Depth</guilabel>: Defines antialiasing quality,
-                  to the detriment of execution speed.
-                </para>
-              </listitem>
-              <listitem>
-                <para>
-                  <guilabel>Threshold</guilabel>: Defines antialiasing
-                  limits. Antialiasing stops when value difference between
-                  pixels becomes lower than this set value.
-                </para>
-              </listitem>
-            </itemizedlist>
+            <variablelist>
+              <varlistentry>
+                <term><guilabel>Depth</guilabel></term>
+                <listitem>
+                  <para>
+                    Defines antialiasing quality, to the detriment of
+                    execution speed.
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Threshold</guilabel></term>
+                <listitem>
+                  <para>
+                    Defines antialiasing limits. Antialiasing stops when value
+                    difference between pixels becomes lower than this set
+                    value.
+                  </para>
+                </listitem>
+              </varlistentry>
+            </variablelist>
           </listitem>
         </varlistentry>
       </variablelist>
     </sect4>
 
     <sect4>
-      <title>Light tab</title>
+      <title>Light</title>
       <figure>
-        <title><quote>Light</quote> tab options</title>
+        <title><quote>Map Object</quote> options (Light)</title>
         <mediaobject>
           <imageobject>
             <imagedata format="PNG"
@@ -215,22 +222,26 @@
         <varlistentry>
           <term>Light Settings</term>
           <listitem>
-            <itemizedlist>
-              <listitem>
-                <para>
-                  <guilabel>Lightsource type</guilabel>: In this dropdown
-                  list, you can select among <emphasis>Point light</emphasis>,
-                  <emphasis>Directionnal light</emphasis> and <emphasis> No
-                  light</emphasis>.
-                </para>
-              </listitem>
-              <listitem>
-                <para>
-                  <guilabel>Lightsource color</guilabel>: Press this button to
-                  open the Color Selector dialog.
-                </para>
-              </listitem>
-            </itemizedlist>
+            <variablelist>
+              <varlistentry>
+                <term><guilabel>Lightsource type</guilabel></term>
+                <listitem>
+                  <para>
+                    In this dropdown list, you can select among
+                    <emphasis>Point light</emphasis>, <emphasis>Directionnal
+                    light</emphasis> and <emphasis>No light</emphasis>.
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Lightsource color</guilabel></term>
+                <listitem>
+                  <para>
+                    Press this button to open the Color Selector dialog.
+                  </para>
+                </listitem>
+              </varlistentry>
+            </variablelist>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -252,9 +263,9 @@
     </sect4>
 
     <sect4>
-      <title>Material tab</title>
+      <title>Material</title>
       <figure>
-        <title><quote>Material</quote> tab options</title>
+        <title><quote>Map Object</quote> options (Material)</title>
         <mediaobject>
           <imageobject>
             <imagedata format="PNG"
@@ -266,53 +277,65 @@
         <varlistentry>
           <term>Intensity Levels</term>
           <listitem>
-            <itemizedlist>
-              <listitem>
-                <para>
-                  <guilabel>Ambient</guilabel>:
-                  Amount of color to show where no light falls directly.
-                </para>
-              </listitem>
-              <listitem>
-                <para><guilabel>Diffuse</guilabel>: Intensity of original color
-                  when lit by a light source.
-                </para>
-              </listitem>
-            </itemizedlist>
+            <variablelist>
+              <varlistentry>
+                <term><guilabel>Ambient</guilabel></term>
+                <listitem>
+                  <para>
+                    Amount of color to show where no light falls directly.
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Diffuse</guilabel></term>
+                <listitem>
+                  <para>
+                    Intensity of original color when lit by a light source.
+                  </para>
+                </listitem>
+              </varlistentry>
+            </variablelist>
           </listitem>
         </varlistentry>
         <varlistentry>
           <term>Reflectivity</term>
           <listitem>
-            <itemizedlist>
-              <listitem>
-                <para>
-                  <guilabel>Diffusion</guilabel>: Higher values make object
-                  reflect more light (looks brighter).
-                </para>
-              </listitem>
-              <listitem>
-                <para>
-                  <guilabel>Specular</guilabel>: Controls how intense the
-                  highlights will be.
-                </para>
-              </listitem>
-              <listitem>
-                <para>
-                  <guilabel>Highlight</guilabel>: Higher values make the
-                  highlights more focused.
-                </para>
-              </listitem>
-            </itemizedlist>
+            <variablelist>
+              <varlistentry>
+                <term><guilabel>Diffusion</guilabel></term>
+                <listitem>
+                  <para>
+                    Higher values make object reflect more light (looks
+                    brighter).
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Specular</guilabel></term>
+                <listitem>
+                  <para>
+                    Controls how intense the highlights will be.
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Highlight</guilabel></term>
+                <listitem>
+                  <para>
+                    Higher values make the highlights more focused.
+                  </para>
+                </listitem>
+              </varlistentry>
+            </variablelist>
           </listitem>
         </varlistentry>
       </variablelist>
     </sect4>
 
     <sect4>
-      <title>Orientation tab</title>
+      <title>Orientation</title>
       <figure>
-        <title><quote>Orientation</quote> tab options</title>
+        <title><quote>Map Object</quote> options (Orientation)</title>
         <mediaobject>
           <imageobject>
             <imagedata format="PNG"
@@ -344,12 +367,12 @@
     </sect4>
 
     <sect4>
-      <title>Box tab</title>
+      <title>Box</title>
       <para>
         This tab appears only when you select the Box object.
       </para>
       <figure>
-        <title><quote>Box</quote> tab options</title>
+        <title><quote>Map Object</quote> options (Box)</title>
         <mediaobject>
           <imageobject>
             <imagedata format="PNG"
@@ -372,7 +395,7 @@
           <term>Scale</term>
           <listitem>
             <para>
-              These X, Y, Z three sliders allow you to change the size of
+              These X, Y, Z sliders allow you to change the size of
               every X, Y, Z dimension of the box.
             </para>
           </listitem>
@@ -381,12 +404,12 @@
     </sect4>
 
     <sect4>
-      <title>Cylinder tab</title>
+      <title>Cylinder</title>
       <para>
         This tab appears only when you select the Cylinder object.
       </para>
       <figure>
-        <title><quote>Cylinder</quote> tab options</title>
+        <title><quote>Map Object</quote> options (Cylinder)</title>
         <mediaobject>
           <imageobject>
             <imagedata format="PNG"
@@ -407,24 +430,29 @@
         <varlistentry>
           <term>Size</term>
           <listitem>
-            <itemizedlist>
-              <listitem>
-                <para>
-                  <guilabel>Radius</guilabel>:
-                  This slider and its input boxes let you control the
-                  Cylinder diameter. Unfortunately, this setting works on the
-                  image mapped onto the cylinder and resamples this image to
-                  adapt it to the new cylinder size. It would be better to
-                  have the possibility of setting size cylinder before mapping
-                  so that we could map a whole image.
-                </para>
-              </listitem>
-              <listitem>
-                <para>
-                  <guilabel>Length</guilabel>: Controls cylinder length.
-                </para>
-              </listitem>
-            </itemizedlist>
+            <variablelist>
+              <varlistentry>
+                <term><guilabel>Radius</guilabel></term>
+                <listitem>
+                  <para>
+                    This slider and its input boxes let you control the
+                    Cylinder diameter. Unfortunately, this setting works on the
+                    image mapped onto the cylinder and resamples this image to
+                    adapt it to the new cylinder size. It would be better to
+                    have the possibility of setting size cylinder before mapping
+                    so that we could map a whole image.
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Length</guilabel></term>
+                <listitem>
+                  <para>
+                    Controls cylinder length.
+                  </para>
+                </listitem>
+              </varlistentry>
+            </variablelist>
           </listitem>
         </varlistentry>
       </variablelist>
diff --git a/src/filters/map/papertile.xml b/src/filters/map/papertile.xml
index 77b4c14..4be111c 100644
--- a/src/filters/map/papertile.xml
+++ b/src/filters/map/papertile.xml
@@ -90,23 +90,27 @@
       <varlistentry>
         <term>Movement</term>
         <listitem>
-          <itemizedlist>
-            <listitem>
-              <para>
-                <guilabel>Max%</guilabel>
-                is the maximum displacement percentage against the side size
-                of squares.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Wrap around</guilabel>:
-                As tiles move, some can go out image borders. If this option
-                is checked, what goes out on one side goes in on the opposite
-                side.
-              </para>
-            </listitem>
-          </itemizedlist>
+          <variablelist>
+            <varlistentry>
+              <term><guilabel>Max (%)</guilabel></term>
+              <listitem>
+                <para>
+                  This is the maximum displacement percentage against the side
+                  size of squares.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Wrap around</guilabel></term>
+              <listitem>
+                <para>
+                  As tiles move, some can go out image borders. If this option
+                  is checked, what goes out on one side goes in on the
+                  opposite side.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -116,27 +120,34 @@
             Because of image cutting, original pixels can persist. There are
             three ways treating them:
           </para>
-          <itemizedlist>
-            <listitem>
-              <para>
-                <guilabel>Background</guilabel>: Remaining pixels will be
-                replaced with the background type defined in the following
-                section.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Ignore</guilabel>: Background Type option is
-                not taken into account and remaining pixels are kept.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Force</guilabel>: Remaining pixels will be cut
-                also.
-              </para>
-            </listitem>
-          </itemizedlist>
+          <variablelist>
+            <varlistentry>
+              <term><guilabel>Background</guilabel></term>
+              <listitem>
+                <para>
+                  Remaining pixels will be replaced with the background type
+                  defined in the following section.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Ignore</guilabel></term>
+              <listitem>
+                <para>
+                  <guilabel>Background Type</guilabel> option is not taken
+                  into account and remaining pixels are kept.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Force</guilabel></term>
+              <listitem>
+                <para>
+                  Remaining pixels will be cut also.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -147,46 +158,62 @@
             <guilabel>Background</guilabel> radio-button is checked, among
             six options:
           </para>
-          <itemizedlist>
-            <listitem>
-              <para>
-                <guilabel>Transparent</guilabel>: Background will be
-                transparent.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Inverted image</guilabel>: Background colors
-                will be inverted (255-value in every color channel).
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Image</guilabel>: Background colors
-                will be unchanged. The original image is the background.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Foreground Color</guilabel>: Remaining pixels
-                will be replaced by the Foreground color of Toolbox.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Background Color</guilabel>: Remaining pixels
-                will be replaced by the Background color of Toolbox.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Select here</guilabel>: When this radio-button
-                is checked, clicking in the color dwell will open a Color
-                Selector where you can select the color you want for
-                background.
-              </para>
-            </listitem>
-          </itemizedlist>
+          <variablelist>
+            <varlistentry>
+              <term><guilabel>Transparent</guilabel></term>
+              <listitem>
+                <para>
+                  Background will be transparent.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Inverted image</guilabel></term>
+              <listitem>
+                <para>
+                  Background colors will be inverted (255-value in every color
+                  channel).
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Image</guilabel></term>
+              <listitem>
+                <para>
+                  Background colors will be unchanged. The original image is
+                  the background.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Foreground color</guilabel></term>
+              <listitem>
+                <para>
+                  Remaining pixels will be replaced by the Foreground color of
+                  Toolbox.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Background color</guilabel></term>
+              <listitem>
+                <para>
+                  Remaining pixels will be replaced by the Background color of
+                  Toolbox.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Select here</guilabel></term>
+              <listitem>
+                <para>
+                  When this radio-button is checked, clicking in the color
+                  dwell will open a Color Selector where you can select the
+                  color you want for background.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
         </listitem>
       </varlistentry>
       <varlistentry>
diff --git a/src/filters/map/smalltiles.xml b/src/filters/map/smalltiles.xml
index 991f25d..5a87101 100644
--- a/src/filters/map/smalltiles.xml
+++ b/src/filters/map/smalltiles.xml
@@ -70,13 +70,47 @@
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Number of Segments</term>
+        <term>Flip</term>
         <listitem>
           <para>
-            <guilabel>n²</guilabel> means <quote>the image into n to
-            the power of two tiles</quote>, where <quote>n</quote> is the
-            number  you set with the slider or its input box. n = 3 will
-            make nine tiles in the image.
+            You can flip tiles according to the
+            <guilabel>Horizontal</guilabel> or/and
+            <guilabel>Vertical</guilabel> axis by checking the corresponding
+            option(s).
+          </para>
+          <para>
+            You can also decide which tiles will be flipped:
+            <variablelist>
+              <varlistentry>
+                <term><guilabel>All tiles</guilabel></term>
+                <listitem>
+                  <para>
+                    No comment.
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Alternate tiles</guilabel></term>
+                <listitem>
+                  <para>
+                    Only odd tiles will be flipped.
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Explicit tile</guilabel></term>
+                <listitem>
+                  <para>
+                    You can define a particular tile using both
+                    <guilabel>Row</guilabel> and <guilabel>Column</guilabel>
+                    input boxes.  This tile will be marked with a box in
+                    Preview. Press <guibutton>Apply</guibutton> to mark this
+                    explicit tile. Repeat this procedure to mark more than one
+                    tile.
+                  </para>
+                </listitem>
+              </varlistentry>
+            </variablelist>
           </para>
         </listitem>
       </varlistentry>
@@ -91,37 +125,13 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Flip</term>
+        <term>Number of Segments</term>
         <listitem>
           <para>
-            You can flip tiles according to the
-            <guilabel>Horizontal</guilabel> or/and
-            <guilabel>Vertical</guilabel> axis by checking the corresponding
-            option(s).
-          </para>
-          <para>
-            You can also decide which tiles will be flipped:
-            <itemizedlist>
-              <listitem>
-                <para>
-                  <guilabel>All tiles</guilabel>: no comment.
-                </para>
-              </listitem>
-              <listitem>
-                <para>
-                  <guilabel>Alternate tiles</guilabel>: only odd tiles will
-                  be flipped.
-                </para>
-              </listitem>
-              <listitem>
-                <para>
-                  <guilabel>Explicit tile</guilabel>: you can define, a
-                  particular tile by using both <guilabel>Line</guilabel>
-                  and <guilabel>Column</guilabel> input boxes. This tile
-                  will be marked with a box in Preview.
-                </para>
-              </listitem>
-            </itemizedlist>
+            <guilabel>n²</guilabel> means <quote>the image into n to
+            the power of two tiles</quote>, where <quote>n</quote> is the
+            number  you set with the slider or its input box. n = 3 will
+            make nine tiles in the image.
           </para>
         </listitem>
       </varlistentry>
diff --git a/src/filters/map/tile.xml b/src/filters/map/tile.xml
index 6f8670d..3d01a47 100644
--- a/src/filters/map/tile.xml
+++ b/src/filters/map/tile.xml
@@ -70,9 +70,10 @@
       </mediaobject>
     </figure>
     <variablelist>
-      <title>Tile to new size</title>
+      <title>Tile to New Size</title>
       <varlistentry>
-        <term>Width/Height</term>
+        <term>Width</term>
+        <term>Height</term>
         <listitem>
           <para>
             Input boxes and their arrow-heads allow you to enter the
@@ -89,17 +90,16 @@
             this chain. You can choose a unit else than pixel by clicking on
             the drop-down list button.
           </para>
-          <para><emphasis>
-              The new image must be bigger than the original one
-            </emphasis>.
-            Else, you will get an image sample only. Choose sizes which are
-            multiple of original sizes if you don't want to have truncated
-            tiles.
+          <para>
+            <emphasis>The new image must be bigger than the original
+            one</emphasis>. Else, you will get an image sample only. Choose
+            sizes which are multiple of original sizes if you don't want to
+            have truncated tiles.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Create New image</term>
+        <term>Create new image</term>
         <listitem>
           <para>
             It's in your interest to keep this option checked to avoid
diff --git a/src/filters/map/warp.xml b/src/filters/map/warp.xml
index 82753bd..57547d2 100644
--- a/src/filters/map/warp.xml
+++ b/src/filters/map/warp.xml
@@ -111,7 +111,7 @@
     <variablelist>
       <title>Basic Options</title>
       <varlistentry>
-        <term>Step Size</term>
+        <term>Step size</term>
         <listitem>
           <para>
             <quote>Step</quote> is displacement distance for every filter
@@ -125,13 +125,12 @@
         <term>Iterations</term>
         <listitem>
           <para>
-            <guilabel>Iteration</guilabel> is the number of repetitions of
-            effect when applying filter.
+            The number of repetitions of effect when applying filter.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>On Edges</term>
+        <term>On edges</term>
         <listitem>
           <para>
             Because of displacement, a part of pixels are driven over the
@@ -139,45 +138,53 @@
             places are emptying. Four following options allow you to fix this
             issue:
           </para>
-          <itemizedlist>
-            <listitem>
-              <para>
-                <guilabel>Warp</guilabel>
-                (default): What goes out on one side is going into the
-                opposite side.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Smear</guilabel>:
-                Emptying places are filled with a spreading of the
-                neighbouring image line.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>Black</guilabel>
-                : Emptying places are filled with black color.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                <guilabel>FG Color</guilabel>
-                : Emptying places are filled with the Foreground color of the
-                color area in Toolbox.
-              </para>
-            </listitem>
-          </itemizedlist>
+          <variablelist>
+            <varlistentry>
+              <term><guilabel>Warp</guilabel></term>
+              <listitem>
+                <para>
+                  What goes out on one side is going into the opposite side
+                  (this is the default).
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Smear</guilabel></term>
+              <listitem>
+                <para>
+                  Emptying places are filled with a spreading of the
+                  neighbouring image line.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Black</guilabel></term>
+              <listitem>
+                <para>
+                  Emptying places are filled with black color.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Foreground color</guilabel></term>
+              <listitem>
+                <para>
+                  Emptying places are filled with the Foreground color of the
+                  color area in Toolbox.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Displacement Map</term>
+        <term>Displacement map</term>
         <listitem>
           <para>
-            To be listed in this drop-down list, the displacement map,
-            which is a grey-scaled image, must be <emphasis>present on
-              your screen when you call filter and must have the same size
-              as the original image</emphasis>.
+            To be listed in this drop-down list, the displacement map, which
+            should be a grayscaled image, must be <emphasis>present on your
+            screen when you call filter and must have the same size as the
+            original image</emphasis>.
           </para>
         </listitem>
       </varlistentry>
@@ -185,7 +192,7 @@
     <variablelist>
       <title>Advanced Options</title>
       <varlistentry>
-        <term>Dither Size</term>
+        <term>Dither size</term>
         <listitem>
           <para>
             Once all pixels displaced, this option scatters them randomly,
@@ -204,7 +211,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Rotation Angle</term>
+        <term>Rotation angle</term>
         <listitem>
           <para>
             This option sets displacement angle of pixels according to the
@@ -233,21 +240,33 @@
         </listitem>
       </varlistentry>
       <varlistentry>
+        <term>Substeps</term>
+        <listitem>
+          <!-- CHECK: I'm unsure whether this is (a) makes senses, and
+               (b) is correct... :-| (ude, 2010-07-19) -->
+          <para>
+            If you specify a value > 1, the displacement vector is computed in
+            several substeps, giving you a finer control to the displace
+            process.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
         <term>Magnitude map</term>
         <listitem>
           <para>
-            In addition to displacement map, you can add a
-            <guilabel>Magnitude Map</guilabel>. This map is also a
-            grey-scaled image, with the same size as the source image and
-            which must be present on your screen when you call filter.
-            This map gives more or less strength to filter on some parts
-            of the image, according to the grey levels of this magnitude
-            map. Image areas corresponding to white parts of this map will
-            undergo all the strength of filter. Image areas corresponding
-            to black parts of the map will be spared by filter.
+            In addition to displacement map, you can add a Magnitude map. This
+            map should also be a grayscaled image, with the same size as the
+            source image and which must be present on your screen when you
+            call filter.  This map gives more or less strength to filter on
+            some parts of the image, according to the grey levels of this
+            magnitude map. Image areas corresponding to white parts of this
+            map will undergo all the strength of filter. Image areas
+            corresponding to black parts of the map will be spared by filter.
             Intermediate grey levels will lessen filter action on
-            corresponding areas of the image. <guilabel>Use magnitude
-              map</guilabel> must be checked for that.
+            corresponding areas of the image.
+            <guilabel>Use&nbsp;magnitude&nbsp;map</guilabel> must be checked
+            for that.
           </para>
           <figure>
             <title>Magnitude Map example:</title>
@@ -282,18 +301,19 @@
         </para>
       </note>
       <varlistentry>
-        <term>The Gradient Map</term>
+        <term>Gradient scale</term>
         <listitem>
-          <para><emphasis>The gradient map</emphasis> is also a grayscaled map.
-            Here, the displacement of pixels depends on the direction of
+          <para>
+            Using a gradient map, (this map should also be a grayscaled
+            image), the displacement of pixels depends on the direction of
             grayscale transitions. The <guilabel>Gradient scale</guilabel>
             option lets you set how much the grayscale variations will
-            influence the displacement of pixels.
-            On every iteration, the filter works of the whole image, not
-            only on the red object: this explains burredness.
+            influence the displacement of pixels. On every iteration, the
+            filter works of the whole image, not only on the red object: this
+            explains burredness.
           </para>
           <figure>
-            <title>Gradient map example</title>
+            <title>Gradient scale example</title>
             <mediaobject>
               <imageobject>
                 <imagedata format="PNG"
@@ -301,23 +321,33 @@
               </imageobject>
               <caption>
                 <para>
-                  From left to right: original image, displacement map,
-                  after applying <quote>Warp</quote> filter with a Gradient
-                  Scale map. Gradient is oblique, from top left to right
-                  bottom. The part of the image corresponding to the gradient
-                  is moved obliquely, 90° rotated (Rotation Angle 90° in
-                  Advanced options).
+                  From left to right: original image, Gradient map, filter
+                  applied.
                 </para>
               </caption>
             </mediaobject>
           </figure>
+          <para>
+            In the example above, <quote>Warp</quote> filter is applied with a
+            gradient map (Gradient scale = 10.0). Gradient is oblique, from
+            top left to right bottom. The part of the image corresponding to
+            the gradient is moved obliquely, 90° rotated (Rotation angle 90°
+            in Advanced Options).
+          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>The Vector Map</term>
+        <term>Vector mag</term>
         <listitem>
+          <para>
+            With this map, the displacement depends on the angle you set in
+            the <guilabel>Angle</guilabel> text box. 0° is upwards.  Angles go
+            counter-clockwise. The <emphasis>vector control map</emphasis>
+            determines by how many pixels the image will move on every
+            iteration.
+          </para>
           <figure>
-            <title>Vector map example</title>
+            <title>Vector mag example</title>
             <mediaobject>
               <imageobject>
                 <imagedata format="PNG"
@@ -326,24 +356,26 @@
               <caption>
                 <para>
                   From left to right: original image, displacement map,
-                  after applying <quote>Warp</quote> filter with a Vector
-                  map. Gradient is vertical, from top to bottom. Vector angle
-                  is 45°. The image is moved obliquely, 45° to the top left
-                  corner. The image is blurred because every iteration works
-                  on the whole image, and not only on the red bar.
+                  filter applied.
                 </para>
               </caption>
             </mediaobject>
           </figure>
           <para>
-            With this map, the displacement depends on the angle you set
-            in the <guilabel>Angle</guilabel> text box. 0° is upwards.
-            Angles go counter-clockwise. The <guilabel>Vector Magnitude
-            </guilabel> determines by how many pixels the image will move on
-            every iteration.
+            In the above example, <quote>Warp</quote> filter is applied with a
+            Vector mag. Gradient is vertical, from top to bottom. Vector angle
+            is 45°. The image is moved obliquely, 45° to the top left corner.
+            The image is blurred because every iteration works on the whole
+            image, and not only on the red bar.
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Angle</term>
+        <listitem>
+          <para>Angle for fixed vector map (see above).</para>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 </sect2>



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