[gimp-help-2] Update blend tool
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Update blend tool
- Date: Wed, 25 Apr 2018 16:48:49 +0000 (UTC)
commit 7da776e1e40a49e5647a467770770dc7b5c9d1f6
Author: Julien Hardelin <jhardlin orange fr>
Date: Wed Apr 25 18:48:05 2018 +0200
Update blend tool
images/C/tool-options/blend-repeat-none.png | Bin 0 -> 24436 bytes
images/C/tool-options/blend-repeat-sawtooth.png | Bin 0 -> 35764 bytes
images/C/tool-options/blend-repeat-triangular.png | Bin 0 -> 37874 bytes
images/C/tool-options/blend-repeat-truncate.png | Bin 0 -> 19457 bytes
images/C/toolbox/blend-endpoint-move.png | Bin 0 -> 40201 bytes
images/C/toolbox/blend-endpoint.png | Bin 0 -> 54632 bytes
images/C/toolbox/blend-icon1.png | Bin 0 -> 1262 bytes
images/C/toolbox/blend-icon2.png | Bin 0 -> 1349 bytes
images/C/toolbox/blend-midpoint-icon1.png | Bin 0 -> 1272 bytes
images/C/toolbox/blend-midpoint-icon2.png | Bin 0 -> 9254 bytes
images/C/toolbox/blend-midpoint.png | Bin 0 -> 56032 bytes
images/C/toolbox/blend-stop.png | Bin 0 -> 55916 bytes
images/C/toolbox/toolbox-gradient.png | Bin 10414 -> 21287 bytes
src/dialogs/gradient-editor-dialog.xml | 4 -
src/toolbox/paint/blend.xml | 338 ++++++++++++++++-----
15 files changed, 255 insertions(+), 87 deletions(-)
---
diff --git a/images/C/tool-options/blend-repeat-none.png b/images/C/tool-options/blend-repeat-none.png
new file mode 100644
index 0000000..d347720
Binary files /dev/null and b/images/C/tool-options/blend-repeat-none.png differ
diff --git a/images/C/tool-options/blend-repeat-sawtooth.png b/images/C/tool-options/blend-repeat-sawtooth.png
new file mode 100644
index 0000000..1745ea4
Binary files /dev/null and b/images/C/tool-options/blend-repeat-sawtooth.png differ
diff --git a/images/C/tool-options/blend-repeat-triangular.png
b/images/C/tool-options/blend-repeat-triangular.png
new file mode 100644
index 0000000..6d91c95
Binary files /dev/null and b/images/C/tool-options/blend-repeat-triangular.png differ
diff --git a/images/C/tool-options/blend-repeat-truncate.png b/images/C/tool-options/blend-repeat-truncate.png
new file mode 100644
index 0000000..0a3916d
Binary files /dev/null and b/images/C/tool-options/blend-repeat-truncate.png differ
diff --git a/images/C/toolbox/blend-endpoint-move.png b/images/C/toolbox/blend-endpoint-move.png
new file mode 100644
index 0000000..1db95f6
Binary files /dev/null and b/images/C/toolbox/blend-endpoint-move.png differ
diff --git a/images/C/toolbox/blend-endpoint.png b/images/C/toolbox/blend-endpoint.png
new file mode 100644
index 0000000..403dd3d
Binary files /dev/null and b/images/C/toolbox/blend-endpoint.png differ
diff --git a/images/C/toolbox/blend-icon1.png b/images/C/toolbox/blend-icon1.png
new file mode 100644
index 0000000..8319445
Binary files /dev/null and b/images/C/toolbox/blend-icon1.png differ
diff --git a/images/C/toolbox/blend-icon2.png b/images/C/toolbox/blend-icon2.png
new file mode 100644
index 0000000..af35604
Binary files /dev/null and b/images/C/toolbox/blend-icon2.png differ
diff --git a/images/C/toolbox/blend-midpoint-icon1.png b/images/C/toolbox/blend-midpoint-icon1.png
new file mode 100644
index 0000000..6f87c0f
Binary files /dev/null and b/images/C/toolbox/blend-midpoint-icon1.png differ
diff --git a/images/C/toolbox/blend-midpoint-icon2.png b/images/C/toolbox/blend-midpoint-icon2.png
new file mode 100644
index 0000000..cb5bcbc
Binary files /dev/null and b/images/C/toolbox/blend-midpoint-icon2.png differ
diff --git a/images/C/toolbox/blend-midpoint.png b/images/C/toolbox/blend-midpoint.png
new file mode 100644
index 0000000..7c979e3
Binary files /dev/null and b/images/C/toolbox/blend-midpoint.png differ
diff --git a/images/C/toolbox/blend-stop.png b/images/C/toolbox/blend-stop.png
new file mode 100644
index 0000000..f010bdd
Binary files /dev/null and b/images/C/toolbox/blend-stop.png differ
diff --git a/images/C/toolbox/toolbox-gradient.png b/images/C/toolbox/toolbox-gradient.png
index bbc2f90..035a86c 100644
Binary files a/images/C/toolbox/toolbox-gradient.png and b/images/C/toolbox/toolbox-gradient.png differ
diff --git a/src/dialogs/gradient-editor-dialog.xml b/src/dialogs/gradient-editor-dialog.xml
index 5bd77bd..11ad5fb 100644
--- a/src/dialogs/gradient-editor-dialog.xml
+++ b/src/dialogs/gradient-editor-dialog.xml
@@ -2,11 +2,7 @@
<!DOCTYPE sect3 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2013-03-29 j.h; added non-documented feature
- 2012-05-25 j.h: no change for 2.8
2009-04-04 j.h: fixed bug #577170
- 2008-02-22 j.h: added example for new gradient
- 2007-08-24 j.h: updated to v2.4
2006-04-30 lexa: made almost docbook compliant
2005-11-28 replaced informalfigures by figures by lexa
-->
diff --git a/src/toolbox/paint/blend.xml b/src/toolbox/paint/blend.xml
index d4271e2..10d4d92 100644
--- a/src/toolbox/paint/blend.xml
+++ b/src/toolbox/paint/blend.xml
@@ -2,7 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2007-04-30 j.h: update
+ 2018-04-05 j.h: update
-->
<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-blend">
<title>Blend</title>
@@ -18,27 +18,22 @@
<secondary>Blend</secondary>
</indexterm>
- <figure>
- <title>The Blend tool in Toolbox</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/toolbox-gradient.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
<para>
This tool fills the selected area with a gradient blend of the foreground
and background colors by default, but there are many options. To make a
- blend, drag the cursor in the direction you want the gradient to go, and
- release the mouse button when you feel you have the right position and
- size of your blend. The softness of the blend depends on how far you drag
- the cursor. The shorter the drag distance, the sharper it will be.
+ blend, drag the cursor in the direction you want the gradient to go and
+ you release the mouse button when you feel you have the right position
+ and size of your blend. The softness of the blend depends on how far you
+ drag the cursor. The shorter the drag distance, the sharper it will be.
</para>
<para>
- You can now click and drag outside the selection, and so, only a part of
- the gradient will appear in the selection.
+ In former GIMP versions, you had to use the gradient editor to modify the
+ gradient. With GIMP-2.10, this gradient editor still exists, but you can
+ now edit it more easily directly on canvas.
+ </para>
+ <para>
+ If you click and drag outside the selection, only a part of the gradient
+ will appear in the selection.
</para>
<para>
There are an astonishing number of things you can do with this tool, and
@@ -102,32 +97,18 @@
</listitem>
</itemizedlist>
</sect3>
-
- <sect3>
- <title>Key modifiers (Defaults)</title>
- <variablelist>
- <varlistentry>
- <term><keycap>Ctrl</keycap></term>
- <listitem>
- <para><keycap>Ctrl</keycap> is used to create straight lines that are
- constrained to 15 degree absolute angles.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </sect3>
+
<sect3>
<title>Options</title>
<figure>
- <title><quote>Blend</quote> tool options</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/blend-tool-options.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
+ <title>The Blend tool dialog</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/toolbox-gradient.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
<xi:include href="../about-common-options-display.xml"/>
<variablelist>
@@ -145,40 +126,17 @@
list. The tool causes a shading pattern that transitions from
foreground to background color or introduces others colors, in
the direction the user determines by drawing a line in the image.
- For the purposes of drawing the gradient, the
- <guilabel>Reverse</guilabel>
- <guiicon>
- <inlinegraphic
- fileref="images/dialogs/stock-flip-horizontal-16.png"/>
- </guiicon>
- checkbox reverses the gradient direction with the effect, for
- instance, of swapping the foreground and background colors.
+ For the purposes of drawing the gradient, clicking on the
+ <guibutton>Reverse</guibutton> reverses the gradient direction with
+ the effect, for instance, of swapping the foreground and background
+ colors.
</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Offset</term>
- <listitem>
<para>
- The <guilabel>Offset</guilabel> value permits to increase the
- <quote>slope</quote> of the gradient. It determines how far
- from the clicked starting point the gradient will begin.
- Shaped forms are not affected by this option.
+ On the right hand, a button to open the Gradient Editor dialog.
</para>
- <figure>
- <title><quote>Blend</quote> tool: Offset example</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/blend-tool-offset.png"/>
- </imageobject>
- <caption>
- <para>Top, Offset = 0 ; Bottom, Offset = 50%</para>
- </caption>
- </mediaobject>
- </figure>
</listitem>
</varlistentry>
+
<varlistentry>
<term>Shape</term>
<listitem>
@@ -396,15 +354,58 @@
<varlistentry>
<term>Repeat</term>
<listitem>
- <para>
- There are two repeat modes: <guilabel>Sawtooth Wave</guilabel>
- and <guilabel>Triangular Wave</guilabel>. The Sawtooth
- pattern is achieved by beginning with the foreground,
- transitioning to the background, then starting over with the
- foreground. The Triangular starts with the foreground,
- transitions to the background, then transitions back to the
- foreground.
- </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>None</guilabel> as default.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/tool-options/blend-repeat-none.png"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Sawtooth Wave</guilabel>: the Sawtooth pattern is
+ achieved by beginning with the foreground, transitioning to the
+ background, then starting over with the foreground.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/tool-options/blend-repeat-sawtooth.png"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Triangular Wave</guilabel>: starts with the
+ foreground, transitions to the background, then transitions
+back
+ to the foreground.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/tool-options/blend-repeat-triangular.png"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Truncate</guilabel>: areas before and after
+ endpoints are truncated.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/tool-options/blend-repeat-truncate.png"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+ </itemizedlist>
</listitem>
</varlistentry>
<varlistentry>
@@ -426,13 +427,184 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>Offset</term>
+ <listitem>
+ <para>
+ The <guilabel>Offset</guilabel> value permits to increase the
+ <quote>slope</quote> of the gradient. It determines how far
+ from the clicked starting point the gradient will begin.
+ Shaped forms are not affected by this option.
+ </para>
+ <figure>
+ <title><quote>Blend</quote> tool: Offset example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/blend-tool-offset.png"/>
+ </imageobject>
+ <caption>
+ <para>Top, Offset = 0 ; Bottom, Offset = 50%</para>
+ </caption>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Instant mode</term>
+ <listitem>
+ <para>
+ When this option is checked, blend tool works as in GIMP-2.8 : the
+ gradient line disappears as soon as you release the mouse button.
+ The option must be activated (with <keycap>Shift</keycap> also)
+ before starting drawing gradient.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Modify active gradient</term>
+ <listitem>
+ <para>
+ When this option is checked, blend tool works as in GIMP-2.8 : the
+ custom gradient is not created automatically and must be created
+ manually. The option can be activated before starting drawing
+ gradient or if the active gradient is not the custom gradient.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
- <note>
+ </sect3>
+ <sect3>
+ <title>Editing Gradient</title>
+ <variablelist>
<para>
- New feature in GIMP-2.10: when you have drawn the gradient, you can
- change its color by selecting a new foreground color in toolbox. It
- will be applied as soon to the gradient.
+ Important change with GIMP-2.10 in editing gradient:
</para>
- </note>
+ <varlistentry>
+ <term>On-canvas editing</term>
+ <listitem>
+ <para>
+ All the old Gradient Editor dialog features are now available
+ directly on canvas. You can create and delete color stops,
+ select and shift them, assign colors to color stops, change
+ blending and coloring for segments between color stops,
+ create color stops from midpoints.
+ </para>
+ <para>
+ Select a gradient in the gradient dialog. Click and drag
+ on canvas. A line is drawn and the gradient is displayed. You
+ can edit this gradient by moving the mouse pointer
+ on this line. As soon as you try to edit gradient, GIMP-2.10
+ creates a custom gradient, which is a copy of the selected
+ gradient. It becomes the active gradient and will be
+ preserved across sessions. Here, we use the Abstract3
+ gradient.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/blend-endpoint.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ The Abstract3 gradient, with endpoints
+ </para>
+ </caption>
+ </mediaobject>
+ <para>
+ At both ends of the line, you can see a <guilabel>Start
+ endpoint</guilabel> and an <guilabel>End endpoint</guilabel>. Click
+ and drag an endpoint (the mouse pointer is accompanied with a moving
+ cross) to move it where you want on your screen. A small window
+ appears showing data about the selected endpoint : the position of
+ the mouse (coordinate origin is the upper left corner of image or
+ selection), the starting (left) and the ending (right) color of
+ the gradient.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/blend-endpoint-move.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ End point moved
+ </para>
+ </caption>
+ </mediaobject>
+ <note>
+ <para>
+ In you only move endpoints, the custom gradient is not created
+ yet.
+ </para>
+ </note>
+ <para>
+ On the line, you can see several small squares. These are
+ <guilabel>Stop</guilabel>s that divide gradient into segments. You
+ can edit segments separately. Click and drag stops to move them
+ (the active endpoint takes a yellow color). As soon as you move a
+ stop, the custom gradient is created. The small data window shows a
+ button that allow you to remove the active stop.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/blend-stop.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ Stop point moved and data window
+ </para>
+ </caption>
+ </mediaobject>
+ <para>
+ If you move the mouse pointer on the line, a
+ <guilabel>Midpoint</guilabel> shows up. Then, the small data window
+ has two buttons : <guiicon><inlinegraphic
+ fileref="images/toolbox/blend-icon1.png"/></guiicon> to create
+ a new stop at midpoint, and <guiicon><inlinegraphic
+ fileref="images/toolbox/blend-icon2.png"/></guiicon> to center
+ midpoint.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/blend-midpoint.png"/>
+ </imageobject>
+ </mediaobject>
+ <para>
+ <emphasis role="bold">Changing color</emphasis>: in stop and
+ end data windows, you have color dwells with a drop-down list. The
+ default option is <guilabel>Fixed</guilabel>; this means that color
+ choice will be independent from foreground and background colors.
+ Click on a color dwell to open a color selector.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Key modifiers (Defaults)</term>
+ <listitem>
+ <para><keycap>Ctrl</keycap> is used to create straight lines that are
+ constrained to 15 degree absolute angles.
+ </para>
+ <para>
+ <keycap>Alt</keycap> or
+ <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap></keycombo> to
+ move the whole line.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>The Gradient Editor</term>
+ <listitem>
+ <para>
+ The Gradient Editor still exists:
+ <xref linkend="gimp-gradient-editor-dialog"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</sect3>
</sect2>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
