


TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


NAME
       tuxpaint -- "Tux Paint", a drawing program for young children.


SYNOPSYS
       tuxpaint [--help --version --verbose-version --usage --copying]


       tuxpaint [--fullscreen]
                [--allowscreensaver]
                [--WIDTHxHEIGHT]
                [--native]
                [--orient=portrait]
                [--startblank]
                [--nosound]
                [--noquit]
                [--noprint]
                [--printdelay=SECONDS]
                [--printcfg]
                [--altprintalways | --altprintnever]
                [--papersize PAPERSIZE | --papersize help]
                [--simpleshapes]
                [--uppercase]
                [--grab]
                [--noshortcuts]
                [--nowheelmouse]
                [--nobuttondistinction]
                [--nofancycursors]
                [--hidecursor]
                [--nooutlines]
                [--nostamps]
                [--nostampcontrols]
                [--nomagiccontrols]
                [--mirrorstamps]
                [--stampsize=SIZE]
                [--keyboard]
                [--nosysfonts]
                [--alllocalefonts]
                [--savedir DIR]
                [--datadir DIR]
                [--saveover]
                [--saveovernew]
                [--nosave]
                [--autosave]
                [--colorfile FILE]


       tuxpaint (defaults)
                [--windowed]
                [--disablescreensaver]
                [--800x600]
                [--orient=landscape]
                [--startlast]
                [--sound]



0.9.21                     2 June 2009                          1





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


                [--quit]
                [--print]
                [--printdelay=0]
                [--noprintcfg]
                [--altprintmod]
                [--complexshapes]
                [--mixedcase]
                [--dontgrab]
                [--shortcuts]
                [--wheelmouse]
                [--buttondistinction]
                [--fancycursors]
                [--showcursor]
                [--outlines]
                [--stamps]
                [--stampcontrols]
                [--magiccontrols]
                [--dontmirrorstamps]
                [--stampsize=default]
                [--mouse]
                [--sysfonts]
                [--currentlocalefont]
                [--saveoverask]
                [--save]
                [--noautosave]


       tuxpaint [--locale LOCALE]


       tuxpaint [--lang LANGUAGE | --lang help]


       tuxpaint [--nosysconfig]
                [--nolockfile]


DESCRIPTION
       Tux  Paint  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 "The GIMP," it has a very  limited
       toolset.  However, it provides a much simpler interface, and has enter-
       taining, child-oriented additions such as sound effects.


OPTIONS - INFORMATIONAL
       --help  Display short, helpful information about Tux Paint.

       --version
               Output the version info.




0.9.21                     2 June 2009                          2





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


       --verbose-version
               Output the version info and compile-time build options.

       --usage Display a list of all commandline options.

       --copying
               Show the license (GNU GPL) under which Tux Paint is released.


OPTIONS - INTERFACE
       tuxpaint accepts the following options to alter  the  interface.   They
       can  be used along with, instead of, or to override options set in con-
       figuration files. (See below.)

       --fullscreen --windowed
               Run Tux Paint in full-screen mode, or in a window (default).


       --allowscreensaver --disablescreensaver
               Normally,   tuxpaint    disables    your    screensaver.    Use
               --allowscreensaver to prevent this from happening.


       --native
               When  in fullscreen mode, use the system's default screen reso-
               lution.


       --WIDTHxHEIGHT
               Run Tux Paint in a particularly-sized window, or at a  particu-
               lar  fullscreen  resolution (if --native is not used).  Default
               is 800x600.  Minimum width is  640.   Minimum  height  is  480.
               Portrait  and landscape orientations are both supported.  (Also
               see --orient, below.)


       --orient=landscape --orient=portrait
               If --orient=portraitis set, asks Tux Paint to  swap  the  WIDTH
               and  HEIGHT  values  it  uses  for windowed or fullscreen mode,
               without having to actually change the WIDTH and  HEIGHT  values
               in the configuration file or on the command-line. (This is use-
               ful on devices where the screen can  be  rotated,  e.g.  tablet
               PCs.)


       --nosound --sound
               Disable or enable (default) sound.


       --noquit --quit
               Disable  or  enable  (default)  the  on-screen  Quit button and
               Escape key sequence for quitting Tux Paint.  Instead,  use  the
               window  close  button in the titlebar, the Alt+F4 key sequence,
               or the Shift+Control+Escape key sequence.



0.9.21                     2 June 2009                          3





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


       --noprint --print
               Disable or enable (default) the Print command within Tux Paint.


       --printdelay=SECONDS --printdelay=0
               Only  allow printing (via the Print command) once every SECONDS
               seconds.  Default is 0 (no limitation).


       --printcfg --noprintcfg
               (Windows and Mac OS X only.)  Enable  or  disable  loading  and
               saving  of  printer settings.  By default, Tux Paint will print
               to the default printer with default settings.   Pressing  [ALT]
               while  pushing  the Print button will cause a printer dialog to
               appear (as long as you're not  in  fullscreen  mode;  see  also
               --altprintalways    and    --altprintnever,   below.)    Unless
               --noprintcfg is used, your previous  settings  will  be  loaded
               when Tux Paint starts up, and setting changes will be saved for
               next time.


       --altprintmod --altprintnever --altprintalways
               These options control whether an system printer dialog  appears
               when the user clicks the Print button.  By default (--altprint-
               mod), pressing [ALT] while clicking Print will bring up a  dia-
               log (unless you're in fullscreen mode).  With --altprintalways,
               the dialog will always appear, even if [ALT] is not being held.
               With  --altprintnever,  the  dialog  will never appear, even if
               [ALT] is being held.


       --papersize PAPERSIZE
               (Only when PostScript printing is used - not Windows, Mac OS  X
               or BeOS.)  Ask Tux Paint to generate PostScript of a particular
               paper size.  Valid sizes are those supported by libpaper.   See
               papersize(5).


       --simpleshapes --complexshapes
               Disable  or  enable  (default) the rotation step when using the
               Shape tool within Tux Paint.  When disabled, shapes  cannot  be
               rotated;   however,  the  interface  is  easier  (click,  drag,
               release), which can be useful for younger or disabled children.


       --uppercase --mixedcase
               In  uppercase  mode, all text prompts and the Text drawing tool
               will display only uppercase letters.  This is useful for  chil-
               dren  who are not yet comfortable with the lowercase character-
               set.  Default mode is mixed case.


       --grab --nograb
               Grab the mouse and keyboard input (if possible),  so  that  the



0.9.21                     2 June 2009                          4





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


               mouse  is  confined to the Tux Paint window.  Default is to not
               grab.


       --noshortcuts --shortcuts
               If noshortcuts mode, keyboard shortcuts (e.g., Ctrl+S for Save)
               will be disabled.  Default mode is shortcuts enabled.


       --nowheelmouse --wheelmouse
               By  default,  the  wheel  (jog dial) on a mouse will be used to
               scroll the selector on the right of the screen.   This  can  be
               disabled, and the wheel completely ignored, with the --nowheel-
               mouse option.  This is useful for children who aren't yet  com-
               fortable with the mouse.  Default is to support the wheel.


       --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  Tux  Paint.   With the --nobuttondistinction
               option, mouse buttons #2 (middle) and #3 (right) can  be  used,
               as  well.   This is useful for children who aren't yet comfort-
               able with the mouse.  Default is to only recognize button #1.


       --nofancycursors --fancycursors
               Disable or enable (default) the 'fancy' mouse pointer shapes in
               Tux Paint.  While the shapes are larger, and context sensitive,
               some environments have trouble displaying  the  mouse  pointer,
               and/or leave 'trails' on the screen.


       --hidecursor --showcursor
               Completely  hide,  or enable (default) the mouse pointer in Tux
               Paint.  This can be useful  on  touchscreen  devices,  such  as
               tablet PCs.


       --nooutlines --outlines
               In  nooutlines  mode,  much  simpler outlines and 'rubber-band'
               lines are displayed when using the Lines,  Shapes,  Stamps  and
               Eraser  tools.  (This  can help when Tux Paint is run on slower
               computers, or displayed on a remote X display.)


       --nostamps --stamps
               With nostamps set, Rubber Stamp images are not loaded,  so  the
               Stamps  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.






0.9.21                     2 June 2009                          5





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


       --nostampcontrols --stampcontrols
               Disable  or  enable  (default) buttons to control stamps.  Con-
               trols include mirror, flip, shrink and grow.   (Note:  Not  all
               stamps will be controllable in all ways.)


       --nomagiccontrols --magiccontrols
               Disable  or  enable  (default)  buttons to control Magic tools.
               Controls include controlling whether a Magic tool is used  like
               a  paint  brush,  or  if  it  affects the entire image at once.
               (Note: Not all Magic tools will be controllable.)


       --mirrorstamps --dontmirrorstamps
               With mirrorstamps 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.

               --stampsize=size --stampsize=default Sets the default  size  of
               all stamps, relative to their possible sizes (determined by Tux
               Paint, based on the dimensions of both the  stamps  themselves,
               and the drawing canvas).  Valid values are from 0 (smallest) to
               10 (largest).  Use default to let Tux Paint choose (this is the
               default setting).


       --keyboard --mouse
               The keyboard option lets the mouse pointer in Tux Paint be con-
               trolled with the keyboard.  The arrow keys  move  the  pointer.
               Spacebar acts as the mouse button.


       --nosysfonts --sysfonts
               Tux  Paint  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
               Tux Paint's directory available, use the nosysfonts  option  to
               disable this feature.


       --alllocalefonts --currentlocalefont
               Tux  Paint avoids loading any fonts in its 'locale' font subdi-
               rectory, except any that match the current locale Tux Paint  is
               running  under.  Use the alllocalefonts option to load all such
               fonts, for use in the "Text" tool. (This is the  old  behavior,
               prior to version 0.9.21.)


       --savedir DIR
               Specify where Tux Paint should save files.


       --datadir DIR
               Specify  where  Tux  Paint  should look for personal data files



0.9.21                     2 June 2009                          6





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


               (brushes, stamps, etc.).


       --saveover --saveovernew --saveoverask
               If, when saving a picture, an older version of the file will be
               overwritten,  Tux Paint will, by default, ask for confirmation:
               either save over the old file, or  create  a  new  file.   This
               prompt can be disabled with --saveover (which always saves over
               older versions of  pictures)  or  --saveovernew  (which  always
               saves a new file).  The default is to prompt (--saveoverask).


       --nosave --save
               The  nosave  option disables Tux Paint's ability to save files.
               This can be used in situations where the program is only  being
               used for fun, or in a test environment.


       --autosave --noautosave
               The  autosave option prevents Tux Paint from asking whether you
               want to save the current picture when quitting, and assumes you
               do.


       --startblank --startlast
               When  you  start  Tux  Paint,  it loads the last image that was
               being worked on.  The --startblank option disables this, so  it
               always  starts  with  a  blank canvas.  The default behavior is
               --startlast.


       --colorfile FILE
               This option allows you to override the default color palette in
               Tux  Paint  and  replace it with your own. The file should be a
               plain ASCII text file  containing  one  color  description  per
               line.  Colors  may  be in decimal or 6- or 3-digit hexadecimal,
               and followed by a description. (For example, "#000  Black"  and
               "255 192 64 Orange".)


OPTIONS - LANGUAGE
       Various  parts  of  Tux  Paint  have been translated into numerous lan-
       guages.  Tux Paint will try its  best  to  honor  your  locale  setting
       (i.e.,  the  LANG  environment  variable),  if  possible.  You can also
       specifically set the language using options on the command-line or in a
       configuration file.


       --locale LOCALE
               Specify  the  language  to  use, based on locale name (which is
               typically  of  the  form  language[_territory][.codeset][@modi-
               fier], where language is an ISO 639 language code, territory is
               an ISO 3166 country code, and codeset is  a  character  set  or
               encoding identifier like ISO-8859-1 or UTF-8.)



0.9.21                     2 June 2009                          7





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


              For  example, de_DE@euro for German, or pt_BR for Brazilian Por-
              tuguese.


       --lang LANGUAGE
               Specify the language to use, based on the language's  name  (as
               recognized  by  Tux  Paint).   Choose one of the language names
               listed below:

              - english | american-english
              - afrikaans
              - albanian
              - arabic
              - asturian
              - azerbaijani
              - australian-english
              - basque | euskara
              - belarusian | bielaruskaja
              - bokmal
              - brazilian-portuguese | portuges-brazilian | brazilian
              - breton | brezhoneg
              - british | british-english
              - bulgarian
              - canadian-english
              - catalan | catala
              - chinese | simplified-chinese
              - croatian | hrvatski
              - czech | cesky
              - danish | dansk
              - dutch
              - esperanto
              - estonian
              - faroese
              - finnish | suomi
              - french | francais
              - gaelic | irish-gaelic | gaidhlig
              - galician | galego
              - georgian
              - german | deutsch
              - greek
              - gronings | zudelk-veenkelonioals
              - gujarati
              - hebrew
              - hindi
              - hungarian | magyar
              - icelandic | islenska
              - indonesian | bahasa-indonesia
              - italian | italiano
              - japanese
              - kinyarwanda
              - khmer
              - klingon | tlhIngan
              - korean
              - kurdish



0.9.21                     2 June 2009                          8





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


              - latvian
              - lithuanian | lietuviu
              - macedonian
              - malay
              - mexican-spanish | espanol-mejicano | mexican
              - ndebele
              - norwegian | nynorsk
              - occitan
              - ojibway
              - polish | polski
              - portuguese | portugues
              - romanian
              - russian | russkiy
              - scottish | scottish-gaelic | ghaidhlig
              - serbian
              - shuswap | secwepemctin
              - slovak
              - slovenian | slovensko
              - songhay
              - southafrican-english
              - spanish | espanol
              - swahili
              - swedish | svenska
              - tagalog
              - tamil
              - telugu
              - thai
              - tibetan
              - traditional-chinese
              - turkish
              - twi
              - ukranian
              - venda
              - vietnamese
              - walloon
              - welsh | cymraeg
              - wolof
              - xhosa
              - zapoteco


       --lang help
               Display a lists of all supported languages.


OPTIONS - MISCELLANEOUS
       --nosysconfig
               With this option, Tux Paint will not attempt to read  the  sys-
               tem-wide   configuration   file  (typically  /etc/tuxpaint/tux-
               paint.conf).


       --nolockfile
               By default, Tux Paint uses a lockfile  (stored  in  the  user's



0.9.21                     2 June 2009                          9





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


               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 Tux  Paint
               ignore the current lockfile.


ENVIRONMENT
       While  Tux  Paint  may refer to a number of environment variables indi-
       rectly (e.g., via SDL(3)), it only directly accesses the following:


       HOME    to determine where picture files go when  using  the  Save  and
               Open  commands  within  Tux Paint, to keep track of the current
               image, when quitting and restarting Tux Paint, and to  get  the
               user's configuration file.


       LANG    to  determine  langauge  to  use,  if  setlocale(3)  refers  to
               'LC_MESSAGES'.


FILES
       /etc/tuxpaint/tuxpaint.conf
               System-wide configuration file.  It is read first  (unless  the
               --nosysconfig option was given on the command-line).

               (Created during installation.)

       $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 con-
               figuration file.

               (Not created or edited automatically; must be created manually.
               You can do this by hand, or use 'Tux Paint Config..')

       $HOME/.tuxpaint/saved/
               A  directory of previously-saved images (and thumbnails).  Only
               files in this directory will be made available using  the  Open
               command within Tux Paint.  (See tuxpaint-import(1).)

               (Created when Save command is used.)

       $HOME/.tuxpaint/current_id.txt
               A  reference to the image which was being edited when Tux Paint
               was last quit.  (This image is automatically  loaded  the  next
               time Tux Paint is re-run.)

               (Created when Tux Paint is Quit.)

       $HOME/.tuxpaint/lockfile.dat
               A  lockfile  that  prevents  Tux Paint from being launched more



0.9.21                     2 June 2009                         10





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


               than once every 30 seconds.  Disable checking the  lockfile  by
               using the '--nolockfile' command-line argument.

               (There's  no  reason  to  delete the lockfile, as it contains a
               timestamp inside which causes it to expire after 30 seconds.)


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.


OTHER INFO
       The canonical place to find Tux Paint information is at http://www.tux-
       paint.org/.


AUTHORS
       Bill Kendrick.  <bill@newbreedsoftware.com>

       With patches, fixes, extensions, translation,  documentation  and  more
       from lots of people, including, but not limited to:

       Khalid  Al Holan, Daniel Andersson, Joana Portia Antwi-Danso, Adorilson
       Bezerra  de  Araujo,  Xandru  Armesto,   Ben   Armstrong,   Ravishankar
       Ayyakkannu,  Dwayne Bailey, Martin Benjamin, Denis Bodor, Herman Bruyn-
       inckx, Lucie Burianova, Laurentiu Buzdugan, Albert Cahalan, Pere  Pujal
       Carabantes,  Ouychai Chaita, Wei-Lun Chao, Jacques Chion, Abdoul Cisse,
       Urska Colner, Adam 'akanewbie' Corcoran, Helder Correia, Ricardo  Cruz,
       Laurent  Dhima,  Yavor  Doganov,  Dawa  Dolma,  Kevin Donnelly, Alberto
       Escudero-Pascual, Jamil Farzana, Doruk  Fisek,  Dovix,  Korvigellou  An
       Drouizig  (Philippe),  Fabian  Franz,  Martin  Fuhrer,  Gabriel Gazzan,
       Torsten Giebl, Robert Glowczynski, Chris Goerner, Mikel  Gonzalez,  The
       Greek  Linux  i18n  Team,  Edmund  GRIMLEY  EVANS,  Frederico Goncalves
       Guimaraes, Joe Hanson, Sam "Criswell" Hart, Guy  Hed,  Tedi  Heriyanto,
       Pjetur  G.  Hjaltason,  Knut  Erik  Hollund, Khaled Hosny, Henry House,
       Mohomodou Houssouba, Song Huang, Karl  Ove  Hufthammer,  Roland  Illig,
       Juan  Irigoien, Dmitriy Ivanov, Mogens Jaeger, Lis Gothe i Jakupsstovu,
       Nedjeljko Jedvaj, Aleksandar Jelenak, Rasmus  Erik  Voel  Jensen,  Wang
       Jian,  Amed C. Jiyan, Petri Jooste, Richard June, Andrej Kacian, Thomas
       Kalka, Jorma Karvonen, Kazuhiko, Gabor Kelemen, Mark Kim, Thomas Klaus-
       ner,  Koby, Marcin 'Shard' Konicki, Ines Kovacevic, Mantas Kriauciunas,
       Freek de Kruijf, Andrzej M. Krzysztofowicz, Serafeim  Kyriaki,  Matthew
       Lange,  Niko  Lewman,  Arkadiusz  Lipiec,  Ricky  Lontoc, Dag H. Loras,
       Burkhard Luck, Vincent  Mahlangu,  Ankit  Malik,  Neskie  Manuel,  Fred
       Ulisses  Maranhao,  Yannig MARCHEGAY (Kokoyaya), Jorge Mariano, Martin,
       Marco Milanesi, Sergio Marques, Kartik Mistry, Mugunth,  Steve  Murphy,
       Samuel  Murray (Groenkloof), Shumani Mercy Nehulaudzi, Mikkel Kirkgaard
       Nielsen, Alesis Novik, Daniel Nylander, Gareth Owen, Sorin Paliga, Yan-
       nis  Papatzikos,  Nikolay  Parukhin, Alessandro Pasotti, Flavio Pastor,
       Patrick, Primoz Peterlin, Le Quang Phan, Henrik Pihl, Auk Piseth, Pablo
       Pita, Milan Plzik, Sergei Popov, John Popplewell, Rodrigo Perez Ramirez



0.9.21                     2 June 2009                         11





TUXPAINT(1)                 Tux Paint                 TUXPAINT(1)


       and  Indigenas  Sin  Fronteras,  Adam  'foo-script'  Rakowski,  Leandro
       Regueiro,  Simona  Riva,  Robin Rosenberg, Ilir Rugova, Jaroslav Rynik,
       Bert Saal, Samuel Sarpong, Kevin Patrick Scannell, Pavithran Shakamuri,
       Gia  Shervashidze,  Clytie  Siddall,  Kliment  Simoncev, Sokratis Sofi-
       anopoulos, Khoem Sokhem, Geert Stams, Peter Sterba, Raivis  Strogonovs,
       Tomasz  'karave'  Tarach,  Michal  Terbert,  Ignacia  Tike, Tilo, Tarmo
       Toikkanen, TOYAMA Shin-ichi, Niall Tracey,  tropikhajma,  Matej  Urban,
       Rita  Verbauskaite, Daniel Jose Viana, Charles Vidal, Darrell Walisser,
       Frank  Weng,  Damian  Yerrick,  Muhammad  Najmi  Ahmad  Zabidi,  Eugene
       Zelenko, Martin Zhekov, and Huang Zuzhen.


SEE ALSO
       tuxpaint-import(1),  tuxpaint-config(1), tp-magic-config(1), xpaint(1),
       gpaint(1), gimp(1), kolourpaint(1), krita(1), gcompris(1)

       And documentation within /usr/local/share/doc/tuxpaint/.








































0.9.21                     2 June 2009                         12


