[gimp-help-2] Update Paste commands
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Update Paste commands
- Date: Mon, 30 Apr 2018 06:36:35 +0000 (UTC)
commit 2b0e56dc686606283571114ab10fd0a4e3bac0a5
Author: Julien Hardelin <jhardlin orange fr>
Date: Mon Apr 30 08:35:52 2018 +0200
Update Paste commands
images/C/dialogs/symmetry.png | Bin 0 -> 1238 bytes
images/C/menus/edit.png | Bin 33869 -> 32931 bytes
images/C/menus/edit/paste-as.png | Bin 3462 -> 6499 bytes
src/dialogs/buffers-dialog.xml | 12 ++--
src/dialogs/symmetry-painting.xml | 35 +++++++++-----
src/menus/edit.xml | 4 +-
src/menus/edit/copy.xml | 6 ++-
.../{paste-as-new.xml => paste-as-new-image.xml} | 9 ++-
...s-layer.xml => paste-as-new-layer-in-place.xml} | 22 ++++----
.../{paste-as-layer.xml => paste-as-new-layer.xml} | 0
src/menus/edit/paste-as.xml | 12 +++--
src/menus/edit/paste-in-place.xml | 36 ++++++++++++++
src/menus/edit/paste-into-selection-in-place.xml | 36 ++++++++++++++
src/menus/edit/paste-into-selection.xml | 44 ++++++++++++++++++
src/menus/edit/paste-into.xml | 49 --------------------
src/menus/edit/paste.xml | 2 +-
src/menus/file/create.xml | 3 +-
17 files changed, 179 insertions(+), 91 deletions(-)
---
diff --git a/images/C/dialogs/symmetry.png b/images/C/dialogs/symmetry.png
new file mode 100644
index 0000000..4e9f42b
Binary files /dev/null and b/images/C/dialogs/symmetry.png differ
diff --git a/images/C/menus/edit.png b/images/C/menus/edit.png
index ada28cb..5486552 100644
Binary files a/images/C/menus/edit.png and b/images/C/menus/edit.png differ
diff --git a/images/C/menus/edit/paste-as.png b/images/C/menus/edit/paste-as.png
index daf17d1..c4a1bc4 100644
Binary files a/images/C/menus/edit/paste-as.png and b/images/C/menus/edit/paste-as.png differ
diff --git a/src/dialogs/buffers-dialog.xml b/src/dialogs/buffers-dialog.xml
index 39c7057..0f65ee6 100644
--- a/src/dialogs/buffers-dialog.xml
+++ b/src/dialogs/buffers-dialog.xml
@@ -211,9 +211,9 @@
This command pastes the contents of the selected buffer into
the active image's selection, as a floating selection. The
only difference between this and the ordinary
- <link linkend="gimp-edit-paste-into">Paste Into</link> command is
- that it uses the selected buffer rather than the global
- clipboard buffer.
+ <link linkend="gimp-edit-paste-into">Paste Into
+ Selection</link> command is that it uses the selected buffer
+ rather than the global clipboard buffer.
</para>
</listitem>
</varlistentry>
@@ -225,9 +225,9 @@
This command creates a new single-layer image out of the
contents of the selected buffer. The only difference between
this and the ordinary
- <link linkend="gimp-edit-paste-as-new">Paste as New</link> command
- is that it uses the selected buffer rather than the content
- of the global clipboard buffer.
+ <link linkend="gimp-edit-paste-as-new-image">Paste as New
+ Image</link> command is that it uses the selected buffer rather
+ than the content of the global clipboard buffer.
</para>
</listitem>
</varlistentry>
diff --git a/src/dialogs/symmetry-painting.xml b/src/dialogs/symmetry-painting.xml
index 9417881..48e57be 100644
--- a/src/dialogs/symmetry-painting.xml
+++ b/src/dialogs/symmetry-painting.xml
@@ -12,26 +12,20 @@
<indexterm>
<primary>Symmetry Painting</primary>
</indexterm>
- <figure>
- <title>Symmetry Painting dialog</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/dialogs/symmetry-painting.png"
+ <imagedata fileref="images/dialogs/symmetry.png"
format="PNG" />
</imageobject>
</mediaobject>
- </figure>
-
- <para>
+
+ <para>
Symmetry Painting is a new painting feature in GIMP-2.10, supported by
brush-based tools (Pencil, Paintbrush, Eraser, Airbrush, MyPaint brush,
Clone, Smudge, Dodge) as well the Ink tool. There are several kinds of
symmetry, all configurable.
</para>
- <para>
- With these feature, GIMP's digital painting possibilities are increased.
- </para>
<sect3>
<title>Activating the Dialog</title>
@@ -54,7 +48,16 @@
<sect3>
<title>Using the Symmetry Painting dialog</title>
-
+ <figure>
+ <title>Symmetry Painting dialog</title>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/dialogs/symmetry-painting.png"
+ format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </figure>
<para>
This dialog is very simple. You only have a <guilabel>Symmetry</guilabel>
item with a drop down list that offers four options. As soon as you check
@@ -114,6 +117,12 @@
<varlistentry>
<term>Tiling</term>
<listitem>
+ <para>
+ <quote>Tiling</quote> is a translational symmetry, which can be
+ finite (with a maximum of strokes) or infinite. In the latter case,
+ it is the perfect tool to create patterns or seamless tiles, at
+ painting time.
+ </para>
<figure>
<title>The Symmetry Tiling Dialog</title>
<mediaobject>
@@ -224,7 +233,7 @@
</imageobject>
<caption>
<para>
- Click and drag
+ A stroke
</para>
</caption>
</mediaobject>
@@ -254,7 +263,7 @@
</imageobject>
<caption>
<para>
- Click and drag
+ A stroke
</para>
</caption>
</mediaobject>
@@ -284,7 +293,7 @@
</imageobject>
<caption>
<para>
- Click and drag
+ A stroke
</para>
</caption>
</mediaobject>
diff --git a/src/menus/edit.xml b/src/menus/edit.xml
index 349ea6e..5d9139c 100644
--- a/src/menus/edit.xml
+++ b/src/menus/edit.xml
@@ -29,7 +29,9 @@
<xi:include href="edit/copy.xml"/>
<xi:include href="edit/copy-visible.xml"/>
<xi:include href="edit/paste.xml"/>
- <xi:include href="edit/paste-into.xml"/>
+ <xi:include href="edit/paste-into-selection.xml"/>
+ <xi:include href="edit/paste-in-place.xml"/>
+ <xi:include href="edit/paste-into-selection-in-place.xml"/>
<xi:include href="edit/paste-as.xml"/>
<xi:include href="edit/buffer.xml"/>
<!-- separator -->
diff --git a/src/menus/edit/copy.xml b/src/menus/edit/copy.xml
index 5784fe1..a296fbd 100644
--- a/src/menus/edit/copy.xml
+++ b/src/menus/edit/copy.xml
@@ -22,8 +22,10 @@
a copy of the current selection and stores it in the Clipboard. The
information can be recalled using the
<link linkend="gimp-edit-paste">Paste</link>,
- <link linkend="gimp-edit-paste-into">Paste Into</link>, or
- <link linkend="gimp-edit-paste-as-new">Paste As New</link> commands. If
+ <link linkend="gimp-edit-paste-into">Paste Into Selection</link>,
+or
+ <link linkend="gimp-edit-paste-as-new-image">Paste As / New Image</link>
+commands. If
there is no selection, the entire current layer is
copied. <quote>Copy</quote> only works on the current active
layer. Any layers above or below it are ignored.
diff --git a/src/menus/edit/paste-as-new.xml b/src/menus/edit/paste-as-new-image.xml
similarity index 85%
rename from src/menus/edit/paste-as-new.xml
rename to src/menus/edit/paste-as-new-image.xml
index 1d51cc0..ec24487 100644
--- a/src/menus/edit/paste-as-new.xml
+++ b/src/menus/edit/paste-as-new-image.xml
@@ -2,9 +2,9 @@
<!DOCTYPE sect3 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2007-10-10 j.h : updated en;fr to v2.4
+ 2018-04-29 j.h : update to v2.10
-->
-<sect3 id="gimp-edit-paste-as-new">
+<sect3 id="gimp-edit-paste-as-new-image">
<title>Paste as New Image</title>
<indexterm>
@@ -41,7 +41,10 @@
<guimenu>Edit</guimenu>
<guisubmenu>Paste as</guisubmenu>
<guimenuitem>New Image</guimenuitem>
- </menuchoice>.
+ </menuchoice>,
+ or using the keyboard shortcut
+ <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>V
+ </keycap></keycombo >.
</para>
</sect4>
</sect3>
diff --git a/src/menus/edit/paste-as-layer.xml b/src/menus/edit/paste-as-new-layer-in-place.xml
similarity index 53%
copy from src/menus/edit/paste-as-layer.xml
copy to src/menus/edit/paste-as-new-layer-in-place.xml
index 646055f..5413fbb 100644
--- a/src/menus/edit/paste-as-layer.xml
+++ b/src/menus/edit/paste-as-new-layer-in-place.xml
@@ -2,10 +2,10 @@
<!DOCTYPE sect3 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2009-01-06 j.h : Created
+ 2018-04-29 j.h : Created
-->
-<sect3 id="gimp-edit-paste-as-new-layer">
- <title>Paste as New Layer</title>
+<sect3 id="gimp-edit-paste-as-new-layer-in-place">
+ <title>Paste As New Layer In Place</title>
<indexterm>
<primary>Layer</primary>
@@ -16,16 +16,16 @@
<secondary>Paste</secondary>
</indexterm>
<indexterm>
- <primary>Paste as New Layer</primary>
+ <primary>Paste as New Layer in Place</primary>
</indexterm>
<para>
- The <guimenuitem>Paste As New Layer</guimenuitem> command creates a new
- layer in the active image and pastes the image data from the Clipboard
- into it. If the data are not rectangular or square in shape, any regions
- that do not extend to the edge of the canvas are left transparent (an
- Alpha channel is automatically created). Of course, you have to Copy your
- selection before you use this command.
+ The <guimenuitem>Paste As New Layer In Place</guimenuitem> command creates
+ a new layer in the active image and pastes the clipboard contents at exact
+ coordinates the contents was originally copied from.
+ </para>
+ <para>
+ This feature is available for both the regular clipboard and named buffers.
</para>
<sect4>
@@ -35,7 +35,7 @@
<menuchoice>
<guimenu>Edit</guimenu>
<guisubmenu>Paste as</guisubmenu>
- <guimenuitem>New Layer</guimenuitem>
+ <guimenuitem>New Layer In Place</guimenuitem>
</menuchoice>.
</para>
</sect4>
diff --git a/src/menus/edit/paste-as-layer.xml b/src/menus/edit/paste-as-new-layer.xml
similarity index 100%
rename from src/menus/edit/paste-as-layer.xml
rename to src/menus/edit/paste-as-new-layer.xml
diff --git a/src/menus/edit/paste-as.xml b/src/menus/edit/paste-as.xml
index 67736eb..9f6ee82 100644
--- a/src/menus/edit/paste-as.xml
+++ b/src/menus/edit/paste-as.xml
@@ -38,10 +38,13 @@
<para>
<itemizedlist>
<listitem>
- <para><xref linkend="gimp-edit-paste-as-new"/></para>
+ <para><xref linkend="gimp-edit-paste-as-new-layer"/></para>
</listitem>
<listitem>
- <para><xref linkend="gimp-edit-paste-as-new-layer"/></para>
+ <para><xref linkend="gimp-edit-paste-as-new-layer-in-place"/></para>
+ </listitem>
+ <listitem>
+ <para><xref linkend="gimp-edit-paste-as-new-image"/></para>
</listitem>
<listitem>
<para><xref linkend="script-fu-paste-as-brush"/></para>
@@ -51,8 +54,9 @@
</listitem>
</itemizedlist>
</para>
- <xi:include href="paste-as-new.xml"/>
- <xi:include href="paste-as-layer.xml"/>
+ <xi:include href="paste-as-new-layer.xml"/>
+ <xi:include href="paste-as-new-layer-in-place.xml"/>
+ <xi:include href="paste-as-new-image.xml"/>
<xi:include href="paste-as-brush.xml"/>
<xi:include href="paste-as-pattern.xml"/>
</sect2>
diff --git a/src/menus/edit/paste-in-place.xml b/src/menus/edit/paste-in-place.xml
new file mode 100644
index 0000000..9692900
--- /dev/null
+++ b/src/menus/edit/paste-in-place.xml
@@ -0,0 +1,36 @@
+<?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:
+ 2018-04-27 j.h: created
+-->
+<sect2 id="gimp-edit-paste-in-place">
+ <title>Paste In Place</title>
+
+ <indexterm>
+ <primary>Selection</primary>
+ <secondary>Paste In Place</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Paste In Place</primary>
+ </indexterm>
+
+ <para>
+ The usual Paste command places the contents of the clipboard into the
+ center of canvas. With this command, you can paste the contents of the
+ clipboard at exact coordinates the contents was originally copied from.
+ This feature is available for both the regular clipboard and named
+ buffers.
+ </para>
+
+ <sect3>
+ <title>Activate the Command</title>
+ <para>
+ You can access this command from the image menubar through
+ <menuchoice>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Paste In Place</guimenuitem>
+ </menuchoice>.
+ </para>
+ </sect3>
+</sect2>
\ No newline at end of file
diff --git a/src/menus/edit/paste-into-selection-in-place.xml
b/src/menus/edit/paste-into-selection-in-place.xml
new file mode 100644
index 0000000..b82b2ac
--- /dev/null
+++ b/src/menus/edit/paste-into-selection-in-place.xml
@@ -0,0 +1,36 @@
+<?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:
+ 2018-04-28 j.h: created
+-->
+<sect2 id="gimp-edit-paste-into-selection-in-place">
+ <title>Paste Into Selection In Place</title>
+
+ <indexterm>
+ <primary>Selection</primary>
+ <secondary>Paste Into Selection In Place</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Paste Into Selection In Place</primary>
+ </indexterm>
+
+ <para>
+ The Paste Into Selection command places the contents of the clipboard into
+ the center of the selection. With Paste Into Selection In Place, you can
+ paste the contents of the clipboard at exact coordinates the contents was
+ originally copied from. This feature is available for both the regular
+ clipboard and named buffers.
+ </para>
+
+ <sect3>
+ <title>Activate the Command</title>
+ <para>
+ You can access this command from the image menubar through
+ <menuchoice>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Paste Into Selection In Place</guimenuitem>
+ </menuchoice>.
+ </para>
+ </sect3>
+</sect2>
\ No newline at end of file
diff --git a/src/menus/edit/paste-into-selection.xml b/src/menus/edit/paste-into-selection.xml
new file mode 100644
index 0000000..7f92347
--- /dev/null
+++ b/src/menus/edit/paste-into-selection.xml
@@ -0,0 +1,44 @@
+<?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:
+ 2018 j.h: update to 2.10
+-->
+<sect2 id="gimp-edit-paste-into">
+ <title>Paste Into Selection</title>
+
+ <indexterm>
+ <primary>Selection</primary>
+ <secondary>Paste Into Selection</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Paste Into Selection</primary>
+ </indexterm>
+
+ <para>
+ The <guimenuitem>Paste Into Selection</guimenuitem> command acts in a
+ similar way to the <guimenuitem>Paste</guimenuitem> command. The primary
+ difference becomes apparent if there is a selection within the canvas.
+ Unlike the <quote>Paste</quote> command, which simply centers the pasted
+ image data over the selection and replaces the selection with its own,
+ <quote>Paste Into Selection</quote> clips the pasted image data by the
+ existing selection. The new selection can be moved as usual, but it is
+ always clipped by the original selection area.
+ </para>
+ <para>
+ If no selection exists, the <quote>Paste Into Selection</quote> command
+ places the data from the Clipboard into the center of the canvas, as the
+ <quote>Paste</quote> command does.
+ </para>
+
+ <sect3>
+ <title>Activate the Command</title>
+ <para>
+ You can access this command from the image menubar through
+ <menuchoice>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Paste Into Selection</guimenuitem>
+ </menuchoice>.
+ </para>
+ </sect3>
+</sect2>
diff --git a/src/menus/edit/paste.xml b/src/menus/edit/paste.xml
index ebfdf9f..a9b93e6 100644
--- a/src/menus/edit/paste.xml
+++ b/src/menus/edit/paste.xml
@@ -31,7 +31,7 @@
the pasted data. If there is already a selection, the data is pasted
using the selection as a center point. If you want the selection to be
used as a clipping region for the pasted data, you should use
- the <quote>Paste Into</quote> command.
+ the <quote>Paste Into Selection</quote> command.
</para>
<note>
<para>
diff --git a/src/menus/file/create.xml b/src/menus/file/create.xml
index 8ca9155..82ba945 100644
--- a/src/menus/file/create.xml
+++ b/src/menus/file/create.xml
@@ -75,7 +75,8 @@
</para>
<para>
This command has the same action as the
- <link linkend="gimp-edit-paste-as-new">Paste as new</link> command.
+ <link linkend="gimp-edit-paste-as-new-image">Paste as / New Image</link>
+ command.
</para>
<para>
The <keycap>Print Screen</keycap> keyboard key captures the screen and
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
