notgne2/tuxpaint-pencil-sharpener
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Sync'ing docs: grab new "Controlling Tux Paint" section

Browse source
This commit is contained in:
Bill Kendrick 2023-07-09 12:55:23 -07:00
parent b63b070325
commit f530b74a27
27 changed files with 1182 additions and 57 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/is_IS.UTF-8/OPTIONS.txt
View file

@ -1232,7 +1232,7 @@ Accessibility
* To click-and-drag, hold one of the 'click' keys (e.g.,
[Insert]), and use the movement keys (e.g., [Left]).
💡 >Note: The "mouse accessibility" feature works with the
💡 Note: The "mouse accessibility" feature works with the
keyboard mouse controls. With both options enabled,
painting tools can be used to draw by pressing a 'click'
key to start clicking, movement keys to move around (which

84
docs/is_IS.UTF-8/README.txt
View file

@ -6,7 +6,7 @@
Copyright © 2002-2023 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
maí 29, 2023
júlí 9, 2023
+------------------------------------------------------+
|Table of Contents |
@ -35,6 +35,7 @@
| f. "Slides" Command (under "Open") |
| g. "Quit" Command |
| h. Sound Muting |
| E. Controlling Tux Paint |
|III. Loading Other Pictures into Tux Paint |
|IV. Further Reading |
|V. How to Get Help |
@ -124,6 +125,11 @@ D. What's New in Tux Paint version 0.9.31?
dialog) and exported templates (via the New dialog) — can be
disabled. (See the "noerase" configuration option.)
"Controlling Tux Paint" documentation
A brief overview of how Tux Paint can be controlled — mouse,
tablet, touchscreen, joystick, and keyboard — has been added to
the README documentation.
See CHANGES.txt for the complete list of changes.
II. Using Tux Paint
@ -1061,6 +1067,82 @@ D. Available Tools
⚙ See the "Options" documentation.
E. Controlling Tux Paint
1. Using a Mouse or Trackball
Tux Paint's main mode of operation is via any device that appears to your
operating system as a mouse, including standard mice, trackballs, and
trackpads, as well as drawing tablets (usually operated with a stylus) and
touch screens (operated with a finger and/or a stylus) (see "Using a
Tablet or Touchscreen" below for more information).
For drawing and controlling Tux Paint, only a single mouse button is used
— typically, on multi-button mice, this will the left mouse button, but
this can usually be configured at the operating system level. By default,
Tux Paint will ignore input from the other button(s). If a user attempts
to use the other button(s), a pop-up dialog will eventually appear
reminding them that only one button is recognized Tux Paint. However, you
may configure Tux Paint to accept any button as input (see the Options
documentation).
a. Scrolling
Many input devices offer a way to quickly scroll within applications —
many mice have a scroll wheel, trackballs have scroll rings, and trackpads
recognize certain "scroll" gestures (e.g., two-finger vertical motion, or
vertical motion on the edge of the trackpad). Tux Paint supports scrooling
input to allow quick scrolling through certain lists (e.g., Stamps, Magic
tools, and the New and Open dialogs).
Tux Paint will also automatically scroll if you click and hold the mouse
down on an scroll button — the "up" and "down" arrow buttons that appear
above and below scrolling lists.
b. Mouse Accessibility
Other devices that appear as a mouse can be used to control Tux Paint. For
example:
* Head pointing/tracking devices
* Eye gaze trackers
* Foot mice
Tux Paint offers a "sticky mouse click" accessibility setting, where a
single click begins a click-and-drag operation, and a subsequent click
ends it. (See the Options documentation.)
2. Using a Tablet or Touchscreen
As noted above, Tux Paint recognizes any device that appears as a mouse.
This means drawing tablets and touchscreens may be used. However, these
devices often support other features beyond X/Y motion, button clicks, and
scroll-wheel motion. Currently, those additional features are not
supported by Tux Paint. Some examples:
* Pressure and angle
* Eraser tip
* Multi-touch gestures
3. Using a Joystick-like Device
Tux Paint may be configured to recognize input from any game controller
that appears to your operating system as a joystick. That even includes
modern game console controllers connected via USB or Bluetooth (e.g.,
Nintendo Switch or Microsoft Xbox game pads)!
Numerous configuration options are available to best suit the device being
used, and the user's needs. Analog input will be used for coarse movement,
and digital "hat" input for fine movement. Buttons on the controller can
be mapped to different Tux Paint controls (e.g., acting as the [Escape]
key, switching to the Paint tool, invoking Undo and Redo operations,
etc.). See the Options documentation for more details.
4. Using the Keyboard
Tux Paint offers an option to allow the keyboard to be used to control the
mouse pointer. This includes motion and clicking, as well as shortcuts to
navigate between and within certain parts of the interface. See the
Options documentation for more details.
III. Loading Other Pictures into Tux Paint
A. Overview

2
docs/is_IS.UTF-8/html/OPTIONS.html
View file

@ -2012,7 +2012,7 @@
</li>
<li>To click-and-drag, hold one of the 'click' keys (e.g., [Insert]), and use the movement keys (e.g., [Left]). <p class="note">
<span title="Information">&#128161;</span> ><strong>Note:</strong> The "mouse accessibility" feature works with the keyboard mouse controls. With both options enabled, painting tools can be used to draw by pressing a 'click' key to start clicking, movement keys to move around (which will draw), and another 'click' key to end the click (stop drawing). </p>
<span title="Information">&#128161;</span> <strong>Note:</strong> The "mouse accessibility" feature works with the keyboard mouse controls. With both options enabled, painting tools can be used to draw by pressing a 'click' key to start clicking, movement keys to move around (which will draw), and another 'click' key to end the click (stop drawing). </p>
</li>
<li>A regular mouse and/or joystick may still be used (so you can, e.g., move with the mouse, and click with the keyboard, or vice-versa) </li>

111
docs/is_IS.UTF-8/html/README.html
View file

@ -102,7 +102,7 @@
</p>
<p>
maí 29, 2023 </p>
júlí 9, 2023 </p>
</center>
</header>
<table border="2"
@ -123,14 +123,14 @@
<li><a href="#using_loading">Launching Tux Paint</a></li> <li><a href="#using_title">Title Screen</a></li> <li><a href="#using_main">Main Screen</a></li> <li><a href="#using_tools">Available Tools</a> <ol type="1">
<li><a href="#using_tools_drawing">Drawing Tools</a> <ol type="a">
<li><a href="#using_tools_drawing_paint">"Paint" Tool (Brush)</a></li> <li><a href="#using_tools_drawing_stamp">"Stamp" Tool (Rubber Stamps)</a></li> <li><a href="#using_tools_drawing_lines">"Lines" Tool</a></li> <li><a href="#using_tools_drawing_shapes">"Shapes" Tool</a></li> <li><a href="#using_tools_drawing_text_and_label">"Text" and "Label" Tools</a></li> <li><a href="#using_tools_drawing_fill">"Fill" Tool</a></li> <li><a href="#using_tools_drawing_magic">"Magic" Tool (Special Effects)</a></li> <li><a href="#using_tools_drawing_eraser">"Eraser" Tool</a></li> </ol>
</li>
</li><!-- Using: Tools: Drawing -->
<li><a href="#using_tools_other">Other Controls</a> <ol type="a">
<li><a href="#using_tools_other_undo_and_redo">"Undo" and "Redo" Commands</a></li> <li><a href="#using_tools_other_new">"New" Command</a></li> <li><a href="#using_tools_other_open">"Open" Command</a></li> <li><a href="#using_tools_other_save">"Save" Command</a></li> <li><a href="#using_tools_other_print">"Print" Command</a></li> <li><a href="#using_tools_other_open_slides">"Slides" Command (under "Open")</a></li> <li><a href="#using_tools_other_quit">"Quit" Command</a></li> <li><a href="#using_tools_other_sound_muting">Sound Muting</a></li> </ol>
</li>
</li><!-- Using: Tools: Other -->
</ol>
</li>
</ol>
</li>
<li><a href="#using_controlling">Controlling Tux Paint</a></li> </ol>
</li><!-- Using -->
<li><a href="#loading_into">Loading Other Pictures into Tux Paint</a></li> <li><a href="#further">Further Reading</a></li> <li><a href="#help">How to Get Help</a></li> <li><a href="#participate">How to Participate</a></li> </ol>
</td>
</tr>
@ -242,6 +242,9 @@
<dt>File Erase may be disabled</dd>
<dd>Controls to erase saved work &mdash; saved drawings (via the Open dialog) and exported templates (via the New dialog) &mdash; can be disabled. (See the <a href="OPTIONS.html#simplification">"<code>noerase</code>" configuration option</a>.)</dd>
<dt>"Controlling Tux Paint" documentation</dd>
<dd>A brief overview of how Tux Paint can be controlled &mdash; mouse, tablet, touchscreen, joystick, and keyboard &mdash; has been <a href="#using_controlling">added to the README documentation</a>.</dd>
</dl>
<p>
@ -1525,6 +1528,104 @@
</section>
<!-- Using: Tools -->
<!-- Using: Controlling -->
<section>
<header>
<h2 id="using_controlling">
E. Controlling Tux Paint </h2>
</header>
<!-- Using: Controlling: Mouse -->
<section>
<header>
<h3 id="using_controlling_mouse">
1. Using a Mouse or Trackball </h3>
</header>
<p>
Tux Paint's main mode of operation is via any device that appears to your operating system as a mouse, including standard mice, trackballs, and trackpads, as well as drawing tablets (usually operated with a stylus) and touch screens (operated with a finger and/or a stylus) (see <a href="#using_controlling_tablet">"Using a Tablet or Touchscreen"</a> below for more information). </p>
<p>
For drawing and controlling Tux Paint, only a single mouse button is used &mdash; typically, on multi-button mice, this will the left mouse button, but this can usually be configured at the operating system level. By default, Tux Paint will ignore input from the other button(s). If a user attempts to use the other button(s), a pop-up dialog will eventually appear reminding them that only one button is recognized Tux Paint. However, you may configure Tux Paint to accept any button as input (see the <a href="OPTIONS.html#mouse_keyboard">Options</a> documentation). </p>
<section>
<header>
<h4>
a. Scrolling </h4>
</header>
<p>
Many input devices offer a way to quickly scroll within applications &mdash; many mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize certain "scroll" gestures (e.g., two-finger vertical motion, or vertical motion on the edge of the trackpad). Tux Paint supports scrolling input to allow quick scrolling through certain lists (e.g., Stamps, Magic tools, and the New and Open dialogs). </p>
<p>
Tux Paint will also automatically scroll if you click and hold the mouse down on an scroll button &mdash; the "up" and "down" arrow buttons that appear above and below scrolling lists. </p>
</section>
<section>
<header>
<h4>
b. Mouse Accessibility </h4>
</header>
<p>
Other devices that appear as a mouse can be used to control Tux Paint. For example: <ul>
<li>Head pointing/tracking devices</li>
<li>Eye gaze trackers</li>
<li>Foot mice</li>
</ul>
</p>
<p>
Tux Paint offers a "sticky mouse click" accessibility setting, where a single click begins a click-and-drag operation, and a subsequent click ends it. (See the <a href="OPTIONS.html#accessibility">Options</a> documentation.) </p>
</section>
</section>
<!-- Using: Controlling: Mouse -->
<!-- Using: Controlling: Tablet -->
<section>
<header>
<h3 id="using_controlling_tablet">
2. Using a Tablet or Touchscreen </h3>
</header>
<p>
As noted above, Tux Paint recognizes any device that appears as a mouse. This means drawing tablets and touchscreens may be used. However, these devices often support other features beyond X/Y motion, button clicks, and scroll-wheel motion. Currently, those additional features are <strong>not supported</strong> by Tux Paint. Some examples: <ul>
<li>Pressure and angle</li>
<li>Eraser tip</li>
<li>Multi-touch gestures</li>
</ul>
</p>
</section>
<!-- Using: Controlling: Tablet -->
<!-- Using: Controlling: Joystick -->
<section>
<header>
<h3 id="using_controlling_joystick">
3. Using a Joystick-like Device </h3>
</header>
<p>
Tux Paint may be configured to recognize input from any game controller that appears to your operating system as a joystick. That even includes modern game console controllers connected via USB or Bluetooth (e.g., <cite>Nintendo Switch</cite> or <cite>Microsoft Xbox</cite> game pads)! </p>
<p>
Numerous configuration options are available to best suit the device being used, and the user's needs. Analog input will be used for coarse movement, and digital "hat" input for fine movement. Buttons on the controller can be mapped to different Tux Paint controls (e.g., acting as the <b><code>[Escape]</code></b> key, switching to the Paint tool, invoking Undo and Redo operations, etc.). See the <a href="OPTIONS.html#joystick">Options</a> documentation for more details. </p>
</section>
<!-- Using: Controlling: Joystick -->
<!-- Using: Controlling: Keyboard -->
<section>
<header>
<h3 id="using_controlling_keyboard">
4. Using the Keyboard </h3>
</header>
<p>
Tux Paint offers an option to allow the keyboard to be used to control the mouse pointer. This includes motion and clicking, as well as shortcuts to navigate between and within certain parts of the interface. See the <a href="OPTIONS.html#accessibility">Options</a> documentation for more details. </p>
</section>
<!-- Using: Controlling: Keyboard -->
</section>
<!-- Using: Controlling -->
</section>
<!-- Using -->