Provided by: tuxpaint_0.9.22-2_amd64 bug

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]
                [--nolabel]
                [--mirrorstamps]
                [--mouse-accessibility]
                [--onscreen-keyboard]
                [--joystick-dev=DEVICE]
                [--joystick-dev=list]
                [--joystick-slowness=SPEED]
                [--joystick-threshold=THRESHOLD]
                [--joystick-maxsteps=STEPS]
                [--joystick-hat-timeout=MILLISECONDS]
                [--joystick-hat-slowness=SPEED]
                [--joystick-btn-escape=BUTTON]
                [--joystick-btn-brush=BUTTON]
                [--joystick-btn-stamp=BUTTON]
                [--joystick-btn-lines=BUTTON]
                [--joystick-btn-shapes=BUTTON]
                [--joystick-btn-text=BUTTON]
                [--joystick-btn-label=BUTTON]
                [--joystick-btn-magic=BUTTON]
                [--joystick-btn-undo=BUTTON]
                [--joystick-btn-redo=BUTTON]
                [--joystick-btn-eraser=BUTTON]
                [--joystick-btn-new=BUTTON]
                [--joystick-btn-open=BUTTON]
                [--joystick-btn-save=BUTTON]
                [--joystick-btn-pgsetup=BUTTON]
                [--joystick-btn-print=BUTTON]
                [--joystick-buttons-ignore=BUTTON1,BUTTON2,...]
                [--stampsize=SIZE]
                [--keyboard]
                [--nosysfonts]
                [--alllocalefonts]
                [--savedir DIR]
                [--datadir DIR]
                [--saveover]
                [--saveovernew]
                [--nosave]
                [--autosave]
                [--colorfile FILE]

       tuxpaint (defaults)
                [--windowed]
                [--disablescreensaver]
                [--800x600]
                [--orient=landscape]
                [--startlast]
                [--sound]
                [--quit]
                [--print]
                [--printdelay=0]
                [--noprintcfg]
                [--altprintmod]
                [--complexshapes]
                [--mixedcase]
                [--dontgrab]
                [--shortcuts]
                [--wheelmouse]
                [--buttondistinction]
                [--fancycursors]
                [--showcursor]
                [--outlines]
                [--stamps]
                [--stampcontrols]
                [--magiccontrols]
                [--label]
                [--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 entertaining, child-oriented additions such as sound effects.

OPTIONS - INFORMATIONAL

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

       --version
               Output the version info.

       --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 configuration 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 resolution.

       --WIDTHxHEIGHT
               Run  Tux  Paint  in  a  particularly-sized  window,  or at a particular 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 useful 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.

       --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 (--altprintmod), pressing [ALT] while clicking Print will bring up  a  dialog
               (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  children  who  are  not  yet  comfortable  with  the  lowercase
               characterset.  Default mode is mixed case.

       --grab --nograb
               Grab the mouse and keyboard input (if possible), so that the 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 --nowheelmouse
               option.  This is useful for children who aren't yet comfortable 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 comfortable 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.

       --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.)

       --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.)

       --nolabel --label
               Disable or enable (default) the Label tool, which lets you create text which can  be  altered  or
               moved later.

       --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.

       --mouse-accessibility
               In  this  mode, instead of clicking, dragging and releasing (e.g., to draw), you click, move, and
               click again to end the motion.

       --onscreen-keyboard
               Presents a clickable on-screen keyboard when using the Text and Label tools.

       --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 controlled  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 subdirectory, 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 (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 languages.  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][@modifier],  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.)

              For example, de_DE@euro for German, or pt_BR for Brazilian Portuguese.

       --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
              - acholi | acoli
              - afrikaans
              - akan | twi-fante
              - albanian
              - amharic
              - arabic
              - aragones
              - armenian | hayeren
              - assamese
              - asturian
              - azerbaijani
              - australian-english
              - bambara
              - basque | euskara
              - belarusian | bielaruskaja
              - bokmal
              - bosnian
              - brazilian-portuguese | portugues-brazilian | brazilian
              - breton | brezhoneg
              - british | british-english
              - bulgarian
              - canadian-english
              - catalan | catala
              - chinese | simplified-chinese
              - croatian | hrvatski
              - czech | cesky
              - danish | dansk
              - dutch | nederlands
              - esperanto
              - estonian
              - faroese
              - finnish | suomi
              - french | francais
              - fula | fulah | pulaar-fulfulde
              - gaelic | irish-gaelic | gaidhlig
              - galician | galego
              - georgian
              - german | deutsch
              - greek
              - gronings | zudelk-veenkelonioals
              - gujarati
              - hebrew
              - hindi
              - hungarian | magyar
              - icelandic | islenska
              - indonesian | bahasa-indonesia
              - inuktitut
              - italian | italiano
              - japanese
              - kannada
              - kiga | chiga
              - kinyarwanda
              - khmer
              - klingon | tlhIngan
              - konkani-devaganari
              - konkani-roman
              - korean
              - kurdish
              - latvian
              - lithuanian | lietuviu
              - luganda
              - luxembourgish | letzebuergesch
              - macedonian
              - maithili
              - malay
              - malayalam
              - manipuri-bengali
              - manipuri-meitei-mayek
              - marathi
              - mexican-spanish | espanol-mejicano | mexican
              - mongolian
              - ndebele
              - nepali
              - northern-sotho | sesotho-sa-leboa
              - norwegian | nynorsk | norsk
              - occitan
              - odia | oriya
              - ojibway | ojibwe
              - persian
              - polish | polski
              - portuguese | portugues
              - punjabi | panjabi
              - romanian
              - russian | russkiy
              - sanskrit
              - santali-devaganari
              - santali-ol-chiki
              - scottish | scottish-gaelic | ghaidhlig
              - serbian
              - serbian-latin
              - shuswap | secwepemctin
              - slovak
              - slovenian | slovensko
              - songhay
              - southafrican-english
              - spanish | espanol
              - sundanese
              - swahili
              - swedish | svenska
              - tagalog
              - tamil
              - telugu
              - thai
              - tibetan
              - traditional-chinese
              - turkish
              - twi
              - ukrainian
              - valencian
              - venda
              - venetian | veneto
              - vietnamese
              - walloon | walon
              - welsh | cymraeg
              - wolof
              - xhosa
              - zapotec | miahuatlan-zapotec
              - zulu

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

OPTIONS - MISCELLANEOUS

       --nosysconfig
               With this option, Tux  Paint  will  not  attempt  to  read  the  system-wide  configuration  file
               (typically /etc/tuxpaint/tuxpaint.conf).

       --nolockfile
               By  default,  Tux  Paint  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 Tux Paint ignore the current lockfile.

ENVIRONMENT

       While Tux Paint may refer to a number of environment variables indirectly (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 language 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  configuration
               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 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.tuxpaint.org/.

AUTHORS

       Bill Kendrick.  <bill@newbreedsoftware.com>

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

       Aki, Ashish Arora, Khalid Al Holan, Daniel Andersson, Hodorog Andrei, Joana Portia Antwi-Danso, Adorilson
       Bezerra de Araujo, Xandru Armesto, Ben Armstrong, Ravishankar Ayyakkannu, Dwayne Bailey, Martin Benjamin,
       Denis  Bodor, René Brandenburger, Herman Bruyninckx, Lucie Burianova, Laurentiu Buzdugan, Albert Cahalan,
       Pere Pujal Carabantes, Ouychai Chaita, Zden¿k Chalupský, Wei-Lun Chao,  Jacques  Chion,  Ankit  Choudary,
       Abdoul  Cisse,  Urska  Colner,  Adam  'akanewbie'  Corcoran, Helder Correia, Ricardo Cruz, Laurent Dhima,
       Chandrakant Dhutadmal, Yavor Doganov, Joe Dalton, Dawa Dolma, Kevin Donnelly,  Ander  Elortondo,  Alberto
       Escudero-Pascual,  Jamil  Farzana,  Doruk Fisek, Dovix, Korvigellou An Drouizig (Philippe), Fabian Franz,
       Derrick Frimpong, Martin Fuhrer, Fula Localization Project, Gabriel Gazzan, Alexander Geroimenko, Torsten
       Giebl, Solomon Gizaw, Robert Glowczynski, Chris Goerner, Mikel González, Volker Grabsch, The Greek  Linux
       i18n Team, Edmund GRIMLEY EVANS, Frederico Goncalves Guimaraes, Joe Hanson, Sam "Criswell" Hart, Guy Hed,
       Farinaz  Hedayat,  Tedi  Heriyanto,  Pjetur  G.  Hjaltason, Knut Erik Hollund, Khaled Hosny, Henry House,
       Mohomodou Houssouba, Song Huang, Karl  Ove  Hufthammer,  Roland  Illig,  Indigenas  Sin  Fronteras,  Juan
       Irigoien,  Students  of Vocational Higher Secondary School Irimpanam, Ivana Rakic, Dmitriy Ivanov, Mogens
       Jaeger, Lis Gøthe í Jákupsstovu, Nedjeljko Jedvaj, Aleksandar Jelenak,  Rasmus  Erik  Voel  Jensen,  Wang
       Jian,  Amed  Ç. Jiyan, Petri Jooste, Richard June, Andrej Kacian, Thomas Kalka, Jorma Karvonen, Kazuhiko,
       Gabor Kelemen,  Mark  Kim,  Thomas  Klausner,  Koby,  Marcin  'Shard'  Konicki,  Ines  Kovacevic,  Mantas
       Kriauciunas,  Freek  de  Kruijf,  Andrzej  M.  Krzysztofowicz, Piotr Kwilinski, Serafeim Kyriaki, Matthew
       Lange, Fabio Lazarin, 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, Sergio Marques, Pheledi Mathibela, Scott McCreary, Marco Milanesi, Kartik Mistry, Mugunth,  Steve
       Murphy,  Samuel  Murray  (Groenkloof),  Shumani Mercy Nehulaudzi, Mikkel Kirkgaard Nielsen, Alesis Novik,
       Daniel Nylander, Olli, James Olweny, Teresa Orive, Gareth Owen, Sorin Paliga, Yannis Papatzikos,  Nikolay
       Parukhin,  Alessandro  Pasotti,  Flavio  Pastor, Patrick, George Patrick, Primoz Peterlin, Le Quang Phan,
       Henrik Pihl, Auk Piseth, Pablo Pita, Milan Plzik, Sergei Popov, John Popplewell,  Rodrigo  Perez  Ramirez
       and  Indigenas  Sin Fronteras, Adam 'foo-script' Rakowski, Rodrigo Perez Ramirez, Robert Readman, Leandro
       Regueiro, Simona Riva, Robin  Rosenberg,  Ilir  Rugova,  Jaroslav  Rynik,  Bert  Saal,  Ibraahiima  SAAR,
       Saikumar,  Samuel  Sarpong,  Kevin  Patrick  Scannell,  Stephanie  Schilling, Kiriaki SERAFEIM, Pavithran
       Shakamuri, Gia Shervashidze, Clytie Siddall, Kliment  Simoncev,  Sokratis  Sofianopoulos,  Khoem  Sokhem,
       Geert Stams, Peter Sterba, Raivis Strogonovs, Tomasz 'karave' Tarach, Michal Terbert, Ignacia Tike, Tilo,
       Tarmo  Toikkanen,  TOYAMA  Shin-ichi,  Niall  Tracey,  tropikhajma,  Florence  Tushabe, 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.22                                            5 August 2014                                      TUXPAINT(1)