[gimp-help] Update Sinus filter

[Julien Hardlin <jhardlin src gnome org>]

commit f9bdafa305c347fa3dae72509bf91e05d9d8f3ab
Author: Julien Hardelin <jhardlin orange fr>
Date:   Mon Mar 11 18:42:29 2019 +0100

    Update Sinus filter

 images/C/filters/render/sinus-dialog.png | Bin 0 -> 30293 bytes
 images/C/filters/render/sinus1.png       | Bin 21228 -> 0 bytes
 images/C/filters/render/sinus2.png       | Bin 10629 -> 0 bytes
 images/C/filters/render/sinus3.png       | Bin 7940 -> 0 bytes
 src/filters/render/sinus.xml             | 263 ++++++++++++-------------------
 5 files changed, 105 insertions(+), 158 deletions(-)
---
diff --git a/images/C/filters/render/sinus-dialog.png b/images/C/filters/render/sinus-dialog.png
new file mode 100644
index 000000000..98271a1cb
Binary files /dev/null and b/images/C/filters/render/sinus-dialog.png differ
diff --git a/src/filters/render/sinus.xml b/src/filters/render/sinus.xml
index 42a1c28e1..575ea28c2 100644
--- a/src/filters/render/sinus.xml
+++ b/src/filters/render/sinus.xml
@@ -2,11 +2,9 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-05-18 KoSt: added 'no'
-  2005-12-08 <simplesect> replaced by <sect3> by lexa
-  2005/09/21 de added by axel.wernicke
+  2019-03-11 j.h: update to v2.10
 -->
-<sect2 id="gimp-filter-sinus">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-sinus">
   <title>Sinus</title>
 
   <indexterm>
@@ -54,163 +52,112 @@
       the function: a high value creates more interference or
       repetition in the pattern.  An example is shown below.
     </para>
+    <para>
+      Results don't depend on the image you opened.
+    </para>
   </sect3>
 
   <sect3>
     <title>Options</title>
-
-    <sect4>
-      <title>Settings</title>
-      <figure>
-        <title><quote>Sinus</quote> filter options (Settings)</title>
-        <mediaobject>
-          <imageobject>
-            <imagedata format="PNG"
-              fileref="images/filters/render/sinus1.png"/>
-          </imageobject>
-        </mediaobject>
-      </figure>
-      <variablelist>
-        <title>Drawing Settings</title>
-        <varlistentry>
-          <term>X scale</term>
-          <term>Y scale</term>
-          <listitem>
-            <para>
-              A low X/Y value will maximize the horizontal/vertical
-              stretch of the texture, whereas a high value will compress
-              it.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>Complexity</term>
-          <listitem>
-            <para>
-              This controls how the two colors interact with each other
-              (the amount of interplay or repetition).
-            </para>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-      <variablelist>
-        <title>Calculation Settings</title>
-        <varlistentry>
-          <term>Random seed</term>
-          <listitem>
-            <para>
-              This option controls the random
-              behaviour of the filter. If the same random seed in the
-              same situation is used, the filter produces exactly the
-              same results. A different random seed produces different
-              results. Random seed can be entered manually or generated
-              randomly by pressing the <guibutton>New Seed</guibutton>
-              button.
-            </para>
-            <para>
-              When the <guilabel>Randomize</guilabel> option is checked,
-              random seed cannot be entered manually, but is randomly
-              generated each time the filter is run. If it is not
-              checked, the filter remembers the last random seed used.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>Force tiling?</term>
-          <listitem>
-            <para>
-              If you check this, you'll get a pattern that can be
-              used for tiling. For example, you can use it as a
-              background in an HTML page, and the tile edges will be
-              joined seamlessly.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>Ideal</term>
-          <term>Distorted</term>
-          <listitem>
-            <para>
-              This options give additional control of the interaction between
-              the two colors. <quote>Distorted</quote> creates a more
-              distorted interference between the two colors than
-              <quote>Ideal</quote>.
-            </para>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-    </sect4>
-
-    <sect4>
-      <title>Colors</title>
-      <figure>
-        <title><quote>Sinus</quote> filter options (Colors)</title>
-        <mediaobject>
-          <imageobject>
-            <imagedata format="PNG"
-              fileref="images/filters/render/sinus2.png"/>
-          </imageobject>
-        </mediaobject>
-      </figure>
-      <variablelist>
-        <varlistentry>
-          <term>Colors</term>
-          <listitem>
-            <para>
-              Here, you set the two colors that make up your texture. You can
-              use <guilabel>Black &amp; white</guilabel> or the
-              <guilabel>Foreground &amp; background</guilabel> colors in the
-              toolbox, or you can <guilabel>Choose</guilabel> a color with the
-              color icons.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>Alpha Channels</term>
-          <listitem>
-            <para>
-              This sliders allow you to assign an opacity to each of the
-              colors. (If the layer you are working on does not have an alpha
-              channel, they will be grayed out.)
-            </para>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-    </sect4>
-
-    <sect4>
-      <title>Blend</title>
-      <figure>
-        <title><quote>Sinus</quote> filter options (Blend)</title>
-        <mediaobject>
-          <imageobject>
-            <imagedata format="PNG"
-              fileref="images/filters/render/sinus3.png"/>
-          </imageobject>
-        </mediaobject>
-      </figure>
-      <variablelist>
-        <varlistentry>
-          <term>Gradient</term>
-          <listitem>
-            <para>
-              You can choose between three functions to set the shapes of the
-              waves that are produced:  Linear, Bilinear and Sinusoidal.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>Exponent</term>
-          <listitem>
-            <para>
-              The Exponent controls which of the two colors is dominant, and
-              how dominant it is. If you set the exponent to -7.5, the left
-              color will dominate totally, and if you set it to +7.5 it will
-              be the other way around. A zero value is neutral.
-            </para>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-    </sect4>
+    <figure>
+      <title><quote>Sinus</quote> filter options (Settings)</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/render/sinus-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>X scale</term>
+        <term>Y scale</term>
+        <listitem>
+          <para>
+            A low X/Y value will maximize the horizontal/vertical
+            stretch of the texture, whereas a high value will compress
+            it.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Complexity</term>
+        <listitem>
+          <para>
+            This controls how the two colors interact with each other
+            (the amount of interplay or repetition).
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Random seed</term>
+        <listitem>
+          <para>
+            This option controls the random
+            behavior of the filter. If the same random seed in the
+            same situation is used, the filter produces exactly the
+            same results. A different random seed produces different
+            results. Random seed can be entered manually or generated
+            randomly by pressing the <guibutton>New Seed</guibutton>
+            button.
+          </para>
+          <para>
+            When the <guilabel>Randomize</guilabel> option is checked,
+            random seed cannot be entered manually, but is randomly
+            generated each time the filter is run. If it is not
+            checked, the filter remembers the last random seed used.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Force tiling</term>
+        <listitem>
+          <para>
+            If you check this, you'll get a pattern that can be
+            used for tiling. For example, you can use it as a
+            background in an HTML page, and the tile edges will be
+            joined seamlessly.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Distorted</term>
+        <listitem>
+          <para>
+            This options give additional control of the interaction between
+            the two colors.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Color 1, Color 2</term>
+        <listitem>
+          <para>
+            Here, you set the two colors that make up your texture. Default 
+            colors are yellow and blue. 
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Blend Mode</term>
+        <listitem>
+          <para>
+            You can choose between three functions to set the shapes of the
+            waves that are produced:  Linear, Bilinear and Sinusoidal.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Exponent</term>
+        <listitem>
+          <para>
+            The Exponent controls which of the two colors is dominant, and
+            how dominant it is. If you set the exponent to -7.5, the left
+            color will dominate totally, and if you set it to +7.5 it will
+            be the other way around. A zero value is neutral.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
   </sect3>
 </sect2>