[gimp-help-2] Add the Difference Clouds rendering filter

[RyoTa SimaMoto <rsimamoto src gnome org>]

commit ee2a4872265e8da8432df1ad51bf81a6eca409db
Author: SimaMoto,RyÅ?Ta <rsimamoto src gnome org>
Date:   Wed Apr 21 04:56:25 2010 +0900

    Add the Difference Clouds rendering filter
    
    initial draft

 images/C/filters/examples/render-taj-diffcloud.jpg |  Bin 0 -> 22753 bytes
 src/filters/render.xml                             |    1 +
 src/filters/render/difference-clouds.xml           |   70 ++++++++++++++++++++
 3 files changed, 71 insertions(+), 0 deletions(-)
---
diff --git a/images/C/filters/examples/render-taj-diffcloud.jpg b/images/C/filters/examples/render-taj-diffcloud.jpg
new file mode 100644
index 0000000..635c1d1
Binary files /dev/null and b/images/C/filters/examples/render-taj-diffcloud.jpg differ
diff --git a/src/filters/render.xml b/src/filters/render.xml
index 95480e1..81f1304 100644
--- a/src/filters/render.xml
+++ b/src/filters/render.xml
@@ -11,6 +11,7 @@
   <xi:include href="render/introduction.xml"/>
   <xi:include href="render/plasma.xml"/>
   <xi:include href="render/solid_noise.xml"/>
+  <xi:include href="render/difference-clouds.xml"/>
   <xi:include href="render/flame.xml"/>
   <xi:include href="render/ifsfractal.xml"/>
   <xi:include href="render/diffraction.xml"/>
diff --git a/src/filters/render/difference-clouds.xml b/src/filters/render/difference-clouds.xml
new file mode 100644
index 0000000..0dc06e6
--- /dev/null
+++ b/src/filters/render/difference-clouds.xml
@@ -0,0 +1,70 @@
+<?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:
+  2010-01-22 liangtai: created initial version
+-->
+<sect2 id="script-fu-difference-clouds">
+  <title>Difference Clouds</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Render</secondary>
+    <tertiary>Difference Clouds</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Difference Clouds</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Example of Difference Clouds</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-diffcloud.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Filter <quote>Differnce Clouds</quote> applied</para>
+        </caption>
+      </mediaobject>
+    </figure>
+
+    <para>
+      <guimenuitem>Difference Clouds</guimenuitem> command inverts colors
+      partially as random spots in the image.  This is a script renders
+      <link linkend="plug-in-solid-noise">Solid Noise</link> cloud in an
+      automatically created new layer, and sets the layer mode to
+      <quote>Difference</quote>, then merges this layer over the specified
+      image.  If the image is in indexed colors, this menu entry is grayed
+      out and unavailable.
+    </para>
+    <para>
+      Before merging the layer, this script opens the dialog of the
+      Solid Noise plug-in which allows to control its effect.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Activate the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Clouds</guisubmenu>
+        <guimenuitem>Difference Clouds...</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <para>
+      This script does not have its own dialogs but invokes the
+      <link linkend="plug-in-solid-noise">Solid Noise</link>
+      filter's dialog.
+    </para>
+  </sect3>
+</sect2>