[gimp-help-2] Improved and simplified wording in English for paths.xml, qmas, .xml, and selections.xml.
- From: Andrew Pitonyak <adpitonyak src gnome org>
- To: svn-commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Improved and simplified wording in English for paths.xml, qmas, .xml, and selections.xml.
- Date: Wed, 16 Dec 2009 01:06:39 +0000 (UTC)
commit 6162c82552e5dd60b1a6fc7d1c8ccb0a30be4ebb
Author: Andrew Pitonyak <andrew pitonyak org>
Date: Tue Dec 15 20:04:26 2009 -0500
Improved and simplified wording in English for paths.xml, qmas,.xml, and selections.xml.
src/using/paths.xml | 127 +++++++++++++++++++++++++---------------------
src/using/qmask.xml | 16 +++---
src/using/selections.xml | 37 +++++++++++---
3 files changed, 108 insertions(+), 72 deletions(-)
---
diff --git a/src/using/paths.xml b/src/using/paths.xml
index 5b9c2be..7ece0ce 100644
--- a/src/using/paths.xml
+++ b/src/using/paths.xml
@@ -25,31 +25,30 @@
</indexterm>
<para>
- Paths are curves (known as Bézier-curves). In <acronym>GIMP</acronym> it's
- very easy to learn and to use them. To understand their concepts and
- mechanism you can go to the glossary
- <link linkend="glossary-bezier-curve">Bézier-curve</link> or to Wikipedia
+ Paths are curves (known as Bézier-curves). Paths are easy to learn and use
+ in <acronym>GIMP</acronym>. To understand their concepts and
+ mechanism, look at the glossary
+ <link linkend="glossary-bezier-curve">Bézier-curve</link> or Wikipedia
<xref linkend="bibliography-online-wkpd-bezier"/>.
- It is a very powerful tool to design sophisticated forms. To use it in
- <acronym>GIMP</acronym> you must operate by two successive ways: 1st
- Create the path and 2nd Stroke path.
+ The Paths tool is very powerful, allowing you to design sophisticated
+ forms. To use the Paths tool in <acronym>GIMP</acronym>, you must first
+ create a path, and then stroke the path.
</para>
<para>
- According to the terminology used in <acronym>GIMP</acronym>,
- <quote>Stroke path</quote> means here to apply a specific style to the
- path (color, width, pattern... ).
+ In <acronym>GIMP</acronym>, the term <quote>Stroke path</quote>, means to
+ apply a specific style to the path (color, width, pattern... ).
</para>
<para>
- Paths are used for two main purposes:
+ A Path has two main purposes:
</para>
<itemizedlist>
<listitem>
- <para>A closed path can be converted into a selection.</para>
+ <para>You can convert a closed path to a selection.</para>
</listitem>
<listitem>
<para>
- An open or closed path can be <emphasis>stroked</emphasis>,
- that is, painted on the image, in a variety of ways.
+ Any path, open or closed, can be <emphasis>stroked</emphasis>;
+ that is, painted on the image in a variety of ways.
</para>
</listitem>
</itemizedlist>
@@ -70,66 +69,84 @@
</figure>
<sect2 id="gimp-using-paths-creating">
- <title>Path Creating</title>
+ <title>Path Creation</title>
<para>
- At this step you can design a skeleton of wished form; this skeleton
- will be modified later by various ways. To do this you can go to
- <link linkend="gimp-tool-path">Paths</link>.
- A short example will be useful to understand the creating process.
+ Start by drawing the outline for your path; the outline
+ can be modified later (see the
+ <link linkend="gimp-tool-path">Paths</link> tool).
+ To start, select the Paths tool using one of the following methods:
</para>
<itemizedlist>
<listitem>
<para>
- In the image menu, click
+ Use
<menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Path</guimenuitem>
- </menuchoice>,
+ </menuchoice>
+ from the image menu.
</para>
</listitem>
<listitem>
<para>
- or on the relevant icon
+ Use the relevant icon
<guiicon>
<inlinegraphic fileref="images/toolbox/stock-tool-path-22.png"/>
- </guiicon> in toolbox,
+ </guiicon> in toolbox.
</para>
</listitem>
<listitem>
- <para>or use hotkey <keycap>B</keycap></para>
+ <para>Use the hotkey <keycap>B</keycap></para>.
</listitem>
</itemizedlist>
<para>
- Your pointer changes into a pen feature with a curve beginning; if you
- left-click in the image you print a point (white inner circle with a
- black border); moving mouse and left-clicking again you create
- automatically a second point linked to previous one. You can carry on as
- often as you wish it to design a polyline, but to learn you need two
- points only. Now if you approach pointer close to segment ranging
- between the two points, the little <quote>+</quote>
- close to pointer changes into a cross (for moving). Now press down left
- button moving pointer to any side.
+ When the Paths tool is selected, the mouse cursor
+ changes into a pointer (arrow) with a curve.
+ Left click in the image to create the first point on the path. Move
+ the mouse to a new point and left click the mouse to create another
+ point linked to the previous point. Although you can create as many
+ points as you desire, you only need two points to learn about Paths.
+ While adding points, the mouse cursor has a little <quote>+</quote>
+ next to the curve, which indicates that clicking will add a new
+ point. When the mouse cursor is close to a line segment, the
+ <quote>+</quote> changes into a cross with arrows; like the move tool.
</para>
<para>
- Then two events occur. One is a bending of the segment to the moving
- direction and this bending is proportional to displacement. The
- second reveals two segments ended with squares (named handles) at the
- two curve ends . If you place the mouse pointer on these squares it
- changes into a pointing finger. Now, if you click-and-drag you can see
- the consequence on the curve feature. By this mean you can change the
- starting curve orientation as well as its <quote>lengthening</quote>
- on modified side.
+ Move the mouse cursor close to a line segment, left-click and drag
+ the line segment. Two events occur.
+ <itemizedlist>
+ <listitem>
+ <para>The line segment bends and curves as it is pulled.</para>
+ </listitem>
+ <listitem>
+ <para>
+ Each line segment has a start point and an end point that is
+ clearly labeled. A <quote>direction line</quote> now
+ projects from each end point for the line segment that was
+ moved.
+ </para>
+ </listitem>
+ </itemizedlist>
+ The curved line segment leaves an end point in the same direction that
+ the <quote>direction line</quote> leaves the end point.
+ The length of the <quote>direction line</quote> controls how far the
+ line segment projects along the <quote>direction line</quote> before
+ curving toward the other end point.
+ Each <quote>direction line</quote> has an empty square box (called a
+ handle) on one end. Click and drag a handle to change the direction and
+ length of a <quote>direction line</quote>.
</para>
<figure>
- <title>Appearance of a path while being manipulated</title>
+ <title>Appearance of a path while it is manipulated</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/using/path-with-anchors.png" format="PNG"/>
</imageobject>
<caption>
<para>
- Appearance of a path while it is being manipulated using the Path
- tool.
+ Appearance of a path while it is manipulated using the Path tool.
+ The path is comprised of two components with both straight and
+ curved segments.
</para>
</caption>
</mediaobject>
@@ -137,27 +154,23 @@
<!--TRANSLATORS: check glossary.po for a translation of this para-->
<para>
Paths can be created and manipulated using the
- <link linkend="gimp-tool-path">Path tool</link>.
- The image above shows a path which consists of two components, having
- both straight and curved segments, being worked on with the Path tool.
- Black squares are anchor points, the open circle indicates the selected
- anchor and the two open squares are the two handles which are associated
- with this anchor from the curves on either side of it.
+ <link linkend="gimp-tool-path">Path tool</link>. Black squares are
+ anchor points, the open circle indicates the selected anchor, and the
+ two open squares are the handles associated with the selected anchor.
</para>
-
<para>
Paths, like layers and channels, are components of an image. When an
- image is saved in GIMP's native XCF file format, any paths it has are
- saved along with it. The list of paths in an image can be viewed and
- operated on using the
+ image is saved in <acronym>GIMP</acronym>'s native XCF file format, any
+ paths it has are saved with it. The list of paths in an image can be
+ viewed and operated on using the
<link linkend="gimp-path-dialog">Paths dialog</link>.
- If you want to move a path from one image to another, you can do so by
+ You can move move a path from one image to another by
copying and pasting using the pop-up menu in the Paths dialog, or by
- dragging an icon from the Paths dialog into the destination image's
+ dragging an icon from the Paths dialog into the destination image
window.
</para>
<para>
- GIMP paths belong to a mathematical type called
+ <acronym>GIMP</acronym> paths belong to a mathematical type called
<quote>Bezier paths</quote>. What this means in practical terms is that
they are defined by <emphasis>anchors</emphasis> and
<emphasis>handles</emphasis>. <quote>Anchors</quote> are points the path
diff --git a/src/using/qmask.xml b/src/using/qmask.xml
index 04a6400..3b8e93d 100644
--- a/src/using/qmask.xml
+++ b/src/using/qmask.xml
@@ -8,7 +8,7 @@
-->
<sect1 id="gimp-using-quickmask">
<title>
- <phrase>Using the QuickMask</phrase>
+ <phrase>Using QuickMask Mode</phrase>
</title>
<indexterm>
<primary>Masks</primary>
@@ -21,26 +21,26 @@
</step>
<step>
<para>
- Activate the QuickMask using the left-bottom button in the image
+ Activate QuickMask mode using the left-bottom button in the image
window. If a selection is present the mask is initialized with the
content of the selection.
</para>
</step>
<step>
<para>
- Choose any drawing tool. Paint on the Quick Mask using black color to
- remove selected areas and white color to add selected areas. You can
- use grey colors to get partially selected areas.
+ Choose any drawing tool. Paint on the QuickMask with black to
+ remove selected areas, and paint with white to add selected
+ areas. Use grey colors to partially select areas.
</para>
<para>
You can also use selection tools and fill these selections with the
- Bucket Fill tool. This does not destroy the Qmask selections!
+ Bucket Fill tool; this does not destroy the QuickMask selections!
</para>
</step>
<step>
<para>
- Toggle off the QuickMask using the left-bottom button in the image
- window: the selection will be displayed with its marching ants.
+ Toggle QuickMask mode off using the left-bottom button in the image
+ window: the selection will be displayed with marching ants.
</para>
</step>
</procedure>
diff --git a/src/using/selections.xml b/src/using/selections.xml
index 81d4e5a..9745f93 100644
--- a/src/using/selections.xml
+++ b/src/using/selections.xml
@@ -170,9 +170,32 @@
</indexterm>
<para>
- When drawing a selection, you can add a part of the image
- or subtract a part of the selection by holding the
- <keycap>Shift</keycap> or the <keycap>Ctrl</keycap> keyboard keys down:
+ Tools have options that you can configure.
+ Each selection tool allows you to set the selection mode. The
+ following selection modes are supported:
+ <itemizedlist>
+ <listitem><para>
+ Replace is the most used selection mode. In replace mode,
+ a selection replaces any existing selection.
+ </para></listitem>
+ <listitem><para>
+ Add mode, causes new selections to be added to any existing
+ selection. Press and hold the <keycap>Shift</keycap> key while
+ making a selection to temporarily enter add mode.
+ </para></listitem>
+ <listitem><para>
+ Subtract mode, causes new selections to be removed from any existing
+ selection. Press and hold the <keycap>Ctrl</keycap> key while
+ making a selection to temporarily enter subtract mode.
+ </para></listitem>
+ <listitem><para>
+ Intersect mode, causes areas in both the new and
+ existing selection to become the new selection.
+ Press and hold both the <keycap>Shift</keycap> and
+ <keycap>Ctrl</keycap> key while
+ making a selection to temporarily enter intersect mode.
+ </para></listitem>
+ </itemizedlist>
</para>
<figure>
@@ -185,10 +208,10 @@
</mediaobject>
</figure>
<para>
- A rectangular has been drawn. Then the Lasso is selected and a free hand
- selection is drawn, holding the <keycap>Shift</keycap> key down,
- including a part of the rectangular selection. As soon as you release
- the mouse button, both selections are added.
+ The figure shows an existing rectangular selection.
+ Select the Lasso. While pressing the <keycap>Shift</keycap>
+ key, make a free hand selection that includes the existing selection.
+ Release the mouse button and areas are included in the selection.
</para>
<note>
<para>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
