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

Improved documentation on new keyboard-controlled mouse feature.

Browse source
This commit is contained in:
William Kendrick 2014-04-07 06:22:23 +00:00
parent d7f9139170
commit 4be5c01673
3 changed files with 71 additions and 35 deletions
Download patch file Download diff file Expand all files Collapse all files

26
docs/CHANGES.txt
View file

@ -114,32 +114,10 @@ $Id$
Special thanks to Richard Verhoeven <river@win.tue.nl>
Public domain.
* Keyboard can be used to move and click mouse ("keyboard" option).
* Keyboard can be used to move and click mouse ("--keyboard" option).
[Experimental!]
by Ankit Choudary <ankit.goaldecided@gmail.com> (GSOC 2010)
* Keys to move:
* [Up] / [Down] / [Left] / [Right]
* [A] / [S] / [D] / [W]
* Numpad 1/2/3/4/6/7/8/9
* Keys to click:
* [\] (backslash)
* Numpad 5
* [Tab] can be used to jump between Tools (toolbox on the left),
Colors (color palette at the bottom) and drawing canvas.
Note: disabled when using Text or Label tool to type, so that you
can type text, and use [Tab] to end a string (without moving text
cursor).
* FIXME:
* Difficult to actually draw, unless mouse-accessibility is also on.
* Option is on by default; should be disabled by default, and enabled
via config.
* ASDW is QWERTY-centric; drop it, or add ways to support other
keyboard layouts.
* See documentation in OPTIONS for how to use it.
* Joystick can be used to drive Tux Paint
by Ankit Choudary <ankit.goaldecided@gmail.com> (GSOC 2010)

38
docs/OPTIONS.txt
View file

@ -3,13 +3,13 @@
Options Documentation
Copyright 2002-2012 by Bill Kendrick and others
Copyright 2002-2014 by Bill Kendrick and others
New Breed Software
bill@newbreedsoftware.com
http://www.tuxpaint.org/
March 30, 2013
April 6, 2014
----------------------------------------------------------------------
@ -505,10 +505,38 @@ Windows Users
keyboard=yes
This allows the keyboard arrow keys to be used to control the
mouse pointer. (e.g., for mouseless environments.)
mouse pointer. (e.g., for mouseless environments, or
handicapped/accessibility purposes)
The [Arrow] keys move the mouse pointer. [Space] acts as the
mouse button.
Features:
* Fine movement within canvas, or coarse movement if
[Shift] is held.
* Coarse movement within tool button areas.
* Key controls:
* [Left]/[Right]/[Up]/[Down], numpad [1] thru [9]:
Move mouse
* [Space]/[5]: Click mouse (except when using "Text"
or "Label" tools)
* [Insert]: Click mouse (always)
* [F4] jump mouse between "Tools", "Colors" and canvas
areas
* If mouse is within "Tools" section on the left, or
"Colors" secton at the bottom:
* [F7], [F8]: Move down/up between buttons,
respectively (Tools section, only)
* [F11], [F12]: Move to previous/next button,
respectively
* 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 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).
* 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)
savedir=DIRECTORY

42
docs/html/OPTIONS.html
View file

@ -16,14 +16,14 @@ version
</h1>
<h2>Options Documentation</h2>
<p>Copyright 2002-2012 by Bill Kendrick and others<br>
<p>Copyright 2002-2014 by Bill Kendrick and others<br>
New Breed Software</p>
<p><a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a><br>
<a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a></p>
<p>March 30, 2013</p>
<p>April 6, 2014</p>
</center>
@ -629,10 +629,40 @@ New Breed Software</p>
<dt><code><b>keyboard=yes</b></code></dt>
<dd>
<p>This allows the keyboard arrow keys to be used
to control the mouse pointer. (e.g., for mouseless environments.)</p>
<p>The <b>[Arrow]</b> keys move the mouse pointer.
<b>[Space]</b> acts as the mouse button.</p>
to control the mouse pointer. (e.g., for mouseless environments, or
handicapped/accessibility purposes)</p>
<p>Features:
<ul>
<li>Fine movement within canvas, or coarse movement if [Shift] is held.
<li>Coarse movement within tool button areas.
<li>Key controls:
<ul>
<li>[Left]/[Right]/[Up]/[Down], numpad [1] thru [9]: Move mouse
<li>[Space]/[5]: Click mouse (except when using "Text" or "Label" tools)
<li>[Insert]: Click mouse (always)
<li>[F4] jump mouse between "Tools", "Colors" and canvas areas
<li>If mouse is within "Tools" section on the left, or
"Colors" secton at the bottom:
<ul>
<li>[F7], [F8]: Move down/up between buttons, respectively
(Tools section, only)
<li>[F11], [F12]: Move to previous/next button, respectively
</ul>
</ul>
<li>To click-and-drag, hold one of the 'click' keys (e.g., [Insert]),
and use the movement keys (e.g., [Left]).
<ul>
<li>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 will draw), and another
'click' key to end the click (stop drawing).
</ul>
<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)
</ul>
</dd>
<dt><code><b>savedir=<i>DIRECTORY</i></b></code></dt>