[gimp-help-2] Add symmetry-painting and draw mask
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Add symmetry-painting and draw mask
- Date: Sun, 7 May 2017 05:40:08 +0000 (UTC)
commit 65fd7abfc3647ee1788a90d5a7ffe3fba2aa2dfb
Author: Julien Hardelin <jhardlin orange fr>
Date: Sun May 7 07:39:25 2017 +0200
Add symmetry-painting and draw mask
docs/templates/dialog_template.xml | 26 ++--
images/C/dialogs/symmetry-mandala-ex1.png | Bin 0 -> 29698 bytes
images/C/dialogs/symmetry-mandala-ex2.png | Bin 0 -> 53282 bytes
images/C/dialogs/symmetry-mandala.png | Bin 0 -> 14051 bytes
images/C/dialogs/symmetry-mirror-ex1.png | Bin 0 -> 11034 bytes
images/C/dialogs/symmetry-mirror-ex2.png | Bin 0 -> 48715 bytes
images/C/dialogs/symmetry-mirror.png | Bin 0 -> 14447 bytes
images/C/dialogs/symmetry-painting.png | Bin 0 -> 14013 bytes
images/C/dialogs/symmetry-tiling-ex1.png | Bin 0 -> 16635 bytes
images/C/dialogs/symmetry-tiling-ex2.png | Bin 0 -> 28327 bytes
images/C/dialogs/symmetry-tiling.png | Bin 0 -> 14714 bytes
images/C/dialogs/symmetry_mandala-ex1.png | Bin 0 -> 29698 bytes
images/C/dialogs/symmetry_mandala-ex2.png | Bin 0 -> 53282 bytes
images/C/tool-options/draw-mask-ex1.png | Bin 0 -> 43057 bytes
images/C/tool-options/draw-mask-ex2.png | Bin 0 -> 38446 bytes
src/dialogs/dialogs-misc.xml | 5 +-
src/dialogs/symmetry-painting.xml | 296 +++++++++++++++++++++++++++++
src/toolbox/paint/blend.xml | 22 +--
src/toolbox/selection/by-color.xml | 28 +---
src/toolbox/selection/fuzzy.xml | 34 ++++-
20 files changed, 355 insertions(+), 56 deletions(-)
---
diff --git a/docs/templates/dialog_template.xml b/docs/templates/dialog_template.xml
index 616043b..d783cfe 100644
--- a/docs/templates/dialog_template.xml
+++ b/docs/templates/dialog_template.xml
@@ -3,41 +3,41 @@
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<sect2 id="gimp-document-dialog">
- <title><!-- dialog name --> dialog</title>
+ <title>Symmetry Painting dialog</title>
<indexterm>
<primary>Dialog</primary>
- <secondary><!-- dialog name --></secondary>
+ <secondary>Symmetry Painting</secondary>
</indexterm>
<indexterm>
- <primary><!-- dialog name --></primary>
+ <primary>Symmetry Painting</primary>
</indexterm>
<figure>
- <title><!-- dialog name --> dialog</title>
+ <title>Symmetry Painting dialog</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/dialogs/name.png"
+ <imagedata fileref="images/dialogs/symmetry-painting.png"
format="PNG" />
</imageobject>
</mediaobject>
</figure>
-
<para>
- <!--
- General description of what the dialog is good for and how it
- can be used in the creative process
- -->
+ Symmetry Painting is a new painting feature in GIMP-2.10, supported by
+ brush-based tools (Pencil, Paintbrush, Eraser, Airbrush, MyPaint brush,
+ Clone, Smudge, Dodge) as well the Ink tool. There are several kinds of
+ symmetry, all configurable.
+ </para>
+ <para>
+ With these feature, GIMP's digital painting possibilities are increased.
</para>
-
- <!-- description of how to activate the dialog -->
<sect3>
<title>Activating the Dialog</title>
<para>
- The dialog <quote><!-- dialog name --></quote>
+ The dialog <quote>Symmetry Painting</quote>
is dockable. Read <xref linkend="gimp-concepts-docks" /> to learn more
about the concept of dockability. You can access this dialog in
different ways:
diff --git a/images/C/dialogs/symmetry-mandala-ex1.png b/images/C/dialogs/symmetry-mandala-ex1.png
new file mode 100644
index 0000000..514c83b
Binary files /dev/null and b/images/C/dialogs/symmetry-mandala-ex1.png differ
diff --git a/images/C/dialogs/symmetry-mandala-ex2.png b/images/C/dialogs/symmetry-mandala-ex2.png
new file mode 100644
index 0000000..cfb5727
Binary files /dev/null and b/images/C/dialogs/symmetry-mandala-ex2.png differ
diff --git a/images/C/dialogs/symmetry-mandala.png b/images/C/dialogs/symmetry-mandala.png
new file mode 100644
index 0000000..1679dba
Binary files /dev/null and b/images/C/dialogs/symmetry-mandala.png differ
diff --git a/images/C/dialogs/symmetry-mirror-ex1.png b/images/C/dialogs/symmetry-mirror-ex1.png
new file mode 100644
index 0000000..6d262b4
Binary files /dev/null and b/images/C/dialogs/symmetry-mirror-ex1.png differ
diff --git a/images/C/dialogs/symmetry-mirror-ex2.png b/images/C/dialogs/symmetry-mirror-ex2.png
new file mode 100644
index 0000000..58ed283
Binary files /dev/null and b/images/C/dialogs/symmetry-mirror-ex2.png differ
diff --git a/images/C/dialogs/symmetry-mirror.png b/images/C/dialogs/symmetry-mirror.png
new file mode 100644
index 0000000..9860f83
Binary files /dev/null and b/images/C/dialogs/symmetry-mirror.png differ
diff --git a/images/C/dialogs/symmetry-painting.png b/images/C/dialogs/symmetry-painting.png
new file mode 100644
index 0000000..64dd4cd
Binary files /dev/null and b/images/C/dialogs/symmetry-painting.png differ
diff --git a/images/C/dialogs/symmetry-tiling-ex1.png b/images/C/dialogs/symmetry-tiling-ex1.png
new file mode 100644
index 0000000..b06d343
Binary files /dev/null and b/images/C/dialogs/symmetry-tiling-ex1.png differ
diff --git a/images/C/dialogs/symmetry-tiling-ex2.png b/images/C/dialogs/symmetry-tiling-ex2.png
new file mode 100644
index 0000000..60af9b6
Binary files /dev/null and b/images/C/dialogs/symmetry-tiling-ex2.png differ
diff --git a/images/C/dialogs/symmetry-tiling.png b/images/C/dialogs/symmetry-tiling.png
new file mode 100644
index 0000000..3dfceed
Binary files /dev/null and b/images/C/dialogs/symmetry-tiling.png differ
diff --git a/images/C/dialogs/symmetry_mandala-ex1.png b/images/C/dialogs/symmetry_mandala-ex1.png
new file mode 100644
index 0000000..514c83b
Binary files /dev/null and b/images/C/dialogs/symmetry_mandala-ex1.png differ
diff --git a/images/C/dialogs/symmetry_mandala-ex2.png b/images/C/dialogs/symmetry_mandala-ex2.png
new file mode 100644
index 0000000..cfb5727
Binary files /dev/null and b/images/C/dialogs/symmetry_mandala-ex2.png differ
diff --git a/images/C/tool-options/draw-mask-ex1.png b/images/C/tool-options/draw-mask-ex1.png
new file mode 100644
index 0000000..744cc21
Binary files /dev/null and b/images/C/tool-options/draw-mask-ex1.png differ
diff --git a/images/C/tool-options/draw-mask-ex2.png b/images/C/tool-options/draw-mask-ex2.png
new file mode 100644
index 0000000..329a245
Binary files /dev/null and b/images/C/tool-options/draw-mask-ex2.png differ
diff --git a/src/dialogs/dialogs-misc.xml b/src/dialogs/dialogs-misc.xml
index 8e4c4cc..946cd45 100755
--- a/src/dialogs/dialogs-misc.xml
+++ b/src/dialogs/dialogs-misc.xml
@@ -2,9 +2,7 @@
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2006-07-16 added error-console by j.h
- 2006-07-07 added device-status by j.h
- 2006-03-13 lexa: created new structure for dialogs
+ 2017-05-06 j.h: add symmetry-painting
-->
<sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-dialogs-misc">
<title>Misc. Dialogs</title>
@@ -17,4 +15,5 @@
<xi:include href="export-file-dialog.xml"/>
<xi:include href="sample-points.xml"/>
<xi:include href="pointer-dialog.xml"/>
+ <xi:include href="symmetry-painting.xml"/>
</sect1>
diff --git a/src/dialogs/symmetry-painting.xml b/src/dialogs/symmetry-painting.xml
new file mode 100644
index 0000000..9417881
--- /dev/null
+++ b/src/dialogs/symmetry-painting.xml
@@ -0,0 +1,296 @@
+<?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";>
+
+<sect2 id="gimp-symmetry-dialog">
+ <title>Symmetry Painting dialog</title>
+
+ <indexterm>
+ <primary>Dialog</primary>
+ <secondary>Symmetry Painting</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Symmetry Painting</primary>
+ </indexterm>
+ <figure>
+ <title>Symmetry Painting dialog</title>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-painting.png"
+ format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>
+ Symmetry Painting is a new painting feature in GIMP-2.10, supported by
+ brush-based tools (Pencil, Paintbrush, Eraser, Airbrush, MyPaint brush,
+ Clone, Smudge, Dodge) as well the Ink tool. There are several kinds of
+ symmetry, all configurable.
+ </para>
+ <para>
+ With these feature, GIMP's digital painting possibilities are increased.
+ </para>
+
+ <sect3>
+ <title>Activating the Dialog</title>
+
+ <para>
+ You can access this dialog from the image Menu bar through:
+ <menuchoice>
+ <guimenu>Windows</guimenu>
+ <guisubmenu>Dockable Dialogs</guisubmenu>
+ <guimenuitem>Symmetry Painting</guimenuitem>
+ </menuchoice>
+ </para>
+
+ <para>
+ The dialog <quote>Symmetry Painting</quote>
+ is dockable. Read <xref linkend="gimp-concepts-docks" /> to learn more
+ about the concept of dockability.
+ </para>
+ </sect3>
+
+ <sect3>
+ <title>Using the Symmetry Painting dialog</title>
+
+ <para>
+ This dialog is very simple. You only have a <guilabel>Symmetry</guilabel>
+ item with a drop down list that offers four options. As soon as you check
+ a symmetry type, symmetry axes appear as dotted green lines in the image
+ window and you can start painting with the brush you have chosen.
+ </para>
+
+ <variablelist>
+ <title>Options</title>
+ <varlistentry>
+ <term>none</term>
+ <listitem>
+ <para>
+ That is the default option; the symmetry painting is not activated.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Mirror</term>
+ <listitem>
+ <figure>
+ <title>The Symmetry mirror dialog</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-mirror.png"
+ format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ This is a symmetry like in a mirror. You can select an
+ <guilabel>Horizontal symmetry</guilabel>, a <guilabel>Vertical
+ symmetry</guilabel> or a <guilabel>Central symmetry</guilabel>. You
+ can also select several symmetries.
+ </para>
+ <para>
+ The default position for symmetry axis is the middle of the image
+ window. You can place axis where you want using
+ <guilabel>Horizontal axis position</guilabel> and
+ <guilabel>Vertical axis position</guilabel>.
+ </para>
+
+ <para>
+ <guilabel>Disable brush transform</guilabel>: when you transform
+ the drawing, the brush itself will end up transformed as well. For
+ instance, in a mirror transform, not only will your drawing on the
+ right of the canvas be mirrored on the left, but the brush itself is
+ obviously "flipped" on the left. If for some reason, you want the
+ drawn lines to be mirrored (or other transformation) but not the
+ brush outline itself, you can check this box.
+ For obvious reason, you won't see it with symmetrical brushes
+ though. That's why you don't see the effect since many default
+ brushes are symmetrical.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Tiling</term>
+ <listitem>
+ <figure>
+ <title>The Symmetry Tiling Dialog</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-tiling.png"
+ format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ This mode covers the image with strokes.
+ </para>
+ <para>
+ No axes here. The options are:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Interval X</guilabel><guilabel>Interval Y</guilabel>:
+ these are the intervals on X and Y axis, in pixels, between
+ stroke centers.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Shift</guilabel>: this the shift between lines on the
+ X axis, in pixels.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Max strokes X</guilabel>, <guilabel>Max
+ strokes Y</guilabel>: these are the maximal number of brush
+ strokes on X and Y axis. Default is 0, which means no limit,
+ according to the image size.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Mandala</term>
+ <listitem>
+ <figure>
+ <title>The Symmetry Mandala Dialog</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-mandala.png"
+ format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Strokes are placed around the center of coordinates of axis.
+ </para>
+ <para>
+ The options are:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Center abscissa</guilabel>, <guilabel>Center
+ ordinate</guilabel> to position the center of coordinates.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Number of points</guilabel>: number of strokes.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Disable brush transform</guilabel>: see above.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+
+ <sect3>
+ <title>Examples</title>
+ <para>
+ Pepper brush is selected. Pencil is used.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Example for Mirror</term>
+ <listitem>
+ <figure>
+ <title>Vertical Symmetry</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-mirror-ex1.png"
+ format="PNG" />
+ </imageobject>
+ <caption>
+ <para>
+ A single click
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-mirror-ex2.png"
+ format="PNG" />
+ </imageobject>
+ <caption>
+ <para>
+ Click and drag
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Example for Tiling</term>
+ <listitem>
+ <figure>
+ <title></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-tiling-ex1.png"
+ format="PNG" />
+ </imageobject>
+ <caption>
+ <para>
+ A single click. Shift = 20.
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-tiling-ex2.png"
+ format="PNG" />
+ </imageobject>
+ <caption>
+ <para>
+ Click and drag
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Example for Mandala</term>
+ <listitem>
+ <figure>
+ <title></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-mandala-ex1.png"
+ format="PNG" />
+ </imageobject>
+ <caption>
+ <para>
+ A single click
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-mandala-ex2.png"
+ format="PNG" />
+ </imageobject>
+ <caption>
+ <para>
+ Click and drag
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+</sect2>
diff --git a/src/toolbox/paint/blend.xml b/src/toolbox/paint/blend.xml
index 521c936..32991f2 100644
--- a/src/toolbox/paint/blend.xml
+++ b/src/toolbox/paint/blend.xml
@@ -2,22 +2,8 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2009-03-16 j.h: reviewed for v2.6. No change
- 2008-04-07 JPL rewied "fr"
- 2008-03-19 Mr.Dust : added korean contents
- 2008-01-25 PP rewied "fr" for GIMP 2.4
- 2008-01-18 alex falappa: reviewed 'it' for
- GIMP 2.4, some small fixes for en too
- 2007-10-07 lexa: reviewed 'de' for GIMP 2.4
- 2007-06-16 kost: added norwegian
- 2007-04-11 lexa: added references to gradient concept and dialog pages
- 2007-02-12 added example en;fr for Offset by j.h
- 2006-04-25 added it content by ciampix
- 2006-01-04 fr reviewed by j.h
- 2005-11-27 changed to figure and sect3
- 050817 de relocated chapter to paint tools
- 050817 de reviewed by axel.wernicke
- -->
+ 2007-04-30 j.h: update
+-->
<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-blend">
<title>Blend</title>
<indexterm>
@@ -51,6 +37,10 @@
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.
+ </para>
+ <para>
There are an astonishing number of things you can do with this tool, and
the possibilities may seem a bit overwhelming at first. The two most
important options you have are the Gradient and the Shape. Clicking the
diff --git a/src/toolbox/selection/by-color.xml b/src/toolbox/selection/by-color.xml
index 16774be..bfac3cc 100644
--- a/src/toolbox/selection/by-color.xml
+++ b/src/toolbox/selection/by-color.xml
@@ -1,15 +1,7 @@
<?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";>
<!-- section history:
- 2008-03-21 JPL reviewed fr & en
- 2007-12-21 PP reviewed fr
- 2007-10-05 lexa: reviewed de for GIMP 2.4
- 2007-06-02 KoSt: added 'no'
- 2006-02-05 fr revised; shortcut changed in "en" by j.h
- 2005-12-14 note added by j.h
- 2005-12-07 replaced <simplesect> by <sect3> by lexa
- 2005-11-30 replaced informalfigure by figure by lexa
- 2005=05-19 de reviewed by axel.wernicke
+ 20117-05-04 j.h: add Draw mask option
-->
<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-by-color-select">
<title>Select By Color</title>
@@ -108,10 +100,8 @@
change the threshold by the same way as with the fuzzy tool.
</para>
<para>
- To move the selection see
- <link linkend="gimp-using-selections-moving">Moving selections</link>.
- <!--(you can move the selection outline with the arrow keys, not with the
- mouse...).-->
+ You can move the selection outline with the arrow keys, not with the
+ mouse.
</para>
</sect3>
@@ -131,18 +121,10 @@
<variablelist>
<xi:include href="about-common-select-options.xml"/>
<varlistentry>
- <term>
- Mode; Antialiasing; Feather edges
- </term>
- <listitem>
- <para>Common select options.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Similar colors</term>
+ <term>Select transparent areas, Sample merged, Draw mask</term>
<listitem>
<para>
- All these options work exactly the same way, they were described
+ These three options work exactly the same way they were described
for the fuzzy selection already. See for
<xref linkend="tool-fuzzy-select-options"/> details.
</para>
diff --git a/src/toolbox/selection/fuzzy.xml b/src/toolbox/selection/fuzzy.xml
index a5bd45f..d4064d3 100644
--- a/src/toolbox/selection/fuzzy.xml
+++ b/src/toolbox/selection/fuzzy.xml
@@ -309,8 +309,40 @@
<term>Draw Mask</term>
<listitem>
<para>
- TODO
+ This option is only an help for selection. Selected areas
+ marked with marching ants may not be evident when selecting
+ with Fuzzy select or Magic wand. If this option is checked,
+ selected areas will be filled with a magenta color as long as
+ you keep pressing on the mouse left button, and this mask
+ will disappear as soon as you release this button.
</para>
+
+ <figure>
+ <title>Example for Draw mask option applied</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/tool-options/draw-mask-ex1.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ Fuzzy Select used with Draw Mask option unchecked
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/tool-options/draw-mask-ex2.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ Fuzzy Select used with Draw Mask option checked, left
+ mouse button not released yet.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
</listitem>
</varlistentry>
</variablelist>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
