diff --git a/docs/CHANGES.txt b/docs/CHANGES.txt index 5b8c69278..df45f164a 100644 --- a/docs/CHANGES.txt +++ b/docs/CHANGES.txt @@ -16,6 +16,10 @@ $Id$ tab-completion list, and "OPTIONS" documentation all cover the full set of Tux Paint options. + * Reorganized the "Available Options" section of "OPTIONS" + documentation (to match the organization found in the UI + of "Tux Paint Config.") + 2021.June.28 (0.9.26) * New Features ------------ diff --git a/docs/en/OPTIONS.txt b/docs/en/OPTIONS.txt index d4288ec7e..9dd1134e7 100644 --- a/docs/en/OPTIONS.txt +++ b/docs/en/OPTIONS.txt @@ -79,1128 +79,1261 @@ Windows Users (Command-line settings will override these. See the "Command-Line Options" section, below.) - fullscreen=yes + ---------------------------------------------------------------------- - Run the program in full screen mode, rather than in a window. +Video/Sound - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "fullscreen=no". In both cases, may be overridden by the - command-line option "--windowed". + Video - fullscreen=native + fullscreen=yes - Run the program in full screen mode. Additionally, assume the - screen's current resolution (set by the operating system). + Run the program in full screen mode, rather than in a + window. - windowsize=SIZE + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "fullscreen=no". In both cases, may be overridden by the + command-line option "--windowed". - Run the program at a different size (in windowed mode) or at a - different screen resolution (in fullscreen mode), rather than - the default (usually 800x600). + fullscreen=native - The SIZE value should be presented in pixels, in - 'width-by-height' format, with an "x" (lowercase X) between the - values. The size can be anything that's at least 640 wide, and - at least 480 tall. + Run the program in full screen mode. Additionally, assume + the screen's current resolution (set by the operating + system). - Some examples: + windowsize=SIZE - * 640x480 - * 1024x768 - * 768x1024 - * 1600x1200 + Run the program at a different size (in windowed mode) or at + a different screen resolution (in fullscreen mode), rather + than the default (usually 800x600). - orient=portrait + The SIZE value should be presented in pixels, in + 'width-by-height' format, with an "x" (lowercase X) between + the values. The size can be anything that's at least 640 + wide, and at least 480 tall. - Swaps the width/height options given to Tux Paint, useful for - rotating the window on portait displays, such as a tablet PC - that's in tablet orientation. + Some examples: - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "orient=landscape". In both cases, may be overridden by the - command-line option "--orient=landscape". + * 640x480 + * 1024x768 + * 768x1024 + * 1600x1200 - native=yes + orient=portrait - When running Tux Paint in fullscreen mode, this assumes the - screen's current resolution (overriding any "windowsize" - option), as set by the operating system. + Swaps the width/height options given to Tux Paint, useful + for rotating the window on portait displays, such as a + tablet PC that's in tablet orientation. - buttonsize=SIZE + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "orient=landscape". In both cases, may be overridden by the + command-line option "--orient=landscape". - Set the pixel size of buttons in Tux Paint's user interface - (overriding the default of "48"). Useful when using very - high-density displays or coarse input devices, such as eye gaze - trackers. + native=yes - The SIZE value should be presented in pixels, and can be - anything between 24 and 192, inclusive. Most buttons are square, - and this will affect their width and height. + When running Tux Paint in fullscreen mode, this assumes the + screen's current resolution (overriding any "windowsize" + option), as set by the operating system. - Note: If the chosen button size would cause the buttons to be - too large for all required UI elements to appear under Tux - Paint's chosen window size, the largest possible button size - will be used. (A note will appear in stderr.) + allowscreensaver=yes - allowscreensaver=yes + By default, Tux Paint prevents your system's screensaver + from starting up. You can override this by using the + "allowscreensaver" option. Note: This requires version + 1.2.12 or higher of the SDL library. (You can also do this + by setting the "SDL_VIDEO_ALLOW_SCREENSAVER" environment + variable on your system to "1".) - By default, Tux Paint prevents your system's screensaver from - starting up. You can override this by using the - "allowscreensaver" option. Note: This requires version 1.2.12 or - higher of the SDL library. (You can also do this by setting the - "SDL_VIDEO_ALLOW_SCREENSAVER" environment variable on your - system to "1".) + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "allowscreensaver=no" or "disablescreensaver=yes". In both + cases, may be overridden by the command-line option + "--disablescreensaver". - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "allowscreensaver=no" or "disablescreensaver=yes". In both - cases, may be overridden by the command-line option - "--disablescreensaver". + Sound - nosound=yes + nosound=yes - Disable sound effects. (Note: Pressing [Alt] + [S] cannot be - used to reenable sounds if they were disabled using this - option.) + Disable sound effects. (Note: Pressing [Alt] + [S] cannot be + used to reenable sounds if they were disabled using this + option.) - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosound=no" - or "sound=yes". In both cases, may be overridden by the - command-line option "--sound". + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nosound=no" or "sound=yes". In both cases, may be + overridden by the command-line option "--sound". - nostereo=yes + nostereo=yes - Disable stereo panning support. (Useful for users with hearing - impairment in one ear, or places where a single speaker or - headphone is being used.) + Disable stereo panning support. (Useful for users with + hearing impairment in one ear, or places where a single + speaker or headphone is being used.) - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostereo=no" - or "stereo=yes". In both cases, may be overridden by the - command-line option "--stereo". + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nostereo=no" or "stereo=yes". In both cases, may be + overridden by the command-line option "--stereo". - noquit=yes + Interface Size - Disable the on-screen "Quit" button and prevent the [Escape] key - from quitting Tux Paint. + buttonsize=SIZE - Using the [Alt] + [F4] keyboard combination or clicking the - window's close button (assuming you're not in fullscreen mode) - still works to quit Tux Paint. + Set the pixel size of buttons in Tux Paint's user interface + (overriding the default of "48"). Useful when using very + high-density displays or coarse input devices, such as eye + gaze trackers. - You can also use the following keyboard combination to quit: - [Shift] + [Control] + [Escape]. + The SIZE value should be presented in pixels, and can be + anything between 24 and 192, inclusive. Most buttons are + square, and this will affect their width and height. - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noquit=no" or - "quit=yes". In both cases, may be overridden by the command-line - option "--quit". + Note: If the chosen button size would cause the buttons to + be too large for all required UI elements to appear under + Tux Paint's chosen window size, the largest possible button + size will be used. (A note will appear in stderr.) - noprint=yes + colorsrows=ROWS - Disable the printing feature. + How many rows of color palette buttons to show; useful when + using a large color palette (see "colorfile", above), and/or + for use with coarse input devices (like eyegaze trackers). + "ROWS" may be between "1" (the default) and "3". - printdelay=SECONDS + ---------------------------------------------------------------------- - Restrict printing so that printing can occur only once every - SECONDS seconds. +Mouse/Keyboard - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "printdelay=0". In both cases, may be overridden by the - command-line option "--printdelay=0". + Cursor - printcommand=COMMAND + nofancycursors=yes - (Linux and Unix only) + This disables the fancy mouse pointer shapes in Tux Paint, + and uses your environment's normal mouse pointer. - Use the command COMMAND to print a PostScript format file when - the 'Print' button is clicked. If this option is not - specifically not set, the default command is: + In some enviornments, the fancy cursors cause problems. Use + this option to avoid them. - lpr + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nofancycursors=no" or "fancycursors=yes". In both cases, + may be overridden by the command-line option + "--fancycursors". - Note: Versions of Tux Paint prior to 0.9.15 sent PNG format data - to the print command (which defaulted to "pngtopnm | pnmtops | - lpr"). + hidecursor=yes - If you set an alternative printcommand in the configuration file - prior to version 0.9.15, you will need to change it. + This completely hides the mouse pointer shapes in Tux Paint. - altprintcommand=COMMAND + This is useful for touchscreen devices, such as tablet PCs. - (Linux and Unix only) + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "hidecursor=no" or "showcursor=yes". In both cases, may be + overridden by the command-line option "--showcursor". - Use the command COMMAND to print a PostScript format file when - the 'Print' button is clicked while the [Alt] modifier key is - being held. (This is typically used for providing a print - dialog, similar to when pressing [Alt]+'Print' in Windows and - macOS.) + Keyboard - If this option is not specifically not set, the default command - is KDE's graphical print dialog: + noshortcuts=yes - kprinter + This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, + [Ctrl]-[N] for a new image, etc.) - printcfg=yes + This is useful to prevent unwanted commands from being + activated by children who aren't experienced with keyboards. - (Windows and macOS only) + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "noshortcuts=no" or "shortcuts=yes". In both cases, may be + overridden by the command-line option "--shortcuts". - Tux Paint will use a printer configuration file when printing. - Push the [Alt] key while clicking the 'Print' button in Tux - Paint to cause a Windows print dialog window to appear. + Mouse - (Note: This only works when not running Tux Paint in fullscreen - mode.) Any configuration changes made in this dialog will be - saved to the file "userdata/print.cfg" , and used again, as long - as the "printcfg" option is set. + grab=yes - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printcfg=no" - or "noprintcfg=yes". In both cases, may be overridden by the - command-line option "--noprintcfg". + Tux Paint will attempt to 'grab' the mouse and keyboard, so + that the mouse is confined to Tux Paint's window, and nearly + all keyboard input is passed directly to it. - altprint=always + This is useful to disable operating system actions that + could get the user out of Tux Paint [Alt]-[Tab] window + cycling, [Ctrl]-[Escape], etc. This is especially useful in + fullscreen mode. - This causes Tux Paint to always show the printer dialog (or, on - Linux/Unix, run the "altprintcommand") when the 'Print' button - is clicked. In other words, it's like clicking 'Print' while - holding [Alt], except you don't need to hold [Alt] every time. + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using "grab=no" + or "dontgrab=yes". In both cases, may be overridden by the + command-line option "--dontgrab". - altprint=never + nowheelmouse=yes - This prevents Tux Paint from ever showing the printer dialog - (or, on Linux/Unix, run the "altprintcommand") when the 'Print' - button is clicked. In other words, it makes the [Alt] key have - no effect when clicking the 'Print' button. + This disables support for the wheel on mice that have it. + (Normally, the wheel will scroll the selector menu on the + right.) - altprint=mod + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nowheelmouse=no" or "wheelmouse=yes". In both cases, may be + overridden by the command-line option "--wheelmouse". - This is the normal, default behavior. Tux Paint shows a printer - dialog (or, on Linux/Unix, runs the "altprintcommand"), when the - [Alt] key is pressed while the 'Print' button is clicked. - Clicking 'Print' without holding [Alt] prints without showing a - dialog. + nobuttondistinction=yes - papersize=PAPERSIZE + Prior to Tux Paint 0.9.15, the middle and right buttons on a + mouse could also be used for clicking. In version 0.9.15, it + was changed so that only the left mouse button worked, so as + to not train children to use the wrong button. - (Platforms that use Tux Paint's internal PostScript generator — - not Windows, macOS, BeOS, or Haiku.) + However, for children who have trouble with the mouse, this + distinction between the two or three buttons on a mouse can + be disabled (returning Tux Paint to its old behavior) by + using this option. - Tell Tux Paint what size PostScript to generate. If none is - specified, Tux Paint first checks your $PAPER environment - variable, then the file /etc/papersize, then uses the the - 'libpaper' library's default paper size. + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nobuttondistinction=no" or "buttondistinction=yes". In both + cases, may be overridden by the command-line option + "--buttondistinction". - Valid paper sizes include: letter, legal, tabloid, executive, - note, statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, - b0, b1, b2 b3, b4, 10x14, 11x17, halfletter, halfexecutive, - halfnote, folio, quarto, ledger, archA, archB, archC, archD, - archE, flsa, flse, csheet, dsheet, esheet. + ---------------------------------------------------------------------- - nolockfile=yes +Simplification - By default, Tux Paint uses what's known as a 'lockfile' to - prevent it from being launched more than once in 30 seconds. - (This is to avoid accidentally running multiple copies; for - example, by double-clicking a single-click launcher, or simply - impatiently clicking the icon multiple times.) + Interface Simplification - To make Tux Paint ignore the lockfile, allowing it to run again, - even if it was just launched less than 30 seconds ago, enable - this setting in the configuration file, or run Tux Paint with - the --nolockfile option on the command-line. + simpleshapes=yes - By default, the lockfile is stored in "~/.tuxpaint/" under Linux - and Unix, and "userdata\" under Windows. + Disable the rotation step of the 'Shape' tool. Click, drag + and release is all that will be needed to draw a shape. - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nolockfile=no" or "lockfile=yes". In both cases, may be - overridden by the command-line option "--lockfile". + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "simpleshapes=no" or "complexshapes=yes". In both cases, may + be overridden by the command-line option "--complexshapes". - simpleshapes=yes + nooutlines=yes - Disable the rotation step of the 'Shape' tool. Click, drag and - release is all that will be needed to draw a shape. + In this mode, much simpler outlines and 'rubber-band' lines + are displayed when using the Lines, Shapes, Stamps and + Eraser tools. - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "simpleshapes=no" or "complexshapes=yes". In both cases, may be - overridden by the command-line option "--complexshapes". + This can help when Tux Paint is run on very slow computers, + or displayed on a remote X-Window display. - uppercase=yes + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nooutlines=no" or "outlines=yes". In both cases, may be + overridden by the command-line option "--outlines". - All text will be rendered only in uppercase (e.g., "Brush" will - be "BRUSH"). Useful for children who can read, but who have only - learned uppercase letters so far. + uppercase=yes - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "uppercase=no" - or "mixedcase=yes". In both cases, may be overridden by the - command-line option "--mixedcase". + All text will be rendered only in uppercase (e.g., "Brush" + will be "BRUSH"). Useful for children who can read, but who + have only learned uppercase letters so far. - grab=yes + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "uppercase=no" or "mixedcase=yes". In both cases, may be + overridden by the command-line option "--mixedcase". - Tux Paint will attempt to 'grab' the mouse and keyboard, so that - the mouse is confined to Tux Paint's window, and nearly all - keyboard input is passed directly to it. + Initial Stamp Size - This is useful to disable operating system actions that could - get the user out of Tux Paint [Alt]-[Tab] window cycling, - [Ctrl]-[Escape], etc. This is especially useful in fullscreen - mode. + stampsize=SIZE - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "grab=no" or - "dontgrab=yes". In both cases, may be overridden by the - command-line option "--dontgrab". + Use this option to force Tux Paint to set the starting size + of all stamps. The SIZE value should be between 0 (smallest) + and 10 (largest). The size is relative to the available + sizes of the stamp, which depends on the stamp itself, and + Tux Paint's current canvas size. - noshortcuts=yes + Specify "default" to let Tux Paint decide (its standard + behavior). - This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, - [Ctrl]-[N] for a new image, etc.) + Control Simplification - This is useful to prevent unwanted commands from being activated - by children who aren't experienced with keyboards. + noquit=yes - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "noshortcuts=no" or "shortcuts=yes". In both cases, may be - overridden by the command-line option "--shortcuts". + Disable the on-screen "Quit" button and prevent the [Escape] + key from quitting Tux Paint. - nowheelmouse=yes + Using the [Alt] + [F4] keyboard combination or clicking the + window's close button (assuming you're not in fullscreen + mode) still works to quit Tux Paint. - This disables support for the wheel on mice that have it. - (Normally, the wheel will scroll the selector menu on the - right.) + You can also use the following keyboard combination to quit: + [Shift] + [Control] + [Escape]. - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nowheelmouse=no" or "wheelmouse=yes". In both cases, may be - overridden by the command-line option "--wheelmouse". + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "noquit=no" or "quit=yes". In both cases, may be overridden + by the command-line option "--quit". - nobuttondistinction=yes + nostamps=yes - Prior to Tux Paint 0.9.15, the middle and right buttons on a - mouse could also be used for clicking. In version 0.9.15, it was - changed so that only the left mouse button worked, so as to not - train children to use the wrong button. + This option tells Tux Paint to not load any rubber stamp + images, which in turn ends up disabling the Stamps tool. + + This can speed up Tux Paint when it first loads up, and + reduce memory usage while it's running. Of course, no stamps + will be available at all. + + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nostamps=no" or "stamps=yes". In both cases, may be + overridden by the command-line option "--stamps". + + nostampcontrols=yes + + Some images in the Stamps tool can be mirrored, flipped, + and/or have their size changed. This option disables the + controls, and only provides the basic stamps. + + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nostampcontrols=no" or "stampcontrols=yes". In both cases, + may be overridden by the command-line option + "--stampcontrols". + + nomagiccontrols=yes + + Some Magic tools have the option of acting like a + paintbrush, or affecting the entire canvas at once. This + option disables the controls, and only provides the default + functionality (usually paint-mode). + + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nomagiccontrols=no" or "magiccontrols=yes". In both cases, + may be overridden by the command-line option + "--magiccontrols". + + noshapecontrols=yes + + Disable the control buttons shown when using the Shapes tool + that allow changing how shapes are drawn — centered around + the initial mouse click, or with a corner at the initial + mouse click. + + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "noshapecontrols=no" or "shapecontrols=yes". In both cases, + may be overridden by the command-line option + "--shapecontrols". + + nolabel=yes + + Disables the Label tool: the tool that allows text entry + which can be edited later. + + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nolabel=no" or "label=yes". In both cases, may be + overridden by the command-line option "--label". + + ---------------------------------------------------------------------- + +Languages + + Language + + lang=LANGUAGE + + Run Tux Paint in one of the supported languages. Possible + choice for LANGUAGE currently include: + + +-----------------------------------------------------------+ + |english |american-english | | + |---------------------+---------------------+---------------| + |acholi |acoli | | + |---------------------+---------------------+---------------| + |afrikaans | | | + |---------------------+---------------------+---------------| + |akan |twi-fante | | + |---------------------+---------------------+---------------| + |albanian | | | + |---------------------+---------------------+---------------| + |amharic | | | + |---------------------+---------------------+---------------| + |arabic | | | + |---------------------+---------------------+---------------| + |aragones | | | + |---------------------+---------------------+---------------| + |armenian |hayeren | | + |---------------------+---------------------+---------------| + |assamese | | | + |---------------------+---------------------+---------------| + |asturian | | | + |---------------------+---------------------+---------------| + |australian-english | | | + |---------------------+---------------------+---------------| + |azerbaijani | | | + |---------------------+---------------------+---------------| + |bambara | | | + |---------------------+---------------------+---------------| + |basque |euskara | | + |---------------------+---------------------+---------------| + |belarusian |bielaruskaja | | + |---------------------+---------------------+---------------| + |bengali | | | + |---------------------+---------------------+---------------| + |bodo | | | + |---------------------+---------------------+---------------| + |bokmal | | | + |---------------------+---------------------+---------------| + |bosnian | | | + |---------------------+---------------------+---------------| + |brazilian-portuguese |portugues-brazilian |brazilian | + |---------------------+---------------------+---------------| + |breton |brezhoneg | | + |---------------------+---------------------+---------------| + |british-english |british | | + |---------------------+---------------------+---------------| + |bulgarian | | | + |---------------------+---------------------+---------------| + |canadian-english | | | + |---------------------+---------------------+---------------| + |catalan |catala | | + |---------------------+---------------------+---------------| + |chinese |simplified-chinese | | + |---------------------+---------------------+---------------| + |croatian |hrvatski | | + |---------------------+---------------------+---------------| + |czech |cesky | | + |---------------------+---------------------+---------------| + |danish |dansk | | + |---------------------+---------------------+---------------| + | |dogri | | + |---------------------+---------------------+---------------| + |dutch |nederlands | | + |---------------------+---------------------+---------------| + |esperanto | | | + |---------------------+---------------------+---------------| + |estonian | | | + |---------------------+---------------------+---------------| + |faroese | | | + |---------------------+---------------------+---------------| + |finnish |suomi | | + |---------------------+---------------------+---------------| + |french |francais | | + |---------------------+---------------------+---------------| + |fula |fulah |pulaar-fulfulde| + |---------------------+---------------------+---------------| + |gaelic |gaidhlig |irish-gaelic | + |---------------------+---------------------+---------------| + |galician |galego | | + |---------------------+---------------------+---------------| + |georgian | | | + |---------------------+---------------------+---------------| + |german |deutsch | | + |---------------------+---------------------+---------------| + |greek | | | + |---------------------+---------------------+---------------| + |gronings |zudelk-veenkelonioals| | + |---------------------+---------------------+---------------| + |gujarati | | | + |---------------------+---------------------+---------------| + |hebrew | | | + |---------------------+---------------------+---------------| + |hindi | | | + |---------------------+---------------------+---------------| + |hungarian |magyar | | + |---------------------+---------------------+---------------| + |icelandic |islenska | | + |---------------------+---------------------+---------------| + |indonesian |bahasa-indonesia | | + |---------------------+---------------------+---------------| + |inuktitut | | | + |---------------------+---------------------+---------------| + |italian |italiano | | + |---------------------+---------------------+---------------| + |japanese | | | + |---------------------+---------------------+---------------| + |kabyle | |kabylian | + |---------------------+---------------------+---------------| + |kannada | | | + |---------------------+---------------------+---------------| + |kashmiri-devanagari | | | + |---------------------+---------------------+---------------| + |kashmiri-perso-arabic| | | + |---------------------+---------------------+---------------| + |khmer | | | + |---------------------+---------------------+---------------| + |kiga |chiga | | + |---------------------+---------------------+---------------| + |kinyarwanda | | | + |---------------------+---------------------+---------------| + |klingon |tlhIngan | | + |---------------------+---------------------+---------------| + |konkani-devanagari | | | + |---------------------+---------------------+---------------| + |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 | | + |---------------------+---------------------+---------------| + |ojibwe |ojibway | | + |---------------------+---------------------+---------------| + |persian | | | + |---------------------+---------------------+---------------| + |polish |polski | | + |---------------------+---------------------+---------------| + |portuguese |portugues | | + |---------------------+---------------------+---------------| + |punjabi |panjabi | | + |---------------------+---------------------+---------------| + |romanian | | | + |---------------------+---------------------+---------------| + |russian |russkiy | | + |---------------------+---------------------+---------------| + |sanskrit | | | + |---------------------+---------------------+---------------| + |santali-devanagari | | | + |---------------------+---------------------+---------------| + |santali-ol-chiki | | | + |---------------------+---------------------+---------------| + |scottish |ghaidhlig |scottish-gaelic| + |---------------------+---------------------+---------------| + |serbian | | | + |---------------------+---------------------+---------------| + |serbian-latin | | | + |---------------------+---------------------+---------------| + |shuswap |secwepemctin | | + |---------------------+---------------------+---------------| + |sindhi-devanagari | | | + |---------------------+---------------------+---------------| + |sindhi-perso-arabic | | | + |---------------------+---------------------+---------------| + |slovak | | | + |---------------------+---------------------+---------------| + |slovenian |slovensko | | + |---------------------+---------------------+---------------| + |songhay | | | + |---------------------+---------------------+---------------| + |southafrican-english | | | + |---------------------+---------------------+---------------| + |spanish |espanol | | + |---------------------+---------------------+---------------| + |sundanese | | | + |---------------------+---------------------+---------------| + |swahili | | | + |---------------------+---------------------+---------------| + |swedish |svenska | | + |---------------------+---------------------+---------------| + |tagalog | | | + |---------------------+---------------------+---------------| + |tamil | | | + |---------------------+---------------------+---------------| + |telugu | | | + |---------------------+---------------------+---------------| + |thai | | | + |---------------------+---------------------+---------------| + |tibetan | | | + |---------------------+---------------------+---------------| + |traditional-chinese | | | + |---------------------+---------------------+---------------| + |turkish | | | + |---------------------+---------------------+---------------| + |twi | | | + |---------------------+---------------------+---------------| + |ukrainian | | | + |---------------------+---------------------+---------------| + |urdu | | | + |---------------------+---------------------+---------------| + |venda | | | + |---------------------+---------------------+---------------| + |venetian |veneto | | + |---------------------+---------------------+---------------| + |vietnamese | | | + |---------------------+---------------------+---------------| + |walloon |walon | | + |---------------------+---------------------+---------------| + |welsh |cymraeg | | + |---------------------+---------------------+---------------| + |wolof | | | + |---------------------+---------------------+---------------| + |xhosa | | | + |---------------------+---------------------+---------------| + |miahuatlan-zapotec | |zapotec | + |---------------------+---------------------+---------------| + |zulu | |zulu | + +-----------------------------------------------------------+ + + --locale LOCALE + + Run Tux Paint in one of the support languages. See the + "Choosing a Different Language" section below for the locale + strings (e.g., "de_DE" for German) to use. + + (If your locale is already set, e.g. with the "$LANG" + environment variable, this option is not necessary, since + Tux Paint honors your environment's setting, if possible.) + + mirrorstamps=yes + + For stamps that can be mirrored, this option sets them to + their mirrored shape by default. + + This can be useful for people who prefer things + right-to-left, rather than left-to-right. + + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "mirrorstamps=no" or "dontmirrorstamps=yes". In both cases, + may be overridden by the command-line option + "--dontmirrorstamps". + + Fonts + + sysfonts=yes + + This option causes Tux Paint to attempt to load fonts (for + use in the Text tool) from your operating system. Normally, + Tux Paint will only load the ones that came bundled with Tux + Paint. + + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "sysfonts=no" or "nosysfonts=yes". In both cases, may be + overridden by the command-line option "--nosysfonts". + + alllocalefonts=yes + + Prior to version 0.9.21, Tux Paint loaded all fonts in its + own fonts directory, including locale-specific ones (e.g., + the one for Tibetan, which had no latin characters). As of + 0.9.21, the only font loaded from the locale-specific + subdirectory, if any, is one matching the locale Tux Paint + is running on. + + To load all locale-specific fonts (the old behavior), set + this option. + + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "alllocalefonts=no" or "currentlocalefont=yes". In both + cases, may be overridden by the command-line option + "--currentlocalefont". + + ---------------------------------------------------------------------- - However, for children who have trouble with the mouse, this - distinction between the two or three buttons on a mouse can be - disabled (returning Tux Paint to its old behavior) by using this - option. +Printing - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobuttondistinction=no" or "buttondistinction=yes". In both - cases, may be overridden by the command-line option - "--buttondistinction". + Print Permissions - nofancycursors=yes + noprint=yes - This disables the fancy mouse pointer shapes in Tux Paint, and - uses your environment's normal mouse pointer. + Disable the printing feature. - In some enviornments, the fancy cursors cause problems. Use this - option to avoid them. + printdelay=SECONDS - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nofancycursors=no" or "fancycursors=yes". In both cases, may be - overridden by the command-line option "--fancycursors". + Restrict printing so that printing can occur only once every + SECONDS seconds. - hidecursor=yes + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "printdelay=0". In both cases, may be overridden by the + command-line option "--printdelay=0". - This completely hides the mouse pointer shapes in Tux Paint. + Show Printer Dialog - This is useful for touchscreen devices, such as tablet PCs. + altprint=always - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "hidecursor=no" or "showcursor=yes". In both cases, may be - overridden by the command-line option "--showcursor". + This causes Tux Paint to always show the printer dialog (or, + on Linux/Unix, run the "altprintcommand") when the 'Print' + button is clicked. In other words, it's like clicking + 'Print' while holding [Alt], except you don't need to hold + [Alt] every time. - nooutlines=yes + altprint=never - In this mode, much simpler outlines and 'rubber-band' lines are - displayed when using the Lines, Shapes, Stamps and Eraser tools. + This prevents Tux Paint from ever showing the printer dialog + (or, on Linux/Unix, run the "altprintcommand") when the + 'Print' button is clicked. In other words, it makes the + [Alt] key have no effect when clicking the 'Print' button. - This can help when Tux Paint is run on very slow computers, or - displayed on a remote X-Window display. + altprint=mod - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nooutlines=no" or "outlines=yes". In both cases, may be - overridden by the command-line option "--outlines". + This is the normal, default behavior. Tux Paint shows a + printer dialog (or, on Linux/Unix, runs the + "altprintcommand"), when the [Alt] key is pressed while the + 'Print' button is clicked. Clicking 'Print' without holding + [Alt] prints without showing a dialog. - sysfonts=yes + Save Printer Configuration - This option causes Tux Paint to attempt to load fonts (for use - in the Text tool) from your operating system. Normally, Tux - Paint will only load the ones that came bundled with Tux Paint. + printcfg=yes - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "sysfonts=no" - or "nosysfonts=yes". In both cases, may be overridden by the - command-line option "--nosysfonts". + (Windows and macOS only) - alllocalefonts=yes + Tux Paint will use a printer configuration file when + printing. Push the [Alt] key while clicking the 'Print' + button in Tux Paint to cause a Windows print dialog window + to appear. - Prior to version 0.9.21, Tux Paint loaded all fonts in its own - fonts directory, including locale-specific ones (e.g., the one - for Tibetan, which had no latin characters). As of 0.9.21, the - only font loaded from the locale-specific subdirectory, if any, - is one matching the locale Tux Paint is running on. + (Note: This only works when not running Tux Paint in + fullscreen mode.) Any configuration changes made in this + dialog will be saved to the file "userdata/print.cfg" , and + used again, as long as the "printcfg" option is set. - To load all locale-specific fonts (the old behavior), set this - option. + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "printcfg=no" or "noprintcfg=yes". In both cases, may be + overridden by the command-line option "--noprintcfg". - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "alllocalefonts=no" or "currentlocalefont=yes". In both cases, - may be overridden by the command-line option - "--currentlocalefont". + Print Commands - nostamps=yes + printcommand=COMMAND - This option tells Tux Paint to not load any rubber stamp images, - which in turn ends up disabling the Stamps tool. + (Linux and Unix only) - This can speed up Tux Paint when it first loads up, and reduce - memory usage while it's running. Of course, no stamps will be - available at all. + Use the command COMMAND to print a PostScript format file + when the 'Print' button is clicked. If this option is not + specifically not set, the default command is: - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostamps=no" - or "stamps=yes". In both cases, may be overridden by the - command-line option "--stamps". + lpr - nostampcontrols=yes + Note: Versions of Tux Paint prior to 0.9.15 sent PNG format + data to the print command (which defaulted to "pngtopnm | + pnmtops | lpr"). - Some images in the Stamps tool can be mirrored, flipped, and/or - have their size changed. This option disables the controls, and - only provides the basic stamps. + If you set an alternative printcommand in the configuration + file prior to version 0.9.15, you will need to change it. - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostampcontrols=no" or "stampcontrols=yes". In both cases, may - be overridden by the command-line option "--stampcontrols". + altprintcommand=COMMAND - nomagiccontrols=yes + (Linux and Unix only) - Some Magic tools have the option of acting like a paintbrush, or - affecting the entire canvas at once. This option disables the - controls, and only provides the default functionality (usually - paint-mode). + Use the command COMMAND to print a PostScript format file + when the 'Print' button is clicked while the [Alt] modifier + key is being held. (This is typically used for providing a + print dialog, similar to when pressing [Alt]+'Print' in + Windows and macOS.) - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagiccontrols=no" or "magiccontrols=yes". In both cases, may - be overridden by the command-line option "--magiccontrols". + If this option is not specifically not set, the default + command is KDE's graphical print dialog: - noshapecontrols=yes + kprinter - Disable the control buttons shown when using the Shapes tool - that allow changing how shapes are drawn — centered around the - initial mouse click, or with a corner at the initial mouse - click. + Paper Size - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "noshapecontrols=no" or "shapecontrols=yes". In both cases, may - be overridden by the command-line option "--shapecontrols". + papersize=PAPERSIZE - nolabel=yes + (Platforms that use Tux Paint's internal PostScript + generator — not Windows, macOS, BeOS, or Haiku.) - Disables the Label tool: the tool that allows text entry which - can be edited later. + Tell Tux Paint what size PostScript to generate. If none is + specified, Tux Paint first checks your $PAPER environment + variable, then the file /etc/papersize, then uses the the + 'libpaper' library's default paper size. - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nolabel=no" - or "label=yes". In both cases, may be overridden by the - command-line option "--label". + Valid paper sizes include: letter, legal, tabloid, + executive, note, statement, a0, a1, a2, a3, a4, a5, a6, a7, + a8, a9, a10, b0, b1, b2 b3, b4, 10x14, 11x17, halfletter, + halfexecutive, halfnote, folio, quarto, ledger, archA, + archB, archC, archD, archE, flsa, flse, csheet, dsheet, + esheet. - newcolorslast=yes + ---------------------------------------------------------------------- - Places the blank color options in the New dialog at the end, so - that any Starters and/or Templates are shown first. +Saving - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "newcolorslast=no" or "newcolorsfirst=yes". In both cases, may - be overridden by the command-line option "--newcolorsfirst". + Save Over Earlier Work - mirrorstamps=yes + saveover=yes - For stamps that can be mirrored, this option sets them to their - mirrored shape by default. + This disables the "Save over the old version...?" prompt + when saving an existing file. With this option, the older + version will always be replaced by the new version, + automatically. - This can be useful for people who prefer things right-to-left, - rather than left-to-right. + saveover=new - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "mirrorstamps=no" or "dontmirrorstamps=yes". In both cases, may - be overridden by the command-line option "--dontmirrorstamps". + This also disables the "Save over the old version...?" + prompt when saving an existing file. This option, however, + will always save a new file, rather than overwrite the older + version. - mouse-accessibility=yes + saveover=ask - In this mode, instead of clicking, dragging and releasing (e.g., - to draw), you click, move, and click again to end the motion. + (This option is redundant, since this is the default.) When + saving an existing drawing, you will be first asked whether + to save over the older version or not. - onscreen-keyboard=yes + Starting Out - Presents a clickable on-screen keyboard when using the Text and - Label tools. + startblank=yes - onscreen-keyboard-layout=LAYOUTNAME + This causes Tux Paint to display a blank canvas when it + first starts up, rather than loading the last image that was + being edited. - Selects the initial layout for the on-screen keyboard when using - the Text and Label tools. - Note: Using this option implies automatically - onscreen-keyboard=yes, so setting both is redundant. + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "startblank=no" or "startlast=yes". In both cases, may be + overridden by the command-line option "--startlast". - onscreen-keyboard-disable-change=yes + newcolorslast=yes - Disables the possibility for changing the layout of the - on-screen keyboard when using the Text and Label tools, useful - for simplifying things for the small children. - Note: Using this option implies automatically - onscreen-keyboard=yes, so setting both is redundant. + Places the blank color options in the New dialog at the end, + so that any Starters and/or Templates are shown first. - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "onscreen-keyboard-disable-change=no". In both cases, may be - overridden by the command-line option - "--onscreen-keyboard-disable-change=no". + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "newcolorslast=no" or "newcolorsfirst=yes". In both cases, + may be overridden by the command-line option + "--newcolorsfirst". - joystick-dev=N + Save and Export Directories - Specify which joystick device should be used by Tux Paint. - Default value is 0 (the first joystick). + savedir=DIRECTORY - joystick-slowness=SPEED + Use this option to change where Tux Paint's "saved" + directory/folder is located, which is where Tux Paint saves + and opens pictures. - Sets a delay at each axis motion, allowing to slow the joystick. - Allowed values are from 0 to 500. Default value is 15. + If you do not override it, the default location is: - joystick-threshold=THRESHOLD + * Linux & Unix — Under a hidden directory named + ".tuxpaint" in your home directory (aka "~" or "$HOME") + Example: /home/username/.tuxpaint/saved/ + * Windows — Inside a folder named "TuxPaint" in your + "Application Data" folder. + Example: C:\Documents and Settings\Username\Application + Data\TuxPaint\saved\ + * macOS — Inside a folder named "TuxPaint" in your + "Application Support" folder. + Example: /Users/Username/Library/Application + Support/TuxPaint/saved/ - Sets the minimum level of axis motion to start moving the - pointer. Allowed values are from 0 to 32766. Default value is - 3200. + Note: When specifying a Windows drive (e.g., "H:\"), you + must also specify a subdirectory. - joystick-maxsteps=STEPS + Note: Prior to version 0.9.18, Tux Paint would also use the + setting or default for "savedir" as the place to search for + personal data files (brushes, stamps, starters and fonts). + As of version 0.9.18, they may be specified separately (see + the "datadir" option, below). - Sets the maximum pixels the pointer will move at once. Allowed - values are from 1 to 7. Default value is 7. + Example: savedir=Z:\tuxpaint\ - joystick-hat-timeout=MILLISECONDS + exportdir=DIRECTORY - Sets the delay after wich the pointer will start moving - automatically if the hat is keeped pushed. Allowed values are - from 0 to 3000. Default value is 1000. + Use this option to change where Tux Paint exports files — + single images, or animated GIF slideshows — for external + use. - joystick-hat-slowness=SPEED + If you do not override it, the default location is: - Sets a delay at each automatic motion, allowing to slow the - speed of the hat. Allowed values are from 0 to 500. Default - value is 15. + * Linux & Unix — If available, wherever your desktop + environment is configured for pictures to be stored, + based on your XDG (X Desktop Group) configuration. (Try + running the command-line "xdg-user-dir PICTURES" to + find out.) + Typically (in an English locale), this will be a + "Pictures" subdirectory in your home directory (i.e., + "$HOME/Pictures" aka "~/Pictures"). + Tux Paint will fall back to using that typical + directory, of no XDG configuration can be read, or + nothing is set for "XDG_PICTURES_DIR". + * Windows - "My Pictures" directory for each user + (normaly "c:\Users\USERNAME\Pictures"). + You can directly open the folder as follows: + * Press "[Windows]+[R]" key to open "Run ..." + dialogue. + * Enter "Shell:My Pictures" in the text box and push + [OK]. + * macOS — TBD! - joystick-btn-escape=BUTTON NUMBER + Note: When the defaults are used, a new "TuxPaint" + subdirectory will be created and used. (e.g., + "~/Pictures/TuxPaint") When the "--exportdir" option is + used, the exact path specified will be used (no "TuxPaint" + subdirectory is created). - Selects the joystick button number, as seen by SDL, that will be - used to generate a escape event. Useful to dismiss dialogs and - quit. + The directory itself (e.g., "~/Pictures/TuxPaint") will be + created, if it doesn't exist. - joystick-btn-brush=BUTTON NUMBER + If the parent directory (e.g., "~/Pictures/TuxPaint") also + does not exist, Tux Paint will attempt to create it as well + (but not any directories higher than that). - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the brush tool. + Example: exportdir=/home/penguin/TuxPaintExports - joystick-btn-stamp=BUTTON NUMBER + More Saving Options - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the stamp tool. + nosave=yes - joystick-btn-lines=BUTTON NUMBER + This disables Tux Paint's ability to save files (and + therefore disables the on-screen "Save" button). It can be + used in situations where the program is only being used for + fun, or in a test environment. - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the lines tool. + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nosave=no" or "save=yes". In both cases, may be overridden + by the command-line option "--save". - joystick-btn-shapes=BUTTON NUMBER + autosave=yes + + This prevents Tux Paint from asking whether you want to save + the current picture when quitting, and assumes you do. + + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "autosave=no" or "noautosave=yes". In both cases, may be + overridden by the command-line option "--noautosave". - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the shapes tool. + ---------------------------------------------------------------------- - joystick-btn-text=BUTTON NUMBER +Data - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the text tool. + Lockfile - joystick-btn-label=BUTTON NUMBER + nolockfile=yes - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the label tool. + By default, Tux Paint uses what's known as a 'lockfile' to + prevent it from being launched more than once in 30 seconds. + (This is to avoid accidentally running multiple copies; for + example, by double-clicking a single-click launcher, or + simply impatiently clicking the icon multiple times.) - joystick-btn-magic=BUTTON NUMBER + To make Tux Paint ignore the lockfile, allowing it to run + again, even if it was just launched less than 30 seconds + ago, enable this setting in the configuration file, or run + Tux Paint with the --nolockfile option on the command-line. - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the magic tool. + By default, the lockfile is stored in "~/.tuxpaint/" under + Linux and Unix, and "userdata\" under Windows. - joystick-btn-undo=BUTTON NUMBER + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "nolockfile=no" or "lockfile=yes". In both cases, may be + overridden by the command-line option "--lockfile". - Selects the joystick button number, as seen by SDL, that will be - a shortcut to invoke the undo tool. + Data Directory - joystick-btn-redo=BUTTON NUMBER + datadir=DIRECTORY - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select redo tool. + Use this option to change where Tux Paint looks for personal + data files (brushes, stamps, starters, templates, and fonts + specific to the current user). + + Tux Paint will search for subdirectories/subfolders named + "brushes", "stamps", "starters", "templates", and "fonts" + under the specified data directory. + + If you do not override it, the default location is: + + * Linux & Unix — Under a hidden directory named + ".tuxpaint" in your home directory (aka "~" or "$HOME") + Example: /home/username/.tuxpaint/brushes/ + * Windows — Inside a folder named "TuxPaint" in your + "Application Data" folder. + Example: C:\Documents and Settings\Username\Application + Data\TuxPaint\brushes\ + * macOS — Inside a folder named "TuxPaint" in your + "Application Support" folder. + Example: /Users/Username/Library/Application + Support/TuxPaint/brushes/ + + Note: Prior to version 0.9.18, Tux Paint would use the same + setting or default as for "savedir" to search for data + files. As of version 0.9.18, they may be specified + separately. - joystick-btn-eraser=BUTTON NUMBER + Note: When specifying a Windows drive (e.g., "H:\"), you + must also specify a subdirectory. - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select eraser tool. + Example: datadir=/home/johnny/tuxpaint-data/ - joystick-btn-new=BUTTON NUMBER + Color Palette File - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the dialog for creating a new drawing. + colorfile=FILENAME - joystick-btn-open=BUTTON NUMBER + You may override Tux Paint's default color palette by + creating a plain ASCII text file that describes the colors + you want, and pointing to that file using the "colorfile" + option. - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the dialog for opening an existing drawing. + The file should list one color per line. Colors are defined + in terms of their Red, Green and Blue values, each from 0 + (off) to 255 (brightest). (For more information, try + Wikipedia's "RGB color model" article.) - joystick-btn-save=BUTTON NUMBER + Colors may be listed using three decimal numbers (e.g., "255 + 68 136") or a 6- or 3-digit-long hexadecimal 'triplet' + (e.g., "#ff4488" or "#F48"). - Selects the joystick button number, as seen by SDL, that will be - a shortcut to save the drawing. + After the color definition (on the same line) you may enter + text to describe the color. Tux will display this text when + the color is clicked. (For example, "#FFF White as snow.") - joystick-btn-pgsetup=BUTTON NUMBER + As an example, you can see the default colors currently used + in Tux Paint in: "default_colors.txt". - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the page setup dialog for printing. + NOTES: You must separate decimal values with spaces, and + begin hexadecimal values with a pound/number-sign character + ("#"). In 3-digit hexadecimal, each digit is used for both + the high and low halves of the byte, so "#FFF" is the same + as "#FFFFFF", not "#F0F0F0". - joystick-btn-print=BUTTON NUMBER + ---------------------------------------------------------------------- - Selects the joystick button number, as seen by SDL, that will be - a shortcut to print. +Accessibility - joystick-buttons-ignore=BUTTON1,BUTTON2,... + Mouse - A set of joystick button numbers, as seen by SDL, that should be - ignored. Otherwise, unless they are used by one of the - "joystick-btn-" options above, buttons will be seen as a mouse - left-click. + mouse-accessibility=yes - stampsize=SIZE + In this mode, instead of clicking, dragging and releasing + (e.g., to draw), you click, move, and click again to end the + motion. - Use this option to force Tux Paint to set the starting size of - all stamps. The SIZE value should be between 0 (smallest) and 10 - (largest). The size is relative to the available sizes of the - stamp, which depends on the stamp itself, and Tux Paint's - current canvas size. + Keyboard - Specify "default" to let Tux Paint decide (its standard - behavior). + keyboard=yes - keyboard=yes + This allows the keyboard arrow keys to be used to control + the mouse pointer. (e.g., for mouseless environments, or + handicapped/accessibility purposes) - This allows the keyboard arrow keys to be used to control the - mouse pointer. (e.g., for mouseless environments, or - handicapped/accessibility purposes) + Features: - Features: + * Fine movement within canvas, or coarse movement if + Shift is held. + * Coarse movement within tool button areas. + * Key controls: + * [Left]/[Right]/[Up]/[Down], numpad [1] thru [9]: + Move mouse + * [Space]/[5]: Click mouse (except when using "Text" + or "Label" tools) + * [Insert]/[F5]: Click mouse (always) + * [F4] jump mouse between "Tools", "Colors" and + canvas areas + * If mouse is within "Tools" section on the left, or + "Colors" section at the bottom: + * [F7], [F8]: Move down/up between buttons, + respectively (Tools section, only) + * [F11], [F12]: Move to previous/next button, + respectively + * To click-and-drag, hold one of the 'click' keys (e.g., + [Insert]), and use the movement keys (e.g., [Left]). + * Note: The "mouse accessibility" feature works with + the keyboard mouse controls. With both options + enabled, painting tools can be used to draw by + pressing a 'click' key to start clicking, movement + keys to move around (which will draw), and another + 'click' key to end the click (stop drawing). + * A regular mouse and/or joystick may still be used (so + you can, e.g., move with the mouse, and click with the + keyboard, or vice-versa) - * Fine movement within canvas, or coarse movement if Shift is - held. - * Coarse movement within tool button areas. - * Key controls: - * [Left]/[Right]/[Up]/[Down], numpad [1] thru [9]: Move - mouse - * [Space]/[5]: Click mouse (except when using "Text" or - "Label" tools) - * [Insert]/[F5]: Click mouse (always) - * [F4] jump mouse between "Tools", "Colors" and canvas - areas - * If mouse is within "Tools" section on the left, or - "Colors" section at the bottom: - * [F7], [F8]: Move down/up between buttons, - respectively (Tools section, only) - * [F11], [F12]: Move to previous/next button, - respectively - * To click-and-drag, hold one of the 'click' keys (e.g., - [Insert]), and use the movement keys (e.g., [Left]). - * Note: The "mouse accessibility" feature works with the - keyboard mouse controls. With both options enabled, - painting tools can be used to draw by pressing a - 'click' key to start clicking, movement keys to move - around (which will draw), and another 'click' key to - end the click (stop drawing). - * A regular mouse and/or joystick may still be used (so you - can, e.g., move with the mouse, and click with the - keyboard, or vice-versa) - - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "keyboard=no" - or "2$keyboard=no". In both cases, may be overridden by the - command-line option "--mouse". - - savedir=DIRECTORY - - Use this option to change where Tux Paint's "saved" - directory/folder is located, which is where Tux Paint saves and - opens pictures. - - If you do not override it, the default location is: - - * Linux & Unix — Under a hidden directory named ".tuxpaint" - in your home directory (aka "~" or "$HOME") - Example: /home/username/.tuxpaint/saved/ - * Windows — Inside a folder named "TuxPaint" in your - "Application Data" folder. - Example: C:\Documents and Settings\Username\Application - Data\TuxPaint\saved\ - * macOS — Inside a folder named "TuxPaint" in your - "Application Support" folder. - Example: /Users/Username/Library/Application - Support/TuxPaint/saved/ - - Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. - - Note: Prior to version 0.9.18, Tux Paint would also use the - setting or default for "savedir" as the place to search for - personal data files (brushes, stamps, starters and fonts). As of - version 0.9.18, they may be specified separately (see the - "datadir" option, below). - - Example: savedir=Z:\tuxpaint\ - - exportdir=DIRECTORY - - Use this option to change where Tux Paint exports files — single - images, or animated GIF slideshows — for external use. - - If you do not override it, the default location is: - - * Linux & Unix — If available, wherever your desktop - environment is configured for pictures to be stored, based - on your XDG (X Desktop Group) configuration. (Try running - the command-line "xdg-user-dir PICTURES" to find out.) - Typically (in an English locale), this will be a "Pictures" - subdirectory in your home directory (i.e., "$HOME/Pictures" - aka "~/Pictures"). - Tux Paint will fall back to using that typical directory, - of no XDG configuration can be read, or nothing is set for - "XDG_PICTURES_DIR". - * Windows - "My Pictures" directory for each user (normaly - "c:\Users\USERNAME\Pictures"). - You can directly open the folder as follows: - * Press "[Windows]+[R]" key to open "Run ..." dialogue. - * Enter "Shell:My Pictures" in the text box and push - [OK]. - * macOS — TBD! - - Note: When the defaults are used, a new "TuxPaint" subdirectory - will be created and used. (e.g., "~/Pictures/TuxPaint") When the - "--exportdir" option is used, the exact path specified will be - used (no "TuxPaint" subdirectory is created). - - The directory itself (e.g., "~/Pictures/TuxPaint") will be - created, if it doesn't exist. - - If the parent directory (e.g., "~/Pictures/TuxPaint") also does - not exist, Tux Paint will attempt to create it as well (but not - any directories higher than that). - - Example: exportdir=/home/penguin/TuxPaintExports - - datadir=DIRECTORY - - Use this option to change where Tux Paint looks for personal - data files (brushes, stamps, starters, templates, and fonts - specific to the current user). - - Tux Paint will search for subdirectories/subfolders named - "brushes", "stamps", "starters", "templates", and "fonts" under - the specified data directory. - - If you do not override it, the default location is: - - * Linux & Unix — Under a hidden directory named ".tuxpaint" - in your home directory (aka "~" or "$HOME") - Example: /home/username/.tuxpaint/brushes/ - * Windows — Inside a folder named "TuxPaint" in your - "Application Data" folder. - Example: C:\Documents and Settings\Username\Application - Data\TuxPaint\brushes\ - * macOS — Inside a folder named "TuxPaint" in your - "Application Support" folder. - Example: /Users/Username/Library/Application - Support/TuxPaint/brushes/ + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "keyboard=no" or "2$keyboard=no". In both cases, may be + overridden by the command-line option "--mouse". - Note: Prior to version 0.9.18, Tux Paint would use the same - setting or default as for "savedir" to search for data files. As - of version 0.9.18, they may be specified separately. + Onscreen Keyboard - Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. - - Example: datadir=/home/johnny/tuxpaint-data/ - - saveover=yes - - This disables the "Save over the old version...?" prompt when - saving an existing file. With this option, the older version - will always be replaced by the new version, automatically. - - saveover=new - - This also disables the "Save over the old version...?" prompt - when saving an existing file. This option, however, will always - save a new file, rather than overwrite the older version. - - saveover=ask - - (This option is redundant, since this is the default.) When - saving an existing drawing, you will be first asked whether to - save over the older version or not. - - nosave=yes - - This disables Tux Paint's ability to save files (and therefore - disables the on-screen "Save" button). It can be used in - situations where the program is only being used for fun, or in a - test environment. - - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosave=no" or - "save=yes". In both cases, may be overridden by the command-line - option "--save". - - autosave=yes - - This prevents Tux Paint from asking whether you want to save the - current picture when quitting, and assumes you do. - - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "autosave=no" - or "noautosave=yes". In both cases, may be overridden by the - command-line option "--noautosave". - - startblank=yes - - This causes Tux Paint to display a blank canvas when it first - starts up, rather than loading the last image that was being - edited. - - Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "startblank=no" or "startlast=yes". In both cases, may be - overridden by the command-line option "--startlast". - - colorfile=FILENAME - - You may override Tux Paint's default color palette by creating a - plain ASCII text file that describes the colors you want, and - pointing to that file using the "colorfile" option. - - The file should list one color per line. Colors are defined in - terms of their Red, Green and Blue values, each from 0 (off) to - 255 (brightest). (For more information, try Wikipedia's "RGB - color model" article.) - - Colors may be listed using three decimal numbers (e.g., "255 68 - 136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., - "#ff4488" or "#F48"). - - After the color definition (on the same line) you may enter text - to describe the color. Tux will display this text when the color - is clicked. (For example, "#FFF White as snow.") - - As an example, you can see the default colors currently used in - Tux Paint in: "default_colors.txt". - - NOTES: You must separate decimal values with spaces, and begin - hexadecimal values with a pound/number-sign character ("#"). In - 3-digit hexadecimal, each digit is used for both the high and - low halves of the byte, so "#FFF" is the same as "#FFFFFF", not - "#F0F0F0". - - colorsrows=ROWS - - How many rows of color palette buttons to show; useful when - using a large color palette (see "colorfile", above), and/or for - use with coarse input devices (like eyegaze trackers). "ROWS" - may be between "1" (the default) and "3". - - lang=LANGUAGE - - Run Tux Paint in one of the supported languages. Possible choice - for LANGUAGE currently include: - - +-----------------------------------------------------------+ - |english |american-english | | - |---------------------+---------------------+---------------| - |acholi |acoli | | - |---------------------+---------------------+---------------| - |afrikaans | | | - |---------------------+---------------------+---------------| - |akan |twi-fante | | - |---------------------+---------------------+---------------| - |albanian | | | - |---------------------+---------------------+---------------| - |amharic | | | - |---------------------+---------------------+---------------| - |arabic | | | - |---------------------+---------------------+---------------| - |aragones | | | - |---------------------+---------------------+---------------| - |armenian |hayeren | | - |---------------------+---------------------+---------------| - |assamese | | | - |---------------------+---------------------+---------------| - |asturian | | | - |---------------------+---------------------+---------------| - |australian-english | | | - |---------------------+---------------------+---------------| - |azerbaijani | | | - |---------------------+---------------------+---------------| - |bambara | | | - |---------------------+---------------------+---------------| - |basque |euskara | | - |---------------------+---------------------+---------------| - |belarusian |bielaruskaja | | - |---------------------+---------------------+---------------| - |bengali | | | - |---------------------+---------------------+---------------| - |bodo | | | - |---------------------+---------------------+---------------| - |bokmal | | | - |---------------------+---------------------+---------------| - |bosnian | | | - |---------------------+---------------------+---------------| - |brazilian-portuguese |portugues-brazilian |brazilian | - |---------------------+---------------------+---------------| - |breton |brezhoneg | | - |---------------------+---------------------+---------------| - |british-english |british | | - |---------------------+---------------------+---------------| - |bulgarian | | | - |---------------------+---------------------+---------------| - |canadian-english | | | - |---------------------+---------------------+---------------| - |catalan |catala | | - |---------------------+---------------------+---------------| - |chinese |simplified-chinese | | - |---------------------+---------------------+---------------| - |croatian |hrvatski | | - |---------------------+---------------------+---------------| - |czech |cesky | | - |---------------------+---------------------+---------------| - |danish |dansk | | - |---------------------+---------------------+---------------| - | |dogri | | - |---------------------+---------------------+---------------| - |dutch |nederlands | | - |---------------------+---------------------+---------------| - |esperanto | | | - |---------------------+---------------------+---------------| - |estonian | | | - |---------------------+---------------------+---------------| - |faroese | | | - |---------------------+---------------------+---------------| - |finnish |suomi | | - |---------------------+---------------------+---------------| - |french |francais | | - |---------------------+---------------------+---------------| - |fula |fulah |pulaar-fulfulde| - |---------------------+---------------------+---------------| - |gaelic |gaidhlig |irish-gaelic | - |---------------------+---------------------+---------------| - |galician |galego | | - |---------------------+---------------------+---------------| - |georgian | | | - |---------------------+---------------------+---------------| - |german |deutsch | | - |---------------------+---------------------+---------------| - |greek | | | - |---------------------+---------------------+---------------| - |gronings |zudelk-veenkelonioals| | - |---------------------+---------------------+---------------| - |gujarati | | | - |---------------------+---------------------+---------------| - |hebrew | | | - |---------------------+---------------------+---------------| - |hindi | | | - |---------------------+---------------------+---------------| - |hungarian |magyar | | - |---------------------+---------------------+---------------| - |icelandic |islenska | | - |---------------------+---------------------+---------------| - |indonesian |bahasa-indonesia | | - |---------------------+---------------------+---------------| - |inuktitut | | | - |---------------------+---------------------+---------------| - |italian |italiano | | - |---------------------+---------------------+---------------| - |japanese | | | - |---------------------+---------------------+---------------| - |kabyle | |kabylian | - |---------------------+---------------------+---------------| - |kannada | | | - |---------------------+---------------------+---------------| - |kashmiri-devanagari | | | - |---------------------+---------------------+---------------| - |kashmiri-perso-arabic| | | - |---------------------+---------------------+---------------| - |khmer | | | - |---------------------+---------------------+---------------| - |kiga |chiga | | - |---------------------+---------------------+---------------| - |kinyarwanda | | | - |---------------------+---------------------+---------------| - |klingon |tlhIngan | | - |---------------------+---------------------+---------------| - |konkani-devanagari | | | - |---------------------+---------------------+---------------| - |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 | | - |---------------------+---------------------+---------------| - |ojibwe |ojibway | | - |---------------------+---------------------+---------------| - |persian | | | - |---------------------+---------------------+---------------| - |polish |polski | | - |---------------------+---------------------+---------------| - |portuguese |portugues | | - |---------------------+---------------------+---------------| - |punjabi |panjabi | | - |---------------------+---------------------+---------------| - |romanian | | | - |---------------------+---------------------+---------------| - |russian |russkiy | | - |---------------------+---------------------+---------------| - |sanskrit | | | - |---------------------+---------------------+---------------| - |santali-devanagari | | | - |---------------------+---------------------+---------------| - |santali-ol-chiki | | | - |---------------------+---------------------+---------------| - |scottish |ghaidhlig |scottish-gaelic| - |---------------------+---------------------+---------------| - |serbian | | | - |---------------------+---------------------+---------------| - |serbian-latin | | | - |---------------------+---------------------+---------------| - |shuswap |secwepemctin | | - |---------------------+---------------------+---------------| - |sindhi-devanagari | | | - |---------------------+---------------------+---------------| - |sindhi-perso-arabic | | | - |---------------------+---------------------+---------------| - |slovak | | | - |---------------------+---------------------+---------------| - |slovenian |slovensko | | - |---------------------+---------------------+---------------| - |songhay | | | - |---------------------+---------------------+---------------| - |southafrican-english | | | - |---------------------+---------------------+---------------| - |spanish |espanol | | - |---------------------+---------------------+---------------| - |sundanese | | | - |---------------------+---------------------+---------------| - |swahili | | | - |---------------------+---------------------+---------------| - |swedish |svenska | | - |---------------------+---------------------+---------------| - |tagalog | | | - |---------------------+---------------------+---------------| - |tamil | | | - |---------------------+---------------------+---------------| - |telugu | | | - |---------------------+---------------------+---------------| - |thai | | | - |---------------------+---------------------+---------------| - |tibetan | | | - |---------------------+---------------------+---------------| - |traditional-chinese | | | - |---------------------+---------------------+---------------| - |turkish | | | - |---------------------+---------------------+---------------| - |twi | | | - |---------------------+---------------------+---------------| - |ukrainian | | | - |---------------------+---------------------+---------------| - |urdu | | | - |---------------------+---------------------+---------------| - |venda | | | - |---------------------+---------------------+---------------| - |venetian |veneto | | - |---------------------+---------------------+---------------| - |vietnamese | | | - |---------------------+---------------------+---------------| - |walloon |walon | | - |---------------------+---------------------+---------------| - |welsh |cymraeg | | - |---------------------+---------------------+---------------| - |wolof | | | - |---------------------+---------------------+---------------| - |xhosa | | | - |---------------------+---------------------+---------------| - |miahuatlan-zapotec | |zapotec | - |---------------------+---------------------+---------------| - |zulu | |zulu | - +-----------------------------------------------------------+ + onscreen-keyboard=yes + + Presents a clickable on-screen keyboard when using the Text + and Label tools. + + onscreen-keyboard-layout=LAYOUTNAME + + Selects the initial layout for the on-screen keyboard when + using the Text and Label tools. + Note: Using this option implies automatically + onscreen-keyboard=yes, so setting both is redundant. + + onscreen-keyboard-disable-change=yes + + Disables the possibility for changing the layout of the + on-screen keyboard when using the Text and Label tools, + useful for simplifying things for the small children. + Note: Using this option implies automatically + onscreen-keyboard=yes, so setting both is redundant. + + Note: If used in a system-wide configuration file, may be + overridden by the user's configuration file using + "onscreen-keyboard-disable-change=no". In both cases, may be + overridden by the command-line option + "--onscreen-keyboard-disable-change=no". + + ---------------------------------------------------------------------- + +Joystick + + Main Device + + joystick-dev=N + + Specify which joystick device should be used by Tux Paint. + Default value is 0 (the first joystick). + + joystick-slowness=SPEED + + Sets a delay at each axis motion, allowing to slow the + joystick. Allowed values are from 0 to 500. Default value is + 15. + + joystick-threshold=THRESHOLD + + Sets the minimum level of axis motion to start moving the + pointer. Allowed values are from 0 to 32766. Default value + is 3200. + + joystick-maxsteps=STEPS + + Sets the maximum pixels the pointer will move at once. + Allowed values are from 1 to 7. Default value is 7. + + Hat + + joystick-hat-slowness=SPEED + + Sets a delay at each automatic motion, allowing to slow the + speed of the hat. Allowed values are from 0 to 500. Default + value is 15. + + joystick-hat-timeout=MILLISECONDS + + Sets the delay after wich the pointer will start moving + automatically if the hat is keeped pushed. Allowed values + are from 0 to 3000. Default value is 1000. + + Buttons to Disable + + joystick-buttons-ignore=BUTTON1,BUTTON2,... + + A set of joystick button numbers, as seen by SDL, that + should be ignored. Otherwise, unless they are used by one of + the "joystick-btn-" options above, buttons will be seen as a + mouse left-click. + + Button Shortcuts + + joystick-btn-escape=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be used to generate a escape event. Useful to dismiss + dialogs and quit. + + joystick-btn-brush=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to select the brush tool. + + joystick-btn-stamp=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to select the stamp tool. + + joystick-btn-lines=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to select the lines tool. + + joystick-btn-shapes=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to select the shapes tool. + + joystick-btn-text=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to select the text tool. + + joystick-btn-label=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to select the label tool. + + joystick-btn-magic=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to select the magic tool. + + joystick-btn-undo=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to invoke the undo tool. + + joystick-btn-redo=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to select redo tool. + + joystick-btn-eraser=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to select eraser tool. + + joystick-btn-new=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to launch the dialog for creating a new + drawing. + + joystick-btn-open=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to launch the dialog for opening an + existing drawing. + + joystick-btn-save=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to save the drawing. + + joystick-btn-pgsetup=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to launch the page setup dialog for + printing. + + joystick-btn-print=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that + will be a shortcut to print. ---------------------------------------------------------------------- @@ -1354,16 +1487,6 @@ Windows Users ------------------------------------- - --locale LOCALE - - Run Tux Paint in one of the support languages. See the - "Choosing a Different Language" section below for the locale - strings (e.g., "de_DE" for German) to use. - - (If your locale is already set, e.g. with the "$LANG" - environment variable, this option is not necessary, since Tux - Paint honors your environment's setting, if possible.) - --nosysconfig Under Linux and Unix, this prevents the system-wide diff --git a/docs/en/html/OPTIONS.html b/docs/en/html/OPTIONS.html index 46b39b07f..9233e9934 100644 --- a/docs/en/html/OPTIONS.html +++ b/docs/en/html/OPTIONS.html @@ -121,2555 +121,2830 @@

The following settings can be set in the configuration file. (Command-line settings will override these. See the "Command-Line Options" section, below.)

-
-
- fullscreen=yes -
+
+

+ Video/Sound

+
+

+ Video

-
-

- Run the program in full screen mode, rather than in a window.

-

- Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "fullscreen=no". In both cases, may be overridden by the command-line option "--windowed".

-
+
+
+
+ fullscreen=yes +
+ +
+

+ Run the program in full screen mode, rather than in a window.

+

+ Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "fullscreen=no". In both cases, may be overridden by the command-line option "--windowed".

+
+ +
+ fullscreen=native +
+ +
+

+ Run the program in full screen mode. Additionally, assume the screen's current resolution (set by the operating system).

+
+ +
+ windowsize=SIZE +
+ +
+

+ Run the program at a different size (in windowed mode) or at a different screen resolution (in fullscreen mode), rather than the default (usually 800x600).

+ +

+ The SIZE value should be presented in pixels, in 'width-by-height' format, with an "x" (lowercase X) between the values. The size can be anything that's at least 640 wide, and at least 480 tall.

+ +

+ Some examples:

+ +
    +
  • 640x480 +
  • + +
  • 1024x768 +
  • + +
  • 768x1024 +
  • + +
  • 1600x1200 +
  • +
+
+ +
+ orient=portrait +
+ +
+

+ Swaps the width/height options given to Tux Paint, useful for rotating the window on portait displays, such as a tablet PC that's in tablet orientation.

+

+ Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "orient=landscape". In both cases, may be overridden by the command-line option "--orient=landscape".

+
+ +
+ native=yes +
+ +
+

+ When running Tux Paint in fullscreen mode, this assumes the screen's current resolution (overriding any "windowsize" option), as set by the operating system.

+
+ +
+ allowscreensaver=yes +
+ +
+

+ By default, Tux Paint prevents your system's screensaver from starting up. You can override this by using the "allowscreensaver" option. Note: This requires version 1.2.12 or higher of the SDL library. (You can also do this by setting the "SDL_VIDEO_ALLOW_SCREENSAVER" environment variable on your system to "1".)

+

+ Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "allowscreensaver=no" or "disablescreensaver=yes". In both cases, may be overridden by the command-line option "--disablescreensaver".

+
+
+
-
- fullscreen=native -
+

+ Sound

+
+
+
+ nosound=yes +
+ +
+

+ Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used to reenable sounds if they were disabled using this option.)

+

+ Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nosound=no" or "sound=yes". In both cases, may be overridden by the command-line option "--sound".

+
+ +
+ nostereo=yes +
+ +
+

+ Disable stereo panning support. (Useful for users with hearing impairment in one ear, or places where a single speaker or headphone is being used.)

+

+ Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nostereo=no" or "stereo=yes". In both cases, may be overridden by the command-line option "--stereo".

+
+
+
-
-

- Run the program in full screen mode. Additionally, assume the screen's current resolution (set by the operating system).

-
+

+ Interface Size

+
+
+
+ buttonsize=SIZE +
+ +
+

+ Set the pixel size of buttons in Tux Paint's user interface (overriding the default of "48"). Useful when using very high-density displays or coarse input devices, such as eye gaze trackers.

+ +

+ The SIZE value should be presented in pixels, and can be anything between 24 and 192, inclusive. Most buttons are square, and this will affect their width and height.

+ +

+ Note: If the chosen button size would cause the buttons to be too large for all required UI elements to appear under Tux Paint's chosen window size, the largest possible button size will be used. (A note will appear in stderr.)

+
+ +
+ colorsrows=ROWS +
+ +
+

+ How many rows of color palette buttons to show; useful when using a large color palette (see "colorfile", above), and/or for use with coarse input devices (like eyegaze trackers). "ROWS" may be between "1" (the default) and "3".

+
+
+
+
-
- windowsize=SIZE -
+
+

+ Mouse/Keyboard

+
+

+ Cursor

-
-

- Run the program at a different size (in windowed mode) or at a different screen resolution (in fullscreen mode), rather than the default (usually 800x600).

+
+
+
+ nofancycursors=yes +
-

- The SIZE value should be presented in pixels, in 'width-by-height' format, with an "x" (lowercase X) between the values. The size can be anything that's at least 640 wide, and at least 480 tall.

+
+

+ This disables the fancy mouse pointer shapes in Tux Paint, and uses your environment's normal mouse pointer.

-

- Some examples:

+

+ In some enviornments, the fancy cursors cause problems. Use this option to avoid them.

+

+ Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nofancycursors=no" or "fancycursors=yes". In both cases, may be overridden by the command-line option "--fancycursors".

+
-
    -
  • 640x480 -
  • +
    + hidecursor=yes +
    -
  • 1024x768 -
  • +
    +

    + This completely hides the mouse pointer shapes in Tux Paint.

    -
  • 768x1024 -
  • +

    + This is useful for touchscreen devices, such as tablet PCs.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "hidecursor=no" or "showcursor=yes". In both cases, may be overridden by the command-line option "--showcursor".

    +
    +
+
-
  • 1600x1200 -
  • +

    + Keyboard

    + +
    +
    +
    + noshortcuts=yes +
    + +
    +

    + This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, [Ctrl]-[N] for a new image, etc.)

    + +

    + This is useful to prevent unwanted commands from being activated by children who aren't experienced with keyboards.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "noshortcuts=no" or "shortcuts=yes". In both cases, may be overridden by the command-line option "--shortcuts".

    +
    +
    +
    + +

    + Mouse

    + +
    +
    +
    + grab=yes +
    + +
    +

    + Tux Paint will attempt to 'grab' the mouse and keyboard, so that the mouse is confined to Tux Paint's window, and nearly all keyboard input is passed directly to it.

    + +

    + This is useful to disable operating system actions that could get the user out of Tux Paint [Alt]-[Tab] window cycling, [Ctrl]-[Escape], etc. This is especially useful in fullscreen mode.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "grab=no" or "dontgrab=yes". In both cases, may be overridden by the command-line option "--dontgrab".

    +
    + +
    + nowheelmouse=yes +
    + +
    +

    + This disables support for the wheel on mice that have it. (Normally, the wheel will scroll the selector menu on the right.)

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nowheelmouse=no" or "wheelmouse=yes". In both cases, may be overridden by the command-line option "--wheelmouse".

    +
    + +
    + nobuttondistinction=yes +
    + +
    +

    + Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse could also be used for clicking. In version 0.9.15, it was changed so that only the left mouse button worked, so as to not train children to use the wrong button.

    + +

    + However, for children who have trouble with the mouse, this distinction between the two or three buttons on a mouse can be disabled (returning Tux Paint to its old behavior) by using this option.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nobuttondistinction=no" or "buttondistinction=yes". In both cases, may be overridden by the command-line option "--buttondistinction".

    +
    +
    +
    +
    + +
    +

    + Simplification

    +
    +

    + Interface Simplification

    + +
    +
    +
    + simpleshapes=yes +
    + +
    +

    + Disable the rotation step of the 'Shape' tool. Click, drag and release is all that will be needed to draw a shape.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "simpleshapes=no" or "complexshapes=yes". In both cases, may be overridden by the command-line option "--complexshapes".

    +
    + +
    + nooutlines=yes +
    + +
    +

    + In this 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 very slow computers, or displayed on a remote X-Window display.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nooutlines=no" or "outlines=yes". In both cases, may be overridden by the command-line option "--outlines".

    +
    + +
    + uppercase=yes +
    + +
    +

    + All text will be rendered only in uppercase (e.g., "Brush" will be "BRUSH"). Useful for children who can read, but who have only learned uppercase letters so far.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "uppercase=no" or "mixedcase=yes". In both cases, may be overridden by the command-line option "--mixedcase".

    +
    +
    +
    + +

    + Initial Stamp Size

    + +
    +
    +
    + stampsize=SIZE +
    + +
    +

    + Use this option to force Tux Paint to set the starting size of all stamps. The SIZE value should be between 0 (smallest) and 10 (largest). The size is relative to the available sizes of the stamp, which depends on the stamp itself, and Tux Paint's current canvas size.

    + +

    + Specify "default" to let Tux Paint decide (its standard behavior).

    +
    +
    +
    + +

    + Control Simplification

    + +
    +
    +
    + noquit=yes +
    + +
    +

    + Disable the on-screen "Quit" button and prevent the [Escape] key from quitting Tux Paint.

    + +

    + Using the [Alt] + [F4] keyboard combination or clicking the window's close button (assuming you're not in fullscreen mode) still works to quit Tux Paint.

    + +

    + You can also use the following keyboard combination to quit: [Shift] + [Control] + [Escape].

    + +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "noquit=no" or "quit=yes". In both cases, may be overridden by the command-line option "--quit".

    +
    + +
    + nostamps=yes +
    + +
    +

    + This option tells Tux Paint to not load any rubber stamp images, which in turn ends up disabling the Stamps tool.

    + +

    + This can speed up Tux Paint when it first loads up, and reduce memory usage while it's running. Of course, no stamps will be available at all.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nostamps=no" or "stamps=yes". In both cases, may be overridden by the command-line option "--stamps".

    +
    + +
    + nostampcontrols=yes +
    + +
    +

    + Some images in the Stamps tool can be mirrored, flipped, and/or have their size changed. This option disables the controls, and only provides the basic stamps.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nostampcontrols=no" or "stampcontrols=yes". In both cases, may be overridden by the command-line option "--stampcontrols".

    +
    + +
    + nomagiccontrols=yes +
    + +
    +

    + Some Magic tools have the option of acting like a paintbrush, or affecting the entire canvas at once. This option disables the controls, and only provides the default functionality (usually paint-mode).

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nomagiccontrols=no" or "magiccontrols=yes". In both cases, may be overridden by the command-line option "--magiccontrols".

    +
    + +
    + noshapecontrols=yes +
    + +
    +

    + Disable the control buttons shown when using the Shapes tool that allow changing how shapes are drawn — centered around the initial mouse click, or with a corner at the initial mouse click.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "noshapecontrols=no" or "shapecontrols=yes". In both cases, may be overridden by the command-line option "--shapecontrols".

    +
    + +
    + nolabel=yes +
    + +
    +

    + Disables the Label tool: the tool that allows text entry which can be edited later.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nolabel=no" or "label=yes". In both cases, may be overridden by the command-line option "--label".

    +
    +
    +
    +
    + +
    +

    + Languages

    +
    +

    + Language

    + +
    +
    +
    + lang=LANGUAGE +
    + +
    +

    + Run Tux Paint in one of the supported languages. Possible choice for LANGUAGE currently include:

    + + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + english + + american-english + + +
    + acholi + + acoli + + +
    + afrikaans + + + + +
    + akan + + twi-fante + + +
    + albanian + + + + +
    + amharic + + + + +
    + arabic + + + + +
    + aragones + + + + +
    + armenian + + hayeren + + +
    + assamese + + + + +
    + asturian + + + + +
    + australian-english + + + + +
    + azerbaijani + + + + +
    + bambara + + + + +
    + basque + + euskara + + +
    + belarusian + + bielaruskaja + + +
    + bengali + + + + +
    + bodo + + + + +
    + bokmal + + + + +
    + bosnian + + + + +
    + brazilian-portuguese + + portugues-brazilian + + brazilian +
    + breton + + brezhoneg + + +
    + british-english + + british + + +
    + bulgarian + + + + +
    + canadian-english + + + + +
    + catalan + + catala + + +
    + chinese + + simplified-chinese + + +
    + croatian + + hrvatski + + +
    + czech + + cesky + + +
    + danish + + dansk + + +
    + + + dogri + + +
    + dutch + + nederlands + + +
    + esperanto + + + + +
    + estonian + + + + +
    + faroese + + + + +
    + finnish + + suomi + + +
    + french + + francais + + +
    + fula + + fulah + + pulaar-fulfulde +
    + gaelic + + gaidhlig + + irish-gaelic +
    + galician + + galego + + +
    + georgian + + + + +
    + german + + deutsch + + +
    + greek + + + + +
    + gronings + + zudelk-veenkelonioals + + +
    + gujarati + + + + +
    + hebrew + + + + +
    + hindi + + + + +
    + hungarian + + magyar + + +
    + icelandic + + islenska + + +
    + indonesian + + bahasa-indonesia + + +
    + inuktitut + + + + +
    + italian + + italiano + + +
    + japanese + + + + +
    + kabyle + + + + kabylian +
    + kannada + + + + +
    + kashmiri-devanagari + + + + +
    + kashmiri-perso-arabic + + + + +
    + khmer + + + + +
    + kiga + + chiga + + +
    + kinyarwanda + + + + +
    + klingon + + tlhIngan + + +
    + konkani-devanagari + + + + +
    + 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 + + +
    + ojibwe + + ojibway + + +
    + persian + + + + +
    + polish + + polski + + +
    + portuguese + + portugues + + +
    + punjabi + + panjabi + + +
    + romanian + + + + +
    + russian + + russkiy + + +
    + sanskrit + + + + +
    + santali-devanagari + + + + +
    + santali-ol-chiki + + + + +
    + scottish + + ghaidhlig + + scottish-gaelic +
    + serbian + + + + +
    + serbian-latin + + + + +
    + shuswap + + secwepemctin + + +
    + sindhi-devanagari + + + + +
    + sindhi-perso-arabic + + + + +
    + slovak + + + + +
    + slovenian + + slovensko + + +
    + songhay + + + + +
    + southafrican-english + + + + +
    + spanish + + espanol + + +
    + sundanese + + + + +
    + swahili + + + + +
    + swedish + + svenska + + +
    + tagalog + + + + +
    + tamil + + + + +
    + telugu + + + + +
    + thai + + + + +
    + tibetan + + + + +
    + traditional-chinese + + + + +
    + turkish + + + + +
    + twi + + + + +
    + ukrainian + + + + +
    + urdu + + + + +
    + venda + + + + +
    + venetian + + veneto + + +
    + vietnamese + + + + +
    + walloon + + walon + + +
    + welsh + + cymraeg + + +
    + wolof + + + + +
    + xhosa + + + + +
    + miahuatlan-zapotec + + + + zapotec +
    + zulu + + + + zulu +
    +
    +
    + +
    + --locale LOCALE +
    + +
    +

    + Run Tux Paint in one of the support languages. See the "Choosing a Different Language" section below for the locale strings (e.g., "de_DE" for German) to use.

    + +

    + (If your locale is already set, e.g. with the "$LANG" environment variable, this option is not necessary, since Tux Paint honors your environment's setting, if possible.)

    +
    + +
    + mirrorstamps=yes +
    + +
    +

    + For stamps that can be mirrored, this option sets them to their mirrored shape by default.

    + +

    + This can be useful for people who prefer things right-to-left, rather than left-to-right.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "mirrorstamps=no" or "dontmirrorstamps=yes". In both cases, may be overridden by the command-line option "--dontmirrorstamps".

    +
    +
    +
    + +

    + Fonts

    + +
    +
    +
    + sysfonts=yes +
    + +
    +

    + This option causes Tux Paint to attempt to load fonts (for use in the Text tool) from your operating system. Normally, Tux Paint will only load the ones that came bundled with Tux Paint.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "sysfonts=no" or "nosysfonts=yes". In both cases, may be overridden by the command-line option "--nosysfonts".

    +
    + +
    + alllocalefonts=yes +
    + +
    +

    + Prior to version 0.9.21, Tux Paint loaded all fonts in its own fonts directory, including locale-specific ones (e.g., the one for Tibetan, which had no latin characters). As of 0.9.21, the only font loaded from the locale-specific subdirectory, if any, is one matching the locale Tux Paint is running on.

    + +

    + To load all locale-specific fonts (the old behavior), set this option.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "alllocalefonts=no" or "currentlocalefont=yes". In both cases, may be overridden by the command-line option "--currentlocalefont".

    +
    +
    +
    +
    + +
    +

    + Printing

    +
    +

    + Print Permissions

    + +
    +
    +
    + noprint=yes +
    + +
    +

    + Disable the printing feature.

    +
    + +
    + printdelay=SECONDS +
    + +
    +

    + Restrict printing so that printing can occur only once every SECONDS seconds.

    + +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "printdelay=0". In both cases, may be overridden by the command-line option "--printdelay=0".

    +
    +
    +
    + +

    + Show Printer Dialog

    + +
    +
    +
    + altprint=always +
    + +
    +

    + This causes Tux Paint to always show the printer dialog (or, on Linux/Unix, run the "altprintcommand") when the 'Print' button is clicked. In other words, it's like clicking 'Print' while holding [Alt], except you don't need to hold [Alt] every time.

    +
    + +
    + altprint=never +
    + +
    +

    + This prevents Tux Paint from ever showing the printer dialog (or, on Linux/Unix, run the "altprintcommand") when the 'Print' button is clicked. In other words, it makes the [Alt] key have no effect when clicking the 'Print' button.

    +
    + +
    + altprint=mod +
    + +
    +

    + This is the normal, default behavior. Tux Paint shows a printer dialog (or, on Linux/Unix, runs the "altprintcommand"), when the [Alt] key is pressed while the 'Print' button is clicked. Clicking 'Print' without holding [Alt] prints without showing a dialog.

    +
    + +
    +
    + +

    + Save Printer Configuration

    + +
    +
    +
    + printcfg=yes +
    + +
    +

    + (Windows and macOS only) +

    + +

    + Tux Paint will use a printer configuration file when printing. Push the [Alt] key while clicking the 'Print' button in Tux Paint to cause a Windows print dialog window to appear.

    + +

    + (Note: This only works when not running Tux Paint in fullscreen mode.) Any configuration changes made in this dialog will be saved to the file "userdata/print.cfg" , and used again, as long as the "printcfg" option is set.

    + +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "printcfg=no" or "noprintcfg=yes". In both cases, may be overridden by the command-line option "--noprintcfg".

    +
    + +
    +
    + +

    + Print Commands

    + +
    +
    +
    + printcommand=COMMAND +
    + +
    +

    + (Linux and Unix only) +

    + +

    + Use the command COMMAND to print a PostScript format file when the 'Print' button is clicked. If this option is not specifically not set, the default command is:

    + +
    + lpr +
    + +

    + Note: Versions of Tux Paint prior to 0.9.15 sent PNG format data to the print command (which defaulted to "pngtopnm | pnmtops | lpr").

    + +

    + If you set an alternative printcommand in the configuration file prior to version 0.9.15, you will need to change it.

    +
    + +
    + altprintcommand=COMMAND +
    + +
    +

    + (Linux and Unix only) +

    + +

    + Use the command COMMAND to print a PostScript format file when the 'Print' button is clicked while the [Alt] modifier key is being held. (This is typically used for providing a print dialog, similar to when pressing [Alt]+'Print' in Windows and macOS.)

    + +

    + If this option is not specifically not set, the default command is KDE's graphical print dialog:

    + +
    + kprinter +
    +
    + +
    +
    + +

    + Paper Size

    + +
    +
    +
    + papersize=PAPERSIZE +
    + +
    +

    + (Platforms that use Tux Paint's internal PostScript generator — not Windows, macOS, BeOS, or Haiku.) +

    + +

    + Tell Tux Paint what size PostScript to generate. If none is specified, Tux Paint first checks your $PAPER environment variable, then the file /etc/papersize, then uses the the 'libpaper' library's default paper size.

    + +

    + Valid paper sizes include: letter, legal, tabloid, executive, note, statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, b0, b1, b2 b3, b4, 10x14, 11x17, halfletter, halfexecutive, halfnote, folio, quarto, ledger, archA, archB, archC, archD, archE, flsa, flse, csheet, dsheet, esheet.

    +
    + +
    +
    +
    + +
    +

    + Saving

    +
    +

    + Save Over Earlier Work

    + +
    +
    +
    + saveover=yes +
    + +
    +

    + This disables the "Save over the old version...?" prompt when saving an existing file. With this option, the older version will always be replaced by the new version, automatically.

    +
    + +
    + saveover=new +
    + +
    +

    + This also disables the "Save over the old version...?" prompt when saving an existing file. This option, however, will always save a new file, rather than overwrite the older version.

    +
    + +
    + saveover=ask +
    + +
    +

    + (This option is redundant, since this is the default.) + When saving an existing drawing, you will be first asked whether to save over the older version or not.

    +
    +
    +
    + +

    + Starting Out

    + +
    +
    +
    + startblank=yes +
    + +
    +

    + This causes Tux Paint to display a blank canvas when it first starts up, rather than loading the last image that was being edited.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "startblank=no" or "startlast=yes". In both cases, may be overridden by the command-line option "--startlast".

    +
    + +
    + newcolorslast=yes +
    + +
    +

    + Places the blank color options in the New dialog at the end, so that any Starters and/or Templates are shown first.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "newcolorslast=no" or "newcolorsfirst=yes". In both cases, may be overridden by the command-line option "--newcolorsfirst".

    +
    + +
    +
    + +

    + Save and Export Directories

    + +
    +
    +
    + savedir=DIRECTORY +
    + +
    +

    + Use this option to change where Tux Paint's "saved" directory/folder is located, which is where Tux Paint saves and opens pictures.

    + +

    + If you do not override it, the default location is:

    + +
      +
    • Linux & Unix — Under a hidden directory named ".tuxpaint" in your home directory (aka "~" or "$HOME")
      + Example: /home/username/.tuxpaint/saved/
    • + +
    • Windows — Inside a folder named "TuxPaint" in your "Application Data" folder.
      + Example: C:\Documents and Settings\Username\Application Data\TuxPaint\saved\
      +
    • + +
    • macOS — Inside a folder named "TuxPaint" in your "Application Support" folder.
      + Example: /Users/Username/Library/Application Support/TuxPaint/saved/
    • +
    + +

    + Note: When specifying a Windows drive (e.g., "H:\"), you must also specify a subdirectory.

    + +

    + Note: Prior to version 0.9.18, Tux Paint would also use the setting or default for "savedir" as the place to search for personal data files (brushes, stamps, starters and fonts). As of version 0.9.18, they may be specified separately (see the "datadir" option, below).

    + +

    + Example: savedir=Z:\tuxpaint\

    +
    + +
    + exportdir=DIRECTORY +
    + +
    +

    + Use this option to change where Tux Paint exports files — single images, or animated GIF slideshows — for external use.

    + +

    + If you do not override it, the default location is:

    + +
      +
    • Linux & Unix — If available, wherever your desktop environment is configured for pictures to be stored, based on your XDG (X Desktop Group) configuration. (Try running the command-line "xdg-user-dir PICTURES" to find out.)
      + Typically (in an English locale), this will be a "Pictures" subdirectory in your home directory (i.e., "$HOME/Pictures" aka "~/Pictures").
      + Tux Paint will fall back to using that typical directory, of no XDG configuration can be read, or nothing is set for "XDG_PICTURES_DIR".
    • +
    • Windows - "My Pictures" directory for each user (normaly "c:\Users\USERNAME\Pictures").
      You can directly open the folder as follows:
        +
      • Press "[Windows]+[R]" key to open "Run ..." dialogue.
      • +
      • Enter "Shell:My Pictures" in the text box and push [OK].
      -
    - -
    - orient=portrait -
    - -
    -

    - Swaps the width/height options given to Tux Paint, useful for rotating the window on portait displays, such as a tablet PC that's in tablet orientation.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "orient=landscape". In both cases, may be overridden by the command-line option "--orient=landscape".

    -
    - -
    - native=yes -
    - -
    -

    - When running Tux Paint in fullscreen mode, this assumes the screen's current resolution (overriding any "windowsize" option), as set by the operating system.

    -
    - -
    - buttonsize=SIZE -
    - -
    -

    - Set the pixel size of buttons in Tux Paint's user interface (overriding the default of "48"). Useful when using very high-density displays or coarse input devices, such as eye gaze trackers.

    - -

    - The SIZE value should be presented in pixels, and can be anything between 24 and 192, inclusive. Most buttons are square, and this will affect their width and height.

    - -

    - Note: If the chosen button size would cause the buttons to be too large for all required UI elements to appear under Tux Paint's chosen window size, the largest possible button size will be used. (A note will appear in stderr.)

    -
    - -
    - allowscreensaver=yes -
    - -
    -

    - By default, Tux Paint prevents your system's screensaver from starting up. You can override this by using the "allowscreensaver" option. Note: This requires version 1.2.12 or higher of the SDL library. (You can also do this by setting the "SDL_VIDEO_ALLOW_SCREENSAVER" environment variable on your system to "1".)

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "allowscreensaver=no" or "disablescreensaver=yes". In both cases, may be overridden by the command-line option "--disablescreensaver".

    -
    - -
    - nosound=yes -
    - -
    -

    - Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used to reenable sounds if they were disabled using this option.)

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nosound=no" or "sound=yes". In both cases, may be overridden by the command-line option "--sound".

    -
    - -
    - nostereo=yes -
    - -
    -

    - Disable stereo panning support. (Useful for users with hearing impairment in one ear, or places where a single speaker or headphone is being used.)

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nostereo=no" or "stereo=yes". In both cases, may be overridden by the command-line option "--stereo".

    -
    - -
    - noquit=yes -
    - -
    -

    - Disable the on-screen "Quit" button and prevent the [Escape] key from quitting Tux Paint.

    - -

    - Using the [Alt] + [F4] keyboard combination or clicking the window's close button (assuming you're not in fullscreen mode) still works to quit Tux Paint.

    - -

    - You can also use the following keyboard combination to quit: [Shift] + [Control] + [Escape].

    - -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "noquit=no" or "quit=yes". In both cases, may be overridden by the command-line option "--quit".

    -
    - -
    - noprint=yes -
    - -
    -

    - Disable the printing feature.

    -
    - -
    - printdelay=SECONDS -
    - -
    -

    - Restrict printing so that printing can occur only once every SECONDS seconds.

    - -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "printdelay=0". In both cases, may be overridden by the command-line option "--printdelay=0".

    -
    - -
    - printcommand=COMMAND -
    - -
    -

    - (Linux and Unix only) -

    - -

    - Use the command COMMAND to print a PostScript format file when the 'Print' button is clicked. If this option is not specifically not set, the default command is:

    - -
    - lpr -
    - -

    - Note: Versions of Tux Paint prior to 0.9.15 sent PNG format data to the print command (which defaulted to "pngtopnm | pnmtops | lpr").

    - -

    - If you set an alternative printcommand in the configuration file prior to version 0.9.15, you will need to change it.

    -
    - -
    - altprintcommand=COMMAND -
    - -
    -

    - (Linux and Unix only) -

    - -

    - Use the command COMMAND to print a PostScript format file when the 'Print' button is clicked while the [Alt] modifier key is being held. (This is typically used for providing a print dialog, similar to when pressing [Alt]+'Print' in Windows and macOS.)

    - -

    - If this option is not specifically not set, the default command is KDE's graphical print dialog:

    - -
    - kprinter -
    -
    - -
    - printcfg=yes -
    - -
    -

    - (Windows and macOS only) -

    - -

    - Tux Paint will use a printer configuration file when printing. Push the [Alt] key while clicking the 'Print' button in Tux Paint to cause a Windows print dialog window to appear.

    - -

    - (Note: This only works when not running Tux Paint in fullscreen mode.) Any configuration changes made in this dialog will be saved to the file "userdata/print.cfg" , and used again, as long as the "printcfg" option is set.

    - -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "printcfg=no" or "noprintcfg=yes". In both cases, may be overridden by the command-line option "--noprintcfg".

    -
    - -
    - altprint=always -
    - -
    -

    - This causes Tux Paint to always show the printer dialog (or, on Linux/Unix, run the "altprintcommand") when the 'Print' button is clicked. In other words, it's like clicking 'Print' while holding [Alt], except you don't need to hold [Alt] every time.

    -
    - -
    - altprint=never -
    - -
    -

    - This prevents Tux Paint from ever showing the printer dialog (or, on Linux/Unix, run the "altprintcommand") when the 'Print' button is clicked. In other words, it makes the [Alt] key have no effect when clicking the 'Print' button.

    -
    - -
    - altprint=mod -
    - -
    -

    - This is the normal, default behavior. Tux Paint shows a printer dialog (or, on Linux/Unix, runs the "altprintcommand"), when the [Alt] key is pressed while the 'Print' button is clicked. Clicking 'Print' without holding [Alt] prints without showing a dialog.

    -
    - -
    - papersize=PAPERSIZE -
    - -
    -

    - (Platforms that use Tux Paint's internal PostScript generator — not Windows, macOS, BeOS, or Haiku.) -

    - -

    - Tell Tux Paint what size PostScript to generate. If none is specified, Tux Paint first checks your $PAPER environment variable, then the file /etc/papersize, then uses the the 'libpaper' library's default paper size.

    - -

    - Valid paper sizes include: letter, legal, tabloid, executive, note, statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, b0, b1, b2 b3, b4, 10x14, 11x17, halfletter, halfexecutive, halfnote, folio, quarto, ledger, archA, archB, archC, archD, archE, flsa, flse, csheet, dsheet, esheet.

    -
    - -
    - nolockfile=yes -
    - -
    -

    - By default, Tux Paint uses what's known as a 'lockfile' to prevent it from being launched more than once in 30 seconds. (This is to avoid accidentally running multiple copies; for example, by double-clicking a single-click launcher, or simply impatiently clicking the icon multiple times.)

    - -

    - To make Tux Paint ignore the lockfile, allowing it to run again, even if it was just launched less than 30 seconds ago, enable this setting in the configuration file, or run Tux Paint with the --nolockfile option on the command-line.

    - -

    - By default, the lockfile is stored in "~/.tuxpaint/" under Linux and Unix, and "userdata\" under Windows.

    - -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nolockfile=no" or "lockfile=yes". In both cases, may be overridden by the command-line option "--lockfile".

    -
    - -
    - simpleshapes=yes -
    - -
    -

    - Disable the rotation step of the 'Shape' tool. Click, drag and release is all that will be needed to draw a shape.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "simpleshapes=no" or "complexshapes=yes". In both cases, may be overridden by the command-line option "--complexshapes".

    -
    - -
    - uppercase=yes -
    - -
    -

    - All text will be rendered only in uppercase (e.g., "Brush" will be "BRUSH"). Useful for children who can read, but who have only learned uppercase letters so far.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "uppercase=no" or "mixedcase=yes". In both cases, may be overridden by the command-line option "--mixedcase".

    -
    - -
    - grab=yes -
    - -
    -

    - Tux Paint will attempt to 'grab' the mouse and keyboard, so that the mouse is confined to Tux Paint's window, and nearly all keyboard input is passed directly to it.

    - -

    - This is useful to disable operating system actions that could get the user out of Tux Paint [Alt]-[Tab] window cycling, [Ctrl]-[Escape], etc. This is especially useful in fullscreen mode.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "grab=no" or "dontgrab=yes". In both cases, may be overridden by the command-line option "--dontgrab".

    -
    - -
    - noshortcuts=yes -
    - -
    -

    - This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, [Ctrl]-[N] for a new image, etc.)

    - -

    - This is useful to prevent unwanted commands from being activated by children who aren't experienced with keyboards.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "noshortcuts=no" or "shortcuts=yes". In both cases, may be overridden by the command-line option "--shortcuts".

    -
    - -
    - nowheelmouse=yes -
    - -
    -

    - This disables support for the wheel on mice that have it. (Normally, the wheel will scroll the selector menu on the right.)

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nowheelmouse=no" or "wheelmouse=yes". In both cases, may be overridden by the command-line option "--wheelmouse".

    -
    - -
    - nobuttondistinction=yes -
    - -
    -

    - Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse could also be used for clicking. In version 0.9.15, it was changed so that only the left mouse button worked, so as to not train children to use the wrong button.

    - -

    - However, for children who have trouble with the mouse, this distinction between the two or three buttons on a mouse can be disabled (returning Tux Paint to its old behavior) by using this option.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nobuttondistinction=no" or "buttondistinction=yes". In both cases, may be overridden by the command-line option "--buttondistinction".

    -
    - -
    - nofancycursors=yes -
    - -
    -

    - This disables the fancy mouse pointer shapes in Tux Paint, and uses your environment's normal mouse pointer.

    - -

    - In some enviornments, the fancy cursors cause problems. Use this option to avoid them.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nofancycursors=no" or "fancycursors=yes". In both cases, may be overridden by the command-line option "--fancycursors".

    -
    - -
    - hidecursor=yes -
    - -
    -

    - This completely hides the mouse pointer shapes in Tux Paint.

    - -

    - This is useful for touchscreen devices, such as tablet PCs.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "hidecursor=no" or "showcursor=yes". In both cases, may be overridden by the command-line option "--showcursor".

    -
    - -
    - nooutlines=yes -
    - -
    -

    - In this 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 very slow computers, or displayed on a remote X-Window display.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nooutlines=no" or "outlines=yes". In both cases, may be overridden by the command-line option "--outlines".

    -
    - -
    - sysfonts=yes -
    - -
    -

    - This option causes Tux Paint to attempt to load fonts (for use in the Text tool) from your operating system. Normally, Tux Paint will only load the ones that came bundled with Tux Paint.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "sysfonts=no" or "nosysfonts=yes". In both cases, may be overridden by the command-line option "--nosysfonts".

    -
    - -
    - alllocalefonts=yes -
    - -
    -

    - Prior to version 0.9.21, Tux Paint loaded all fonts in its own fonts directory, including locale-specific ones (e.g., the one for Tibetan, which had no latin characters). As of 0.9.21, the only font loaded from the locale-specific subdirectory, if any, is one matching the locale Tux Paint is running on.

    - -

    - To load all locale-specific fonts (the old behavior), set this option.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "alllocalefonts=no" or "currentlocalefont=yes". In both cases, may be overridden by the command-line option "--currentlocalefont".

    -
    - -
    - nostamps=yes -
    - -
    -

    - This option tells Tux Paint to not load any rubber stamp images, which in turn ends up disabling the Stamps tool.

    - -

    - This can speed up Tux Paint when it first loads up, and reduce memory usage while it's running. Of course, no stamps will be available at all.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nostamps=no" or "stamps=yes". In both cases, may be overridden by the command-line option "--stamps".

    -
    - -
    - nostampcontrols=yes -
    - -
    -

    - Some images in the Stamps tool can be mirrored, flipped, and/or have their size changed. This option disables the controls, and only provides the basic stamps.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nostampcontrols=no" or "stampcontrols=yes". In both cases, may be overridden by the command-line option "--stampcontrols".

    -
    - -
    - nomagiccontrols=yes -
    - -
    -

    - Some Magic tools have the option of acting like a paintbrush, or affecting the entire canvas at once. This option disables the controls, and only provides the default functionality (usually paint-mode).

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nomagiccontrols=no" or "magiccontrols=yes". In both cases, may be overridden by the command-line option "--magiccontrols".

    -
    - -
    - noshapecontrols=yes -
    - -
    -

    - Disable the control buttons shown when using the Shapes tool that allow changing how shapes are drawn — centered around the initial mouse click, or with a corner at the initial mouse click.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "noshapecontrols=no" or "shapecontrols=yes". In both cases, may be overridden by the command-line option "--shapecontrols".

    -
    - -
    - nolabel=yes -
    - -
    -

    - Disables the Label tool: the tool that allows text entry which can be edited later.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nolabel=no" or "label=yes". In both cases, may be overridden by the command-line option "--label".

    -
    - -
    - newcolorslast=yes -
    - -
    -

    - Places the blank color options in the New dialog at the end, so that any Starters and/or Templates are shown first.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "newcolorslast=no" or "newcolorsfirst=yes". In both cases, may be overridden by the command-line option "--newcolorsfirst".

    -
    - -
    - mirrorstamps=yes -
    - -
    -

    - For stamps that can be mirrored, this option sets them to their mirrored shape by default.

    - -

    - This can be useful for people who prefer things right-to-left, rather than left-to-right.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "mirrorstamps=no" or "dontmirrorstamps=yes". In both cases, may be overridden by the command-line option "--dontmirrorstamps".

    -
    - -
    - mouse-accessibility=yes -
    - -
    -

    - 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=yes -
    - -
    -

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

    -
    - -
    - onscreen-keyboard-layout=LAYOUTNAME -
    - -
    -

    - Selects the initial layout for the on-screen keyboard when using the Text and Label tools.
    Note: Using this option implies automatically onscreen-keyboard=yes, so setting both is redundant.

    -
    - -
    - onscreen-keyboard-disable-change=yes -
    - -
    -

    - Disables the possibility for changing the layout of the on-screen keyboard when using the Text and Label tools, useful for simplifying things for the small children.
    - Note: Using this option implies automatically onscreen-keyboard=yes, so setting both is redundant.

    -

    - Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "onscreen-keyboard-disable-change=no". In both cases, may be overridden by the command-line option "--onscreen-keyboard-disable-change=no".

    -
    - -
    - joystick-dev=N -
    - -
    -

    - Specify which joystick device should be used by Tux Paint. Default value is 0 (the first joystick).

    -
    - -
    - joystick-slowness=SPEED -
    - -
    -

    - Sets a delay at each axis motion, allowing to slow the joystick. Allowed values are from 0 to 500. Default value is 15.

    -
    - -
    - joystick-threshold=THRESHOLD -
    - -
    -

    - Sets the minimum level of axis motion to start moving the pointer. Allowed values are from 0 to 32766. Default value is 3200.

    -
    - -
    - joystick-maxsteps=STEPS -
    - -
    -

    - Sets the maximum pixels the pointer will move at once. Allowed values are from 1 to 7. Default value is 7.

    -
    - -
    - joystick-hat-timeout=MILLISECONDS -
    - -
    -

    - Sets the delay after wich the pointer will start moving automatically if the hat is keeped pushed. Allowed values are from 0 to 3000. Default value is 1000.

    -
    - -
    - joystick-hat-slowness=SPEED -
    - -
    -

    - Sets a delay at each automatic motion, allowing to slow the speed of the hat. Allowed values are from 0 to 500. Default value is 15.

    -
    - -
    - joystick-btn-escape=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be used to generate a escape event. Useful to dismiss dialogs and quit.

    -
    - -
    - joystick-btn-brush=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to select the brush tool.

    -
    - -
    - joystick-btn-stamp=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to select the stamp tool.

    -
    - -
    - joystick-btn-lines=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to select the lines tool.

    -
    - -
    - joystick-btn-shapes=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to select the shapes tool.

    -
    - -
    - joystick-btn-text=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to select the text tool.

    -
    - -
    - joystick-btn-label=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to select the label tool.

    -
    - -
    - joystick-btn-magic=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to select the magic tool.

    -
    - -
    - joystick-btn-undo=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to invoke the undo tool.

    -
    - -
    - joystick-btn-redo=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to select redo tool.

    -
    - -
    - joystick-btn-eraser=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to select eraser tool.

    -
    - -
    - joystick-btn-new=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to launch the dialog for creating a new drawing.

    -
    - -
    - joystick-btn-open=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to launch the dialog for opening an existing drawing.

    -
    - -
    - joystick-btn-save=BUTTON NUMBER -
    - -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to save the drawing.

    -
    + + +
  • macOS — TBD! +
  • + + +

    + Note: When the defaults are used, a new "TuxPaint" subdirectory will be created and used. (e.g., "~/Pictures/TuxPaint") When the "--exportdir" option is used, the exact path specified will be used (no "TuxPaint" subdirectory is created).

    +

    + The directory itself (e.g., "~/Pictures/TuxPaint") will be created, if it doesn't exist.

    +

    + If the parent directory (e.g., "~/Pictures/TuxPaint") also does not exist, Tux Paint will attempt to create it as well (but not any directories higher than that).

    + +

    + Example: exportdir=/home/penguin/TuxPaintExports

    + + +
    +
    + +

    + More Saving Options

    + +
    +
    +
    + nosave=yes +
    + +
    +

    + This disables Tux Paint's ability to save files (and therefore disables the on-screen "Save" button). It can be used in situations where the program is only being used for fun, or in a test environment.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nosave=no" or "save=yes". In both cases, may be overridden by the command-line option "--save".

    +
    + +
    + autosave=yes +
    + +
    +

    + This prevents Tux Paint from asking whether you want to save the current picture when quitting, and assumes you do.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "autosave=no" or "noautosave=yes". In both cases, may be overridden by the command-line option "--noautosave".

    +
    -
    - joystick-btn-pgsetup=BUTTON NUMBER -
    +
    +
    +
    -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to launch the page setup dialog for printing.

    -
    +
    +

    + Data

    +
    +

    + Lockfile

    + +
    +
    +
    + nolockfile=yes +
    + +
    +

    + By default, Tux Paint uses what's known as a 'lockfile' to prevent it from being launched more than once in 30 seconds. (This is to avoid accidentally running multiple copies; for example, by double-clicking a single-click launcher, or simply impatiently clicking the icon multiple times.)

    + +

    + To make Tux Paint ignore the lockfile, allowing it to run again, even if it was just launched less than 30 seconds ago, enable this setting in the configuration file, or run Tux Paint with the --nolockfile option on the command-line.

    + +

    + By default, the lockfile is stored in "~/.tuxpaint/" under Linux and Unix, and "userdata\" under Windows.

    + +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nolockfile=no" or "lockfile=yes". In both cases, may be overridden by the command-line option "--lockfile".

    +
    + +
    +
    + +

    + Data Directory

    + +
    +
    +
    + datadir=DIRECTORY +
    + +
    +

    + Use this option to change where Tux Paint looks for personal data files (brushes, stamps, starters, templates, and fonts specific to the current user).

    + +

    + Tux Paint will search for subdirectories/subfolders named "brushes", "stamps", "starters", "templates", and "fonts" under the specified data directory.

    + +

    + If you do not override it, the default location is:

    + +
      +
    • Linux & Unix — Under a hidden directory named ".tuxpaint" in your home directory (aka "~" or "$HOME")
      + Example: /home/username/.tuxpaint/brushes/
    • + +
    • Windows — Inside a folder named "TuxPaint" in your "Application Data" folder.
      + Example: C:\Documents and Settings\Username\Application Data\TuxPaint\brushes\
    • + +
    • macOS — Inside a folder named "TuxPaint" in your "Application Support" folder.
      + Example: /Users/Username/Library/Application Support/TuxPaint/brushes/
    • +
    -
    - joystick-btn-print=BUTTON NUMBER -
    +

    + Note: Prior to version 0.9.18, Tux Paint would use the same setting or default as for "savedir" to search for data files. As of version 0.9.18, they may be specified separately.

    -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to print.

    -
    +

    + Note: When specifying a Windows drive (e.g., "H:\"), you must also specify a subdirectory.

    -
    - joystick-buttons-ignore=BUTTON1,BUTTON2,... -
    +

    + Example: datadir=/home/johnny/tuxpaint-data/

    + -
    -

    - A set of joystick button numbers, as seen by SDL, that should be ignored. Otherwise, unless they are used by one of the "joystick-btn-" options above, buttons will be seen as a mouse left-click.

    -
    +
    +
    -
    - stampsize=SIZE -
    +

    + Color Palette File

    -
    -

    - Use this option to force Tux Paint to set the starting size of all stamps. The SIZE value should be between 0 (smallest) and 10 (largest). The size is relative to the available sizes of the stamp, which depends on the stamp itself, and Tux Paint's current canvas size.

    +
    +
    +
    + colorfile=FILENAME +
    -

    - Specify "default" to let Tux Paint decide (its standard behavior).

    -
    +
    +

    + You may override Tux Paint's default color palette by creating a plain ASCII text file that describes the colors you want, and pointing to that file using the "colorfile" option.

    -
    - keyboard=yes -
    +

    + The file should list one color per line. Colors are defined in terms of their Red, Green and Blue values, each from 0 (off) to 255 (brightest). (For more information, try Wikipedia's "RGB color model" article.)

    -
    -

    - This allows the keyboard arrow keys to be used to control the mouse pointer. (e.g., for mouseless environments, or handicapped/accessibility purposes)

    +

    + Colors may be listed using three decimal numbers (e.g., "255 68 136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., "#ff4488" or "#F48").

    -

    - Features:

    +

    + After the color definition (on the same line) you may enter text to describe the color. Tux will display this text when the color is clicked. (For example, "#FFF White as snow.")

    -
      -
    • Fine movement within canvas, or coarse movement if Shift is held.
    • +

      + As an example, you can see the default colors currently used in Tux Paint in: "default_colors.txt".

      -
    • Coarse movement within tool button areas.
    • +

      + NOTES: You must separate decimal values with spaces, and begin hexadecimal values with a pound/number-sign character ("#"). In 3-digit hexadecimal, each digit is used for both the high and low halves of the byte, so "#FFF" is the same as "#FFFFFF", not "#F0F0F0".

      +
    +
    + + -
  • Key controls: + +

    + Note: When the defaults are used, a new "TuxPaint" subdirectory will be created and used. (e.g., "~/Pictures/TuxPaint") When the "--exportdir" option is used, the exact path specified will be used (no "TuxPaint" subdirectory is created).

    +

    + The directory itself (e.g., "~/Pictures/TuxPaint") will be created, if it doesn't exist.

    +

    + If the parent directory (e.g., "~/Pictures/TuxPaint") also does not exist, Tux Paint will attempt to create it as well (but not any directories higher than that).

    + +

    + Example: exportdir=/home/penguin/TuxPaintExports

    + + + + + +

    + More Saving Options

    + +
    +
    +
    + nosave=yes +
    + +
    +

    + This disables Tux Paint's ability to save files (and therefore disables the on-screen "Save" button). It can be used in situations where the program is only being used for fun, or in a test environment.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nosave=no" or "save=yes". In both cases, may be overridden by the command-line option "--save".

    +
    + +
    + autosave=yes +
    + +
    +

    + This prevents Tux Paint from asking whether you want to save the current picture when quitting, and assumes you do.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "autosave=no" or "noautosave=yes". In both cases, may be overridden by the command-line option "--noautosave".

    +
    -
    - joystick-btn-pgsetup=BUTTON NUMBER -
    +
    +
    + -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to launch the page setup dialog for printing.

    -
    +
    +

    + Data

    +
    +

    + Lockfile

    + +
    +
    +
    + nolockfile=yes +
    + +
    +

    + By default, Tux Paint uses what's known as a 'lockfile' to prevent it from being launched more than once in 30 seconds. (This is to avoid accidentally running multiple copies; for example, by double-clicking a single-click launcher, or simply impatiently clicking the icon multiple times.)

    + +

    + To make Tux Paint ignore the lockfile, allowing it to run again, even if it was just launched less than 30 seconds ago, enable this setting in the configuration file, or run Tux Paint with the --nolockfile option on the command-line.

    + +

    + By default, the lockfile is stored in "~/.tuxpaint/" under Linux and Unix, and "userdata\" under Windows.

    + +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nolockfile=no" or "lockfile=yes". In both cases, may be overridden by the command-line option "--lockfile".

    +
    + +
    +
    + +

    + Data Directory

    + +
    +
    +
    + datadir=DIRECTORY +
    + +
    +

    + Use this option to change where Tux Paint looks for personal data files (brushes, stamps, starters, templates, and fonts specific to the current user).

    + +

    + Tux Paint will search for subdirectories/subfolders named "brushes", "stamps", "starters", "templates", and "fonts" under the specified data directory.

    + +

    + If you do not override it, the default location is:

    + +
      +
    • Linux & Unix — Under a hidden directory named ".tuxpaint" in your home directory (aka "~" or "$HOME")
      + Example: /home/username/.tuxpaint/brushes/
    • + +
    • Windows — Inside a folder named "TuxPaint" in your "Application Data" folder.
      + Example: C:\Documents and Settings\Username\Application Data\TuxPaint\brushes\
    • + +
    • macOS — Inside a folder named "TuxPaint" in your "Application Support" folder.
      + Example: /Users/Username/Library/Application Support/TuxPaint/brushes/
    • +
    -
    - joystick-btn-print=BUTTON NUMBER -
    +

    + Note: Prior to version 0.9.18, Tux Paint would use the same setting or default as for "savedir" to search for data files. As of version 0.9.18, they may be specified separately.

    -
    -

    - Selects the joystick button number, as seen by SDL, that will be a shortcut to print.

    -
    +

    + Note: When specifying a Windows drive (e.g., "H:\"), you must also specify a subdirectory.

    -
    - joystick-buttons-ignore=BUTTON1,BUTTON2,... -
    +

    + Example: datadir=/home/johnny/tuxpaint-data/

    + -
    -

    - A set of joystick button numbers, as seen by SDL, that should be ignored. Otherwise, unless they are used by one of the "joystick-btn-" options above, buttons will be seen as a mouse left-click.

    -
    +
    +
    -
    - stampsize=SIZE -
    +

    + Color Palette File

    -
    -

    - Use this option to force Tux Paint to set the starting size of all stamps. The SIZE value should be between 0 (smallest) and 10 (largest). The size is relative to the available sizes of the stamp, which depends on the stamp itself, and Tux Paint's current canvas size.

    +
    +
    +
    + colorfile=FILENAME +
    -

    - Specify "default" to let Tux Paint decide (its standard behavior).

    -
    +
    +

    + You may override Tux Paint's default color palette by creating a plain ASCII text file that describes the colors you want, and pointing to that file using the "colorfile" option.

    -
    - keyboard=yes -
    +

    + The file should list one color per line. Colors are defined in terms of their Red, Green and Blue values, each from 0 (off) to 255 (brightest). (For more information, try Wikipedia's "RGB color model" article.)

    -
    -

    - This allows the keyboard arrow keys to be used to control the mouse pointer. (e.g., for mouseless environments, or handicapped/accessibility purposes)

    +

    + Colors may be listed using three decimal numbers (e.g., "255 68 136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., "#ff4488" or "#F48").

    -

    - Features:

    +

    + After the color definition (on the same line) you may enter text to describe the color. Tux will display this text when the color is clicked. (For example, "#FFF White as snow.")

    -
      -
    • Fine movement within canvas, or coarse movement if Shift is held.
    • +

      + As an example, you can see the default colors currently used in Tux Paint in: "default_colors.txt".

      -
    • Coarse movement within tool button areas.
    • +

      + NOTES: You must separate decimal values with spaces, and begin hexadecimal values with a pound/number-sign character ("#"). In 3-digit hexadecimal, each digit is used for both the high and low halves of the byte, so "#FFF" is the same as "#FFFFFF", not "#F0F0F0".

      +
    + +
    + -
  • Key controls: + +

    + Remarque :Quand les réglages par défaut sont utilisés, un nouveau sous-répertoire "TuxPaint" sera créé puis utilisé(par ex "~/Images/TuxPaint"). Quand l'option "--exportdir" est utilisée, le chemin exact qui a été spécifié sera utilisé (pas sous-répertoire "TuxPaint" créé).

    +

    + Le répertoire lui-même (par ex. "~/Images/TuxPaint") sera créé, s'il n'existe pas.

    +

    + Si le répertoire parent (par ex "~/Images/TuxPaint") n'existe pas non plus, Tux Paint essayera aussi de le créer (mais de répertoire plus haut que celui-là).

    + +

    + Exemple: exportdir=/home/penguin/TuxPaintExports

    + + + + + +

    + More Saving Options

    + +
    +
    +
    + nosave=yes +
    + +
    +

    + Ceci désactive la possibilité de sauvegarder les fichiers par Tux Paint (et par conséquent ôte le bouton "Sauvegarder" sur l'écran). On peut l'utiliser dans le cas où le programme est utilisé juste pour le fun, ou dans un environnement de tests.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nosave=no" or "save=yes". In both cases, may be overridden by the command-line option "--save".

    +
    + +
    + autosave=yes +
    + +
    +

    + Ceci empêche Tux Paint de vous demander si vous voulez sauvegarder l'image quand vous quittez, et suppose que vous le faites.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "autosave=no" or "noautosave=yes". In both cases, may be overridden by the command-line option "--noautosave".

    +
    -
    - joystick-btn-pgsetup=BUTTON NUMBER -
    +
    +
    + -
    -

    - Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera un raccourci pour sélectionner lancer la boîte de dialogue pour le réglage de l'imprssion.

    -
    +
    +

    + Data

    +
    +

    + Lockfile

    + +
    +
    +
    + nolockfile=yes +
    + +
    +

    + Par défaut, Tux Paint utilise ce qu'on appelle un «fichier de verrouillage» pour éviter qu'il ne soit lancé plus d'une fois toutes les 30 secondes. (Ceci permet d'éviter d'exécuter accidentellement plusieurs copies; par exemple, en double-cliquant sur un lanceur fonctionnant avec un seul clic, ou en cliquant simplement avec impatience plusieurs fois sur l'icône.)

    + +

    + Pour que Tux Paint ignore le fichier de verrouillage, lui permettant de s'exécuter à nouveau, même s'il vient d'être lancé il y a moins de 30 secondes, activez ce paramètre dans le fichier de configuration ou exécutez Tux Paint avec l'option '--nolockfile ' en ligne de commande.

    + +

    + Par défaut, le fichier de verrouillage est stocké dans "~/.tuxpaint/" sous Linux et Unix, et "userdata\" sous Windows.

    + +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nolockfile=no" or "lockfile=yes". In both cases, may be overridden by the command-line option "--lockfile".

    +
    + +
    +
    + +

    + Data Directory

    + +
    +
    +
    + datadir=DIRECTORY +
    + +
    +

    + Utilisez cette option pour changer l'endroit où Tux Paint ira rechercher les fichiers de données personnelles (pinceaux, tampons, images de démarrage, modèles et fontes spécifiques pour l'utilisateur actuel).

    + +

    + Tux Paint va chercher des sous-répertoires nommés "brushes", "stamps", "starters", "templates", et "fonts" sous le répertoire spécifié.

    + +

    + Si vous ne le changez pas, l' emplacement par défaut est :

    + +
      +
    • Linux & Unix - Sous un répertoire caché nommé ".tuxpaint" dans votre répertoire personnel (aka "~" ou "$HOME")
      + Exemple: /home/username/.tuxpaint/brushes/
    • + +
    • Windows - Dans un dossier nommé "TuxPaint" dans votre dossier "Application Data".
      + Exemple: C:\Documents and Settings\Username\Application Data\TuxPaint\brushes\
    • + +
    • macOS - Dans un dossier nommé "TuxPaint" dans votre dossier "Application Support".
      + Exemple: /Users/Username/Library/Application Support/TuxPaint/brushes/
    • +
    -
    - joystick-btn-print=BUTTON NUMBER -
    +

    + Remarque :Avant la version 0.9.18, Tux Paint utlisait les mêmes réglages que "savedir" pour chercher les fichiers de données. Depuis la version 0.9.18, ils peuvent être spécifiés séparément.

    -
    -

    - Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera un raccourci pour sélectionner print.

    -
    +

    + Remarque : lorsque vous spécifiez un lecteur Windows (par ex. "H:\"), vous devez également spécifier un sous-répertoire.

    -
    - joystick-buttons-ignore=BUTTON1,BUTTON2,... -
    +

    + Exemple: datadir=/home/johnny/tuxpaint-data/

    + -
    -

    - Un ensemble de numéros de boutons du joystick, comme vu par SDL, qui doit être ignoré. Sinon, à moins qu'ils ne soient utilisés par l'une des joptions "joystick-btn-" ci-dessus, les boutons seront considérés comme un clic gauche de la souris.

    -
    +
    +
    -
    - stampsize=SIZE -
    +

    + Color Palette File

    -
    -

    - Utilisez cette option pour forcer Tux Paint à définir la taille de départ de tous les tampons. La valeur SIZE doit être comprise entre 0 (le plus petit) et 10 (le plus grand). La taille est relative aux tailles disponibles du tampon, qui dépendent du tampon lui-même, et de la taille actuelle de la toile de Tux Paint.

    +
    +
    +
    + colorfile=FILENAME +
    -

    - Spécifiez "default" pour laisser Tux Paint décider (c'est un comportement standard).

    -
    +
    +

    + Vous pouvez remplacer la palette de couleurs par défaut de Tux Paint en créant un fichier texte ASCII simple qui décrit les couleurs souhaitées et en pointant vers ce fichier à l'aide de l'option "colorfile".

    -
    - keyboard=yes -
    +

    + Le fichier doit répertorier une couleur par ligne. Les couleurs sont définies en fonction de leurs valeurs Rouge, Vert et Bleu, chacune comprise entre 0 (désactivée) et 255 (la plus intense). (Pour plus d'informations, consultez l'article de Wikipedia sur le modèle de couleur RVB .)

    -
    -

    - Cela permet d'utiliser les touches fléchées du clavier pour contrôler le pointeur de la souris. (Par exemple, pour les environnements sans souris, ou en cas de problèmes de handicap /d'accessibilité)

    +

    + Les couleurs peuvent être listées en utilisant trois nombres décimaux (par exemple, "255 68 136") ou un 'triplet' hexadécimal de 6 ou 3 chiffres (par exemple, " #ff4488" ou "#F48").

    -

    - Caractéristiques :

    +

    + Après la définition de la couleur (sur la même ligne), vous pouvez saisir du texte pour décrire la couleur. Tux affichera ce texte lorsque la couleur sera cliquée. (Par exemple, "#FFF Blanc comme neige.")

    -
      -
    • Mouvement fin sur la toile, ou rapide si Shift est maintenu.
    • +

      + A titre d'exemple, vous pouvez voir les couleurs par défaut actuellement utilisées dans Tux Paint dans : "default_colors.txt".

      -
    • Mouvement rapide dans la zone des boutons d'outils.
    • +

      + REMARQUES : Vous devez séparer les valeurs décimales par des espaces et commencer les valeurs hexadécimales par un caractère dièse / signe dièse (" #"). En hexadécimal à 3 chiffres, chaque chiffre est utilisé à la fois pour les moitiés haute et basse de l'octet, donc "#FFF" est identique à " #FFFFFF", mais pas à "#F0F0F0".

      +
    + +
    + -
  • Touches de contrôle : + +

    + Nota: Cando se empregan os valores predeterminados, crearase e usarase un novo subdirectorio «TuxPaint». (p. ex.: «~/Imaxes/TuxPaint») Cando se usa a opción «--exportdir», empregarase a ruta exacta especificada (non se crea ningún subdirectorio «TuxPaint»).

    +

    + O directorio en si (p. ex.: «~/Imaxes/TuxPaint») crearase, se non existe.

    +

    + Se o directorio pai (por exemplo, «~/Imaxes/TuxPaint») tampouco existe, Tux Paint tentará crealo tamén (pero non ningún directorio superior a ese).

    + +

    + Exemplo: exportdir=/home/penguin/TuxPaintExports

    + + + + + +

    + More Saving Options

    + +
    +
    +
    + nosave=yes +
    + +
    +

    + Isto desactiva a capacidade de Tux Paint para gardar ficheiros (e, polo tanto, desactiva o botón «Gardar» na pantalla). Pode usarse en situacións nas que o programa só se usa para divertirse ou nun contorno de proba.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nosave=no" or "save=yes". In both cases, may be overridden by the command-line option "--save".

    +
    + +
    + autosave=yes +
    + +
    +

    + Isto impide a Tux Paint preguntar se quere gardar a imaxe actual ao saír e supón que si.

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "autosave=no" or "noautosave=yes". In both cases, may be overridden by the command-line option "--noautosave".

    +
    -
    - joystick-btn-pgsetup=NÚMERO DE BOTÓN -
    +
    +
    + -
    -

    - Selecciona o número do botón do joystick, como o ve SDL, que será un atallo a inicia o diálogo de configuración da páxina para imprimir.

    -
    +
    +

    + Data

    +
    +

    + Lockfile

    + +
    +
    +
    + nolockfile=yes +
    + +
    +

    + De xeito predeterminado, Tux Paint usa o que se coñece como «ficheiro de bloqueo» para evitar que se inicie máis dunha vez en 30 segundos. (Isto é para evitar executar accidentalmente varias copias; por exemplo, premendo dúas veces nun iniciador dun só clic ou simplemente premendo impacientemente na icona varias veces.)

    + +

    + Para facer que Tux Paint ignore o ficheiro de bloqueo, permitindo que se execute de novo, aínda que se lanzase hai menos de 30 segundos, active este axuste no ficheiro de configuración ou execute Tux Paint coa opción --nolockfile na liña de ordes.

    + +

    + De xeito predeterminado, o ficheiro de bloqueo almacénase en «~/.tuxpaint/» en Linux e Unix e en «userdata\» en Windows.

    + +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nolockfile=no" or "lockfile=yes". In both cases, may be overridden by the command-line option "--lockfile".

    +
    + +
    +
    + +

    + Data Directory

    + +
    +
    +
    + datadir=DIRECTORIO +
    + +
    +

    + Use esta opción para cambiar onde Tux Paint busca ficheiros de datos persoais (pinceis, selos, imaxes de comezo, modelos e tipos de letra específicos do usuario actual).

    + +

    + Tux Paint buscará subdirectorios/subcartafoles chamados «brushes», «stamps», «starters», «templates», «fonts» no directorio de datos especificado.

    + +

    + Se non o anula, a ubicación predeterminada é:

    + +
      +
    • Linux e Unix: baixo un directorio agochado chamado «.tuxpaint» no seu directorio persoal (tamén coñecido como «~» ou «$HOME»)
      + Exemplo: /home/username/.tuxpaint/brushes/
    • + +
    • Windows: Dentro un cartafol chamado «TuxPaint» no seu cartafol «Application Data».
      + Exemplo: C:\Documents and Settings\Username\Application Data\TuxPaint\brushes\
    • + +
    • macOS: Dentro un cartafol chamado «TuxPaint» no seu cartafol «Application Support».
      + Exemplo: /Users/Username/Library/Application Support/TuxPaint/brushes/
    • +
    -
    - joystick-btn-print=NÚMERO DE BOTÓN -
    +

    + Nota: Antes da versión 0.9.18, Tux Paint usaba o mesmo axuste ou predeterminado que para «savedir» para buscar ficheiros de datos. A partir da versión 0.9.18, pódense especificar por separado.

    -
    -

    - Selecciona o número do botón do joystick, como o ve SDL, que será un atallo a imprimir.

    -
    +

    + Nota: Ao especificar unha unidade de Windows (por exemplo, «H:\»), tamén debe especificar un subdirectorio.

    -
    - joystick-buttons-ignore=BOTÓN1,BOTÓN2,... -
    +

    + Exemplo: datadir=/home/johnny/tuxpaint-data/

    + -
    -

    - Un conxunto de números de botóns do mando (joystick), como se ve en SDL, que deben ignorarse. Se non, a menos que sexan utilizados por unha das opcións «joystick-btn-» anteriores, os botóns veranse como un botón esquerdo do rato.

    -
    +
    +
    -
    - stampsize=TAMAÑO -
    +

    + Color Palette File

    -
    -

    - Use esta opción para forzar a Tux Paint a estabelecer o tamaño inicial de todos os selos. O valor TAMAÑO debería estar entre 0 (máis pequeno) e 10 (máis grande). O tamaño é relativo aos tamaños dispoñíbeis do selo, que depende do selo en si, e do tamaño actual do lenzo de Tux Paint.

    +
    +
    +
    + colorfile=NOME_DE_FICHEIRO +
    -

    - Especifique «default» para que Tux Paint decida (o seu comportamento estándar).

    -
    +
    +

    + Pode anular a paleta de cores predeterminada de Tux Paint creando un ficheiro de texto ASCII simple que describa as cores que quere e apuntando a ese ficheiro usando a opción «colorfile».

    -
    - keyboard=yes -
    +

    + O ficheiro debería incluír unha cor por liña. As cores defínense en función dos seus valores vermello, verde e azul, cada un de 0 (apagado) a 255 (máis brillante). (Para obter máis información, vexa o artigo «Modelo de cor RGB (en inglés) de Wikipedia).

    -
    -

    - Isto permite empregar as teclas de frecha do teclado para controlar o punteiro do rato. (por exemplo, para contornos sen rato ou persoas con discapacidade ou problemas de accesibilidade)

    +

    + As cores pódense enumerar usando tres números decimais (por exemplo, «255 68 136») ou un «triplete» hexadecimal de 6 ou 3 díxitos de longo (por exemplo, «#ff4488» ou «#F48»).

    -

    - Funcionalidades:

    +

    + Após a definición da cor (na mesma liña) pode introducir texto para describir a cor. Tux amosará este texto cando se prema na cor. (Por exemplo, «#FFF Branco coma a neve.»)

    -
      -
    • Movemento fino dentro do lenzo ou movemento groseiro se se mantén premida Shift.
    • +

      + Como exemplo, pode ver as cores predeterminadas empregadas actualmente en Tux Paint en: «default_colors.txt».

      -
    • Movemento groseiro dentro das áreas dos botóns da ferramenta.
    • +

      + NOTAS: Debe separar os valores decimais con espazos e comezar os valores hexadecimais cun carácter de libra/signo de númeral («#»). En hexadecimais de 3 díxitos, cada díxito úsase tanto para a metade alta como para a baixa do byte, polo que «#FFF» é o mesmo que «#FFFFFF» e non que «#F0F0F0».

      +
    + +
    + -
  • Principais controis: + +

    + 注:標準の設定を用いる場合は、画像用のディレクトリにサブディレクトリ "TuxPaint" が作成されます。(例:"~/Pictures/TuxPaint")一方、"--exportdir" オプションを用いると、指定されたパスがそのまま使用されます(サブディレクトリ "TuxPaint" は作成されません)。

    +

    + ディレクトリ(例: "~/Pictures/TuxPaint")が存在しない場合は新たに作成されます。

    +

    + 一つ上の親ディレクトリ(例:"~/Pictures/TuxPaint")が存在しない場合もディレクトリの作成を試みますが、それ以上の階層のディレクトリを作成することはありません。

    + +

    + 例:exportdir=/home/penguin/TuxPaintExports

    + + + + + +

    + More Saving Options

    + +
    +
    +
    + nosave=yes +
    + +
    +

    + 絵の保存ができないようにします("セーブ" ボタンも無効になります)。一時的なお遊びに使う場合や、テスト環境で使えるオプションです。

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nosave=no" or "save=yes". In both cases, may be overridden by the command-line option "--save".

    +
    + +
    + autosave=yes +
    + +
    +

    + プログラムを終了するときに、絵を保存するかどうか尋ねずに、自動的に保存します。

    +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "autosave=no" or "noautosave=yes". In both cases, may be overridden by the command-line option "--noautosave".

    +
    -
    - joystick-btn-pgsetup=BUTTON NUMBER -
    +
    +
    + -
    -

    - ジョイスティックの BUTTON NUMBER で設定したボタンに "印刷設定ダイアログ" へのショートカットを割り当てます。

    -
    +
    +

    + Data

    +
    +

    + Lockfile

    + +
    +
    +
    + nolockfile=yes +
    + +
    +

    + 標準では、タックスペイントは「ロックファイル」と呼ばれるものを使用して、30秒間に1回以上起動できないようになっています。これは、シングルクリックのランチャーをダブルクリックしたり、アイコンをせわしなく何度もクリックしたりして、誤って複数回起動してしまうことを防ぐためです。

    + +

    + ロックファイルを無視して、起動してから30秒以内であっても再びすぐに実行できるようにするには、設定ファイルでこの設定を有効にするか、コマンドラインで --nolockfile オプションを指定して Tux Paint を実行してください。

    + +

    + 標準では、Linux および Unix では "~/.tuxpaint/" に、Windows では "userdata\" にロックファイルが保存されます。

    + +

    + Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nolockfile=no" or "lockfile=yes". In both cases, may be overridden by the command-line option "--lockfile".

    +
    + +
    +
    + +

    + Data Directory

    + +
    +
    +
    + datadir=DIRECTORY +
    + +
    +

    + 個人用データファイル(ペイントブラシ、スタンプ、スターター、テンプレート、個人用のフォント)を検索する場所を変更します。

    + +

    + Tux Paint は、ここで指定されたディレクトリ以下の "brushes", "stamps", "starters", "templates", and "fonts" という名前のサブディレクトリをそれぞれ検索します。

    + +

    + 特に設定していなければ、標準のディレクトリは次の場所にあります:

    + +
      +
    • Linux および Unix — ユーザーのホームディレクトリ("~" または "$HOME")にある隠しディレクトリ ".tuxpaint" 以下
      + 例:/home/username/.tuxpaint/brushes/
    • + +
    • Windows — ユーザーごとの "Application Data" フォルダーにある "TuxPaint" フォルダー以下
      + 例:C:\Documents and Settings\Username\Application Data\TuxPaint\brushes\
    • + +
    • macOS — ユーザーごとの "Application Support" フォルダーにある "TuxPaint" フォルダー以下
      + 例:/Users/Username/Library/Application Support/TuxPaint/brushes/
    • +
    -
    - joystick-btn-print=BUTTON NUMBER -
    +

    + 注:バージョン 0.9.18 以前は "savedir" の指定と同じディレクトリを使用していました。0.9.18 以降では個別に設定できるようになりました。

    -
    -

    - ジョイスティックの BUTTON NUMBER で設定したボタンに "「いんさつ」" へのショートカットを割り当てます。

    -
    +

    + 注:Windowsのドライブ(例:"H:\")を指定する際は、サブディレクトリも指定する必要があります。

    -
    - joystick-buttons-ignore=BUTTON1,BUTTON2,... -
    +

    + 例:datadir=/home/johnny/tuxpaint-data/

    + -
    -

    - 無効にするジョイスティックのボタンの番号を指定します。何も指定しない場合、上記の "joystick-btn-" オプションで機能が設定されたボタン以外は、マウスの左ボタンと同じ動作になります。

    -
    +
    +
    -
    - stampsize=SIZE -
    +

    + Color Palette File

    -
    -

    - すべてのスタンプの初期の大きさを 0(最小)から 10(最大)の間で設定します。SIZE の値はスタンプ自体の大きさとタックスペイントのキャンバスサイズによって決まる大きさに対する相対的な指定になります。

    +
    +
    +
    + colorfile=FILENAME +
    -

    - SIZE の値に default を指定すると、Tux Paint がスタンプの大きさを自動的に決定します。(これが標準の動作です)

    -
    +
    +

    + お好みのカラーパレットを記述した簡単なテキストファイルを作成して、そのファイル名を "colorfile" オプションで指定すれば、標準のカラーパレットを置き換えることができます。

    -
    - keyboard=yes -
    +

    + ファイルは、1行ごとに1色のリストです。色は RGB の形式で、各色 0 から 255 の範囲で指定します。(詳細は、Wikipedia の "RGB" のページを参照して下さい。)

    -
    -

    - キーボードの矢印キーによるマウスポインターの操作が行えるようにします(マウスが使えない場合や、マウス操作が難しいユーザー向けの機能です)

    +

    + 各行の色は、3つの十進数の組み(例:"255 68 136")、あるいは、3つの16 進数の組からなる6桁または3桁の表記(例:"#ff4488" または "#F48”)で指定します。

    -

    - 使用方法:

    +

    + 色の定義に続いて、色の説明を同じ行に書いておけば、カラーパレットでその色をクリックしたときに Tux がその説明文を表示します。(例:"#FFF 雪のような白。")

    -
      -
    • キャンバスエリアでは、通常はなめらかに、Shift キーを押しながらでは飛び飛びにカーソルが動きます。
    • +

      + 参考となる例として、標準で使われているカラーパレット "default_colors.txt" をご確認ください。

      -
    • ツールボタンのエリアでは、飛び飛びにカーソルが動きます。
    • +

      + 注:十進数の値は空白文字で区切って記載し、16進数の値は "#" で始める必要があります。3桁の16進数では、各桁がバイトの上位と下位の両方に使用されるため、"#FFF" は "#F0F0F0" ではなく "#FFFFFF" を意味します。

      +
    + +
    + -
  • 各キーの動作: