Documenting mouse accessibility and onscreen keyboard options.

Normalizing those options ('-' instead of '_' in their names, like other opts.)
This commit is contained in:
William Kendrick 2011-04-14 06:26:45 +00:00
parent c314c49927
commit 2715f918e9
7 changed files with 130 additions and 81 deletions

View file

@ -48,6 +48,21 @@ $Id$
* Added support for building under Haiku OS * Added support for building under Haiku OS
Scott McCreary <scottmc@users.sourceforge.net> Scott McCreary <scottmc@users.sourceforge.net>
* Accessibility Improvements:
---------------------------
* Added a mouse accessibility mode to avoid the need to drag the mouse.
("--mouse-accessibility")
by Ankit Choudary <ankit.goaldecided@gmail.com> (GSOC 2009)
with integration and fixes by
Pere Pujal i Carabantes <pere@fornol.no-ip.org>
* Added an option to display an on-screen keyboard when using the
'Text' and 'Label' tools. (Experimental.)
("--onscreen-keyboard")
by Ankit Choudary <ankit.goaldecided@gmail.com> (GSOC 2009)
with integration and fixes by
Pere Pujal i Carabantes <pere@fornol.no-ip.org>
* Other Improvements: * Other Improvements:
------------------- -------------------
* Tux Paint (in windowed mode) now only centers itself if * Tux Paint (in windowed mode) now only centers itself if
@ -55,15 +70,8 @@ $Id$
the SDL_VIDEO_WINDOW_POS environment variable. the SDL_VIDEO_WINDOW_POS environment variable.
(SourceForge Bug #3138446) (SourceForge Bug #3138446)
* Adding a mouse mode to avoid the need to drag the mouse.
FIXME: Explain
by Ankit Choudary <ankit.goaldecided@gmail.com>
* Allowing to paint with the keyboard.
FIXME: Explain
by Ankit Choudary.
* Creating thumbnails for the starters we provide. * Creating thumbnails for the starters we provide.
(Speeds up 'New' dialog appearance.)
Pere Pujal i Carabantes <pere@fornol.no-ip.org> Pere Pujal i Carabantes <pere@fornol.no-ip.org>
* On systems where Pango is used for UI text rendering, Tux Paint now * On systems where Pango is used for UI text rendering, Tux Paint now

View file

@ -9,7 +9,7 @@ Options Documentation
bill@newbreedsoftware.com bill@newbreedsoftware.com
http://www.tuxpaint.org/ http://www.tuxpaint.org/
January 12, 2011 April 13, 2011
---------------------------------------------------------------------- ----------------------------------------------------------------------
@ -369,6 +369,15 @@ Windows Users
This can be useful for people who prefer things right-to-left, This can be useful for people who prefer things right-to-left,
rather than left-to-right. rather than left-to-right.
mouse-accessibility=yes
In this mode, instead of clicking, dragging and releasing
(e.g., to draw), you click, move, and click again to end the
motion.
onscreen-keyboard=yes
Presents a clickable on-screen keyboard when using the Text
and Label tools.
stampsize=SIZE stampsize=SIZE
Use this option to force Tux Paint to set the starting size of Use this option to force Tux Paint to set the starting size of
@ -767,6 +776,8 @@ Windows Users
--nostampcontrols --nostampcontrols
--nomagiccontrols --nomagiccontrols
--nolabel --nolabel
--mouse-accessibility
--onscreen-keyboard
--sysfonts --sysfonts
--alllocalefonts --alllocalefonts
--mirrorstamps --mirrorstamps
@ -888,9 +899,9 @@ Command-Line Informational Options
Available Languages Available Languages
+------------------------------------------------------------------+ +------------------------------------------------------------------+
| | Language | Language | Input Method | | |Language |Language |Input Method |
|Locale Code| (native name) | (English name) | Cycle Key | |Locale Code|(native name) |(English name) |Cycle Key |
| | | | Combination | | | | |Combination |
|-----------+-------------------+-----------------+----------------| |-----------+-------------------+-----------------+----------------|
|C | |English | | |C | |English | |
|-----------+-------------------+-----------------+----------------| |-----------+-------------------+-----------------+----------------|

View file

@ -14,7 +14,7 @@
---------------------------------------------------------------------- ----------------------------------------------------------------------
+-------------------------------------------+ +-------------------------------------------+
| Table of Contents | |Table of Contents |
|-------------------------------------------| |-------------------------------------------|
| * About | | * About |
| * Using Tux Paint | | * Using Tux Paint |

View file

@ -23,7 +23,7 @@ New Breed Software</p>
<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>January 12, 2011</p> <p>April 13, 2011</p>
</center> </center>
@ -460,6 +460,18 @@ New Breed Software</p>
rather than left-to-right.</p> rather than left-to-right.</p>
</dd> </dd>
<dt><code><b>mouse-accessibility=yes</b></code></dt>
<dd>
In this mode, instead of clicking, dragging and releasing
(e.g., to draw), you click, move, and click again to end the motion.
</dd>
<dt><code><b>onscreen-keyboard=yes</b></code></dt>
<dd>
Presents a clickable on-screen keyboard when using the <b>Text</b> and
<b>Label</b> tools.
</dd>
<dt><code><b>stampsize=<i>SIZE</i></b></code></dt> <dt><code><b>stampsize=<i>SIZE</i></b></code></dt>
<dd> <dd>
<p>Use this option to force Tux&nbsp;Paint to set the starting size of <p>Use this option to force Tux&nbsp;Paint to set the starting size of
@ -1182,6 +1194,8 @@ New Breed Software</p>
--nostampcontrols<br> --nostampcontrols<br>
--nomagiccontrols<br> --nomagiccontrols<br>
--nolabel<br> --nolabel<br>
--mouse-accessibility<br>
--onscreen-keyboard<br>
--sysfonts<br> --sysfonts<br>
--alllocalefonts<br> --alllocalefonts<br>
--mirrorstamps<br> --mirrorstamps<br>

View file

@ -1,5 +1,5 @@
.\" tuxpaint.1 - 2011.01.12 .\" tuxpaint.1 - 2011.04.13
.TH TUXPAINT 1 "12 January 2011" "0.9.22" "Tux Paint" .TH TUXPAINT 1 "13 April 2011" "0.9.22" "Tux Paint"
.SH NAME .SH NAME
tuxpaint -- "Tux Paint", a drawing program for young children. tuxpaint -- "Tux Paint", a drawing program for young children.
@ -63,6 +63,10 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
.br .br
[\-\-mirrorstamps] [\-\-mirrorstamps]
.br .br
[\-\-mouse-accessibility]
.br
[\-\-onscreen-keyboard]
.br
[\-\-stampsize=\fISIZE\fP] [\-\-stampsize=\fISIZE\fP]
.br .br
[\-\-keyboard] [\-\-keyboard]
@ -362,6 +366,16 @@ With \fImirrorstamps\fP set, stamps which can be mirrored will appear
mirrored by default. This can be useful when used by people who prefer mirrored by default. This can be useful when used by people who prefer
things right-to-left over left-to-right. things right-to-left over left-to-right.
.TP 8
.B \-\-mouse-accessibility
In this mode, instead of clicking, dragging and releasing (e.g., to draw),
you click, move, and click again to end the motion.
.TP 8
.B \-\-onscreen-keyboard
Presents a clickable on-screen keyboard when using the \fIText\fP and
\fILabel\fP tools.
.TB 8 .TB 8
.B \-\-stampsize=\fIsize\fP \-\-stampsize=default .B \-\-stampsize=\fIsize\fP \-\-stampsize=default
Sets the default size of all stamps, relative to their possible sizes Sets the default size of all stamps, relative to their possible sizes

View file

@ -90,71 +90,71 @@ static void imm_copying(void)
struct cfg struct cfg
%% %%
alllocalefonts, POSBOOL(all_locale_fonts) alllocalefonts, POSBOOL(all_locale_fonts)
allowscreensaver, NEGBOOL(disable_screensaver) allowscreensaver, NEGBOOL(disable_screensaver)
altprint, MULTI(alt_print_command_default) altprint, MULTI(alt_print_command_default)
altprintalways, MULTI(alt_print_command_default) altprintalways, MULTI(alt_print_command_default)
altprintcommand, MULTI(altprintcommand) altprintcommand, MULTI(altprintcommand)
altprintmod, MULTI(alt_print_command_default) altprintmod, MULTI(alt_print_command_default)
altprintnever, MULTI(alt_print_command_default) altprintnever, MULTI(alt_print_command_default)
autosave, POSBOOL(autosave_on_quit) autosave, POSBOOL(autosave_on_quit)
buttondistinction, NEGBOOL(no_button_distinction) buttondistinction, NEGBOOL(no_button_distinction)
colorfile, MULTI(colorfile) colorfile, MULTI(colorfile)
complexshapes, NEGBOOL(simple_shapes) complexshapes, NEGBOOL(simple_shapes)
copying, IMM(copying) copying, IMM(copying)
currentlocalefont, NEGBOOL(all_locale_fonts) currentlocalefont, NEGBOOL(all_locale_fonts)
datadir, MULTI(datadir) datadir, MULTI(datadir)
disablescreensaver, POSBOOL(disable_screensaver) disablescreensaver, POSBOOL(disable_screensaver)
dontgrab, NEGBOOL(grab_input) dontgrab, NEGBOOL(grab_input)
dontmirrorstamps, NEGBOOL(mirrorstamps) dontmirrorstamps, NEGBOOL(mirrorstamps)
fancycursors, NEGBOOL(no_fancy_cursors) fancycursors, NEGBOOL(no_fancy_cursors)
fullscreen, MULTI(parsertmp_fullscreen_native) fullscreen, MULTI(parsertmp_fullscreen_native)
grab, POSBOOL(grab_input) grab, POSBOOL(grab_input)
help, IMM(help) help, IMM(help)
hidecursor, POSBOOL(hide_cursor) hidecursor, POSBOOL(hide_cursor)
keyboard, POSBOOL(keymouse) keyboard, POSBOOL(keymouse)
label, NEGBOOL(disable_label) label, NEGBOOL(disable_label)
lang, MULTI(parsertmp_lang) lang, MULTI(parsertmp_lang)
locale, MULTI(parsertmp_locale) locale, MULTI(parsertmp_locale)
lockfile, POSBOOL(ok_to_use_lockfile) lockfile, POSBOOL(ok_to_use_lockfile)
magiccontrols, NEGBOOL(disable_magic_controls) magiccontrols, NEGBOOL(disable_magic_controls)
mirrorstamps, POSBOOL(mirrorstamps) mirrorstamps, POSBOOL(mirrorstamps)
mixedcase, NEGBOOL(only_uppercase) mixedcase, NEGBOOL(only_uppercase)
mouse, NEGBOOL(keymouse) mouse, NEGBOOL(keymouse)
native, POSBOOL(native_screensize) native, POSBOOL(native_screensize)
orient, MULTI(rotate_orientation) orient, MULTI(rotate_orientation)
outlines, NEGBOOL(dont_do_xor) outlines, NEGBOOL(dont_do_xor)
papersize, MULTI(papersize) papersize, MULTI(papersize)
print, NEGBOOL(disable_print) print, NEGBOOL(disable_print)
printcfg, POSBOOL(use_print_config) printcfg, POSBOOL(use_print_config)
printcommand, MULTI(printcommand) printcommand, MULTI(printcommand)
printdelay, MULTI(print_delay) printdelay, MULTI(print_delay)
quit, NEGBOOL(disable_quit) quit, NEGBOOL(disable_quit)
save, NEGBOOL(disable_save) save, NEGBOOL(disable_save)
savedir, MULTI(savedir) savedir, MULTI(savedir)
saveover, MULTI(promptless_save) saveover, MULTI(promptless_save)
saveoverask, MULTI(promptless_save) saveoverask, MULTI(promptless_save)
saveovernew, MULTI(promptless_save) saveovernew, MULTI(promptless_save)
shortcuts, NEGBOOL(noshortcuts) shortcuts, NEGBOOL(noshortcuts)
showcursor, NEGBOOL(hide_cursor) showcursor, NEGBOOL(hide_cursor)
simpleshapes, POSBOOL(simple_shapes) simpleshapes, POSBOOL(simple_shapes)
sound, POSBOOL(use_sound) sound, POSBOOL(use_sound)
stampcontrols, NEGBOOL(disable_stamp_controls) stampcontrols, NEGBOOL(disable_stamp_controls)
stamps, NEGBOOL(dont_load_stamps) stamps, NEGBOOL(dont_load_stamps)
stampsize, MULTI(stamp_size_override) stampsize, MULTI(stamp_size_override)
startblank, POSBOOL(start_blank) startblank, POSBOOL(start_blank)
startlast, NEGBOOL(start_blank) startlast, NEGBOOL(start_blank)
sysconfig, POSBOOL(parsertmp_sysconfig) sysconfig, POSBOOL(parsertmp_sysconfig)
sysfonts, NEGBOOL(no_system_fonts) sysfonts, NEGBOOL(no_system_fonts)
uppercase, POSBOOL(only_uppercase) uppercase, POSBOOL(only_uppercase)
usage, IMM(usage) usage, IMM(usage)
verbose-version, IMM(verbose_version) verbose-version, IMM(verbose_version)
version, IMM(version) version, IMM(version)
wheelmouse, POSBOOL(wheely) wheelmouse, POSBOOL(wheely)
windowed, NEGBOOL(fullscreen) windowed, NEGBOOL(fullscreen)
windowsize, MULTI(parsertmp_windowsize) windowsize, MULTI(parsertmp_windowsize)
mouse_accessibility, POSBOOL(mouseaccessibility) mouse-accessibility, POSBOOL(mouseaccessibility)
onscreen_keyboard, POSBOOL(onscreen_keyboard) onscreen-keyboard, POSBOOL(onscreen_keyboard)
%% %%
void parse_one_option(struct cfginfo *restrict tmpcfg, const char *str, const char *opt, const char *restrict src) void parse_one_option(struct cfginfo *restrict tmpcfg, const char *str, const char *opt, const char *restrict src)

View file

@ -60,6 +60,8 @@ _tuxpaint()
-l --lang -L --locale \ -l --lang -L --locale \
--nosysconfig \ --nosysconfig \
--nolockfile \ --nolockfile \
--mouse-accessibility \
--onscreen-keyboard \
--colorfile' -- $cur ) ) --colorfile' -- $cur ) )
# We don't accept filenames on the command-line yet -bjk 2009.09.09 # We don't accept filenames on the command-line yet -bjk 2009.09.09
# else # else