[gimp-help-2] Review Alpha to Logo filters



commit 727651cf20707157665eb2711cb7b9610f6147ad
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date:   Fri Sep 24 20:10:51 2010 +0200

    Review Alpha to Logo filters
    
    Especially, merge Basic I and Basic II docs, move filter details to
    the end of the respective file, update some example images.

 images/C/filters/alpha-to-logo/chrome-offs100.jpg |  Bin 2418 -> 0 bytes
 images/C/filters/alpha-to-logo/chrome-offs25.jpg  |  Bin 2791 -> 2022 bytes
 images/C/filters/alpha-to-logo/chrome-offs50.jpg  |  Bin 3040 -> 2163 bytes
 images/C/filters/alpha-to-logo/chrome-offs75.jpg  |  Bin 0 -> 1944 bytes
 images/C/filters/alpha-to-logo/frosty-10.jpg      |  Bin 8939 -> 5708 bytes
 images/C/filters/alpha-to-logo/frosty-200.jpg     |  Bin 8327 -> 5382 bytes
 images/C/filters/alpha-to-logo/frosty-400.jpg     |  Bin 5576 -> 4252 bytes
 images/C/filters/examples/t-o-p-script-fu.jpg     |  Bin 1882 -> 4606 bytes
 src/filters/alpha-to-logo.xml                     |    3 +
 src/filters/alpha-to-logo/alien-glow.xml          |  106 ++++++------
 src/filters/alpha-to-logo/basic.xml               |  182 +++++++++++++++++++++
 src/filters/alpha-to-logo/bovination.xml          |   87 +++++-----
 src/filters/alpha-to-logo/chalk.xml               |   74 +++++----
 src/filters/alpha-to-logo/chip-away.xml           |   64 +++++--
 src/filters/alpha-to-logo/chrome.xml              |   13 +-
 src/filters/alpha-to-logo/neon.xml                |  117 +++++++------
 src/filters/alpha-to-logo/t-o-p.xml               |   47 +++---
 17 files changed, 467 insertions(+), 226 deletions(-)
---
diff --git a/images/C/filters/alpha-to-logo/chrome-offs25.jpg b/images/C/filters/alpha-to-logo/chrome-offs25.jpg
index a73556a..2c82ce1 100644
Binary files a/images/C/filters/alpha-to-logo/chrome-offs25.jpg and b/images/C/filters/alpha-to-logo/chrome-offs25.jpg differ
diff --git a/images/C/filters/alpha-to-logo/chrome-offs50.jpg b/images/C/filters/alpha-to-logo/chrome-offs50.jpg
index d143577..4311a6f 100644
Binary files a/images/C/filters/alpha-to-logo/chrome-offs50.jpg and b/images/C/filters/alpha-to-logo/chrome-offs50.jpg differ
diff --git a/images/C/filters/alpha-to-logo/chrome-offs75.jpg b/images/C/filters/alpha-to-logo/chrome-offs75.jpg
new file mode 100644
index 0000000..4f73b74
Binary files /dev/null and b/images/C/filters/alpha-to-logo/chrome-offs75.jpg differ
diff --git a/images/C/filters/alpha-to-logo/frosty-10.jpg b/images/C/filters/alpha-to-logo/frosty-10.jpg
index 062e922..ef682a7 100644
Binary files a/images/C/filters/alpha-to-logo/frosty-10.jpg and b/images/C/filters/alpha-to-logo/frosty-10.jpg differ
diff --git a/images/C/filters/alpha-to-logo/frosty-200.jpg b/images/C/filters/alpha-to-logo/frosty-200.jpg
index d8428c1..614b41a 100644
Binary files a/images/C/filters/alpha-to-logo/frosty-200.jpg and b/images/C/filters/alpha-to-logo/frosty-200.jpg differ
diff --git a/images/C/filters/alpha-to-logo/frosty-400.jpg b/images/C/filters/alpha-to-logo/frosty-400.jpg
index 268e023..f119724 100644
Binary files a/images/C/filters/alpha-to-logo/frosty-400.jpg and b/images/C/filters/alpha-to-logo/frosty-400.jpg differ
diff --git a/images/C/filters/examples/t-o-p-script-fu.jpg b/images/C/filters/examples/t-o-p-script-fu.jpg
index dada4f9..48673f8 100644
Binary files a/images/C/filters/examples/t-o-p-script-fu.jpg and b/images/C/filters/examples/t-o-p-script-fu.jpg differ
diff --git a/src/filters/alpha-to-logo.xml b/src/filters/alpha-to-logo.xml
index 0555b6f..89e3b9e 100644
--- a/src/filters/alpha-to-logo.xml
+++ b/src/filters/alpha-to-logo.xml
@@ -26,8 +26,11 @@
   <xi:include href="alpha-to-logo/3d-outline.xml"/>
   <xi:include href="alpha-to-logo/alien-glow.xml"/>
   <xi:include href="alpha-to-logo/alien-neon.xml"/>
+  <xi:include href="alpha-to-logo/basic.xml"/>
+<!--
   <xi:include href="alpha-to-logo/basic1.xml"/>
   <xi:include href="alpha-to-logo/basic2.xml"/>
+-->
   <xi:include href="alpha-to-logo/blended.xml"/>
   <xi:include href="alpha-to-logo/bovination.xml"/>
   <xi:include href="alpha-to-logo/chalk.xml"/>
diff --git a/src/filters/alpha-to-logo/alien-glow.xml b/src/filters/alpha-to-logo/alien-glow.xml
index ac20176..3e996d4 100644
--- a/src/filters/alpha-to-logo/alien-glow.xml
+++ b/src/filters/alpha-to-logo/alien-glow.xml
@@ -28,18 +28,22 @@
             fileref="images/filters/examples/logo-alien-glow.jpg"/>
         </imageobject>
         <caption>
-          <para><quote>Alien Glow</quote> applied</para>
+          <para>The <quote>Alien Glow</quote> filter</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/alien-glow-script-fu.jpg"/>
+        </imageobject>
+        <caption>
+          <para>The <quote>Alien Glow</quote> logo</para>
         </caption>
       </mediaobject>
     </figure>
     <para>
       This filter adds an eerie glow around the active layer's alpha.
     </para>
-    <warning>
-      <para>
-        The image will always be resized to the active layer's size.
-      </para>
-    </warning>
     <para>
       The filter is derived from the <quote>Alien Glow</quote> script
       (<menuchoice>
@@ -48,52 +52,13 @@
         <guisubmenu>Logos</guisubmenu>
         <guimenuitem>Alien Glow</guimenuitem>
       </menuchoice> in the image window),
-      which creates the following text effect:
-    </para>
-    <mediaobject>
-      <imageobject>
-        <imagedata format="JPG"
-          fileref="images/filters/examples/alien-glow-script-fu.jpg"/>
-      </imageobject>
-      <caption>
-        <para>The <quote>Alien Glow</quote> Script-Fu script.</para>
-      </caption>
-    </mediaobject>
-    <para>
-      Reproducing this glow is easy:
+      which creates a logo with the above text effect.
     </para>
-    <itemizedlist>
-      <listitem>
-        <para>
-          If necessary, create a
-          <link linkend="gimp-layer-alpha-selection-replace">selection from
-          the alpha channel</link> of the active layer.
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          Fill the selection with the following
-          <link linkend="gimp-tool-blend">Gradient Blend</link>: Shape =
-          Shaped (spherical); Gradient = FG to BG (RGB), with FG = dark gray
-          (79,79,79), BG = black.
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          Create a <link linkend="gimp-layer-new">new layer</link>
-          (<quote>Alien Glow</quote>) below.
-          <link linkend="gimp-selection-grow">Extend</link> the selection
-          slightly,
-          <link linkend="gimp-selection-feather">feather</link> it,
-          and fill it with the <guilabel>Glow color</guilabel>.
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          Create a new background layer filled with black.
-        </para>
-      </listitem>
-    </itemizedlist>
+    <warning>
+      <para>
+        The image will always be resized to the active layer's size.
+      </para>
+    </warning>
   </sect3>
 
   <sect3>
@@ -147,4 +112,43 @@
       </varlistentry>
     </variablelist>
   </sect3>
+
+  <sect3>
+    <title>Filter details</title>
+    <para>
+      Reproducing an eerie alien glow is easy:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          If necessary, create a
+          <link linkend="gimp-layer-alpha-selection-replace">selection from
+          the alpha channel</link> of the active layer.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Fill the selection with the following
+          <link linkend="gimp-tool-blend">Gradient Blend</link>: Shape =
+          Shaped (spherical); Gradient = FG to BG (RGB), with FG = dark gray
+          (79,79,79), BG = black.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Create a <link linkend="gimp-layer-new">new layer</link>
+          (<quote>Alien Glow</quote>) below.
+          <link linkend="gimp-selection-grow">Extend</link> the selection
+          slightly,
+          <link linkend="gimp-selection-feather">feather</link> it,
+          and fill it with the <guilabel>Glow color</guilabel>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Create a new background layer filled with black.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
 </sect2>
diff --git a/src/filters/alpha-to-logo/basic.xml b/src/filters/alpha-to-logo/basic.xml
new file mode 100644
index 0000000..919ff42
--- /dev/null
+++ b/src/filters/alpha-to-logo/basic.xml
@@ -0,0 +1,182 @@
+<?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="script-fu-basic-logo-alpha">
+  <title>Basic I &amp; II</title>
+  <anchor id="script-fu-basic1-logo-alpha" xreflabel="Basic I"/>
+  <anchor id="script-fu-basic2-logo-alpha" xreflabel="Basic II"/>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Alpha to Logo</secondary>
+    <tertiary>Basic I</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Alpha to Logo</secondary>
+    <tertiary>Basic II</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Basic I</primary>
+  </indexterm>
+  <indexterm>
+    <primary>Basic II</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Examples for the <quote>Basic</quote> filters</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/logo-basic1.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Basic I</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/logo-basic2.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Basic II</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      These filters add a gradient effect to the alpha channel of active layer as well as a
+      drop shadow and a background layer.
+    </para>
+    <para>
+      The <quote>Basic II</quote> also adds a highlight layer.
+    </para>
+    <warning>
+      <para>
+        The image will always be resized to the active layer's size.
+      </para>
+    </warning>
+    <para>
+      The filters are derived from the <quote>Basic&nbsp;I</quote> and
+      <quote>Basic&nbsp;II</quote> logo scripts
+      (see <menuchoice>
+        <guimenu>File</guimenu>
+        <guisubmenu>Create</guisubmenu>
+        <guisubmenu>Logos</guisubmenu>
+      </menuchoice>),
+      which draw a text with the filter effect, e.g.
+    </para>
+    <!-- TODO: this should go to a separate document describing the logo script.
+    -->
+    <mediaobject>
+      <imageobject>
+        <imagedata format="JPG"
+          fileref="images/filters/examples/basic1-script-fu.jpg"/>
+      </imageobject>
+      <caption>
+        <para>The <quote>Basic I</quote> logo script.</para>
+      </caption>
+    </mediaobject>
+  </sect3>
+
+  <sect3>
+    <title>Activate the filter</title>
+    <para>
+      You can find the filter in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Alpha to Logo</guisubmenu>
+        <guimenuitem>Basic I</guimenuitem>
+      </menuchoice>
+      and
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Alpha to Logo</guisubmenu>
+        <guimenuitem>Basic II</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Basic</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/alpha-to-logo/basic1-options.png"/>
+        </imageobject>
+        <caption>
+          <para><quote>Basic I</quote> options</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/alpha-to-logo/basic2-options.png"/>
+        </imageobject>
+        <caption>
+          <para><quote>Basic II</quote> options</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Background color</term>
+        <listitem>
+          <para>
+            This color is used to fill the background layer created by the
+            filter. It defaults to white. When you click on the color swatch
+            button, a color selector pops up where you can select any other
+            color.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Text color</term>
+        <listitem>
+          <para>
+            The name of this option refers to the text color of the logo
+            scripts that were mentioned above. Here this color &mdash; by
+            default blue (6,6,206) for <quote>Basic I</quote> and red
+            (206,6,50) for <quote>Basic II</quote> &mdash; sets the basic
+            color of the gradient effect: this is the color the alpha channel
+            will be filled with before the gradient effect will be applied.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+
+  <sect3>
+    <title>Filter details</title>
+    <itemizedlist>
+      <para>
+        You can reproduce the gradient effect manually by using the
+        <link linkend="gimp-tool-blend">Blend tool</link> with the following
+        options:
+      </para>
+      <listitem>
+        <para><guilabel>Mode</guilabel>: Multiply,</para>
+      </listitem>
+      <listitem>
+        <para>
+          <guilabel>Gradient</guilabel>: FG to BG (RGB), where FG is white and
+          BG is black,
+        </para>
+      </listitem>
+      <listitem>
+        <para><guilabel>Offset</guilabel>: 20,</para>
+      </listitem>
+      <listitem>
+        <para><guilabel>Shape</guilabel>: Radial,</para>
+      </listitem>
+      <listitem>
+        <para><guilabel>Dithering</guilabel>: checked.</para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+</sect2>
diff --git a/src/filters/alpha-to-logo/bovination.xml b/src/filters/alpha-to-logo/bovination.xml
index 74d2fed..907fd16 100644
--- a/src/filters/alpha-to-logo/bovination.xml
+++ b/src/filters/alpha-to-logo/bovination.xml
@@ -41,46 +41,6 @@
         The image will always be resized to the active layer's size.
       </para>
     </warning>
-    <para>
-      The filter fills the alpha channel with
-      <link linkend="plug-in-solid-noise">Solid Noise</link>:
-    </para>
-    <mediaobject>
-      <imageobject>
-        <imagedata format="JPG"
-          fileref="images/filters/examples/bovination-noise.jpg"/>
-      </imageobject>
-    </mediaobject>
-    <para>
-      ... and maximizes the
-      <link linkend="gimp-tool-brightness-contrast">Contrast</link>:
-    </para>
-    <mediaobject>
-      <imageobject>
-        <imagedata format="PNG"
-          fileref="images/filters/examples/bovination-contrast.png"/>
-      </imageobject>
-    </mediaobject>
-    <para>
-      Besides, the filter adds a
-      <link linkend="plug-in-gauss">Blur</link>
-      layer as a light gray shadow and uses this layer as a
-      <link linkend="plug-in-bump-map">Bump Map</link>. Finally a (by default)
-      white <quote>Background</quote> layer is added below.
-    </para>
-    <para>
-      So the filter will end up with these layers:<footnote><para>
-        If the active layer is not the top layer, it might happen that the
-        filter messes up the layers. Then you will have to
-        <link linkend="gimp-layer-dialog">raise the active layer</link>.
-      </para></footnote>
-    </para>
-    <mediaobject>
-      <imageobject>
-        <imagedata format="PNG"
-          fileref="images/filters/examples/bovination-layers.png"/>
-      </imageobject>
-    </mediaobject>
   </sect3>
 
   <sect3>
@@ -108,7 +68,8 @@
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Spots density X; Spots density Y</term>
+        <term>Spots density X</term>
+        <term>Spots density Y</term>
         <listitem>
           <para>
             The horizontal (X) and vertical (Y) spots density will be used by
@@ -153,4 +114,48 @@
       </varlistentry>
     </variablelist>
   </sect3>
+
+  <sect3>
+    <title>Filter details</title>
+    <para>
+      The filter fills the alpha channel with
+      <link linkend="plug-in-solid-noise">Solid Noise</link>:
+    </para>
+    <mediaobject>
+      <imageobject>
+        <imagedata format="JPG"
+          fileref="images/filters/examples/bovination-noise.jpg"/>
+      </imageobject>
+    </mediaobject>
+    <para>
+      ... and maximizes the
+      <link linkend="gimp-tool-brightness-contrast">Contrast</link>:
+    </para>
+    <mediaobject>
+      <imageobject>
+        <imagedata format="PNG"
+          fileref="images/filters/examples/bovination-contrast.png"/>
+      </imageobject>
+    </mediaobject>
+    <para>
+      Besides, the filter adds a
+      <link linkend="plug-in-gauss">Blur</link>
+      layer as a light gray shadow and uses this layer as a
+      <link linkend="plug-in-bump-map">Bump Map</link>. Finally a (by default)
+      white <quote>Background</quote> layer is added below.
+    </para>
+    <para>
+      So the filter will end up with these layers:<footnote><para>
+        If the active layer is not the top layer, it might happen that the
+        filter messes up the layers. Then you will have to
+        <link linkend="gimp-layer-dialog">raise the active layer</link>.
+      </para></footnote>
+    </para>
+    <mediaobject>
+      <imageobject>
+        <imagedata format="PNG"
+          fileref="images/filters/examples/bovination-layers.png"/>
+      </imageobject>
+    </mediaobject>
+  </sect3>
 </sect2>
diff --git a/src/filters/alpha-to-logo/chalk.xml b/src/filters/alpha-to-logo/chalk.xml
index edc26d7..e6dc8a2 100644
--- a/src/filters/alpha-to-logo/chalk.xml
+++ b/src/filters/alpha-to-logo/chalk.xml
@@ -60,7 +60,7 @@
           fileref="images/filters/examples/chalk-script-fu.png"/>
       </imageobject>
       <caption>
-        <para>The <quote>Chalk</quote> Script-Fu script.</para>
+        <para>The <quote>Chalk</quote> logo</para>
       </caption>
     </mediaobject>
     <warning>
@@ -68,40 +68,6 @@
         The image will always be resized to the active layer's size.
       </para>
     </warning>
-    <orderedlist>
-      <para>The <quote>Chalk</quote> filter</para>
-      <listitem>
-        <para>
-          applies a <link linkend="plug-in-gauss">Gaussian blur</link> to the
-          layer, <link linkend="plug-in-spread">spreads</link> the pixels, and
-          <link linkend="plug-in-ripple">ripples</link> the layer
-          horizontally and vertically,
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          extracts edges using the <link linkend="plug-in-sobel">Sobel</link>
-          edge detect filter, and
-        </para>
-        <note>
-          <para>
-            Sometimes the sobel edge detect produces some garbage at the
-            image sides.
-          </para>
-        </note>
-      </listitem>
-      <listitem>
-        <para>
-          increases the luminosity <link linkend="gimp-tool-levels">level</link>.
-        </para>
-      </listitem>
-    </orderedlist>
-    <para>
-      Unfortunately you cannot change the tool and filter options. But you may
-      reproduce the process step by step using the methods listed above,
-      varying the respective options. Then you just have to add a background
-      layer filled with any color. That's all.
-    </para>
   </sect3>
 
   <sect3>
@@ -141,4 +107,42 @@
       </varlistentry>
     </variablelist>
   </sect3>
+
+  <sect3>
+    <title>Filter details</title>
+    <procedure>
+      <para>The <quote>Chalk</quote> filter</para>
+      <step>
+        <para>
+          applies a <link linkend="plug-in-gauss">Gaussian blur</link> to the
+          layer, <link linkend="plug-in-spread">spreads</link> the pixels, and
+          <link linkend="plug-in-ripple">ripples</link> the layer
+          horizontally and vertically,
+        </para>
+      </step>
+      <step>
+        <para>
+          extracts edges using the <link linkend="plug-in-sobel">Sobel</link>
+          edge detect filter, and
+        </para>
+        <note>
+          <para>
+            Sometimes the sobel edge detect produces some garbage at the
+            image sides.
+          </para>
+        </note>
+      </step>
+      <step>
+        <para>
+          increases the luminosity <link linkend="gimp-tool-levels">level</link>.
+        </para>
+      </step>
+    </procedure>
+    <para>
+      Unfortunately you cannot change the tool and filter options. But you may
+      reproduce the process step by step using the methods listed above,
+      varying the respective options. Then you just have to add a background
+      layer filled with any color. That's all.
+    </para>
+  </sect3>
 </sect2>
diff --git a/src/filters/alpha-to-logo/chip-away.xml b/src/filters/alpha-to-logo/chip-away.xml
index 542f2df..e609538 100644
--- a/src/filters/alpha-to-logo/chip-away.xml
+++ b/src/filters/alpha-to-logo/chip-away.xml
@@ -27,7 +27,16 @@
             fileref="images/filters/examples/logo-chip-away.jpg"/>
         </imageobject>
         <caption>
-          <para><quote>Chip Away</quote> applied</para>
+          <para>The <quote>Chip Away</quote> filter</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/chip-away-script-fu.jpg"/>
+        </imageobject>
+        <caption>
+          <para>The <quote>Chip Away</quote> logo</para>
         </caption>
       </mediaobject>
     </figure>
@@ -49,23 +58,8 @@
         <guisubmenu>Create</guisubmenu>
         <guisubmenu>Logos</guisubmenu>
         <guimenuitem>Chip Away</guimenuitem>
-      </menuchoice> in the image window),
-      which creates a text effect like that:
-    </para>
-    <mediaobject>
-      <imageobject>
-        <imagedata format="JPG"
-          fileref="images/filters/examples/chip-away-script-fu.jpg"/>
-      </imageobject>
-    </mediaobject>
-    <para>
-      To achieve a chipping effect, the filter creates a
-      <link linkend="gimp-channel-selection-replace">selection from the alpha
-      channel</link> in a new layer, fills the selection with white,
-      <link linkend="plug-in-spread">spreads</link> the pixels, and applies a
-      <link linkend="plug-in-gauss">Gaussian blur</link> to the layer. Then
-      it uses this layer as a <link linkend="plug-in-bump-map">Bump
-      map</link>, creating a 3D effect.
+      </menuchoice>),
+      which creates a text logo with the effect shown above.
     </para>
   </sect3>
 
@@ -267,4 +261,38 @@
       </varlistentry>
     </variablelist>
   </sect3>
+
+  <sect3>
+    <title>Filter details</title>
+    <procedure>
+      <para>To achieve a chipping effect, the filter...</para>
+      <step>
+         <para>
+           ...creates a
+           <link linkend="gimp-channel-selection-replace">selection from the
+           alpha channel</link> in a new layer,
+         </para>
+      </step>
+      <step>
+         <para>fills the selection with white,</para>
+      </step>
+      <step>
+         <para>
+           <link linkend="plug-in-spread">spreads</link> the pixels,
+         </para>
+      </step>
+      <step>
+         <para>
+           and applies a <link linkend="plug-in-gauss">Gaussian blur</link> to
+           the layer.
+         </para>
+      </step>
+      <step>
+         <para>
+           Then it uses this layer as a <link linkend="plug-in-bump-map">Bump
+           map</link>, creating a 3D effect.
+         </para>
+      </step>
+    </procedure>
+  </sect3>
 </sect2>
diff --git a/src/filters/alpha-to-logo/chrome.xml b/src/filters/alpha-to-logo/chrome.xml
index d8b0dbd..da122e0 100644
--- a/src/filters/alpha-to-logo/chrome.xml
+++ b/src/filters/alpha-to-logo/chrome.xml
@@ -40,8 +40,13 @@
     </figure>
     <para>
       This filter is derived from the <quote>Chrome</quote> logo script
-      (<menuchoice><guimenu>File</guimenu><guisubmenu>Create</guisubmenu><guisubmenu>Logos</guisubmenu><guimenuitem>Chrome</guimenuitem></menuchoice>
-      in the image window), which â?? according to the script author â?? creates a
+      (<menuchoice>
+        <guimenu>File</guimenu>
+        <guisubmenu>Create</guisubmenu>
+        <guisubmenu>Logos</guisubmenu>
+        <guimenuitem>Chrome</guimenuitem>
+      </menuchoice>),
+      which &mdash; according to the script author &mdash; creates a
       <quote>simplistic, but cool, chromed logo</quote> (see above).
     </para>
     <para>
@@ -111,10 +116,10 @@
             <mediaobject>
               <imageobject>
                 <imagedata format="JPG"
-                  fileref="images/filters/alpha-to-logo/chrome-offs100.jpg"/>
+                  fileref="images/filters/alpha-to-logo/chrome-offs75.jpg"/>
               </imageobject>
               <caption>
-                <para>Offset 100</para>
+                <para>Offset 75</para>
               </caption>
             </mediaobject>
           </figure>
diff --git a/src/filters/alpha-to-logo/neon.xml b/src/filters/alpha-to-logo/neon.xml
index badcfc1..25c1a76 100644
--- a/src/filters/alpha-to-logo/neon.xml
+++ b/src/filters/alpha-to-logo/neon.xml
@@ -28,7 +28,16 @@
             fileref="images/filters/examples/logo-neon-applied.jpg"/>
         </imageobject>
         <caption>
-          <para><quote>Neon</quote> applied</para>
+          <para>The <quote>Neon</quote> filter</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/neon-script-fu.jpg"/>
+        </imageobject>
+        <caption>
+          <para>The <quote>Neon</quote> logo</para>
         </caption>
       </mediaobject>
     </figure>
@@ -43,66 +52,14 @@
         <guisubmenu>Create</guisubmenu>
         <guisubmenu>Logos</guisubmenu>
         <guimenuitem>Neon</guimenuitem>
-      </menuchoice> in the image window),
-      which creates a text effect that simulates neon lighting:
-    </para>
-    <mediaobject>
-      <imageobject>
-        <imagedata format="JPG"
-          fileref="images/filters/examples/neon-script-fu.jpg"/>
-      </imageobject>
-    </mediaobject>
-    <para>
-      The filter uses two layers to achieve the neon effect:
-    </para>
-    <figure>
-      <title>The Neon effect</title>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="PNG"
-            fileref="images/filters/examples/neon-tubes.png"/>
-        </imageobject>
-        <caption>
-          <para>The <quote>Neon Tubes</quote> layer</para>
-        </caption>
-      </mediaobject>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="PNG"
-            fileref="images/filters/examples/neon-glow.png"/>
-        </imageobject>
-        <caption>
-          <para>The <quote>Neon Glow</quote> layer</para>
-        </caption>
-      </mediaobject>
-    </figure>
-    <para>
-      The layer <quote>Neon Tubes</quote> is the active layer the filter is
-      applied to. The content of this layer doesn't matter. Only the alpha
-      channel does, especially its shape.
+      </menuchoice>),
+      which creates a text effect that simulates neon lighting.
     </para>
     <warning>
       <para>
         The image will always be resized to the active layer's size.
       </para>
     </warning>
-    <para>
-      The <quote>Neon Glow</quote> layer below contains the glowing of the
-      neon light.
-    </para>
-    <para>
-      Optional a <quote>Shadow</quote> layer is created below, containing a
-      drop shadow in the same shape of the active layer's alpha channel. At
-      the bottom a new <quote>Background</quote> layer is created filled with
-      the <guilabel>Background color</guilabel>.
-    </para>
-    <para>Overview of the Neon filter layers:</para>
-    <mediaobject>
-      <imageobject>
-        <imagedata format="PNG"
-          fileref="images/filters/examples/neon-4layers.png"/>
-      </imageobject>
-    </mediaobject>
   </sect3>
 
   <sect3>
@@ -186,4 +143,54 @@
       </varlistentry>
     </variablelist>
   </sect3>
+
+  <sect3>
+    <title>Filter details</title>
+    <para>
+      The filter uses two layers to achieve the neon effect:
+    </para>
+    <figure>
+      <title>The Neon effect</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/neon-tubes.png"/>
+        </imageobject>
+        <caption>
+          <para>The <quote>Neon Tubes</quote> layer</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/neon-glow.png"/>
+        </imageobject>
+        <caption>
+          <para>The <quote>Neon Glow</quote> layer</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      The layer <quote>Neon Tubes</quote> is the active layer the filter is
+      applied to. The content of this layer doesn't matter. Only the alpha
+      channel does, especially its shape.
+    </para>
+    <para>
+      The <quote>Neon Glow</quote> layer below contains the glowing of the
+      neon light.
+    </para>
+    <para>
+      Optional a <quote>Shadow</quote> layer is created below, containing a
+      drop shadow in the same shape of the active layer's alpha channel. At
+      the bottom a new <quote>Background</quote> layer is created filled with
+      the <guilabel>Background color</guilabel>.
+    </para>
+    <para>Overview of the Neon filter layers:</para>
+    <mediaobject>
+      <imageobject>
+        <imagedata format="PNG"
+          fileref="images/filters/examples/neon-4layers.png"/>
+      </imageobject>
+    </mediaobject>
+  </sect3>
 </sect2>
diff --git a/src/filters/alpha-to-logo/t-o-p.xml b/src/filters/alpha-to-logo/t-o-p.xml
index 6a3edfa..c5e300f 100644
--- a/src/filters/alpha-to-logo/t-o-p.xml
+++ b/src/filters/alpha-to-logo/t-o-p.xml
@@ -28,16 +28,16 @@
             fileref="images/filters/examples/t-o-p.jpg"/>
         </imageobject>
         <caption>
-          <para><quote>Particle Trace</quote> applied</para>
+          <para>The <quote>Particle Trace</quote> filter</para>
         </caption>
       </mediaobject>
       <mediaobject>
         <imageobject>
           <imagedata format="JPG"
-            fileref="images/filters/examples/t-o-p-edge.jpg"/>
+            fileref="images/filters/examples/t-o-p-script-fu.jpg"/>
         </imageobject>
         <caption>
-          <para>Applied with <quote>Edge only</quote> option</para>
+          <para>The <quote>Particle Trace</quote> logo</para>
         </caption>
       </mediaobject>
     </figure>
@@ -57,30 +57,14 @@
       </para>
     </warning>
     <para>
-      The filter is derived from the <quote>Particle Trace</quote> script
+      The filter is derived from the <quote>Particle Trace</quote> logo script
       (<menuchoice>
         <guimenu>File</guimenu>
         <guisubmenu>Create</guisubmenu>
         <guisubmenu>Logos</guisubmenu>
         <guimenuitem>Particle Trace</guimenuitem>
-      </menuchoice>
-      in image window), which creates the following text effect:
-    </para>
-    <mediaobject>
-      <imageobject>
-        <imagedata format="JPG"
-          fileref="images/filters/examples/t-o-p-script-fu.jpg"/>
-      </imageobject>
-      <caption>
-        <para>The <quote>Particle Trace</quote> Script-Fu
-        script.</para>
-      </caption>
-    </mediaobject>
-    <para>
-      The filter adds <link linkend="plug-in-rgb-noise">noise</link> to the
-      alpha and then turns the spots into
-      <link linkend="plug-in-sparkle">sparkles</link>. Then it adds a
-      <link linkend="gimp-selection-feather">feathered</link> white shadow.
+      </menuchoice>),
+      which creates the text effect shown in the example above.
     </para>
   </sect3>
 
@@ -181,6 +165,15 @@
             alpha channel only and the area of the alpha channel will be
             cleared.
           </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata format="JPG"
+                fileref="images/filters/examples/t-o-p-edge.jpg"/>
+            </imageobject>
+            <caption>
+              <para><quote>Edge only</quote> activated</para>
+            </caption>
+          </mediaobject>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -221,4 +214,14 @@
       </varlistentry>
     </variablelist>
   </sect3>
+
+  <sect3>
+    <title>Filter details</title>
+    <para>
+      The filter adds <link linkend="plug-in-rgb-noise">noise</link> to the
+      alpha and then turns the spots into
+      <link linkend="plug-in-sparkle">sparkles</link>. Then it adds a
+      <link linkend="gimp-selection-feather">feathered</link> white shadow.
+    </para>
+  </sect3>
 </sect2>



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