[gimp-help-2] Minor changes to Render filters
- From: Ulf-D. Ehlert <ulfehlert src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Minor changes to Render filters
- Date: Tue, 27 Jul 2010 10:23:08 +0000 (UTC)
commit bfd03741f0f60efc75b69ab13b9133d7a40208e8
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date: Tue Jul 27 12:07:26 2010 +0200
Minor changes to Render filters
Mostly formal changes, especially
* fix spelling of options (upper/lower case),
* change layout of options (<variablelist> vs. <itemizedlist>,
nested <variablelist>s).
src/filters/render/checkerboard.xml | 10 +-
src/filters/render/circuit.xml | 82 +++---
src/filters/render/cmlexplorer.xml | 189 +++++------
src/filters/render/flame.xml | 199 ++++++------
src/filters/render/fractalexplorer.xml | 544 +++++++++++++++--------------
src/filters/render/gfig.xml | 584 +++++++++++++++++---------------
src/filters/render/ifsfractal.xml | 257 ++++++++------
src/filters/render/jigsaw.xml | 24 +-
src/filters/render/maze.xml | 45 ++--
src/filters/render/plasma.xml | 27 +-
src/filters/render/qbist.xml | 9 +-
src/filters/render/sinus.xml | 301 +++++++++--------
src/filters/render/solid_noise.xml | 22 +-
src/filters/render/spheredesigner.xml | 301 +++++++++--------
14 files changed, 1362 insertions(+), 1232 deletions(-)
---
diff --git a/src/filters/render/checkerboard.xml b/src/filters/render/checkerboard.xml
index 5cf4a0b..f486095 100644
--- a/src/filters/render/checkerboard.xml
+++ b/src/filters/render/checkerboard.xml
@@ -76,19 +76,19 @@
</figure>
<variablelist>
<varlistentry>
- <term>Psychobilly</term>
+ <term>Size</term>
<listitem>
<para>
- This option gives an eiderdown look to the Checkerboard.
+ With this option, you can set checkerboard square size, in
+ pixels, or in your chosen unit by using the drop-down list.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Size</term>
+ <term>Psychobilly</term>
<listitem>
<para>
- With this option, you can set checkerboard square size, in
- pixels, or in your chosen unit by using the drop-down list.
+ This option gives an eiderdown look to the Checkerboard.
</para>
</listitem>
</varlistentry>
diff --git a/src/filters/render/circuit.xml b/src/filters/render/circuit.xml
index 8851f29..cf86c56 100644
--- a/src/filters/render/circuit.xml
+++ b/src/filters/render/circuit.xml
@@ -36,6 +36,14 @@
circuit board. It looks even better when gradmapped with a suitable
gradient.
</para>
+ <tip>
+ <para>
+ <!--This script doesn't handle or color combos well, i.e. black/black
+ doesn't work. (I don't understand this)-->
+ The effect seems to work best on odd shaped selections because of
+ some limitations in the maze codes selection handling ability.
+ </para>
+ </tip>
<para>
If the image is in indexed colors, this menu entry is grayed out
and unavailable.
@@ -48,45 +56,6 @@
The resulting image doesn't depend on the original image.
</para>
</note>
- <para>This effect is achieved through the following steps:</para>
- <procedure>
- <step>
- <para>
- First, <link linkend="plug-in-maze">draw maze</link> with 5 pixels
- width pathways and walls with the <quote>Depth First</quote>
- algorithm. The pattern of maze is set by <guilabel>Circuit
- seed</guilabel>.
- </para>
- </step>
- <step>
- <para>
- <link linkend="plug-in-oilify">Oilify</link> this maze with a brush
- of <guilabel>Oilify mask size</guilabel>.
- </para>
- </step>
- <step>
- <para>
- Then apply the <link linkend="plug-in-edge">extract edge</link>
- filter with Sobel algorithm, Smear option and Amount to 2.0,
- to the oilified maze image. This crowds high contrast winding curves
- like as a circuit map.
- </para>
- </step>
- <step>
- <para>
- Finally, <link linkend="gimp-tool-desaturate">Desaturate</link> the
- map with gray color in <acronym>RGB</acronym> mode.
- </para>
- </step>
- </procedure>
- <tip>
- <para>
- <!--This script doesn't handle or color combos well, i.e. black/black
- doesn't work. (I don't understand this)-->
- The effect seems to work best on odd shaped selections because of
- some limitations in the maze codes selection handling ability.
- </para>
- </tip>
</sect3>
<sect3>
@@ -168,4 +137,39 @@
</varlistentry>
</variablelist>
</sect3>
+
+ <sect3>
+ <title>Making the Circuit effect</title>
+ <para>The Circuit effect is achieved through the following steps:</para>
+ <procedure>
+ <step>
+ <para>
+ First, <link linkend="plug-in-maze">draw maze</link> with 5 pixels
+ width pathways and walls with the <quote>Depth First</quote>
+ algorithm. The pattern of maze is set by <guilabel>Circuit
+ seed</guilabel>.
+ </para>
+ </step>
+ <step>
+ <para>
+ <link linkend="plug-in-oilify">Oilify</link> this maze with a
+ brush of <guilabel>Oilify mask size</guilabel>.
+ </para>
+ </step>
+ <step>
+ <para>
+ Then apply the <link linkend="plug-in-edge">extract edge</link>
+ filter with Sobel algorithm, Smear option and Amount to 2.0, to
+ the oilified maze image. This crowds high contrast winding curves
+ like as a circuit map.
+ </para>
+ </step>
+ <step>
+ <para>
+ Finally, <link linkend="gimp-tool-desaturate">Desaturate</link>
+ the map with gray color in <acronym>RGB</acronym> mode.
+ </para>
+ </step>
+ </procedure>
+ </sect3>
</sect2>
diff --git a/src/filters/render/cmlexplorer.xml b/src/filters/render/cmlexplorer.xml
index b28c429..9e546e7 100644
--- a/src/filters/render/cmlexplorer.xml
+++ b/src/filters/render/cmlexplorer.xml
@@ -67,8 +67,8 @@
Filter options are distributed among
<guilabel>Hue</guilabel>,<guilabel>Saturation</guilabel>,
<guilabel>Value</guilabel>, <guilabel>Advanced</guilabel>,
- <guilabel>others</guilabel> and <guilabel>Misc.ops</guilabel>
- tabs. Some more options are available. They will be described
+ <guilabel>Others</guilabel> and <guilabel>Misc Ops.</guilabel>
+ tabs. Some more options are available. They will be described
in following section.
</para>
<variablelist>
@@ -83,23 +83,26 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>New seed; Fix seed; Random seed</term>
+ <term>New Seed</term>
+ <term>Fix Seed</term>
+ <term>Random Seed</term>
<listitem>
<para>
Random plays a large part in creating patterns. With these
options, you can influence the way random is generated. By
- clicking on the <guibutton>New seed</guibutton> button, you
+ clicking on the <guibutton>New Seed</guibutton> button, you
can force random to use a new source of random. The preview
will show you the result.
- <guibutton>Fix seed</guibutton> lets you keep the same seed
+ <guibutton>Fix Seed</guibutton> lets you keep the same seed
and so to reproduce the same effect with the filter.
- <guibutton>Random seed</guibutton> generates a random seed
+ <guibutton>Random Seed</guibutton> generates a random seed
at random.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Open; Save</term>
+ <term>Open</term>
+ <term>Save</term>
<listitem>
<para>
With these both command buttons you can save pattern
@@ -111,7 +114,7 @@
</simplesect>
<simplesect>
- <title><quote>CML Explorer</quote> filter options(Hue)</title>
+ <title><quote>CML Explorer</quote> filter options (Hue)</title>
<figure>
<title>Hue tab</title>
<mediaobject>
@@ -135,98 +138,79 @@
will be used to treat the current layer. These methods
are:
</para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Keep image's values</guilabel>: With this
- option, image hue values will be kept.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Keep the first value</guilabel>: With this
- option, starting color will be standard cyan.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Fill with k parameter</guilabel>,
- <guilabel>k{x(1-x)}^p</guilabel>,
- <guilabel>k{x(1-x)}^p stepped</guilabel>,
- <guilabel>kx^p</guilabel>,
- <guilabel>kx^p stepped</guilabel>,
- <guilabel>k(1-x^p)</guilabel>,
- <guilabel>k(1-x^p) stepped</guilabel>: pattern look
- will depend on <parameter>k</parameter> that you will
- set later in options.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Delta function</guilabel>,
- <guilabel>Delta function stepped</guilabel>: FIXME
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>sin^p based Function</guilabel>,
- <guilabel>sin^p stepped</guilabel>: These options
- create wave-like patterns, like aurora borealis or
- curtain folds.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Keep image's values</guilabel></term>
+ <listitem>
+ <para>
+ With this option, image hue values will be kept.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Keep the first value</guilabel></term>
+ <listitem>
+ <para>
+ With this option, starting color will be standard cyan.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Fill with k parameter</guilabel></term>
+ <listitem>
+ <para>
+ Pattern look will depend on <parameter>k</parameter> that
+ you will set later in options.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Miscellaneous f(k)</term>
+ <listitem>
+ <para>
+ See above, <quote>Fill with k parameter</quote>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Delta function</guilabel></term>
+ <term><guilabel>Delta function stepped</guilabel></term>
+ <listitem>
+ <para>
+ // TODO
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>sin^p-based function</guilabel></term>
+ <term><guilabel>sin^p, stepped</guilabel></term>
+ <listitem>
+ <para>
+ These options create wave-like patterns, like aurora
+ borealis or curtain folds.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term>Composition</term>
<listitem>
<para>
- Here, these options concern Hue. You can select:
- </para>
- <para>
- <guilabel>None</guilabel>, <guilabel>Max(x, -)</guilabel>,
- <guilabel>Max(x+d, -)</guilabel>,
- <guilabel>Max(x-d, -)</guilabel>,
- <guilabel>Min(x, -)</guilabel>,
- <guilabel>Min(x+d, -)</guilabel>,
- <guilabel>Min(x-d, -)</guilabel>,
- <guilabel>Max(x+d, -), (x < 0,5)</guilabel>,
- <guilabel>Max(x+d, -), (0,5 < x)</guilabel>,
- <guilabel>Max(x-d, -), (x < 0,5)</guilabel>,
- <guilabel>Max(x-d, -), (0,5 < x)</guilabel>,
- <guilabel>Min(x+d, -), (x < 0,5)</guilabel>,
- <guilabel>Min(x+d, -), (0,5 < x)</guilabel>,
- <guilabel>Min(x-d, -), (x < 0,5)</guilabel> and
- <guilabel>Min(x-d, -), (0,5 < x)</guilabel>.
- </para>
- <para>
- A book could be filled with results of all these
+ Here, these options concern Hue. You can choose among several
+ functions, and a book could be filled with results of all these
functions. Please, experiment!
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Misc. Arrange</term>
+ <term>Misc. arrange</term>
<listitem>
<para>
- This drop-down list offers you some other parameters:
- </para>
- <para>
- <guilabel>Standard</guilabel>,
- <guilabel>Use average value</guilabel>,
- <guilabel>Use reverse value</guilabel>,
- <guilabel>With random power (0,10)</guilabel>,
- <guilabel>With random power (0,1)</guilabel>,
- <guilabel>with gradient power (0,1)</guilabel>,
- <guilabel>Multiply rand. value (0,1)</guilabel>,
- <guilabel>Multiply rand. value (0,2)</guilabel>,
- <guilabel>Multiply gradient (0,1)</guilabel> and
- <guilabel>With p and random (0,1)</guilabel>.
- </para>
- <para>
- Also a book would be necessary to explain all
- possibilities of these parameters.
+ This drop-down list offers you several other parameters.
+ Also a book would be necessary to explain all possibilities of
+ these parameters.
</para>
</listitem>
</varlistentry>
@@ -234,7 +218,7 @@
<term>Use cyclic range</term>
<listitem>
<para>
- //TODO
+ // TODO
</para>
</listitem>
</varlistentry>
@@ -283,7 +267,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>k Parameter</term>
+ <term>Parameter k</term>
<listitem>
<para>
With this option you can influence the
@@ -311,7 +295,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Plot a graph of the settings</term>
+ <term>Plot a Graph of the Settings</term>
<listitem>
<para>
By clicking on this large button, you can open a window
@@ -332,7 +316,7 @@
</simplesect>
<simplesect>
- <title><quote>CML Explorer</quote> filter options(Saturation)</title>
+ <title><quote>CML Explorer</quote> filter options (Saturation)</title>
<figure>
<title>Saturation tab</title>
<mediaobject>
@@ -357,7 +341,8 @@
<title>Value tab</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/options-render-cmlexplorer3.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/options-render-cmlexplorer3.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -386,7 +371,8 @@
</para>
<variablelist>
<varlistentry>
- <term>Channel Sensitivity</term>
+ <!--Ch. sensitivity-->
+ <term>Channel sensitivity</term>
<listitem>
<para>// TODO</para>
</listitem>
@@ -398,9 +384,10 @@
</listitem>
</varlistentry>
<varlistentry>
+ <!--Mutation dist.-->
<term>Mutation distance</term>
<listitem>
- <para>//TODO</para>
+ <para>// TODO</para>
</listitem>
</varlistentry>
</variablelist>
@@ -429,7 +416,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Zoom factor</term>
+ <term>Zoom scale</term>
<listitem>
<para>// TODO</para>
</listitem>
@@ -441,7 +428,8 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Seed of random</term>
+ <!--Seed of Random (only for "From Seed" Modes)-->
+ <term>Seed of Random</term>
<listitem>
<para>// TODO</para>
</listitem>
@@ -450,12 +438,13 @@
</simplesect>
<simplesect>
- <title><quote>CML Explorer</quote> filter options (Misc.ops)</title>
+ <title><quote>CML Explorer</quote> filter options (Misc Ops.)</title>
<figure>
<title>Miscellaneous options tab</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/options-render-cmlexplorer6.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/options-render-cmlexplorer6.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -464,7 +453,7 @@
</para>
<variablelist>
<varlistentry>
- <term>Copy settings</term>
+ <term>Copy Settings</term>
<listitem>
<para>
These options allow you to transfer information from
@@ -473,7 +462,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Selective load setting</term>
+ <term>Selective Load Settings</term>
<listitem>
<para>
With the <guibutton>Open</guibutton> button of this
diff --git a/src/filters/render/flame.xml b/src/filters/render/flame.xml
index 9c9bc39..f7e465f 100644
--- a/src/filters/render/flame.xml
+++ b/src/filters/render/flame.xml
@@ -157,115 +157,108 @@
</para>
</listitem>
</varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Rendering</title>
+ <varlistentry>
+ <term>Brightness</term>
+ <listitem>
+ <para>
+ Controls the brightness of the flame object.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Contrast</term>
+ <listitem>
+ <para>
+ Controls the contrast between brighter and dimmer parts of
+ the flame.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Gamma</term>
+ <listitem>
+ <para>
+ Sets a gamma correction for parts with intermediate
+ brightness.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Sample density</term>
+ <listitem>
+ <para>
+ Controls the resolution of the rendered pattern. (Does
+ not have any effect on the preview.) A high sample
+ density results in soft and smooth
+ rendering (like a spider's web), whereas low density
+ rendering resembles spray or particle clouds.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
- <term>Rendering tab</term>
+ <term>Spatial oversample</term>
<listitem>
- <variablelist>
- <varlistentry>
- <term>Brightness</term>
- <listitem>
- <para>
- Controls the brightness of the flame object.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Contrast</term>
- <listitem>
- <para>
- Controls the contrast between brighter and dimmer parts of
- the flame.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Gamma</term>
- <listitem>
- <para>
- Sets a gamma correction for parts with intermediate
- brightness.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Sample Density</term>
- <listitem>
- <para>
- Controls the resolution of the rendered pattern. (Does
- not have any effect on the preview.) A high sample
- density results in soft and smooth
- rendering (like a spider's web), whereas low density
- rendering resembles spray or particle clouds.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Spatial Oversample</term>
- <listitem>
- <para>
- What does this do?
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Spatial Filter Radius</term>
- <listitem>
- <para>
- What does this do?
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Colormap</term>
- <listitem>
- <para>
- This menu gives you several options to set the color blend
- in the flame pattern:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- The current gradient as shown in the Toolbox.
- </para>
- </listitem>
- <listitem>
- <para>
- A number of preset colormaps.
- </para>
- </listitem>
- <listitem>
- <para>
- The colors from images that are presently open in
- <acronym>GIMP</acronym>.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- </variablelist>
+ <para>
+ What does this do?
+ </para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Camera tab</term>
+ <term>Spatial filter radius</term>
<listitem>
- <variablelist>
- <varlistentry>
- <term>Zoom</term>
- <listitem>
- <para>
- Allows you to zoom the flame in or out.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>X, Y</term>
- <listitem>
- <para>
- Allows you to move the flame around in the image area.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
+ <para>
+ What does this do?
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Colormap</term>
+ <listitem>
+ <para>
+ This menu gives you several options to set the color blend
+ in the flame pattern:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ The current gradient as shown in the Toolbox.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ A number of preset colormaps.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The colors from images that are presently open in
+ <acronym>GIMP</acronym>.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Camera</title>
+ <varlistentry>
+ <term>Zoom</term>
+ <listitem>
+ <para>
+ Allows you to zoom the flame in or out.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>X</term>
+ <term>Y</term>
+ <listitem>
+ <para>
+ Allows you to move the flame around in the image area.
+ </para>
</listitem>
</varlistentry>
</variablelist>
diff --git a/src/filters/render/fractalexplorer.xml b/src/filters/render/fractalexplorer.xml
index 4063d63..6799747 100644
--- a/src/filters/render/fractalexplorer.xml
+++ b/src/filters/render/fractalexplorer.xml
@@ -59,268 +59,286 @@
<sect3>
<title>Options</title>
- <figure>
- <title>
- <quote>Parameters</quote> options for Fractal Explorer filter
- </title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/options-render-fractalexplorer1.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <variablelist>
- <varlistentry>
- <term>Realtime preview</term>
- <listitem>
- <para>
- Uncheck the <guilabel>Real time preview</guilabel> only if your
- computer is slow. In this case, you can update preview by
- clicking on the <guibutton>Redraw</guibutton> button.
- </para>
- <para>
- By clicking-dragging mouse pointer on preview, you can draw a
- rectangle delimiting an area which will be zoomed.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Zoom</term>
- <listitem>
- <para>
- You have there some options to zoom in or zoom out. The
- <guibutton>Undo</guibutton> allows you to return to previous
- state, before zooming. The <guibutton>Redo</guibutton> allows
- you to reestablish the zoom you had undone, without having to
- re-create it with the zoom-in button.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Parameters tab</term>
- <listitem>
- <para>
- This tab contains some options to set fractal calculation and
- select fractal type.
- </para>
- <variablelist>
- <varlistentry>
- <term>Fractal Parameters</term>
- <listitem>
- <para>
- here, you have sliders and input boxes to set fractal
- spreading, repetition and aspect.
- </para>
- <variablelist>
- <varlistentry>
- <term>XMIN; XMAX; YMIN; YMAX</term>
- <listitem>
- <para>
- You can set fractal spreading between a MINimum and
- a MAXimum, in the horizontal (X) and/or vertical (Y)
- directions. Values are from -3.0 to 3.0.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>ITER</term>
- <listitem>
- <para>
- With this parameter, you can set fractal iteration,
- repetition and so detail. Values are from 0.0 to
- 1000.0
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>CX; CY</term>
- <listitem>
- <para>
- With these parameters, you can change fractal
- aspect, in the horizontal (X) and/or vertical (Y)
- directions, except for Mandelbrot and Sierpinski
- types.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Open; Reset; Save</term>
- <listitem>
- <para>
- With these three buttons, you can save your work
- with all its parameters, open a previously saved
- fractal, or return to the initial state before all
- modifications.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Fractal type</term>
- <listitem>
- <para>
- You can choose what fractal type will be, for instance
- <guilabel>Mandelbrot</guilabel>, <guilabel>Julia</guilabel>,
- <guilabel>Barnsley</guilabel> or
- <guilabel>Sierpinski</guilabel>.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Colors tab</term>
- <listitem>
- <figure>
- <title>Color tab options</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/options-render-fractalexplorer2.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- This tab contains options for fractal color setting.
- </para>
- <variablelist>
- <varlistentry>
- <term>Color number</term>
- <listitem>
- <para>
- This slider and its input boxes allow you to set the
- number of colors for the fractal, between 2 and 8192.
- A palette of these colors is displayed at the bottom of
- the tab. Actually, that's a gradient between colors in
- fractal: you can change colors with <quote>Color intensity
- </quote> and <quote>Color function </quote> options.
- Fractal colors don't depend on colors of the original
- image (you can use a white image for fractals as well).
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Use loglog-smoothing</term>
- <listitem>
- <para>
- If this option is checked, the band effect is smoothed.
- </para>
- <figure>
- <title>Loglog smoothing example</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/examples/render-fractalexpl.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Color density</term>
- <listitem>
- <para>
- These three sliders and their text-boxes let you set the
- color intensity in the three
- <guilabel>Red</guilabel>, <guilabel>Green</guilabel> and
- <guilabel>Blue</guilabel> color channels. Values vary from
- 0.0 to 1.0.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Color function</term>
- <listitem>
- <para>
- For the <guilabel>Red</guilabel>,
- <guilabel>Green</guilabel> and <guilabel>Blue</guilabel>
- color channels, you can select how color will be treated:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Sinus</guilabel>: Color variations will be
- modulated according to the sinus function.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Cosinus</guilabel>: Color densities will
- vary according to cosinus function.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>None</guilabel>: Color densities will vary
- linearly.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Inversion</guilabel>: if you check this
- option, function values will be inverted.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Color Mode</term>
- <listitem>
- <para>
- These options allow you to set where color values must be
- taken from.
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>As specified above</guilabel>: Color values
- will be taken from the <guilabel>Color density
- </guilabel> options.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Apply active gradient to final image
- </guilabel>: used colors will be that of active
- gradient. You should be able to select another gradient
- by clicking on the gradient source button.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Fractals tab</term>
- <listitem>
- <figure>
- <title><quote>Fractal tab</quote> options</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/options-render-fractalexplorer3.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- This tab contains a big list of fractals with their parameters,
- that you can use as a model: only click on the wanted one.
- </para>
- <para>
- The <guibutton>Refresh</guibutton> allows you to update the
- list if you have saved your work, without needing to re-start
- GIMP. You can delete the selected fractal from the list by
- clicking on the <guibutton>Delete</guibutton>.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
+
+ <sect4>
+ <title>Preview and Zoom</title>
+ <variablelist>
+ <varlistentry>
+ <term>Realtime preview</term>
+ <listitem>
+ <para>
+ Uncheck the <guilabel>Realtime preview</guilabel> only if your
+ computer is slow. In this case, you can update preview by
+ clicking on the <guibutton>Redraw preview</guibutton> button.
+ </para>
+ <para>
+ By clicking-dragging mouse pointer on preview, you can draw a
+ rectangle delimiting an area which will be zoomed.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Zoom</term>
+ <listitem>
+ <para>
+ You have there some options to zoom in or zoom out. The
+ <guibutton>Undo</guibutton> allows you to return to previous
+ state, before zooming. The <guibutton>Redo</guibutton> allows
+ you to reestablish the zoom you had undone, without having to
+ re-create it with the zoom-in button.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4>
+ <title>Parameters</title>
+ <figure>
+ <title>
+ <quote>Fractal Explorer</quote> filter options (Parameters)
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-render-fractalexplorer1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ This tab contains some options to set fractal calculation and select
+ fractal type.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Fractal Parameters</term>
+ <listitem>
+ <para>
+ Here, you have sliders and input boxes to set fractal
+ spreading, repetition and aspect.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <!--XMIN-->
+ <term>Left</term>
+ <!--XMAX-->
+ <term>Right</term>
+ <!--YMIN-->
+ <term>Top</term>
+ <!--YMAX-->
+ <term>Bottom</term>
+ <listitem>
+ <para>
+ You can set fractal spreading between a minimum and a
+ maximum, in the horizontal and/or vertical directions.
+ Values are from -3.0 to 3.0.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <!--ITER-->
+ <term>Iteration</term>
+ <listitem>
+ <para>
+ With this parameter, you can set fractal iteration,
+ repetition and so detail. Values are from 0.0 to 1000.0
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>CX</term>
+ <term>CY</term>
+ <listitem>
+ <para>
+ With these parameters, you can change fractal aspect, in
+ the horizontal (X) and/or vertical (Y) directions, except
+ for Mandelbrot and Sierpinski types.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Open</term>
+ <term>Reset</term>
+ <term>Save</term>
+ <listitem>
+ <para>
+ With these three buttons, you can save your work
+ with all its parameters, open a previously saved
+ fractal, or return to the initial state before all
+ modifications.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Fractal Type</term>
+ <listitem>
+ <para>
+ You can choose what fractal type will be, for instance
+ <guilabel>Mandelbrot</guilabel>, <guilabel>Julia</guilabel>,
+ <guilabel>Barnsley</guilabel> or
+ <guilabel>Sierpinski</guilabel>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4>
+ <title>Colors</title>
+ <figure>
+ <title>
+ <quote>Fractal Explorer</quote> filter options (Colors)
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-render-fractalexplorer2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>This tab contains options for fractal color setting.</para>
+ <variablelist>
+ <title>Number of Colors</title>
+ <varlistentry>
+ <term>Number of colors</term>
+ <listitem>
+ <para>
+ This slider and its input boxes allow you to set the number of
+ colors for the fractal, between 2 and 8192. A palette of these
+ colors is displayed at the bottom of the tab. Actually, that's a
+ gradient between colors in fractal: you can change colors with
+ <quote>Color Density</quote> and <quote>Color Function</quote>
+ options. Fractal colors don't depend on colors of the original
+ image (you can use a white image for fractals as well).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Use loglog smoothing</term>
+ <listitem>
+ <para>
+ If this option is checked, the band effect is smoothed.
+ </para>
+ <figure>
+ <title>Loglog smoothing example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/render-fractalexpl.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Color density</title>
+ <varlistentry>
+ <term>Red</term>
+ <term>Green</term>
+ <term>Blue</term>
+ <listitem>
+ <para>
+ These three sliders and their text-boxes let you set the color
+ intensity in the three color channels. Values vary from 0.0 to
+ 1.0.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Color Function</title>
+ <para>
+ For the <guilabel>Red</guilabel>, <guilabel>Green</guilabel> and
+ <guilabel>Blue</guilabel> color channels, you can select how color
+ will be treated:
+ </para>
+ <varlistentry>
+ <term>Sine</term>
+ <listitem>
+ <para>
+ Color variations will be modulated according to the sine
+ function.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Cosine</term>
+ <listitem>
+ <para>
+ Color densities will vary according to cosine function.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>None</term>
+ <listitem>
+ <para>Color densities will vary linearly.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Inversion</term>
+ <listitem>
+ <para>
+ If you check this option, function values will be inverted.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Color Mode</title>
+ <para>
+ These options allow you to set where color values must be taken
+ from.
+ </para>
+ <varlistentry>
+ <term>As specified above</term>
+ <listitem>
+ <para>
+ Color values will be taken from the <guilabel>Color
+ Density</guilabel> options.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Apply active gradient to final image</term>
+ <listitem>
+ <para>
+ Used colors will be that of active gradient. You should be able
+ to select another gradient by clicking on the gradient source
+ button.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4>
+ <title>Fractals</title>
+ <figure>
+ <title>
+ <quote>Fractal Explorer</quote> filter options (Fractals)
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-render-fractalexplorer3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ This tab contains a big list of fractals with their parameters, that
+ you can use as a model: only click on the wanted one.
+ </para>
+ <para>
+ The <guibutton>Refresh</guibutton> allows you to update the list if
+ you have saved your work, without needing to re-start
+ <acronym>GIMP</acronym>. You can delete the selected fractal from the
+ list by clicking on the <guibutton>Delete</guibutton>.
+ </para>
+ </sect4>
</sect3>
</sect2>
diff --git a/src/filters/render/gfig.xml b/src/filters/render/gfig.xml
index a891d9c..0ecb556 100644
--- a/src/filters/render/gfig.xml
+++ b/src/filters/render/gfig.xml
@@ -66,7 +66,7 @@
</para>
</sect3>
- <sect3>
+ <sect3 id="plug-in-gfig-options">
<title>Options</title>
<figure>
<title><quote>Gfig</quote> filter options</title>
@@ -77,276 +77,316 @@
</imageobject>
</mediaobject>
</figure>
- <variablelist>
- <varlistentry>
- <term>The tool bar</term>
- <listitem>
- <para>
- At the top of dialog, you can find a set of icons which
- represents the functions of this filter. Help pop-ups are
- explicit.
- </para>
- <variablelist>
- <varlistentry>
- <term>Functions for object drawing </term>
- <listitem>
- <para>
- On the left part of tool bar, you can find some functions
- for object drawing. You enable them by clicking on the
- corresponding icon. You can create the following objects
- (note that <emphasis>Control points</emphasis> are
- created at the same time as object):
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Line</guilabel>: With this tool, you can
- draw lines. Click on Preview to mark start point, then
- drag mouse pointer to the end point.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Circle</guilabel>: With this tool, you can
- draw circles. Click on Preview to mark center, then
- drag mouse pointer to the wanted radius.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Ellipse</guilabel>: With this tool, you can
- draw ellipses. Click on Preview to mark center, then
- drag mouse pointer to get the wanted size and form.
- </para>
- </listitem>
- <listitem>
- <para>
- <guibutton>Arc</guibutton>: With this tool, you can
- draw circle arcs. Click on Preview to set start point.
- Click again to set another arc point. Without
- releasing mouse button, drag pointer; when you
- release mouse button, the arc end point is placed and
- an arc encompassing these three points is drawn.
- </para>
- </listitem>
- <listitem>
- <para>
- <guibutton>Regular polygon</guibutton>: With this
- tool, you can create a regular polygon. Start with
- setting side number in <guilabel>Tool Options
- </guilabel> at the right of Preview. Then click on
- Preview to place center and, without releasing mouse
- button, drag pointer to get the wanted size and
- orientation.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Star</guilabel>: With this
- tool, you can create a star. Start with
- setting side number (spikes) in <guilabel>Tool Options
- </guilabel> at the right of Preview. Then click on
- Preview to place center and, without releasing mouse
- button, drag pointer to get the wanted size and
- orientation.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Spiral</guilabel>: With this
- tool, you can create a spiral. Start with
- setting spire number (sides) and spire orientation in
- <guilabel>Tool Options </guilabel> at the right of
- Preview. Then click on Preview to place center and,
- without releasing mouse button, drag pointer to get
- the wanted size.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Bezier's Curve</guilabel>: With this tool,
- you can create Bezier's curves. Click on Preview to
- set start point and the other points: the curve will
- be created between these points. To end point creation
- press <keycap>Shift</keycap> key when creating last
- point.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Functions for object management</term>
- <listitem>
- <para>
- In the middle of tool bar, you can find tools to manage
- objects:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Move (Object)</guilabel>: With this tool,
- you can move the active object. To enable an object,
- click on a control point created at the same time as
- the object.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Move (Point)</guilabel>: With this tool, you
- can click-and-drag one of the control points created
- at the same time as object. Each of these points moves
- the object in a different way.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Copy</guilabel>: With this tool, you can
- duplicate an object. Click on an object control point
- and drag it to the wanted place.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Delete</guilabel>: Click on an object
- control point to delete it.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Select</guilabel>: With this tool, you can
- select an object to active it. Simply click on one of
- its control points.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Functions for object organisation</term>
- <listitem>
- <para>
- At the right of tool bar, you can find tools for object
- superimposing (you can also get them by clicking on the
- drop-down list button if they are not visible). You have:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Raise/Lower Selected Object</guilabel>:
- With this tool, you can push the selected object one
- level up or down.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Raise/Lower selected object to
- top/bottom</guilabel>: self explanatory.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Functions for object display</term>
- <listitem>
- <para>
- The drop-down list in tool bar offers you some more
- functions:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Back/Forward</guilabel>: These functions
- allow you to jump from one object to another. Only
- this object is displayed.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Show all objects</guilabel>: This function
- shows all objects again, after using both previous
- functions.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Preview field</term>
- <listitem>
- <para>
- Preview comes with several options:
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Settings</term>
- <listitem>
- <para>
- In this area, you have several options to work with this filter.
- </para>
- <variablelist>
- <varlistentry>
- <term>Tool Options</term>
- <listitem>
- <para>
- This area shows tool options.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Stroke</term>
- <listitem>
- <para>
- If this option is checked, the object will be drawn. Two
- buttons are available, to select color and brush type.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Filling</term>
- <listitem>
- <para>
- With help of this drop-down list, you can decide whether
- and how the object will be filled, with a color, a pattern
- or a gradient.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Show grid</term>
- <listitem>
- <para>
- If this option is checked, a grid is applied on Preview to
- make object positioning easier.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Snap to Grid</term>
- <listitem>
- <para>
- If this option is checked, objects will align to the grid.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Show image</term>
- <listitem>
- <para>
- When this option is checked, the current image is
- displayed in Preview. If not checked, a white surface is
- shown and neither stroke color nor brush type are shown.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- </variablelist>
+
+ <!-- TODO: should we eliminate the word "Preview"? -->
+ <para>
+ The Preview (with a horizontal and a vertical ruler) on the left of the
+ main window actually is your working area where you are adding your
+ figures.
+ </para>
+ <para>
+ You can add and modify figures using the Gfig tools
+ (<link linkend="plug-in-gfig-toolbar">Gfig tool bar</link>
+ and using the appropriate options
+ (<link linkend="plug-in-gfig-mainwindow">Gfig main window</link>).
+ </para>
+
+ <!-- FIXME: Gfig menu ("File", "Edit") is not documented -->
+<!--
+ <sect4 id="plug-in-gfig-menu">
+ </sect4>
+-->
+
+ <sect4 id="plug-in-gfig-toolbar">
+ <title>The Gfig tool bar</title>
+ <para>
+ At the top of dialog, you can find a set of icons which represents the
+ functions of this filter. Help pop-ups are explicit.
+ </para>
+ <variablelist>
+ <title>Functions for object drawing</title>
+ <para>
+ On the left part of tool bar, you can find some functions for object
+ drawing. You enable them by clicking on the corresponding icon. You
+ can create the following objects (note that <emphasis>Control
+ points</emphasis> are created at the same time as object):
+ </para>
+ <varlistentry>
+ <!--terms according to tooltips-->
+ <term>Create line</term>
+ <listitem>
+ <para>
+ With this tool, you can draw lines. Click on Preview to mark
+ start point, then drag mouse pointer to the end point.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Create rectangle</term>
+ <listitem>
+ <para>
+ With this tool, you can draw rectangles. Click on Preview to
+ mark start point, then drag mouse pointer to create the
+ rectangle.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Create circle</term>
+ <listitem>
+ <para>
+ With this tool, you can draw circles. Click on Preview to mark
+ center, then drag mouse pointer to the wanted radius.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Create ellipse</term>
+ <listitem>
+ <para>
+ With this tool, you can draw ellipses. Click on Preview to mark
+ center, then drag mouse pointer to get the wanted size and form.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Create arc</term>
+ <listitem>
+ <para>
+ With this tool, you can draw circle arcs. Click on Preview to
+ set start point. Click again to set another arc point. Without
+ releasing mouse button, drag pointer; when you release mouse
+ button, the arc end point is placed and an arc encompassing
+ these three points is drawn.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Create regular polygon</term>
+ <listitem>
+ <para>
+ With this tool, you can create a regular polygon. Start with
+ setting side number in <guilabel>Tool Options</guilabel> at the
+ right of Preview. Then click on Preview to place center and,
+ without releasing mouse button, drag pointer to get the wanted
+ size and orientation.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Create star</term>
+ <listitem>
+ <para>
+ With this tool, you can create a star. Start with setting side
+ number (spikes) in <guilabel>Tool Options</guilabel> at the
+ right of Preview. Then click on Preview to place center and,
+ without releasing mouse button, drag pointer to get the wanted
+ size and orientation.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Create spiral</term>
+ <listitem>
+ <para>
+ With this tool, you can create a spiral. Start with setting
+ spire number (sides) and spire orientation in <guilabel>Tool
+ Options</guilabel> at the right of Preview. Then click on
+ Preview to place center and, without releasing mouse button,
+ drag pointer to get the wanted size.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Create bezier curve</term>
+ <listitem>
+ <para>
+ With this tool, you can create Bézier curves. Click on
+ Preview to set start point and the other points: the curve will
+ be created between these points. To end point creation press
+ <keycap>Shift</keycap> key when creating last point.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Functions for object management</title>
+ <para>
+ In the middle of tool bar, you can find tools to manage objects:
+ </para>
+ <varlistentry>
+ <term>Move an object</term>
+ <listitem>
+ <para>
+ With this tool, you can move the active object. To enable an
+ object, click on a control point created at the same time as the
+ object.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Move a single point</term>
+ <listitem>
+ <para>
+ With this tool, you can click-and-drag one of the control points
+ created at the same time as object. Each of these points moves
+ the object in a different way.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Copy an object</term>
+ <listitem>
+ <para>
+ With this tool, you can duplicate an object. Click on an object
+ control point and drag it to the wanted place.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Delete an object</term>
+ <listitem>
+ <para>Click on an object control point to delete it.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Select an object</term>
+ <listitem>
+ <para>
+ With this tool, you can select an object to active it. Simply
+ click on one of its control points.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Functions for object organisation</title>
+ <para>
+ At the right of tool bar, you can find tools for object
+ superimposing (you can also get them by clicking on the drop-down
+ list button if they are not visible). You have:
+ </para>
+ <varlistentry>
+ <term>Up (Raise selected object)</term>
+ <term>Down (Lower selected object)</term>
+ <listitem>
+ <para>
+ With this tool, you can push the selected object one level up or
+ down.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <!--terms according to drop-down list-->
+ <!--Raise selected object to top-->
+ <term>Top</term>
+ <!--Lower selected object to bottom-->
+ <term>Bottom</term>
+ <listitem>
+ <para>Self explanatory.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Functions for object display</title>
+ <varlistentry>
+ <!--Show previous object-->
+ <term>Back</term>
+ <!--Show next object-->
+ <term>Forward</term>
+ <listitem>
+ <para>
+ These functions allow you to jump from one object to another.
+ Only this object is displayed.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Show all objects</term>
+ <listitem>
+ <para>
+ This function shows all objects again, after using both previous
+ functions.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <note>
+ <para>
+ If your window is too small to show all icons, the tool bar provides a
+ drop-down list which offers you the missing functions.
+ </para>
+ </note>
+ </sect4>
+
+ <sect4 id="plug-in-gfig-mainwindow">
+ <title>The Gfig main window</title>
+ <variablelist>
+ <varlistentry>
+ <term>Object Details</term>
+ <listitem>
+ <para>
+ The <guilabel>XY position</guilabel> shows the position of your
+ pointer.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Tool Options</term>
+ <listitem>
+ <para>
+ If the selected tools provides some options (like number of
+ sides), you can change them here.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Stroke</term>
+ <listitem>
+ <para>
+ If this option is checked, the object will be drawn. Two
+ buttons are available, to select color and brush type.
+ Changes to color or brush apply to existing objects too.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Fill</term>
+ <listitem>
+ <para>
+ With help of this drop-down list, you can decide whether
+ and how the object will be filled, with a color, a pattern
+ or a gradient.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Show grid</term>
+ <listitem>
+ <para>
+ If this option is checked, a grid is applied on Preview to
+ make object positioning easier.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Snap to grid</term>
+ <listitem>
+ <para>
+ If this option is checked, objects will align to the grid.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Show image</term>
+ <listitem>
+ <para>
+ When this option is checked, the current image is displayed in
+ Preview (working area).
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
</sect3>
</sect2>
diff --git a/src/filters/render/ifsfractal.xml b/src/filters/render/ifsfractal.xml
index e0d0cd3..13285e3 100644
--- a/src/filters/render/ifsfractal.xml
+++ b/src/filters/render/ifsfractal.xml
@@ -74,7 +74,7 @@
<guimenu>Filters</guimenu>
<guisubmenu>Render</guisubmenu>
<guisubmenu>Nature</guisubmenu>
- <guimenuitem>IFS fractal</guimenuitem>
+ <guimenuitem>IFS Fractal</guimenuitem>
</menuchoice>.
</para>
</sect3>
@@ -82,7 +82,7 @@
<sect3>
<title>Options</title>
<figure>
- <title><quote>IFS fractal</quote> filter options</title>
+ <title><quote>IFS Fractal</quote> filter options</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
@@ -90,153 +90,190 @@
</imageobject>
</mediaobject>
</figure>
+ <para>
+ The plug-in interface consists of the compose area to the left, a
+ preview screen to the right, and some tabs and option buttons at the
+ bottom of the dialog. The Default setting (in the preview window) is
+ three equilateral triangles. (This gives rise to a fractal pattern
+ called the <emphasis>Sierpinski Triangle</emphasis>).
+ </para>
<variablelist>
+ <title>Toolbar</title>
+ <para>
+ Click on the toolbar buttons to use the following tools, or open the
+ context menu of the compose area.
+ </para>
<varlistentry>
- <term>The Main Interface</term>
+ <term>Move</term>
+ <term>Rotate/Scale</term>
+ <term>Stretch</term>
<listitem>
- <para>
- The plug-in interface consists of the compose area to the left, a
- preview screen to the right, and some tabs and option buttons at
- the bottom of the dialog. The Default setting (in the preview
- window) is three equilateral triangles. (This gives rise to a
- fractal pattern called the
- <emphasis>Sierpinski Triangle</emphasis>).
- </para>
+ <para>Select the action to perform using the (mouse) pointer.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Toolbar</term>
+ <term>New</term>
+ <term>Delete</term>
<listitem>
- <para>
- Some tools are directly visible in this tool bar:
- <guibutton>Move</guibutton>,
- <guibutton>Rotate</guibutton>, <guibutton>Stretch</guibutton>,
- <guibutton>New</guibutton>,
- <guibutton>Delete</guibutton>, <guibutton>Undo</guibutton>,
- <guibutton>Redo</guibutton>,
- <guibutton>Select All</guibutton>.
- You can see others, if your window is not wide enough, by
- clicking on the drop-down list button on the right of tool bar:
- <guibutton>Recenter</guibutton> and
- <guibutton>Render Options</guibutton> where you have have
- several parameters:
- </para>
- <variablelist>
- <varlistentry>
- <term>Render Options</term>
- <listitem>
- <variablelist>
- <varlistentry>
- <term>Memory</term>
- <listitem>
- <para>
- Enables you to speed up rendering time. This is
- especially useful when working with a large spot
- radius; just remember to use even multiples of the
- default value: 4096, 8192, 16384, ...
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Iterations</term>
- <listitem>
- <para>
- Determines how many times the fractal will repeat
- itself. (A high value for Subdivide and Iterations is
- for obvious reasons a waste of process time unless
- your image is very large.)
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Subdivide</term>
- <listitem>
- <para>Controls the level of detail.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Spot Radius</term>
- <listitem>
- <para>
- Determines the density of the
- <quote>brushstrokes</quote>
- in the rendered image. A low spot radius is good for
- thin particle clouds or spray, while a high spot
- radius produces thick, solid color strokes much like
- watercolor painting. Be careful not to use too much
- spot radius -- it takes a lot of time to render.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- </variablelist>
+ <para>Add or remove fractals.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Spatial Transformation</term>
+ <term>Undo</term>
+ <term>Redo</term>
<listitem>
+ <para>Standard.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Select all</term>
+ <listitem>
+ <para>Link fractals and let apply actions to all fractals.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Recenter</term>
+ <listitem>
+ <!--TODO: when or why is this useful?-->
<para>
- Gives you information on the active fractal, and allows you to
- type a value instead of changing it manually. Changing parameters
- with the mouse isn't very accurate, so this is a useful option
- when you need to be exact.
- </para>
+ Recompute the center of the fractals. This does not have any
+ visible effect to the resulting fractal.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Color transformation</term>
+ <term>Render Options</term>
<listitem>
- <figure>
- <title><quote>Color transformation</quote> tab options</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/options-render-ifscompose2.png"/>
- </imageobject>
- </mediaobject>
- </figure>
<variablelist>
<varlistentry>
- <term>Simple color transformation</term>
+ <term>Max. memory</term>
<listitem>
<para>
- Changes the color of the currently selected fractal
- component (default is the foreground color in the toolbox)
- to a color of your choice.
+ Enables you to speed up rendering time. This is
+ especially useful when working with a large spot
+ radius; just remember to use even multiples of the
+ default value: 4096, 8192, 16384, ...
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Full color transformation</term>
+ <term>Iterations</term>
<listitem>
<para>
- Like the Simple color transformation but this time you can
- manage the color transformation for each color channel and
- for the alpha channel (shown as a black channel).
+ Determines how many times the fractal will repeat
+ itself. (A high value for Subdivide and Iterations is
+ for obvious reasons a waste of process time unless
+ your image is very large.)
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Scale Hue/Value</term>
+ <term>Subdivide</term>
+ <listitem>
+ <para>Controls the level of detail.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Spot radius</term>
<listitem>
<para>
- When you have many fractals with different colors, the
- colors blend into each other. So even if you set
- <quote>pure red</quote> for a fractal, it might actually
- be quite blue in some places, while another <quote>red
- </quote> fractal might have a lot of yellow in it. Scale
- Hue/Value changes the color strength of the active
- fractal, or how influential that fractal color should be.
+ Determines the density of the <quote>brushstrokes</quote> in
+ the rendered image. A low spot radius is good for thin
+ particle clouds or spray, while a high spot radius produces
+ thick, solid color strokes much like watercolor painting. Be
+ careful not to use too much spot radius — it takes a
+ lot of time to render.
</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Spatial Transformation</title>
+ <para>
+ Gives you information on the active fractal, and allows you to type a
+ value instead of changing it manually. Changing parameters with the
+ mouse isn't very accurate, so this is a useful option when you need to
+ be exact.
+ </para>
+ <varlistentry>
+ <term>X</term>
+ <term>Y</term>
+ <term>Scale</term>
+ <term>Angle</term>
+ <term>Shear</term>
+ <listitem>
+ <para>Move, scale, or shear the active fractal.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Asymmetry</term>
+ <listitem>
+ <para>Stretch the active fractal.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Flip</term>
+ <listitem>
+ <para>Flip the active fractal.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Color Transformation</title>
+ <para>
+ <figure>
+ <title>IFS Fractal options (Color Transformation)</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-render-ifscompose2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </para>
+ <varlistentry>
+ <term>Simple</term>
+ <listitem>
+ <para>
+ Changes the color of the currently selected fractal
+ component (default is the foreground color in the toolbox)
+ to a color of your choice.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Full</term>
+ <listitem>
+ <para>
+ Like the Simple color transformation but this time you can
+ manage the color transformation for each color channel and
+ for the alpha channel (shown as a black channel).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Scale hue by</term>
+ <term>Scale value by</term>
+ <listitem>
+ <para>
+ When you have many fractals with different colors, the
+ colors blend into each other. So even if you set
+ <quote>pure red</quote> for a fractal, it might actually
+ be quite blue in some places, while another <quote>red
+ </quote> fractal might have a lot of yellow in it. Scale
+ Hue/Value changes the color strength of the active
+ fractal, or how influential that fractal color should be.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Other</title>
<varlistentry>
- <term>Relative Probability</term>
+ <term>Relative probability</term>
<listitem>
<para>
Determines influence or total impact of a certain fractal.
diff --git a/src/filters/render/jigsaw.xml b/src/filters/render/jigsaw.xml
index def6ee9..640f25f 100644
--- a/src/filters/render/jigsaw.xml
+++ b/src/filters/render/jigsaw.xml
@@ -92,8 +92,11 @@
</para>
</listitem>
</varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Bevel Edges</title>
<varlistentry>
- <term>Bevel Width</term>
+ <term>Bevel width</term>
<listitem>
<para>
The Bevel width slider controls the slope of the edges of
@@ -118,15 +121,20 @@
</para>
</listitem>
</varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Jigsaw Style</title>
+ <para>You can choose between two types of puzzle:</para>
<varlistentry>
- <term>Jigsaw Style</term>
+ <term>Square</term>
<listitem>
- <para>
- You can choose between two types of puzzle,
- <guilabel>Square</guilabel> then you get pieces made with
- straight lines, or <guilabel>Curved</guilabel> then you get
- pieces made with curves.
- </para>
+ <para>Then you get pieces made with straight lines.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Square</term>
+ <listitem>
+ <para>Then you get pieces made with curves.</para>
</listitem>
</varlistentry>
</variablelist>
diff --git a/src/filters/render/maze.xml b/src/filters/render/maze.xml
index df63082..d93467a 100644
--- a/src/filters/render/maze.xml
+++ b/src/filters/render/maze.xml
@@ -66,50 +66,51 @@
</mediaobject>
</figure>
<variablelist>
+ <title>Maze Size</title>
<varlistentry>
- <term>Width/Height</term>
+ <term>Width</term>
+ <term>Height</term>
<listitem>
<para>
- The <guilabel>Width</guilabel> and
- <guilabel>Height</guilabel> sliders control how many
- pathways the
- maze should have. The lower the values for width and height,
- the more paths you will get. The same happens if you
- increase the number of pieces in the Width and Height
- <guilabel>Pieces</guilabel> fields. The result won't
- really look like a maze unless the width and height are
+ These sliders control how many pathways the maze should have. The
+ lower the values for width and height, the more paths you will
+ get. The same happens if you increase the number of pieces in the
+ Width and Height <guilabel>Pieces</guilabel> fields. The result
+ won't really look like a maze unless the width and height are
equal.
</para>
</listitem>
</varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Algorithm</title>
<varlistentry>
- <term>Tileable</term>
+ <term>Seed</term>
<listitem>
<para>
- If you want to use it in a pattern, you can make the maze
- tileable by checking this check-button.
+ You can specify a seed for the random number generator, or
+ ask the program to generate one for you. Unless you need
+ to later reproduce exactly the same maze, you might as
+ well have the program do it.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Seed</term>
+ <term>Depth first</term>
+ <term>Prim's algorithm</term>
<listitem>
<para>
- You can specify a seed for the random number generator, or
- ask the program to generate one for you. Unless you need
- to later reproduce exactly the same maze, you might as
- well have the program do it.
+ You can choose between these two algorithms for maze. Only a
+ computer scientist can tell the difference between them.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Algorithm</term>
+ <term>Tileable</term>
<listitem>
<para>
- You can choose between two algorithms for maze,
- <guilabel>Depth First</guilabel> and
- <guilabel>Prim's Algorithm</guilabel>. Only a computer
- scientist can tell the difference between them.
+ If you want to use it in a pattern, you can make the maze
+ tileable by checking this check-button.
</para>
</listitem>
</varlistentry>
diff --git a/src/filters/render/plasma.xml b/src/filters/render/plasma.xml
index 512f489..3de7924 100644
--- a/src/filters/render/plasma.xml
+++ b/src/filters/render/plasma.xml
@@ -38,7 +38,10 @@
Sometimes the strong colors may be distracting, and a more
interesting surface will appear when you desaturate the image
using
- <guimenuitem>Layer/Colors/Desaturate</guimenuitem>.
+ <menuchoice>
+ <guimenu>Colors</guimenu>
+ <guimenuitem>Desaturate</guimenuitem>
+ </menuchoice>.
</para>
<note>
<para>
@@ -76,15 +79,23 @@
</figure>
<variablelist>
<varlistentry>
- <term>Random Seed</term>
+ <term>Preview</term>
+ <listitem>
+ <para>
+ If checked, parameter setting results are interactively displayed
+ in preview.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Random seed</term>
<listitem>
<para>
- <guilabel>Random Seed</guilabel> controls the randomization
- element. The <guibutton>Randomize</guibutton> check-button will
- set the seed using the hardware clock of the computer.
- There is no reason to use anything else unless you want to
- be able to repeat the exact same pattern of randomization
- on a later occasion.
+ This option controls the randomization element. The
+ <guibutton>Randomize</guibutton> check-button will set the seed
+ using the hardware clock of the computer. There is no reason to
+ use anything else unless you want to be able to repeat the exact
+ same pattern of randomization on a later occasion.
</para>
</listitem>
</varlistentry>
diff --git a/src/filters/render/qbist.xml b/src/filters/render/qbist.xml
index 2d5c40d..33a854a 100644
--- a/src/filters/render/qbist.xml
+++ b/src/filters/render/qbist.xml
@@ -94,7 +94,14 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Open/Save</term>
+ <term>Undo</term>
+ <listitem>
+ <para>Lets you go back one step in history.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Open</term>
+ <term>Save</term>
<listitem>
<para>
These buttons allow you to save and reload your textures. This is
diff --git a/src/filters/render/sinus.xml b/src/filters/render/sinus.xml
index cb3e3d2..087e9d7 100644
--- a/src/filters/render/sinus.xml
+++ b/src/filters/render/sinus.xml
@@ -58,152 +58,159 @@
<sect3>
<title>Options</title>
- <figure>
- <title><quote>Sinus</quote> filter options (Settings)</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/options-render-sinus1.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <variablelist>
- <varlistentry>
- <term>Settings tab</term>
- <listitem>
- <variablelist>
- <varlistentry>
- <term>X and Y Scales</term>
- <listitem>
- <para>
- A low X/Y value will maximize the horizontal/vertical
- stretch of the texture, whereas a high value will compress
- it.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Complexity</term>
- <listitem>
- <para>
- This controls how the two colors interact with each other
- (the amount of interplay or repetition).
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Random Seed</term>
- <listitem>
- <para>
- <guilabel>Random Seed</guilabel> controls the random
- behaviour of the filter. If the same random seed in the
- same situation is used, the filter produces exactly the
- same results. A different random seed produces different
- results. Random seed can be entered manually or generated
- randomly by pressing the <guibutton>New Seed</guibutton>
- button.
- </para>
- <para>
- When the <guilabel>Randomize</guilabel> option is checked,
- random seed cannot be entered manually, but is randomly
- generated each time the filter is run. If it is not
- checked, the filter remembers the last random seed used.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Force Tiling?</term>
- <listitem>
- <para>
- If you check this, you'll get a pattern that can be
- used for tiling. For example, you can use it as a
- background in an HTML page, and the tile edges will be
- joined seamlessly.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Ideal/Distorted</term>
- <listitem>
- <para>
- This option gives additional control of the interaction
- between the two colors. Distorted creates a more distorted
- interference between the two colors than Ideal.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Color settings</term>
- <listitem>
- <figure>
- <title><quote>Sinus</quote> filter options (Color)</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/options-render-sinus2.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <variablelist>
- <varlistentry>
- <term>Colors</term>
- <listitem>
- <para>
- Here, you set the two colors that make up your
- texture. You can use Black and white or the
- foreground/background colors in the toolbox, or you can
- choose a color with the color icons. The <parameter>Alpha
- Channels</parameter> sliders allow you to assign an
- opacity to each of the colors. (If the layer you are
- working on does not have an alpha channel, they will be
- grayed out.)
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Blend settings</term>
- <listitem>
- <figure>
- <title>Sinus filter options (Blend)</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/options-render-sinus3.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <variablelist>
- <varlistentry>
- <term>Gradient</term>
- <listitem>
- <para>
- You can choose between three functions to set the shapes
- of the waves that are produced: Linear, Bilinear and
- Sinusoidal.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Exponent</term>
- <listitem>
- <para>
- The Exponent controls which of the two colors is
- dominant, and how dominant it is. If you set
- the exponent to -7.5, the left color will dominate
- totally, and if you set it to +7.5 it will be the other
- way around. A zero value is neutral.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- </variablelist>
+
+ <sect4>
+ <title>Settings</title>
+ <figure>
+ <title><quote>Sinus</quote> filter options (Settings)</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-render-sinus1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <variablelist>
+ <title>Drawing Settings</title>
+ <varlistentry>
+ <term>X scale</term>
+ <term>Y scale</term>
+ <listitem>
+ <para>
+ A low X/Y value will maximize the horizontal/vertical
+ stretch of the texture, whereas a high value will compress
+ it.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Complexity</term>
+ <listitem>
+ <para>
+ This controls how the two colors interact with each other
+ (the amount of interplay or repetition).
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Calculation Settings</title>
+ <varlistentry>
+ <term>Random seed</term>
+ <listitem>
+ <para>
+ This option controls the random
+ behaviour of the filter. If the same random seed in the
+ same situation is used, the filter produces exactly the
+ same results. A different random seed produces different
+ results. Random seed can be entered manually or generated
+ randomly by pressing the <guibutton>New Seed</guibutton>
+ button.
+ </para>
+ <para>
+ When the <guilabel>Randomize</guilabel> option is checked,
+ random seed cannot be entered manually, but is randomly
+ generated each time the filter is run. If it is not
+ checked, the filter remembers the last random seed used.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Force tiling?</term>
+ <listitem>
+ <para>
+ If you check this, you'll get a pattern that can be
+ used for tiling. For example, you can use it as a
+ background in an HTML page, and the tile edges will be
+ joined seamlessly.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Ideal</term>
+ <term>Distorted</term>
+ <listitem>
+ <para>
+ This options give additional control of the interaction between
+ the two colors. <quote>Distorted</quote> creates a more
+ distorted interference between the two colors than
+ <quote>Ideal</quote>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4>
+ <title>Colors</title>
+ <figure>
+ <title><quote>Sinus</quote> filter options (Colors)</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-render-sinus2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <variablelist>
+ <varlistentry>
+ <term>Colors</term>
+ <listitem>
+ <para>
+ Here, you set the two colors that make up your texture. You can
+ use <guilabel>Black & white</guilabel> or the
+ <guilabel>Foreground & background</guilabel> colors in the
+ toolbox, or you can <guilabel>Choose</guilabel> a color with the
+ color icons.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Alpha Channels</term>
+ <listitem>
+ <para>
+ This sliders allow you to assign an opacity to each of the
+ colors. (If the layer you are working on does not have an alpha
+ channel, they will be grayed out.)
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4>
+ <title>Blend</title>
+ <figure>
+ <title><quote>Sinus</quote> filter options (Blend)</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-render-sinus3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <variablelist>
+ <varlistentry>
+ <term>Gradient</term>
+ <listitem>
+ <para>
+ You can choose between three functions to set the shapes of the
+ waves that are produced: Linear, Bilinear and Sinusoidal.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Exponent</term>
+ <listitem>
+ <para>
+ The Exponent controls which of the two colors is dominant, and
+ how dominant it is. If you set the exponent to -7.5, the left
+ color will dominate totally, and if you set it to +7.5 it will
+ be the other way around. A zero value is neutral.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
</sect3>
</sect2>
diff --git a/src/filters/render/solid_noise.xml b/src/filters/render/solid_noise.xml
index fe3fc76..955ec41 100644
--- a/src/filters/render/solid_noise.xml
+++ b/src/filters/render/solid_noise.xml
@@ -71,13 +71,22 @@
</figure>
<variablelist>
<varlistentry>
- <term>Random Seed</term>
+ <term>Preview</term>
<listitem>
<para>
- <guilabel>Random Seed</guilabel> controls random behaviour of the
- filter. If the same random seed in the same situation is used, the
- filter produces exactly the same results. A different random seed
- produces different results. Random seed can be entered manually or
+ If checked, parameter setting results are interactively displayed
+ in preview.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Random seed</term>
+ <listitem>
+ <para>
+ This option controls random behaviour of the filter. If the same
+ random seed in the same situation is used, the filter produces
+ exactly the same results. A different random seed produces
+ different results. Random seed can be entered manually or
generated randomly by pressing <guibutton>New Seed</guibutton>
button.
</para>
@@ -123,7 +132,8 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>X and Y Size</term>
+ <term>X size</term>
+ <term>Y size</term>
<listitem>
<para>
These control the size and proportion of the noise shapes
diff --git a/src/filters/render/spheredesigner.xml b/src/filters/render/spheredesigner.xml
index dec21ce..e59635e 100644
--- a/src/filters/render/spheredesigner.xml
+++ b/src/filters/render/spheredesigner.xml
@@ -10,6 +10,7 @@
-->
<sect2 id="plug-in-spheredesigner">
<title>Sphere Designer</title>
+
<indexterm>
<primary>Filters</primary>
<secondary>Render</secondary>
@@ -18,6 +19,7 @@
<indexterm>
<primary>Sphere Designer</primary>
</indexterm>
+
<sect3>
<title>Overview</title>
<figure>
@@ -73,6 +75,7 @@
</imageobject>
</mediaobject>
</figure>
+
<variablelist>
<varlistentry>
<term>Preview</term>
@@ -87,140 +90,80 @@
</para>
</listitem>
</varlistentry>
+ </variablelist>
+
+ <variablelist>
+ <title>Textures</title>
+ <para>
+ The list of textures applied to the sphere. There textures are applied
+ in the order listed. Each item shows the type and the name of the
+ texture.
+ </para>
<varlistentry>
- <term>Textures</term>
+ <term>New</term>
<listitem>
<para>
- The list of textures applied to the sphere. There textures are
- applied in the order listed. Each item shows the type and the
- name of the texture.
+ Creates a new texture and adds it to the end of the list. The name
+ and the features of this new texture are the ones which are
+ displayed in the Texture Properties area, but you can change them
+ by operating in this area, provided that your new texture is
+ highlighted.
</para>
- <variablelist>
- <varlistentry>
- <term>New</term>
- <listitem>
- <para>
- Creates a new texture and adds it to the end of the
- list. The name and the features of this new texture are
- the ones which are displayed in the Texture Properties
- area, but you can change them by operating in this area,
- provided that your new texture is highlighted.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Duplicate</term>
- <listitem>
- <para><guilabel>Duplicate</guilabel>: Copies the selected texture
- and adds the copy to the end of the list.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Delete</term>
- <listitem>
- <para>
- Deletes the selected texture from the list.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Open/Save</term>
- <listitem>
- <para>
- Allows to save current settings or load previously saved
- settings.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
</listitem>
</varlistentry>
<varlistentry>
- <term>Texture properties</term>
+ <term>Duplicate</term>
<listitem>
+ <para>
+ Copies the selected texture and adds the copy to the end of the
+ list.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Delete</term>
+ <listitem>
+ <para>
+ Deletes the selected texture from the list.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Open</term>
+ <term>Save</term>
+ <listitem>
+ <para>
+ Allows to save current settings or load previously saved settings.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ <variablelist>
+ <title>Properties</title>
+ <varlistentry>
+ <term>Type</term>
+ <listitem>
+ <para>Determines the type of action on the sphere.</para>
<variablelist>
<varlistentry>
- <term>Type</term>
- <listitem>
- <para>
- Determines the type of action on the sphere.
- <itemizedlist><listitem><para><guilabel>Texture</guilabel> covers the sphere with
- a specific pattern.
- </para></listitem><listitem><para><guilabel>Bumpmap</guilabel> gives some relief to
- the texture.
- </para></listitem><listitem><para><guilabel>Light</guilabel> lets you set the
- parameters of the light shining on the sphere.
- </para></listitem></itemizedlist>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
<term>Texture</term>
<listitem>
- <para>
- Determines the pattern used by the texture type. If the
- texture applies to light then the light is distorted by
- this texture as if it was going through this texture
- before falling onto the sphere. If the texture applies to
- the texture itself, the texture is applied directly to
- the sphere. The following options are available:
- <quote>Solid</quote>, <quote>Checker</quote>,
- <quote>Marble</quote>, <quote>Lizard</quote>,
- <quote>Phong</quote>, <quote>Noise</quote>,
- <quote>Wood</quote>, <quote>Spiral</quote> and
- <quote>Spots</quote>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Colors</term>
- <listitem>
- <para>
- Sets the two colors to be used for a texture. By pressing
- the color button a color selection dialog appears.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Scale</term>
- <listitem>
- <para>
- Determines the size of separate elements composing the
- texture. For example, for the <quote>Checker</quote>
- texture this parameter determines the size of black and
- white squares. Value range is from 0 to 10.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Turbulence</term>
- <listitem>
- <para>
- Determines the degree of texture distortion before
- applying the texture to the sphere. Value range is from 0
- to 10. With values of up to 1.0 you can still make out
- the undistorted patterns; beyond that the texture
- gradually turns into noise.
- </para>
+ <para>Covers the sphere with a specific pattern.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Amount</term>
+ <term>Bumpmap</term>
<listitem>
- <para>
- Determines the degree of influence the texture has on the
- final result. Value range is from 0 to 1. With the value
- of 0 the texture does not affect the result.
- </para>
+ <para>Gives some relief to the texture.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Exponent</term>
+ <term>Light</term>
<listitem>
<para>
- With the Wood texture, this options gives an aspect of
- venetian blind, more or less open.
+ Lets you set the parameters of the light shining on the
+ sphere.
</para>
</listitem>
</varlistentry>
@@ -228,50 +171,112 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Texture Transformations</term>
+ <term>Texture</term>
<listitem>
- <variablelist>
- <varlistentry>
- <term>Scale X/Y/Z</term>
- <listitem>
- <para>
- Determines the degree of stretching/compression of the
- texture on the sphere along the three directions. The
- value range is from 0 to 10.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Rotate X/Y/Z</term>
- <listitem>
- <para>
- Determines the amount of a turn of the texture on the
- sphere around the three axes. The value range is from 0
- to 360.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Position X/Y/Z</term>
- <listitem>
- <para>
- Determines the position of the texture relative to the
- sphere. When type is Light, this parameter refers to the
- position of the light floodlighting the sphere.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
+ <para>
+ Determines the pattern used by the texture type. If the texture
+ applies to light then the light is distorted by this texture as if
+ it was going through this texture before falling onto the sphere.
+ If the texture applies to the texture itself, the texture is
+ applied directly to the sphere. Several options are available.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Reset</term>
+ <term>Colors</term>
<listitem>
<para>
- Sets all parameters to the default values.
+ Sets the two colors to be used for a texture. By pressing the
+ color button a color selection dialog appears.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Scale</term>
+ <listitem>
+ <para>
+ Determines the size of separate elements composing the texture.
+ For example, for the <quote>Checker</quote> texture this parameter
+ determines the size of black and white squares. Value range is
+ from 0 to 10.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Turbulence</term>
+ <listitem>
+ <para>
+ Determines the degree of texture distortion before applying the
+ texture to the sphere. Value range is from 0 to 10. With values of
+ up to 1.0 you can still make out the undistorted patterns; beyond
+ that the texture gradually turns into noise.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Amount</term>
+ <listitem>
+ <para>
+ Determines the degree of influence the texture has on the final
+ result. Value range is from 0 to 1. With the value of 0 the
+ texture does not affect the result.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <!--Exp.-->
+ <term>Exponent</term>
+ <listitem>
+ <para>
+ With the Wood texture, this options gives an aspect of venetian
+ blind, more or less open.
</para>
</listitem>
</varlistentry>
</variablelist>
+
+ <variablelist>
+ <title>Transformations</title>
+ <varlistentry>
+ <term>Scale X</term>
+ <term>Scale Y</term>
+ <term>Scale Z</term>
+ <listitem>
+ <para>
+ Determines the degree of stretching/compression of the texture on
+ the sphere along the three directions. The value range is from 0
+ to 10.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Rotate X</term>
+ <term>Rotate Y</term>
+ <term>Rotate Z</term>
+ <listitem>
+ <para>
+ Determines the amount of a turn of the texture on the sphere
+ around the three axes. The value range is from 0 to 360.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Position X</term>
+ <term>Position Y</term>
+ <term>Position Z</term>
+ <listitem>
+ <para>
+ Determines the position of the texture relative to the sphere.
+ When type is Light, this parameter refers to the position of the
+ light floodlighting the sphere.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ <para>
+ The <guibutton>Reset</guibutton> button sets all parameters to the
+ default values.
+ </para>
</sect3>
</sect2>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
