[gimp-help-2: 2/4] Move paint mode examples to new sect3
- From: Ulf-D. Ehlert <ulfehlert src gnome org>
- To: svn-commits-list gnome org
- Subject: [gimp-help-2: 2/4] Move paint mode examples to new sect3
- Date: Sun, 3 May 2009 15:51:37 -0400 (EDT)
commit a24688bee94de0c45d61b8b4a99dfb5d9af2f74c
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date: Wed Apr 29 19:39:05 2009 +0200
Move paint mode examples to new sect3
---
src/toolbox/tool-brush.xml | 499 ++++++++++++++++++++++----------------------
1 files changed, 250 insertions(+), 249 deletions(-)
diff --git a/src/toolbox/tool-brush.xml b/src/toolbox/tool-brush.xml
index 0c78722..4e0e50d 100644
--- a/src/toolbox/tool-brush.xml
+++ b/src/toolbox/tool-brush.xml
@@ -1,6 +1,8 @@
<?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">
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.docbook.org/xml/4.3/docbookx.dtd">
<!-- section history:
+ 2009-04-29 ude: Moved Paint Mode examples to new sect3
2008-09-25 aprokoudine reviwed 'ru'
2008-06-01 ciampix reviewed for it
2008-04-14 JPL reviewed for fr
@@ -15,9 +17,8 @@
2005-05-20 de reviewed by axel.wernicke
-->
<sect2 id="gimp-tool-brush">
- <title>
- <phrase>Common Features</phrase>
- </title>
+ <title>Common Features</title>
+
<indexterm>
<primary>Paint Tools</primary>
</indexterm>
@@ -27,9 +28,7 @@
</indexterm>
<figure>
- <title>
- <phrase>The Paint Tools (Tools menu)</phrase>
- </title>
+ <title>The Paint Tools (Tools menu)</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/toolbox/brush-tools.png" format="PNG"/>
@@ -42,9 +41,7 @@
all grouped together at the bottom (in the default arrangement).
</para>
<figure>
- <title>
- <phrase>The Paint Tools (Tools Box)</phrase>
- </title>
+ <title>The Paint Tools (Tools Box)</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/toolbox/brush-tools-box.png" format="PNG"/>
@@ -155,9 +152,7 @@
</para>
<sect3 id="gimp-tools-brush-modifiers">
- <title>
- <phrase>Key modifiers</phrase>
- </title>
+ <title>Key modifiers</title>
<variablelist>
<varlistentry>
<term>
@@ -226,29 +221,24 @@
</sect3>
<sect3 id="gimp-tool-brush-options">
- <title>
- <phrase>Tool Options</phrase>
- </title>
+ <title>Tool Options</title>
<figure>
- <title>
- <phrase>Tool Options shared by all brush tools</phrase>
- </title>
+ <title>Tool Options shared by all brush tools</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/tool-options-brushcommon.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/toolbox/tool-options-brushcommon.png"/>
</imageobject>
</mediaobject>
</figure>
<para>
Many tool options are shared by several brush tools: these are described
- here. Options that apply onltool-options-brushcommony to one specific tool, or to a small number
- of tools, are described in the sections devoted to those tools.
+ here. Options that apply onltool-options-brushcommony to one specific
+ tool, or to a small number of tools, are described in the sections
+ devoted to those tools.
</para>
<variablelist id="gimp-tool-painting-modes">
- <title>
- <phrase>Paint Modes</phrase>
- </title>
<varlistentry>
<term>Mode</term>
<listitem>
@@ -263,208 +253,13 @@
for tools that can be thought of as adding color to the image:
the Pencil, Paintbrush, Airbrush, Ink, and Clone tools. For the
other brush tools, the option appears for the sake of
- consistency but is always grayed out. A list of modes can be
+ consistency but is always grayed out. A list of modes can be
found in <xref linkend="gimp-concepts-layer-modes"/>.
</para>
<para>
- In this list, some modes are particular:
+ In this list, some modes are particular and are described
+ <link linkend="gimp-paint-mode-examples">below</link>.
</para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Dissolve</guilabel>
- </para>
- <figure>
- <title>
- <phrase>Dissolve mode example</phrase>
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/toolbox/dissolve-mode-example.png" format="PNG"/>
- </imageobject>
- <caption>
- <para>
- Two brush-strokes made with the Airbrush, using the same
- fuzzy circular brush. Left: Normal mode. Right: Dissolve
- mode.
- </para>
- </caption>
- </mediaobject>
- </figure>
- <para><!--Changed 2008-02-24-->
- For any paint tool with opacity less than 100%, this very
- useful mode doesn't draw transparency but determines the
- probability of applying paint. This gives nice patterns of
- dots to paint-strokes or filling.
- </para>
- <figure>
- <title>
- <phrase>Painting in Dissolve mode</phrase>
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/toolbox/mode-dissolve.png" format="PNG"/>
- </imageobject>
- <caption>
- <para>
- This image has only the background layer and no Alpha
- channel. The background color is sky blue. Three
- strokes with Pencil and various opacities: 100%, 50%,
- 25%. Foreground color pixels are scattered along
- brushstroke.
- </para>
- </caption>
- </mediaobject>
- </figure>
- </listitem>
- <listitem>
- <para>
- <guilabel>Behind</guilabel>
- </para>
- <indexterm>
- <primary>Paint Modes</primary>
- <secondary>Behind</secondary>
- </indexterm>
- <indexterm>
- <primary>Behind (paint mode)</primary>
- </indexterm>
- <figure>
- <title>
- <phrase>
- Example for layer mode <quote>Behind</quote>
- </phrase>
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/glossary/modes-normal2.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/glossary/modes-behind.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- This mode applies paint only to transparent areas of the
- layer: the lower the opacity, the more paint is applied.
- Thus, painting opaque areas has no effect; painting
- transparent areas has the same effect as normal mode. The
- result is always an increase in opacity. Of course none of
- this is meaningful for layers that lack an alpha channel.
- </para>
- <para>
- In the above example image, Wilber is on the top layer,
- surrounded by transparency. The lower layer is solid light
- blue. The Bucket Fill tool was used, with the
- <guilabel>Fill Whole Selection</guilabel> option checked
- and the entire layer was selected. A pattern was used to
- paint with the Bucket Fill tool.
- </para>
- <figure>
- <title>
- <phrase>
- Painting in <quote>Behind</quote> mode
- </phrase>
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/toolbox/mode-behind.png" format="PNG"/>
- </imageobject>
- <caption>
- <para>
- This image has two layers. The upper layer is active.
- Three brushtrokes with pencil, red color at 100%, 50%,
- 25% : only transparent or semi-transparent pixels of
- the layer are painted.
- </para>
- </caption>
- </mediaobject>
- </figure>
- </listitem>
- <listitem>
- <para>
- <guilabel>Color Erase</guilabel>
- </para>
- <indexterm>
- <primary>Paint Modes</primary>
- <secondary>Color Erase</secondary>
- </indexterm>
- <indexterm>
- <primary>Color Erase (paint mode)</primary>
- </indexterm>
- <figure>
- <title>
- <phrase>
- Example for layer mode <quote>Color erase</quote>
- </phrase>
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/glossary/modes-normal2.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/glossary/modes-colorerase.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- This mode erases the foreground color, replacing it with
- partial transparency. It acts like the
- <link linkend="plug-in-colortoalpha">Color to Alpha</link>
- filter, applied to the area under the brushstroke. Note that
- this only works on layers that possess an alpha channel;
- otherwise, this mode is identical to Normal.
- </para>
- <para>
- In the above example image, the color of the Bucket Fill tool
- was white, so white parts of Wilber were erased and the blue
- background shows through.
- </para>
- <figure>
- <title>
- <phrase>
- Painting in <quote>Color Erase</quote> mode
- </phrase>
- </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/toolbox/mode-erase.png" format="PNG"/>
- </imageobject>
- <caption>
- <para>
- This image has only one layer, the background layer.
- Background color is sky blue. Three brushtrokes with
- pencil:
- </para>
- <orderedlist>
- <listitem>
- <para>
- With the exact color of the blue area: only this
- blue color is erased.
- </para>
- </listitem>
- <listitem>
- <para>
- With the exact color of the red area. Only this
- red color is erased, whatever its transparency.
- Erased areas are made transparent.
- </para>
- </listitem>
- <listitem>
- <para>
- With the sky blue color of the layer background:
- only this color is erased.
- </para>
- </listitem>
- </orderedlist>
- </caption>
- </mediaobject>
- </figure>
- </listitem>
- </itemizedlist>
</listitem>
</varlistentry>
@@ -473,11 +268,11 @@
<listitem>
<indexterm>
<primary>Transparency</primary>
- <secondary>The brush Opacity slider</secondary>
+ <secondary>Brush opacity</secondary>
</indexterm>
<indexterm>
<primary>Opacity</primary>
- <secondary>The brush Opacity slider</secondary>
+ <secondary>Brush opacity</secondary>
</indexterm>
<para>
The Opacity slider sets the transparency level for the brush
@@ -531,15 +326,11 @@
<term>Brush Dynamics</term>
<listitem>
<figure>
- <title>
- <phrase>
- The Brush Dynamics check box.
- </phrase>
- </title>
+ <title>The Brush Dynamics check box. </title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
- fileref="images/toolbox/brush-dynamics.png"/>
+ fileref="images/toolbox/brush-dynamics.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -654,9 +445,7 @@
<guimenuitem>Quantity</guimenuitem> slider.
</para>
<figure>
- <title>
- <phrase><quote>Jitter</quote> example</phrase>
- </title>
+ <title><quote>Jitter</quote> example</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/jitter.png" format="PNG"/>
@@ -693,12 +482,11 @@
<term>Color from Gradient</term>
<listitem>
<figure>
- <title>
- <phrase>Gradient options for painting tools.</phrase>
- </title>
+ <title>Gradient options for painting tools. </title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/tool-options-paint-gradient.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/toolbox/tool-options-paint-gradient.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -759,7 +547,8 @@
</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/tool-options/brush-gradient-normal.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/tool-options/brush-gradient-normal.png"/>
</imageobject>
<caption>
<para>Abstract2 Gradient</para>
@@ -767,7 +556,8 @@
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata fileref="images/tool-options/brush-gradient-none.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/tool-options/brush-gradient-none.png"/>
</imageobject>
<caption>
<para>None</para>
@@ -775,7 +565,8 @@
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata fileref="images/tool-options/brush-gradient-sawtooth.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/tool-options/brush-gradient-sawtooth.png"/>
</imageobject>
<caption>
<para>Sawtooth</para>
@@ -783,7 +574,8 @@
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata fileref="images/tool-options/brush-gradient-triangular.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/tool-options/brush-gradient-triangular.png"/>
</imageobject>
<caption>
<para>Triangular</para>
@@ -805,9 +597,9 @@
</listitem>
<listitem>
<para>
- <guilabel>Sawtooth wave</guilabel> means that the gradient will be
- restarted from the beginning, which will often produce a
- color discontinuity;
+ <guilabel>Sawtooth wave</guilabel> means that the
+ gradient will be restarted from the beginning, which
+ will often produce a color discontinuity;
</para>
</listitem>
<listitem>
@@ -825,11 +617,220 @@
</varlistentry>
</variablelist>
</sect3>
- <sect3>
- <title>
- <phrase>Further Information</phrase>
- </title>
+ <sect3 id="gimp-paint-mode-examples">
+ <title>Paint Mode Examples</title>
+
+ <para>
+ The following examples demonstrate some of <acronym>GIMP</acronym>'s
+ paint modes:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Dissolve</term>
+ <listitem>
+ <figure>
+ <title>Dissolve mode example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/dissolve-mode-example.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ Two brush-strokes made with the Airbrush, using the same
+ fuzzy circular brush. Left: Normal mode. Right: Dissolve
+ mode.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ <para>
+ For any paint tool with opacity less than 100%, this very
+ useful mode doesn't draw transparency but determines the
+ probability of applying paint. This gives nice patterns of
+ dots to paint-strokes or filling.
+ </para>
+ <figure>
+ <title>Painting in Dissolve mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/mode-dissolve.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ This image has only the background layer and no Alpha
+ channel. The background color is sky blue. Three
+ strokes with Pencil and various opacities: 100%, 50%,
+ 25%. Foreground color pixels are scattered along
+ brushstroke.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Behind</term>
+ <listitem>
+ <indexterm>
+ <primary>Paint Modes</primary>
+ <secondary>Behind</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Behind (paint mode)</primary>
+ </indexterm>
+ <figure>
+ <title>Example for layer mode <quote>Behind</quote></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/glossary/modes-normal2.png"/>
+ </imageobject>
+ <caption>
+ <para>Wilber over a blue background layer</para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/glossary/modes-behind.png"/>
+ </imageobject>
+ <caption>
+ <para>Filled with pattern</para>
+ </caption>
+ </mediaobject>
+ </figure>
+ <para>
+ This mode applies paint only to transparent areas of the
+ layer: the lower the opacity, the more paint is applied.
+ Thus, painting opaque areas has no effect; painting
+ transparent areas has the same effect as normal mode. The
+ result is always an increase in opacity. Of course none of
+ this is meaningful for layers that lack an alpha channel.
+ </para>
+ <para>
+ In the above example image, Wilber is on the top layer,
+ surrounded by transparency. The lower layer is solid light
+ blue. The Bucket Fill tool was used, with the
+ <guilabel>Fill Whole Selection</guilabel> option checked
+ and the entire layer was selected. A pattern was used to
+ paint with the Bucket Fill tool.
+ </para>
+ <para>
+ The next image (below) has two layers. The upper layer is active.
+ Three brushtrokes with pencil, red color at 100%, 50%, 25%: only
+ transparent or semi-transparent pixels of the layer are painted.
+ </para>
+ <figure>
+ <title>Painting in <quote>Behind</quote> mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/mode-behind.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ Painting with 100%, 50%, 25% transparency (from left to
+ right)
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Color Erase</term>
+ <listitem>
+ <indexterm>
+ <primary>Paint Modes</primary>
+ <secondary>Color Erase</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Color Erase (paint mode)</primary>
+ </indexterm>
+ <figure>
+ <title>Example for layer mode <quote>Color erase</quote></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/glossary/modes-normal2.png"/>
+ </imageobject>
+ <caption>
+ <para>Wilber over a blue background layer</para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/glossary/modes-colorerase.png"/>
+ </imageobject>
+ <caption>
+ <para>White foreground color erased</para>
+ </caption>
+ </mediaobject>
+ </figure>
+ <para>
+ This mode erases the foreground color, replacing it with
+ partial transparency. It acts like the
+ <link linkend="plug-in-colortoalpha">Color to Alpha</link>
+ filter, applied to the area under the brushstroke. Note that
+ this only works on layers that possess an alpha channel;
+ otherwise, this mode is identical to Normal.
+ </para>
+ <para>
+ In the above example image, the color of the Bucket Fill tool
+ was white, so white parts of Wilber were erased and the blue
+ background shows through.
+ </para>
+ <para>
+ This image below has only one layer, the background layer.
+ Background color is sky blue. Three brushtrokes with
+ pencil:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ With the exact color of the blue area: only this blue color is
+ erased.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ With the exact color of the red area. Only this red color is
+ erased, whatever its transparency. Erased areas are made
+ transparent.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ With the sky blue color of the layer background: only this
+ color is erased.
+ </para>
+ </listitem>
+ </orderedlist>
+ <figure>
+ <title>Painting in <quote>Color Erase</quote> mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/mode-erase.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ Painted with 1. blue; 2. red; 3. background color
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+
+ <sect3>
+ <title>Further Information</title>
<para>
Advanced users may be interested to know that brush tools actually
operate at a sub-pixel level, in order to avoid producing jagged-looking
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]