[gimp-help] Update Tile Paper filter

[Julien Hardlin <jhardlin src gnome org>]

commit cea0032f2293886ab06313992054cbdab323290e
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Mar 3 07:57:42 2019 +0100

    Update Tile Paper filter

 images/C/filters/map/paper_tile-dialog.png | Bin 0 -> 31692 bytes
 images/C/filters/map/papertile.png         | Bin 21305 -> 0 bytes
 src/filters/map.xml                        |   6 +-
 src/filters/map/papertile.xml              | 137 ++++++++++++++---------------
 4 files changed, 72 insertions(+), 71 deletions(-)
---
diff --git a/images/C/filters/map/paper_tile-dialog.png b/images/C/filters/map/paper_tile-dialog.png
new file mode 100644
index 000000000..7be1f5ec8
Binary files /dev/null and b/images/C/filters/map/paper_tile-dialog.png differ
diff --git a/src/filters/map.xml b/src/filters/map.xml
index 3b6fc4d5f..a86a5989a 100644
--- a/src/filters/map.xml
+++ b/src/filters/map.xml
@@ -18,10 +18,12 @@
   <xi:include href="map/little-planet.xml"/>
   <xi:include href="map/panorama-projection.xml"/>
   <xi:include href="map/recursive-transform.xml"/>
+  <xi:include href="map/papertile.xml"/>
+  <xi:include href="map/tile.xml"/>
   <xi:include href="map/make-seamless.xml"/>
   <xi:include href="map/map-object.xml"/>
-  <xi:include href="map/papertile.xml"/>
+  
   <xi:include href="map/smalltiles.xml"/>
-  <xi:include href="map/tile.xml"/>
+  
   <xi:include href="map/warp.xml"/>
 </sect1>
diff --git a/src/filters/map/papertile.xml b/src/filters/map/papertile.xml
index 99903d9ce..9780d6f1c 100644
--- a/src/filters/map/papertile.xml
+++ b/src/filters/map/papertile.xml
@@ -2,12 +2,10 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-09-05 AntI: added 'es'
-  2007-05-07 KoSt: added 'no'
-  2006-12-23 lexa: added de translation
+  2019-03-02 j.h: update to v2.10
   2005-11-15: created by julien hardelin
 -->
-<sect2 id="gimp-filter-tile-paper">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-tile-paper">
   <title>Paper Tile</title>
 
   <indexterm>
@@ -70,51 +68,51 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/map/papertile.png"/>
+            fileref="images/filters/map/paper_tile-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Division</term>
+        <term>Presets, Preview, Split view</term>
         <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Tile Width/Height</term>
+        <listitem>
+          <para>
+            Filter starts cutting image before it displaces pieces; so, piece 
+            size and number of pieces in horizontal (Width) and vertical 
+            (Height) directions must be convenient to image size.
+          </para>
           <para>
-            <guilabel>X</guilabel>, <guilabel>Y</guilabel> and <guilabel>
-            Size</guilabel> parameters are linked, because filter starts
-            cutting image before it displaces pieces; so, piece size and
-            number of pieces in horizontal (X) and vertical (Y) directions
-            must be convenient to image size.
+            When these options are linked, tiles are square.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Movement</term>
+        <term>Move rate</term>
         <listitem>
-          <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>
+          <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>
       <varlistentry>
-        <term>Fractional Pixels</term>
+        <term>Fractional type</term>
         <listitem>
           <para>
             Because of image cutting, original pixels can persist. There are
@@ -122,11 +120,10 @@
           </para>
           <variablelist>
             <varlistentry>
-              <term><guilabel>Background</guilabel></term>
+              <term><guilabel>Force</guilabel></term>
               <listitem>
                 <para>
-                  Remaining pixels will be replaced with the background type
-                  defined in the following section.
+                  Remaining pixels will be cut also.
                 </para>
               </listitem>
             </varlistentry>
@@ -140,16 +137,26 @@
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term><guilabel>Force</guilabel></term>
+              <term><guilabel>Background</guilabel></term>
               <listitem>
                 <para>
-                  Remaining pixels will be cut also.
+                  Remaining pixels will be replaced with the background type
+                  defined in the following section.
                 </para>
               </listitem>
             </varlistentry>
           </variablelist>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Centering</term>
+        <listitem>
+          <para>
+            If this option is checked, tiles will rather be gathered together
+            in the center of the image.
+          </para>
+        </listitem>
+      </varlistentry>
       <varlistentry>
         <term>Background Type</term>
         <listitem>
@@ -159,14 +166,6 @@
             six options:
           </para>
           <variablelist>
-            <varlistentry>
-              <term><guilabel>Transparent</guilabel></term>
-              <listitem>
-                <para>
-                  Background will be transparent.
-                </para>
-              </listitem>
-            </varlistentry>
             <varlistentry>
               <term><guilabel>Inverted image</guilabel></term>
               <listitem>
@@ -177,39 +176,30 @@
               </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>
+              <term><guilabel>Transparent</guilabel></term>
               <listitem>
                 <para>
-                  Remaining pixels will be replaced by the Foreground color of
-                  Toolbox.
+                  Background will be transparent.
                 </para>
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term><guilabel>Background color</guilabel></term>
+              <term><guilabel>Image</guilabel></term>
               <listitem>
                 <para>
-                  Remaining pixels will be replaced by the Background color of
-                  Toolbox.
+                  Background colors will be unchanged. The original image is
+                  the background.
                 </para>
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term><guilabel>Select here</guilabel></term>
+              <term><guilabel>Color</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.
+                  Remaining pixels will be replaced by the color you can 
+                  select. Default is the Foreground color of toolbox. You can 
+                  choose another color using the color dwell or the color 
+                  picker.
                 </para>
               </listitem>
             </varlistentry>
@@ -217,11 +207,20 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Centering</term>
+        <term>Random seed</term>
         <listitem>
           <para>
-            If this option is checked, tiles will rather be gathered together
-            in the center of the image.
+            Tile displacement can be done at random.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Use the selection as input/Use the entire layer as input</term>
+        <listitem>
+          <para>
+            If there is a selection, transformation will be done in the 
+            selection from the selected part of the image or from the entire 
+            layer.
           </para>
         </listitem>
       </varlistentry>