[gimp-help-2] Update smudge.xml
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Update smudge.xml
- Date: Sat, 5 Aug 2017 06:03:57 +0000 (UTC)
commit 052938b54a29fb30c5c9a9bf7f1fc33482e164a9
Author: Julien Hardelin <jhardlin orange fr>
Date: Sat Aug 5 08:03:29 2017 +0200
Update smudge.xml
.../MyPaint-brush-ex-base-opacity.xcf | Bin 60839 -> 60839 bytes
.../{ => xcf images}/MyPaint-brush-ex-hardness.xcf | Bin 106315 -> 106315 bytes
docs/xcf images/smudge-ex-noerasing.xcf | Bin 0 -> 450383 bytes
docs/xcf images/smudge-simpletest.xcf | Bin 0 -> 246235 bytes
docs/{ => xcf images}/warp-ex-abyss.xcf | Bin 101066 -> 101066 bytes
images/C/toolbox/smudge-ex-line.png | Bin 0 -> 3940 bytes
images/C/toolbox/smudge-ex-noerasing.jpg | Bin 0 -> 37477 bytes
images/C/toolbox/smudge-ex-rate.png | Bin 0 -> 16502 bytes
images/C/toolbox/smudge-options.png | Bin 0 -> 42211 bytes
images/C/toolbox/smudge-simpletest.jpg | Bin 0 -> 43263 bytes
images/C/toolbox/smudge-toolbox.png | Bin 0 -> 34773 bytes
images/C/toolbox/tool-options-smudge.png | Bin 6409 -> 0 bytes
src/toolbox/paint/common-features.xml | 47 +++++++-
src/toolbox/paint/smudge.xml | 136 +++++++++++++++++---
14 files changed, 163 insertions(+), 20 deletions(-)
---
diff --git a/docs/xcf images/smudge-ex-noerasing.xcf b/docs/xcf images/smudge-ex-noerasing.xcf
new file mode 100644
index 0000000..42fb7c9
Binary files /dev/null and b/docs/xcf images/smudge-ex-noerasing.xcf differ
diff --git a/docs/xcf images/smudge-simpletest.xcf b/docs/xcf images/smudge-simpletest.xcf
new file mode 100644
index 0000000..68e8a50
Binary files /dev/null and b/docs/xcf images/smudge-simpletest.xcf differ
diff --git a/images/C/toolbox/smudge-ex-line.png b/images/C/toolbox/smudge-ex-line.png
new file mode 100644
index 0000000..feae7c4
Binary files /dev/null and b/images/C/toolbox/smudge-ex-line.png differ
diff --git a/images/C/toolbox/smudge-ex-noerasing.jpg b/images/C/toolbox/smudge-ex-noerasing.jpg
new file mode 100644
index 0000000..744f8a3
Binary files /dev/null and b/images/C/toolbox/smudge-ex-noerasing.jpg differ
diff --git a/images/C/toolbox/smudge-ex-rate.png b/images/C/toolbox/smudge-ex-rate.png
new file mode 100644
index 0000000..d6041d5
Binary files /dev/null and b/images/C/toolbox/smudge-ex-rate.png differ
diff --git a/images/C/toolbox/smudge-options.png b/images/C/toolbox/smudge-options.png
new file mode 100644
index 0000000..e4caef3
Binary files /dev/null and b/images/C/toolbox/smudge-options.png differ
diff --git a/images/C/toolbox/smudge-simpletest.jpg b/images/C/toolbox/smudge-simpletest.jpg
new file mode 100644
index 0000000..c89b44f
Binary files /dev/null and b/images/C/toolbox/smudge-simpletest.jpg differ
diff --git a/images/C/toolbox/smudge-toolbox.png b/images/C/toolbox/smudge-toolbox.png
new file mode 100644
index 0000000..369d7fd
Binary files /dev/null and b/images/C/toolbox/smudge-toolbox.png differ
diff --git a/src/toolbox/paint/common-features.xml b/src/toolbox/paint/common-features.xml
index 03ebd3a..5d47eea 100644
--- a/src/toolbox/paint/common-features.xml
+++ b/src/toolbox/paint/common-features.xml
@@ -322,7 +322,34 @@
if the brush is not circular or made from a rotated figure.
</para>
</listitem>
- </varlistentry>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Spacing</term>
+ <listitem>
+ <para>
+ TODO
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Hardness</term>
+ <listitem>
+ <para>
+ TODO
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Force</term>
+ <listitem>
+ <para>
+ TODO
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry id="gimp-tool-brush-dynamics" xreflabel="Brush Dynamics">
<term>Dynamics</term>
@@ -435,6 +462,24 @@
</figure>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>Lock brush size to zoom</term>
+ <listitem>
+ <para>
+ TODO
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Hard edge</term>
+ <listitem>
+ <para>
+ TODO
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term>Incremental</term>
diff --git a/src/toolbox/paint/smudge.xml b/src/toolbox/paint/smudge.xml
index a7b5318..ae3fac8 100644
--- a/src/toolbox/paint/smudge.xml
+++ b/src/toolbox/paint/smudge.xml
@@ -2,14 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2009-03-18 j.h: reviewed for v2.6. No change ("scale" exists)
- 2008-01-06 j.h: updated to v2.4. Ctrl key modifier added
- 2007-06-17 kost: added norwegian
- 2006-07-15 added es content by mq
- 2006-05-01 added italian content by ciampix
- 2005-12-06 simplesect replaced by sect3 by lexa
- 2005-12-06 informalfigures replaced by figures by lexa
- 050523 de reviewed by axel.wernicke
+ 2017-07-30 j.h Update to v2.10
-->
<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-smudge">
<title>Smudge</title>
@@ -25,14 +18,30 @@
<title>Smudge tool</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/toolbox-smudge.png" format="PNG"/>
+ <imagedata fileref="images/toolbox/smudge-toolbox.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>
<para>
- The Smudge tool uses the current brush to smudge colors on the active
- layer or a selection. It takes color in passing and uses it to mix it to
- the next colors it meets, on a distance you can set.
+ The Smudge tool evokes finger painting . With GIMP-2.10, it works in two
+ ways:
+ <itemizedlist>
+ <listitem>
+ <para>
+ If the <guilabel>Flow</guilabel> option is set to 0.00 (default),
+ the Smudge tool uses the current brush to smudge colors on the
+ active layer or a selection. It takes color in passing and uses it to
+ mix it to the next colors it meets.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ When the <guilabel>Flow</guilabel> option is more than 0.00, the
+ Smudge tool works as a brush using the foreground color of the
+ toolbox and blend it with the underlying color.
+ </para>
+ </listitem>
+ </itemizedlist>
</para>
<sect3>
@@ -47,7 +56,7 @@
<menuchoice>
<guimenu>Tools</guimenu>
<guisubmenu>Paint Tools</guisubmenu>
- <guimenuitem>Smudge.</guimenuitem>
+ <guimenuitem>Smudge</guimenuitem>
</menuchoice>
in the image menu,
</para>
@@ -82,9 +91,23 @@
The <keycap>Shift</keycap> key places the smudge tool into
straight line mode. Holding <keycap>Shift</keycap> while clicking
the mouse <mousebutton>Left Button</mousebutton> will smudge
- in a straight line. Consecutive clicks will continue smudging in
- straight lines that originate from the end of the last line.
+ in a straight line. Consecutive clicks will continue smudging in
+ straight lines that originate from the end of the last line.
</para>
+ <figure>
+ <title>Smudge tool</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/smudge-ex-line.png"
+ format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ Shift click and drag to create line
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
</listitem>
</varlistentry>
<varlistentry>
@@ -105,11 +128,11 @@
<sect3>
<title>Options</title>
<figure>
- <title>The Smudge tool in Toolbox</title>
+ <title>Smudge Options</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
- fileref="images/toolbox/tool-options-smudge.png"/>
+ fileref="images/toolbox/smudge-options.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -119,13 +142,88 @@
<variablelist>
<varlistentry>
<term>
- Opacity; Brush; Dynamics; Dynamics Options; Fade Options;
- Apply Jitter; Hard Edge; Rate
+ Opacity; Brush; Size; Aspect ratio; Angle; Spacing;
+ Hardness; Force; Dynamics; Dynamics Options;
+ Apply Jitter; Smooth stroke; Lock brush size to zoom; Hard edge
</term>
<listitem>
<xi:include href="about-common-paint-options.xml"/>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>Rate</term>
+ <listitem>
+ <para>
+ This option could be called "Smudge length" since it sets the
+ length of the smudging effect in a stroke.
+ </para>
+ <figure>
+ <title>Rate example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/smudge-ex-rate.png"
+ format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ 1: Rate=20 2: Rate=60 3: Rate=90
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>No erasing effect</term>
+ <listitem>
+ <para>
+ If smudging will decrease alpha of some pixels; this alpha is not
+ decreased if this option is checked, and so pixels are not erased.
+ This is useful to fill a gap between two color areas.
+ </para>
+ <!--TRANSLATORS: a xcf file exists for this image at
+ https://git.gnome.org/browse/gimp-help-2/tree/docs-->
+ <figure>
+ <title>An example of "No erasing" from the programmer</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/smudge-ex-noerasing.jpg"
+ format="JPG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Flow</term>
+ <listitem>
+ <para>
+ We already saw the different behavior of the <quote>Flow</quote>
+ option when it is set to 0.00 (works as the original Smudge tool)
+ and set to more than 0.00 (uses the foreground color for smudging).
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
+
+ <para>
+ <quote>No erasing effect</quote> and <quote>Flow</quote> are new
+ options in GIMP-2.10. Here are comments and examples from the
+ programmer of these options in <ulink
+ url="https://www.gimp-forum.net/Thread-Customized-smudge-tool-Smudge-with-
+ painting">gimp-forum.net</ulink>:
+ </para>
+ <!--TRANSLATORS: a xcf file exists for this image at
+ https://git.gnome.org/browse/gimp-help-2/tree/docs-->
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/smudge-simpletest.jpg"
+ format="JPG"/>
+ </imageobject>
+ </mediaobject>
+
</sect3>
</sect2>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
