[gimp-help] Add noise-reduction filter

[Julien Hardlin <jhardlin src gnome org>]

commit 0154efdcd131a1798cd4fd94982c01b034ec015a
Author: Julien Hardelin <jhardlin orange fr>
Date:   Tue Dec 4 08:17:47 2018 +0100

    Add noise-reduction filter

 images/C/filters/enhance/deinterlace-dialog.png    | Bin 0 -> 20272 bytes
 images/C/filters/enhance/deinterlace.png           | Bin 29437 -> 0 bytes
 .../C/filters/enhance/noise-reduction-dialog.jpg   | Bin 0 -> 11843 bytes
 .../C/filters/enhance/red-eye-removal-dialog.png   | Bin 0 -> 15244 bytes
 images/C/filters/enhance/red-eye-removal.png       | Bin 10654 -> 0 bytes
 .../C/filters/examples/enhance/high-pass-ex2.png   | Bin 108432 -> 0 bytes
 .../examples/enhance/noise-reduction-ex1.gif       | Bin 0 -> 247232 bytes
 .../examples/enhance/noise-reduction-ex2.gif       | Bin 0 -> 219825 bytes
 images/C/filters/examples/enhance/result.png       | Bin 232131 -> 0 bytes
 src/filters/enhance.xml                            |   1 +
 src/filters/enhance/deinterlace.xml                |   2 +-
 src/filters/enhance/noise-reduction.xml            | 100 +++++++++++++++++++++
 src/filters/enhance/red-eye-removal.xml            |   2 +-
 13 files changed, 103 insertions(+), 2 deletions(-)
---
diff --git a/images/C/filters/enhance/deinterlace-dialog.png b/images/C/filters/enhance/deinterlace-dialog.png
new file mode 100644
index 000000000..3070b2876
Binary files /dev/null and b/images/C/filters/enhance/deinterlace-dialog.png differ
diff --git a/images/C/filters/enhance/noise-reduction-dialog.jpg 
b/images/C/filters/enhance/noise-reduction-dialog.jpg
new file mode 100644
index 000000000..1c7309a39
Binary files /dev/null and b/images/C/filters/enhance/noise-reduction-dialog.jpg differ
diff --git a/images/C/filters/enhance/red-eye-removal-dialog.png 
b/images/C/filters/enhance/red-eye-removal-dialog.png
new file mode 100644
index 000000000..ca6396e01
Binary files /dev/null and b/images/C/filters/enhance/red-eye-removal-dialog.png differ
diff --git a/images/C/filters/examples/enhance/noise-reduction-ex1.gif 
b/images/C/filters/examples/enhance/noise-reduction-ex1.gif
new file mode 100644
index 000000000..ff45a8932
Binary files /dev/null and b/images/C/filters/examples/enhance/noise-reduction-ex1.gif differ
diff --git a/images/C/filters/examples/enhance/noise-reduction-ex2.gif 
b/images/C/filters/examples/enhance/noise-reduction-ex2.gif
new file mode 100644
index 000000000..7af661066
Binary files /dev/null and b/images/C/filters/examples/enhance/noise-reduction-ex2.gif differ
diff --git a/src/filters/enhance.xml b/src/filters/enhance.xml
index ce59e709a..9c5cd933e 100644
--- a/src/filters/enhance.xml
+++ b/src/filters/enhance.xml
@@ -18,6 +18,7 @@
   <xi:include href="enhance/antialias.xml"/>
   <xi:include href="enhance/deinterlace.xml"/>
   <xi:include href="enhance/high-pass.xml"/>
+  <xi:include href="enhance/noise-reduction.xml"/>
   <xi:include href="enhance/red-eye-removal.xml"/>
   <xi:include href="enhance/symmetric-nearest-neighbor.xml"/>
   <xi:include href="enhance/unsharp_mask.xml"/>
diff --git a/src/filters/enhance/deinterlace.xml b/src/filters/enhance/deinterlace.xml
index 89027ec2f..cb4b3b3b0 100644
--- a/src/filters/enhance/deinterlace.xml
+++ b/src/filters/enhance/deinterlace.xml
@@ -57,7 +57,7 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/enhance/deinterlace.png"/>
+            fileref="images/filters/enhance/deinterlace-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
diff --git a/src/filters/enhance/noise-reduction.xml b/src/filters/enhance/noise-reduction.xml
new file mode 100644
index 000000000..8c444d431
--- /dev/null
+++ b/src/filters/enhance/noise-reduction.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";>
+
+<sect2 id="gimp-filter-noise-reduction">
+  <title>Noise Reduction</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Enhance</secondary>
+    <tertiary>Noise Reduction</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Noise Reduction</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <para>
+      A simple GEGL filter to reduce noise.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      You can find this filter through
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Enhance</guisubmenu>
+        <guimenuitem>Noise Reduction…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title>Noise Reduction filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/enhance/noise-reduction-dialog.jpg"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    
+    <variablelist>
+      <varlistentry>
+        <term><guilabel>Presets</guilabel>, <guilabel>Preview</guilabel>, 
+          <guilabel>Split view</guilabel></term>
+        <listitem>
+          <para>
+            These options are common to GEGL-based filters. Please refer to 
+            <xref linkend="gimp-filters-common"/>.
+          </para>
+        </listitem>
+      </varlistentry>
+      
+      <varlistentry>
+        <term><guilabel>Strength</guilabel></term>
+        <listitem>
+          <para>
+            Increasing Strength lessens noise, and increases blur: find 
+            compromise using the on-canvas preview.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+  
+  <sect3>
+    <title>Example</title>
+    <mediaobject>
+      <imageobject>
+        <imagedata 
+          fileref="images/filters/examples/enhance/noise-reduction-ex1.gif"
+          format="GIF"/>
+      </imageobject>
+      <caption>
+        <para>
+          Original
+        </para>
+      </caption>
+    </mediaobject>
+    <mediaobject>
+      <imageobject>
+        <imagedata 
+          fileref="images/filters/examples/enhance/noise-reduction-ex2.gif"
+          format="GIF"/>
+      </imageobject>
+      <caption>
+        <para>
+          Filter applied. Strength = 5
+        </para>
+      </caption>
+    </mediaobject>
+  </sect3>
+</sect2>
+
diff --git a/src/filters/enhance/red-eye-removal.xml b/src/filters/enhance/red-eye-removal.xml
index 2b7b65dee..c7d2e0359 100644
--- a/src/filters/enhance/red-eye-removal.xml
+++ b/src/filters/enhance/red-eye-removal.xml
@@ -70,7 +70,7 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/enhance/red-eye-removal.png"/>
+            fileref="images/filters/enhance/red-eye-removal-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>