[gimp-help-2] Update text tool
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Update text tool
- Date: Mon, 19 Mar 2012 14:02:07 +0000 (UTC)
commit c5d7c070aff01d190d8d0b6a36eb6ec8ada738bc
Author: Julien Hardelin <jm hard wanadoo fr>
Date: Mon Mar 19 15:02:08 2012 +0100
Update text tool
images/C/toolbox/text-editing-context-menu.png | Bin 0 -> 13705 bytes
images/C/using/text-example-2.png | Bin 0 -> 3535 bytes
images/C/using/text-toolbar.png | Bin 0 -> 6998 bytes
src/concepts/text-management.xml | 305 ++++++++++++++++++++++++
src/gimp.xml | 7 +-
src/menus/layer/text-commands.xml | 5 +-
src/toolbox/text.xml | 298 ++++++++++++++----------
src/using/text-tool-box.xml | 57 +++++
8 files changed, 544 insertions(+), 128 deletions(-)
---
diff --git a/images/C/toolbox/text-editing-context-menu.png b/images/C/toolbox/text-editing-context-menu.png
new file mode 100755
index 0000000..d90de87
Binary files /dev/null and b/images/C/toolbox/text-editing-context-menu.png differ
diff --git a/images/C/using/text-example-2.png b/images/C/using/text-example-2.png
new file mode 100755
index 0000000..9e08447
Binary files /dev/null and b/images/C/using/text-example-2.png differ
diff --git a/images/C/using/text-toolbar.png b/images/C/using/text-toolbar.png
new file mode 100755
index 0000000..3325651
Binary files /dev/null and b/images/C/using/text-toolbar.png differ
diff --git a/src/concepts/text-management.xml b/src/concepts/text-management.xml
new file mode 100755
index 0000000..c40035a
--- /dev/null
+++ b/src/concepts/text-management.xml
@@ -0,0 +1,305 @@
+<?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:
+ 2012-03-18 j.h: created
+ -->
+<sect1 id="gimp-text-management">
+ <title>Text Management</title>
+
+ <indexterm>
+ <primary>Text</primary>
+ <secondary>Editing text</secondary>
+ </indexterm>
+
+ <!--FOR TRANSLATORS: this file is a reshaping of the old
+ concepts/fonts-and-text.xml file. A large part can be copy-pasted-->
+
+ <para>
+ Text is managed with the Text tool. This tool creates a new layer containing
+ the text, above the current layer in the layer dialog, with the size of the
+ text box. Its name is the beginning of the text.
+ </para>
+
+ <figure>
+ <title>Example of a text item</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/using/text-example.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ Example of a text item, showing the boundary of the text layer.
+ (Font: Utopia Bold)
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/using/text-example-2.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ The layer dialog, with the text layer above the layer which was
+ current.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+
+ <para>
+ The Text tool is progressively improved. With <acronym>GIMP</acronym>-2.8,
+ you can now edit text directly on canvas. A text tool box has been added
+ which overlays the canvas above the text box.
+ </para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/using/text-toolbar.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ As soon as you click on the canvas with the Text tool, you get a closed
+ text box and a semi-transparent tool box just above.
+ </para>
+ </caption>
+ </mediaobject>
+
+ <para>
+ Text tool options are described in <xref linkend="gimp-tool-text"/>.
+ </para>
+
+ <para>
+ The default box mode is <quote>Dynamic</quote>, and you can start typing
+ text at once. The text box will enlarge gradually. Press
+ <keycap>Enter</keycap> to add a new line.
+ </para>
+ <para>
+ You can also <emphasis role="bold">enlarge the text box</emphasis> by
+ click-and-dragging, as you do with selections, before starting typing
+ text. Note that box mode turns to "Fixed". You also have to press
+ <keycap>Enter</keycap> to add a new line.
+ </para>
+ <para>
+ To <emphasis role="bold">edit text</emphasis>, you must, first, select the
+ part you want to edit by click-and-drag, or
+ <keycombo><keycap>Shift</keycap><keycap>arrow key</keycap></keycombo> and
+ then use the options of the <xref linkend="gimp-text-tool-box"/>.
+ </para>
+
+ <para>
+ Instead of using the on-canvas text editing, you can use the
+ <xref linkend="gimp-text-editor-dialog"/>.
+ </para>
+
+ <para>
+ You can <emphasis role="bold">move the text</emphasis> on the image using
+ the Move tool: you must click on a character, not on the background.
+ </para>
+
+ <para>
+ You can get <emphasis role="bold">Unicode characters</emphasis> with
+ <keycombo>
+ <keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>U</keycap>
+ </keycombo>
+ plus hexadecimal Unicode code of the desired char. Please see <xref
+ linkend="gimp-text-editor-dialog"/>.
+ </para>
+
+ <para>
+ You can <emphasis role="bold">edit the text later</emphasis>, if the text
+ layer still exists and has not been modified by another tool (see below):
+ make the text layer active in the<link linkend="gimp-layer-dialog">Layer
+ dialog</link>, select the Text tool and click on the text in the image
+ window.
+ </para>
+
+ <variablelist>
+ <varlistentry>
+ <term>Managing Text Layer</term>
+ <listitem>
+ <para>
+ You can operate on a text layer in the same ways as any other layer,
+ but doing so often means giving up the ability to edit the text
+ without losing the results of your work.
+ </para>
+ <para>
+ To understand some of the idiosyncrasies of text handling, it may help
+ for you to realize that a text layer contains more information than
+ the pixel data that you see: it also contains a representation of the
+ text in a text-editor format. You can see this in the text-editor
+ window that pops up while you are using the Text tool. Every time you
+ alter the text, the image layer is redrawn to reflect your changes.
+ </para>
+ <para>
+ Now suppose you create a text layer, and then operate on it in some
+ way that does not involve the Text tool: rotate it, for example.
+ Suppose you then come back and try to edit it using the Text tool. As
+ soon as you edit the text, the Text tool will redraw the layer,
+ wiping out the results of the operations you performed in the
+ meantime.
+ </para>
+ <para>
+ Because this danger is not obvious, the Text tool tries to protect you
+ from it. If you operate on a text layer, and then later try to edit
+ the text, a message pops up, warning you that your alterations will be
+ undone, and giving you three options:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>edit the text anyway;</para>
+ </listitem>
+ <listitem>
+ <para>cancel;</para>
+ </listitem>
+ <listitem>
+ <para>
+ create a new text layer with the same text as the existing layer,
+ leaving the existing layer unchanged.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Warning lose modifications</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/using/text-warning.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Text Editing Context Menu</term>
+ <listitem>
+ <figure>
+ <title>Text Editing Context Menu</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/text-editing-context-menu.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>
+ You get this menu by right-clicking on text. It is somewhat different
+ from that of the Text Editor dialog.
+ </para>
+
+ <itemizedlist>
+ <!--Options migrated from old text.xml-->
+ <listitem>
+ <para>
+ <guilabel>Cut, Copy, Paste, Delete</guilabel>: these options
+ concern a selected text. They remain grayed out as long as no text
+ is selected. <quote>Paste</quote> is activated if the clipboard is
+ not empty.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Open text file</guilabel>: this command opens a file
+ browser where you can find the wanted text file.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Clear</guilabel>: this command deletes all the text,
+ selected or not.
+ </para>
+ </listitem>
+ <listitem>
+ <para id="text-to-path">
+ <guilabel>Path from text</guilabel>: this command creates a
+ path from the outlines of the current text. The result is not
+ evident. You have to open the Path dialog and make path visible.
+ Then select the Path tool and click on the text. Every letter
+ is now surrounded with a path component. So you can modify
+ the shape of letters by moving path control points.
+ </para>
+ <para>
+ This command is similar to
+ <menuchoice>
+ <guimenu>Layer</guimenu>
+ <guisubmenu>Text to Path</guisubmenu>
+ </menuchoice>.
+ </para>
+ </listitem>
+ <listitem>
+ <para id="text-along-path">
+ <guilabel>Text along path</guilabel>:
+ <indexterm>
+ <primary>Text along Path</primary>
+ </indexterm>
+ </para>
+ <para>
+ This option is enabled only if a
+ <link linkend="gimp-using-paths">path</link> exists. When your
+ text is created, then create or import a path and make it active.
+ If you create your path before the text, the path becomes
+ invisible and you have to make it visible in the Path Dialog.
+ </para>
+ <para>
+ This command is also available from the <quote>Layer</quote> menu:
+ </para>
+ <figure>
+ <title>
+ The Text along Path command among text commands in the Layer
+ menu
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/menus/layer/text-commands.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ This group of options appears only if a text layer exists.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+
+ <para>
+ Click on the <guibutton>Text along Path</guibutton> button. The
+ text is bent along the path. Letters are represented with their
+ outline. Each of them is a component of the new path that
+ appears in the <link linkend="gimp-path-dialog">Path
+ dialog</link>. All path options should apply to this new path.
+ </para>
+ <figure>
+ <title><quote>Text along Path</quote> example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/text-along-path.png"
+ format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/text-path.png"
+ format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>From Left to Right / From Right to Left</guilabel>: fix
+ the writing direction of your language.
+ </para>
+ </listitem>
+ <listitem>
+ <para id="gimp-input-methods">
+ <guilabel>Input Methods</guilabel>: methods are available for some
+ languages. For example, selecting <quote>Inuktitut</quote>
+ transforms your keyboard into an Inuktitut keyboard, temporarily.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+</sect1>
\ No newline at end of file
diff --git a/src/gimp.xml b/src/gimp.xml
old mode 100644
new mode 100755
index 8ec61aa..5d470a4
--- a/src/gimp.xml
+++ b/src/gimp.xml
@@ -2,6 +2,7 @@
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
+ 2012-03-18 j.h: add text-tool-box.xml
2012-03-06 j.h: add layer-groups.xml
2009-02-21 j.h: removed using/docks.xml
2009-02-15 ude: removed menu-xtns.xml
@@ -124,7 +125,11 @@
<xi:include href="concepts/layer-modes.xml"/>
<xi:include href="using/layers.xml"/>
<xi:include href="concepts/layer-groups.xml"/>
- <xi:include href="concepts/fonts-and-text.xml"/>
+ </chapter>
+ <chapter id="gimp-image-text-management">
+ <title>Text Management</title>
+ <xi:include href="concepts/text-management.xml"/>
+ <xi:include href="using/text-tool-box.xml"/>
<xi:include href="using/fonts-and-text.xml"/>
</chapter>
<chapter id="gimp-imaging-photos">
diff --git a/src/menus/layer/text-commands.xml b/src/menus/layer/text-commands.xml
old mode 100644
new mode 100755
index 952c3e2..0594833
--- a/src/menus/layer/text-commands.xml
+++ b/src/menus/layer/text-commands.xml
@@ -2,8 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2008-06-15 kost: added 'no'
- 2008-06-07 ude: added 'de'
+ 2012-03-18 j.h: change link text-to-path
2008-05-11 Created by j.h
-->
<sect2 id="gimp-layer-text-commands">
@@ -28,7 +27,7 @@
<listitem>
<para><xref linkend="gimp-layer-text-discard"/></para>
</listitem>
- <listitem id="gimp-layer-text-to-path" xreflabel="Path from Text">
+ <listitem>
<para><xref linkend="text-to-path"/></para>
</listitem>
<listitem id="gimp-layer-text-along-path" xreflabel="Text along Path">
diff --git a/src/toolbox/text.xml b/src/toolbox/text.xml
old mode 100644
new mode 100755
index 16551f7..d62836d
--- a/src/toolbox/text.xml
+++ b/src/toolbox/text.xml
@@ -2,16 +2,15 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
+ 2012-03-18 j.h: update to v2.7
2009-07-09 ude: added scroll wheel tip (#585823),
fixed "entering special chars" (#580532)
2009-03-09 j.h: updated to v2.6
- 2008-01-05 j.h: updated en;fr to v2.4.
- 2007-06-04 kost: added 'no'
+ 2008-01-05 j.h: updated to v2.4.
2006-07-03 lexa: enhanced docbook compliance
- 2006-06-17 added note en;fr for special characters by j.h
+ 2006-06-17 added note for special characters by j.h
2005-12-07 replaced <simplesect> by <sect3> by lexa
2005-12-06 replaced informalfigure by figure by lexa
- 050818 de reviewed by axel.wernicke
-->
<sect2 id="gimp-tool-text">
<title>Text</title>
@@ -35,39 +34,34 @@
</figure>
<para>
- The Text tool places text into an image. When you click on an image with
- this tool the <emphasis>Text Editor dialog</emphasis> is opened where
- you can type your text, and a text layer is added in the Layer Dialog.
- In the <emphasis>Text Option dialog</emphasis>, you can change the font,
- color and size of your text, and justify it, interactively.
+ The Text tool places text into an image. With <acronym>GIMP-2.8</acronym>,
+ you can write your text directly on the canvas. No Text Editor is needed
+ anymore (although you can still use it if you want by checking the
+ <guilabel>Use editor</guilabel> option in the Tool Options dialog. A text
+ toolbar has been added which allows you to edit text in different ways but
+ you can still go on using the <emphasis>Text Option dialog</emphasis>, to
+ change the font, color and size of your text, and justify it,
+ interactively. Right clicking on the frame opens a context menu that allows
+ you to copy, cut, paste, load a text...
</para>
<para>
- A new possibility appeared with <acronym>GIMP</acronym>-2.6:
- click-dragging the mouse pointer on the canvas draws a rectangular frame
- that you can enlarge and move as you do with rectangular selections. The
- text you type in the Text Editor is displayed in this frame and
- automatically adapted to the frame size. You can adjust this frame
- whenever you like.
+ As soon as you type your text, it appears on the canvas in a rectangular
+ frame. If you draw the rectangular frame first, the text is automatically
+ adapted to the frame size. You can enlarge this frame as you do with
+ rectangular selections.
</para>
- <figure id="gimp-text-bounding-box">
- <title>Text tool bounding box</title>
+
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="images/using/text-tool.png"/>
</imageobject>
</mediaobject>
- </figure>
<para>
- When the mouse pointer is around the center of the frame, it
- comes with a small crosshair
- <guiicon>
- <inlinegraphic fileref="images/toolbox/stock-tool-move-16.png"/>
- </guiicon>.
- Click-and-drag to move the frame and its contents (the text shows up when
- you release the mouse button). The text remains at the same place in the
- frame.
+ To move the text on canvas, you have to select the Move tool and click
+ on a character to drag the frame and its text.
</para>
-
+
+
<sect3>
<title>Activating the Tool</title>
<para>
@@ -134,7 +128,7 @@
<itemizedlist>
<para>
At the bottom of the font selector you find some icons which
- act as buttoms for:
+ act as buttons for:
</para>
<listitem>
<para>resizing the font previews,</para>
@@ -177,22 +171,13 @@
</para>
</listitem>
</varlistentry>
-
- <varlistentry>
- <term>Hinting</term>
+
+ <varlistentry> <!--Added-->
+ <term>Use editor</term>
<listitem>
<para>
- Uses the indices of adjustment to modify the characters in
- order to produce clear letters in small font sizes.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Force Auto-Hinter</term>
- <listitem>
- <para><guilabel>Auto Hinter</guilabel> tries to automatically
- compute information for better representation of the
- character font.
+ Use an external editor window for text editing instead of
+ direct-on-canvas editing.
</para>
</listitem>
</varlistentry>
@@ -209,6 +194,16 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>Hinting</term>
+ <listitem>
+ <para>
+ Uses the index of adjustment of the font to modify characters in
+ order to produce clear letters in small font sizes.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term>Color</term>
@@ -247,7 +242,7 @@
<primary>Indent</primary>
</indexterm>
<para>
- Controls the indent spacing from the left margin, for the fist
+ Controls the indent spacing from the left margin, for the first
line.
</para>
</listitem>
@@ -275,86 +270,150 @@
<para>
Controls the spacing between letters. Also in this case the number
is not the space itself between letters, but how many pixels must
- be added to or substracted from this space (the value can be
+ be added to or subtracted from this space (the value can be
negative).
</para>
</listitem>
</varlistentry>
- <varlistentry id="text-along-path">
- <term>Text along Path</term>
+ <varlistentry>
+ <term>Box</term>
<listitem>
- <indexterm>
- <primary>Text along Path</primary>
- </indexterm>
<para>
- This option is enabled only if a
- <link linkend="gimp-using-paths">path</link> exists. When your
- text is created, then create or import a path and make it active.
- If you create your path before the text, the path becomes
- invisible and you have to make it visible in the Path Dialog.
+ Concerns the text box. The associated drop down list offers two
+ options:
</para>
<para>
- This command is also available from the <quote>Layer</quote> menu:
+ <emphasis role="bold">Dynamic</emphasis>: default option. The size
+ of the text box increases as you type. Text may go out of the
+ image. You have to press the <keycap>Enter</keycap> key to add a
+ new line. The indent option indents all lines. If you increase the
+ box size, the option turns to "Fixed".
</para>
- <figure>
- <title>
- The Text to Path command among text commands in the Layer menu
- </title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/menus/layer/text-commands.png"/>
- </imageobject>
- <caption>
- <para>
- This group of options appears only if a layer text exists.
- </para>
- </caption>
- </mediaobject>
- </figure>
<para>
- If you want to use a text which already exists, make it active
- in the <link linkend="gimp-layer-dialog">Layer dialog</link>,
- select the Text tool and click on the text in the image window.
+ <emphasis role="bold">Fixed</emphasis>: you must enlarge the text
+ box first. Else, usual shortcuts are active! The text is limited
+ by the right side of the box and continues on next line. This is
+ not true new line: you must press the <keycap>Enter</keycap> key
+ to add a real new line. The text may go out the lower border of the
+ image. The indent option works on the first line only.
</para>
- <para>
- Click on the <guibutton>Text along Path</guibutton> button. The
- text is bent along the path. Letters are represented with their
- outline. Each of them is a component of the new path which
- appears in the <link linkend="gimp-path-dialog">Path
- dialog</link>. All path options should apply to this new path.
- </para>
- <figure>
- <title><quote>Text along Path</quote> example</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/toolbox/text-along-path.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/toolbox/text-path.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </figure>
</listitem>
- </varlistentry>
+ </varlistentry>
+ </variablelist>
+ </sect3>
- <varlistentry id="text-to-path">
- <term>Path from Text</term>
- <listitem>
+ <sect3 id="text-tool-popup">
+ <title>The Text tool context menu</title>
+ <para>
+ You get this menu by right clicking in a text frame with handles.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Cut, Copy, Paste, Delete</guilabel>: these options concern
+ a selected text. They remain grayed out as long as no text is
+ selected. <quote>Paste</quote> is activated if the clipboard
+ is not empty.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Open text file</guilabel>: this command opens a file browser
+ where you can find the wanted text file.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Clear</guilabel>: this command deletes all the text,
+ selected or not.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Path from text</guilabel>: this command creates a
+ path from the outlines of the current text. The result is not
+ evident. You have to open the Path dialog and make path visible.
+ Then select the Path tool and click on the text. Every letter
+ is now surrounded with a path component. So you can modify
+ the shape of letters by moving path control points.
+ </para>
+ <para>
+ This command is similar to
+ <menuchoice>
+ <guimenu>Layer</guimenu>
+ <guisubmenu>Text to Path</guisubmenu>
+ </menuchoice>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Text along path</guilabel>:
<indexterm>
- <primary>Text to Path</primary>
+ <primary>Text along Path</primary>
</indexterm>
- <para>
- This tool creates a selection path from the selected text. Every
- letter is surrounded with a path component. So you can modify
- the shape of letters by moving path control points.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
+ </para>
+ <para>
+ This option is enabled only if a
+ <link linkend="gimp-using-paths">path</link> exists. When your
+ text is created, then create or import a path and make it active.
+ If you create your path before the text, the path becomes
+ invisible and you have to make it visible in the Path Dialog.
+ </para>
+ <para>
+ This command is also available from the <quote>Layer</quote> menu:
+ </para>
+ <figure>
+ <title>
+ The Text along Path command among text commands in the Layer menu
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/menus/layer/text-commands.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ This group of options appears only if a layer text exists.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ <para>
+ If you want to use a text that already exists, make it active
+ in the <link linkend="gimp-layer-dialog">Layer dialog</link>,
+ select the Text tool and click on the text in the image window.
+ </para>
+ <para>
+ Click on the <guibutton>Text along Path</guibutton> button. The
+ text is bent along the path. Letters are represented with their
+ outline. Each of them is a component of the new path that
+ appears in the <link linkend="gimp-path-dialog">Path
+ dialog</link>. All path options should apply to this new path.
+ </para>
+ <figure>
+ <title><quote>Text along Path</quote> example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/text-along-path.png"
+ format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/toolbox/text-path.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>From Left to Right / From Right to Left</guilabel>: fix
+ the writing direction of your language.
+ </para>
+ </listitem>
+
+ </itemizedlist>
</sect3>
<sect3 id="gimp-text-editor-dialog">
@@ -376,9 +435,10 @@
</figure>
<para>
- This dialog window is opened when you click on the image with the Text
- Tool. There, you can enter the text which shows up in real time in the
- frame on top of the canvas.
+ With <acronym>GIMP-2.8</acronym>, this text editor is available only if
+ the <guilabel>Use editor</guilabel> option is checked. It persists
+ probably because all its functions are not transferred to the
+ direct-on-canvas mode, for instance the Unicode characters.
</para>
<para>
You can correct the text you are writing and you can change the text
@@ -473,26 +533,16 @@
<secondary>Load from file</secondary>
</indexterm>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/stock-fileopen-16.png"/>
- </guiicon>
- <phrase condition="tag-is-required">Load text from file</phrase>
- </term>
+ <term>Load Text from file</term>
<listitem>
<para>
- Text can be loaded from a text file by clicking the folder icon
- in the text editor. All the text in the file is loaded.
+ Text can be loaded from a text file by clicking the folder icon in
+ the text editor. All the text in the file is loaded.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/stock-edit-clear-16.png"/>
- </guiicon>
- <phrase condition="tag-is-required">Clear all text</phrase>
- </term>
+ <term>Clear all text</term>
<listitem>
<para>
Clicking this icon clears the editor and the associated text on
diff --git a/src/using/text-tool-box.xml b/src/using/text-tool-box.xml
new file mode 100755
index 0000000..3fee9d8
--- /dev/null
+++ b/src/using/text-tool-box.xml
@@ -0,0 +1,57 @@
+<?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
+ 2012-03-18 j.h: created
+ -->
+
+<sect1 id="gimp-text-tool-box">
+ <title>Text Tool Box</title>
+
+ <indexterm>
+ <primary>Text</primary>
+ <secondary>Tool Box</secondary>
+ </indexterm>
+
+ <figure>
+ <title>Text Tool Box</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/using/text-toolbar.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>
+ You get this box, which overlays canvas, as soon as you click on canvas with
+ the Text Tool. It allows you to edit text directly on canvas.
+ </para>
+ <para>
+ Apart from the usual text formatting features like font family, style and
+ size selectors you get numeric control over baseline offset and kerning, as
+ well as the ability to change text color for a selection.
+ </para>
+ <para>
+ Help pop-ups are self-explanatory.
+ </para>
+ <para>
+ You can also use <keycombo><keycap>Alt</keycap><keycap>Arrow keys</keycap>
+ </keycombo> to change baseline offset and kerning.
+ </para>
+ <important>
+ <para>
+ These features work on selected text. You get weird effects if no text is
+ selected.
+ </para>
+ </important>
+
+ <sect2>
+ <title>Text Tool Box Context menu</title>
+ <para>
+ TODO
+ </para>
+ </sect2>
+
+</sect1>
\ No newline at end of file
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
