.\" tuxpaint.1 - 2003.09.11 .TH TUXPAINT 1 "11 Sep 2003" "0.9.13" "Tux Paint" .SH NAME tuxpaint -- A drawing program for young children. .SH SYNOPSYS .B tuxpaint [\-\-help \-\-version \-\-usage \-\-copying] .TP 9 .B tuxpaint [\-\-fullscreen] [\-\-800x600] [\-\-nosound] [\-\-noquit] [\-\-noprint] [\-\-printdelay=\fISECONDS\fP] [\-\-printcfg] [\-\-simpleshapes] [\-\-uppercase] [\-\-grab] [\-\-noshortcuts] [\-\-nowheelmouse] [\-\-nofancycursors] [\-\-nooutlines] [\-\-nostamps] [\-\-keyboard] [\-\-savedir \fIDIR\fP] [\-\-saveover] [\-\-saveovernew] .TP 9 .B tuxpaint [\-\-windowed] [\-\-640x480] [\-\-sound] [\-\-quit] [\-\-print] [\-\-printdelay=0] [\-\-noprintcfg] [\-\-complexshapes] [\-\-mixedcase] [\-\-dontgrab] [\-\-shortcuts] [\-\-wheelmouse] [\-\-mouse] [\-\-outlines] [\-\-stamps] [\-\-fancycursors] [\-\-saveoverask] .TP 9 .B tuxpaint [\-\-locale \fILOCALE\fP] .TP 9 .B tuxpaint [\-\-lang \fILANGUAGE\fP] .TP 9 .B tuxpaint [\-\-nosysconfig] .SH DESCRIPTION .PP \fITux Paint\fP is a drawing program for young children. It is meant to be easy and fun to use. It provides a simple interface and fixed canvas size, and provides access to previous images using a thumbnail browser (i.e., no access to the underlying filesystem). Unlike popular drawing programs like "\fIThe GIMP\fP," it has a very limited toolset. However, it provides a much simpler interface, and has entertaining, child-oriented additions such as sound effects. .SH OPTIONS - INFORMATIONAL .TP 8 .B \-\-help Display short, helpful information about Tux Paint. .TP 8 .B \-\-version Output the version info. .TP 8 .B \-\-usage Display a list of all commandline options. .TP 8 .B \-\-copying Show the license (GNU GPL) under which Tux Paint is released. .SH OPTIONS - INTERFACE .l \fItuxpaint\fP accepts the following options to alter the interface. They can be used along with, instead of, or to override options set in configuration files. (See below.) .TP 8 .B \-\-fullscreen \-\-windowed Run \fITux Paint\fP in full-screen mode, or in a window (default). .TP 8 .B \-\-800x600 \-\-640x480 Run \fITux Paint\fP at 800x600 resolution (EXPERIMENTAL), or 640x480 resolution (default). .TP 8 .B \-\-nosound \-\-sound Disable or enable (default) sound. .TP 8 .B \-\-noquit \-\-quit Disable or enable (default) the on-screen \fIQuit\fP button. .TP 8 .B \-\-noprint \-\-print Disable or enable (default) the \fIPrint\fP command within \fITux Paint\fP. .TP 8 .B \-\-printdelay=\fISECONDS\fP \-\-printdelay=0 Only allow printing (via the \fIPrint\fP command) once every \fISECONDS\fP seconds. Default is 0 (no limitation). .TP 8 .B \-\-printcfg \-\-noprintcfg (Windows only.) Enable or disable loading and saving of printer settings. By default, \fITux Paint\fP will print to the default printer with default settings. Pressing \fI[ALT]\fP while pushing the \fIPrint\fP button will cause a Windows printer dialog to appear (as long as you're not in fullscreen mode.) If \-\-printcfg is used, your previous settings will be loaded when \fITux Paint\fP starts up, and setting changes will be saved for next time. .TP 8 .B \-\-simpleshapes \-\-complexshapes Disable or enable (default) the \fIrotation\fP step when using the \fIShape\fP tool within \fITux Paint\fP. When disabled, shapes cannot be rotated; however, the interface is easier (click, drag, release), which can be useful for younger or disabled children. .TP 8 .B \-\-uppercase \-\-mixedcase In \fIuppercase\fP mode, all text prompts and the \fIText\fP drawing tool will display only uppercase letters. This is useful for children who are not yet comfortable with the lowercase characterset. Default mode is \fImixed case\fP. .TP 8 .B \-\-grab \-\-nograb Grab the mouse and keyboard input (if possible), so that the mouse is confined to the \fITux Paint\fP window. Default is to not grab. .TP 8 .B \-\-noshortcuts \-\-shortcuts If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., Ctrl+S for Save) will be disabled. Default mode is \fIshortcuts enabled\fP. .TP 8 .B \-\-nowheelmouse \-\-wheelmouse By default, the wheel (jog dial) on a mouse will be used to scroll the \fIselector\fP on the right of the screen. This can be disabled, and the wheel completely ignored, with the \fI\-\-nowheelmouse\fP option. This is useful for children who aren't yet comfortable with the mouse. Default is to support the wheel. .TP 8 .B \-\-nofancycursors \-\-fancycursors Disable or enable (default) the 'fancy' mouse pointer shapes in \fITux Paint\fP. While the shapes are larger, and context sensitive, some environments have trouble displaying the mouse pointer, and/or leave 'trails' on the screen. .TP 8 .B \-\-keyboard \-\-mouse The \fIkeyboard\fP option lets the mouse pointer in \fITux Paint\fP be controlled with the keyboard. The \fIarrow keys\fP move the pointer. \fISpacebar\fP acts as the mouse button. .TP 8 .B \-\-nooutlines \-\-outlines In \fInooutlines\fP mode, much simpler outlines and 'rubber-band' lines are displayed when using the \fILines\fP, \fIShapes\fP, \fIStamps\fP and \fIEraser\fP tools. (This can help when \fITux Paint\fP is run on slower computers, or displayed on a remote X display.) .TP 8 .B \-\-nostamps \-\-stamps With \fInostamps\fP set, Rubber Stamp images are not loaded, so the \fIStamps\fP tool will not be available. This option can be used to reduce the time Tux Paint takes to load, and reduce the amount of RAM it requires. .TP 8 .B \-\-savedir \fIDIR\fP Specify where \fITux Paint\fP should save files. By default, this is "~/.tuxpaint/saved" under Linux and Unix, and "userdata\\" under Windows. .TP 8 .B \-\-saveover \-\-saveovernew \-\-saveoverask If, when saving a picture, an older version of the file will be overwritten, \fITux Paint\fP will, by default, ask for confirmation: either \fIsave over\fP the old file, or \fIcreate\fP a new file. This prompt can be disabled with \fI\-\-saveover\fP (which always saves over older versions of pictures) or \fI\-\-saveovernew\fP (which always saves a new file). The default is to prompt (\fI\-\-saveoverask\fP). .SH OPTIONS - LANGUAGE .l Various parts of \fITux Paint\fP have been translated into numerous languages. \fITux Paint\fP will try its best to honor your \fIlocale\fP setting (i.e., the \fILANG\fP environment variable), if possible. You can also specifically set the language using options on the command-line or in a configuration file. .TP 8 .B \-\-locale \fILOCALE\fP Specify the language to use, based on locale name (which is typically of the form \fIlanguage\fP[_\fIterritory\fP][.\fIcodeset\fP][@\fImodifier\fP], where \fIlanguage\fP is an ISO 639 language code, \fIterritory\fP is an ISO 3166 country code, and \fIcodeset\fP is a character set or encoding identifier like ISO-8859-1 or UTF-8.) .PP .RS For example, \fIde_DE@euro\fP for German, or \fIpt_BR\fP for Brazilian Portuguese. .RE .TP 8 .B \-\-lang \fILANGUAGE\fP Specify the language to use, based on the language's name (as recognized by \fITux Paint\fP). Choose one of the language names listed below: .PP .RS .PD 0 .TP 2 - english | american-english .TP 2 - brazilian-portuguese | portuges-brazilian | brazilian .TP 2 - british | british-english .TP 2 - catalan | catala .TP 2 - czech | cesky .TP 2 - chinese .TP 2 - danish | dansk .TP 2 - dutch .TP 2 - finnish | suomi .TP 2 - french | francais .TP 2 - german | dutch .TP 2 - greek .TP 2 - hebrew .TP 2 - hungarian | magyar .TP 2 - icelandic | islenska .TP 2 - indonesian | bahasa-indonesia .TP 2 - italian | italiano .TP 2 - japanese .TP 2 - korean .TP 2 - lithuanian | lietuviu .TP 2 - malay .TP 2 - norwegian | nynorsk .TP 2 - polish | polski .TP 2 - portuguese | portugues .TP 2 - romanian .TP 2 - russian | russkiy .TP 2 - slovak .TP 2 - spanish | espanol .TP 2 - swedish | svenska .TP 2 - turkish .TP 2 - walloon .RE .PD .SH OPTIONS - MISCELLANEOUS .TP 8 .B \-\-nosysconfig With this option, \fITux Paint\fP will not attempt to read the system-wide configuration file (typically \fI/etc/tuxpaint/tuxpaint.conf\fP). .SH ENVIRONMENT .l While \fITux Paint\fP may refer to a number of environment variables indirectly (e.g., via \fISDL(3)\fP), it only directly accesses the following: .PP .TP 8 .B HOME to determine where picture files go when using the \fISave\fP and \fIOpen\fP commands within \fITux Paint\fP, to keep track of the current image, when quitting and restarting \fITux Paint\fP, and to get the user's configuration file. .TP 8 .B LANG to determine langauge to use, if \fIsetlocale(3)\fP refers to 'LC_MESSAGES'. .SH FILES .TP 8 .B /etc/tuxpaint/tuxpaint.conf System-wide configuration file. It is read first (unless the \fI\-\-nosysconfig\fP option was given on the command-line). .RS .PP (Created during installation.) .RE .TP 8 .B $HOME/.tuxpaintrc User's configuration file. It can be used to set default options (rather than setting them on the command-line every time), and/or to override any settings in the system-wide configuration file. .RS .PP (Not created or edited automatically; must be created manually.) .RE .TP 8 .B $HOME/.tuxpaint/saved/ A directory of previously-saved images (and thumbnails). Only files in this directory will be made available using the \fIOpen\fP command within \fITux Paint\fP. (See \fItuxpaint-import(1)\fP.) .RS .PP (Created when \fISave\fP command is used.) .RE .TP 8 .B $HOME/.tuxpaint/current_id.txt A reference to the image which was being edited when \fITux Paint\fP was last quit. (This image is automatically loaded the next time \fITux Paint\fP is re-run.) .RS .PP (Created when \fITux Paint\fP is \fIQuit\fP.) .RE .SH COPYRIGHT This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. .SH OTHER INFO The canonical place to find \fITux Paint\fP information is at http://www.newbreedsoftware.com/tuxpaint/. .SH AUTHORS Bill Kendrick. With patches, fixes, extensions, translation, documentation and more from lots of people, including, but not limited to: Daniel Andersson, Ben Armstrong, Denis Bodor, Herman Bruyninckx, Laurentiu Buzdugan, Pere Pujal Carabantes, Jacques Chion, Ricardo Cruz, Doruk Fisek, Dovix, Fabian Franz, Gabriel Gazzan, The Greek Linux i18n Team, Robert Glowczynski, Sam "Criswell" Hart, Tedi Heriyanto, Pjetur G. Hjaltason, Karl Ove Hufthammer, Dmitriy Ivanov, Rasmus Erik Voel Jensen, Wang Jian, Kazuhiko, Mark Kim, Thomas Klausner, Koby, Marcin 'Shard' Konicki, Mantas Kriauciunas, Arkadiusz Lipiec, Martin, Marco Milanesi, Primoz Peterlin, Milan Plzik, John Popplewell, Geert Stams, Peter Sterba, Tarmo Toikkanen, TOYAMA Shin-ichi, Rita Verbauskaite, Daniel Jose Viana, Charles Vidal, Damian Yerrick, and Muhammad Najmi Ahmad Zabidi. .SH "SEE ALSO" .BR tuxpaint-import (1), .BR xpaint (1), .BR gpaint (1), .BR gimp (1) .PP And documentation within /usr/[local/]share/doc/tuxpaint/.