[gimp-help-2] Some changes in dynamics.xml. (Marcos suggestions)
- From: KolbjÃrn StuestÃl <kolbjoern src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Some changes in dynamics.xml. (Marcos suggestions)
- Date: Thu, 1 Nov 2012 21:55:58 +0000 (UTC)
commit d1fbd8ae3007531b703a0446631d3587c7dad06b
Author: kolbjoern <kolbjoern git gnome org>
Date: Thu Nov 1 22:55:32 2012 +0100
Some changes in dynamics.xml. (Marcos suggestions)
src/toolbox/paint/dynamics.xml | 356 +++++++++++++++-------------------------
1 files changed, 130 insertions(+), 226 deletions(-)
---
diff --git a/src/toolbox/paint/dynamics.xml b/src/toolbox/paint/dynamics.xml
index 1617596..74ee023 100755
--- a/src/toolbox/paint/dynamics.xml
+++ b/src/toolbox/paint/dynamics.xml
@@ -17,14 +17,18 @@
<para>
The dynamics apply a more <quote>real feeling</quote> to the brush by
- 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.
+ 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.
</para>
+ <para>
+ The dynamics will make some of the behaviours of the drawing tools act more
+ like the physical (<quote>real</quote>) tools.
+ </para>
<figure>
<title>Dynamics in Tool Options </title>
@@ -36,7 +40,7 @@
</figure>
<para>
- The Dynamics area in the tools option dialog shows from left to right, the
+ 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
@@ -58,7 +62,7 @@
</mediaobject>
</figure>
<para>
- The paint dynamics dialog window can be opened
+ The paint dynamics dialog can be opened
</para>
<itemizedlist>
<listitem>
@@ -162,13 +166,6 @@
</sect3>
<sect3>
<title>The Paint Dynamics Matrix</title>
- <indexterm>
- <primary>Tools</primary>
- <secondary>Dynamics Matrix</secondary>
- </indexterm>
- <indexterm>
- <primary>Dynamics 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
@@ -178,93 +175,89 @@
<itemizedlist>
<para>
- Each column in the table represents a stylus or mouse action except
- the random and the fade functions.
+ Each column in the table represents a stylus or mouse action except the
+ random and the fade functions.
</para>
<listitem>
<para>
- <guilabel>Pressure</guilabel>: (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>: 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.
</para>
</listitem>
<listitem>
<para>
- <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). This is the speed
- of the stylus or the mouse.
+ <guilabel>Velocity</guilabel>: This is the speed of the stylus or the
+ mouse.
</para>
</listitem>
<listitem>
<para>
- <guilabel>Direction</guilabel>: (Graphic tablet, mouse). This is the direction
- of the stylus or the mouse.
+ <guilabel>Direction</guilabel>: This is the direction of the stylus or the mouse.
</para>
</listitem>
<listitem>
<para>
- <guilabel>Tilt</guilabel>: (Graphic tablet). The behavior of the function
- depends on the tilting of the stylus.
+ <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.
</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>: 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.
</para>
</listitem>
<listitem>
<para>
- <guilabel>Random</guilabel>: (Graphic tablet, mouse). The selected option
- will change at random.
+ <guilabel>Random</guilabel>: 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.
+ <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.
</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
- connection.
+ 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>
<varlistentry>
<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
- decrease as the speed of the stylus increase.
+ <guilabel>Velocity</guilabel>: The opacity decrease as the speed of the
+ stylus increase.
</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>: 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 change
- at random in the interval set by the opacity slider in the toolbox.
+ <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>: (Graphic tablet, mouse). Starting with full
- transparency and ending with the opacity set by the opacity slider in
- the toolbox.
+ <guilabel>Fade</guilabel>: Starting with full transparency and ending with the
+ opacity set by the opacity slider in the tool options dialog.
</para>
</listitem>
</varlistentry>
@@ -273,32 +266,28 @@
<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
- decrease the width of the brush.
+ <guilabel>Velocity</guilabel>: Increasing speed decrease the width of the brush.
</para>
<para>
- <guilabel>Direction</guilabel>: (Graphic tablet, mouse). 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.
+ <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>: (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). TO DO
+ <guilabel>Wheel</guilabel>:
</para>
<para>
- <guilabel>Random</guilabel>: (Graphic tablet, mouse). The size of the brush
- change at random up to the size set in the brush size slider in the toolbox.
+ <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>: (Graphic tablet, mouse). Fades from a narrow
- brush to the size set in the brush size slider in the toolbox.
+ <guilabel>Fade</guilabel>: Fades from a narrow brush to the size set in the brush
+ size slider in the tool options dialog.
</para>
</listitem>
</varlistentry>
@@ -316,34 +305,28 @@
<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.
+ 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
- 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.
+ <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>: (Graphic tablet, mouse). The
- direction determine 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>: The direction determine where on the gradient the
+ color is picked from. The effect seems to have 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>: 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 in the toolbox.
+ <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>
</listitem>
</varlistentry>
@@ -356,18 +339,16 @@
</para>
<para>
- <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). At slow speed
- the brush is hard and become more fuzzy as the speed increase.
+ <guilabel>Velocity</guilabel>: 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>: The fussiness of the brush varies at random.
</para>
<para>
- <guilabel>Fade</guilabel>: (Graphic tablet, mouse). The brush become
- less fuzzy during the stroke. The behavior of the fading is set in the
- fade options in the toolbox.
+ <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>
</varlistentry>
@@ -385,35 +366,32 @@
<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 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>: (Graphic tablet, mouse). The aspect
- ratio of the brush varies with the speed.
+ <guilabel>Velocity</guilabel>: 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.
+ <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>
<para>
- <guilabel>Random</guilabel>: (Graphic tablet, mouse). The aspect
- ratio of the brush varies at random.
+ <guilabel>Random</guilabel>: 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>:
+ 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>
@@ -422,30 +400,27 @@
<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 the stylus is used.
+ 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>: (Graphic tablet, mouse). The
- spacing between the footprints of the brush increase with
- increasing speed.
+ <guilabel>Velocity</guilabel>: The spacing between the footprints of the brush
+ increase with increasing speed.
</para>
<para>
- <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The
- spacing varies with the moving direction of the brush.
+ <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>
<para>
- <guilabel>Random</guilabel>: (Graphic tablet, mouse). The
- spacing varies at random.
+ <guilabel>Random</guilabel>: The spacing varies at random.
</para>
<para>
- <guilabel>Fade</guilabel>: (Graphic tablet, 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 toolbox.
+ <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>
</varlistentry>
@@ -454,7 +429,7 @@
<term>Rate</term>
<listitem>
<para>
- This option applies to the Airbrush, Convolve tool, and
+ This option applies to the Airbrush, Convolve tool, and
Smudge tool, all of which have time-based effects.
</para>
<para>
@@ -476,33 +451,31 @@
<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.
+ 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>: (Graphic tablet). TO DO
+ <guilabel>Pressure</guilabel>:
</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 increase the scattering amount decrease.
+ <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>: (Graphic tablet, mouse). The jitter
- effect depends on the direction of the brush.
+ <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>
<para>
- <guilabel>Random</guilabel>: (Graphic tablet, mouse). The jitter varies
- at random.
+ <guilabel>Random</guilabel>: 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 toolbox.
+ <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>
@@ -520,9 +493,9 @@
</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.
+ 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>
@@ -534,76 +507,10 @@
</mediaobject>
</figure>
<para>
- Click on one of the options to open the fine tuning dialog.
+ Click on one of the options to open the fin 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>
- <para>
- On top of the dialog you find the name of the dynamics. Below this
- there is a drop down list where you can select what option to edit.
- </para>
- <para>
- The fine tuning is done by moving the curve by grabbing it by the
- mouse pointer the usual way.
- </para>
- <para>
- Downmost there is a list where you mark what action to be tuned.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>Dynamics Examples</term>
- <listitem>
- <para>
- A few brief examples on how to use dynamics settings.
- </para>
- <figure>
- <title>
- Illustration of the effects of changing the dynamics settings.
- </title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/dynamic-fade-example.png"/>
- </imageobject>
- </mediaobject>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/dynamic-fade-example-curve.png"/>
- </imageobject>
- </mediaobject>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/dynamic-fade-example-curve-color-fade.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- In these examples the foreground color is set to blue (#0000ff) and the background color to yellow (#ffff00). Fading: 200 pixels. Paintbrush size: 72.
- </para>
- <para>
- Example 1 shows the result when the brush size is connected to the fading. Default options. The brush fades gently from near zero to the full width set
- by the brush sliders.
- </para>
- <para>
- In example 2 the same settings as in the prior example, but the fade curve is set as in image 5. The brush width fades from zero to full width and then
- back again to zero.
- </para>
- <para>
- In example 3 the settings are the same as in example 2 except that now also
- color is connected to the fade option. The color is picked from the active
- gradient, starting at the left side of the gradient and ending at the right
- side of the gradient.
- </para>
- <para>
- In example 4 the the setting of the color curve is as showed in image 6. No other changes. At the start of the stroke the color is picked from the left
- side of the gradient, then more from the right side, fading back to the left
- side and at the end of the fading from the rightmost side of the gradient.
- Study the curve and compare it to the stroke.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
</sect3>
<!-- ****** Dynamic Options: ****** -->
@@ -629,20 +536,19 @@
</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
+ 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>
<varlistentry>
<term>Fade Options</term>
<listitem>
<para>
- This slider determinds the length of the fading. What will
+ 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.
+ 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
@@ -724,15 +630,13 @@
<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 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.
</para>
<para>
- If none of the color options are selected in the currently used
- dynamics, the brush will use the foreground color set in the
- toolbox.
+ If none of the color options are selected, the brush will use the
+ foreground color set in the toolbox.
</para>
</listitem>
</varlistentry>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
