1TUXPAINT(1) Tux Paint TUXPAINT(1)
2
6 tuxpaint -- "Tux Paint", a drawing program for young children.
7
10 tuxpaint [--help --version --verbose-version --usage --copying]
11 tuxpaint [--fullscreen]
14 [--allowscreensaver]
15 [--WIDTHxHEIGHT]
16 [--native]
17 [--orient=portrait]
18 [--startblank]
19 [--nosound]
20 [--noquit]
21 [--noprint]
22 [--printdelay=SECONDS]
23 [--printcfg]
24 [--altprintalways | --altprintnever]
25 [--papersize PAPERSIZE | --papersize help]
26 [--simpleshapes]
27 [--uppercase]
28 [--grab]
29 [--noshortcuts]
30 [--nowheelmouse]
31 [--nobuttondistinction]
32 [--nofancycursors]
33 [--hidecursor]
34 [--nooutlines]
35 [--nostamps]
36 [--nostampcontrols]
37 [--nomagiccontrols]
38 [--mirrorstamps]
39 [--stampsize=SIZE]
40 [--keyboard]
41 [--nosysfonts]
42 [--alllocalefonts]
43 [--savedir DIR]
44 [--datadir DIR]
45 [--saveover]
46 [--saveovernew]
47 [--nosave]
48 [--autosave]
49 [--colorfile FILE]
50 tuxpaint (defaults)
53 [--windowed]
54 [--disablescreensaver]
55 [--800x600]
56 [--orient=landscape]
57 [--startlast]
58 [--sound]
59 [--quit]
60 [--print]
61 [--printdelay=0]
62 [--noprintcfg]
63 [--altprintmod]
64 [--complexshapes]
65 [--mixedcase]
66 [--dontgrab]
67 [--shortcuts]
68 [--wheelmouse]
69 [--buttondistinction]
70 [--fancycursors]
71 [--showcursor]
72 [--outlines]
73 [--stamps]
74 [--stampcontrols]
75 [--magiccontrols]
76 [--dontmirrorstamps]
77 [--stampsize=default]
78 [--mouse]
79 [--sysfonts]
80 [--currentlocalefont]
81 [--saveoverask]
82 [--save]
83 [--noautosave]
84 tuxpaint [--locale LOCALE]
87 tuxpaint [--lang LANGUAGE | --lang help]
90 tuxpaint [--nosysconfig]
93 [--nolockfile]
94
97 Tux Paint is a drawing program for young children. It is meant to be
98 easy and fun to use. It provides a simple interface and fixed canvas
99 size, and provides access to previous images using a thumbnail browser
100 (i.e., no access to the underlying filesystem).
101 Unlike popular drawing programs like "The GIMP," it has a very limited
103 toolset. However, it provides a much simpler interface, and has enter‐
104 taining, child-oriented additions such as sound effects.
105
108 --help Display short, helpful information about Tux Paint.
109 --version
111 Output the version info.
112 --verbose-version
114 Output the version info and compile-time build options.
115 --usage Display a list of all commandline options.
117 --copying
119 Show the license (GNU GPL) under which Tux Paint is released.
120
123 tuxpaint accepts the following options to alter the interface. They
124 can be used along with, instead of, or to override options set in con‐
125 figuration files. (See below.)
126 --fullscreen --windowed
128 Run Tux Paint in full-screen mode, or in a window (default).
129 --allowscreensaver --disablescreensaver
132 Normally, tuxpaint disables your screensaver. Use
133 --allowscreensaver to prevent this from happening.
134 --native
137 When in fullscreen mode, use the system's default screen reso‐
138 lution.
139 --WIDTHxHEIGHT
142 Run Tux Paint in a particularly-sized window, or at a particu‐
143 lar fullscreen resolution (if --native is not used). Default
144 is 800x600. Minimum width is 640. Minimum height is 480.
145 Portrait and landscape orientations are both supported. (Also
146 see --orient, below.)
147 --orient=landscape --orient=portrait
150 If --orient=portraitis set, asks Tux Paint to swap the WIDTH
151 and HEIGHT values it uses for windowed or fullscreen mode,
152 without having to actually change the WIDTH and HEIGHT values
153 in the configuration file or on the command-line. (This is use‐
154 ful on devices where the screen can be rotated, e.g. tablet
155 PCs.)
156 --nosound --sound
159 Disable or enable (default) sound.
160 --noquit --quit
163 Disable or enable (default) the on-screen Quit button and
164 Escape key sequence for quitting Tux Paint. Instead, use the
165 window close button in the titlebar, the Alt+F4 key sequence,
166 or the Shift+Control+Escape key sequence.
167 --noprint --print
170 Disable or enable (default) the Print command within Tux Paint.
171 --printdelay=SECONDS --printdelay=0
174 Only allow printing (via the Print command) once every SECONDS
175 seconds. Default is 0 (no limitation).
176 --printcfg --noprintcfg
179 (Windows and Mac OS X only.) Enable or disable loading and
180 saving of printer settings. By default, Tux Paint will print
181 to the default printer with default settings. Pressing [ALT]
182 while pushing the Print button will cause a printer dialog to
183 appear (as long as you're not in fullscreen mode; see also
184 --altprintalways and --altprintnever, below.) Unless
185 --noprintcfg is used, your previous settings will be loaded
186 when Tux Paint starts up, and setting changes will be saved for
187 next time.
188 --altprintmod --altprintnever --altprintalways
191 These options control whether an system printer dialog appears
192 when the user clicks the Print button. By default (--altprint‐
193 mod), pressing [ALT] while clicking Print will bring up a dia‐
194 log (unless you're in fullscreen mode). With --altprintalways,
195 the dialog will always appear, even if [ALT] is not being held.
196 With --altprintnever, the dialog will never appear, even if
197 [ALT] is being held.
198 --papersize PAPERSIZE
201 (Only when PostScript printing is used - not Windows, Mac OS X
202 or BeOS.) Ask Tux Paint to generate PostScript of a particular
203 paper size. Valid sizes are those supported by libpaper. See
204 papersize(5).
205 --simpleshapes --complexshapes
208 Disable or enable (default) the rotation step when using the
209 Shape tool within Tux Paint. When disabled, shapes cannot be
210 rotated; however, the interface is easier (click, drag,
211 release), which can be useful for younger or disabled children.
212 --uppercase --mixedcase
215 In uppercase mode, all text prompts and the Text drawing tool
216 will display only uppercase letters. This is useful for chil‐
217 dren who are not yet comfortable with the lowercase character‐
218 set. Default mode is mixed case.
219 --grab --nograb
222 Grab the mouse and keyboard input (if possible), so that the
223 mouse is confined to the Tux Paint window. Default is to not
224 grab.
225 --noshortcuts --shortcuts
228 If noshortcuts mode, keyboard shortcuts (e.g., Ctrl+S for Save)
229 will be disabled. Default mode is shortcuts enabled.
230 --nowheelmouse --wheelmouse
233 By default, the wheel (jog dial) on a mouse will be used to
234 scroll the selector on the right of the screen. This can be
235 disabled, and the wheel completely ignored, with the --nowheel‐
236 mouse option. This is useful for children who aren't yet com‐
237 fortable with the mouse. Default is to support the wheel.
238 --nobuttondistinction --buttondistinction
241 By default, only mouse button #1 (typically the leftmost mouse
242 button on mice with more than one button) can be used for
243 interacting with Tux Paint. With the --nobuttondistinction
244 option, mouse buttons #2 (middle) and #3 (right) can be used,
245 as well. This is useful for children who aren't yet comfort‐
246 able with the mouse. Default is to only recognize button #1.
247 --nofancycursors --fancycursors
250 Disable or enable (default) the 'fancy' mouse pointer shapes in
251 Tux Paint. While the shapes are larger, and context sensitive,
252 some environments have trouble displaying the mouse pointer,
253 and/or leave 'trails' on the screen.
254 --hidecursor --showcursor
257 Completely hide, or enable (default) the mouse pointer in Tux
258 Paint. This can be useful on touchscreen devices, such as
259 tablet PCs.
260 --nooutlines --outlines
263 In nooutlines mode, much simpler outlines and 'rubber-band'
264 lines are displayed when using the Lines, Shapes, Stamps and
265 Eraser tools. (This can help when Tux Paint is run on slower
266 computers, or displayed on a remote X display.)
267 --nostamps --stamps
270 With nostamps set, Rubber Stamp images are not loaded, so the
271 Stamps tool will not be available. This option can be used to
272 reduce the time Tux Paint takes to load, and reduce the amount
273 of RAM it requires.
274 --nostampcontrols --stampcontrols
277 Disable or enable (default) buttons to control stamps. Con‐
278 trols include mirror, flip, shrink and grow. (Note: Not all
279 stamps will be controllable in all ways.)
280 --nomagiccontrols --magiccontrols
283 Disable or enable (default) buttons to control Magic tools.
284 Controls include controlling whether a Magic tool is used like
285 a paint brush, or if it affects the entire image at once.
286 (Note: Not all Magic tools will be controllable.)
287 --mirrorstamps --dontmirrorstamps
290 With mirrorstamps set, stamps which can be mirrored will appear
291 mirrored by default. This can be useful when used by people
292 who prefer things right-to-left over left-to-right.
293 --stampsize=size --stampsize=default Sets the default size of
295 all stamps, relative to their possible sizes (determined by Tux
296 Paint, based on the dimensions of both the stamps themselves,
297 and the drawing canvas). Valid values are from 0 (smallest) to
298 10 (largest). Use default to let Tux Paint choose (this is the
299 default setting).
300 --keyboard --mouse
303 The keyboard option lets the mouse pointer in Tux Paint be con‐
304 trolled with the keyboard. The arrow keys move the pointer.
305 Spacebar acts as the mouse button.
306 --nosysfonts --sysfonts
309 Tux Paint normally attempts to search for additional TrueType
310 Fonts installed in common places on your system. If this
311 causes trouble, or you'd prefer to only make fonts installed in
312 Tux Paint's directory available, use the nosysfonts option to
313 disable this feature.
314 --alllocalefonts --currentlocalefont
317 Tux Paint avoids loading any fonts in its 'locale' font subdi‐
318 rectory, except any that match the current locale Tux Paint is
319 running under. Use the alllocalefonts option to load all such
320 fonts, for use in the "Text" tool. (This is the old behavior,
321 prior to version 0.9.21.)
322 --savedir DIR
325 Specify where Tux Paint should save files.
326 --datadir DIR
329 Specify where Tux Paint should look for personal data files
330 (brushes, stamps, etc.).
331 --saveover --saveovernew --saveoverask
334 If, when saving a picture, an older version of the file will be
335 overwritten, Tux Paint will, by default, ask for confirmation:
336 either save over the old file, or create a new file. This
337 prompt can be disabled with --saveover (which always saves over
338 older versions of pictures) or --saveovernew (which always
339 saves a new file). The default is to prompt (--saveoverask).
340 --nosave --save
343 The nosave option disables Tux Paint's ability to save files.
344 This can be used in situations where the program is only being
345 used for fun, or in a test environment.
346 --autosave --noautosave
349 The autosave option prevents Tux Paint from asking whether you
350 want to save the current picture when quitting, and assumes you
351 do.
352 --startblank --startlast
355 When you start Tux Paint, it loads the last image that was
356 being worked on. The --startblank option disables this, so it
357 always starts with a blank canvas. The default behavior is
358 --startlast.
359 --colorfile FILE
362 This option allows you to override the default color palette in
363 Tux Paint and replace it with your own. The file should be a
364 plain ASCII text file containing one color description per
365 line. Colors may be in decimal or 6- or 3-digit hexadecimal,
366 and followed by a description. (For example, "#000 Black" and
367 "255 192 64 Orange".)
368
371 Various parts of Tux Paint have been translated into numerous lan‐
372 guages. Tux Paint will try its best to honor your locale setting
373 (i.e., the LANG environment variable), if possible. You can also
374 specifically set the language using options on the command-line or in a
375 configuration file.
376 --locale LOCALE
379 Specify the language to use, based on locale name (which is
380 typically of the form language[_territory][.codeset][@modi‐
381 fier], where language is an ISO 639 language code, territory is
382 an ISO 3166 country code, and codeset is a character set or
383 encoding identifier like ISO-8859-1 or UTF-8.)
384 For example, de_DE@euro for German, or pt_BR for Brazilian Por‐
386 tuguese.
387 --lang LANGUAGE
390 Specify the language to use, based on the language's name (as
391 recognized by Tux Paint). Choose one of the language names
392 listed below:
393 - english | american-english
395 - afrikaans
396 - albanian
397 - arabic
398 - asturian
399 - azerbaijani
400 - australian-english
401 - basque | euskara
402 - belarusian | bielaruskaja
403 - bokmal
404 - brazilian-portuguese | portuges-brazilian | brazilian
405 - breton | brezhoneg
406 - british | british-english
407 - bulgarian
408 - canadian-english
409 - catalan | catala
410 - chinese | simplified-chinese
411 - croatian | hrvatski
412 - czech | cesky
413 - danish | dansk
414 - dutch
415 - esperanto
416 - estonian
417 - faroese
418 - finnish | suomi
419 - french | francais
420 - gaelic | irish-gaelic | gaidhlig
421 - galician | galego
422 - georgian
423 - german | deutsch
424 - greek
425 - gronings | zudelk-veenkelonioals
426 - gujarati
427 - hebrew
428 - hindi
429 - hungarian | magyar
430 - icelandic | islenska
431 - indonesian | bahasa-indonesia
432 - italian | italiano
433 - japanese
434 - kinyarwanda
435 - khmer
436 - klingon | tlhIngan
437 - korean
438 - kurdish
439 - latvian
440 - lithuanian | lietuviu
441 - macedonian
442 - malay
443 - mexican-spanish | espanol-mejicano | mexican
444 - ndebele
445 - norwegian | nynorsk
446 - occitan
447 - ojibway
448 - polish | polski
449 - portuguese | portugues
450 - romanian
451 - russian | russkiy
452 - scottish | scottish-gaelic | ghaidhlig
453 - serbian
454 - shuswap | secwepemctin
455 - slovak
456 - slovenian | slovensko
457 - songhay
458 - southafrican-english
459 - spanish | espanol
460 - swahili
461 - swedish | svenska
462 - tagalog
463 - tamil
464 - telugu
465 - thai
466 - tibetan
467 - traditional-chinese
468 - turkish
469 - twi
470 - ukranian
471 - venda
472 - vietnamese
473 - walloon
474 - welsh | cymraeg
475 - wolof
476 - xhosa
477 - zapoteco
478 --lang help
481 Display a lists of all supported languages.
482
485 --nosysconfig
486 With this option, Tux Paint will not attempt to read the sys‐
487 tem-wide configuration file (typically /etc/tuxpaint/tux‐
488 paint.conf).
489 --nolockfile
492 By default, Tux Paint uses a lockfile (stored in the user's
493 local Tux Paint directory) which prevents it from being
494 launched more than once in 30 seconds. (Sometimes children get
495 too eager, or user interfaces only require one click, but users
496 think they need to double-click.) This option makes Tux Paint
497 ignore the current lockfile.
498
501 While Tux Paint may refer to a number of environment variables indi‐
502 rectly (e.g., via SDL(3)), it only directly accesses the following:
503 HOME to determine where picture files go when using the Save and
505 Open commands within Tux Paint, to keep track of the current
506 image, when quitting and restarting Tux Paint, and to get the
507 user's configuration file.
508 LANG to determine langauge to use, if setlocale(3) refers to
511 'LC_MESSAGES'.
512
515 /etc/tuxpaint/tuxpaint.conf
516 System-wide configuration file. It is read first (unless the
517 --nosysconfig option was given on the command-line).
518 (Created during installation.)
520 $HOME/.tuxpaintrc
522 User's configuration file. It can be used to set default
523 options (rather than setting them on the command-line every
524 time), and/or to override any settings in the system-wide con‐
525 figuration file.
526 (Not created or edited automatically; must be created manually.
528 You can do this by hand, or use 'Tux Paint Config..')
529 $HOME/.tuxpaint/saved/
531 A directory of previously-saved images (and thumbnails). Only
532 files in this directory will be made available using the Open
533 command within Tux Paint. (See tuxpaint-import(1).)
534 (Created when Save command is used.)
536 $HOME/.tuxpaint/current_id.txt
538 A reference to the image which was being edited when Tux Paint
539 was last quit. (This image is automatically loaded the next
540 time Tux Paint is re-run.)
541 (Created when Tux Paint is Quit.)
543 $HOME/.tuxpaint/lockfile.dat
545 A lockfile that prevents Tux Paint from being launched more
546 than once every 30 seconds. Disable checking the lockfile by
547 using the ´--nolockfile´ command-line argument.
548 (There's no reason to delete the lockfile, as it contains a
550 timestamp inside which causes it to expire after 30 seconds.)
551
554 This program is free software; you can redistribute it and/or modify it
555 under the terms of the GNU General Public License as published by the
556 Free Software Foundation; either version 2 of the License, or (at your
557 option) any later version.
558
561 The canonical place to find Tux Paint information is at http://www.tux‐
562 paint.org/.
563
566 Bill Kendrick. <bill@newbreedsoftware.com>
567 With patches, fixes, extensions, translation, documentation and more
569 from lots of people, including, but not limited to:
570 Khalid Al Holan, Daniel Andersson, Joana Portia Antwi-Danso, Adorilson
572 Bezerra de Araujo, Xandru Armesto, Ben Armstrong, Ravishankar
573 Ayyakkannu, Dwayne Bailey, Martin Benjamin, Denis Bodor, Herman Bruyn‐
574 inckx, Lucie Burianova, Laurentiu Buzdugan, Albert Cahalan, Pere Pujal
575 Carabantes, Ouychai Chaita, Wei-Lun Chao, Jacques Chion, Abdoul Cisse,
576 Urska Colner, Adam 'akanewbie' Corcoran, Helder Correia, Ricardo Cruz,
577 Laurent Dhima, Yavor Doganov, Dawa Dolma, Kevin Donnelly, Alberto
578 Escudero-Pascual, Jamil Farzana, Doruk Fisek, Dovix, Korvigellou An
579 Drouizig (Philippe), Fabian Franz, Martin Fuhrer, Gabriel Gazzan,
580 Torsten Giebl, Robert Glowczynski, Chris Goerner, Mikel González, The
581 Greek Linux i18n Team, Edmund GRIMLEY EVANS, Frederico Goncalves
582 Guimaraes, Joe Hanson, Sam "Criswell" Hart, Guy Hed, Tedi Heriyanto,
583 Pjetur G. Hjaltason, Knut Erik Hollund, Khaled Hosny, Henry House,
584 Mohomodou Houssouba, Song Huang, Karl Ove Hufthammer, Roland Illig,
585 Juan Irigoien, Dmitriy Ivanov, Mogens Jaeger, Lis Gøthe Ã
586 Jákupsstovu, Nedjeljko Jedvaj, Aleksandar Jelenak, Rasmus Erik Voel
587 Jensen, Wang Jian, Amed Ã. Jiyan, Petri Jooste, Richard June, Andrej
588 Kacian, Thomas Kalka, Jorma Karvonen, Kazuhiko, Gabor Kelemen, Mark
589 Kim, Thomas Klausner, Koby, Marcin 'Shard' Konicki, Ines Kovacevic,
590 Mantas Kriauciunas, Freek de Kruijf, Andrzej M. Krzysztofowicz, Ser‐
591 afeim Kyriaki, Matthew Lange, Niko Lewman, Arkadiusz Lipiec, Ricky Lon‐
592 toc, Dag H. Loras, Burkhard Luck, Vincent Mahlangu, Ankit Malik, Neskie
593 Manuel, Fred Ulisses Maranhao, Yannig MARCHEGAY (Kokoyaya), Jorge Mari‐
594 ano, Martin, Marco Milanesi, Sergio Marques, Kartik Mistry, Mugunth,
595 Steve Murphy, Samuel Murray (Groenkloof), Shumani Mercy Nehulaudzi,
596 Mikkel Kirkgaard Nielsen, Alesis Novik, Daniel Nylander, Gareth Owen,
597 Sorin Paliga, Yannis Papatzikos, Nikolay Parukhin, Alessandro Pasotti,
598 Flavio Pastor, Patrick, Primoz Peterlin, Le Quang Phan, Henrik Pihl,
599 Auk Piseth, Pablo Pita, Milan Plzik, Sergei Popov, John Popplewell,
600 Rodrigo Perez Ramirez and Indigenas Sin Fronteras, Adam 'foo-script'
601 Rakowski, Leandro Regueiro, Simona Riva, Robin Rosenberg, Ilir Rugova,
602 Jaroslav Rynik, Bert Saal, Samuel Sarpong, Kevin Patrick Scannell,
603 Pavithran Shakamuri, Gia Shervashidze, Clytie Siddall, Kliment Simon‐
604 cev, Sokratis Sofianopoulos, Khoem Sokhem, Geert Stams, Peter Sterba,
605 Raivis Strogonovs, Tomasz 'karave' Tarach, Michal Terbert, Ignacia
606 Tike, Tilo, Tarmo Toikkanen, TOYAMA Shin-ichi, Niall Tracey, tropikha‐
607 jma, Matej Urban, Rita Verbauskaite, Daniel Jose Viana, Charles Vidal,
608 Darrell Walisser, Frank Weng, Damian Yerrick, Muhammad Najmi Ahmad
609 Zabidi, Eugene Zelenko, Martin Zhekov, and Huang Zuzhen.
610
613 tuxpaint-import(1), tuxpaint-config(1), tp-magic-config(1), xpaint(1),
614 gpaint(1), gimp(1), kolourpaint(1), krita(1), gcompris(1)
615 And documentation within /usr/[local/]share/doc/tuxpaint/.
6170.9.21 2 June 2009 TUXPAINT(1)