[gimp-help-2] Review Gradient Flare filter docs



commit 3ad27a28e9878366eda91d618dc082acec15423d
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date:   Wed May 19 20:38:47 2010 +0200

    Review Gradient Flare filter docs

 src/dialogs/color-dialog.xml          |   24 +-
 src/filters/light_effects/flarefx.xml |    5 +-
 src/filters/light_effects/gflare.xml  |  788 +++++++++++++++++---------------
 3 files changed, 431 insertions(+), 386 deletions(-)
---
diff --git a/src/dialogs/color-dialog.xml b/src/dialogs/color-dialog.xml
index 63ebe90..7915994 100644
--- a/src/dialogs/color-dialog.xml
+++ b/src/dialogs/color-dialog.xml
@@ -111,13 +111,12 @@
     </para>
   </sect3>
 
-  <sect3>
+  <sect3 id="gimp-colorselectors">
     <title>Using the <quote>FG/BG color</quote> dialog</title>
     <variablelist>
-      <varlistentry>
+      <varlistentry id="gimp-colorselector-gimp">
         <term>GIMP Selector</term>
         <listitem>
-          <anchor id="gimp-colorselector-gimp"/>
           <para>
             With the GIMP Color Selector, you select a color by clicking on a
             one-dimensional strip located at the right edge, and then in a
@@ -129,10 +128,9 @@
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      <varlistentry id="gimp-colorselector-cmyk">
         <term>CMYK</term>
         <listitem>
-          <anchor id="gimp-colorselector-cmyk"/>
           <figure>
             <title>CMYK</title>
             <mediaobject>
@@ -149,10 +147,9 @@
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      <varlistentry id="gimp-colorselector-triangle">
         <term>Triangle</term>
         <listitem>
-          <anchor id="gimp-colorselector-triangle"/>
           <indexterm>
             <primary>Triangle Color Selector</primary>
           </indexterm>
@@ -174,10 +171,9 @@
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      <varlistentry id="gimp-colorselector-watercolor">
         <term>Watercolor</term>
         <listitem>
-          <anchor id="gimp-colorselector-watercolor"/>
           <indexterm>
             <primary>Watercolor Color Selector</primary>
           </indexterm>
@@ -206,10 +202,9 @@
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      <varlistentry id="gimp-colorselector-palette">
         <term>Palette</term>
         <listitem>
-          <anchor id="gimp-colorselector-palette"/>
           <indexterm>
             <primary>Palette Color Selector</primary>
           </indexterm>
@@ -232,10 +227,9 @@
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      <varlistentry id="gimp-colorselector-scales">
         <term>Scales</term>
         <listitem>
-          <anchor id="gimp-colorselector-scales"/>
           <figure>
             <title>The Scales selector</title>
             <mediaobject>
@@ -251,7 +245,7 @@
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      <varlistentry id="gimp-colorselector-picker">
         <term>Color picker</term>
         <listitem>
           <para>
@@ -262,7 +256,7 @@
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      <varlistentry id="gimp-colorselector-html">
         <term>HTML Notation</term>
         <listitem>
           <indexterm>
diff --git a/src/filters/light_effects/flarefx.xml b/src/filters/light_effects/flarefx.xml
index a319f12..2bcc947 100644
--- a/src/filters/light_effects/flarefx.xml
+++ b/src/filters/light_effects/flarefx.xml
@@ -90,8 +90,9 @@
         <term>Center of Flare Effect</term>
         <listitem>
           <para>
-            You can set there X and Y (pixels) coordinates of glint. The
-            coordinate origin is at upper left corner.
+            You can set X and Y (pixels) coordinates of glint using the input
+            box or by clicking into the preview. The coordinate origin is at
+            the upper left corner.
           </para>
         </listitem>
       </varlistentry>
diff --git a/src/filters/light_effects/gflare.xml b/src/filters/light_effects/gflare.xml
index c83ffc0..12178ce 100644
--- a/src/filters/light_effects/gflare.xml
+++ b/src/filters/light_effects/gflare.xml
@@ -71,15 +71,16 @@
   <sect3>
     <title>Options</title>
     <para>
-      The Settings tab allows you to set manually the parameters while the
-      Selector tab let you choose presets in a list.
+      The <emphasis>Settings</emphasis> tab allows you to set manually the
+      parameters while the <emphasis>Selector</emphasis> tab let you choose
+      presets in a list.
     </para>
     <variablelist>
       <varlistentry>
         <term>Preview</term>
         <listitem>
           <para>
-            When <guilabel>Auto Update Preview</guilabel> is checked,
+            When <guilabel>Auto update preview</guilabel> is checked,
             parameter setting results are interactively displayed in preview
             without modifying the image until you click on
             <guilabel>OK</guilabel> button.
@@ -87,405 +88,454 @@
         </listitem>
       </varlistentry>
     </variablelist>
-  </sect3>
 
-  <sect3>
-    <title>Settings</title>
-    <figure>
-      <title>
-        <quote>Gradient Flare</quote> filter options (Settings)
-      </title>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="PNG"
-            fileref="images/filters/gflare-options-1.png"/>
-        </imageobject>
-      </mediaobject>
-    </figure>
-    <variablelist>
-      <varlistentry>
-        <term>Center</term>
-        <listitem>
-          <para>
-            You can set there X and Y (pixels) coordinates of glint. The
-            coordinate origin is at the upper left corner
-          </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Parameters</term>
-        <listitem>
-          <itemizedlist>
-            <listitem>
-              <para><guilabel>Radius</guilabel>: The radius of the effect. Don't
-                be afraid to use the box with the digits instead the slider
-                which is a bit limited.
-              </para>
-            </listitem>
-            <listitem>
-              <para><guilabel>Rotation</guilabel>: Turn the effect.
-              </para>
-            </listitem>
-            <listitem>
-              <para><guilabel>Hue Rotation</guilabel>: Change the tint (color)
-                of the effect.
-              </para>
-            </listitem>
-            <listitem>
-              <para><guilabel>Vector Angle</guilabel>: Turn the Second flares.
-              </para>
-            </listitem>
-            <listitem>
-              <para><guilabel>Vector length</guilabel>: Vary the distance
-                applied for the Second flares.
-              </para>
-            </listitem>
-          </itemizedlist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Adaptive Supersampling</term>
-        <listitem>
-          <para>
-            Settings of the anti-aliasing following parameters like Depth
-            and Threshold.
-          </para>
-        </listitem>
-      </varlistentry>
-    </variablelist>
+    <sect4>
+      <title>Settings</title>
+      <figure>
+        <title><quote>Gradient Flare</quote> filter options (Settings)</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/filters/gflare-options-1.png"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <variablelist>
+        <varlistentry>
+          <term>Center</term>
+          <listitem>
+            <para>
+              You can set X and Y (pixels) coordinates of glint using the
+              input box or by clicking into the preview. The coordinate origin
+              is at the upper left corner.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Parameters</term>
+          <listitem>
+            <variablelist>
+              <varlistentry>
+                <term><guilabel>Radius</guilabel></term>
+              <listitem>
+                <para>
+                  The radius of the effect. The slider limits the range of
+                  possible values, but using the input box you can enter
+                  greater values.
+                </para>
+              </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Rotation</guilabel></term>
+                <listitem>
+                  <para>Turn the effect.</para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Hue rotation</guilabel></term>
+                <listitem>
+                  <para>Change the tint (color) of the effect.</para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Vector angle</guilabel></term>
+                <listitem>
+                  <para>Turn the Second flares.</para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Vector length</guilabel></term>
+                <listitem>
+                  <para>Vary the distance applied for the Second flares.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Adaptive supersampling</term>
+          <listitem>
+            <para>
+              Settings of the anti-aliasing following parameters like Depth
+              and Threshold. (See also
+              <xref linkend="glossary-supersampling"/>.)
+            </para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </sect4>
+
+    <sect4>
+      <title>Selector</title>
+      <figure>
+        <title><quote>Gradient Flare</quote> filter options (Selector)</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/filters/gflare-options-2.png"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <para>
+        The Selector tab allows you to select a Gradient Flare pattern, to
+        change it and save it.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term>New</term>
+          <listitem>
+            <para>
+              When you click on this button, you create a new Gradient Flare
+              pattern.  Give it a name of your choice.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Edit</term>
+          <listitem>
+            <para>
+              This button brings up the
+              <link linkend="plug-in-gflare-editor">Gradient Flare
+              Editor</link> (see below).
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Copy</term>
+          <listitem>
+            <para>
+              This button allows you to duplicate selected Gradient Flare
+              pattern.  You can edit the copy without altering the original.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Delete</term>
+          <listitem>
+            <para>
+              This button deletes the selected Gradient Flare pattern.
+            </para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </sect4>
   </sect3>
 
-  <sect3>
-    <title>Selector</title>
-    <figure>
-      <title>
-        <quote>Gradient Flare</quote> filter options (Selector)
-      </title>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="PNG"
-            fileref="images/filters/gflare-options-2.png"/>
-        </imageobject>
-      </mediaobject>
-    </figure>
+  <sect3 id="plug-in-gflare-editor">
+    <title>Gradient Flare Editor</title>
     <para>
-      The Selector tab allows you to select a Gradient Flare pattern, to
-      change it and save it.
+      The Gradient Flare Editor is also organized in tabs:
     </para>
-    <variablelist>
-      <varlistentry>
-        <term>New</term>
-        <listitem>
-          <para>
-            When you click on this button, you create a new Gradient Flare
-            pattern.  Give it a name of your choice.
-          </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Edit</term>
-        <listitem>
-          <para>
-            This button brings up the Gradient Flare Editor (see below).
-          </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Copy</term>
-        <listitem>
-          <para>
-            This button allows you to duplicate selected Gradient Flare
-            pattern.  You can edit the copy without altering the original.
-          </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Delete</term>
-        <listitem>
-          <para>
-            This button deletes the selected Gradient Flare pattern.
-          </para>
-        </listitem>
-      </varlistentry>
-    </variablelist>
-  </sect3>
 
-  <sect3>
-    <title>Gradient Flare Editor</title>
-    <variablelist>
-      <varlistentry>
-        <term>General</term>
-        <listitem>
-          <figure>
-            <title>
-              <quote>Gradient Flare Editor</quote> options (General)
-            </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata format="PNG"
-                  fileref="images/filters/gflare-editor-1.png"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <variablelist>
-            <varlistentry>
-              <term>Glow Paint Options</term>
-              <listitem>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>Opacity</guilabel>: Slider and input box
-                      allows you to reduce glow opacity (0-100).
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Paint Mode</guilabel>: You can choose
-                      between four modes:
-                    </para>
-                    <itemizedlist>
+    <sect4 id="plug-in-gflare-editor-general">
+      <title>General</title>
+      <figure>
+        <title><quote>Gradient Flare Editor</quote> options (General)</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/filters/gflare-editor-1.png"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <variablelist>
+        <varlistentry>
+          <term>Glow Paint Options</term>
+          <listitem>
+            <variablelist>
+              <varlistentry>
+                <term>Opacity</term>
+                <listitem>
+                  <para>
+                    Slider and input box allows you to reduce glow opacity
+                    (0-100).
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term>Paint Mode</term>
+                <listitem>
+                  <para>You can choose between four modes:</para>
+                  <variablelist>
+                    <varlistentry>
+                      <term><guilabel>Normal</guilabel></term>
                       <listitem>
                         <para>
-                          <emphasis>Normal</emphasis>: In this mode, the
-                          glow covers the image without taking into account
-                          what is beneath.
+                          In this mode, the glow covers the image without
+                          taking into account what is beneath.
                         </para>
                       </listitem>
+                    </varlistentry>
+                    <varlistentry>
+                      <term><guilabel>Addition</guilabel></term>
                       <listitem>
                         <para>
-                          <emphasis>Addition</emphasis>: Pixel RGB values of
-                          glow are added to RGB values of the corresponding
-                          pixels in the image. Colors get lighter and white
-                          areas may appear.
+                          Pixel RGB values of glow are added to RGB values of
+                          the corresponding pixels in the image. Colors get
+                          lighter and white areas may appear.
                         </para>
                       </listitem>
+                    </varlistentry>
+                    <varlistentry>
+                      <term><guilabel>Overlay</guilabel></term>
                       <listitem>
                         <para>
-                          <emphasis>Overlay</emphasis>: Light/Dark areas of
-                          glow enhance corresponding light/dark areas of
-                          image.
+                          Light/Dark areas of glow enhance corresponding
+                          light/dark areas of image.
                         </para>
                       </listitem>
+                    </varlistentry>
+                    <varlistentry>
+                      <term><guilabel>Screen</guilabel></term>
                       <listitem>
                         <para>
-                          <emphasis>Screen</emphasis>: Dark areas of image
-                          are enlightened by corresponding light areas of
-                          glow. Imagine two slides projected onto the same
-                          screen.
+                          Dark areas of image are enlightened by corresponding
+                          light areas of glow. Imagine two slides projected
+                          onto the same screen.
                         </para>
                       </listitem>
-                    </itemizedlist>
-                  </listitem>
-                </itemizedlist>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Rays Paint Options</term>
-              <listitem>
-                <para>
-                  Options are the same as for "Glow".
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Second Flare Paint Options</term>
-              <listitem>
-                <para>
-                  Options are the same as for "Glow".
-                </para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Glow</term>
-        <listitem>
-          <figure>
-            <title>
-              <quote>Gradient Flare Editor</quote> options (Glow)
-            </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata format="PNG"
-                  fileref="images/filters/gflare-editor-2.png"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <variablelist>
-            <varlistentry>
-              <term>Gradients</term>
-              <listitem>
-                <para>
-                  By clicking on the rectangular buttons, you can develop a
-                  long list of gradients. <quote>%</quote> gradients belong
-                  to the Editor.
-                </para>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>Radial gradient</guilabel>: The selected
-                      gradient is drawn radially, from center to edge.
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para>
-                      <guilabel>Angular gradient</guilabel>: The selected
-                      gradient develops around center, counter-clockwise,
-                      starting from three o'clock if the
-                      <quote>Rotation</quote> parameter is
-                      set to 0. Radial and angular gradients are combined
-                      according to the Multiply mode: light areas are enhanced
-                      and colors are mixed according to CMYK color system
-                      (that of your printer).
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Angular size gradient</guilabel>: This is a
-                      gradient of radius size which develops angularly. Radius
-                      is controlled according to gradient Luminosity: if
-                      luminosity is zero (black), the radius is 0%. If
-                      luminosity is 100% (white), the radius is also 100%.
-                    </para>
-                  </listitem>
-                </itemizedlist>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Parameters</term>
-              <listitem>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>Size (%)</guilabel>: Sets size (%) of glow
-                      (0-200).
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Rotation</guilabel>: Sets the origin of the
-                      angular gradient (-180 +180).
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Hue rotation</guilabel>: Sets glow color,
-                      according to the HSV color circle (-180 +180).
-                    </para>
-                  </listitem>
-                </itemizedlist>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Rays</term>
-        <listitem>
-          <figure>
-            <title>
-              <quote>Gradient Flare Editor</quote> options (Rays)
-            </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata format="PNG"
-                  fileref="images/filters/gflare-editor-3.png"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <variablelist>
-            <varlistentry>
-              <term>Gradients</term>
-              <listitem>
-                <para>
-                  The options are the same as for Glow.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Parameters</term>
-              <listitem>
-                <para>
-                  The first three options are the same as in Glow. Two are
-                  new:
-                </para>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel># of spikes</guilabel>: This option determines
-                      the number of spikes (1-300) but also their texture.
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Spike Thickness</guilabel>: When spikes get
-                      wider (1-100), they look like flower petals
-                    </para>
-                  </listitem>
-                </itemizedlist>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Second Flares</term>
-        <listitem>
-          <figure>
-            <title>
-              <quote>Gradient Flare Editor</quote> options (Second Flares)
-            </title>
-            <mediaobject>
-              <imageobject>
-                <imagedata format="PNG"
-                  fileref="images/filters/gflare-editor-4.png"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
-          <variablelist>
-            <varlistentry>
-              <term>Gradients</term>
+                    </varlistentry>
+                  </variablelist>
+                </listitem>
+              </varlistentry>
+            </variablelist>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Rays Paint Options</term>
+          <listitem>
+            <para>
+              Options are the same as for
+              <link linkend="plug-in-gflare-editor-glow">Glow</link>.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Second Flare Paint Options</term>
+          <listitem>
+            <para>
+              Options are the same as for
+              <link linkend="plug-in-gflare-editor-glow">Glow</link>.
+            </para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </sect4>
+
+    <sect4 id="plug-in-gflare-editor-glow">
+      <title>Glow</title>
+      <figure>
+        <title><quote>Gradient Flare Editor</quote> options (Glow)</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/filters/gflare-editor-2.png"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <variablelist>
+        <varlistentry>
+          <term>Gradients</term>
+          <listitem>
+            <variablelist>
+              <para>
+                By clicking on the rectangular buttons, you can develop a long
+                list of gradients. <quote>%</quote> gradients belong to the
+                Editor.
+              </para>
+              <varlistentry>
+                <term><guilabel>Radial gradient</guilabel></term>
+                <listitem>
+                  <para>
+                    The selected gradient is drawn radially, from center to
+                    edge.
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Angular gradient</guilabel></term>
+                <listitem>
+                  <para>
+                    The selected gradient develops around center,
+                    counter-clockwise, starting from three o'clock if the
+                    <guilabel>Rotation</guilabel> parameter is set to 0.
+                    Radial and angular gradients are combined according to the
+                    Multiply mode: light areas are enhanced and colors are
+                    mixed according to CMYK color system (that of your
+                    printer).
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Angular size gradient</guilabel></term>
+                <listitem>
+                  <para>
+                    This is a gradient of radius size which develops
+                    angularly. Radius is controlled according to gradient
+                    Luminosity: if luminosity is zero (black), the radius is
+                    0%. If luminosity is 100% (white), the radius is also
+                    100%.
+                  </para>
+                </listitem>
+              </varlistentry>
+            </variablelist>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Parameters</term>
+          <listitem>
+            <variablelist>
+              <varlistentry>
+                <term><guilabel>Size (%)</guilabel></term>
               <listitem>
+                <!--FIXME: percent of what?-->
                 <para>
-                  The options are the same as for Glow.
+                  Sets size of glow in percent (0-200).
                 </para>
               </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Parameters</term>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Rotation</guilabel></term>
               <listitem>
                 <para>
-                  Options are the same as in Glow.
+                  Sets the origin of the angular gradient (-180 +180).
                 </para>
               </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Shape of Second Flares</term>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Hue rotation</guilabel></term>
               <listitem>
                 <para>
-                  Second flares, these satellites of the main flare, may have
-                  two shapes: <emphasis>Circle</emphasis> and
-                  <emphasis>Polygon</emphasis>. You can set the
-                  <emphasis>Number</emphasis> polygon sides. The option
-                  accepts 1 side (!), not 2.
+                  Sets glow color, according to the HSV color circle (-180
+                  +180). (Cf. <link linkend="gimp-colorselector-triangle">The
+                  triangle color selector</link>.)
                 </para>
               </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>Random seed and Randomize</term>
-              <listitem>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>Random Seed</guilabel>: The random generator
-                      will use this value as a seed to generate random
-                      numbers. You can use the same value to repeat the same
-                      <quote>random</quote> sequence several times.
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Randomize</guilabel>: When you click on this
-                      button, you produce a random seed that will be used by
-                      the random generator. It is each time different.
-                    </para>
-                  </listitem>
-                </itemizedlist>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </listitem>
-      </varlistentry>
-    </variablelist>
+              </varlistentry>
+            </variablelist>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </sect4>
+
+    <sect4 id="plug-in-gflare-editor-rays">
+      <title>Rays</title>
+      <figure>
+        <title><quote>Gradient Flare Editor</quote> options (Rays)</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/filters/gflare-editor-3.png"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <variablelist>
+        <varlistentry>
+          <term>Gradients</term>
+          <listitem>
+            <para>
+              The options are the same as for
+              <link linkend="plug-in-gflare-editor-glow">Glow</link>.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Parameters</term>
+          <listitem>
+            <variablelist>
+              <para>
+                The first three options are the same as in
+                <link linkend="plug-in-gflare-editor-glow">Glow</link>.
+                Two are new:
+              </para>
+              <varlistentry>
+                <term><guilabel># of Spikes</guilabel></term>
+                <listitem>
+                  <para>
+                    This option determines the number of spikes (1-300) but
+                    also their texture.
+                  </para>
+                </listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><guilabel>Spike thickness</guilabel></term>
+                <listitem>
+                  <para>
+                    When spikes get wider (1-100), they look like flower
+                    petals.
+                  </para>
+                </listitem>
+              </varlistentry>
+            </variablelist>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </sect4>
+
+    <sect4 id="plug-in-gflare-editor-secondflares">
+      <title>Second Flares</title>
+      <figure>
+        <title>
+          <quote>Gradient Flare Editor</quote> options (Second Flares)
+        </title>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/filters/gflare-editor-4.png"/>
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <variablelist>
+        <varlistentry>
+          <term>Gradients</term>
+          <listitem>
+            <para>
+              The options are the same as for
+              <link linkend="plug-in-gflare-editor-glow">Glow</link>.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Parameters</term>
+          <listitem>
+            <para>
+              Options are the same as in
+              <link linkend="plug-in-gflare-editor-glow">Glow</link>.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Shape of Second Flares</term>
+          <listitem>
+            <para>
+              Second flares, these satellites of the main flare, may have
+              two shapes: <guilabel>Circle</guilabel> and
+              <guilabel>Polygon</guilabel>. You can set the
+              <emphasis>Number</emphasis> polygon sides. The option
+              accepts 1 side (!), not 2.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Random seed</term>
+          <listitem>
+            <para>
+              The random generator will use this value as a seed to generate
+              random numbers. You can use the same value to repeat the same
+              <quote>random</quote> sequence several times.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Randomize</term>
+          <listitem>
+            <para>
+              When you click on this button, you produce a random seed that
+              will be used by the random generator. It is each time different.
+            </para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+    </sect4>
   </sect3>
 </sect2>



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