.\" tuxpaint.1 - 2006.02.03 .TH TUXPAINT 1 "3 Feb 2006" "0.9.16" "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 | \-\-1024x768 | \-\-1280x1024 | \-\-1400x1050 | \-\-1600x1200] [\-\-nosound] [\-\-noquit] [\-\-noprint] [\-\-printdelay=\fISECONDS\fP] [\-\-printcfg] [\-\-simpleshapes] [\-\-uppercase] [\-\-grab] [\-\-noshortcuts] [\-\-nowheelmouse] [\-\-nobuttondistinction] [\-\-nofancycursors] [\-\-nooutlines] [\-\-nostamps] [\-\-nostampcontrols] [\-\-mirrorstamps] [\-\-keyboard] [\-\-nosysfonts] [\-\-savedir \fIDIR\fP] [\-\-saveover] [\-\-saveovernew] [\-\-nosave] .TP 9 .B tuxpaint [\-\-windowed] [\-\-640x480] [\-\-sound] [\-\-quit] [\-\-print] [\-\-printdelay=0] [\-\-noprintcfg] [\-\-complexshapes] [\-\-mixedcase] [\-\-dontgrab] [\-\-shortcuts] [\-\-wheelmouse] [\-\-buttondistinction] [\-\-fancycursors] [\-\-outlines] [\-\-stamps] [\-\-stampcontrols] [\-\-dontmirrorstamps] [\-\-mouse] [\-\-sysfonts] [\-\-saveoverask] [\-\-save] .TP 9 .B tuxpaint [\-\-locale \fILOCALE\fP] .TP 9 .B tuxpaint [\-\-lang \fILANGUAGE\fP | \-\-lang help] .TP 9 .B tuxpaint [\-\-nosysconfig] [\-\-nolockfile] .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 \-\-1024x768 \-\- 1280x1024 \-\-1400x1050 \-\-1600x1200 \-\-640x480 Run \fITux Paint\fP at higher resolution, 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 and \fIEscape\fP key sequence for quitting \fITux Paint\fP. Instead, use the window close button in the titlebar, the \fIAlt+F4\fP key sequence, or the \fIShift+Control+Escape\fP key sequence. .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 \-\-nobuttondistinction \-\-buttondistinction By default, only mouse button #1 (typically the leftmost mouse button on mice with more than one button) can be used for interacting with \fITux Paint\fP. With the \fI\-\-nobuttondistinction\fP option, mouse buttons #2 (middle) and #3 (right) can be used, as well. This is useful for children who aren't yet comfortable with the mouse. Default is to only recognize button #1. .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 \-\-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 \-\-nostampcontrols \-\-stampcontrols Disable or enable (default) buttons to control stamps. Controls include mirror, flip, shrink and grow. (Note: Not all stamps will be controllable in all ways.) .TP 8 .B \-\-mirrorstamps \-\-dontmirrorstamps With \fImirrorstamps\fP set, stamps which can be mirrored will appear mirrored by default. This can be useful when used by people who prefer things right-to-left over left-to-right. .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 \-\-nosysfonts \-\-sysfonts \fITux Paint\fP normally attempts to search for additional TrueType Fonts installed in common places on your system. If this causes trouble, or you'd prefer to only make fonts installed in \fITux Paint\fP's directory available, use the \fInosysfonts\fP option to disable this feature. .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). .TP 8 .B \-\-nosave \-\-save The \fInosave\fP option disables \fITux Paint's\fP ability to save files. This can be used in situations where the program is only being used for fun, or in a test environment. .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 - afrikaans .TP 2 - albanian .TP 2 - basque | euskara .TP 2 - belarusian | bielaruskaja .TP 2 - bokmal .TP 2 - brazilian-portuguese | portuges-brazilian | brazilian .TP 2 - breton | brezhoneg .TP 2 - british | british-english .TP 2 - bulgarian .TP 2 - catalan | catala .TP 2 - chinese | simplified-chinese .TP 2 - croatian | hrvatski .TP 2 - czech | cesky .TP 2 - danish | dansk .TP 2 - dutch .TP 2 - estonian .TP 2 - finnish | suomi .TP 2 - french | francais .TP 2 - gaelic | gaidhlig .TP 2 - galician | galego .TP 2 - german | deutsch .TP 2 - greek .TP 2 - gronings | zudelk-veenkelonioals .TP 2 - hebrew .TP 2 - hindi .TP 2 - hungarian | magyar .TP 2 - icelandic | islenska .TP 2 - indonesian | bahasa-indonesia .TP 2 - italian | italiano .TP 2 - japanese .TP 2 - kinyarwanda .TP 2 - klingon | tlhIngan .TP 2 - korean .TP 2 - lithuanian | lietuviu .TP 2 - malay .TP 2 - mexican-spanish | espanol-mejicano | mexican .TP 2 - norwegian | nynorsk .TP 2 - polish | polski .TP 2 - portuguese | portugues .TP 2 - romanian .TP 2 - russian | russkiy .TP 2 - serbian .TP 2 - slovak .TP 2 - slovenian | slovensko .TP 2 - spanish | espanol .TP 2 - swahili .TP 2 - swedish | svenska .TP 2 - tamil .TP 2 - thai .TP 2 - traditional-chinese .TP 2 - turkish .TP 2 - ukranian .TP 2 - vietnamese .TP 2 - walloon .TP 2 - welsh | cymraeg .RE .PD .TP 8 .B \-\- lang help Display a lists of all supported languages. .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). .TP 8 .B \-\-nolockfile By default, \fITux Paint\fP uses a lockfile (stored in the user's local Tux Paint directory) which prevents it from being launched more than once in 30 seconds. (Sometimes children get too eager, or user interfaces only require one click, but users think they need to double-click.) This option makes \fITux Paint\fP ignore the current lockfile. .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. You can do this by hand, or use '\fITux Paint Config.\fP.') .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 .TP 8 .B $HOME/.tuxpaint/lockfile.dat A lockfile that prevents \fITux Paint\fP from being launched more than once every 30 seconds. Disable checking the lockfile by using the \'\-\-nolockfile\' command-line argument. .RS .PP (There's no reason to delete the lockfile, as it contains a timestamp inside which causes it to expire after 30 seconds.) .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, Martin Benjamin, Denis Bodor, Herman Bruyninckx, Lucie Burianova, Laurentiu Buzdugan, Albert Cahalan, Pere Pujal Carabantes, Ouychai Chaita, Jacques Chion, Urska Colner, Helder Correia, Ricardo Cruz, Laurent Dhima, Yavor Doganov, Kevin Donnelly, Alberto Escudero-Pascual, Doruk Fisek, Dovix, Korvigellou An Drouizig (Philippe), Fabian Franz, Gabriel Gazzan, The Greek Linux i18n Team, Robert Glowczynski, Sam "Criswell" Hart, Tedi Heriyanto, Pjetur G. Hjaltason, Knut Erik Hollund, Song Huang, Karl Ove Hufthammer, Roland Illig, Juan Irigoien, Dmitriy Ivanov, Mogens Jaeger, Nedjeljko Jedvaj, Aleksandar Jelenak, Rasmus Erik Voel Jensen, Wang Jian, Petri Jooste, Andrej Kacian, Kazuhiko, Mark Kim, Thomas Klausner, Koby, Marcin 'Shard' Konicki, Ines Kovacevic, Mantas Kriauciunas, Arkadiusz Lipiec, Dag H. Loras, Burkhard Luck, Ankit Malik, Martin, Marco Milanesi, Mugunth, Steve Murphy, Daniel Nylander, Gareth Owen, Flavio Pastor, Patrick, Primoz Peterlin, Le Quang Phan, Henrik Pihl, Milan Plzik, John Popplewell, Leandro Regueiro, Ilir Rugova, Kevin Patrick Scannell, Gia Shervashidze, Clytie Siddall, Geert Stams, Peter Sterba, Tomasz 'karave' Tarach, Tarmo Toikkanen, TOYAMA Shin-ichi, Matej Urban, Rita Verbauskaite, Daniel Jose Viana, Charles Vidal, Damian Yerrick, Muhammad Najmi Ahmad Zabidi, Eugene Zelenko, and Martin Zhekov. .SH "SEE ALSO" .BR tuxpaint-import (1), .BR tuxpaint-config (1), .BR xpaint (1), .BR gpaint (1), .BR gimp (1) .PP And documentation within /usr/[local/]share/doc/tuxpaint/.