Improved documentation on new keyboard-controlled mouse feature.

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

View file

@ -114,32 +114,10 @@ $Id$
Special thanks to Richard Verhoeven <river@win.tue.nl> Special thanks to Richard Verhoeven <river@win.tue.nl>
Public domain. 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!] [Experimental!]
by Ankit Choudary <ankit.goaldecided@gmail.com> (GSOC 2010) by Ankit Choudary <ankit.goaldecided@gmail.com> (GSOC 2010)
* See documentation in OPTIONS for how to use it.
* 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.
* Joystick can be used to drive Tux Paint * Joystick can be used to drive Tux Paint
by Ankit Choudary <ankit.goaldecided@gmail.com> (GSOC 2010) by Ankit Choudary <ankit.goaldecided@gmail.com> (GSOC 2010)

View file

@ -3,13 +3,13 @@
Options Documentation Options Documentation
Copyright 2002-2012 by Bill Kendrick and others Copyright 2002-2014 by Bill Kendrick and others
New Breed Software New Breed Software
bill@newbreedsoftware.com bill@newbreedsoftware.com
http://www.tuxpaint.org/ http://www.tuxpaint.org/
March 30, 2013 April 6, 2014
---------------------------------------------------------------------- ----------------------------------------------------------------------
@ -505,10 +505,38 @@ Windows Users
keyboard=yes keyboard=yes
This allows the keyboard arrow keys to be used to control the 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 Features:
mouse button. * 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 savedir=DIRECTORY

View file

@ -16,14 +16,14 @@ version
</h1> </h1>
<h2>Options Documentation</h2> <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> New Breed Software</p>
<p><a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a><br> <p><a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a><br>
<a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a></p> <a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a></p>
<p>March 30, 2013</p> <p>April 6, 2014</p>
</center> </center>
@ -629,10 +629,40 @@ New Breed Software</p>
<dt><code><b>keyboard=yes</b></code></dt> <dt><code><b>keyboard=yes</b></code></dt>
<dd> <dd>
<p>This allows the keyboard arrow keys to be used <p>This allows the keyboard arrow keys to be used
to control the mouse pointer. (e.g., for mouseless environments.)</p> to control the mouse pointer. (e.g., for mouseless environments, or
handicapped/accessibility purposes)</p>
<p>The <b>[Arrow]</b> keys move the mouse pointer.
<b>[Space]</b> acts as the mouse button.</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> </dd>
<dt><code><b>savedir=<i>DIRECTORY</i></b></code></dt> <dt><code><b>savedir=<i>DIRECTORY</i></b></code></dt>