[gimp-help-2] Formal changes to GIMPressionist docs
- From: Ulf-D. Ehlert <ulfehlert src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Formal changes to GIMPressionist docs
- Date: Sat, 8 May 2010 10:55:46 +0000 (UTC)
commit 6536d964ad264a90d954c79d7466eacd66b06233
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date: Fri May 7 21:26:37 2010 +0200
Formal changes to GIMPressionist docs
Change Orientation Map Editor and Size Map Editor to be subsection of
GIMPressionist; enhance DocBook compliance; correct some option names.
src/filters/artistic.xml | 4 +-
src/filters/artistic/GIMPressionist-orientmap.xml | 40 +-
src/filters/artistic/GIMPressionist-sizemap.xml | 38 +-
src/filters/artistic/GIMPressionist.xml | 1370 +++++++++++----------
4 files changed, 768 insertions(+), 684 deletions(-)
---
diff --git a/src/filters/artistic.xml b/src/filters/artistic.xml
index 9473a31..4c7d2c9 100644
--- a/src/filters/artistic.xml
+++ b/src/filters/artistic.xml
@@ -2,6 +2,7 @@
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
+ 2010-05-07 ude: let GIMPressionist include orientation & size map editor
2007-08-08 ude: moved Van Gogh (LIC) from map filters
2007-04-28 KoSt: added 'no'
2005-09-03 de added by axel.wernicke
@@ -14,9 +15,6 @@
<xi:include href="artistic/clothify.xml"/>
<xi:include href="artistic/cubism.xml"/>
<xi:include href="artistic/GIMPressionist.xml"/>
- <!-- TODO: check: shouldn't GIMPressionist include orientmap & sizemap? -->
- <xi:include href="artistic/GIMPressionist-orientmap.xml"/>
- <xi:include href="artistic/GIMPressionist-sizemap.xml"/>
<xi:include href="artistic/oilify.xml"/>
<xi:include href="artistic/photocopy.xml"/>
<xi:include href="artistic/predator.xml"/>
diff --git a/src/filters/artistic/GIMPressionist-orientmap.xml b/src/filters/artistic/GIMPressionist-orientmap.xml
index 1692051..a249630 100644
--- a/src/filters/artistic/GIMPressionist-orientmap.xml
+++ b/src/filters/artistic/GIMPressionist-orientmap.xml
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+<!DOCTYPE sect3 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
2007-06-26 Added Spanish translation by AntI
@@ -10,8 +10,8 @@
2005-09-15 de added by axel.wernicke
2005-11-07 small add in Overview by julien hardelin
-->
-<sect2 id="gimpressionist-orient-map-editor">
- <title>GIMPressionist - Orientation Map Editor</title>
+<sect3 id="gimpressionist-orient-map-editor">
+ <title>Orientation Map Editor</title>
<indexterm>
<primary>Filters</primary>
@@ -22,19 +22,22 @@
<primary>GIMPressionist</primary>
</indexterm>
- <sect3>
+ <sect4>
<title>Overview</title>
<para>
The Orientation-map editor is an annexe of the
<link linkend="plug-in-gimpressionist">GIMPressionist</link> filter. You
- can get to it by clicking on the <guibutton>Edit</guibutton> button
- in the <quote>Orientation</quote> tab. With this editor, you can set
- the direction that brush strokes given by filter will have.
+ can get to it by clicking on the <guibutton>Edit</guibutton> button in
+ the
+ <link linkend="gimpressionist-orientation-options">Orientation</link>
+ tab. With this editor, you can set the direction that brush strokes
+ given by filter will have.
</para>
- </sect3>
+ </sect4>
- <sect3>
- <title>Parameter Settings</title>
+ <sect4>
+ <!-- Parameter Settings -->
+ <title>Options</title>
<figure>
<title>
Options of the <quote>Orientation-map Editor</quote> dialog
@@ -125,7 +128,7 @@
</para>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry id="gimpressionist-editor-voronoi">
<term>Voronoi</term>
<listitem>
<indexterm>
@@ -160,10 +163,11 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Angle Offset</term>
+ <term>Angle offset</term>
<listitem>
<para>
- This slider allows you to change the angle of ALL vectors.
+ This slider allows you to change the angle of
+ <emphasis>all</emphasis> vectors.
</para>
</listitem>
</varlistentry>
@@ -178,14 +182,14 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Strength Exp.</term>
+ <term>Strength exp.</term>
<listitem>
<para>
- This slider acts on the length of ALL vectors, and so changes
- the strength of all brush strokes.
+ This slider acts on the length of <emphasis>all</emphasis>
+ vectors, and so changes the strength of all brush strokes.
</para>
</listitem>
</varlistentry>
</variablelist>
- </sect3>
-</sect2>
+ </sect4>
+</sect3>
diff --git a/src/filters/artistic/GIMPressionist-sizemap.xml b/src/filters/artistic/GIMPressionist-sizemap.xml
index 517723a..9829718 100644
--- a/src/filters/artistic/GIMPressionist-sizemap.xml
+++ b/src/filters/artistic/GIMPressionist-sizemap.xml
@@ -1,16 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+<!DOCTYPE sect3 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
2007-06-26 Added Spanish translation by AntI
2007-05-02 KoSt: added 'no'
2007-01-18 it added by alessandro falappa
2005-12-07 replaced <simplesect> by <sect3> by lexa
- 050915 de added by axel.wernicke
- 051107 small add in Overview by julien hardelin
+ 2005-09-15 de added by axel.wernicke
+ 2005-11-07 small add in Overview by julien hardelin
-->
-<sect2 id="gimpressionist-size-map-editor">
- <title>GIMPressionist - Size Map Editor</title>
+<sect3 id="gimpressionist-size-map-editor">
+ <title>Size Map Editor</title>
<indexterm>
<primary>Filters</primary>
@@ -21,19 +21,21 @@
<primary>GIMPressionist</primary>
</indexterm>
- <sect3>
+ <sect4>
<title>Overview</title>
<para>
The Size-map editor is an annexe of the
- <link linkend="plug-in-gimpressionist">GIMPressionist</link>
- filter. You can get to it by clicking on the <guibutton>Edit</guibutton>
- button in the <quote>Size</quote> tab. With this editor, you can set the
- size that brush strokes given by filter will have.
+ <link linkend="plug-in-gimpressionist">GIMPressionist</link> filter. You
+ can get to it by clicking on the <guibutton>Edit</guibutton> button in
+ the <link linkend="gimpressionist-size-options">Size</link> tab. With
+ this editor, you can set the size that brush strokes given by filter
+ will have.
</para>
- </sect3>
+ </sect4>
- <sect3>
- <title>Parameter Settings</title>
+ <sect4>
+ <!-- Parameter Settings -->
+ <title>Options</title>
<figure>
<title>Size-map editor options</title>
<mediaobject>
@@ -116,7 +118,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Strength Exp.</term>
+ <term>Strength exp.</term>
<listitem>
<para>Change the exponent of the stroke.</para>
</listitem>
@@ -125,11 +127,11 @@
<term>Voronoi</term>
<listitem>
<para>
- See <link linkend="gimpressionist-orient-map-editor">
- Orientation Map Editor</link> for an explanation.
+ See <link linkend="gimpressionist-editor-voronoi">Orientation Map
+ Editor</link> for an explanation.
</para>
</listitem>
</varlistentry>
</variablelist>
- </sect3>
-</sect2>
+ </sect4>
+</sect3>
diff --git a/src/filters/artistic/GIMPressionist.xml b/src/filters/artistic/GIMPressionist.xml
index 7a759af..709f492 100644
--- a/src/filters/artistic/GIMPressionist.xml
+++ b/src/filters/artistic/GIMPressionist.xml
@@ -1,16 +1,16 @@
<?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";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
2007-06-27 Added Spanish translation by AntI
2007-04-30 KoSt: added 'no'
2007-01-18 it added by alessandro falappa
2005-12-07 replaced <simplesect> by <sect3> by lexa
- 050912 de added by axel.wernicke
+ 2005-09-12 de added by axel.wernicke
-->
-<sect2 id="plug-in-gimpressionist">
- <title>
- GIMPressionist
- </title>
+<sect2 id="plug-in-gimpressionist" xmlns:xi="http://www.w3.org/2001/XInclude";>
+ <title>GIMPressionist</title>
+
<indexterm>
<primary>Filters</primary>
<secondary>Artistic</secondary>
@@ -21,16 +21,13 @@
</indexterm>
<sect3>
- <title>
- Overview
- </title>
+ <title>Overview</title>
<figure>
- <title>
- Example for the <quote>GIMPressionist</quote> filter
- </title>
+ <title>Example for the <quote>GIMPressionist</quote> filter</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/taj_orig.jpg" format="JPG"/>
+ <imagedata format="JPG"
+ fileref="images/filters/examples/taj_orig.jpg"/>
</imageobject>
<caption>
<para>Original image</para>
@@ -38,7 +35,8 @@
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/artistic-taj-gimpressionist.jpg" format="JPG"/>
+ <imagedata format="JPG"
+ fileref="images/filters/examples/artistic-taj-gimpressionist.jpg"/>
</imageobject>
<caption>
<para>Filter <quote>GIMPressionist</quote> applied</para>
@@ -46,16 +44,17 @@
</mediaobject>
</figure>
<para>
- It's the king of Artistic filters. It can do what Cubism and Apply
- Canvas do and much more. It gives your image the look of a painting.
- All is going as if your image was painted again on a paper and with a
- brush you'd have chosen. It works on the active layer or selection.
+ The GIMPressionist filter is the king of Artistic filters. It can do
+ what <link linkend="plug-in-cubism">Cubism</link> and
+ <link linkend="plug-in-apply-canvas">Apply Canvas</link> do and much
+ more. It gives your image the look of a painting. All is going as if
+ your image was painted again on a paper and with a brush you'd have
+ chosen. It works on the active layer or selection.
</para>
</sect3>
+
<sect3>
- <title>
- Activating the filter
- </title>
+ <title>Activating the filter</title>
<para>
You can find this filter via the image menu through
<menuchoice>
@@ -67,629 +66,710 @@
</sect3>
<sect3>
- <title>
- Parameter Settings
- </title>
- <variablelist>
- <varlistentry>
- <term>Preview</term>
- <listitem>
- <para>
- All your setting changes will appear in the Preview without
- affecting the image until you click on <guibutton>OK</guibutton>.
- The <guibutton>Update</guibutton> button refreshes the preview
- window (it is not automatic, Gimpressionist has so much work
- to do!), and the <guibutton>Reset</guibutton> button reverts to
- the original image.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Presets</term>
- <listitem>
- <figure>
- <title>
- <quote>Presets</quote> tab options
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/filters/options-artistic-gimpressionist1.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- GIMPressionist has a lot of parameters. When combined, they
- give an astronomical number of possibilities. So, it is important,
- when an interesting preset has been found, to save it and also to
- send it to the plugin author if exceptional. Per contra, the
- intricacy of all these parameters makes difficult understanding
- and foreseeing how each one works.
- </para>
- <itemizedlist>
- <listitem>
- <para><guilabel>Save Current</guilabel>: Save current parameters.
- You can give a name in the input box on the left and a short
- description in the dialog that appear.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Apply</guilabel>: Load the parameters of the
- selected preset in the list.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Delete</guilabel>: Delete the selected preset. You
- can delete only the presets you have created.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Refresh</guilabel>: Update the preset list.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Paper tab</term>
- <listitem>
- <figure>
- <title>
- <quote>Paper</quote> tab options
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/filters/options-artistic-gimpressionist2.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- This tab concerns the texture of the canvas your image will be
- painted on. You have a list of textures and a
- <guilabel>Preview</guilabel> for the selected texture. A
- description is displayed on the right for every texture when
- selected.
- </para>
- <variablelist>
- <varlistentry>
- <term>Invert</term>
- <listitem>
- <para>
- Inverts the paper texture: what was a hollow turns to a bump
- and vice-versa.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Overlay</term>
- <listitem>
- <para>
- Apply the paper as it, without embossing it. It looks like
- if a transparent paper has been overlayed on the image.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Scale</term>
- <listitem>
- <para>
- Specifies the scale of the texture (in % of the original
- file): controls the graininess of the texture.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Relief</term>
- <listitem>
- <para>
- Specifies the amount of embossing to apply (3-150).
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Brush tab</term>
- <listitem>
- <figure>
- <title>
- <quote>Brush</quote> tab options
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/filters/options-artistic-gimpressionist3.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- <quote>Brush</quote> is a general term for any material used to
- paint. A list of brushes is available with a
- <guilabel>Preview</guilabel> for the selected one.
- </para>
- <variablelist>
- <varlistentry>
- <term>Gamma</term>
- <listitem>
- <para>
- Changes the gamma (luminosity) of the selected brush. The
- gamma correction brightens or darkens midtones.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Select</term>
- <listitem>
- <para>
- You can also use a brush pattern you have created by
- selecting its image (arrow button on the Select line). This
- image must be on your screen before you launch the filter to
- be taken in account. Of course, don't use big images.
- </para>
- <para>
- If your image has several layers, they also will be
- displayed in the Select list and can be used as a brush.
- When selected, the layer appears in the brush preview and
- the normal brush is deselected.
- </para>
- <para>
- The <guibutton>Save as</guibutton>
- button allows you to save the selected brush.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Aspect ratio</term>
- <listitem>
- <para>
- Specifies the brush proportions, height (0 -1) and width (0
- +1).
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Relief</term>
- <listitem>
- <para>
- Specifies the amount of paint used for each stroke. This may
- evoke painting with a palette knife.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Orientation tab</term>
- <listitem>
- <figure>
- <title>
- <quote>Orientation</quote> tab options
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/filters/options-artistic-gimpressionist4.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- This tab allows to set the orientation of the brush strokes. A
- painter is not obliged to go over with the same paintbrush angle.
- To perform some effects, he can vary their orientation.
- </para>
- <variablelist>
- <varlistentry>
- <term>Directions</term>
- <listitem>
- <para>
- With this option, you can set how many times the brush will
- pass through a same place, with each time a different
- direction, resulting in a more and more thick paint.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Start Angle</term>
- <listitem>
- <para>
- Specifies the general direction of the strokes, the angle
- that the angle range will start from. Directions are often
- chosen to give some movement to the image.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Angle Span</term>
- <listitem>
- <para>
- Specifies the angle, the sector, of the stroke "fan".
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Orientation</term>
- <listitem>
- <para>
- Specifies the direction of the brush strokes.
- </para>
- <itemizedlist>
- <listitem>
- <para><guilabel>Value</guilabel>
- : Let the Value (luminosity) of the region determine the
- direction of the stroke.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Radius</guilabel>
- : The distance from the center of the image determines
- the direction of the stroke.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Random</guilabel>
- : Select a random direction for each stroke.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Radial</guilabel>
- : Let the direction from the center determine the
- direction of the stroke.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Flowing</guilabel>
- : Not a direction question here: the strokes follow a
- "flowing" pattern.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Hue</guilabel>
- : Let the hue of the region determine the direction of
- the stroke.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Adaptive</guilabel>
- : The brush direction that matches the original image
- the closest is selected.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Manual</guilabel>
- : The <guilabel>Edit</guilabel> button opens the
- <link linkend="gimpressionist-orient-map-editor">
- Edit orientation Map dialog
- </link>
- that allows you to set the directions manually.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Size tab</term>
- <listitem>
- <figure>
- <title>
- <quote>Size</quote> tab options
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/filters/options-artistic-gimpressionist5.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- This tab allows you to set the number of brush sizes that will be
- used to paint, the limits of variation of these sizes and the
- criterion used to determine them.
- </para>
- <variablelist>
- <varlistentry>
- <term>Three Sliders</term>
- <listitem>
- <para>
- You can specify how many brush sizes are to be used and
- their sizes.
- </para>
- <itemizedlist>
- <listitem>
- <para><guilabel>Sizes</guilabel>: The number of brush
- sizes to use.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Minimum Size</guilabel> and
- <guilabel>Maximum Size </guilabel>: The brush sizes are
- between these two values. Greater the size, greater the
- length and width of strokes.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Sizes</term>
- <listitem>
- <para>
- You have there options to specify how the size of strokes
- will be determined.
- </para>
- <itemizedlist>
- <listitem>
- <para><guilabel>Value</guilabel>: Let the Value (luminosity)
- of the region determine the size of the stroke.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Radius</guilabel> : The distance from the
- center of the image determines the size of the stroke.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Random</guilabel> : Select a random size for
- each stroke.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Radial</guilabel> : Let the direction
- from the center determine the size of the stroke.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Flowing</guilabel> : Not a length question
- here: the strokes follow a <quote>flowing</quote> pattern.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Hue</guilabel> : Let the hue of
- the region determine the size of the stroke.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Adaptive</guilabel> : The brush size that
- matches the original image the closest is selected.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Manual</guilabel> : The
- <guilabel>Edit</guilabel> button opens the
- <link linkend="gimpressionist-size-map-editor">Size Map
- Editor</link>. That allows you to specify the size of
- strokes by yourself.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Placement tab</term>
- <listitem>
- <figure>
- <title>
- <quote>Placement</quote> tab options
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/filters/options-artistic-gimpressionist6.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- In this tab you can set how strokes will be distributed.
- </para>
- <variablelist>
- <varlistentry>
- <term>Placement</term>
- <listitem>
- <para>
- In the preview of the Orientation Map Editor, all small
- arrows look like a flow around objects. Inside this flow,
- strokes may be placed in two different ways:
- </para>
- <itemizedlist>
- <listitem>
- <para><guilabel>Randomly</guilabel>: Places strokes randomly.
- This produces a more realistic paint.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Evenly</guilabel>: Strokes are evenly
- distributed across the image.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Stroke Density</term>
- <listitem>
- <para>
- The greater the density the closer the strokes. With a low
- density, the paper or background may be visible in unstroke
- areas.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Centerize</term>
- <listitem>
- <para>Focus brush strokes around center.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Color tab</term>
- <listitem>
- <figure>
- <title>
- <quote>Color</quote> tab options
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/filters/options-artistic-gimpressionist7.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- In this tab, you can set what the stroke color will be.
- </para>
- <variablelist>
- <varlistentry>
- <term>Color</term>
- <listitem>
- <para>
- You can set the stroke color in two ways:
- </para>
- <itemizedlist>
- <listitem>
- <para><guilabel>Average under brush</guilabel>: Stroke color
- is computed from the the average of all pixels under
- the brush.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Center of brush</guilabel>: Samples the
- color from the pixel in the center of the brush.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Color Noise</term>
- <listitem>
- <para>
- This slider, and its input box, allow you to introduce noise
- in the stroke color, that will look less homogeneous.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>General tab</term>
- <listitem>
- <figure>
- <title>
- <quote>General</quote> tab options
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/filters/options-artistic-gimpressionist8.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- In this tab you can set what will be the background and the relief
- of brush strokes.
- </para>
- <variablelist>
- <varlistentry>
- <term>Background</term>
- <listitem>
- <itemizedlist>
- <listitem>
- <para><guilabel>Keep Original</guilabel>: The original image
- will be used as a background.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>From Paper</guilabel>: Copy the texture of
- the selected paper as a background.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Solid</guilabel>: By clicking on the color
- dwell you can select a solid colored background.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Transparent</guilabel>: Use a transparent
- background. Only the painted strokes will be visible.
- This option is available only if your image has an
- Alpha channel.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Paint Edges</term>
- <listitem>
- <para>
- If it is disabled, a thin border will not be painted around
- the outside border of the image.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Tileable</term>
- <listitem>
- <para>
- If checked, the resulting image will be seamlessly tileable.
- The right side will match the left side and the top will
- match the bottom. This is interesting if your image will be
- repeatedly used in a Web background.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Drop Shadow</term>
- <listitem>
- <para>
- Add a shadow effect to each brush stroke.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Edge Darken</term>
- <listitem>
- <para>
- How much to darken the edges of each brush stroke. This
- increases paint relief or thickness.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Shadow Darken</term>
- <listitem>
- <para>How much to darken the brush shadow.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Shadow Depth</term>
- <listitem>
- <para>
- How far apart from the object the drop shadow should be.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Shadow Blur</term>
- <listitem>
- <para>How much to blur the drop shadow.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Deviation Threshold</term>
- <listitem>
- <para>
- A bail-out value for adaptive selections of brush size.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- </variablelist>
+ <!-- Parameter Settings -->
+ <title>Options</title>
+
+ <para>
+ The dialog window consists of a small Preview area on the left, which is
+ always visible, and a huge amount of GIMPressionist options organized in
+ tabs.
+ </para>
+
+ <sect4>
+ <title>Preview</title>
+ <para>
+ All your setting changes will appear in the Preview without affecting
+ the image until you click on <guibutton>OK</guibutton>. The
+ <guibutton>Update</guibutton> button refreshes the preview window (it
+ is not automatic, GIMPressionist has so much work to do!), and the
+ <guibutton>Reset</guibutton> button reverts to the original image.
+ </para>
+ </sect4>
+
+ <sect4>
+ <title>Presets tab</title>
+ <figure>
+ <title><quote>Presets</quote> tab options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-artistic-gimpressionist1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ GIMPressionist has a lot of parameters. When combined, they
+ give an astronomical number of possibilities. So, it is important,
+ when an interesting preset has been found, to save it and also to
+ send it to the plugin author if exceptional. Per contra, the
+ intricacy of all these parameters makes difficult understanding
+ and foreseeing how each one works.
+ </para>
+ <variablelist>
+ <title>Presets options</title>
+ <varlistentry>
+ <term>Save Current</term>
+ <listitem>
+ <para>
+ Save current parameters.
+ You can give a name in the input box on the left and a short
+ description in the dialog that appear.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Apply</term>
+ <listitem>
+ <para>
+ Load the parameters of the selected preset in the list.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Delete</term>
+ <listitem>
+ <para>
+ Delete the selected preset. You can delete only the presets you
+ have created.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Refresh</term>
+ <listitem>
+ <para>Update the preset list.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4>
+ <title>Paper tab</title>
+ <figure>
+ <title><quote>Paper</quote> tab options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-artistic-gimpressionist2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ This tab concerns the texture of the canvas your image will be painted
+ on. You have a list of textures and a <guilabel>Preview</guilabel> for
+ the selected texture. A description is displayed on the right for
+ every texture when selected.
+ </para>
+ <variablelist>
+ <title>Paper options</title>
+ <varlistentry>
+ <term>Invert</term>
+ <listitem>
+ <para>
+ Inverts the paper texture: what was a hollow turns to a bump
+ and vice-versa.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Overlay</term>
+ <listitem>
+ <para>
+ Apply the paper as it, without embossing it. It looks like
+ if a transparent paper has been overlayed on the image.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Scale</term>
+ <listitem>
+ <para>
+ Specifies the scale of the texture (in % of the original
+ file): controls the graininess of the texture.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Relief</term>
+ <listitem>
+ <para>
+ Specifies the amount of embossing to apply (3-150).
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4>
+ <title>Brush tab</title>
+ <figure>
+ <title><quote>Brush</quote> tab options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-artistic-gimpressionist3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ <quote>Brush</quote> is a general term for any material used to paint.
+ A list of brushes is available with a <guilabel>Preview</guilabel> for
+ the selected one.
+ </para>
+ <variablelist>
+ <title>Brush options</title>
+ <varlistentry>
+ <term>Gamma</term>
+ <listitem>
+ <para>
+ Changes the gamma (luminosity) of the selected brush. The
+ gamma correction brightens or darkens midtones.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Select</term>
+ <listitem>
+ <para>
+ You can also use a brush pattern you have created by
+ selecting its image (arrow button on the Select line). This
+ image must be on your screen before you launch the filter to
+ be taken in account. Of course, don't use big images.
+ </para>
+ <para>
+ If your image has several layers, they also will be
+ displayed in the Select list and can be used as a brush.
+ When selected, the layer appears in the brush preview and
+ the normal brush is deselected.
+ </para>
+ <para>
+ The <guibutton>Save as</guibutton>
+ button allows you to save the selected brush.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Aspect ratio</term>
+ <listitem>
+ <para>
+ Specifies the brush proportions, height (0 -1) and width (0
+ +1).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Relief</term>
+ <listitem>
+ <para>
+ Specifies the amount of paint used for each stroke. This may
+ evoke painting with a palette knife.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4 id="gimpressionist-orientation-options">
+ <title>Orientation tab</title>
+ <figure>
+ <title><quote>Orientation</quote> tab options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-artistic-gimpressionist4.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ This tab allows to set the orientation of the brush strokes. A painter
+ is not obliged to go over with the same paintbrush angle. To perform
+ some effects, he can vary their orientation.
+ </para>
+ <variablelist>
+ <title>Orientation options</title>
+ <varlistentry>
+ <term>Directions</term>
+ <listitem>
+ <para>
+ With this option, you can set how many times the brush will pass
+ through a same place, with each time a different direction,
+ resulting in a more and more thick paint.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Start angle</term>
+ <listitem>
+ <para>
+ Specifies the general direction of the strokes, the angle that
+ the angle range will start from. Directions are often chosen to
+ give some movement to the image.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Angle span</term>
+ <listitem>
+ <para>
+ Specifies the angle, the sector, of the stroke <quote>fan</quote>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Orientation</term>
+ <listitem>
+ <para>Specifies the direction of the brush strokes.</para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Value</guilabel></term>
+ <listitem>
+ <para>
+ Let the value (luminosity) of the region determine the
+ direction of the stroke.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Radius</guilabel></term>
+ <listitem>
+ <para>
+ The distance from the center of the image determines
+ the direction of the stroke.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Random</guilabel></term>
+ <listitem>
+ <para>Select a random direction for each stroke.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Radial</guilabel></term>
+ <listitem>
+ <para>
+ Let the direction from the center determine the direction
+ of the stroke.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Flowing</guilabel></term>
+ <listitem>
+ <para>
+ Not a direction question here: the strokes follow a
+ <quote>flowing</quote> pattern.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Hue</guilabel></term>
+ <listitem>
+ <para>
+ Let the hue of the region determine the direction of the
+ stroke.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Adaptive</guilabel></term>
+ <listitem>
+ <para>
+ The brush direction that matches the original image the
+ closest is selected.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Manual</guilabel></term>
+ <listitem>
+ <para>
+ The <guilabel>Edit</guilabel> button opens the
+ <link linkend="gimpressionist-orient-map-editor">Edit
+ orientation Map dialog</link> that allows you to set the
+ directions manually.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist> <!--end of "brush stroke Orientation"-->
+ </listitem>
+ </varlistentry>
+ </variablelist> <!--end of "Orientation options"-->
+ </sect4>
+
+ <sect4 id="gimpressionist-size-options">
+ <title>Size tab</title>
+ <figure>
+ <title><quote>Size</quote> tab options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-artistic-gimpressionist5.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ This tab allows you to set the number of brush sizes that will be used
+ to paint, the limits of variation of these sizes and the criterion
+ used to determine them.
+ </para>
+ <variablelist>
+ <title>Size options</title>
+ <para>
+ You can specify how many brush sizes are to be used and their sizes.
+ </para>
+ <varlistentry>
+ <term>Sizes</term>
+ <listitem>
+ <para>The number of brush sizes to use.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Minimum Size</term>
+ <term>Maximum Size</term>
+ <listitem>
+ <para>
+ The brush sizes are between these two values. The greater the
+ size, the greater the length and width of strokes.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Sizes</term>
+ <listitem>
+ <para>
+ You have there options to specify how the size of strokes
+ will be determined.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Value</guilabel></term>
+ <listitem>
+ <para>
+ Let the value (luminosity) of the region determine the
+ size of the stroke.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Radius</guilabel></term>
+ <listitem>
+ <para>
+ The distance from the center of the image determines the
+ size of the stroke.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Random</guilabel></term>
+ <listitem>
+ <para>Select a random size for each stroke.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Radial</guilabel></term>
+ <listitem>
+ <para>
+ Let the direction from the center determine the size of
+ the stroke.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Flowing</guilabel></term>
+ <listitem>
+ <para>
+ Not a length question here: the strokes follow a
+ <quote>flowing</quote> pattern.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Hue</guilabel></term>
+ <listitem>
+ <para>
+ Let the hue of the region determine the size of the
+ stroke.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Adaptive</guilabel></term>
+ <listitem>
+ <para>
+ The brush size that matches the original image the closest
+ is selected.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Manual</guilabel></term>
+ <listitem>
+ <para>
+ The <guilabel>Edit</guilabel> button opens the
+ <link linkend="gimpressionist-size-map-editor">Size Map
+ Editor</link>. That allows you to specify the size of
+ strokes by yourself.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist> <!--end of "brush stroke Size"-->
+ </listitem>
+ </varlistentry>
+ </variablelist> <!--end of "Size options"-->
+ </sect4>
+
+ <sect4>
+ <title>Placement tab</title>
+ <figure>
+ <title><quote>Placement</quote> tab options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-artistic-gimpressionist6.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ In this tab you can set how strokes will be distributed.
+ </para>
+ <variablelist>
+ <title>Placement options</title>
+ <varlistentry>
+ <term>Placement</term>
+ <listitem>
+ <para>
+ In the preview of the Orientation Map Editor, all small
+ arrows look like a flow around objects. Inside this flow,
+ strokes may be placed in two different ways:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Randomly</guilabel></term>
+ <listitem>
+ <para>
+ Places strokes randomly. This produces a more realistic
+ paint.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Evenly distributed</guilabel></term>
+ <listitem>
+ <para>
+ Strokes are evenly distributed across the image.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Stroke density</term>
+ <listitem>
+ <para>
+ The greater the density the closer the strokes. With a low
+ density, the paper or background may be visible in unstroke
+ areas.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Centered</term>
+ <listitem>
+ <para>Focus brush strokes around center.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4>
+ <title>Color tab</title>
+ <figure>
+ <title><quote>Color</quote> tab options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-artistic-gimpressionist7.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ In this tab, you can set what the stroke color will be.
+ </para>
+ <variablelist>
+ <title>Color options</title>
+ <varlistentry>
+ <term>Color</term>
+ <listitem>
+ <para>
+ You can set the stroke color in two ways:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Average under brush</guilabel></term>
+ <listitem>
+ <para>
+ Stroke color is computed from the the average of all
+ pixels under the brush.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Center of brush</guilabel></term>
+ <listitem>
+ <para>
+ Samples the color from the pixel in the center of the
+ brush.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Color noise</term>
+ <listitem>
+ <para>
+ This slider, and its input box, allow you to introduce noise
+ in the stroke color, that will look less homogeneous.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4>
+ <title>General tab</title>
+ <figure>
+ <title><quote>General</quote> tab options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/options-artistic-gimpressionist8.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ In this tab you can set what will be the background and the relief
+ of brush strokes.
+ </para>
+ <variablelist>
+ <title>General options</title>
+ <varlistentry>
+ <term>Background</term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Keep original</guilabel></term>
+ <listitem>
+ <para>
+ The original image will be used as a background.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>From paper</guilabel></term>
+ <listitem>
+ <para>
+ Copy the texture of the selected paper as a background.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Solid</guilabel></term>
+ <listitem>
+ <para>
+ By clicking on the color dwell you can select a solid
+ colored background.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Transparent</guilabel></term>
+ <listitem>
+ <para>
+ Use a transparent background. Only the painted strokes
+ will be visible. This option is available only if your
+ image has an alpha channel.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Paint edges</term>
+ <listitem>
+ <para>
+ If it is disabled, a thin border will not be painted around
+ the outside border of the image.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Tileable</term>
+ <listitem>
+ <para>
+ If checked, the resulting image will be seamlessly tileable.
+ The right side will match the left side and the top will
+ match the bottom. This is interesting if your image will be
+ repeatedly used in a Web background.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Drop shadow</term>
+ <listitem>
+ <para>Add a shadow effect to each brush stroke.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Edge darken</term>
+ <listitem>
+ <para>
+ How much to darken the edges of each brush stroke. This
+ increases paint relief or thickness.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Shadow darken</term>
+ <listitem>
+ <para>How much to darken the brush shadow.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Shadow depth</term>
+ <listitem>
+ <para>
+ How far apart from the object the drop shadow should be.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Shadow blur</term>
+ <listitem>
+ <para>How much to blur the drop shadow.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Deviation threshold</term>
+ <listitem>
+ <para>
+ A bail-out value for adaptive selections of brush size.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
</sect3>
+
+ <!-- GIMPressionist Orientation Map Editor
+ (id=gimpressionist-orientation-map-editor) -->
+ <xi:include href="GIMPressionist-orientmap.xml"/>
+
+ <!-- GIMPressionist Size Map Editor (id=gimpressionist-size-map-editor) -->
+ <xi:include href="GIMPressionist-sizemap.xml"/>
+
</sect2>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
