Syncing docs (README + EXTENDING) re: Text/Label "paste"

This commit is contained in:
Bill Kendrick 2024-12-25 11:45:31 -08:00
parent 023fafe54f
commit c7d449888d
29 changed files with 766 additions and 126 deletions

View file

@ -6,7 +6,7 @@
Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
octubre 25, 2024
diciembre 25, 2024
+-------------------------------------------------+
| Table of Contents |
@ -103,6 +103,9 @@ See COPYING.txt for the full text of the GPL license.
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.
See CHANGES.txt for the complete list of changes.
@ -489,6 +492,13 @@ e."Text" and "Label" Tools ←
to the left. (This can be useful to create a line of text with mixed
colors, fonts, styles and sizes.)
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.
Clicking elsewhere in the picture while the text entry is still active
causes the current line of text to move to that location (where you can
continue editing it).
@ -527,6 +537,9 @@ e."Text" and "Label" Tools ←
Tool" in Tux Paint Config. or running Tux Paint with the "nolabel"
option).
📜 The ability to paste text from the clipboard was added in Tux Paint
0.9.35
→ International Character Input ←
@ -560,7 +573,37 @@ e."Text" and "Label" Tools ←
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 "æ").
(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
⚙ See the "Options" and "Extending Tux Paint" documentation for more
information.