[gimp-help-2] Added some fetures to the dynamics.xml
- From: KolbjÃrn StuestÃl <kolbjoern src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Added some fetures to the dynamics.xml
- Date: Mon, 29 Oct 2012 17:43:24 +0000 (UTC)
commit a298a1c212234b77f30d761d7808144f83bca496
Author: kolbjoern <kolbjoern git gnome org>
Date: Mon Oct 29 18:42:53 2012 +0100
Added some fetures to the dynamics.xml
.../dynamic-fade-example-curve-color-fade.png | Bin 0 -> 8496 bytes
images/C/toolbox/dynamic-fade-example-curve.png | Bin 0 -> 7969 bytes
images/C/toolbox/dynamic-fade-example.png | Bin 0 -> 10780 bytes
src/toolbox/paint/dynamics.xml | 235 +++++++++++++-------
4 files changed, 149 insertions(+), 86 deletions(-)
---
diff --git a/images/C/toolbox/dynamic-fade-example-curve-color-fade.png b/images/C/toolbox/dynamic-fade-example-curve-color-fade.png
new file mode 100755
index 0000000..d5f9300
Binary files /dev/null and b/images/C/toolbox/dynamic-fade-example-curve-color-fade.png differ
diff --git a/images/C/toolbox/dynamic-fade-example-curve.png b/images/C/toolbox/dynamic-fade-example-curve.png
new file mode 100755
index 0000000..fbea15b
Binary files /dev/null and b/images/C/toolbox/dynamic-fade-example-curve.png differ
diff --git a/images/C/toolbox/dynamic-fade-example.png b/images/C/toolbox/dynamic-fade-example.png
new file mode 100755
index 0000000..3747481
Binary files /dev/null and b/images/C/toolbox/dynamic-fade-example.png differ
diff --git a/src/toolbox/paint/dynamics.xml b/src/toolbox/paint/dynamics.xml
index 07a043b..9b682c9 100755
--- a/src/toolbox/paint/dynamics.xml
+++ b/src/toolbox/paint/dynamics.xml
@@ -183,47 +183,46 @@
</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 should be affected by the press of the
+ stylus against the tablet.
</para>
</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 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>
<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.
</para>
</listitem>
</itemizedlist>
@@ -239,31 +238,33 @@
<term>Opacity</term>
<listitem>
<para>
- <guilabel>Pressure</guilabel>: Press harder to make the drawing less transparent.
+ <guilabel>Pressure</guilabel>: (Graphic tablet). Press harder to make
+ the drawing less transparent.
</para>
<para>
- <guilabel>Velocity</guilabel>: The opacity decrease as the speed
- of the stylus increase.
+ <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). 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.
+ <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>: The opacity depends on the tilt of the
- stylus.
+ <guilabel>Tilt</guilabel>: (Graphic tablet). The opacity depends on the
+ tilt of the stylus.
</para>
<para>
- <guilabel>Wheel</guilabel>: TO DO
+ <guilabel>Wheel</guilabel>: (Graphic tablet). TO DO
</para>
<para>
- <guilabel>Random</guilabel>: The opacity change at random in the interval set by the
- opacity slider in the toolbox.
+ <guilabel>Random</guilabel>: (Graphic tablet, mouse). The opacity change
+ at random in the interval set by the opacity slider in the toolbox.
</para>
<para>
- <guilabel>Fade</guilabel>: Starting with full transparency and ending with the
- opacity set by the opacity slider in the toolbox.
+ <guilabel>Fade</guilabel>: (Graphic tablet, mouse). Starting with full
+ transparency and ending with the opacity set by the opacity slider in
+ the toolbox.
</para>
</listitem>
</varlistentry>
@@ -272,31 +273,32 @@
<term>Size</term>
<listitem>
<para>
- <guilabel>Pressure</guilabel>: Press harder to make the brush
- wider.
+ <guilabel>Pressure</guilabel>: (Graphic tablet). Press harder to make the
+ brush wider.
</para>
<para>
- <guilabel>Velocity</guilabel>: Increasing speed decrease the
- width of the brush.
+ <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). 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.
+ <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.
</para>
<para>
- <guilabel>Tilt</guilabel>: The size of the brush depends on the tilt of the stylus.
+ <guilabel>Tilt</guilabel>: (Graphic tablet). The size of the brush depends
+ on the tilt of the stylus.
</para>
<para>
- <guilabel>Wheel</guilabel>:
+ <guilabel>Wheel</guilabel>: (Graphic tablet). TO DO
</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 toolbox.
+ <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.
</para>
<para>
- <guilabel>Fade</guilabel>: Fades from a narrow brush to the size set in the brush
- size slider in the toolbox.
+ <guilabel>Fade</guilabel>: (Graphic tablet, mouse). Fades from a narrow
+ brush to the size set in the brush size slider in the toolbox.
</para>
</listitem>
</varlistentry>
@@ -320,28 +322,28 @@
</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.
+ <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.
</para>
<para>
- <guilabel>Direction</guilabel>: 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>: (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.
</para>
<para>
- <guilabel>Random</guilabel>: The color is picked at random from
- the gradient.
+ <guilabel>Random</guilabel>: (Graphic tablet, mouse). 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 toolbox.
+ <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.
</para>
</listitem>
</varlistentry>
@@ -354,18 +356,18 @@
</para>
<para>
- <guilabel>Velocity</guilabel>: At slow speed the brush is hard
- and become more fuzzy as the speed increase.
+ <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). At slow speed
+ the brush is hard and become more fuzzy as the speed increase.
</para>
<para>
- <guilabel>Random</guilabel>: The fussiness of the brush varies at
- random.
+ <guilabel>Random</guilabel>: (Graphic tablet, mouse). The fuzziness 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 toolbox.
+ <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.
</para>
</listitem>
</varlistentry>
@@ -392,20 +394,20 @@
</para>
<para>
- <guilabel>Velocity</guilabel>: The aspect ratio of the brush
- (width / height) varies with the speed.
+ <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). The aspect
+ ratio of the brush varies with the speed.
</para>
<para>
- <guilabel>Direction</guilabel>: The aspect ratio of the brush
- varies with the moving direction of the brush.
+ <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>: The aspect ratio of the brush varies
- at random.
+ <guilabel>Random</guilabel>: (Graphic tablet, mouse). The aspect
+ ratio of the brush varies at random.
</para>
<para>
- <guilabel>Fade</guilabel>:
+ <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
@@ -426,19 +428,21 @@
</para>
<para>
- <guilabel>Velocity</guilabel>: The spacing between the footprints
- of the brush increase with increasing speed.
+ <guilabel>Velocity</guilabel>: (Graphic tablet, mouse). 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.
+ <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The
+ spacing varies with the moving direction of the brush.
</para>
<para>
- <guilabel>Random</guilabel>: The spacing varies at random.
+ <guilabel>Random</guilabel>: (Graphic tablet, mouse). The
+ spacing varies at random.
</para>
<para>
- <guilabel>Fade</guilabel>:
+ <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.
@@ -478,23 +482,24 @@
of the jitter slider in the tool options dialog window.
</para>
<para>
- <guilabel>Pressure</guilabel>:
+ <guilabel>Pressure</guilabel>: (Graphic tablet). TO DO
</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.
+ <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.
</para>
<para>
- <guilabel>Direction</guilabel>: The jitter effect depends on the
- direction of the brush.
+ <guilabel>Direction</guilabel>: (Graphic tablet, mouse). The jitter
+ effect depends on the direction of the brush.
</para>
<para>
- <guilabel>Random</guilabel>: The jitter varies at random.
+ <guilabel>Random</guilabel>: (Graphic tablet, mouse). The jitter varies
+ at random.
</para>
<para>
- <guilabel>Fade</guilabel>:
+ <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.
@@ -542,6 +547,63 @@
<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: ****** -->
@@ -570,6 +632,7 @@
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>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
