[gimp-help] Updates inn artistic filters



commit 2d7394418dff8350b470b9204712ebb66eecdf0b
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Jan 27 15:30:07 2019 +0100

    Updates inn artistic filters

 images/C/filters/artistic/apply_canvas-dialog.png  | Bin 0 -> 18907 bytes
 images/C/filters/artistic/cartoon-dialog.png       | Bin 0 -> 17355 bytes
 images/C/filters/artistic/cubism-dialog.png        | Bin 0 -> 22088 bytes
 images/C/filters/artistic/glass_tile-dialog.png    | Bin 0 -> 18945 bytes
 images/C/filters/artistic/oilify-dialog.png        | Bin 0 -> 20595 bytes
 images/C/filters/artistic/photocopy-dialog.png     | Bin 0 -> 22265 bytes
 images/C/filters/artistic/softglow-dialog.png      | Bin 0 -> 19797 bytes
 images/C/filters/artistic/waterpixels-dialog.png   | Bin 0 -> 23649 bytes
 src/filters/artistic.xml                           |  13 +-
 src/filters/artistic/applycanvas.xml               |  24 ++--
 src/filters/artistic/cartoon-legacy.xml            | 100 ++++++++++++++++
 src/filters/artistic/cartoon.xml                   |  15 ++-
 src/filters/artistic/cubism.xml                    |  17 +--
 .../{light-and-shadow => artistic}/glasstile.xml   |  29 ++---
 src/filters/artistic/oilify-legacy.xml             | 131 +++++++++++++++++++++
 src/filters/artistic/oilify.xml                    |  39 ++----
 src/filters/artistic/photocopy.xml                 |  17 +--
 src/filters/artistic/softglow-legacy.xml           | 111 +++++++++++++++++
 src/filters/artistic/softglow.xml                  |  16 +--
 src/filters/artistic/waterpixels.xml               |  86 ++++++++++++++
 20 files changed, 495 insertions(+), 103 deletions(-)
---
diff --git a/images/C/filters/artistic/apply_canvas-dialog.png 
b/images/C/filters/artistic/apply_canvas-dialog.png
new file mode 100644
index 000000000..fdcbe7ae3
Binary files /dev/null and b/images/C/filters/artistic/apply_canvas-dialog.png differ
diff --git a/images/C/filters/artistic/cartoon-dialog.png b/images/C/filters/artistic/cartoon-dialog.png
new file mode 100644
index 000000000..13cb99ad9
Binary files /dev/null and b/images/C/filters/artistic/cartoon-dialog.png differ
diff --git a/images/C/filters/artistic/cubism-dialog.png b/images/C/filters/artistic/cubism-dialog.png
new file mode 100644
index 000000000..f1d57c98f
Binary files /dev/null and b/images/C/filters/artistic/cubism-dialog.png differ
diff --git a/images/C/filters/artistic/glass_tile-dialog.png b/images/C/filters/artistic/glass_tile-dialog.png
new file mode 100644
index 000000000..de10e3de6
Binary files /dev/null and b/images/C/filters/artistic/glass_tile-dialog.png differ
diff --git a/images/C/filters/artistic/oilify-dialog.png b/images/C/filters/artistic/oilify-dialog.png
new file mode 100644
index 000000000..e9b64c16c
Binary files /dev/null and b/images/C/filters/artistic/oilify-dialog.png differ
diff --git a/images/C/filters/artistic/photocopy-dialog.png b/images/C/filters/artistic/photocopy-dialog.png
new file mode 100644
index 000000000..87592a5b7
Binary files /dev/null and b/images/C/filters/artistic/photocopy-dialog.png differ
diff --git a/images/C/filters/artistic/softglow-dialog.png b/images/C/filters/artistic/softglow-dialog.png
new file mode 100644
index 000000000..0071f3396
Binary files /dev/null and b/images/C/filters/artistic/softglow-dialog.png differ
diff --git a/images/C/filters/artistic/waterpixels-dialog.png 
b/images/C/filters/artistic/waterpixels-dialog.png
new file mode 100644
index 000000000..5e03fd5ec
Binary files /dev/null and b/images/C/filters/artistic/waterpixels-dialog.png differ
diff --git a/src/filters/artistic.xml b/src/filters/artistic.xml
index 7aa819958..2490860f4 100644
--- a/src/filters/artistic.xml
+++ b/src/filters/artistic.xml
@@ -2,10 +2,9 @@
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
+  2019-01-21 j.h update to v2.10
   2010-05-07 ude: let GIMPressionist include orientation & size map editor
   2007-08-08 ude: moved Van Gogh (LIC) from map filters
-  2007-04-28 KoSt: added 'no'
-  2005-09-03 de added by axel.wernicke
 -->
 <sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="filters-artistic">
   <title>Artistic Filters</title>
@@ -13,18 +12,18 @@
   <xi:include href="artistic/applycanvas.xml"/>
   <xi:include href="artistic/cartoon.xml"/>
   <xi:include href="artistic/cubism.xml"/>
-  <!--<xi:include href="artistic/glasstile.xml"/>-->
+  <xi:include href="artistic/glasstile.xml"/>
   <xi:include href="artistic/oilify.xml"/>
   <xi:include href="artistic/photocopy.xml"/>
   <xi:include href="artistic/simple-linear-clustering.xml"/>
   <xi:include href="artistic/softglow.xml"/>
-  <!--<xi:include href="artistic/waterpixel.xml"/>-->
-    <!--<xi:include href="artistic/cartoon-legacy.xml"/>-->
+  <xi:include href="artistic/waterpixels.xml"/>
+  <xi:include href="artistic/cartoon-legacy.xml"/>
   <xi:include href="artistic/clothify.xml"/>
   <xi:include href="artistic/GIMPressionist.xml"/>
-  <!--<xi:include href="artistic/oilify-legacy.xml"/>-->
+  <xi:include href="artistic/oilify-legacy.xml"/>
   <xi:include href="artistic/predator.xml"/>
-  <!--<xi:include href="artistic/softglow-legacy.xml"/>-->
+  <xi:include href="artistic/softglow-legacy.xml"/>
   <xi:include href="artistic/vangogh-lic.xml"/>
   <xi:include href="artistic/weave.xml"/>
 </sect1>
diff --git a/src/filters/artistic/applycanvas.xml b/src/filters/artistic/applycanvas.xml
index 33a4f4011..1befac8a4 100644
--- a/src/filters/artistic/applycanvas.xml
+++ b/src/filters/artistic/applycanvas.xml
@@ -2,14 +2,9 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-06-25 Added Spanish translation by AntI
-  2007-04-28 KoSt: added 'no'
-  2006-10-19 change in Direction en;fr by j.h
-  2006-02-25 fixed invalid image reference, cleaned imageobjects structure
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  2005-09-15 de added by axel.wernicke
+  2019-01-21 j.h update to v2.10
 -->
-<sect2 id="gimp-filter-apply-canvas">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-apply-canvas">
   <title>Apply Canvas</title>
 
   <indexterm>
@@ -73,18 +68,15 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/artistic/applycanvas.png"/>
+            fileref="images/filters/artistic/apply_canvas-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term>Presets, Preview, Split view</term>
         <listitem>
-          <para>
-            Your changes are displayed in this preview before being applied
-            to your image.
-          </para>
+          <xi:include href="../about-common-features.xml"/>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -106,6 +98,12 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Use the selection as input, Use the entire layer as input</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 </sect2>
diff --git a/src/filters/artistic/cartoon-legacy.xml b/src/filters/artistic/cartoon-legacy.xml
new file mode 100644
index 000000000..7cd6c1167
--- /dev/null
+++ b/src/filters/artistic/cartoon-legacy.xml
@@ -0,0 +1,100 @@
+<?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";>
+<!-- section history:
+  2019-01-26 j.h update to v2.10
+-->
+<sect2 id="plug-in-cartoon">
+  <title>Cartoon (legacy)</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Artistic</secondary>
+    <tertiary>Cartoon (legacy)</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Cartoon (legacy)</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Example for the <quote>Cartoon (legacy)</quote> filter</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Original image</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/artistic-taj-cartoon.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Filter <quote>Cartoon(legacy)</quote> applied</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      The Cartoon filter modifies the active layer or selection so that it
+      looks like a cartoon drawing. Its result is similar to a black felt pen
+      drawing subsequently shaded with color. This is achieved by darkening
+      areas that are already distinctly darker than their neighborhood.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Activate the filter</title>
+    <para>
+      You can find this filter in
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Artistic</guisubmenu>
+        <guimenuitem>Cartoon (legacy)…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Cartoon</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/artistic/cartoon.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Mask radius</term>
+        <listitem>
+          <para>
+            This parameter controls the size of areas the filter works with.
+            Large values result in very thick black areas and much less detail
+            in the resulting image. Small values result in more subtle pen
+            strokes and more details preserved.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Percent black</term>
+        <listitem>
+          <para>
+            This parameter controls the amount of black color added to the
+            image. Small values make the blend from color regions to blackened
+            areas smoother and dark lines themselves thinner and less
+            noticeable. Larger values make the lines thicker, darker and
+            sharper. The maximum value makes the lines aliased. The best, most
+            natural results are usually achieved with an intermediate value.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
diff --git a/src/filters/artistic/cartoon.xml b/src/filters/artistic/cartoon.xml
index e5780635c..c2521f3f4 100644
--- a/src/filters/artistic/cartoon.xml
+++ b/src/filters/artistic/cartoon.xml
@@ -2,12 +2,9 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-06-25 Added Spanish translation by AntI
-  2007-04-29 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  2005-09-15 de added by axel.wernicke
+  2019-01-21 j.h update to v2.10
 -->
-<sect2 id="gimp-filter-cartoon">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-cartoon">
   <title>Cartoon</title>
 
   <indexterm>
@@ -69,11 +66,17 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/artistic/cartoon.png"/>
+            fileref="images/filters/artistic/cartoon-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
+      <varlistentry>
+        <term>Presets, Preview, Split view</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
       <varlistentry>
         <term>Mask radius</term>
         <listitem>
diff --git a/src/filters/artistic/cubism.xml b/src/filters/artistic/cubism.xml
index 699df6e1c..82b66bb5a 100644
--- a/src/filters/artistic/cubism.xml
+++ b/src/filters/artistic/cubism.xml
@@ -2,13 +2,9 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-06-25 Added Spanish translation by AntI
-  2007-05-09 ude: removed filters-artistic-cubism.png
-  2007-04-30 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  2005-09-15 de added by axel.wernicke
+  2019-01-21 j.h update to v2.10
 -->
-<sect2 id="gimp-filter-cubism">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-cubism">
   <title>Cubism</title>
 
   <indexterm>
@@ -75,18 +71,15 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/artistic/cubism.png"/>
+            fileref="images/filters/artistic/cubism-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term>Presets, Preview, Split view</term>
         <listitem>
-          <para>
-            Your changes are displayed in this preview before being applied
-            to your image.
-          </para>
+          <xi:include href="../about-common-features.xml"/>
         </listitem>
       </varlistentry>
       <varlistentry>
diff --git a/src/filters/light-and-shadow/glasstile.xml b/src/filters/artistic/glasstile.xml
similarity index 77%
rename from src/filters/light-and-shadow/glasstile.xml
rename to src/filters/artistic/glasstile.xml
index fb768a758..b4b09be98 100644
--- a/src/filters/light-and-shadow/glasstile.xml
+++ b/src/filters/artistic/glasstile.xml
@@ -2,17 +2,11 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-12-29 MikaS: updated 'fr'
-  2007-12-25 ciampix: updated 'it'
-  2007-08-24 AntI: added 'es'
-  2007-04-17 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  2005-11-25 en;fr fixed image file name by axel.wernicke
-  2005-08-30 de replaced informalfigure by axel.wernicke
-  2005-09-03 de added by axel.wernicke
+  2019-01-21 j.h transfer from Light an Shadow; update to v2.10
 -->
-<sect2 id="gimp-filter-tile-glass">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-tile-glass">
   <title>Glass Tile</title>
+  <!--Transferred from Dark and Shadow-->
 
   <indexterm>
     <primary>Filters</primary>
@@ -61,7 +55,7 @@
       <menuchoice>
         <guimenu>Filters</guimenu>
         <guisubmenu>Light and Shadow</guisubmenu>
-        <guimenuitem>Glass Tile</guimenuitem>
+        <guimenuitem>Glass Tile…</guimenuitem>
       </menuchoice>
     </para>
   </sect3>
@@ -73,18 +67,15 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/light-and-shadow/glasstile.png"/>
+            fileref="images/filters/artistic/glass_tile-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term>Presets, Preview, Split view</term>
         <listitem>
-          <para>
-            If checked, parameter setting results are interactively displayed
-            in preview. Scroll bars allow you to move around the image.
-          </para>
+          <xi:include href="../about-common-features.xml"/>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -99,6 +90,12 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Use the selection as input, Use the entire layer as input</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 </sect2>
diff --git a/src/filters/artistic/oilify-legacy.xml b/src/filters/artistic/oilify-legacy.xml
new file mode 100644
index 000000000..f5417dad0
--- /dev/null
+++ b/src/filters/artistic/oilify-legacy.xml
@@ -0,0 +1,131 @@
+<?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";>
+<!-- section history:
+  2019-01-26 j.h update to v2.10
+-->
+<sect2 id="plug-in-oilify">
+  <title>Oilify (legacy)</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Artistic</secondary>
+    <tertiary>Oilify (legacy)</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Oilify (legacy)</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Example for the <quote>Oilify (legacy)</quote> filter</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Original image</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/artistic-taj-oilify.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Filter <quote>Oilify (legacy)</quote> applied</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      This filter makes the image look like an oil painting. The
+      <guilabel>Mask size</guilabel> controls the outcome: a high value gives
+      the image less detail, as if you had used a larger brush.
+    </para>
+    <tip>
+      <para>
+        The GIMPressionist filter can produce similar effects, but
+        allows a much wider variety of options.
+      </para>
+    </tip>
+  </sect3>
+
+  <sect3>
+    <title>Activate the filter</title>
+    <para>
+      This filter is found in the image menu through
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Artistic</guisubmenu>
+        <guimenuitem>Oilify (legacy)…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Oilify (legacy)</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/artistic/oilify.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Mask size</term>
+        <listitem>
+          <para>
+            Mask size selects the size of the brush mask used to paint the
+            oily render. Larger values here produce an oilier render.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Use mask-size map</term>
+        <listitem>
+          <para>
+            You may use a mask-size map to control
+            <guilabel>Mask&nbsp;size</guilabel> partially. Mask size is
+            reduced according to darkness in each pixel of the map image.
+            You can select a map image among the current opened images of the
+            same size as the source image.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Exponent</term>
+        <listitem>
+          <para>
+            Exponent selects density of the brush mask used to paint the
+            oily render.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Use exponent map</term>
+        <listitem>
+          <para>
+            You may use an exponent map to control density of brush touch
+            partially. Density is reduced according to darkness in each pixel
+            of the map image. You can select a map image among the current
+            opened images of the same size as the source image.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Use intensity algorithm</term>
+        <listitem>
+          <para>
+            <quote>Use intensity algorithm</quote> changes the mode of
+            operation to help preserve detail and coloring.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
diff --git a/src/filters/artistic/oilify.xml b/src/filters/artistic/oilify.xml
index 22a9dca7d..22eb96e17 100644
--- a/src/filters/artistic/oilify.xml
+++ b/src/filters/artistic/oilify.xml
@@ -2,13 +2,9 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-06-25 Added Spanish translation by AntI
-  2007-05-15 ude: removed filters-artistic-oilify.png
-  2007-05-03 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  050916 de added by axel.wernicke
+  2019-01-21 j.h update to v2.10
 -->
-<sect2 id="gimp-filter-oilify">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-oilify">
   <title>Oilify</title>
 
   <indexterm>
@@ -75,29 +71,23 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/artistic/oilify.png"/>
+            fileref="images/filters/artistic/oilify-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Mask size</term>
+        <term>Presets, Preview, Split view</term>
         <listitem>
-          <para>
-            Mask size selects the size of the brush mask used to paint the
-            oily render. Larger values here produce an oilier render.
-          </para>
+          <xi:include href="../about-common-features.xml"/>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Use mask-size map</term>
+        <term>Mask radius</term>
         <listitem>
           <para>
-            You may use a mask-size map to control
-            <guilabel>Mask&nbsp;size</guilabel> partially. Mask size is
-            reduced accordings to darkness in each pixel of the map image.
-            You can select a map image among the current opened images of the
-            same size as the source image.
+            Mask radius selects the size of the brush mask used to paint the
+            oily render. Larger values here produce an oilier render.
           </para>
         </listitem>
       </varlistentry>
@@ -111,22 +101,19 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Use exponent map</term>
+        <term>Number of intensities</term>
         <listitem>
           <para>
-            You may use an exponent map to control density of brush touch
-            partially. Density is reduced accordings to darkness in each pixel
-            of the map image. You can select a map image among the current
-            opened images of the same size as the source image.
+            Size of the histogram: default is 128. Reducing the number of 
+            intensities results in a loss of details.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Use intensity algorithm</term>
+        <term>Intensity mode</term>
         <listitem>
           <para>
-            <quote>Use intensity algorithm</quote> changes the mode of
-            operation to help preserve detail and coloring.
+            Use pixel luminance values: to test.
           </para>
         </listitem>
       </varlistentry>
diff --git a/src/filters/artistic/photocopy.xml b/src/filters/artistic/photocopy.xml
index e43ef716d..578c2a17d 100644
--- a/src/filters/artistic/photocopy.xml
+++ b/src/filters/artistic/photocopy.xml
@@ -2,13 +2,9 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-06-25 Added Spanish translation by AntI
-  2007-05-03 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  050916 added by axel.wernicke
-  051022 en;fr by julien hardelin
+  2019-01-21 j.h update to v2.10
 -->
-<sect2 id="gimp-filter-photocopy">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-photocopy">
   <title>Photocopy</title>
 
   <indexterm>
@@ -80,18 +76,15 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/artistic/photocopy.png"/>
+            fileref="images/filters/artistic/photocopy-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term>Presets, Preview, Split view</term>
         <listitem>
-          <para>
-            Your changes are displayed in this preview before being applied
-            to your image.
-          </para>
+          <xi:include href="../about-common-features.xml"/>
         </listitem>
       </varlistentry>
       <varlistentry>
diff --git a/src/filters/artistic/softglow-legacy.xml b/src/filters/artistic/softglow-legacy.xml
new file mode 100644
index 000000000..5c7548a60
--- /dev/null
+++ b/src/filters/artistic/softglow-legacy.xml
@@ -0,0 +1,111 @@
+<?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";>
+<!-- section history:
+  2019-01-26 j.h update to v2.10
+-->
+<sect2 id="plug-in-softglow">
+  <title>Softglow (legacy)</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Artistic</secondary>
+    <tertiary>Softglow (legacy)</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Softglow (legacy)</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Example for the <quote>SoftGlow (legacy)</quote> filter</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Original image</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/artistic-taj-softglow.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Filter <quote>Softglow (legacy)</quote> applied</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      This filter lights the image with a soft glow, like the old trick 
+      smearing vaseline on the lens. Softglow (legacy) produces this
+      effect by making bright areas of the image brighter.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Starting filter</title>
+    <para>
+      You can find this file in the Image menu through:
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Artistic</guisubmenu>
+        <guimenuitem>Softglow…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Softglow</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/artistic/softglow.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Preview</term>
+        <listitem>
+          <para>
+            Your changes are displayed in this preview before being applied
+            to your image.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Glow radius</term>
+        <listitem>
+          <para>
+            The glow radius parameter controls the sharpness of the effect,
+            giving a "vaseline-on-the-lens" effect.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Brightness</term>
+        <listitem>
+          <para>
+            The brightness parameter controls the degree of intensification
+            applied to image highlights.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Sharpness</term>
+        <listitem>
+          <para>
+            The sharpness parameter controls how defined or alternatively
+            diffuse the glow effect should be.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
diff --git a/src/filters/artistic/softglow.xml b/src/filters/artistic/softglow.xml
index 3feade9cc..bc92826da 100644
--- a/src/filters/artistic/softglow.xml
+++ b/src/filters/artistic/softglow.xml
@@ -2,12 +2,9 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-06-25 Added Spanish translation by AntI
-  2007-05-03 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  050916 added by axel.wernicke
+  2019-01-21 j.h update to v2.10
 -->
-<sect2 id="gimp-filter-softglow">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-softglow">
   <title>Softglow</title>
 
   <indexterm>
@@ -68,18 +65,15 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/artistic/softglow.png"/>
+            fileref="images/filters/artistic/softglow-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term>Presets, Preview, Split view</term>
         <listitem>
-          <para>
-            Your changes are displayed in this preview before being applied
-            to your image.
-          </para>
+          <xi:include href="../about-common-features.xml"/>
         </listitem>
       </varlistentry>
       <varlistentry>
diff --git a/src/filters/artistic/waterpixels.xml b/src/filters/artistic/waterpixels.xml
new file mode 100644
index 000000000..4d2a08239
--- /dev/null
+++ b/src/filters/artistic/waterpixels.xml
@@ -0,0 +1,86 @@
+<?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";>
+<!-- section history:
+  2019-01-24 j.h prepare skeleton. Fed up with options names and help popups 
+referring directly to algorithm and not to wanted action.
+-->
+
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-waterpixels">
+  <title>Waterpixels</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Artistic</secondary>
+    <tertiary>Waterpixels</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Waterpixels</primary>
+  </indexterm>
+  
+  <sect3>
+    <title>Overview</title>
+    <para>
+      Superpixels based on the watershed transformation.
+    </para>
+    
+    
+  </sect3>
+  
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Artistic</guisubmenu>
+        <guimenuitem>Waterpixels…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Waterpixels</quote> options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/artistic/waterpixels-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Presets, Preview, Split view</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Superpixels size</term>
+        <para>
+          TODO
+        </para>
+      </varlistentry>
+      <varlistentry>
+        <term>Gradient smoothness</term>
+        <para>
+          TODO
+        </para>
+      </varlistentry>
+      <varlistentry>
+        <term>Spatial regularization</term>
+        <para>
+          TODO
+        </para>
+      </varlistentry>
+      <varlistentry>
+        <term>Superpixels color</term>
+        <para>
+          TODO
+        </para>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>


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