Syncing docs (README + EXTENDING) re: Text/Label "paste"
This commit is contained in:
Bill Kendrick
parent
023fafe54f
commit
c7d449888d
29 changed files with 766 additions and 126 deletions
|
|
@ -5,7 +5,7 @@
|
|||
Copyright © 2002-2024 by various contributors; AUTHORS.txt 参照.
|
||||
https://tuxpaint.org/
|
||||
|
||||
2024年10月10日
|
||||
2024年12月25日
|
||||
|
||||
+-----------------------------------------+
|
||||
| 目次 |
|
||||
|
|
@ -958,11 +958,11 @@ source code ("/src/im.c"), and requires updates to the Makefile, to ensure the
|
|||
画面キーボード
|
||||
|
||||
As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an
|
||||
on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems,
|
||||
etc.) to be used to input characters. Files that describe the layout and
|
||||
available keys are stored in Tux Paint "osk" directory. Each keyboard layout is
|
||||
defined by a number of files (some of which may be shared by different
|
||||
layouts).
|
||||
on-screen keyboard that allows the pointer (via a mouse, touch screen,
|
||||
eye-tracking systems, etc.) to be used to input characters. Files that describe
|
||||
the layout and available keys are stored in Tux Paint "osk" directory. Each
|
||||
keyboard layout is defined by a number of files (some of which may be shared by
|
||||
different layouts).
|
||||
|
||||
We'll use the QWERTY keyboard as an example:
|
||||
|
||||
|
|
@ -979,7 +979,7 @@ and key mappings.
|
|||
|
||||
⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text
|
||||
following a "#" (pound/hash) character — it can be used to denote comments, as
|
||||
seen in the example above.
|
||||
seen in the example below.
|
||||
|
||||
The "keyboardlist" line describes which layouts to switch to, when the user
|
||||
clicks the left and right buttons on the keyboard. (See below.)
|
||||
|
|
@ -996,6 +996,9 @@ been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] +
|
|||
(use "1") or [AltGr] (alternate graphics) key (use "2"), or not at all (use
|
||||
"0").
|
||||
|
||||
The "NEWLINE" keyword is used to indicate the end of one row of the keyboard,
|
||||
and thus subsequent key layout descriptions will be beginning on a new row.
|
||||
|
||||
WIDTH 15
|
||||
HEIGHT 5
|
||||
|
||||
|
|
@ -1031,10 +1034,14 @@ been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] +
|
|||
KEY 64 2.0 Alt Alt Alt Alt 0
|
||||
|
||||
# Space
|
||||
KEY 65 7.0 SPACE SPACE SPACE SPACE 0
|
||||
KEY 65 5.0 SPACE SPACE SPACE SPACE 0
|
||||
|
||||
# AltGr
|
||||
KEY 108 2.0 AltGr AltGr AltGr AltGr 0
|
||||
|
||||
# Paste
|
||||
KEY 143 2.0 Paste Paste Paste Paste 0
|
||||
|
||||
# Arrow to right will change to the next keyboard
|
||||
KEY 1 1.0 -> -> -> -> 0
|
||||
|
||||
|
|
@ -1048,6 +1055,11 @@ described below.
|
|||
* 1 — next layout (per the layout file's "keyboardlist" setting)
|
||||
* 2 — previous layout (per the layout file's "keyboardlist" setting)
|
||||
|
||||
📜 Starting with Tux Paint 0.9.35, the XF86Paste keysym (value 143) can be used
|
||||
to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in
|
||||
the keyboard layout files. (Pasting via a physical keyboard is initiated using
|
||||
the [Control] + [V] key combination.
|
||||
|
||||
### Keymap file ("us-intl-altgr-dead-keys.keymap") ###
|
||||
|
||||
This file defines which numeric keycodes (seen in the keyboard layout files,
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@
|
|||
Copyright © 2002-2024 by various contributors; AUTHORS.txt 参照.
|
||||
https://tuxpaint.org/
|
||||
|
||||
2024年10月25日
|
||||
2024年12月25日
|
||||
|
||||
+--------------------------------------------------+
|
||||
| 目次 |
|
||||
|
|
@ -101,6 +101,9 @@ Tux Paint は、オープンソースのプロジェクトで、GNUの一般公
|
|||
Better behavior when clicking/tapping and dragging hue/saturation box and
|
||||
value slider.
|
||||
|
||||
→ Text clipboard paste support ←
|
||||
The "Text" and "Label" tools support pasting the copy/paste clipboard.
|
||||
|
||||
|
||||
全ての変更点については、CHANGES.txt をお読みください。
|
||||
|
||||
|
|
@ -444,6 +447,13 @@ e.「もじ」ツール、「ラベル」ツール ←
|
|||
側に移動します。これは、１行の中で異なったフォント、字体、フォントサイズ、
|
||||
色などを混在させたい場合に便利な方法です。
|
||||
|
||||
Text from the clipboard (copy/paste buffer) can be inserted with the "Text"
|
||||
and "Label" tools by pressing the [Control] + [V] key combination on a
|
||||
physical keyboard, or clicking the "Paste" button in Tux Paint's on-screen
|
||||
keyboard. The text will wrap to the next line if it hits the right edge of
|
||||
the canvas. If the text hits the bottom of the canvas, the pasting will
|
||||
abort, truncating the text.
|
||||
|
||||
文字の入力中に別の場所をクリックすると、入力内容を維持したまま、文字を貼り
|
||||
付ける位置をクリックした位置に移動させ、文字入力を続けることができます。
|
||||
|
||||
|
|
@ -477,6 +487,9 @@ e.「もじ」ツール、「ラベル」ツール ←
|
|||
⚙ 「ラベル」ツールは、Tux Paint 設定ツールや、"nolabel"オプションによ
|
||||
り、無効にすることができます。
|
||||
|
||||
📜 The ability to paste text from the clipboard was added in Tux Paint
|
||||
0.9.35
|
||||
|
||||
|
||||
|
||||
→ 多言語文字入力 ←
|
||||
|
|
@ -506,9 +519,39 @@ e.「もじ」ツール、「ラベル」ツール ←
|
|||
|
||||
→ 画面キーボード ←
|
||||
|
||||
「もじ」ツールや「ラベル」ツールで使える、オプションの「スクリーンキー
|
||||
ボード」では、キーボードレイアウトを変えたり、文字の合成（例: "a "と "e
|
||||
"を "æ "に合成）を行うことができます。
|
||||
An optional on-screen keyboard is available for the Text and Label
|
||||
tools, which can provide a variety of layouts and character composition
|
||||
(e.g., composing "a" and "e" into "æ"). Run Tux Paint with the
|
||||
"--onscreen-keyboard" option, or enable that setting in Tux Paint's
|
||||
configuration file, to enable it. Multiple layouts are offered
|
||||
(currently "QWERTY" and "ABC"), which the user can switch between.
|
||||
Additional configuration options allow specifying a default layout, as
|
||||
well as preventing the layout from being changed.
|
||||
|
||||
The on-screen keyboard appears at the bottom or top of the Tux Paint
|
||||
window, obscuring part of the canvas, depending on where the text
|
||||
insertion cursor is placed. Along with alphabetic, numeric, and some
|
||||
punctuation keys, the keyboard provides:
|
||||
@ A "Backspace" key (⇐) to remove the previous character
|
||||
@ A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current
|
||||
input and begin a new one on the following line (below and to the
|
||||
left)
|
||||
@ A "Tab" key (⇔) to end the current input and begin a new one at the
|
||||
current cursor position
|
||||
@ A "Shift" key (⇑) to shift alphabetic keys from lowercase to
|
||||
uppercase, access more punctuation, etc.
|
||||
@ A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic
|
||||
keys from lowercase to uppercase (click it again to disable caps
|
||||
lock)
|
||||
@ A "Compose" key ("Cmp"), to initiate character composition (e.g.,
|
||||
click "Cmp", "a", "e" to produce an "æ" character)
|
||||
@ An "Alternate Graphics" key ("AltGr") to access additional
|
||||
characters (e.g., "¿", "ß", etc.)
|
||||
@ An "Alternate" key ("Alt")
|
||||
@ A "Paste" key to paste the current clipboard's text into the Text
|
||||
or Label tool
|
||||
@ Left and right arrows (← & →) to access different on-screen
|
||||
keyboard layouts
|
||||
|
||||
⚙ 詳細については "各種設定について" と "Tux Paintの拡張" のドキュメント
|
||||
を参照してください。
|
||||
|
|
|
|||
|
|
@ -100,7 +100,7 @@
|
|||
</p>
|
||||
|
||||
<p>
|
||||
2024年10月10日 </p>
|
||||
2024年12月25日 </p>
|
||||
</center>
|
||||
</header>
|
||||
|
||||
|
|
@ -1118,7 +1118,7 @@
|
|||
</header>
|
||||
|
||||
<p>
|
||||
As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts). </p>
|
||||
As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, touch screen, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts). </p>
|
||||
<p>
|
||||
We'll use the QWERTY keyboard as an example: </p>
|
||||
|
||||
|
|
@ -1142,7 +1142,7 @@
|
|||
</blockquote>
|
||||
|
||||
<p class="note">
|
||||
<span title="Configuration option">⚙</span> <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example above. </p>
|
||||
<span title="Configuration option">⚙</span> <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example below. </p>
|
||||
|
||||
<p>
|
||||
The "<code>keyboardlist</code>" line describes which layouts to switch to, when the user clicks the left and right buttons on the keyboard. (See below.) </p>
|
||||
|
|
@ -1157,6 +1157,9 @@
|
|||
<p>
|
||||
This describes how big the keyboard is (as a "width × height" grid), and lists each key with its numeric keycode (see the "<code>keymap</code>" file, below), the width it should be drawn at (typically "<code>1.0</code>", to take one space on the keyboard, but in the example below, notice the "<code>TAB</code>" and "<code>SPACE</code>" keys are much wider), the character or text to display on the key, depending on which modifier keys have been pressed (one each for: no modifiers, <b><code>[Shift]</code></b>, <b><code>[AltGr]</code></b>, and <b><code>[Shift]</code></b> + <b><code>[AltGr]</code></b>), and finally whether or not the key is affected by the <b><code>[CapsLock]</code></b> key (use "<code>1</code>") or <b><code>[AltGr]</code></b> (alternate graphics) key (use "<code>2</code>"), or not at all (use "<code>0</code>"). </p>
|
||||
|
||||
<p>
|
||||
The "<code>NEWLINE</code>" keyword is used to indicate the end of one row of the keyboard, and thus subsequent key layout descriptions will be beginning on a new row. </p>
|
||||
|
||||
<blockquote>
|
||||
<p>
|
||||
<code>WIDTH 15<br>
|
||||
|
|
@ -1193,10 +1196,14 @@
|
|||
KEY 64 2.0 Alt Alt Alt Alt 0<br>
|
||||
<br>
|
||||
# Space<br>
|
||||
KEY 65 7.0 SPACE SPACE SPACE SPACE 0<br>
|
||||
KEY 65 5.0 SPACE SPACE SPACE SPACE 0<br>
|
||||
<br>
|
||||
# AltGr<br>
|
||||
KEY 108 2.0 AltGr AltGr AltGr AltGr 0<br>
|
||||
<br>
|
||||
# Paste<br>
|
||||
KEY 143 2.0 Paste Paste Paste Paste 0<br>
|
||||
<br>
|
||||
# Arrow to right will change to the next keyboard<br>
|
||||
KEY 1 1.0 -> -> -> -> 0</code>
|
||||
</p>
|
||||
|
|
@ -1221,6 +1228,10 @@
|
|||
<code>2</code> —
|
||||
previous layout (per the layout file's "<code>keyboardlist</code>" setting) </li>
|
||||
</ul>
|
||||
|
||||
<p class="note">
|
||||
<span title="Version variation">📜</span> Starting with Tux Paint 0.9.35, the <code>XF86Paste</code> keysym (value 143) can be used to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in the keyboard layout files. (Pasting via a physical keyboard is initiated using the <code>[Control]</code> + <code>[V]</code> key combination. </p>
|
||||
|
||||
</section><!-- H2: Keyboard layout file ("qwerty.h_layout") -->
|
||||
|
||||
<section><!-- H2: Keymap file ("us-intl-altgr-dead-keys.keymap") -->
|
||||
|
|
|
|||
|
|
@ -102,7 +102,7 @@
|
|||
</p>
|
||||
|
||||
<p>
|
||||
2024年10月25日 </p>
|
||||
2024年12月25日 </p>
|
||||
</center>
|
||||
</header>
|
||||
<table border="2"
|
||||
|
|
@ -230,6 +230,9 @@
|
|||
<dl>
|
||||
<dt>Improved color picker</dt>
|
||||
<dd>Better behavior when clicking/tapping and dragging hue/saturation box and value slider.</dd>
|
||||
|
||||
<dt>Text clipboard paste support</dt>
|
||||
<dd>The "Text" and "Label" tools support pasting the copy/paste clipboard.</dd>
|
||||
</dl>
|
||||
|
||||
<p>
|
||||
|
|
@ -819,6 +822,9 @@
|
|||
<p>
|
||||
また、<strong><code>[Tab]</code></strong>キーを押すと、文字が描画された後、カーソルは、次の行ではなく、右側に移動します。これは、１行の中で異なったフォント、字体、フォントサイズ、色などを混在させたい場合に便利な方法です。 </p>
|
||||
|
||||
<p>
|
||||
Text from the clipboard (copy/paste buffer) can be inserted with the "Text" and "Label" tools by pressing the <strong><code>[Control]</code> + <code>[V]</code></strong> key combination on a physical keyboard, or clicking the "<strong>Paste</strong>" button in Tux Paint's on-screen keyboard. The text will wrap to the next line if it hits the right edge of the canvas. If the text hits the bottom of the canvas, the pasting will abort, truncating the text. </p>
|
||||
|
||||
<p>
|
||||
文字の入力中に別の場所をクリックすると、入力内容を維持したまま、文字を貼り付ける位置をクリックした位置に移動させ、文字入力を続けることができます。 </p>
|
||||
|
||||
|
|
@ -849,6 +855,9 @@
|
|||
|
||||
<p class="note">
|
||||
<span title="Configuration option">⚙</span> <strong>「ラベル」</strong>ツールは、<em>Tux Paint 設定ツール</em>や、"<code>nolabel</code>"オプションにより、無効にすることができます。 </p>
|
||||
|
||||
<p class="note">
|
||||
<span title="Version variation">📜</span> The ability to paste text from the clipboard was added in Tux Paint 0.9.35 </p>
|
||||
</dd>
|
||||
|
||||
<dt>
|
||||
|
|
@ -886,7 +895,23 @@
|
|||
|
||||
<dd>
|
||||
<p>
|
||||
「もじ」ツールや「ラベル」ツールで使える、オプションの「スクリーンキーボード」では、キーボードレイアウトを変えたり、文字の合成（例: "a "と "e "を "æ "に合成）を行うことができます。 </p>
|
||||
An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ"). Run Tux Paint with the "<code>--onscreen-keyboard</code>" option, or enable that setting in Tux Paint's configuration file, to enable it. Multiple layouts are offered (currently "QWERTY" and "ABC"), which the user can switch between. Additional configuration options allow specifying a default layout, as well as preventing the layout from being changed. </p>
|
||||
|
||||
<p>
|
||||
The on-screen keyboard appears at the bottom or top of the Tux Paint window, obscuring part of the canvas, depending on where the text insertion cursor is placed. Along with alphabetic, numeric, and some punctuation keys, the keyboard provides: <ul>
|
||||
<li>A "Backspace" key (⇐) to remove the previous character</li>
|
||||
<li>A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current input and begin a new one on the following line (below and to the left)</li>
|
||||
<li>A "Tab" key (⇔) to end the current input and begin a new one at the current cursor position</li>
|
||||
<li>A "Shift" key (⇑) to shift alphabetic keys from lowercase to uppercase, access more punctuation, etc.</li>
|
||||
<li>A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic keys from lowercase to uppercase (click it again to disable caps lock)</li>
|
||||
<li>A "Compose" key ("Cmp"), to initiate character composition (e.g., click "Cmp", "a", "e" to produce an "æ" character)</li>
|
||||
<li>An "Alternate Graphics" key ("AltGr") to access additional characters (e.g., "¿", "ß", etc.)</li>
|
||||
<li>An "Alternate" key ("Alt")</li>
|
||||
<li>A "Paste" key to paste the current clipboard's text into the Text or Label tool</li>
|
||||
<li>Left and right arrows (← & →) to access different on-screen keyboard layouts</li>
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<p class="note">
|
||||
<span title="Configuration option">⚙</span> 詳細については "<a href="OPTIONS.html"><em>各種設定について</em></a>" と "<a href="EXTENDING.html"><em>Tux Paintの拡張</em></a>" のドキュメントを参照してください。 </p>
|
||||
</dd>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue