[gimp-help-2] Rebuilt and update align.xml
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Rebuilt and update align.xml
- Date: Wed, 6 Sep 2017 05:49:19 +0000 (UTC)
commit afb57b5156ce3b6d09e979a194b9e2a9d82a088e
Author: Julien Hardelin <jhardlin orange fr>
Date: Wed Sep 6 07:48:43 2017 +0200
Rebuilt and update align.xml
images/C/tool-options/align-hfill.png | Bin 0 -> 7270 bytes
images/C/tool-options/align-vfill.png | Bin 0 -> 7037 bytes
...hcenter-24.png => stock-gravity-hcenter-24.png} | Bin 750 -> 750 bytes
...vcenter-24.png => stock-gravity-vcenter-24.png} | Bin 668 -> 668 bytes
images/C/toolbox/align-ex-distrib-0-yellow.png | Bin 0 -> 887 bytes
images/C/toolbox/align-ex-distrib-1.png | Bin 0 -> 8466 bytes
images/C/toolbox/align-ex-distrib-10-yellow.png | Bin 0 -> 9559 bytes
images/C/toolbox/align-ex-distrib-2.png | Bin 0 -> 3110 bytes
images/C/toolbox/align-ex-distrib-3.png | Bin 0 -> 2328 bytes
images/C/toolbox/align-ex-distrib-4.png | Bin 0 -> 2328 bytes
images/C/toolbox/align-ex-distrib-orig.png | Bin 0 -> 4914 bytes
images/C/toolbox/align-ex-ref-active-layer.png | Bin 0 -> 4085 bytes
images/C/toolbox/align-ex-ref-image.png | Bin 0 -> 4065 bytes
images/C/toolbox/align-ex-ref-orig.png | Bin 0 -> 4038 bytes
images/C/toolbox/align-ex-ref-path.png | Bin 0 -> 4190 bytes
images/C/toolbox/align-ex-ref-selection.png | Bin 0 -> 4648 bytes
images/C/toolbox/align-ex1.png | Bin 2218 -> 0 bytes
images/C/toolbox/align-ex2.png | Bin 675 -> 0 bytes
images/C/toolbox/align-ex3.png | Bin 632 -> 0 bytes
images/C/toolbox/align-ex4.png | Bin 620 -> 0 bytes
images/C/toolbox/align-options.png | Bin 0 -> 17330 bytes
images/C/toolbox/tool-options-align.png | Bin 17873 -> 0 bytes
src/toolbox/transform/align.xml | 377 ++++++++++++++------
23 files changed, 264 insertions(+), 113 deletions(-)
---
diff --git a/images/C/tool-options/align-hfill.png b/images/C/tool-options/align-hfill.png
new file mode 100644
index 0000000..8f718d9
Binary files /dev/null and b/images/C/tool-options/align-hfill.png differ
diff --git a/images/C/tool-options/align-vfill.png b/images/C/tool-options/align-vfill.png
new file mode 100644
index 0000000..86969b7
Binary files /dev/null and b/images/C/tool-options/align-vfill.png differ
diff --git a/images/C/toolbox/align-ex-distrib-0-yellow.png b/images/C/toolbox/align-ex-distrib-0-yellow.png
new file mode 100644
index 0000000..0ed3898
Binary files /dev/null and b/images/C/toolbox/align-ex-distrib-0-yellow.png differ
diff --git a/images/C/toolbox/align-ex-distrib-1.png b/images/C/toolbox/align-ex-distrib-1.png
new file mode 100644
index 0000000..b52d975
Binary files /dev/null and b/images/C/toolbox/align-ex-distrib-1.png differ
diff --git a/images/C/toolbox/align-ex-distrib-10-yellow.png b/images/C/toolbox/align-ex-distrib-10-yellow.png
new file mode 100644
index 0000000..6513b28
Binary files /dev/null and b/images/C/toolbox/align-ex-distrib-10-yellow.png differ
diff --git a/images/C/toolbox/align-ex-distrib-2.png b/images/C/toolbox/align-ex-distrib-2.png
new file mode 100644
index 0000000..ae18f99
Binary files /dev/null and b/images/C/toolbox/align-ex-distrib-2.png differ
diff --git a/images/C/toolbox/align-ex-distrib-3.png b/images/C/toolbox/align-ex-distrib-3.png
new file mode 100644
index 0000000..a724b72
Binary files /dev/null and b/images/C/toolbox/align-ex-distrib-3.png differ
diff --git a/images/C/toolbox/align-ex-distrib-4.png b/images/C/toolbox/align-ex-distrib-4.png
new file mode 100644
index 0000000..806af7c
Binary files /dev/null and b/images/C/toolbox/align-ex-distrib-4.png differ
diff --git a/images/C/toolbox/align-ex-distrib-orig.png b/images/C/toolbox/align-ex-distrib-orig.png
new file mode 100644
index 0000000..a7634de
Binary files /dev/null and b/images/C/toolbox/align-ex-distrib-orig.png differ
diff --git a/images/C/toolbox/align-ex-ref-active-layer.png b/images/C/toolbox/align-ex-ref-active-layer.png
new file mode 100644
index 0000000..71ee250
Binary files /dev/null and b/images/C/toolbox/align-ex-ref-active-layer.png differ
diff --git a/images/C/toolbox/align-ex-ref-image.png b/images/C/toolbox/align-ex-ref-image.png
new file mode 100644
index 0000000..7a5b035
Binary files /dev/null and b/images/C/toolbox/align-ex-ref-image.png differ
diff --git a/images/C/toolbox/align-ex-ref-orig.png b/images/C/toolbox/align-ex-ref-orig.png
new file mode 100644
index 0000000..1f661b4
Binary files /dev/null and b/images/C/toolbox/align-ex-ref-orig.png differ
diff --git a/images/C/toolbox/align-ex-ref-path.png b/images/C/toolbox/align-ex-ref-path.png
new file mode 100644
index 0000000..2d67054
Binary files /dev/null and b/images/C/toolbox/align-ex-ref-path.png differ
diff --git a/images/C/toolbox/align-ex-ref-selection.png b/images/C/toolbox/align-ex-ref-selection.png
new file mode 100644
index 0000000..a55ba63
Binary files /dev/null and b/images/C/toolbox/align-ex-ref-selection.png differ
diff --git a/images/C/toolbox/align-options.png b/images/C/toolbox/align-options.png
new file mode 100644
index 0000000..e83eb5d
Binary files /dev/null and b/images/C/toolbox/align-options.png differ
diff --git a/src/toolbox/transform/align.xml b/src/toolbox/transform/align.xml
index 4ddabdc..251155d 100644
--- a/src/toolbox/transform/align.xml
+++ b/src/toolbox/transform/align.xml
@@ -2,13 +2,8 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2007-11-09 KoSt: added 'no'
- 2007-09-14 AntI: Added 'es'
- 2007-08-30 j.h: replaced "select layer" with "choose layer"
+ 2017-08-24 j.h: update
2007-08-27 ude: added rubber-banding
- 2007-08-22 j.h: completed en and added example. Translated to fr
- 2007-08-19 ude: added stock images; de translation
- 2007-08-14 ciampix: align tool stub page created
-->
<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-align">
<title>Align</title>
@@ -21,7 +16,7 @@
</indexterm>
<figure>
- <title>The Align tool in the toolbox</title>
+ <title>The Align tool in toolbox</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/toolbox/toolbox-align.png" format="PNG"/>
@@ -34,11 +29,11 @@
to a small hand. By clicking on an element of a layer in the
image, you choose the layer which will be moved (with <keycap>Shift
</keycap> + click, you can choose several layers to be aligned);
- this focalised layer has small squares in corners.
+ this focalised layer has small squares in corners and is called
+ <emphasis>target</emphasis>.
Various buttons in the dialog allow you to select how the layer
will be moved. And you can select the image object (other layer,
- selection, path...) the selected layer will be aligned on. This
- object is called <emphasis>target</emphasis>.
+ selection, path...) the selected layer will be aligned on.
</para>
<sect3>
@@ -47,7 +42,7 @@
<itemizedlist>
<listitem>
<para>
- From the image-menu, through:
+ from the image-menu, through:
<menuchoice>
<guimenu>Tools</guimenu>
<guisubmenu>Transform Tools</guisubmenu>
@@ -109,7 +104,7 @@
<mediaobject>
<imageobject>
<imagedata format="PNG"
- fileref="images/toolbox/tool-options-align.png"/>
+ fileref="images/toolbox/align-options.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -125,8 +120,7 @@
<term>Relative to:</term>
<listitem>
<para>
- This is the target - the image object the selected layer
- will be aligned on.
+ To reference the image object the layer will be aligned on.
</para>
<itemizedlist>
<listitem>
@@ -140,182 +134,339 @@
</listitem>
<listitem>
<para>
- <guilabel>Image</guilabel>: the image is used as a
- target.
+ <guilabel>Image</guilabel>: the image is used as
+ alignment reference.
</para>
</listitem>
<listitem>
<para>
- <guilabel>Selection</guilabel>: the minimal rectangular
- region covering the active selection.
+ <guilabel>Selection</guilabel>: the selection is used as
+ alignment reference.
</para>
</listitem>
<listitem>
- <para><guilabel>Active layer</guilabel>:</para>
+ <para>
+ <guilabel>Active layer</guilabel>: the active layer, in
+ the layer dialog, is used as alignment reference.
+ </para>
</listitem>
<listitem>
- <para><guilabel>Active Channel</guilabel>:</para>
+ <para>
+ <guilabel>Active Channel</guilabel>: the active channel
+ is used as alignment reference.
+ </para>
</listitem>
<listitem>
- <para><guilabel>Active Path</guilabel>:</para>
+ <para>
+ <guilabel>Active Path</guilabel>: the active path is used
+ as alignment reference.
+ </para>
</listitem>
</itemizedlist>
+ <figure>
+ <title>Alignment References Examples</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+fileref="images/toolbox/align-ex-ref-orig.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ An image with a selection, a text layer and an active
+ layer. This layer is cropped to content.
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+fileref="images/toolbox/align-ex-ref-image.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ Image is the alignment reference. The
+<guiicon><inlinegraphic
+fileref="images/tool-options/stock-gravity-east-24.png"/></guiicon>
+ (Align right edge of target command has been used.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ <figure>
+ <title></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+fileref="images/toolbox/align-ex-ref-selection.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ Selection is the alignment reference
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+fileref="images/toolbox/align-ex-ref-active-layer.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ Active layer is the alignment reference
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+fileref="images/toolbox/align-ex-ref-path.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ Path is the alignment reference
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
</listitem>
</varlistentry>
+
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-gravity-west-24.png"/>
- </guiicon>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-hcenter-24.png"/>
- </guiicon>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-gravity-east-24.png"/>
- </guiicon>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-gravity-north-24.png"/>
- </guiicon>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-vcenter-24.png"/>
- </guiicon>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-gravity-south-24.png"/>
- </guiicon>
- </term>
+ <term>Align buttons</term>
<listitem>
<para>
- These buttons become active when a layer is selected.
- When you click on one of these buttons, you align the
- selected layer with left edge, horizontal middle, right edge,
- top edge, vertical middle, or bottom of the target.
+ These buttons become active when a target is selected.
+ <itemizedlist>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-west-24.png"/>: to
+ align left edge of target.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-hcenter-24.png"/>: to
+ align center of target horizontally.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-east-24.png"/>: to
+ align right edge of target.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-north-24.png"/>: to
+ align top edge of target.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-vcenter-24.png"/>: to
+ align center of target vertically.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-south-24.png"/>: to
+ align bottom edge of target.
+ </para>
+ </listitem>
+ </itemizedlist>
</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
+
<varlistentry>
<term>Distribute</term>
<listitem>
<variablelist>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-gravity-west-24.png"/>
- </guiicon>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-hcenter-24.png"/>
- </guiicon>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-gravity-east-24.png"/>
- </guiicon>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-gravity-north-24.png"/>
- </guiicon>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-vcenter-24.png"/>
- </guiicon>
- <guiicon>
- <inlinegraphic fileref="images/tool-options/stock-gravity-south-24.png"/>
- </guiicon>
- </term>
+ <term>Distribute buttons</term>
<listitem>
<para>
- These options seem to differ from the <quote>Related to
- </quote> options only by the possibility to set an
- offset. This offset is the distance which will
- separate the selected layer(s) from the target once the
- alignment is performed. It can be positive or negative
- and is expressed in pixel. Distribute add this offset to
- the left edges, horizontal centers, right edges, top
- edges, vertical centers, or bottoms of targets.
+ These options are used when you have several targets and want
+ to arrange them. <quote>targets</quote> are the layers
+ selected with <keycap>Shift</keycap> + Click.
</para>
+ <para>
+ Note that <quote>Relative to</quote> options are active when
+ using Distribute.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-west-24.png"/>: to
+ distribute left edges of targets.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-hcenter-24.png"/> to
+ distribute horizontal centers of targets.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-east-24.png"/> to
+ distribute right edges of targets.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-north-24.png"/> to
+ distribute top edges of targets.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/align-vfill.png"/> to
+ distribute vertical centers of targets.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/stock-gravity-south-24.png"/> to
+ distribute bottom edges of targets.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/align-hfill.png"/> to
+ distribute targets evenly in the horizontal.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+<inlinegraphic fileref="images/tool-options/align-vfill.png"/> to
+ distribute targets evenly in the vertical.
+ </para>
+ <para>
+ Last both buttons ones are new in GIMP-2.10.
+ </para>
+ </listitem>
+ </itemizedlist>
</listitem>
</varlistentry>
<varlistentry>
<term>Offset</term>
<listitem>
<para>
- This entry controls the amount of displacement that could
- be given to the desired alignment effect (in pixel)
- regarding the target. The default value is 0; it can be
- positive or negative.
+ This offset can be positive or negative and is expressed in
+ pixels. Distribute add it to the left edges, horizontal
+ centers, right edges, top edges, vertical centers, or bottoms
+ of targets.
</para>
</listitem>
</varlistentry>
</variablelist>
+ <figure>
+ <title>Example for the <quote>Distribute</quote> commands</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/align-ex-distrib-orig.png"
+ format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ Base image: three layers. <guiicon><inlinegraphic
+ fileref="images/tool-options/stock-gravity-east-24.png"/>
+ </guiicon>(Distribute right edges of targets) will
+ be used.
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/toolbox/align-ex-distrib-0-yellow.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ Active layer is yellow (reference). Offset = 0: all layers are
+ aligned on the the right edge of the yellow layer.
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/toolbox/align-ex-distrib-10-yellow.png"
+ format="PNG"/>
+ </imageobject>
+ <caption>
+ Active layer is yellow. Offset = 10:
+ </caption>
+ </mediaobject>
+ </figure>
</listitem>
</varlistentry>
</variablelist>
</sect3>
+
<sect3>
- <title>Example for the <quote>Align</quote> command</title>
+ <title> A practical example</title>
<figure>
- <title>Base image</title>
+ <title>Origin</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/align-ex1.png" format="PNG"/>
+ <imagedata
+fileref="images/toolbox/align-ex-distrib-1.png" format="PNG"/>
</imageobject>
<caption>
- <para>
- This image has three layers with different sizes and a
- rectangular selection. The yellow layer is active.
- </para>
+ Four text layers, with same size. We want to align them at center of
+ image.
</caption>
</mediaobject>
- </figure>
- <figure>
- <title>Red layer selected</title>
+ <literallayout>
+ </literallayout>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/align-ex2.png" format="PNG"/>
+ <imagedata
+fileref="images/toolbox/align-ex-distrib-2.png" format="PNG"/>
</imageobject>
<caption>
<para>
- Click on red: the red layer is selected, with a small square
- in every corner.
+ We select them as targets with <keycap>Shift</keycap> + Click.
</para>
</caption>
</mediaobject>
- </figure>
- <figure>
- <title>Red layer aligned</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/align-ex3.png" format="PNG"/>
+ <imagedata
+fileref="images/toolbox/align-ex-distrib-3.png" format="PNG"/>
</imageobject>
<caption>
<para>
- We chose <quote>Selection</quote> as a target and we clicked
- on the
- <guiicon><inlinegraphic
- fileref="images/tool-options/stock-gravity-east-24.png"/>
- </guiicon> button (Related to). The red layer alignes with
- the right side of the selection.
+ Alignment reference (<guilabel>Relative to</guilabel>) is
+ <quote>Image</quote>. Offset = 0. We used the
+<guiicon><inlinegraphic
+fileref="images/tool-options/align-vfill.png"/>
+ </guiicon>(Distribute vertical centers of targets) command.
</para>
</caption>
</mediaobject>
- </figure>
- <figure>
- <title>Distribute with offset</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/align-ex4.png" format="PNG"/>
+ <imagedata
+fileref="images/toolbox/align-ex-distrib-4.png" format="PNG"/>
</imageobject>
<caption>
<para>
- We set Offset to -5, we chose <quote>Active layer</quote> as a
- target and we clicked on the
- <guiicon><inlinegraphic
- fileref="images/tool-options/stock-gravity-east-24.png"/>
- </guiicon> button (Distribution).
- The layer is aligned 5 pixels before the right side of the
- yellow active layer.
+ After using the <guiicon><inlinegraphic
+fileref="images/tool-options/align-hfill.png"/></guiicon>(Distribute targets
+ evenly in the horizontal) with offset = 5.
</para>
</caption>
</mediaobject>
</figure>
+
+ </sect3>
+
+ <sect3>
+ <title>Align using the rubber-band box</title>
<figure>
<title>Align using rubber-band box</title>
<mediaobject>
@@ -336,12 +487,12 @@
</imageobject>
<caption>
<para>
- Again, <guilabel>Selection</guilabel> is the target. After a click
+ <quote>Selection</quote> is the reference. After a click
on the
<guiicon><inlinegraphic
fileref="images/tool-options/stock-gravity-west-24.png"/>
</guiicon>
- button, both layers aligne with the left side of the
+ button, both layers align with the left side of the
selection.
</para>
</caption>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
