[gimp-help-2] Some corrections and additions



commit ccb83df4c924c449a1fb5b6948fd7beec1da0db3
Author: Julien Hardelin <jm hard wanadoo fr>
Date:   Sat Nov 17 21:09:00 2012 +0100

    Some corrections and additions

 images/C/tool-options/smooth-stroke.png |  Bin 0 -> 22229 bytes
 src/toolbox/paint/common-features.xml   |  133 +++---
 src/toolbox/paint/dynamics.xml          |  812 ++++++++++++++++---------------
 3 files changed, 501 insertions(+), 444 deletions(-)
---
diff --git a/images/C/tool-options/smooth-stroke.png b/images/C/tool-options/smooth-stroke.png
new file mode 100755
index 0000000..2aef07d
Binary files /dev/null and b/images/C/tool-options/smooth-stroke.png differ
diff --git a/src/toolbox/paint/common-features.xml b/src/toolbox/paint/common-features.xml
index e4ed6b3..fcbfb1a 100644
--- a/src/toolbox/paint/common-features.xml
+++ b/src/toolbox/paint/common-features.xml
@@ -2,19 +2,9 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2009-04-29 ude: Moved Paint Mode examples to new sect3
-  2008-09-25 aprokoudine reviwed 'ru'
-  2008-06-01 ciampix reviewed for it
-  2008-04-14 JPL reviewed for fr
-  2008-03-12 Mr.Dust : added 'ko'
-  2008-03-01 ude: updated 'de'
-  2007-12-01 PP  reviewed for fr
-  2007-11-11 KoSt: updated 'no'
-  2007-10-29 j.h: updated fr ; documented Scale, Jitter en;fr
-  2007-10-06 lexa: reviewed for GIMP 2.4 (de)
-  2007-06-15 kost: added norwegian
-  2006-02-05 fr revised by j.h
-  2005-05-20 de reviewed by axel.wernicke
+  2012-11-16 j.h: documented Smooth Stroke
+  2012-10-15 Kolbjoern: documented Dynamics
+  2007-10-29 j.h: documented Scale, Jitter en;fr
 -->
 <sect2 id="gimp-tool-brush">
   <title>Common Features</title>
@@ -226,7 +216,7 @@
     <para>
       Many tool options are shared by several paint tools: these are described 
       here. Options that apply only to one specific tool, or to a small number
-			of tools, are described in the sections devoted to those tools.
+      of tools, are described in the sections devoted to those tools.
     </para>
     <variablelist id="gimp-tool-painting-modes" xreflabel="Painting Modes">
       <varlistentry>
@@ -272,9 +262,9 @@
             the Tool Options has the same effect that changing opacity in the
             Layers dialog would have in the latter situation. It controls the 
             <quote>strength</quote> of all paint tools, not just those that 
-						paint on the active layer. In the case of the Eraser, this can 
-						come across as a bit confusing: it works out that the higher the 
-						<quote>opacity</quote> is, the more transparency you get.
+            paint on the active layer. In the case of the Eraser, this can 
+            come across as a bit confusing: it works out that the higher the 
+            <quote>opacity</quote> is, the more transparency you get.
           </para>
         </listitem>
       </varlistentry>
@@ -310,16 +300,16 @@
           </para>
         </listitem>
       </varlistentry>
-			
+      
       <varlistentry>
         <term>Aspect Ratio</term>
         <listitem>
           <para>
             This determines the ratio between the height and the width
-						of the brush. The slider is scaled from -20.00 to 20.00 with the 
-						default value set to 0.00. A negative value from 0.00 to -20 will 
-						narrow the height of the brush while a positive value between 0.00 
-						and 20.00 indicates the narrowing rate of the width of the brush.
+            of the brush. The slider is scaled from -20.00 to 20.00 with the 
+            default value set to 0.00. A negative value from 0.00 to -20 will 
+            narrow the height of the brush while a positive value between 0.00 
+            and 20.00 indicates the narrowing rate of the width of the brush.
           </para>
         </listitem>
       </varlistentry>
@@ -328,7 +318,8 @@
         <term>Angle</term>
         <listitem>
           <para>
-            TO DO
+            This option makes the brush turn round its center. This is visible 
+            if the brush is not circular.
           </para>
         </listitem>
       </varlistentry>			
@@ -347,21 +338,21 @@
           </figure>
           <para>
             Brush dynamics let you map different brush parameters to several 
-						input dynamics. They are mostly used with tablets,
-            but some of them are also usable with a mouse.
+            input dynamics. They are mostly used with graphic tablets, but 
+            some of them are also usable with a mouse.
+          </para>
+          <para>
+            You can read more about dynamics in 
+            <link linkend="gimp-tool-dynamics">Dynamics</link>
           </para>
-					<para>
-						You may read more about dynamics in 
-						<link linkend="gimp-tool-dynamics">Dynamics</link>
-					</para>					
           <para>
             When stroking paths and selections using a paint tool there is a an 
-						option to select <quote>Emulate brush dynamics</quote>. That means 
-						that when you stoke, brush pressure and velocity are varying along 
-						the length of the stroke. Pressure starts with zero, ramps up to 
-						full pressure and then ramps down again to no pressure. Velocity 
-						starts from zero and ramps up to full speed by the end of the  
-						stroke.
+            option to select <quote>Emulate brush dynamics</quote>. That means 
+            that when you stoke, brush pressure and velocity are varying along 
+            the length of the stroke. Pressure starts with zero, ramps up to 
+            full pressure and then ramps down again to no pressure. Velocity 
+            starts from zero and ramps up to full speed by the end of the  
+            stroke.
           </para>          
         </listitem>
       </varlistentry>
@@ -369,12 +360,12 @@
       <varlistentry>
         <term>Dynamics Options</term>
         <listitem>
-					<para>
-						This belongs to the dynamics and is described in 
-						<link linkend="gimp-tool-dynamic-options">Dynamics Options</link>
-					</para>					        
+          <para>
+            These options are described in 
+            <link linkend="gimp-tool-dynamic-options">Dynamics Options</link>
+          </para>        
         </listitem>
-      </varlistentry>			
+      </varlistentry>
 
       <varlistentry>
         <term>Apply Jitter</term>
@@ -403,42 +394,68 @@
               </caption>
             </mediaobject>
           </figure>
-					<para>
-						Jitter is also available in the Paint Dynamic Editor where you may 
-						connect jitter to the behaviour of the brush.
-					</para>
+          <para>
+            Jitter is also available in the Paint Dynamic Editor where you can 
+            connect jitter to the behavior of the brush.
+          </para>
         </listitem>
       </varlistentry>
-			
+
       <varlistentry>
         <term>Smooth Stroke</term>
         <listitem>
           <para>
-            TO DO
+            This option doesn't affect the rendering of the brush stroke but 
+            its <quote>shape</quote>. It takes away the wobbles of the line you
+            are drawing. It makes drawing with a mouse easier.
+          </para>
+          <para>
+            When this option is checked, two setting areas appear,
+            <guilabel>Quality</guilabel> and <guilabel>Weight</guilabel>. You
+            can change the default values to adapt them to your skill.
           </para>
+          <para>
+            High weight values rigidifies the brush stroke.
+          </para>
+          <figure>
+            <title><quote>Smooth Stroke</quote> example</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/tool-options/smooth-stroke.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Trying to draw a straight line and a sine curve with the
+                  mouse.  1 : option unchecked   2 : default values   
+                  3 : maximum values
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>
         </listitem>
-      </varlistentry>			
+      </varlistentry>
 
       <varlistentry>
         <term>Incremental</term>
         <listitem>
           <para>
             At least in my version of GIMP 2.8 the incremental check-box does 
-						not works 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 
+            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 
             also <xref linkend="gimp-concepts-layer-modes"/>.
           </para>
         </listitem>
       </varlistentry>
-			
+
     </variablelist>
   </sect3>
 
diff --git a/src/toolbox/paint/dynamics.xml b/src/toolbox/paint/dynamics.xml
old mode 100755
new mode 100644
index bcedc33..1918ebd
--- a/src/toolbox/paint/dynamics.xml
+++ b/src/toolbox/paint/dynamics.xml
@@ -1,9 +1,8 @@
 <?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";>
-<!-- comments:
-  This is at the moment a suggestion. Hoping somebody will enhance it.
-	Kolbjoern
+<!-- Section history:
+  2012-10-20 Created by Kolbjoern
 -->
 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-dynamics">
   <title>Dynamics</title>
@@ -15,21 +14,21 @@
     <primary>Dynamics</primary>
   </indexterm>
 
-	<para>
+  <para>
     The dynamics apply a more <quote>real feeling</quote> to the brush by
-		connecting one or more of the brush parameters to the use of the brush. 
-		You may for instance let the width of the pencil vary according to the speed of 
-		the stylus or the mouse, make the color saturation depending on the stylus 
-		pressure, make the color changing as the direction of the brush changes on the 
-		canvas, and so on. You may choose among several presets or define your own. The 
-		dynamics are created for use together with drawing tablets, but some are available 
-		using the mouse.
+    connecting one or more of the brush parameters to the way of using the
+    brush. You may for instance let the width of the pencil vary according to
+    the speed of the stylus or the mouse, make the color saturation
+    depending on the stylus pressure, make the color changing as the
+    direction of the brush changes on the canvas, and so on. You may choose
+    among several presets or define your own. The dynamics are created to be
+    used together with drawing tablets, but some are available using the mouse.
   </para>
   <para>
-		The dynamics will make some of the behaviours of the drawing tools act more 
-		like the physical (<quote>real</quote>) tools. 
-  </para>	
-	
+    The dynamics will make some of the behaviors of the drawing tools act more
+    like the physical (<quote>real</quote>) tools. 
+  </para>
+
   <figure>
     <title>Dynamics in Tool Options </title>
     <mediaobject>
@@ -40,18 +39,18 @@
   </figure>
 
   <para>
-    The dynamics area in the tools 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 button 
-		<guiicon>
+    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 
+    <guiicon>
       <inlinegraphic fileref="images/toolbox/stock-tool-folders-dynamics-22.png"/>
     </guiicon>
-		to open the dialog window displaying the available dynamics presets to select 
-		another preset.
+    button to open the dialog window displaying the available dynamics presets
+    and select another preset.
   </para>
 
-	<sect3>
+  <sect3>
     <title>The Paint Dynamics Selection Dialog</title>
     <figure>
       <title>The Paint Dynamics Selection Dialog</title>
@@ -61,9 +60,9 @@
         </imageobject>
       </mediaobject>
     </figure>
-		<para>
-			The paint dynamics dialog can be opened
-		</para>
+    <para>
+      The Paint Dynamics dialog window can be opened
+    </para>
     <itemizedlist>
       <listitem>
         <para>
@@ -74,37 +73,37 @@
             <guimenuitem>Paint Dynamics</guimenuitem>
           </menuchoice>,
         </para>
-      </listitem>				
+      </listitem>
       <listitem>
         <para>
-          or by clicking on the button <guibutton>Open the dynamics selection</guibutton> 
-					in the list of dynamics presets.
+          or by clicking on the <guibutton>Open the dynamics selection</guibutton>
+          button in the list of dynamics presets.
         </para>
       </listitem>
     </itemizedlist>
-		<para>
-		  The <guilabel>Dynamics Selection</guilabel> dialog is a dockable dialog; see 
-			the section <xref linkend="gimp-concepts-docks"/> for help on 
-			manipulating it.
-		</para>
+    <para>
+      The <guilabel>Paint Dynamics</guilabel> dialog is a dockable dialog;
+      please see the section <xref linkend="gimp-concepts-docks"/> for help on
+      manipulating it.
+    </para>
 
-		<itemizedlist>
-		  <para>
-			  From this dialog you can select from all the available presets, just 
-				as from the list of dynamic presets. In addition there are five 
-				buttons:			  
-			</para>
+    <itemizedlist>
+      <para>
+        From this dialog you can select from all the available presets, just
+        as from the list of dynamics presets. In addition there are five
+        buttons:
+      </para>
       <listitem>
         <para>
-          Edit dynamics: Click on this to edit the selected dynamics. 
+          Edit dynamics: Click on this to edit the selected dynamics.
         </para>
-      </listitem>		
+      </listitem>
       <listitem>
         <para>
           Create a new dynamics: Do just that.
         </para>
       </listitem>
-			<listitem>
+      <listitem>
         <para>
           Duplicate this dynamics: Make a copy of the selected dynamics.
         </para>
@@ -113,17 +112,17 @@
         <para>
           Delete this dynamics: Delete the selected dynamics.
         </para>
-      </listitem>	
+      </listitem>
       <listitem>
         <para>
           Refresh dynamics: Update the dynamics list.
         </para>
-      </listitem>				
+      </listitem>
     </itemizedlist>
 
   </sect3>
-	
-	<sect3>
+
+  <sect3>
     <title>Editing Paint Dynamics</title>
     <figure>
       <title>Editing Paint Dynamics</title>
@@ -134,225 +133,250 @@
       </mediaobject>
     </figure>
     <itemizedlist>
-		  <para>
-			  The paint dynamics edit dialog can be called from
-			</para>
+      <para>
+        The Paint Dynamics Editor can be called from:
+      </para>
       <listitem>
         <para>
-          the edit button in the Tool options dialog,
+          the edit button in the Tool Options dialog,
         </para>
-      </listitem>		
+      </listitem>
       <listitem>
         <para>
-          from the Paint Dynamics Selection dialog by either clicking the 
-					button <guibutton>Edit Dynamics</guibutton> or the button <guibutton>Create a New 
-					Dynamics</guibutton>.
+          the Paint Dynamics selection dialog by clicking either the
+          <guibutton>Edit Dynamics</guibutton> button or the <guibutton>Create
+          a New Dynamics</guibutton> button.
         </para>
       </listitem>
     </itemizedlist>
-	  <para>
-		  You select the desirable behavior by clicking in the small squares. 
-			Clicking a second time unselect the marking. 
-		</para>		
+    <para>
+      You select the desirable behavior by clicking in the small squares.
+      Clicking a second time unselects the marking.
+    </para>
     <note>
       <para>
-        If you open a dynamics in the edit dialog it is usually grayed out 
-				meaning you are not allowed to change the settings. To edit the 
-				options you have to work on a copy made from one of the preinstalled 
-				dynamics or create a new dynamics.
+        Pre-installed dynamics are grayed out meaning you are not allowed to
+        change the settings. To edit the options you have to work on a copy
+        made from one of the pre-installed dynamics or create a new dynamics.
       </para>
     </note>
-		
-	</sect3>
-	<sect3>
-		<title>The Paint Dynamics Matrix</title>
-		<para>
-      The main part of the edit dialog is a table where you can decide 
-			which brush parameters should be affected by the way you use the stylus or the 
-			mouse. You may enable as many parameters and parameter combinations as you wish
-			but usually the fewer the better.
+  </sect3>
+  
+  <sect3>
+    <title>Mapping Matrix</title>
+    <indexterm>
+    <primary>Tools</primary>
+    <secondary>Mapping Matrix</secondary>
+    </indexterm>
+    <indexterm>
+      <primary>Mapping Matrix</primary>
+    </indexterm>
+    <para>
+      The main part of the edit dialog is a table where you can decide
+      which brush parameters should be affected by the way you use the stylus
+      or the mouse. You can enable as many parameters and parameter
+      combinations you want, but usually the fewer the better.
     </para>
-		
-		<itemizedlist>
-		  <para>
-			  Each column in the table represents a stylus or mouse action except the 
-				random and the fade functions.
-			</para>
+
+    <itemizedlist>
+      <para>
+        Each column in the table represents a stylus or mouse action except for 
+        the random and the fade functions.
+      </para>
       <listitem>
         <para>
-          <guilabel>Pressure</guilabel>: This is only meaningful if you are
-					using a graphic tablet. It allows you to decide which aspects of the
-					tool's action should be affected by the press of the stylus
-					against the tablet.
+          <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.
         </para>
-      </listitem>		
+      </listitem>
       <listitem>
         <para>
-          <guilabel>Velocity</guilabel>: This is the speed of the stylus or the 
-					mouse. 
+          <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). This is the
+          speed of the stylus or the mouse.
         </para>
       </listitem>
       <listitem>
         <para>
-          <guilabel>Direction</guilabel>: This is the direction of the stylus or the mouse.
+          <guilabel>Direction</guilabel>: (Graphic tablet, mouse). This is the
+          moving direction of the stylus or the mouse.
         </para>
       </listitem>
       <listitem>
         <para>
-          <guilabel>Tilt</guilabel>: This is only meaningful if you are using a 
-					graphic tablet. The behavior of the function depends on the tilting
-					of the stylus.
+          <guilabel>Tilt</guilabel>: (Graphic tablet). The behavior of the
+          function depends on the tilting of the stylus.
         </para>
-      </listitem>	
+      </listitem>
       <listitem>
         <para>
-          <guilabel>Wheel</guilabel>: This is only meaningful if you are using a 
-					graphic tablet. The output depends on the rotation of the stylus or 
-					the setting of the wheel on the airbrush pen.
+          <guilabel>Wheel</guilabel>: (Graphic tablet). 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>: The selected option will change at random. 
+          <guilabel>Random</guilabel>: (Graphic tablet, mouse). The selected
+          option will change at random.
         </para>
       </listitem>
       <listitem>
         <para>
-          <guilabel>Fade</guilabel>: The selected option will be faded in or out 
-					depending on the settings of the fade options in the Dynamic Options
-					menu.
+          <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.
         </para>
-      </listitem>			
+      </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 connection.
+    <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
+      connection.
     </para>
-		<variablelist>
+    <variablelist>
       <varlistentry>
         <term>Opacity</term>
         <listitem>
-					<para>
-            <guilabel>Pressure</guilabel>: Press harder to make the drawing less transparent.
-					</para>	
-					<para>
-						<guilabel>Velocity</guilabel>: The opacity decrease as the speed of the 
-						stylus increase. 
-					</para>
-					<para>
-						<guilabel>Direction</guilabel>: 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>: The opacity depends on the tilt of the stylus.
-					</para>
-					<para>
-						<guilabel>Wheel</guilabel>: TO DO 
-					</para>
-					<para>
-						<guilabel>Random</guilabel>: The opacity change at random in the interval set by the 
-						opacity slider in the tool options dialog. 
-					</para>
-					<para>
-						<guilabel>Fade</guilabel>: Starting with full transparency and ending with the
-						opacity set by the opacity slider in the tool options dialog.
-					</para>
+          <para>
+            <guilabel>Pressure</guilabel>: (Graphic tablet). 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.
+          </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.
+          </para>
+          <para>
+            <guilabel>Tilt</guilabel>: (Graphic tablet). The opacity depends
+            on the tilt of the stylus.
+          </para>
+          <para>
+            <guilabel>Wheel</guilabel>: (Graphic tablet). 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.
+          </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.
+          </para>
         </listitem>
       </varlistentry>
-			
+
       <varlistentry>
         <term>Size</term>
-				<listitem>
-					<para>
-            <guilabel>Pressure</guilabel>: Press harder to make the brush wider.
-					</para>	
-					<para>
-						<guilabel>Velocity</guilabel>: Increasing speed decrease the width of the brush. 
-					</para>
-					<para>
-						<guilabel>Direction</guilabel>: The size of the brush 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>: The size of the brush depends on the tilt of the stylus.
-					</para>
-					<para>
-						<guilabel>Wheel</guilabel>:  
-					</para>
-					<para>
-						<guilabel>Random</guilabel>: The size of the brush change at random up to the size  
-						set in the brush size slider in the tool options dialog. 
-					</para>
-					<para>
-						<guilabel>Fade</guilabel>: Fades from a narrow brush to the size set in the brush
-						size slider in the tool options dialog.
-					</para>
+        <listitem>
+          <para>
+            <guilabel>Pressure</guilabel>: (Graphic tablet). Press harder to
+            make the brush wider.
+          </para>
+          <para>
+            <guilabel>Velocity</guilabel>: (Graphic tablet, 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.
+          </para>
+          <para>
+            <guilabel>Tilt</guilabel>: (Graphic tablet). The size of the brush
+            depends on the tilt of the stylus.
+          </para>
+          <para>
+            <guilabel>Wheel</guilabel>: (Graphic tablet). 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.
+          </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.
+          </para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term>Angle</term>
-				<listitem>
-					<para>
-            TO DO 
-					</para>						
-        </listitem>				
+        <listitem>
+          <para>
+            TO DO
+          </para>
+        </listitem>
       </varlistentry>
 
       <varlistentry>
         <term>Color</term>
-				<listitem>
-					<para>
-						By default the color is picked from the foreground color in the toolbox.
-						However, if the color is activated in the dynamics editor, the 
-						color is instead collected from the active gradient.
-					</para>
-
-					<para>
-						<guilabel>Velocity</guilabel>: 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>: The direction determine where on the gradient the 
-						color is picked from. The effect seems to have work a bit on random.  
-					</para>
+        <listitem>
+          <para>
+            By default the color is picked from the foreground color in the
+            toolbox. However, if the color is activated in the dynamics
+            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.
+          </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.
+          </para>
 
-					<para>
-						<guilabel>Random</guilabel>: The color is picked at random from the gradient. 
-					</para>
-					<para>
-						<guilabel>Fade</guilabel>: 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>
+          <para>
+            <guilabel>Random</guilabel>: (Graphic tablet, 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.
+          </para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
-				<term>Hardness</term>
-				<listitem>
-					<para>
-						The hardness option is useful only for fuzzy brushes.
-					</para>				
-
-					<para>
-						<guilabel>Velocity</guilabel>: At slow speed the brush is hard and become more fuzzy 
-						as the speed increase. 
-					</para>
+        <term>Hardness</term>
+        <listitem>
+          <para>
+            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.
+          </para>
 
-					<para>
-						<guilabel>Random</guilabel>: The fussiness of the brush varies at random.  
-					</para>
-					<para>
-						<guilabel>Fade</guilabel>: 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>					
+          <para>
+          <guilabel>Random</guilabel>: (Graphic tablet, mouse). The fuzziness
+          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.
+          </para>
+        </listitem>
       </varlistentry>
-			
+
       <varlistentry>
         <term>Force</term>
         <listitem>
@@ -364,169 +388,183 @@
 
       <varlistentry>
         <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 only the 
-						height of the brush will vary.
-					</para>				
-	
-					<para>
-						<guilabel>Velocity</guilabel>: The aspect ratio of the brush (width / height) 
-						varies with the speed.
-					</para>
-					<para>
-						<guilabel>Direction</guilabel>: 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>
+        <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.
+          </para>
 
-					<para>
-						<guilabel>Random</guilabel>: The aspect ratio of the brush varies at random.   
-					</para>
-					<para>
-						<guilabel>Fade</guilabel>:  
-						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>				
+          <para>
+            <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). The aspect
+            ratio of the brush (width / height) varies with the speed.
+          </para>
+          <para>
+            <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The aspect
+            ratio of the brush varies with the moving direction of the brush.
+          </para>
+
+          <para>
+            <guilabel>Random</guilabel>: (Graphic tablet, 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.
+          </para>
+        </listitem>
       </varlistentry>
 
       <varlistentry>
-        <term>Spacing</term>				
-				<listitem>
-					<para>
-						Spacing is the distance between the marks set by the    
-						brush when drawing lines. This option determines if the spacing is affected 
-						and how, by the way the stylus is used.
-					</para>				
-	
-					<para>
-						<guilabel>Velocity</guilabel>: The spacing between the footprints of the brush 
-						increase with increasing speed.
-					</para>
-					<para>
-						<guilabel>Direction</guilabel>: The spacing varies with the moving direction 
-						of the brush. The effect seems to have a touch of randomness built in. 
-					</para>
+        <term>Spacing</term>
+        <listitem>
+          <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.
+          </para>
 
-					<para>
-						<guilabel>Random</guilabel>: The spacing varies at random.   
-					</para>
-					<para>
-						<guilabel>Fade</guilabel>:  
-						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>					
+          <para>
+            <guilabel>Velocity</guilabel>: (Graphic tablet, 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.
+          </para>
+
+          <para>
+            <guilabel>Random</guilabel>: (Graphic tablet, 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.
+          </para>
+        </listitem>
       </varlistentry>
 
       <varlistentry>
-        <term>Rate</term>				
-				<listitem>
-					<para>
-						This option applies to the Airbrush, Convolve tool, and
-						Smudge tool, all of which have time-based effects.
-					</para>				
-					<para>
-            TO DO
-					</para>	
-        </listitem>					
-      </varlistentry>	
-			
+        <term>Rate</term>
+        <listitem>
+          <para>
+            This option applies to the Airbrush, Convolve tool, and
+            Smudge tool, all of which have time-based effects.
+          </para>
+          <para>
+            The actions of these tools are more or less quick. The amount
+            of Rate depends on the setting of the Rate slider in the Tool
+            Options dialog.
+          </para>
+        </listitem>
+      </varlistentry>
+
       <varlistentry>
-        <term>Flow</term>			
-				<listitem>
-					<para>
-            TO DO
-					</para>	
+        <term>Flow</term>
+        <listitem>
+          <para>
+            Significant only for the Airbrush: more or less paint is delivered.
+            The amount of flow depends on the setting of the Flow slider in the
+            Tool Options dialog.
+          </para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
-        <term>Jitter</term>			
-				<listitem>
-					<para>
-						Normally the brush draw a line by printing the brush marks close together. 
-						Adding jitter means that the brush prints are scattered along the line. The
-						amount of scattering depends on the setting of the jitter slider in the tool 
-						options dialog window.
-					</para>				
-					<para>
-            <guilabel>Pressure</guilabel>: 
-					</para>	
-					<para>
-						<guilabel>Velocity</guilabel>: 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>: The jitter effect depends on the direction of the brush. The effect seems to have a touch of randomness built in. 
-					</para>
+        <term>Jitter</term>
+        <listitem>
+          <para>
+            Normally the brush draws a line by printing the brush marks close
+            together. Adding jitter means that the brush prints are scattered
+            along the line. The amount of scattering depends on the setting
+            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.
+          </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.
+          </para>
+          <para>
+            <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The
+            jitter effect depends on the moving direction of the brush.
+          </para>
+          <para>
+            <guilabel>Random</guilabel>: (Graphic tablet, 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.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
 
-					<para>
-						<guilabel>Random</guilabel>: The jitter varies at random.   
-					</para>
-					<para>
-						<guilabel>Fade</guilabel>:  
-						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>			
-		</variablelist>		
-	</sect3>
-	
-	<sect3>
-		<title>Fine Tuning the Dynamics</title>
-		<figure>
+  <sect3>
+    <title>Fine Tuning the Dynamics</title>
+    <figure>
       <title>Fine Tuning the Dynamics</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/paint-dynamics-tuning.png" format="PNG"/>
         </imageobject>
       </mediaobject>
-    </figure>		
-		<para>
-			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 what option to change.
-		</para>
-		
-		<figure>
+    </figure>
+    <para>
+      If the current options does not suit 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.
+    </para>
+
+    <figure>
       <title>The Fine Tuning Curve</title>
       <mediaobject>
         <imageobject>
           <imagedata fileref="images/toolbox/paint-dynamics-tuning-color.png" format="PNG"/>
         </imageobject>
       </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 behaviour of the chosen parameters
-			selected in the lower part of the dialog.		
-		</para>
-	</sect3>
-	
-<!-- ****** Dynamic Options: ****** -->	
-	
-	<sect3 id="gimp-tool-dynamic-options">
-		<title>Dynamics Options</title>
-		
-		<indexterm>
-			<primary>Tools</primary>
-			<secondary>Dynamics Options</secondary>
-		</indexterm>
-		<indexterm>
-			<primary>Dynamics Options</primary>
-		</indexterm>
-	
-		<figure>
+    </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.
+    </para>
+  </sect3>
+
+<!-- ****** Dynamic Options: ****** -->
+
+  <sect3 id="gimp-tool-dynamic-options">
+    <title>Dynamics Options</title>
+
+    <indexterm>
+      <primary>Tools</primary>
+      <secondary>Dynamics Options</secondary>
+    </indexterm>
+    <indexterm>
+      <primary>Dynamics Options</primary>
+    </indexterm>
+
+    <figure>
       <title>Dynamics Options</title>
       <mediaobject>
         <imageobject>
@@ -534,41 +572,41 @@
         </imageobject>
       </mediaobject>
     </figure>
-		<para>
-			Many of the dynamics behaviours also depends on the settings of the 
-			Dynamics Options in the tool options dialog and vice versa. For example
-			will the fading not work if it is not applied in the Dynamics section.
-		</para>
-		<variablelist>
+    <para>
+      Many of the dynamics behaviors also depends on the settings of the
+      Dynamics Options in the Tool Options dialog and vice versa. For example
+      the fading will not work if it is not applied in the Dynamics section.
+    </para>
+    <variablelist>
       <varlistentry>
         <term>Fade Options</term>
         <listitem>
           <para>
-            This slider determinds the length of the fading. What will
-            actually happen depends on the setting of the Dynamic. If 
-						set to act on the color for example, the color will be taken from 
-						the current gradient starting from the left side of the gradient and 
-						moving toward the right side of the gradient.
-          </para>
-					<para>
-						The Fade Options has a drop down list determining how the
-						fading is repeated.  
-					</para>					
-					<figure>
-						<title>
-						  Illustration of the effects of the three gradient-repeat
+            This slider determines the length of the fading. What will
+            actually happen depends on the setting of the Dynamic. If
+            set to act on the color for example, the color will be taken from
+            the current gradient starting from the left side of the gradient
+            and moving toward the right side of the gradient.
+          </para>
+          <para>
+            The Fade Options has a drop down list determining how the
+            fading is repeated.
+          </para>
+          <figure>
+            <title>
+              Illustration of the effects of the three gradient-repeat
               options, for the <guilabel>Abstract 2</guilabel> gradient.
-						</title>
-						<mediaobject>
-							<imageobject>
-								<imagedata format="PNG"
-									fileref="images/tool-options/brush-gradient-normal.png"/>
-							</imageobject>
-							<caption>
+            </title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/tool-options/brush-gradient-normal.png"/>
+              </imageobject>
+              <caption>
                   <para>Abstract2 Gradient</para>
               </caption>
-						</mediaobject>
-						<mediaobject>
+            </mediaobject>
+            <mediaobject>
               <imageobject>
                 <imagedata format="PNG"
                   fileref="images/tool-options/brush-gradient-none.png"/>
@@ -585,7 +623,7 @@
                 <caption>
                   <para>Sawtooth</para>
                 </caption>
-            </mediaobject>						
+            </mediaobject>
             <mediaobject>
               <imageobject>
                 <imagedata format="PNG"
@@ -594,9 +632,9 @@
                 <caption>
                   <para>Triangular</para>
                 </caption>
-            </mediaobject>						
-					</figure>
-					<para>
+            </mediaobject>
+          </figure>
+          <para>
             This option determines what happens if a brush stroke extends
             farther than the Length specified by the slider. There are three
             possibilities:
@@ -623,24 +661,26 @@
                 back and forth until the end of the brush stroke.
               </para>
             </listitem>
-          </itemizedlist>					
+          </itemizedlist>
         </listitem>
-			</varlistentry>
-			<varlistentry>
+      </varlistentry>
+      <varlistentry>
         <term>Color Options</term>
         <listitem>
           <para>
-            Here you may choose which gradient to use as the color source when using the 
-						brush with the color option set. Click on the box showing the gradient to 
-						change to another one from the gradient list. 
+            Here you can choose the gradient to use as color source
+            when using the brush with the color option set. Click on the box
+            showing the gradient to change to another one from the gradient
+            list.
           </para>
-					<para>
-					  If none of the color options are selected, the brush will use the
-						foreground color set in the toolbox.
-					</para>
-        </listitem>				
-			</varlistentry>	
+          <para>
+            If no color option is selected in the currently used
+            dynamics, the brush will use the foreground color set in the
+            toolbox.
+          </para>
+        </listitem>
+      </varlistentry>
 
-		</variablelist>			
-	</sect3>
+    </variablelist>
+  </sect3>
 </sect2>



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