[gimp-help-2] Added some changes in helps on dynamics



commit 2697bd4acf6699e97bcde7468f3511ed302b8672
Author: kolbjoern <kolbjoern git gnome org>
Date:   Sat Nov 24 19:20:09 2012 +0100

    Added some changes in helps on dynamics

 images/C/toolbox/paint-dynamics-fade-example-1.png |  Bin 0 -> 10136 bytes
 images/C/toolbox/paint-dynamics-fade-example-2.png |  Bin 0 -> 7633 bytes
 images/C/toolbox/paint-dynamics-fade-example-3.png |  Bin 0 -> 7854 bytes
 images/C/toolbox/paint-dynamics-list.png           |  Bin 0 -> 5460 bytes
 images/C/toolbox/paint-dynamics-options.png        |  Bin 3952 -> 5526 bytes
 images/C/toolbox/paint-dynamics-tool-options.png   |  Bin 0 -> 5778 bytes
 src/toolbox/paint/common-features.xml              |   21 +-
 src/toolbox/paint/dynamics.xml                     |  406 +++++++++++++-------
 8 files changed, 269 insertions(+), 158 deletions(-)
---
diff --git a/images/C/toolbox/paint-dynamics-fade-example-1.png b/images/C/toolbox/paint-dynamics-fade-example-1.png
new file mode 100755
index 0000000..2880614
Binary files /dev/null and b/images/C/toolbox/paint-dynamics-fade-example-1.png differ
diff --git a/images/C/toolbox/paint-dynamics-fade-example-2.png b/images/C/toolbox/paint-dynamics-fade-example-2.png
new file mode 100755
index 0000000..8598791
Binary files /dev/null and b/images/C/toolbox/paint-dynamics-fade-example-2.png differ
diff --git a/images/C/toolbox/paint-dynamics-fade-example-3.png b/images/C/toolbox/paint-dynamics-fade-example-3.png
new file mode 100755
index 0000000..a1a53ce
Binary files /dev/null and b/images/C/toolbox/paint-dynamics-fade-example-3.png differ
diff --git a/images/C/toolbox/paint-dynamics-list.png b/images/C/toolbox/paint-dynamics-list.png
new file mode 100755
index 0000000..e87b1c4
Binary files /dev/null and b/images/C/toolbox/paint-dynamics-list.png differ
diff --git a/images/C/toolbox/paint-dynamics-options.png b/images/C/toolbox/paint-dynamics-options.png
index 2675b2b..552a4e7 100755
Binary files a/images/C/toolbox/paint-dynamics-options.png and b/images/C/toolbox/paint-dynamics-options.png differ
diff --git a/images/C/toolbox/paint-dynamics-tool-options.png b/images/C/toolbox/paint-dynamics-tool-options.png
new file mode 100755
index 0000000..01b499f
Binary files /dev/null and b/images/C/toolbox/paint-dynamics-tool-options.png differ
diff --git a/src/toolbox/paint/common-features.xml b/src/toolbox/paint/common-features.xml
index 94b62f6..e4f492e 100644
--- a/src/toolbox/paint/common-features.xml
+++ b/src/toolbox/paint/common-features.xml
@@ -440,17 +440,16 @@
         <term>Incremental</term>
         <listitem>
           <para>
-            At least in my version of GIMP 2.8 the incremental check-box does 
-            not work quite as I expected. If it is deactivated (the default 
-            value) the maximum effect of a single stroke is determined by the 
-            opacity set in the opacity slider. If the opacity is set to less 
-            than 100, moving the brush over the same spot will increase the 
-            opacity if the brush is lifted in the meantime. Painting over with 
-            the same stroke has no such effect. If Incremental is active the 
-            brush will paint with full opacity independent of the slider 
-            setting. This option is available for all paint tools except those 
-            which have a <quote>rate</quote> control, which automatically 
-            implies an incremental effect. See 
+            The incremental check-box does not seems to work as everyone expect.
+            If it is deactivated (the default value) the maximum effect of a 
+            single stroke is determined by the opacity set in the opacity 
+            slider. If the opacity is set to less than 100, moving the brush 
+            over the same spot will increase the opacity if the brush is lifted 
+            in the meantime. Painting over with the same stroke has no such 
+            effect. If Incremental is active the brush will paint with full 
+            opacity independent of the slider's setting. This option is available 
+            for all paint tools except those which have a <quote>rate</quote> 
+            control, which automatically implies an incremental effect. See 
             also <xref linkend="gimp-concepts-layer-modes"/>.
           </para>
         </listitem>
diff --git a/src/toolbox/paint/dynamics.xml b/src/toolbox/paint/dynamics.xml
old mode 100644
new mode 100755
index 1918ebd..54add0d
--- a/src/toolbox/paint/dynamics.xml
+++ b/src/toolbox/paint/dynamics.xml
@@ -26,15 +26,28 @@
   </para>
   <para>
     The dynamics will make some of the behaviors of the drawing tools act more
-    like the physical (<quote>real</quote>) tools. 
+    like the physical (<quote>real</quote>) tools.
   </para>
 
   <figure>
     <title>Dynamics in Tool Options </title>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/toolbox/paint-dynamics-options.png" format="PNG"/>
+        <imagedata fileref="images/toolbox/paint-dynamics-tool-options.png"
+        format="PNG"/>
       </imageobject>
+      <caption>
+        <para>The Dynamics in Tool Options Dialog</para>
+      </caption>
+    </mediaobject>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/toolbox/paint-dynamics-list.png"
+        format="PNG"/>
+      </imageobject>
+      <caption>
+        <para>The Dynamics Preset List</para>
+      </caption>
     </mediaobject>
   </figure>
 
@@ -42,9 +55,10 @@
     The Dynamics area in the Tool Option dialog shows from left to right, the
     button to open the list containing the available dynamic presets, a field
     displaying the name of the current preset, and rightmost the edit button.
-    Click on the 
+    Click on the
     <guiicon>
-      <inlinegraphic fileref="images/toolbox/stock-tool-folders-dynamics-22.png"/>
+      <inlinegraphic
+      fileref="images/toolbox/stock-tool-folders-dynamics-22.png"/>
     </guiicon>
     button to open the dialog window displaying the available dynamics presets
     and select another preset.
@@ -56,7 +70,8 @@
       <title>The Paint Dynamics Selection Dialog</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/paint-dynamics-select.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/paint-dynamics-select.png"
+          format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -76,7 +91,8 @@
       </listitem>
       <listitem>
         <para>
-          or by clicking on the <guibutton>Open the dynamics selection</guibutton>
+          or by clicking on the <guibutton>Open the dynamics
+          selection</guibutton>
           button in the list of dynamics presets.
         </para>
       </listitem>
@@ -128,7 +144,8 @@
       <title>Editing Paint Dynamics</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/paint-dynamics-edit.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/paint-dynamics-edit.png"
+          format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -150,8 +167,8 @@
       </listitem>
     </itemizedlist>
     <para>
-      You select the desirable behavior by clicking in the small squares.
-      Clicking a second time unselects the marking.
+      You select the desired behaviors by clicking in the small squares.
+      Clicking a second time will unselect the marking.
     </para>
     <note>
       <para>
@@ -161,15 +178,15 @@
       </para>
     </note>
   </sect3>
-  
+
   <sect3>
-    <title>Mapping Matrix</title>
+    <title>The Paint Dynamics Matrix</title>
     <indexterm>
     <primary>Tools</primary>
-    <secondary>Mapping Matrix</secondary>
+    <secondary>Dynamics Matrix</secondary>
     </indexterm>
     <indexterm>
-      <primary>Mapping Matrix</primary>
+      <primary>Dynamics Matrix</primary>
     </indexterm>
     <para>
       The main part of the edit dialog is a table where you can decide
@@ -180,59 +197,61 @@
 
     <itemizedlist>
       <para>
-        Each column in the table represents a stylus or mouse action except for 
-        the random and the fade functions.
+        Each column in the table represents a stylus or mouse action except
+        the random and the fade functions. All functions works with graphic
+        tablet. Some of the functions are also available using the mouse. These
+        functions are marked in the tables. The descriptions are using the
+        default settings of all functions
       </para>
       <listitem>
         <para>
-          <guilabel>Pressure</guilabel>: (Graphic tablet). It allows you to
-          decide which aspects of the tool's action will be affected by
-          pressing the stylus against the tablet.
+          <guilabel>Pressure</guilabel>: It allows you to decide which
+          aspects of the tool's action will be affected by pressing the
+          stylus against the tablet.
         </para>
       </listitem>
       <listitem>
         <para>
-          <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). This is the
-          speed of the stylus or the mouse.
+          <guilabel>Velocity</guilabel>: (mouse) This is the speed of
+          the brush.
         </para>
       </listitem>
       <listitem>
         <para>
-          <guilabel>Direction</guilabel>: (Graphic tablet, mouse). This is the
-          moving direction of the stylus or the mouse.
+          <guilabel>Direction</guilabel>: (mouse) This is the moving direction
+          of the brush.
         </para>
       </listitem>
       <listitem>
         <para>
-          <guilabel>Tilt</guilabel>: (Graphic tablet). The behavior of the
-          function depends on the tilting of the stylus.
+          <guilabel>Tilt</guilabel>: The behavior of the function depends
+          on the tilting of the stylus.
         </para>
       </listitem>
       <listitem>
         <para>
-          <guilabel>Wheel</guilabel>: (Graphic tablet). The output depends on
-          the rotation of the stylus or the setting of the wheel on the airbrush
-          pen.
+          <guilabel>Wheel</guilabel>: The output depends on the rotation of
+          the stylus or the setting of the wheel on the airbrush pen.
         </para>
       </listitem>
       <listitem>
         <para>
-          <guilabel>Random</guilabel>: (Graphic tablet, mouse). The selected
-          option will change at random.
+          <guilabel>Random</guilabel>: (mouse) The selected option will
+          change at random.
         </para>
       </listitem>
       <listitem>
         <para>
-          <guilabel>Fade</guilabel>: (Graphic tablet, mouse). The selected
-          option will be faded in or out depending on the settings of the fade
-          options in the Dynamic Options menu of the Tools Option dialog.
+          <guilabel>Fade</guilabel>: (mouse) The selected option will be
+          faded in or out depending on the settings of the fade options in
+          the Dynamic Options menu of the Tools Option dialog.
         </para>
       </listitem>
     </itemizedlist>
     <para>
-      Each line shows a brush parameter and seven check-boxes, one for each
-      action. You connect the parameters to the actions by clicking the
-      appropriate boxes. Clicking on a box a second time will unselect the
+      Each row shows a brush parameter and seven check-boxes, one for
+      each action. You connect the parameters to the actions by clicking
+      the appropriate boxes. Clicking on a selected box will unselect the
       connection.
     </para>
     <variablelist>
@@ -240,34 +259,34 @@
         <term>Opacity</term>
         <listitem>
           <para>
-            <guilabel>Pressure</guilabel>: (Graphic tablet). Press harder to
-            make the drawing less transparent.
+            <guilabel>Pressure</guilabel>: Press harder to make the drawing
+            less transparent.
           </para>
           <para>
-            <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). The
-            opacity decreases as the speed of the stylus increases.
+            <guilabel>Velocity</guilabel>: (mouse) The opacity decreases as
+            the speed of the stylus increases.
           </para>
           <para>
-            <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The
-            opacity depends on the direction of the stylus or the mouse. The
-            effect seems to have a touch of randomness built in.
+            <guilabel>Direction</guilabel>: (mouse) The opacity depends on
+            the direction of the stylus or the mouse. The effect seems to
+            have a touch of randomness built in.
           </para>
           <para>
-            <guilabel>Tilt</guilabel>: (Graphic tablet). The opacity depends
-            on the tilt of the stylus.
+            <guilabel>Tilt</guilabel>: The opacity depends on the tilt of
+            the stylus.
           </para>
           <para>
-            <guilabel>Wheel</guilabel>: (Graphic tablet). TO DO
+            <guilabel>Wheel</guilabel>: TO DO
           </para>
           <para>
-            <guilabel>Random</guilabel>: (Graphic tablet, mouse). The opacity
-            changes at random in the interval set by the opacity slider in the
-            Tool Options dialog.
+            <guilabel>Random</guilabel>: (mouse) The opacity changes at
+            random in the interval set by the opacity slider in the Tool
+            Options dialog.
           </para>
           <para>
-            <guilabel>Fade</guilabel>: (Graphic tablet, mouse). Starting with
-            full transparency and ending with the opacity set by the opacity
-            slider in the Tool Options dialog.
+            <guilabel>Fade</guilabel>: (mouse) Starting with full transparency
+            and ending with the opacity set by the opacity slider in the
+            Tool Options dialog.
           </para>
         </listitem>
       </varlistentry>
@@ -276,34 +295,33 @@
         <term>Size</term>
         <listitem>
           <para>
-            <guilabel>Pressure</guilabel>: (Graphic tablet). Press harder to
-            make the brush wider.
+            <guilabel>Pressure</guilabel>: Press harder to make the brush
+            wider.
           </para>
           <para>
-            <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). Increasing
-            speed decreases the width of the brush.
+            <guilabel>Velocity</guilabel>: (mouse) Increasing speed decreases
+            the width of the brush.
           </para>
           <para>
-            <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The size
-            of the brush depends on the moving direction of the stylus or the
-            mouse. The effect seems to have a touch of randomness built in.
+            <guilabel>Direction</guilabel>: (mouse) The size of the brush
+            depends on the moving direction of the stylus or the mouse. The
+            effect seems to have a touch of randomness built in.
           </para>
           <para>
-            <guilabel>Tilt</guilabel>: (Graphic tablet). The size of the brush
-            depends on the tilt of the stylus.
+            <guilabel>Tilt</guilabel>: The size of the brush depends on the
+            tilt of the stylus.
           </para>
           <para>
-            <guilabel>Wheel</guilabel>: (Graphic tablet). TODO
+            <guilabel>Wheel</guilabel>: TODO
           </para>
           <para>
-            <guilabel>Random</guilabel>: (Graphic tablet, mouse). The size of
-            the brush changes at random up to the size set in the brush size
-            slider in the Tool Options dialog.
+            <guilabel>Random</guilabel>: (mouse) The size of the brush
+            changes at random up to the size set in the brush size slider
+            in the Tool Options dialog.
           </para>
           <para>
-            <guilabel>Fade</guilabel>: (Graphic tablet, mouse). Fades from a
-            narrow brush to the size set by the brush size slider in the Tools
-            Options dialog.
+            <guilabel>Fade</guilabel>: (mouse) Fades from a narrow brush to
+            the size set by the brush size slider in the Tools Options dialog.
           </para>
         </listitem>
       </varlistentry>
@@ -326,29 +344,26 @@
             editor, the color is instead collected from the active gradient.
           </para>
           <para>
-            <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). At slow
-            speed the color is collected from the right side of the gradient.
-            As the speed increases, the color is picked more and more from
-            the left side of the gradient.
+            <guilabel>Velocity</guilabel>: (mouse) At slow speeds the color
+            is collected from the right side of the gradient. As the speed
+            increase the color is picked more and more from the left side
+            of the gradient.
           </para>
           <para>
-            <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The
-            direction determines where on the gradient the color is picked
-            from. Mostly moving to the right and moving downward the color is
-            picked from the left side of the gradient and the other directions
-            get the color picked from the right half of the gradient.
+            <guilabel>Direction</guilabel>: (mouse) The direction determine
+            where on the gradient the color is picked from. The effect seems
+            to work a bit on random.
           </para>
 
           <para>
-            <guilabel>Random</guilabel>: (Graphic tablet, mouse). The color is
-            picked at random from the gradient.
+            <guilabel>Random</guilabel>: (mouse) The color is picked at
+            random from the gradient.
           </para>
           <para>
-            <guilabel>Fade</guilabel>: (Graphic tablet, mouse). The start
-            color is collected from the left side of the gradient and then
-            more and more from the right side during the stroke. The behavior
-            of the fading is set in the fade options of the Tool Options
-            dialog.
+            <guilabel>Fade</guilabel>: (mouse) The start color is collected
+            from the left side of the gradient and then more and more from
+            the right side during the stroke. The behavior of the fading is
+            set in the Fade Options in the Tool Options Dialog.
           </para>
         </listitem>
       </varlistentry>
@@ -360,19 +375,18 @@
             The hardness option is useful only for fuzzy brushes.
           </para>
           <para>
-            <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). At slow
-            speed the brush is hard and becomes more fuzzy as the speed
-            increases.
+            <guilabel>Velocity</guilabel>: (mouse) At slow speed the brush
+            is hard and become more fuzzy as the speed increase.
           </para>
 
           <para>
-          <guilabel>Random</guilabel>: (Graphic tablet, mouse). The fuzziness
-          of the brush varies at random.
+          <guilabel>Random</guilabel>: (mouse) The fussiness of the brush
+          varies at random.
           </para>
           <para>
-            <guilabel>Fade</guilabel>: (Graphic tablet, mouse). The brush
-            becomes less fuzzy during the stroke. The behavior of the fading
-            is set in the fade options of the Tools options dialog.
+            <guilabel>Fade</guilabel>:(mouse) The brush become less fuzzy
+            during the stroke. The behavior of the fading is set in the Fade
+            Options in the Tool Options Dialog.
           </para>
         </listitem>
       </varlistentry>
@@ -390,35 +404,37 @@
         <term>Aspect Ratio</term>
         <listitem>
           <para>
-            The Aspect Ratio Slider in the Tool Options must be set to other
-            values than the default value of 0.00 to activate the dynamics.
-            If the aspect ratio slider is set to a negative value the height
-            of the brush is constant but the width of the brush will vary. If
-            the slider is set to a positive value then only the height of the
-            brush will vary.
+            The Aspect Ratio Slider in the Tool Options Dialog must be set
+            to other values than the default value of 0.00 to activate the
+            dynamics. If the aspect ratio slider is set to a negative value
+            the width of the brush will vary while the height of the brush
+            is constant. If the slider is set to a positive value only the
+            height of the brush will vary.
           </para>
 
           <para>
-            <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). The aspect
-            ratio of the brush (width / height) varies with the speed.
+            <guilabel>Velocity</guilabel>: (mouse) The aspect
+            ratio of the brush (width / height) varies with the speed of
+            the brush.
           </para>
           <para>
-            <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The aspect
-            ratio of the brush varies with the moving direction of the brush.
+            <guilabel>Direction</guilabel>: (mouse) The aspect ratio of the
+            brush varies with the moving direction of the brush. The effect
+            seems to have a touch of randomness built in.
           </para>
 
           <para>
-            <guilabel>Random</guilabel>: (Graphic tablet, mouse). The aspect
-            ratio of the brush varies at random.
+            <guilabel>Random</guilabel>: (mouse) The aspect ratio of the
+            brush varies at random.
           </para>
           <para>
-            <guilabel>Fade</guilabel>:  (Graphic tablet, mouse). If the Aspect
-            Ratio Slider is set to a positive value the brush
-            will fade from full height at the start of the stroke to the
-            height set by the aspect ratio slider. If the slider is set to a
-            negative value the brush fades from full width to the width set
-            by the aspect ratio slider. The behavior of the fading is set in
-            the fade options in the toolbox.
+            <guilabel>Fade</guilabel>: (mouse) If the Aspect Ratio Slider
+            is set to a positive value the brush will fade from full height
+            at the start of the stroke to the height set by the aspect ratio
+            slider. If the slider is set to a negative value the brush fades
+            from full width to the width set by the aspect ratio slider. The
+            behavior of the fading is set in the Fade Options in the Tool
+            Options Dialog.
           </para>
         </listitem>
       </varlistentry>
@@ -429,27 +445,26 @@
           <para>
             Spacing is the distance between the marks set by the brush when
             drawing lines. With this option set the spacing is affected by how
-            the stylus is used.
+            the stylus or mouse is used.
           </para>
 
           <para>
-            <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). The spacing
-            between the footprints of the brush increases with increasing speed.
+            <guilabel>Velocity</guilabel>: (mouse) The spacing between the
+            footprints of the brush increases with increasing speed.
           </para>
           <para>
-            <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The
-            spacing varies with the moving direction of the brush.
+            <guilabel>Direction</guilabel>: (mouse) The spacing varies with
+            the moving direction of the brush. The effect seems to have a
+            touch of randomness built in.
           </para>
 
           <para>
-            <guilabel>Random</guilabel>: (Graphic tablet, mouse). The spacing
-            varies at random.
+            <guilabel>Random</guilabel>: (mouse) The spacing varies at random.
           </para>
           <para>
-            <guilabel>Fade</guilabel>:  (Graphic tablet, mouse). Start with a
-            wide spacing and gradually make the spacing narrower. The behavior
-            of the fading is set in the fade options in the Tool Options
-            dialog.
+            <guilabel>Fade</guilabel>: (mouse) Starting with a wide spacing
+            and gradually make the spacing narrower. The behavior of the
+            fading is set in the Fade Options in the Tool Options Dialog.
           </para>
         </listitem>
       </varlistentry>
@@ -490,30 +505,28 @@
             of the jitter slider in the Tool Options dialog window.
           </para>
           <para>
-            <guilabel>Pressure</guilabel>: (Graphic tablet). At low pressure
-            the brush prints are spread according to the value set in the
-            jitter amount slider. As the pressure increases the scattering
-            amount decreases.
+            <guilabel>Pressure</guilabel>: At low pressure the brush prints
+            are spread according to the value set in the jitter amount
+            slider. As the pressure increases the scattering amount decreases.
           </para>
           <para>
-            <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). At slow
-            speed the brush prints are spread according to the value set in
-            the jitter amount slider. As the speed increases the scattering
-            amount decreases.
+            <guilabel>Velocity</guilabel>: (mouse) At slow speed the brush
+            prints are spread according to the value set in the jitter amount
+            slider. As the speed increase the scattering amount decrease.
           </para>
           <para>
-            <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The
-            jitter effect depends on the moving direction of the brush.
+            <guilabel>Direction</guilabel>: (mouse) The jitter effect depends
+            on the direction of the brush. The effect seems to have a touch
+            of randomness built in.
           </para>
           <para>
-            <guilabel>Random</guilabel>: (Graphic tablet, mouse). The jitter
-            varies at random.
+            <guilabel>Random</guilabel>: (mouse)The jitter varies at random.
           </para>
           <para>
-            <guilabel>Fade</guilabel>: (Graphic tablet, mouse).
-            Starting with no jitter and ending with the amount of jitter set
-            in the jitter amount slider. The behavior of the fading is set in
-            the fade options in the Tool Options dialog.
+            <guilabel>Fade</guilabel>: (mouse) Starting with no jitter
+            and ending with the amount of jitter set in the jitter amount
+            slider. The behavior of the fading is set in the fade options
+            in the Tool Options dialog.
           </para>
         </listitem>
       </varlistentry>
@@ -521,34 +534,132 @@
   </sect3>
 
   <sect3>
-    <title>Fine Tuning the Dynamics</title>
+    <title>Customizing the Dynamics</title>
     <figure>
-      <title>Fine Tuning the Dynamics</title>
+      <title>Customizing the Dynamics</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/paint-dynamics-tuning.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/paint-dynamics-tuning.png"
+          format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>
     <para>
-      If the current options does not suit you, you may fine-tune the settings
+      If the current options do not suits you, you may fine-tune the settings
       from the Paint Dynamics Editor. Click on the down arrow to open the
-      drop down menu and then select the option to be changed.
+      drop down menu and then select what option to change.
     </para>
 
     <figure>
       <title>The Fine Tuning Curve</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/paint-dynamics-tuning-color.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/paint-dynamics-tuning-color.png"
+          format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <para>
+      Click on one of the options to open the customizing dialog. The upper
+      part of the dialog contains a curve where you can adjust the behaviour
+      of the chosen parameters selected in the lower part of the dialog. You
+      can drag the curve by pointing on it with the mouse pointer, holding
+      down the left mouse button and the move the curve wherever you want
+      inside the diagram.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Dynamics Examples</title>
+    <figure>
+      <title>Dynamics Options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/toolbox/paint-dynamics-fade-example-1.png"
+          format="PNG"/>
+        </imageobject>
+        <caption>
+          <para>
+            The brush strokes
+          </para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/toolbox/paint-dynamics-fade-example-2.png"
+          format="PNG"/>
         </imageobject>
+        <caption>
+          <para>
+            The brush size - fade curve
+          </para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/toolbox/paint-dynamics-fade-example-3.png"
+          format="PNG"/>
+        </imageobject>
+        <caption>
+          <para>
+            The color - fade curve
+          </para>
+        </caption>
       </mediaobject>
     </figure>
     <para>
-      Click on one of the options to open the fine tuning dialog. The upper part of the
-      dialog contains a curve where you can adjust the behavior of the chosen
-      parameters selected in the lower part of the dialog.
+      The examples shown are very brief, but will perhaps give you an idea
+      of how to use this functions. Feel free to try other combinations. In
+      these examples the foreground color is set to blue (#0000ff) and the
+      background color to yellow (#ffff00). Fading: 200 pixels. Paintbrush
+      size: 72. All other settings are the default values except for those
+      values changed
     </para>
+    <itemizedlist mark="opencircle">
+      <listitem>
+        <para>
+          Example 1 shows the result when the brush size is connected to the
+          fading. Default options. The brush size starts as zero and increase
+          to the size set in the brush size slider in the Tools Options Dialog.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          In example 2 the brush size is still connected to the fade tool,
+          but the fade curve is set as in image 5. The brush size starts at
+          zero, fades up to full size and then fades down to zero again.
+        </para>
+        <para>
+          The full fade length is set along the x-axis from left to right. The
+          y-axis determines the size of the brush. At the bottom the brush size
+          is zero, and at the top of the diagram the brush is set to the full
+          size according to the size set in the slider in the Brush Options
+          Dialog. Study the example and the curve to see the relationship.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          In example 3 the brush size is disconnected from the fade tool. The
+          color is connected with the fade option with the curve set as in
+          image 6. At the start of the drawing the color is picked from the
+          left side of the gradient, then gradually more from the right side
+          of the gradient and then finally fading back to the left side again.
+        </para>
+        <para>
+          As usual the x-axis is the total fade length. When the curve is
+          near the bottom of the diagram the color is picked from the left
+          side of the gradient. With the curve at the top of the diagram
+          the color is picked from the right side of the gradient.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          The last example shows a combination of these two settings. Both
+          the size of the brush and the color are connected to the fading
+          function with the curves set as in image 5 and 6.
+        </para>
+      </listitem>
+    </itemizedlist>
   </sect3>
 
 <!-- ****** Dynamic Options: ****** -->
@@ -568,7 +679,8 @@
       <title>Dynamics Options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/toolbox/dynamics-options.png" format="PNG"/>
+          <imagedata fileref="images/toolbox/paint-dynamics-options.png"
+          format="PNG"/>
         </imageobject>
       </mediaobject>
     </figure>



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