[gimp-help-2] Fix bug #675745
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Fix bug #675745
- Date: Sat, 19 Dec 2015 06:37:17 +0000 (UTC)
commit 372c322af4a851fbb76cd329ea396a33273c5f1b
Author: Julien Hardelin <jhardlin orange fr>
Date: Sat Dec 19 07:36:15 2015 +0100
Fix bug #675745
images/C/toolbox/text-area-size.png | Bin 0 -> 4460 bytes
images/C/toolbox/text-default-baseline.png | Bin 0 -> 9956 bytes
images/C/toolbox/text-kerning.png | Bin 0 -> 11862 bytes
images/C/toolbox/text-selected.png | Bin 0 -> 14584 bytes
images/C/toolbox/text-spacing.png | Bin 0 -> 12220 bytes
images/C/toolbox/text-to-path1.png | Bin 0 -> 2796 bytes
images/C/toolbox/text-to-path2.png | Bin 0 -> 6229 bytes
images/C/toolbox/text-to-path3.png | Bin 0 -> 13339 bytes
images/C/using/text-toolbar.png | Bin 6998 -> 7258 bytes
src/concepts/text-management.xml | 687 +++++++++++++++++++--------
src/gimp.xml | 3 +-
src/menus/layer/text-commands.xml | 4 +-
src/toolbox/text.xml | 213 +--------
src/using/text-tool-box.xml | 57 ---
14 files changed, 503 insertions(+), 461 deletions(-)
---
diff --git a/images/C/toolbox/text-area-size.png b/images/C/toolbox/text-area-size.png
new file mode 100644
index 0000000..a23dbc8
Binary files /dev/null and b/images/C/toolbox/text-area-size.png differ
diff --git a/images/C/toolbox/text-default-baseline.png b/images/C/toolbox/text-default-baseline.png
new file mode 100644
index 0000000..360a23f
Binary files /dev/null and b/images/C/toolbox/text-default-baseline.png differ
diff --git a/images/C/toolbox/text-kerning.png b/images/C/toolbox/text-kerning.png
new file mode 100644
index 0000000..18b55bf
Binary files /dev/null and b/images/C/toolbox/text-kerning.png differ
diff --git a/images/C/toolbox/text-selected.png b/images/C/toolbox/text-selected.png
new file mode 100644
index 0000000..dca3169
Binary files /dev/null and b/images/C/toolbox/text-selected.png differ
diff --git a/images/C/toolbox/text-spacing.png b/images/C/toolbox/text-spacing.png
new file mode 100644
index 0000000..a086814
Binary files /dev/null and b/images/C/toolbox/text-spacing.png differ
diff --git a/images/C/toolbox/text-to-path1.png b/images/C/toolbox/text-to-path1.png
new file mode 100644
index 0000000..c7abfbc
Binary files /dev/null and b/images/C/toolbox/text-to-path1.png differ
diff --git a/images/C/toolbox/text-to-path2.png b/images/C/toolbox/text-to-path2.png
new file mode 100644
index 0000000..301d401
Binary files /dev/null and b/images/C/toolbox/text-to-path2.png differ
diff --git a/images/C/toolbox/text-to-path3.png b/images/C/toolbox/text-to-path3.png
new file mode 100644
index 0000000..52b4b73
Binary files /dev/null and b/images/C/toolbox/text-to-path3.png differ
diff --git a/images/C/using/text-toolbar.png b/images/C/using/text-toolbar.png
old mode 100755
new mode 100644
index 3325651..8c166e0
Binary files a/images/C/using/text-toolbar.png and b/images/C/using/text-toolbar.png differ
diff --git a/src/concepts/text-management.xml b/src/concepts/text-management.xml
index 610e2eb..3bd122a 100755
--- a/src/concepts/text-management.xml
+++ b/src/concepts/text-management.xml
@@ -2,6 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
+ 2015-12-18 j.h Fix bug #675745: developp text toolbox elements
2012-03-18 j.h: created
-->
<sect1 id="gimp-text-management">
@@ -13,7 +14,7 @@
</indexterm>
<!--FOR TRANSLATORS: this file is a reshaping of the old
- concepts/fonts-and-text.xml file. A large part can be copy-pasted-->
+ 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
@@ -68,238 +69,516 @@
<para>
Text tool options are described in <xref linkend="gimp-tool-text"/>.
</para>
+
+ <sect2 id="text-area">
+ <title>Text Area</title>
+ <indexterm>
+ <primary>Text</primary>
+ <secondary>Text Area</secondary>
+ </indexterm>
+ <para>
+ 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. The box size appears then
+ in the status bar at the bottom of the image:
+ </para>
+ <para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/text-area-size.png"/>
+ </imageobject>
+ </mediaobject>
+ </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 keys</keycap></keycombo> and
+ then use the options of the <xref linkend="gimp-text-toolbox"/>.
+ </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. 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 keys</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 text editor
+ dialog described in <xref linkend="gimp-text-editor-dialog"/>.
+ </para>
- <para>
- Instead of using the on-canvas text editing, you can use the text editor
- dialog described in <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 <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 id="Unicode-characters">
+ You can get Unicode characters with
+ <keycombo>
+ <keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>U</keycap>
+ </keycombo>
+ plus hexadecimal Unicode code of the desired char, for example:
+ </para>
+ <figure>
+ <title>Entering Unicode characters</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/using/enter-unicode-char1.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>Shift</keycap>
+ <keycap>U</keycap>
+ </keycombo>
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/using/enter-unicode-char2.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ <keycombo action="seq">
+ <keycap>4</keycap><keycap>7</keycap>
+ </keycombo>
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/using/enter-unicode-char3.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ <keycap>Enter</keycap>
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ <para>
+ Of course this feature is more useful for entering special (even exotic)
+ characters, provided that the required glyphs for these characters are
+ supplied by the selected font — only few fonts support Klingon.
+ ;-)
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/using/enter-unicode-char4.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ Unicode 0x47 (<quote>G</quote>), 0x2665, 0x0271, 0x03C0
+ </para>
+ </caption>
+ </mediaobject>
- <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>
+ </sect2>
+
+ <sect2 id="managing-text-layer">
+ <title>Managing Text Layer</title>
+ <indexterm>
+ <primary>Text</primary>
+ <secondary>Managing Text Layer</secondary>
+ </indexterm>
+ <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>
+ </sect2>
+
+ <sect2 id="gimp-text-toolbox">
+ <title>Text Toolbox</title>
+ <indexterm>
+ <primary>Text</primary>
+ <secondary>Text Toolbox</secondary>
+ </indexterm>
+ <figure>
+ <title>Text Toolbox</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>
- 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>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <emphasis role="bold">Change font of selected text</emphasis>:
+ as soon as you start editing the default font name, a drop-down
+ list appears, allowing you to select a font.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis role="bold">Change size of selected text</emphasis>:
+ self-explanatory.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis role="bold">Bold, Italic, Underline, Strikethrough
+ </emphasis>: self-explanatory.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis role="bold">Change baseline of selected text</emphasis>:
+ "In European typography and penmanship, baseline is the line upon
+ which most letters "sit" and below which descenders extend"
+ (Wikipedia). In HTML, there are several kinds of baselines
+ (alphabetic, ideographic, bottom…). Here, consider that baseline
+ is "bottom" and determines the place for descenders. The default
+ baseline "0" gives place for descenders. You can use it to
+ increase space between two lines only, while <quote>Adjust line
+ spacing</quote> in tool options increases space between all lines.
+ </para>
+ <para>
+ <figure>
+ <title>Default Baseline</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/text-default-baseline.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ Default baseline marked with a red line.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">Change kerning of selected text</emphasis>:
+ "In typography, kerning… is the process of adjusting the spacing
+ between characters in a proportional font." (Wikipedia). You will
+ probably use this setting to adjust letter spacing of a selected
+ part of text.
+ </para>
+ <para>
+ Let us look at a selected text (zoomx800 to see pixels):
+ </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.
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/text-selected.png"/>
+ </imageobject>
+ </mediaobject>
+
+ <para>
+ We can see that the Sans font is a proportional font: letters
+ widths are different, and <quote>T</quote> glyph comes over
+ the <quote>e</quote>. Letters widths are marked with thin
+ vertical lines and left borders of letter width cover
+ preceding letters by one pixel. Now we set <quote>Change
+ kerning of selected text</quote> to 2 pixels:
</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/text-kerning.png"/>
+ </imageobject>
+ </mediaobject>
+
<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.
+ Blank spaces, 2 pixels wide, are added between all selected
+ characters and letter widths are preserved. If no text is
+ selected, a blank space is added at the place of the mouse
+ pointer between two characters.
</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.
+ Now, we compare with the <quote>Adjust letter spacing</quote>
+ option of Text tool:
</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/text-spacing.png"/>
+ </imageobject>
+ </mediaobject>
+
<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:
+ The option applies to the whole text, not only to the selected
+ text. Blank spaces are added inside letters widths and
+ letter widths are not respected.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ You can also use <keycombo><keycap>Alt</keycap><keycap>arrow keys</keycap>
+ </keycombo> to change baseline offset and kerning.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis role="bold">Change color of selected text</emphasis>:
+ this command opens a color dialog where you choose a color for
+ the selected text.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis role="bold">Clear style of selected text</emphasis>:
+ using this command, you can get rid of all new settings you
+ applied to the selected text.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
+ <sect2 id="text-context-menu">
+ <title>Text Context Menu</title>
+ <indexterm>
+ <primary>Text</primary>
+ <secondary>Context Menu</secondary>
+ </indexterm>
+ <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>
+ <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
+ full of text.
+ </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 id="gimp-layer-text-to-path">
+ <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>
- <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>
+ <title>Text to path applied</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/using/text-warning.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/toolbox/text-to-path1.png"/>
</imageobject>
+ <caption>
+ <para>
+ Nothing appears.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ <figure>
+ <title>Path made visible</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/text-to-path2.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ Path made visible in Path tab. Path appears
+ as a red border around text.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ <figure>
+ <title>Path tool activated</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/text-to-path3.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ Path tool activated; click on path.
+ </para>
+ </caption>
</mediaobject>
</figure>
</listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Text Editing Context Menu</term>
- <listitem>
+ <listitem id="gimp-layer-text-along-path">
+ <para>
+ <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>Text Editing Context Menu</title>
+ <title>
+ The Text along Path command among text commands in the Layer
+ menu
+ </title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
- fileref="images/toolbox/text-editing-context-menu.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>
- You get this menu by right-clicking on text. It is somewhat different
- from that of the Text Editor dialog.
+ 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>
-
- <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
- full of text.
- </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>
- <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>
+ </itemizedlist>
+ </sect2>
</sect1>
\ No newline at end of file
diff --git a/src/gimp.xml b/src/gimp.xml
index ba7044d..d34bf1e 100755
--- 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:
+ 2015-12-16 j.h: deleted text-toolbox, included in text-management
2012-04-01 j.h: add tools-presets
2012-03-18 j.h: add text-tool-box.xml
2012-03-06 j.h: add layer-groups.xml
@@ -38,6 +39,7 @@
<year>2012</year>
<year>2013</year>
<year>2014</year>
+ <year>2015</year>
<holder>The GIMP Documentation Team</holder>
</copyright>
<legalnotice>
@@ -133,7 +135,6 @@
<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
index 03129c3..05ffad6 100755
--- a/src/menus/layer/text-commands.xml
+++ b/src/menus/layer/text-commands.xml
@@ -28,10 +28,10 @@
<para><xref linkend="gimp-layer-text-discard"/></para>
</listitem>
<listitem>
- <para><link linkend="path-from-text">Text to Path</link></para>
+ <para><link linkend="gimp-layer-text-to-path">Text to Path</link></para>
</listitem>
<listitem>
- <para><link linkend="text-along-path">Text along Path</link></para>
+ <para><link linkend="gimp-layer-text-along-path">Text along Path</link></para>
</listitem>
<listitem>
<indexterm>
diff --git a/src/toolbox/text.xml b/src/toolbox/text.xml
index e3b6d58..4fa3939 100755
--- a/src/toolbox/text.xml
+++ b/src/toolbox/text.xml
@@ -2,6 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
+ 2015-12-12 j.h fix bug #675745: add on-canvas editor
2012-03-18 j.h: update to v2.7
2009-07-09 ude: added scroll wheel tip (#585823),
fixed "entering special chars" (#580532)
@@ -53,12 +54,13 @@
<mediaobject>
<imageobject>
- <imagedata format="PNG" fileref="images/using/text-tool.png"/>
+ <imagedata format="PNG" fileref="images/using/text-toolbar.png"/>
</imageobject>
</mediaobject>
<para>
- 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.
+ In this chapter, tool options will be described. To know how to use the
+ Text tool, please refer to <link linkend="gimp-text-management">text
+ management</link>.
</para>
@@ -172,7 +174,7 @@
</listitem>
</varlistentry>
- <varlistentry> <!--Added-->
+ <varlistentry>
<term>Use editor</term>
<listitem>
<para>
@@ -302,120 +304,7 @@
</varlistentry>
</variablelist>
</sect3>
-
- <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 full of text.
- </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="path-from-text">
- <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 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">
<title>Text Editor</title>
@@ -438,11 +327,8 @@
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
- font with the Font Editor.
+ direct-on-canvas mode. We will
+ limit description to commands that has not been transferred.
</para>
<para>
As soon as you start writing, a Text layer is created in the Layer
@@ -458,73 +344,6 @@
text to another one activate the corresponding text layer and click on
it to activate the editor.
</para>
- <!--cf. bug #580532 (2009-06-15)-->
- <para>
- You can get Unicode characters with
- <keycombo>
- <keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>U</keycap>
- </keycombo>
- plus hexadecimal Unicode code of the desired char, for example:
- </para>
- <figure>
- <title>Entering Unicode characters</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/using/enter-unicode-char1.png"/>
- </imageobject>
- <caption>
- <para>
- <keycombo>
- <keycap>Ctrl</keycap>
- <keycap>Shift</keycap>
- <keycap>U</keycap>
- </keycombo>
- </para>
- </caption>
- </mediaobject>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/using/enter-unicode-char2.png"/>
- </imageobject>
- <caption>
- <para>
- <keycombo action="seq">
- <keycap>4</keycap><keycap>7</keycap>
- </keycombo>
- </para>
- </caption>
- </mediaobject>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/using/enter-unicode-char3.png"/>
- </imageobject>
- <caption>
- <para>
- <keycap>Enter</keycap>
- </para>
- </caption>
- </mediaobject>
- </figure>
- <para>
- Of course this feature is more useful for entering special (even exotic)
- characters, provided that the required glyphs for these characters are
- supplied by the selected font — only few fonts support Klingon.
- ;-)
- </para>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/using/enter-unicode-char4.png"/>
- </imageobject>
- <caption>
- <para>
- Unicode 0x47 (<quote>G</quote>), 0x2665, 0x0271, 0x03C0
- </para>
- </caption>
- </mediaobject>
<variablelist>
<title>The Text Editor options</title>
@@ -539,14 +358,8 @@
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>Clear all text</term>
- <listitem>
<para>
- Clicking this icon clears the editor and the associated text on
- the image.
+ This option is also in the text context menu.
</para>
</listitem>
</varlistentry>
@@ -558,6 +371,9 @@
is the case with most Western languages and may Eastern
languages.
</para>
+ <para>
+ This option is also in the text context menu.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -568,6 +384,9 @@
the case with some Eastern languages, such as Arabic (illustrated
in the icon).
</para>
+ <para>
+ This option is also in the text context menu.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
