[gimp-help-2] Line Nova (Render) filter: initial draft

[RyoTa SimaMoto <rsimamoto src gnome org>]

commit af618533e6d7ab2c3dfeb80148a0f4439e0b92cf
Author: SimaMoto,RyÅ?Ta <rsimamoto src gnome org>
Date:   Sat Jul 31 21:01:29 2010 +0900

    Line Nova (Render) filter: initial draft

 src/filters/render/line-nova.xml |   47 ++++++++++++++++++++++++-------------
 1 files changed, 30 insertions(+), 17 deletions(-)
---
diff --git a/src/filters/render/line-nova.xml b/src/filters/render/line-nova.xml
index 7ad0a6b..1274a3e 100644
--- a/src/filters/render/line-nova.xml
+++ b/src/filters/render/line-nova.xml
@@ -1,6 +1,6 @@
 <?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";>
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 
 <sect2 id="script-fu-line-nova">
   <title>Line Nova</title>
@@ -38,14 +38,24 @@
     </figure>
 
     <para>
-      <!--
-        Describe what the filter does, which algorithms it uses.
-        Give the user an idea what to use the filter for
-       -->
+      <guimenuitem>Line Nova</guimenuitem> command is a script which fills
+      a layer with rays emanating outward from its center using the foreground
+      color shown in the Toolbox.  All lines radiates from the near center of
+      the layer, and get broader to join both neighboring lines into outer
+      solid field filled with the foreground color.  Rendered lines are
+      cropped on the every edge of the image to be fit inside of it.
     </para>
+    <tip>
+      <para>
+        This filter does not provide any option which allow you to set the
+        center point of lines.  If you need adjust the place of the radial
+        lines where you want, create another transparent image and apply this
+        filter on it, then add it on your image.  Setting large size for the
+        new nova image may help you not to break lines inside of your image.
+      </para>
+    </tip>
   </sect3>
 
-
   <sect3>
     <title>Activating the filter</title>
     <para>
@@ -60,13 +70,6 @@
 
   <sect3>
     <title>Options</title>
-    <para>
-      <!--
-        Describe how the filter options are organized in general.
-        This part is optional, but helps if the filter options dialog is a bit
-        more complex e.g. has some tabs etc.
-       -->
-    </para>
     <figure>
       <title><quote>Line Nova</quote> options</title>
       <mediaobject>
@@ -82,7 +85,8 @@
         <term>Number of lines</term>
         <listitem>
           <para>
-            TODO
+            By using this slider you can set the number of lines between 40
+            to 1000. The default is 200.
           </para>
         </listitem>
       </varlistentry>
@@ -90,7 +94,11 @@
         <term>Sharpness (degrees)</term>
         <listitem>
           <para>
-            TODO
+            Every transparent chink between lines is tapering off toward the
+            outer direction.  To see the base image more wider, set this
+            degree more shorter so that the chick spaces stretch longer.
+            Allowed range is between 0.0 and 10.0, but note that 0.0 makes
+            nothing drawn.  The default is 1.0.
           </para>
         </listitem>
       </varlistentry>
@@ -98,7 +106,10 @@
         <term>Offset radius</term>
         <listitem>
           <para>
-            TODO
+            Almost lines don't reach the center point if this value is set
+            over 0.  By this option, you can set radius (between 0 to 2000
+            pixels) of the transparent space around the center point. The
+            default value is 100 pixels.
           </para>
         </listitem>
       </varlistentry>
@@ -106,7 +117,9 @@
         <term>Randomness</term>
         <listitem>
           <para>
-            TODO
+            Set this value more larger (up to 2000) to get more distoted
+            radiation.  Regular star shape is given by setting this value
+            to 1.  The default is 30.
           </para>
         </listitem>
       </varlistentry>