1TUXPAINT(1)                        Tux Paint                       TUXPAINT(1)
2
3
4

NAME

6       tuxpaint -- A drawing program for young children.
7
8

SYNOPSYS

10       tuxpaint [--help --version --usage --copying]
11
12
13       tuxpaint [--fullscreen]   [--640x480   |  --1024x768  |  --1280x1024  |
14                --1400x1050 | --1600x1200 | --WxH ] [--startblank] [--nosound]
15                [--noquit]   [--noprint]  [--printdelay=SECONDS]  [--printcfg]
16                [--simpleshapes]   [--uppercase]   [--grab]    [--noshortcuts]
17                [--nowheelmouse]   [--nobuttondistinction]  [--nofancycursors]
18                [--nooutlines]   [--nostamps]   [--nostampcontrols]    [--mir‐
19                rorstamps]   [--keyboard]   [--nosysfonts]   [--savedir   DIR]
20                [--saveover] [--saveovernew] [--nosave] [--colorfile FILE]
21
22
23       tuxpaint (defaults)
24                [--windowed]  [--800x600]  [--startlast]  [--sound]   [--quit]
25                [--print]  [--printdelay=0]  [--noprintcfg]  [--complexshapes]
26                [--mixedcase]   [--dontgrab]   [--shortcuts]    [--wheelmouse]
27                [--buttondistinction] [--fancycursors] [--outlines] [--stamps]
28                [--stampcontrols] [--dontmirrorstamps] [--mouse]  [--sysfonts]
29                [--saveoverask] [--save]
30
31
32       tuxpaint [--locale LOCALE]
33
34
35       tuxpaint [--lang LANGUAGE | --lang help]
36
37
38       tuxpaint [--nosysconfig] [--nolockfile]
39
40

DESCRIPTION

42       Tux  Paint  is a drawing program for young children.  It is meant to be
43       easy and fun to use.  It provides a simple interface and  fixed  canvas
44       size,  and provides access to previous images using a thumbnail browser
45       (i.e., no access to the underlying filesystem).
46
47       Unlike popular drawing programs like "The GIMP," it has a very  limited
48       toolset.  However, it provides a much simpler interface, and has enter‐
49       taining, child-oriented additions such as sound effects.
50
51

OPTIONS - INFORMATIONAL

53       --help  Display short, helpful information about Tux Paint.
54
55       --version
56               Output the version info.
57
58       --usage Display a list of all commandline options.
59
60       --copying
61               Show the license (GNU GPL) under which Tux Paint is released.
62
63

OPTIONS - INTERFACE

65       tuxpaint accepts the following options to alter  the  interface.   They
66       can  be used along with, instead of, or to override options set in con‐
67       figuration files. (See below.)
68
69       --fullscreen --windowed
70               Run Tux Paint in full-screen mode, or in a window (default).
71
72
73       --800x600 --1024x768 -- 1280x1024 --1400x1050 --1600x1200 --640x480
74               Run Tux Paint  at  higher  resolution,  or  640x480  resolution
75               (default).
76
77
78       --nosound --sound
79               Disable or enable (default) sound.
80
81
82       --noquit --quit
83               Disable  or  enable  (default)  the  on-screen  Quit button and
84               Escape key sequence for quitting Tux Paint.  Instead,  use  the
85               window  close  button in the titlebar, the Alt+F4 key sequence,
86               or the Shift+Control+Escape key sequence.
87
88
89       --noprint --print
90               Disable or enable (default) the Print command within Tux Paint.
91
92
93       --printdelay=SECONDS --printdelay=0
94               Only allow printing (via the Print command) once every  SECONDS
95               seconds.  Default is 0 (no limitation).
96
97
98       --printcfg --noprintcfg
99               (Windows  only.)   Enable  or  disable  loading  and  saving of
100               printer settings.  By default, Tux  Paint  will  print  to  the
101               default  printer  with  default settings.  Pressing [ALT] while
102               pushing the Print button will cause a Windows printer dialog to
103               appear (as long as you're not in fullscreen mode.)  If --print‐
104               cfg is used, your previous settings will  be  loaded  when  Tux
105               Paint  starts  up,  and  setting changes will be saved for next
106               time.
107
108
109       --simpleshapes --complexshapes
110               Disable or enable (default) the rotation step  when  using  the
111               Shape  tool  within Tux Paint.  When disabled, shapes cannot be
112               rotated;  however,  the  interface  is  easier  (click,   drag,
113               release), which can be useful for younger or disabled children.
114
115
116       --uppercase --mixedcase
117               In  uppercase  mode, all text prompts and the Text drawing tool
118               will display only uppercase letters.  This is useful for  chil‐
119               dren  who are not yet comfortable with the lowercase character‐
120               set.  Default mode is mixed case.
121
122
123       --grab --nograb
124               Grab the mouse and keyboard input (if possible),  so  that  the
125               mouse  is  confined to the Tux Paint window.  Default is to not
126               grab.
127
128
129       --noshortcuts --shortcuts
130               If noshortcuts mode, keyboard shortcuts (e.g., Ctrl+S for Save)
131               will be disabled.  Default mode is shortcuts enabled.
132
133
134       --nowheelmouse --wheelmouse
135               By  default,  the  wheel  (jog dial) on a mouse will be used to
136               scroll the selector on the right of the screen.   This  can  be
137               disabled, and the wheel completely ignored, with the --nowheel‐
138               mouse option.  This is useful for children who aren't yet  com‐
139               fortable with the mouse.  Default is to support the wheel.
140
141
142       --nobuttondistinction --buttondistinction
143               By  default, only mouse button #1 (typically the leftmost mouse
144               button on mice with more than  one  button)  can  be  used  for
145               interacting  with  Tux  Paint.   With the --nobuttondistinction
146               option, mouse buttons #2 (middle) and #3 (right) can  be  used,
147               as  well.   This is useful for children who aren't yet comfort‐
148               able with the mouse.  Default is to only recognize button #1.
149
150
151       --nofancycursors --fancycursors
152               Disable or enable (default) the 'fancy' mouse pointer shapes in
153               Tux Paint.  While the shapes are larger, and context sensitive,
154               some environments have trouble displaying  the  mouse  pointer,
155               and/or leave 'trails' on the screen.
156
157
158       --nooutlines --outlines
159               In  nooutlines  mode,  much  simpler outlines and 'rubber-band'
160               lines are displayed when using the Lines,  Shapes,  Stamps  and
161               Eraser  tools.  (This  can help when Tux Paint is run on slower
162               computers, or displayed on a remote X display.)
163
164
165       --nostamps --stamps
166               With nostamps set, Rubber Stamp images are not loaded,  so  the
167               Stamps  tool will not be available.  This option can be used to
168               reduce the time Tux Paint takes to load, and reduce the  amount
169               of RAM it requires.
170
171
172       --nostampcontrols --stampcontrols
173               Disable  or  enable  (default) buttons to control stamps.  Con‐
174               trols include mirror, flip, shrink and grow.   (Note:  Not  all
175               stamps will be controllable in all ways.)
176
177
178       --mirrorstamps --dontmirrorstamps
179               With mirrorstamps set, stamps which can be mirrored will appear
180               mirrored by default.  This can be useful when  used  by  people
181               who prefer things right-to-left over left-to-right.
182
183
184       --keyboard --mouse
185               The keyboard option lets the mouse pointer in Tux Paint be con‐
186               trolled with the keyboard.  The arrow keys  move  the  pointer.
187               Spacebar acts as the mouse button.
188
189
190       --nosysfonts --sysfonts
191               Tux  Paint  normally attempts to search for additional TrueType
192               Fonts installed in common  places  on  your  system.   If  this
193               causes trouble, or you'd prefer to only make fonts installed in
194               Tux Paint's directory available, use the nosysfonts  option  to
195               disable this feature.
196
197
198       --savedir DIR
199               Specify where Tux Paint should save files.  By default, this is
200               "~/.tuxpaint/saved" under Linux and Unix, and "userdata\" under
201               Windows.
202
203
204       --saveover --saveovernew --saveoverask
205               If, when saving a picture, an older version of the file will be
206               overwritten, Tux Paint will, by default, ask for  confirmation:
207               either  save  over  the  old  file, or create a new file.  This
208               prompt can be disabled with --saveover (which always saves over
209               older  versions  of  pictures)  or  --saveovernew (which always
210               saves a new file).  The default is to prompt (--saveoverask).
211
212
213       --nosave --save
214               The nosave option disables Tux Paint's ability to  save  files.
215               This  can be used in situations where the program is only being
216               used for fun, or in a test environment.
217
218
219       --startblank --startlast
220               When you start Tux Paint, it loads  the  last  image  that  was
221               being  worked on.  The --startblank option disables this, so it
222               always starts with a blank canvas.   The  default  behavior  is
223               --startlast.
224
225
226       --colorfile FILE
227               This option allows you to override the default color palette in
228               Tux Paint and replace it with your own. The file  should  be  a
229               plain  ASCII  text  file  containing  one color description per
230               line. Colors may be in decimal or 6-  or  3-digit  hexadecimal,
231               and  followed  by a description. (For example, "#000 Black" and
232               "255 192 64 Orange".)
233
234

OPTIONS - LANGUAGE

236       Various parts of Tux Paint have  been  translated  into  numerous  lan‐
237       guages.   Tux  Paint  will  try  its  best to honor your locale setting
238       (i.e., the LANG environment  variable),  if  possible.   You  can  also
239       specifically set the language using options on the command-line or in a
240       configuration file.
241
242
243       --locale LOCALE
244               Specify the language to use, based on  locale  name  (which  is
245               typically  of  the  form  language[_territory][.codeset][@modi‐
246               fier], where language is an ISO 639 language code, territory is
247               an  ISO  3166  country  code, and codeset is a character set or
248               encoding identifier like ISO-8859-1 or UTF-8.)
249
250              For example, de_DE@euro for German, or pt_BR for Brazilian  Por‐
251              tuguese.
252
253
254       --lang LANGUAGE
255               Specify  the  language to use, based on the language's name (as
256               recognized by Tux Paint).  Choose one  of  the  language  names
257               listed below:
258
259              - english | american-english
260              - afrikaans
261              - albanian
262              - arabic
263              - basque | euskara
264              - belarusian | bielaruskaja
265              - bokmal
266              - brazilian-portuguese | portuges-brazilian | brazilian
267              - breton | brezhoneg
268              - british | british-english
269              - bulgarian
270              - catalan | catala
271              - chinese | simplified-chinese
272              - croatian | hrvatski
273              - czech | cesky
274              - danish | dansk
275              - dutch
276              - estonian
277              - faroese
278              - finnish | suomi
279              - french | francais
280              - gaelic | irish-gaelic | gaidhlig
281              - galician | galego
282              - georgian
283              - german | deutsch
284              - greek
285              - gronings | zudelk-veenkelonioals
286              - gujarati
287              - hebrew
288              - hindi
289              - hungarian | magyar
290              - icelandic | islenska
291              - indonesian | bahasa-indonesia
292              - italian | italiano
293              - japanese
294              - kinyarwanda
295              - klingon | tlhIngan
296              - korean
297              - kurdish
298              - lithuanian | lietuviu
299              - malay
300              - mexican-spanish | espanol-mejicano | mexican
301              - ndebele
302              - norwegian | nynorsk
303              - polish | polski
304              - portuguese | portugues
305              - romanian
306              - russian | russkiy
307              - scottish | scottish-gaelic | ghaidhlig
308              - serbian
309              - slovak
310              - slovenian | slovensko
311              - southafrican-english
312              - spanish | espanol
313              - swahili
314              - swedish | svenska
315              - tagalog
316              - tamil
317              - thai
318              - tibetan
319              - traditional-chinese
320              - turkish
321              - ukranian
322              - venda
323              - vietnamese
324              - walloon
325              - welsh | cymraeg
326              - xhosa
327
328
329       --lang help
330               Display a lists of all supported languages.
331
332

OPTIONS - MISCELLANEOUS

334       --nosysconfig
335               With  this  option, Tux Paint will not attempt to read the sys‐
336               tem-wide  configuration  file   (typically   /etc/tuxpaint/tux‐
337               paint.conf).
338
339
340       --nolockfile
341               By  default,  Tux  Paint  uses a lockfile (stored in the user's
342               local  Tux  Paint  directory)  which  prevents  it  from  being
343               launched  more than once in 30 seconds. (Sometimes children get
344               too eager, or user interfaces only require one click, but users
345               think  they need to double-click.)  This option makes Tux Paint
346               ignore the current lockfile.
347
348

ENVIRONMENT

350       While Tux Paint may refer to a number of  environment  variables  indi‐
351       rectly (e.g., via SDL(3)), it only directly accesses the following:
352
353       HOME    to  determine  where  picture  files go when using the Save and
354               Open commands within Tux Paint, to keep track  of  the  current
355               image,  when  quitting and restarting Tux Paint, and to get the
356               user's configuration file.
357
358
359       LANG    to  determine  langauge  to  use,  if  setlocale(3)  refers  to
360               'LC_MESSAGES'.
361
362

FILES

364       /etc/tuxpaint/tuxpaint.conf
365               System-wide  configuration  file.  It is read first (unless the
366               --nosysconfig option was given on the command-line).
367
368               (Created during installation.)
369
370       $HOME/.tuxpaintrc
371               User's configuration file.  It  can  be  used  to  set  default
372               options  (rather  than  setting  them on the command-line every
373               time), and/or to override any settings in the system-wide  con‐
374               figuration file.
375
376               (Not created or edited automatically; must be created manually.
377               You can do this by hand, or use 'Tux Paint Config..')
378
379       $HOME/.tuxpaint/saved/
380               A directory of previously-saved images (and thumbnails).   Only
381               files  in  this directory will be made available using the Open
382               command within Tux Paint.  (See tuxpaint-import(1).)
383
384               (Created when Save command is used.)
385
386       $HOME/.tuxpaint/current_id.txt
387               A reference to the image which was being edited when Tux  Paint
388               was  last  quit.   (This image is automatically loaded the next
389               time Tux Paint is re-run.)
390
391               (Created when Tux Paint is Quit.)
392
393       $HOME/.tuxpaint/lockfile.dat
394               A lockfile that prevents Tux Paint  from  being  launched  more
395               than  once  every 30 seconds.  Disable checking the lockfile by
396               using the ´--nolockfile´ command-line argument.
397
398               (There's no reason to delete the lockfile,  as  it  contains  a
399               timestamp inside which causes it to expire after 30 seconds.)
400
401
403       This program is free software; you can redistribute it and/or modify it
404       under the terms of the GNU General Public License as published  by  the
405       Free  Software Foundation; either version 2 of the License, or (at your
406       option) any later version.
407
408

OTHER INFO

410       The canonical place to find Tux Paint information is at http://www.new
411       breedsoftware.com/tuxpaint/.
412
413

AUTHORS

415       Bill Kendrick.  <bill@newbreedsoftware.com>
416
417       With  patches,  fixes,  extensions, translation, documentation and more
418       from lots of people, including, but not limited to:
419
420       Khalid Al Holan, Daniel Andersson, Ben Armstrong, Dwayne Bailey, Martin
421       Benjamin,  Denis  Bodor,  Herman Bruyninckx, Lucie Burianova, Laurentiu
422       Buzdugan, Albert Cahalan, Pere Pujal Carabantes, Ouychai  Chaita,  Wei-
423       Lun  Chao,  Jacques  Chion, Urska Colner, Helder Correia, Ricardo Cruz,
424       Laurent Dhima, Yavor  Doganov,  Dawa  Dolma,  Kevin  Donnelly,  Alberto
425       Escudero-Pascual,   Doruk   Fisek,   Dovix,   Korvigellou  An  Drouizig
426       (Philippe), Fabian Franz, Gabriel Gazzan, The Greek  Linux  i18n  Team,
427       Robert  Glowczynski,  Sam  "Criswell"  Hart,  Tedi Heriyanto, Pjetur G.
428       Hjaltason, Knut Erik Hollund, Song Huang, Karl Ove  Hufthammer,  Roland
429       Illig,  Juan  Irigoien,  Dmitriy  Ivanov,  Mogens  Jaeger,  Lis Gøthe í
430       Jákupsstovu, Nedjeljko Jedvaj, Aleksandar  Jelenak,  Rasmus  Erik  Voel
431       Jensen,  Wang  Jian,  Amed  Ç.  Jiyan,  Petri  Jooste,  Andrej  Kacian,
432       Kazuhiko, Gabor  Kelemen,  Mark  Kim,  Thomas  Klausner,  Koby,  Marcin
433       'Shard' Konicki, Ines Kovacevic, Mantas Kriauciunas, Niko Lewman, Arka‐
434       diusz Lipiec, Ricky  Lontoc,  Dag  H.  Loras,  Burkhard  Luck,  Vincent
435       Mahlangu,  Ankit  Malik, Fred Ulisses Maranhao, Martin, Marco Milanesi,
436       Kartik Mistry, Mugunth, Steve Murphy, Shumani Mercy Nehulaudzi,  Daniel
437       Nylander,  Gareth  Owen,  Flavio  Pastor,  Patrick, Primoz Peterlin, Le
438       Quang Phan, Henrik Pihl, Pablo  Pita,  Milan  Plzik,  John  Popplewell,
439       Leandro Regueiro, Robin Rosenberg, Ilir Rugova, Kevin Patrick Scannell,
440       Gia Shervashidze, Clytie Siddall, Sokratis Sofianopoulos, Geert  Stams,
441       Peter  Sterba,  Tomasz  'karave' Tarach, Tarmo Toikkanen, Niall Tracey,
442       TOYAMA Shin-ichi, Matej Urban, Rita Verbauskaite,  Daniel  Jose  Viana,
443       Charles  Vidal,  Damian  Yerrick,  Muhammad  Najmi Ahmad Zabidi, Eugene
444       Zelenko, and Martin Zhekov.
445
446

SEE ALSO

448       tuxpaint-import(1), tuxpaint-config(1), xpaint(1), gpaint(1),  gimp(1),
449       kolourpaint(1), krita(1), gcompris(1)
450
451       And documentation within /usr/[local/]share/doc/tuxpaint/.
452
453
454
4550.9.16                            11 Oct 2006                      TUXPAINT(1)
Impressum