[gimp-help] Add Cell Noise filter

[Julien Hardlin <jhardlin src gnome org>]

commit 915dc53c6815b63f949c6ec09b88962ecf239567
Author: Julien Hardelin <jhardlin orange fr>
Date:   Thu Mar 7 17:25:34 2019 +0100

    Add Cell Noise filter

 .../filters/examples/render/cell_noise-applied.jpg | Bin 0 -> 15454 bytes
 .../filters/examples/render/cell_noise-palette.jpg | Bin 0 -> 21638 bytes
 .../C/filters/examples/render/cell_noise-rank.jpg  | Bin 0 -> 13136 bytes
 .../C/filters/examples/render/cell_noise-shape.jpg | Bin 0 -> 16203 bytes
 images/C/filters/render/cell_noise-dialog.png      | Bin 0 -> 24076 bytes
 src/filters/render.xml                             |   4 +-
 src/filters/render/cell-noise.xml                  | 142 +++++++++++++++++++++
 .../render/{solid_noise.xml => solid-noise.xml}    |   0
 8 files changed, 144 insertions(+), 2 deletions(-)
---
diff --git a/images/C/filters/examples/render/cell_noise-applied.jpg 
b/images/C/filters/examples/render/cell_noise-applied.jpg
new file mode 100644
index 000000000..25d5de1c9
Binary files /dev/null and b/images/C/filters/examples/render/cell_noise-applied.jpg differ
diff --git a/images/C/filters/examples/render/cell_noise-palette.jpg 
b/images/C/filters/examples/render/cell_noise-palette.jpg
new file mode 100644
index 000000000..1fe84a757
Binary files /dev/null and b/images/C/filters/examples/render/cell_noise-palette.jpg differ
diff --git a/images/C/filters/examples/render/cell_noise-rank.jpg 
b/images/C/filters/examples/render/cell_noise-rank.jpg
new file mode 100644
index 000000000..b43941c37
Binary files /dev/null and b/images/C/filters/examples/render/cell_noise-rank.jpg differ
diff --git a/images/C/filters/examples/render/cell_noise-shape.jpg 
b/images/C/filters/examples/render/cell_noise-shape.jpg
new file mode 100644
index 000000000..09d6b040b
Binary files /dev/null and b/images/C/filters/examples/render/cell_noise-shape.jpg differ
diff --git a/images/C/filters/render/cell_noise-dialog.png b/images/C/filters/render/cell_noise-dialog.png
new file mode 100644
index 000000000..22960bdc2
Binary files /dev/null and b/images/C/filters/render/cell_noise-dialog.png differ
diff --git a/src/filters/render.xml b/src/filters/render.xml
index e38afa40d..f5e7c0e3f 100644
--- a/src/filters/render.xml
+++ b/src/filters/render.xml
@@ -13,11 +13,11 @@
   <xi:include href="render/ifsfractal.xml"/>
 
   <!--Noise-->
-  <!--<xi:include href="render/cell_noise.xml"/>-->
+  <xi:include href="render/cell-noise.xml"/>
   <!--<xi:include href="render/perlin_noise.xml"/>-->
   <xi:include href="render/plasma.xml"/>
   <!--<xi:include href="render/simplex_noise.xml"/>-->
-  <xi:include href="render/solid_noise.xml"/>
+  <xi:include href="render/solid-noise.xml"/>
   <xi:include href="render/difference-clouds.xml"/>
 
   <!--Patterns-->
diff --git a/src/filters/render/cell-noise.xml b/src/filters/render/cell-noise.xml
new file mode 100644
index 000000000..4afeed4fd
--- /dev/null
+++ b/src/filters/render/cell-noise.xml
@@ -0,0 +1,142 @@
+<?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-03-06 j.h: create
+-->
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-noise-cell">
+  <title>Cell Noise</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Render</secondary>
+    <tertiary>Cell Noise</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Grid</primary>
+    <secondary>Cell Noise</secondary>
+  </indexterm>
+  
+  <sect3>
+    <title>Overview</title>
+    <para>
+      Generates a cellular texture. Results don't depend on the image you 
+      opened.
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render/cell_noise-applied.jpg"/>
+        </imageobject>
+        <caption>
+          <para>
+            Filter applied with default options: scale=1.000  shape=2.000 rank=1
+          </para>
+        </caption>
+      </mediaobject>
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Noise</guisubmenu>
+        <guimenuitem>Cell Noise…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Cell Noise</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/render/cell_noise-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Presets, Preview, Split view, Use selection as input</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Scale</term>
+        <listitem>
+          <para>
+            Scale of the noise function: works like a zoom.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Shape</term>
+        <listitem>
+          <para>
+            Interpolates between Manhattan and Euclidean distance: (1.000 to 
+            2.000). Lower values give four spikes stars nuclei to cells. Upper 
+            values give circular nuclei.
+          </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata format="JPG"
+                fileref="images/filters/examples/render/cell_noise-shape.jpg"/>
+            </imageobject>
+            <caption>
+              <para>
+                Shape = 1.000
+              </para>
+            </caption>
+          </mediaobject>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Rank</term>
+        <listitem>
+          <para>
+            Selects the n-th closest point: (1-3). Cells are elongated.
+          </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata format="JPG"
+                fileref="images/filters/examples/render/cell_noise-rank.jpg"/>
+            </imageobject>
+            <caption>
+              <para>
+                Rank = 2
+              </para>
+            </caption>
+          </mediaobject>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Iterations</term>
+        <listitem>
+          <para>
+            The number of noise octaves.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Palettize</term>
+        <listitem>
+          <para>
+            Fills each cell with a random color.
+          </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata format="JPG"
+              fileref="images/filters/examples/render/cell_noise-palette.jpg"/>
+            </imageobject>
+          </mediaobject>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
\ No newline at end of file
diff --git a/src/filters/render/solid_noise.xml b/src/filters/render/solid-noise.xml
similarity index 100%
rename from src/filters/render/solid_noise.xml
rename to src/filters/render/solid-noise.xml