diff --git a/docs/CHANGES.txt b/docs/CHANGES.txt index b114508ba..fec433b79 100644 --- a/docs/CHANGES.txt +++ b/docs/CHANGES.txt @@ -36,6 +36,10 @@ $Id$ (Ref: https://github.com/haikuports/haikuports/issues/3045) Gerasim Troeglazov <3dEyes@gmail.com> + * Documentation updates + --------------------- + * Cleaned up HTML code of HTML-based documentation. + * Bug Fixes --------- * Mended issue where stamp descriptions were not loading diff --git a/docs/en/EXTENDING.txt b/docs/en/EXTENDING.txt index 9bd8a7042..67b672789 100644 --- a/docs/en/EXTENDING.txt +++ b/docs/en/EXTENDING.txt @@ -5,7 +5,7 @@ Copyright (c) 2002-2020 by various contributors; see AUTHORS.txt http://www.tuxpaint.org/ - June 14, 2002 - June 22, 2020 + June 14, 2002 - July 27, 2020 ---------------------------------------------------------------------- diff --git a/docs/en/FAQ.txt b/docs/en/FAQ.txt index 4eee7e9da..f72de02b5 100644 --- a/docs/en/FAQ.txt +++ b/docs/en/FAQ.txt @@ -42,30 +42,30 @@ Drawing-related it with "--stamps" on the command line or "nostamps=no" or "stamps=yes" in a configuration file. - * The Magic "Fill" Tool Looks Bad + * The Magic "Fill" Tool Looks Bad - Tux Paint is probably comparing exact pixel colors when filling. - This is faster, but looks worse. Run the command - "tuxpaint --version" from a command line, and you should see, - amongst the other output: "Low Quality Flood Fill enabled". + Tux Paint is probably comparing exact pixel colors when filling. This + is faster, but looks worse. Run the command "tuxpaint --version" from + a command line, and you should see, amongst the other output: "Low + Quality Flood Fill enabled". - To change this, you must rebuild Tux Paint from source. Be sure - to remove or comment out any line that says: + To change this, you must rebuild Tux Paint from source. Be sure to + remove or comment out any line that says: - #define LOW_QUALITY_FLOOD_FILL + #define LOW_QUALITY_FLOOD_FILL - in the "tuxpaint.c" file in the "src" directory. + in the "tuxpaint.c" file in the "src" directory. - * Stamp outlines are always rectangles + * Stamp outlines are always rectangles - Tux Paint was built with low-quality (but faster) stamp outlines. + Tux Paint was built with low-quality (but faster) stamp outlines. - Rebuild Tux Paint from source. Be sure to remove or comment out - any line that says: + Rebuild Tux Paint from source. Be sure to remove or comment out any + line that says: - #define LOW_QUALITY_STAMP_OUTLINE + #define LOW_QUALITY_STAMP_OUTLINE - in the "tuxpaint.c" file in the "src" directory. + in the "tuxpaint.c" file in the "src" directory. Interface Problems diff --git a/docs/en/OPTIONS.txt b/docs/en/OPTIONS.txt index d46f61fd9..30f3cc4a6 100644 --- a/docs/en/OPTIONS.txt +++ b/docs/en/OPTIONS.txt @@ -6,7 +6,7 @@ Options Documentation Copyright (c) 2002-2020 by various contributors; see AUTHORS.txt http://www.tuxpaint.org/ - July 26, 2020 + July 27, 2020 ---------------------------------------------------------------------- @@ -64,1528 +64,1521 @@ Mac OS X Users Windows Users - The file you should create is called "tuxpaint.cfg" and it should be - placed in Tux Paint's folder. + The file you should create is called "tuxpaint.cfg" and it should be + placed in Tux Paint's folder. - You can use NotePad or WordPad to create this file. Be sure to save - it as Plain Text, and make sure the filename doesn't have ".txt" at - the end... + You can use NotePad or WordPad to create this file. Be sure to save it + as Plain Text, and make sure the filename doesn't have ".txt" at the + end... ---------------------------------------------------------------------- Available Options - The following settings can be set in the configuration file. - (Command-line settings will override these. See the "Command-Line - Options" section, below.) + 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 - Run the program in full screen mode, rather than in a window. + fullscreen=yes + Run the program in full screen mode, rather than in a window. - fullscreen=native - Run the program in full screen mode. Additionally, assume the - screen's current resolution (set by the operating system). + fullscreen=native + Run the program in full screen mode. Additionally, assume the + screen's current resolution (set by the operating system). - windowsize=SIZE + 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). + 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. + 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 + Some examples: - orient=portrait + * 640x480 + * 1024x768 + * 768x1024 + * 1600x1200 - 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. + orient=portrait - native=yes + 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. - When running Tux Paint in fullscreen mode, this assumes the - screen's current resolution (overriding any "windowsize" - option), as set by the operating system. + native=yes - allowscreensaver=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. - 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".) + allowscreensaver=yes - nosound=yes - Disable sound effects. (Note: Pressing [Alt] + [S] cannot be - used to reenable sounds if they were disabled using this - option.) + 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".) - 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.) + nosound=yes + Disable sound effects. (Note: Pressing [Alt] + [S] cannot be + used to reenable sounds if they were disabled using this + option.) - noquit=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 the on-screen "Quit" button and prevent the [Escape] - key from quitting Tux Paint. + noquit=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. + Disable the on-screen "Quit" button and prevent the [Escape] key + from quitting Tux Paint. - You can also use the following keyboard combination to quit: - [Shift] + [Control] + [Escape]. + 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. - noprint=yes - Disable the printing feature. + You can also use the following keyboard combination to quit: + [Shift] + [Control] + [Escape]. - printdelay=SECONDS - Restrict printing so that printing can occur only once every - SECONDS seconds. + noprint=yes + Disable the printing feature. - printcommand=COMMAND + printdelay=SECONDS + Restrict printing so that printing can occur only once every + SECONDS seconds. - (Linux and Unix only) + printcommand=COMMAND - 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: + (Linux and Unix only) - lpr + 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: Versions of Tux Paint prior to 0.9.15 sent PNG format - data to the print command (which defaulted to - "pngtopnm | pnmtops | lpr"). + lpr - If you set an alternative printcommand in the configuration - file prior to version 0.9.15, you will need to change it. + Note: Versions of Tux Paint prior to 0.9.15 sent PNG format data + to the print command (which defaulted to + "pngtopnm | pnmtops | lpr"). - altprintcommand=COMMAND + If you set an alternative printcommand in the configuration file + prior to version 0.9.15, you will need to change it. - (Linux and Unix only) + altprintcommand=COMMAND - 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 - Mac OS X.) + (Linux and Unix only) - If this option is not specifically not set, the default - command is KDE's graphical print dialog: + 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 + Mac OS X.) - kprinter + If this option is not specifically not set, the default command + is KDE's graphical print dialog: - printcfg=yes + kprinter - (Windows and macOS only) + printcfg=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. + (Windows and macOS only) - (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. + 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. - altprint=always + (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. - 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=always - altprint=never + 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. - 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=never - altprint=mod + 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 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. + altprint=mod - papersize=PAPERSIZE + 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. - (Platforms that use Tux Paint's internal PostScript generator - — not Windows, macOS, BeOS, or Haiku.) + papersize=PAPERSIZE - 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. + (Platforms that use Tux Paint's internal PostScript generator — + not Windows, macOS, BeOS, or Haiku.) - 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. + 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. - nolockfile=yes + 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. - 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.) + nolockfile=yes - 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, 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.) - By default, the lockfile is stored in "~/.tuxpaint/" under - Linux and Unix, and "userdata\" under Windows. + 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 - Disable the rotation step of the 'Shape' tool. Click, drag and - release is all that will be needed to draw a shape. + By default, the lockfile is stored in "~/.tuxpaint/" under Linux + and Unix, and "userdata\" under Windows. - 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. + simpleshapes=yes + Disable the rotation step of the 'Shape' tool. Click, drag and + release is all that will be needed to draw a shape. - grab=yes + 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. - 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. + grab=yes - 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. + 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. - noshortcuts=yes + 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 disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, - [Ctrl]-[N] for a new image, etc.) + noshortcuts=yes - This is useful to prevent unwanted commands from being - activated by children who aren't experienced with keyboards. + This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, + [Ctrl]-[N] for a new image, etc.) - nowheelmouse=yes - This disables support for the wheel on mice that have it. - (Normally, the wheel will scroll the selector menu on the - right.) + This is useful to prevent unwanted commands from being activated + by children who aren't experienced with keyboards. - nobuttondistinction=yes + nowheelmouse=yes + This disables support for the wheel on mice that have it. + (Normally, the wheel will scroll the selector menu on the + right.) - 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. + nobuttondistinction=yes - 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. + 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. - nofancycursors=yes + 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. - This disables the fancy mouse pointer shapes in Tux Paint, and - uses your environment's normal mouse pointer. + nofancycursors=yes - In some enviornments, the fancy cursors cause problems. Use - this option to avoid them. + This disables the fancy mouse pointer shapes in Tux Paint, and + uses your environment's normal mouse pointer. - hidecursor=yes + In some enviornments, the fancy cursors cause problems. Use this + option to avoid them. - This completely hides the mouse pointer shapes in Tux Paint. + hidecursor=yes - This is useful for touchscreen devices, such as tablet PCs. + This completely hides the mouse pointer shapes in Tux Paint. - nooutlines=yes + This is useful for touchscreen devices, such as tablet PCs. - In this mode, much simpler outlines and 'rubber-band' lines - are displayed when using the Lines, Shapes, Stamps and Eraser - tools. + nooutlines=yes - This can help when Tux Paint is run on very slow computers, or - displayed on a remote X-Window display. + In this mode, much simpler outlines and 'rubber-band' lines are + displayed when using the Lines, Shapes, Stamps and Eraser tools. - sysfonts=yes + This can help when Tux Paint is run on very slow computers, or + displayed on a remote X-Window display. - 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. + sysfonts=yes - alllocalefonts=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. - 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. + alllocalefonts=yes - To load all locale-specific fonts (the old behavior), set this - option. + 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. - nostamps=yes + To load all locale-specific fonts (the old behavior), set this + option. - This option tells Tux Paint to not load any rubber stamp - images, which in turn ends up disabling the Stamps tool. + nostamps=yes - 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. + This option tells Tux Paint to not load any rubber stamp images, + which in turn ends up disabling the Stamps tool. - 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. + 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. - 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). + 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. - nolabel=yes - Disables the Label tool: the tool that allows text entry which - can be edited later. + 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). - newcolorslast=yes - Places the blank color options in the New dialog at the end, - so that any Starters and/or Templates are shown first. + nolabel=yes + Disables the Label tool: the tool that allows text entry which + can be edited later. - mirrorstamps=yes + newcolorslast=yes + Places the blank color options in the New dialog at the end, so + that any Starters and/or Templates are shown first. - For stamps that can be mirrored, this option sets them to - their mirrored shape by default. + mirrorstamps=yes - This can be useful for people who prefer things right-to-left, - rather than left-to-right. + For stamps that can be mirrored, this option sets them to their + mirrored shape by default. - 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. + This can be useful for people who prefer things right-to-left, + rather than left-to-right. - onscreen-keyboard=yes - Presents a clickable on-screen keyboard when using the Text - and Label tools. + 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-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=yes + Presents a clickable on-screen keyboard when using the Text and + Label tools. - 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. + 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. - joystick-dev=N - Specify which joystick device should be used by Tux Paint. - Default value is 0 (the first joystick). + 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. - 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-dev=N + Specify which joystick device should be used by Tux Paint. + Default value is 0 (the first joystick). - 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-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-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 shortcurt to select the brush tool. - - joystick-btn-stamp=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt to select the stamp tool. - - joystick-btn-lines=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt to select the lines tool. - - joystick-btn-shapes=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt to select the shapes tool. - - joystick-btn-text=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt to select the text tool. - - joystick-btn-label=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt to select the label tool. - - joystick-btn-magic=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt to select the magic tool. - - joystick-btn-undo=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt to the undo tool. - - joystick-btn-redo=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt to the redo tool. - - joystick-btn-eraser=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt for selecting the eraser tool. - - joystick-btn-new=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt to launch the dialog for opening a new draw. - - joystick-btn-open=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt to launch the dialog for opening an existing - draw. - - joystick-btn-save=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt for saving the draw. - - joystick-btn-pgsetup=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will - be a shortcurt 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 shortcurt to print. - - 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. - - 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. - - Specifc "default" to let Tux Paint decide (it's standard - behavior). - - 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) - - 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" secton 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) - - 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 determined - as follows: - * 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 — TBD! - * 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). It is expected that the parent - directory exists. (The directory itself will be created, if it - doesn't.) - - 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: 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. - - 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. - - autosave=yes - This prevents Tux Paint from asking whether you want to save - the current picture when quitting, and assumes you do. - - 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. - - 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". - - 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-devaganari | | | - |---------------------+---------------------+---------------| - |konkani-roman | | | - |---------------------+---------------------+---------------| - |korean | | | - |---------------------+---------------------+---------------| - |kurdish | | | - |---------------------+---------------------+---------------| - |latvian | | | - |---------------------+---------------------+---------------| - |lithuanian |lietuviu | | - |---------------------+---------------------+---------------| - |luganda | | | - |---------------------+---------------------+---------------| - |luxembourgish |letzebuergesch | | - |---------------------+---------------------+---------------| - |macedonian | | | - |---------------------+---------------------+---------------| - |maithili | | | - |---------------------+---------------------+---------------| - |malay | | | - |---------------------+---------------------+---------------| - |malayalam | | | - |---------------------+---------------------+---------------| - |manipuri-bengali | | | - |---------------------+---------------------+---------------| - |manipuri-meitei-mayek| | | - |---------------------+---------------------+---------------| - |marathi | | | - |---------------------+---------------------+---------------| - |mexican-spanish |espanol-mejicano |mexican | - |---------------------+---------------------+---------------| - |mongolian | | | - |---------------------+---------------------+---------------| - |ndebele | | | - |---------------------+---------------------+---------------| - |nepali | | | - |---------------------+---------------------+---------------| - |northern-sotho |sesotho-sa-leboa | | - |---------------------+---------------------+---------------| - |norwegian |nynorsk |norsk | - |---------------------+---------------------+---------------| - |occitan | | | - |---------------------+---------------------+---------------| - |odia |oriya | | - |---------------------+---------------------+---------------| - |ojibwe |ojibway | | - |---------------------+---------------------+---------------| - |persian | | | - |---------------------+---------------------+---------------| - |polish |polski | | - |---------------------+---------------------+---------------| - |portuguese |portugues | | - |---------------------+---------------------+---------------| - |punjabi |panjabi | | - |---------------------+---------------------+---------------| - |romanian | | | - |---------------------+---------------------+---------------| - |russian |russkiy | | - |---------------------+---------------------+---------------| - |sanskrit | | | - |---------------------+---------------------+---------------| - |santali-devaganari | | | - |---------------------+---------------------+---------------| - |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 | - +-----------------------------------------------------------+ + 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 shortcurt to select the brush tool. + + joystick-btn-stamp=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt to select the stamp tool. + + joystick-btn-lines=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt to select the lines tool. + + joystick-btn-shapes=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt to select the shapes tool. + + joystick-btn-text=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt to select the text tool. + + joystick-btn-label=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt to select the label tool. + + joystick-btn-magic=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt to select the magic tool. + + joystick-btn-undo=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt to the undo tool. + + joystick-btn-redo=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt to the redo tool. + + joystick-btn-eraser=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt for selecting the eraser tool. + + joystick-btn-new=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt to launch the dialog for opening a new draw. + + joystick-btn-open=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt to launch the dialog for opening an existing draw. + + joystick-btn-save=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt for saving the draw. + + joystick-btn-pgsetup=BUTTON NUMBER + Selects the joystick button number, as seen by SDL, that will be + a shortcurt 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 shortcurt to print. + + 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. + + 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. + + Specifc "default" to let Tux Paint decide (it's standard + behavior). + + 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) + + 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" secton 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) + + 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 determined as + follows: + + * 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 — TBD! + * 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). It is expected + that the parent directory exists. (The directory itself will be + created, if it doesn't.) + + 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: 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. + + 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. + + autosave=yes + This prevents Tux Paint from asking whether you want to save the + current picture when quitting, and assumes you do. + + 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. + + 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". + + 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-devaganari | | | + |---------------------+---------------------+---------------| + |konkani-roman | | | + |---------------------+---------------------+---------------| + |korean | | | + |---------------------+---------------------+---------------| + |kurdish | | | + |---------------------+---------------------+---------------| + |latvian | | | + |---------------------+---------------------+---------------| + |lithuanian |lietuviu | | + |---------------------+---------------------+---------------| + |luganda | | | + |---------------------+---------------------+---------------| + |luxembourgish |letzebuergesch | | + |---------------------+---------------------+---------------| + |macedonian | | | + |---------------------+---------------------+---------------| + |maithili | | | + |---------------------+---------------------+---------------| + |malay | | | + |---------------------+---------------------+---------------| + |malayalam | | | + |---------------------+---------------------+---------------| + |manipuri-bengali | | | + |---------------------+---------------------+---------------| + |manipuri-meitei-mayek| | | + |---------------------+---------------------+---------------| + |marathi | | | + |---------------------+---------------------+---------------| + |mexican-spanish |espanol-mejicano |mexican | + |---------------------+---------------------+---------------| + |mongolian | | | + |---------------------+---------------------+---------------| + |ndebele | | | + |---------------------+---------------------+---------------| + |nepali | | | + |---------------------+---------------------+---------------| + |northern-sotho |sesotho-sa-leboa | | + |---------------------+---------------------+---------------| + |norwegian |nynorsk |norsk | + |---------------------+---------------------+---------------| + |occitan | | | + |---------------------+---------------------+---------------| + |odia |oriya | | + |---------------------+---------------------+---------------| + |ojibwe |ojibway | | + |---------------------+---------------------+---------------| + |persian | | | + |---------------------+---------------------+---------------| + |polish |polski | | + |---------------------+---------------------+---------------| + |portuguese |portugues | | + |---------------------+---------------------+---------------| + |punjabi |panjabi | | + |---------------------+---------------------+---------------| + |romanian | | | + |---------------------+---------------------+---------------| + |russian |russkiy | | + |---------------------+---------------------+---------------| + |sanskrit | | | + |---------------------+---------------------+---------------| + |santali-devaganari | | | + |---------------------+---------------------+---------------| + |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 | + +-----------------------------------------------------------+ ---------------------------------------------------------------------- Overriding System Config. Options using .tuxpaintrc - (For Linux and Unix users) + (For Linux and Unix users) - If any of the above options are set in - "/etc/tuxpaint/tuxpaint.config", you can override them in your own - "~/.tuxpaintrc" file. + If any of the above options are set in "/etc/tuxpaint/tuxpaint.config", + you can override them in your own "~/.tuxpaintrc" file. - For true/false options, like "noprint" and "grab", you can simply say - they equal 'no' in your "~/.tuxpaintrc" file: + For true/false options, like "noprint" and "grab", you can simply say + they equal 'no' in your "~/.tuxpaintrc" file: - noprint=no - uppercase=no + noprint=no + uppercase=no - Or, you can use options similar to the command-line override options - described below. For example: + Or, you can use options similar to the command-line override options + described below. For example: - print=yes - mixedcase=yes + print=yes + mixedcase=yes ---------------------------------------------------------------------- Command-Line Options - Options can also be issued on the command-line when you start - Tux Paint. + Options can also be issued on the command-line when you start Tux Paint. - --fullscreen - --WIDTHxHEIGHT - --orient=portrait - --native - --allowscreensaver - --startblank - --nosound - --nostereo - --noquit - --noprint - --printdelay=SECONDS - --printcfg - --altprintnever - --altprintalways - --papersize=PAPERSIZE - --nolockfile - --simpleshapes - --uppercase - --grab - --noshortcuts - --nowheelmouse - --nobuttondistinction - --nofancycursors - --hidecursor - --nooutlines - --nostamps - --nostampcontrols - --nomagiccontrols - --nolabel - --newcolorslast - --mouse-accessibility - --onscreen-keyboard - --onscreen-keyboard-layout - --onscreen-keyboard-disable-change - --joystick-dev - --joystick-slowness - --joystick-threshold - --joystick-maxsteps - --joystick-hat-slowness - --joystick-hat-timeout - --joystick-btn-escape - --joystick-btn-brush - --joystick-btn-stamp - --joystick-btn-lines - --joystick-btn-shapes - --joystick-btn-text - --joystick-btn-label - --joystick-btn-magic - --joystick-btn-undo - --joystick-btn-redo - --joystick-btn-eraser - --joystick-btn-new - --joystick-btn-open - --joystick-btn-save - --joystick-btn-pgsetup - --joystick-btn-print - --joystick-buttons-ignore - --sysfonts - --alllocalefonts - --mirrorstamps - --stampsize=SIZE - --keyboard - --savedir DIRECTORY - --datadir DIRECTORY - --exportdir DIRECTORY - --saveover - --saveovernew - --nosave - --autosave - --lang LANGUAGE - --colorfile FILE - These enable or correspond to the configuration file options - described above. + --fullscreen + --WIDTHxHEIGHT + --orient=portrait + --native + --allowscreensaver + --startblank + --nosound + --nostereo + --noquit + --noprint + --printdelay=SECONDS + --printcfg + --altprintnever + --altprintalways + --papersize=PAPERSIZE + --nolockfile + --simpleshapes + --uppercase + --grab + --noshortcuts + --nowheelmouse + --nobuttondistinction + --nofancycursors + --hidecursor + --nooutlines + --nostamps + --nostampcontrols + --nomagiccontrols + --nolabel + --newcolorslast + --mouse-accessibility + --onscreen-keyboard + --onscreen-keyboard-layout + --onscreen-keyboard-disable-change + --joystick-dev + --joystick-slowness + --joystick-threshold + --joystick-maxsteps + --joystick-hat-slowness + --joystick-hat-timeout + --joystick-btn-escape + --joystick-btn-brush + --joystick-btn-stamp + --joystick-btn-lines + --joystick-btn-shapes + --joystick-btn-text + --joystick-btn-label + --joystick-btn-magic + --joystick-btn-undo + --joystick-btn-redo + --joystick-btn-eraser + --joystick-btn-new + --joystick-btn-open + --joystick-btn-save + --joystick-btn-pgsetup + --joystick-btn-print + --joystick-buttons-ignore + --sysfonts + --alllocalefonts + --mirrorstamps + --stampsize=SIZE + --keyboard + --savedir DIRECTORY + --datadir DIRECTORY + --exportdir DIRECTORY + --saveover + --saveovernew + --nosave + --autosave + --lang LANGUAGE + --colorfile FILE + These enable or correspond to the configuration file options + described above. ------------------------------------- - --windowed - --800x600 - --orient=landscape - --disablescreensaver - --startlast - --sound - --stereo - --quit - --print - --printdelay=0 - --noprintcfg - --altprintmod - --lockfile - --complexshapes - --mixedcase - --dontgrab - --shortcuts - --wheelmouse - --buttondistinction - --fancycursors - --showcursor - --outlines - --stamps - --stampcontrols - --magiccontrols - --label - --newcolorsfirst - --nosysfonts - --currentlocalefont - --dontmirrorstamps - --stampsize=default - --mouse - --saveoverask - --save - --noautosave - These options can be used to override any settings made in - the configuration file. (If the option isn't set in the - configuration file(s), no overriding option is necessary.) + --windowed + --800x600 + --orient=landscape + --disablescreensaver + --startlast + --sound + --stereo + --quit + --print + --printdelay=0 + --noprintcfg + --altprintmod + --lockfile + --complexshapes + --mixedcase + --dontgrab + --shortcuts + --wheelmouse + --buttondistinction + --fancycursors + --showcursor + --outlines + --stamps + --stampcontrols + --magiccontrols + --label + --newcolorsfirst + --nosysfonts + --currentlocalefont + --dontmirrorstamps + --stampsize=default + --mouse + --saveoverask + --save + --noautosave + These options can be used to override any settings made in the + configuration file. (If the option isn't set in the + configuration file(s), no overriding option is necessary.) ------------------------------------- - --locale LOCALE + --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. + 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.) + (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 + --nosysconfig - Under Linux and Unix, this prevents the system-wide - configuration file, "/etc/tuxpaint/tuxpaint.conf", from - being read. + Under Linux and Unix, this prevents the system-wide + configuration file, "/etc/tuxpaint/tuxpaint.conf", from being + read. - Only your own configuration file, "~/.tuxpaintrc", if it - exists, will be used. + Only your own configuration file, "~/.tuxpaintrc", if it + exists, will be used. ---------------------------------------------------------------------- Command-Line Informational Options - The following options display some informative text on the screen. - Tux Paint doesn't actually start up and run afterwards, however. + The following options display some informative text on the screen. + Tux Paint doesn't actually start up and run afterwards, however. - --version - --verbose-version - Display the version number and date of the copy of - Tux Paint you are running. The "--verbose-version" also - lists what compile-time options were set. (See INSTALL.txt - and FAQ.txt). + --version + --verbose-version + Display the version number and date of the copy of Tux Paint + you are running. The "--verbose-version" also lists what + compile-time options were set. (See INSTALL.txt and + FAQ.txt). - --copying - Show brief license information about copying Tux Paint. + --copying + Show brief license information about copying Tux Paint. - --usage - Display the list of available command-line options. + --usage + Display the list of available command-line options. - --help - Display brief help on using Tux Paint. + --help + Display brief help on using Tux Paint. - --lang help - Display a list of available languages in Tux Paint. + --lang help + Display a list of available languages in Tux Paint. - --joystick-dev list - Display list of attached joysticks available to Tux Paint. + --joystick-dev list + Display list of attached joysticks available to Tux Paint. ---------------------------------------------------------------------- Choosing a Different Language - Tux Paint has been translated into a number of languages. To access - the translations, you can use the "--lang" option on the command-line - to set the language (e.g. "--lang spanish") or use the "lang=" setting - in the configuration file (e.g., "lang=spanish"). + Tux Paint has been translated into a number of languages. To access the + translations, you can use the "--lang" option on the command-line to set + the language (e.g. "--lang spanish") or use the "lang=" setting in the + configuration file (e.g., "lang=spanish"). - Tux Paint also honors your environment's current locale. (You can - override it on the command-line using the "--locale" option; see - above.) + Tux Paint also honors your environment's current locale. (You can + override it on the command-line using the "--locale" option; see above.) - Use the option "--lang help" to list the available language options - available. + Use the option "--lang help" to list the available language options + available. Available Languages - +------------------------------------------------------------------+ - | |Language |Language |Input Method | - |Locale Code |(native name) |(English name) |Cycle Key | - | | | |Combination | - |----------------+----------------+----------------+---------------| - |C | |English | | - |----------------+----------------+----------------+---------------| - |ach_UG |Acoli |Acholi | | - |----------------+----------------+----------------+---------------| - |af_ZA | |Afrikaans | | - |----------------+----------------+----------------+---------------| - |ak_GH | |Akan | | - |----------------+----------------+----------------+---------------| - |am_ET | |Amharic | | - |----------------+----------------+----------------+---------------| - |an_ES | |Aragones | | - |----------------+----------------+----------------+---------------| - |ar_SA | |Arabic | | - |----------------+----------------+----------------+---------------| - |as_IN | |Assamese | | - |----------------+----------------+----------------+---------------| - |ast_ES | |Asturian | | - |----------------+----------------+----------------+---------------| - |az_AZ | |Azerbaijani | | - |----------------+----------------+----------------+---------------| - |bm_ML | |Bambara | | - |----------------+----------------+----------------+---------------| - |bn_IN | |Bengali | | - |----------------+----------------+----------------+---------------| - |be_BY |Bielaruskaja |Belarusian | | - |----------------+----------------+----------------+---------------| - |bg_BG | |Bulgarian | | - |----------------+----------------+----------------+---------------| - |bo_CN (*) | |Tibetan | | - |----------------+----------------+----------------+---------------| - |br_FR |Brezhoneg |Breton | | - |----------------+----------------+----------------+---------------| - |brx_IN | |Bodo | | - |----------------+----------------+----------------+---------------| - |bs_BA | |Bosnian | | - |----------------+----------------+----------------+---------------| - |ca_ES |Català |Catalan | | - |----------------+----------------+----------------+---------------| - |ca_ES@valencia |Valencia |Valencian | | - |----------------+----------------+----------------+---------------| - |cgg_UG |Chiga |Kiga | | - |----------------+----------------+----------------+---------------| - |cs_CZ |Cesky |Czech | | - |----------------+----------------+----------------+---------------| - |cy_GB |Cymraeg |Welsh | | - |----------------+----------------+----------------+---------------| - |da_DK |Dansk |Danish | | - |----------------+----------------+----------------+---------------| - |de_DE |Deutsch |German | | - |----------------+----------------+----------------+---------------| - |doi_IN | |Dogri | | - |----------------+----------------+----------------+---------------| - |et_EE | |Estonian | | - |----------------+----------------+----------------+---------------| - |el_GR (*) | |Greek | | - |----------------+----------------+----------------+---------------| - |en_AU | |Australian | | - | | |English | | - |----------------+----------------+----------------+---------------| - |en_CA | |Canadian English| | - |----------------+----------------+----------------+---------------| - |en_GB | |British English | | - |----------------+----------------+----------------+---------------| - |en_ZA | |South African | | - | | |English | | - |----------------+----------------+----------------+---------------| - |eo | |Esperanto | | - |----------------+----------------+----------------+---------------| - |es_ES |Español |Spanish | | - |----------------+----------------+----------------+---------------| - |es_MX |Español-Mejicano|Mexican Spanish | | - |----------------+----------------+----------------+---------------| - |eu_ES |Euskara |Basque | | - |----------------+----------------+----------------+---------------| - |fa_IR | |Persian | | - |----------------+----------------+----------------+---------------| - |ff_SN |Fulah |Fula | | - |----------------+----------------+----------------+---------------| - |fi_FI |Suomi |Finnish | | - |----------------+----------------+----------------+---------------| - |fo_FO | |Faroese | | - |----------------+----------------+----------------+---------------| - |fr_FR |Français |French | | - |----------------+----------------+----------------+---------------| - |ga_IE |Gàidhlig |Irish Gaelic | | - |----------------+----------------+----------------+---------------| - |gd_GB |Ghaidhlig |Scottish Gaelic | | - |----------------+----------------+----------------+---------------| - |gl_ES |Galego |Galician | | - |----------------+----------------+----------------+---------------| - |gos_NL |Zudelk |Gronings | | - | |Veenkelonioals | | | - |----------------+----------------+----------------+---------------| - |gu_IN | |Gujarati | | - |----------------+----------------+----------------+---------------| - |he_IL (*) | |Hebrew | | - |----------------+----------------+----------------+---------------| - |hi_IN (*) | |Hindi | | - |----------------+----------------+----------------+---------------| - |hr_HR |Hrvatski |Croatian | | - |----------------+----------------+----------------+---------------| - |hu_HU |Magyar |Hungarian | | - |----------------+----------------+----------------+---------------| - |hy_AM |Hayeren |Armenian | | - |----------------+----------------+----------------+---------------| - |id_ID |Bahasa Indonesia|Indonesian | | - |----------------+----------------+----------------+---------------| - |is_IS |Íslenska |Icelandic | | - |----------------+----------------+----------------+---------------| - |it_IT |Italiano |Italian | | - |----------------+----------------+----------------+---------------| - |iu_CA | |Inuktitut | | - |----------------+----------------+----------------+---------------| - |ja_JP (*) | |Japanese |right [Alt] | - |----------------+----------------+----------------+---------------| - |ka_GE | |Georgian | | - |----------------+----------------+----------------+---------------| - |kab | |Kabyle | | - |----------------+----------------+----------------+---------------| - |km_KH | |Khmer | | - |----------------+----------------+----------------+---------------| - |kn_IN | |Kannada | | - |----------------+----------------+----------------+---------------| - |ko_KR (*) | |Korean |right [Alt] or | - | | | |left [Alt] | - |----------------+----------------+----------------+---------------| - |kok_IN | |Konkani | | - | | |(Devaganari) | | - |----------------+----------------+----------------+---------------| - |kok@roman | |Konkani (Roman) | | - |----------------+----------------+----------------+---------------| - |ks_IN@devanagari| |Kashmiri | | - | | |(Devanagari) | | - |----------------+----------------+----------------+---------------| - |ks_IN | |Kashmiri | | - | | |(Perso-Arabic) | | - |----------------+----------------+----------------+---------------| - |ku_TR | |Kurdish | | - |----------------+----------------+----------------+---------------| - |lb_LU |Letzebuergesch |Luxembourgish | | - |----------------+----------------+----------------+---------------| - |lg_UG | |Luganda | | - |----------------+----------------+----------------+---------------| - |lt_LT |Lietuviu |Lithuanian | | - |----------------+----------------+----------------+---------------| - |lv_LV | |Latvian | | - |----------------+----------------+----------------+---------------| - |mk_MK | |Macedonian | | - |----------------+----------------+----------------+---------------| - |mai_IN | |Maithili | | - |----------------+----------------+----------------+---------------| - |ml_IN | |Malayalam | | - |----------------+----------------+----------------+---------------| - |mn_MN | |Mongolian | | - |----------------+----------------+----------------+---------------| - |mni_IN | |Manipuri | | - | | |(Bengali) | | - |----------------+----------------+----------------+---------------| - |mni@meiteimayek | |Manipuri (Meitei| | - | | |Mayek) | | - |----------------+----------------+----------------+---------------| - |mr_IN | |Marathi | | - |----------------+----------------+----------------+---------------| - |ms_MY | |Malay | | - |----------------+----------------+----------------+---------------| - |nb_NO |Norsk (bokmål) |Norwegian Bokmål| | - |----------------+----------------+----------------+---------------| - |ne_NP |Nepali | | | - |----------------+----------------+----------------+---------------| - |nl_NL | |Dutch | | - |----------------+----------------+----------------+---------------| - |nn_NO |Norsk (nynorsk) |Norwegian | | - | | |Nynorsk | | - |----------------+----------------+----------------+---------------| - |nr_ZA | |Ndebele | | - |----------------+----------------+----------------+---------------| - |nso_ZA |Sesotho sa Leboa|Northern Sotho | | - |----------------+----------------+----------------+---------------| - |oc_FR | |Occitan | | - |----------------+----------------+----------------+---------------| - |oj_CA | |Ojibwe |Ojibway | - |----------------+----------------+----------------+---------------| - |pa_IN | |Punjabi | | - |----------------+----------------+----------------+---------------| - |or_IN | |Odia |Oriya | - |----------------+----------------+----------------+---------------| - |pl_PL |Polski |Polish | | - |----------------+----------------+----------------+---------------| - |pt_BR |Portugês |Brazilian | | - | |Brazileiro |Portuguese | | - |----------------+----------------+----------------+---------------| - |pt_PT |Portugês |Portuguese | | - |----------------+----------------+----------------+---------------| - |ro_RO | |Romanian | | - |----------------+----------------+----------------+---------------| - |ru_RU |Russkiy |Russian | | - |----------------+----------------+----------------+---------------| - |rw_RW | |Kinyarwanda | | - |----------------+----------------+----------------+---------------| - |sa_IN | |Sanskrit | | - |----------------+----------------+----------------+---------------| - |sat_IN | |Santali | | - | | |(Devaganari) | | - |----------------+----------------+----------------+---------------| - |sat@olchiki | |Santali | | - | | |(Ol-Chikii) | | - |----------------+----------------+----------------+---------------| - |shs_CA |Secwepemctin |Shuswap | | - |----------------+----------------+----------------+---------------| - |si_LK | |Sinhala | | - |----------------+----------------+----------------+---------------| - |sd_IN@devanagari| |Sindhi | | - | | |(Devanagari) | | - |----------------+----------------+----------------+---------------| - |sd_IN | |Sindhi | | - |----------------+----------------+----------------+---------------| - |sk_SK | |Slovak | | - |----------------+----------------+----------------+---------------| - |sl_SI | |Slovenian | | - |----------------+----------------+----------------+---------------| - |son | |Songhay | | - |----------------+----------------+----------------+---------------| - |sq_AL | |Albanian | | - |----------------+----------------+----------------+---------------| - |sr_YU | |Serbian | | - | | |(cyrillic) | | - |----------------+----------------+----------------+---------------| - |sr_RS@latin | |Serbian (latin) | | - |----------------+----------------+----------------+---------------| - |su_ID | |Sundanese | | - |----------------+----------------+----------------+---------------| - |sv_SE |Svenska |Swedish | | - |----------------+----------------+----------------+---------------| - |sw_TZ | |Swahili | | - |----------------+----------------+----------------+---------------| - |ta_IN (*) | |Tamil | | - |----------------+----------------+----------------+---------------| - |te_IN (*) | |Telugu | | - |----------------+----------------+----------------+---------------| - |th_TH (*) | |Thai | | - |----------------+----------------+----------------+---------------| - |tl_PH (*) | |Tagalog | | - |----------------+----------------+----------------+---------------| - |tlh |tlhIngan |Klingon | | - |----------------+----------------+----------------+---------------| - |tr_TR | |Turkish | | - |----------------+----------------+----------------+---------------| - |tw_GH | |Twi | | - |----------------+----------------+----------------+---------------| - |uk_UA | |Ukrainian | | - |----------------+----------------+----------------+---------------| - |ur_IN | |Urdu | | - |----------------+----------------+----------------+---------------| - |ve_ZA | |Venda | | - |----------------+----------------+----------------+---------------| - |vec |Venèto |Venetian | | - |----------------+----------------+----------------+---------------| - |vi_VN | |Vietnamese | | - |----------------+----------------+----------------+---------------| - |wa_BE | |Walloon | | - |----------------+----------------+----------------+---------------| - |wo_SN | |Wolof | | - |----------------+----------------+----------------+---------------| - |xh_ZA | |Xhosa | | - |----------------+----------------+----------------+---------------| - |zh_CN (*) | |Chinese | | - | | |(Simplified) | | - |----------------+----------------+----------------+---------------| - |zh_TW (*) | |Chinese | | - | | |(Traditional) | | - |----------------+----------------+----------------+---------------| - |zam | |Zapotec | | - | | |(Miahuatlan) | | - |----------------+----------------+----------------+---------------| - |zu_ZA | |Zulu | | - +------------------------------------------------------------------+ + +--------------------------------------------------------------------+ + | |Language |Language |Input Method | + |Locale Code |(native name) |(English name) |Cycle Key | + | | | |Combination | + |----------------+-------------------+----------------+--------------| + |C | |English | | + |----------------+-------------------+----------------+--------------| + |ach_UG |Acoli |Acholi | | + |----------------+-------------------+----------------+--------------| + |af_ZA | |Afrikaans | | + |----------------+-------------------+----------------+--------------| + |ak_GH | |Akan | | + |----------------+-------------------+----------------+--------------| + |am_ET | |Amharic | | + |----------------+-------------------+----------------+--------------| + |an_ES | |Aragones | | + |----------------+-------------------+----------------+--------------| + |ar_SA | |Arabic | | + |----------------+-------------------+----------------+--------------| + |as_IN | |Assamese | | + |----------------+-------------------+----------------+--------------| + |ast_ES | |Asturian | | + |----------------+-------------------+----------------+--------------| + |az_AZ | |Azerbaijani | | + |----------------+-------------------+----------------+--------------| + |bm_ML | |Bambara | | + |----------------+-------------------+----------------+--------------| + |bn_IN | |Bengali | | + |----------------+-------------------+----------------+--------------| + |be_BY |Bielaruskaja |Belarusian | | + |----------------+-------------------+----------------+--------------| + |bg_BG | |Bulgarian | | + |----------------+-------------------+----------------+--------------| + |bo_CN (*) | |Tibetan | | + |----------------+-------------------+----------------+--------------| + |br_FR |Brezhoneg |Breton | | + |----------------+-------------------+----------------+--------------| + |brx_IN | |Bodo | | + |----------------+-------------------+----------------+--------------| + |bs_BA | |Bosnian | | + |----------------+-------------------+----------------+--------------| + |ca_ES |Català |Catalan | | + |----------------+-------------------+----------------+--------------| + |ca_ES@valencia |Valencia |Valencian | | + |----------------+-------------------+----------------+--------------| + |cgg_UG |Chiga |Kiga | | + |----------------+-------------------+----------------+--------------| + |cs_CZ |Cesky |Czech | | + |----------------+-------------------+----------------+--------------| + |cy_GB |Cymraeg |Welsh | | + |----------------+-------------------+----------------+--------------| + |da_DK |Dansk |Danish | | + |----------------+-------------------+----------------+--------------| + |de_DE |Deutsch |German | | + |----------------+-------------------+----------------+--------------| + |doi_IN | |Dogri | | + |----------------+-------------------+----------------+--------------| + |et_EE | |Estonian | | + |----------------+-------------------+----------------+--------------| + |el_GR (*) | |Greek | | + |----------------+-------------------+----------------+--------------| + |en_AU | |Australian | | + | | |English | | + |----------------+-------------------+----------------+--------------| + |en_CA | |Canadian English| | + |----------------+-------------------+----------------+--------------| + |en_GB | |British English | | + |----------------+-------------------+----------------+--------------| + |en_ZA | |South African | | + | | |English | | + |----------------+-------------------+----------------+--------------| + |eo | |Esperanto | | + |----------------+-------------------+----------------+--------------| + |es_ES |Español |Spanish | | + |----------------+-------------------+----------------+--------------| + |es_MX |Español-Mejicano |Mexican Spanish | | + |----------------+-------------------+----------------+--------------| + |eu_ES |Euskara |Basque | | + |----------------+-------------------+----------------+--------------| + |fa_IR | |Persian | | + |----------------+-------------------+----------------+--------------| + |ff_SN |Fulah |Fula | | + |----------------+-------------------+----------------+--------------| + |fi_FI |Suomi |Finnish | | + |----------------+-------------------+----------------+--------------| + |fo_FO | |Faroese | | + |----------------+-------------------+----------------+--------------| + |fr_FR |Français |French | | + |----------------+-------------------+----------------+--------------| + |ga_IE |Gàidhlig |Irish Gaelic | | + |----------------+-------------------+----------------+--------------| + |gd_GB |Ghaidhlig |Scottish Gaelic | | + |----------------+-------------------+----------------+--------------| + |gl_ES |Galego |Galician | | + |----------------+-------------------+----------------+--------------| + |gos_NL |Zudelk |Gronings | | + | |Veenkelonioals | | | + |----------------+-------------------+----------------+--------------| + |gu_IN | |Gujarati | | + |----------------+-------------------+----------------+--------------| + |he_IL (*) | |Hebrew | | + |----------------+-------------------+----------------+--------------| + |hi_IN (*) | |Hindi | | + |----------------+-------------------+----------------+--------------| + |hr_HR |Hrvatski |Croatian | | + |----------------+-------------------+----------------+--------------| + |hu_HU |Magyar |Hungarian | | + |----------------+-------------------+----------------+--------------| + |hy_AM |Hayeren |Armenian | | + |----------------+-------------------+----------------+--------------| + |id_ID |Bahasa Indonesia |Indonesian | | + |----------------+-------------------+----------------+--------------| + |is_IS |Íslenska |Icelandic | | + |----------------+-------------------+----------------+--------------| + |it_IT |Italiano |Italian | | + |----------------+-------------------+----------------+--------------| + |iu_CA | |Inuktitut | | + |----------------+-------------------+----------------+--------------| + |ja_JP (*) | |Japanese |right [Alt] | + |----------------+-------------------+----------------+--------------| + |ka_GE | |Georgian | | + |----------------+-------------------+----------------+--------------| + |kab | |Kabyle | | + |----------------+-------------------+----------------+--------------| + |km_KH | |Khmer | | + |----------------+-------------------+----------------+--------------| + |kn_IN | |Kannada | | + |----------------+-------------------+----------------+--------------| + |ko_KR (*) | |Korean |right [Alt] or| + | | | |left [Alt] | + |----------------+-------------------+----------------+--------------| + |kok_IN | |Konkani | | + | | |(Devaganari) | | + |----------------+-------------------+----------------+--------------| + |kok@roman | |Konkani (Roman) | | + |----------------+-------------------+----------------+--------------| + |ks_IN@devanagari| |Kashmiri | | + | | |(Devanagari) | | + |----------------+-------------------+----------------+--------------| + |ks_IN | |Kashmiri | | + | | |(Perso-Arabic) | | + |----------------+-------------------+----------------+--------------| + |ku_TR | |Kurdish | | + |----------------+-------------------+----------------+--------------| + |lb_LU |Letzebuergesch |Luxembourgish | | + |----------------+-------------------+----------------+--------------| + |lg_UG | |Luganda | | + |----------------+-------------------+----------------+--------------| + |lt_LT |Lietuviu |Lithuanian | | + |----------------+-------------------+----------------+--------------| + |lv_LV | |Latvian | | + |----------------+-------------------+----------------+--------------| + |mk_MK | |Macedonian | | + |----------------+-------------------+----------------+--------------| + |mai_IN | |Maithili | | + |----------------+-------------------+----------------+--------------| + |ml_IN | |Malayalam | | + |----------------+-------------------+----------------+--------------| + |mn_MN | |Mongolian | | + |----------------+-------------------+----------------+--------------| + |mni_IN | |Manipuri | | + | | |(Bengali) | | + |----------------+-------------------+----------------+--------------| + |mni@meiteimayek | |Manipuri (Meitei| | + | | |Mayek) | | + |----------------+-------------------+----------------+--------------| + |mr_IN | |Marathi | | + |----------------+-------------------+----------------+--------------| + |ms_MY | |Malay | | + |----------------+-------------------+----------------+--------------| + |nb_NO |Norsk (bokmål) |Norwegian Bokmål| | + |----------------+-------------------+----------------+--------------| + |ne_NP |Nepali | | | + |----------------+-------------------+----------------+--------------| + |nl_NL | |Dutch | | + |----------------+-------------------+----------------+--------------| + |nn_NO |Norsk (nynorsk) |Norwegian | | + | | |Nynorsk | | + |----------------+-------------------+----------------+--------------| + |nr_ZA | |Ndebele | | + |----------------+-------------------+----------------+--------------| + |nso_ZA |Sesotho sa Leboa |Northern Sotho | | + |----------------+-------------------+----------------+--------------| + |oc_FR | |Occitan | | + |----------------+-------------------+----------------+--------------| + |oj_CA | |Ojibwe |Ojibway | + |----------------+-------------------+----------------+--------------| + |pa_IN | |Punjabi | | + |----------------+-------------------+----------------+--------------| + |or_IN | |Odia |Oriya | + |----------------+-------------------+----------------+--------------| + |pl_PL |Polski |Polish | | + |----------------+-------------------+----------------+--------------| + |pt_BR |Portugês Brazileiro|Brazilian | | + | | |Portuguese | | + |----------------+-------------------+----------------+--------------| + |pt_PT |Portugês |Portuguese | | + |----------------+-------------------+----------------+--------------| + |ro_RO | |Romanian | | + |----------------+-------------------+----------------+--------------| + |ru_RU |Russkiy |Russian | | + |----------------+-------------------+----------------+--------------| + |rw_RW | |Kinyarwanda | | + |----------------+-------------------+----------------+--------------| + |sa_IN | |Sanskrit | | + |----------------+-------------------+----------------+--------------| + |sat_IN | |Santali | | + | | |(Devaganari) | | + |----------------+-------------------+----------------+--------------| + |sat@olchiki | |Santali | | + | | |(Ol-Chikii) | | + |----------------+-------------------+----------------+--------------| + |shs_CA |Secwepemctin |Shuswap | | + |----------------+-------------------+----------------+--------------| + |si_LK | |Sinhala | | + |----------------+-------------------+----------------+--------------| + |sd_IN@devanagari| |Sindhi | | + | | |(Devanagari) | | + |----------------+-------------------+----------------+--------------| + |sd_IN | |Sindhi | | + |----------------+-------------------+----------------+--------------| + |sk_SK | |Slovak | | + |----------------+-------------------+----------------+--------------| + |sl_SI | |Slovenian | | + |----------------+-------------------+----------------+--------------| + |son | |Songhay | | + |----------------+-------------------+----------------+--------------| + |sq_AL | |Albanian | | + |----------------+-------------------+----------------+--------------| + |sr_YU | |Serbian | | + | | |(cyrillic) | | + |----------------+-------------------+----------------+--------------| + |sr_RS@latin | |Serbian (latin) | | + |----------------+-------------------+----------------+--------------| + |su_ID | |Sundanese | | + |----------------+-------------------+----------------+--------------| + |sv_SE |Svenska |Swedish | | + |----------------+-------------------+----------------+--------------| + |sw_TZ | |Swahili | | + |----------------+-------------------+----------------+--------------| + |ta_IN (*) | |Tamil | | + |----------------+-------------------+----------------+--------------| + |te_IN (*) | |Telugu | | + |----------------+-------------------+----------------+--------------| + |th_TH (*) | |Thai | | + |----------------+-------------------+----------------+--------------| + |tl_PH (*) | |Tagalog | | + |----------------+-------------------+----------------+--------------| + |tlh |tlhIngan |Klingon | | + |----------------+-------------------+----------------+--------------| + |tr_TR | |Turkish | | + |----------------+-------------------+----------------+--------------| + |tw_GH | |Twi | | + |----------------+-------------------+----------------+--------------| + |uk_UA | |Ukrainian | | + |----------------+-------------------+----------------+--------------| + |ur_IN | |Urdu | | + |----------------+-------------------+----------------+--------------| + |ve_ZA | |Venda | | + |----------------+-------------------+----------------+--------------| + |vec |Venèto |Venetian | | + |----------------+-------------------+----------------+--------------| + |vi_VN | |Vietnamese | | + |----------------+-------------------+----------------+--------------| + |wa_BE | |Walloon | | + |----------------+-------------------+----------------+--------------| + |wo_SN | |Wolof | | + |----------------+-------------------+----------------+--------------| + |xh_ZA | |Xhosa | | + |----------------+-------------------+----------------+--------------| + |zh_CN (*) | |Chinese | | + | | |(Simplified) | | + |----------------+-------------------+----------------+--------------| + |zh_TW (*) | |Chinese | | + | | |(Traditional) | | + |----------------+-------------------+----------------+--------------| + |zam | |Zapotec | | + | | |(Miahuatlan) | | + |----------------+-------------------+----------------+--------------| + |zu_ZA | |Zulu | | + +--------------------------------------------------------------------+ - (*) - These languages require their own fonts, since they are not - represented using a Latin character set, like the others. See the - "Special Fonts" section, below. + (*) - These languages require their own fonts, since they are not + represented using a Latin character set, like the others. See the + "Special Fonts" section, below. - Note: Tux Paint provides an alternative input method for entering - characters with the Text tool in some locales. The key comibation(s) - listed can be used to cycle through the supported input methods - while the Text tool is active. + Note: Tux Paint provides an alternative input method for entering + characters with the Text tool in some locales. The key comibation(s) + listed can be used to cycle through the supported input methods while + the Text tool is active. Setting Your Environment's Locale - Changing your locale will affect much of your environment. + Changing your locale will affect much of your environment. - As stated above, along with letting you choose the language at - runtime using command-line options ("--lang" and "--locale"), - Tux Paint honors the global locale setting in your environment. + As stated above, along with letting you choose the language at runtime + using command-line options ("--lang" and "--locale"), Tux Paint honors + the global locale setting in your environment. - If you haven't already set your environment's locale, the following - will briefly explain how: + If you haven't already set your environment's locale, the following + will briefly explain how: Linux/Unix Users - First, be sure the locale you want to use is enabled by editing - the file "/etc/locale.gen" on your system and then running the - program "locale-gen" as root. + First, be sure the locale you want to use is enabled by editing the + file "/etc/locale.gen" on your system and then running the program + "locale-gen" as root. - Note: Debian users may be able to simply run the command - "dpkg-reconfigure locales" as root to bring up a configuration - dialog. Ubuntu users may be able to run - "sudo dpkg-reconfigure localeconf" (the "localeconf" package may - need to be installed first), or may need to edit the file - "/var/lib/locales/supported.d/local" first, and add locales they - want, from the list found in "/usr/share/i18n/SUPPORTED". + Note: Debian users may be able to simply run the command + "dpkg-reconfigure locales" as root to bring up a configuration + dialog. Ubuntu users may be able to run + "sudo dpkg-reconfigure localeconf" (the "localeconf" package may + need to be installed first), or may need to edit the file + "/var/lib/locales/supported.d/local" first, and add locales they + want, from the list found in "/usr/share/i18n/SUPPORTED". - Then, before running Tux Paint, set your "$LANG" environment - variable to one of the locales listed above. (If you want all - programs that can be translated to be, you may wish to place the - following in your login script; e.g. ~/.profile, ~/.bashrc, - ~/.cshrc, etc.) + Then, before running Tux Paint, set your "$LANG" environment + variable to one of the locales listed above. (If you want all + programs that can be translated to be, you may wish to place the + following in your login script; e.g. ~/.profile, ~/.bashrc, + ~/.cshrc, etc.) - For example, in a Bourne Shell (like BASH): + For example, in a Bourne Shell (like BASH): - export LANG=es_ES ; \ - tuxpaint + export LANG=es_ES ; \ + tuxpaint - And in a C Shell (like TCSH): + And in a C Shell (like TCSH): - setenv LANG es_ES ; \ - tuxpaint + setenv LANG es_ES ; \ + tuxpaint ---------------------------------------------------------------------- Windows Users - Tux Paint will recognize the current locale and use the - appropriate files by default. So this section is only for people - trying different languages. + Tux Paint will recognize the current locale and use the appropriate + files by default. So this section is only for people trying + different languages. - The simplest thing to do is to use the '--lang' switch in the - shortcut (see "INSTALL.txt"). However, by using an MSDOS Prompt - window, it is also possible to issue a command like this: + The simplest thing to do is to use the '--lang' switch in the + shortcut (see "INSTALL.txt"). However, by using an MSDOS Prompt + window, it is also possible to issue a command like this: - set LANG=es_ES + set LANG=es_ES - ...which will set the language for the lifetime of that DOS - window. + ...which will set the language for the lifetime of that DOS window. - For something more permanent, try editing your computer's - 'autoexec.bat' file using Windows' "sysedit" tool: + For something more permanent, try editing your computer's + 'autoexec.bat' file using Windows' "sysedit" tool: Windows 95/98 - 1. Click on the 'Start' button, and select 'Run...'. - 2. Type "sysedit" into the 'Open:' box (with or without quotes). - 3. Click 'OK'. - 4. Locate the AUTOEXEC.BAT window in the System Configuration - Editor. - 5. Add the following at the bottom of the file: + 1. Click on the 'Start' button, and select 'Run...'. + 2. Type "sysedit" into the 'Open:' box (with or without quotes). + 3. Click 'OK'. + 4. Locate the AUTOEXEC.BAT window in the System Configuration + Editor. + 5. Add the following at the bottom of the file: - set LANG=es_ES + set LANG=es_ES - 6. Close the System Configuration Editor, answering yes to save - the changes. - 7. Restart your machine. + 6. Close the System Configuration Editor, answering yes to save the + changes. + 7. Restart your machine. - To affect the entire machine, and all applications, it is - possible to use the "Regional Settings" control panel: + To affect the entire machine, and all applications, it is possible + to use the "Regional Settings" control panel: - 1. Click on the 'Start' button, and select - 'Settings | Control Panel'. - 2. Double click on the "Regional Settings" globe. - 3. Select a language/region from the drop down list. - 4. Click 'OK'. - 5. Restart your machine when prompted. + 1. Click on the 'Start' button, and select + 'Settings | Control Panel'. + 2. Double click on the "Regional Settings" globe. + 3. Select a language/region from the drop down list. + 4. Click 'OK'. + 5. Restart your machine when prompted. Special Fonts - Some languages require special fonts be installed. These font files - (which are in TrueType format (TTF)), are much too large to include - with the Tux Paint download, and are available separately. (See the - table above, under the "Choosing a Different Language" section.) + Some languages require special fonts be installed. These font files + (which are in TrueType format (TTF)), are much too large to include + with the Tux Paint download, and are available separately. (See the + table above, under the "Choosing a Different Language" section.) - Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, - which utilizes the "Pango" library to render text in the user - interface, rather than using "SDL_ttf" directly. Unless your copy of - Tux Paint was built without Pango support, special fonts should no - longer be necessary. + Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, + which utilizes the "Pango" library to render text in the user + interface, rather than using "SDL_ttf" directly. Unless your copy of + Tux Paint was built without Pango support, special fonts should no + longer be necessary. - When running Tux Paint in a language that requires its own font, - Tux Paint will try to load the font file from its system-wide - "fonts" directory (under a "locale" subdirectory). The name of the - file corresponds to the first two letters in the 'locale' code of - the language (e.g., "ko" for Korean, "ja" for Japanese, "zh_tw" for - Traditional Chinese). + When running Tux Paint in a language that requires its own font, + Tux Paint will try to load the font file from its system-wide "fonts" + directory (under a "locale" subdirectory). The name of the file + corresponds to the first two letters in the 'locale' code of the + language (e.g., "ko" for Korean, "ja" for Japanese, "zh_tw" for + Traditional Chinese). - For example, under Linux or Unix, when Tux Paint is run in Korean - (e.g., with the option "--lang korean"), Tux Paint will attempt to - load the following font file: + For example, under Linux or Unix, when Tux Paint is run in Korean + (e.g., with the option "--lang korean"), Tux Paint will attempt to + load the following font file: - /usr/share/tuxpaint/fonts/locale/ko.ttf + /usr/share/tuxpaint/fonts/locale/ko.ttf - You can download fonts for supported languages from Tux Paint's - website, http://www.tuxpaint.org/. (Look in the 'Fonts' section - under 'Download.') + You can download fonts for supported languages from Tux Paint's + website, http://www.tuxpaint.org/. (Look in the 'Fonts' section under + 'Download.') - Under Unix and Linux, you can use the Makefile that comes with the - font to install the font in the appropriate location. + Under Unix and Linux, you can use the Makefile that comes with the + font to install the font in the appropriate location. ---------------------------------------------------------------------- diff --git a/docs/en/README.txt b/docs/en/README.txt index 1e7ada4eb..22e68110e 100644 --- a/docs/en/README.txt +++ b/docs/en/README.txt @@ -147,8 +147,8 @@ Main Screen The toolbar contains the drawing and editing controls. - [Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, - Eraser, New, Open, Save, Print, Quit] + [Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser, + New, Open, Save, Print, Quit] Middle: Drawing Canvas @@ -176,8 +176,8 @@ Main Screen A palette of available colors are shown near the bottom of the screen. - [Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, - Purple, Brown, Grey] + [Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, Purple, + Brown, Grey] On the far right are two special color options, the "color picker", which has an outline of an eye-dropper, and @@ -193,9 +193,8 @@ Main Screen At the very bottom of the screen, Tux, the Linux Penguin, provides tips and other information while you draw. - (For example: 'Pick a shape. Click to pick the center, drag, then let go -when it is the size you want. Move around to rotate it, and click to draw - it.) +(For example: 'Pick a shape. Click to pick the center, drag, then let go when it + is the size you want. Move around to rotate it, and click to draw it.) ---------------------------------------------------------------------- diff --git a/docs/en/html/ADVANCED-STAMPS-HOWTO.html b/docs/en/html/ADVANCED-STAMPS-HOWTO.html index b1e7f2ed2..7a1c13b68 100644 --- a/docs/en/html/ADVANCED-STAMPS-HOWTO.html +++ b/docs/en/html/ADVANCED-STAMPS-HOWTO.html @@ -1,330 +1,501 @@ -Tux Paint Advanced Stamps HOWTO - - - - - -
-


-version - -0.9.25 - -
-Advanced Stamps HOWTO

- -

Copyright 2006-2008 by Albert Cahalan for the Tux Paint project
-New Breed Software

-

albert@users.sf.net
-http://www.tuxpaint.org/

- -
- - -

About this HOWTO

-
- -

This HOWTO assumes that you want to make an excellent Tux Paint - stamp, in PNG bitmapped format, from a JPEG image (e.g., a digital - photograph). There are easier and faster methods that - produce lower quality.

- -

This HOWTO assumes you are dealing with normal opaque objects. Dealing - with semi-transparent objects (fire, moving fan blade, kid's baloon) - or light-giving objects (fire, lightbulb, sun) is best done with custom - software. Images with perfect solid-color backgrounds are also best done - with custom software, but are not troublesome to do as follows.

- -
- -

Image choice is crucial

-
- -

License

-
- -

If you wish to submit artwork to the Tux Paint developers for - consideration for inclusion in the official project, or if you wish to - release your own copy of Tux Paint, bundled with your own graphics, - you need an image that is compatible with the GNU - General Public License used by - Tux Paint.

- -

Images produced by the US government are Public Domain, but be aware - that the US government sometimes uses other images on the web. - Google image queries including - either site:gov or site:mil will supply many - suitable images. (Note: the *.mil sites include non-military content, - too!)

- - Your own images can be placed in the Public Domain by declaring it - so. (Hire a lawyer if you feel the need for legal advice.)

- -

For personal use, any image you can legitimately modify and use - for your own personal use should be fine.

- -
- -

Image Size and Orientation:

-
- -

You need an image that has a useful orientation. Perspective is - an enemy. Images that show an object from the corner are difficult to - fit into a nice drawing. As a general rule, telephoto side views are - the best. The impossible ideal is that, for example, two wheels of a - car are perfectly hidden behind the other two.

- -

Rotating an image can make it blurry, especially if you only rotate by - a few degrees. Images that don't need rotation are best, images that need - lots of rotation (30 to 60 degrees) are next best, and images that need - just a few degrees are worst. Rotation will also make an image darker - because most image editing software is very bad about gamma handling. - (Rotation is only legitimate for gamma=1.0 images.)

- -

Very large images are more forgiving of mistakes, and thus easier to - work with. Choose an image with an object that is over 1000 pixels - across if you can. You can shrink this later to hide your mistakes.

- -

Be sure that the image is not too grainy, dim, or washed out.

- -

Pay attention to feet and wheels. If they are buried in something, - you will need to draw new ones. If only one is buried, you might be - able to copy the other one as a replacement.

- -
-
- -

Prepare the image:

-
- -

First of all, be sure to avoid re-saving the image as a JPEG. This causes - quality loss. There is a special tool called - jpegtran - that lets you crop an image without the normal quality loss. If you want a - GUI for it, use - ljcrop. - Otherwise, use it like this:

- -
-

jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg - > cropped.jpg

-
- -

Bring that image up in your image editor. If you didn't crop it yet, - you may find that your image editor is very slow. Rotate and crop the - image as needed. Save the image — choose whatever native format - supports layers, masks, alpha, etc. GIMP - users should choose "XCF", and Adobe Photoshop users should choose "PSD", - for example.

- -

If you have rotated or cropped the image in your image editor, flatten - it now. You need to have just one RGB layer without mask or - alpha.

- -

Open the layers dialog box. Replicate the one layer several times. - From top to bottom you will need something like this:

- -
    -
  1. unmodified image (write-protect this if you can)
    2. -
  2. an image you will modify — the "WIP" layer
    3. -
  3. solid green (write-protect this if you can)
    4. -
  4. solid magenta (write-protect this if you can)
    5. -
  5. unmodified image (write-protect this if you can)
    6. -
- -

Give the WIP layer a rough initial mask. You might start with a - selection, or by using the grayscale value of the WIP layer. You might - invert the mask.

- -

Warning: once you have the mask, you may not rotate or - scale the image normally. This would cause data loss. You will be - given special scaling instructions later.

- -
- -

Prepare the mask:

-
- -

Get used to doing Ctrl-click and Alt-click on the thumbnail images in the - layers dialog. You will need this to control what you are looking at and - what you are editing. Sometimes you will be editing things you can't see. - For example, you might edit the mask of the WIP layer while looking at the - unmodified image. Pay attention so you don't screw up. Always verify that - you are editing the right thing.

- -

Set an unmodified image as what you will view (the top one is easiest). - Set the WIP mask as what you will edit. At some point, perhaps not - immediately, you should magnify the image to about 400% (each pixel of - the image is seen and edited as a 4x4 block of pixels on your screen).

- -

Select parts of the image that need to be 100% opaque or 0% opaque. - If you can select the object or background somewhat accurately by - color, do so. As needed to avoid selecting any pixels that should be - partially opaque (generally at the edge of the object) you should - grow, shrink, and invert the selection.

- -

Fill the 100% opaque areas with white, and the 0% opaque areas with - black. This is most easily done by drag-and-drop from the - foreground/background color indicator. You should not see anything happen, - because you are viewing the unmodified image layer while editing the mask - of the WIP layer. Large changes might be noticable in the thumbnail.

- -

Now you must be zoomed in.

- -

Check your work. Hide the top unmodified image layer. Display just the - mask, which should be a white object on a black background (probably - with unedited grey at the edge). Now display the WIP layer normally, so - that the mask is active. This should show your object over top of the - next highest enabled layer, which should be green or magenta as needed - for maximum contrast. You might wish to flip back and forth between - those backgrounds by repeatedly clicking to enable/disable the green - layer. Fix any obvious and easy problems by editing the mask while - viewing the mask.

- -

Go back to viewing the top unmodified layer while editing the WIP mask. - Set your drawing tool the paintbrush. For the brush, choose a small fuzzy - circle. The 5x5 size is good for most uses.

- -

With a steady hand, trace around the image. Use black around the outside, - and white around the inside. Avoid making more than one pass without - switching colors (and thus sides).

- -

Flip views a bit, checking to see that the mask is working well. When - the WIP layer is composited over the green or magenta, you should see a - tiny bit of the original background as an ugly fringe around the edge. - If this fringe is missing, then you made the object mask too small. - The fringe consists of pixels that are neither 100% object nor 0% object. - For them, the mask should be neither 100% nor 0%. The fringe gets removed - soon.

- -

View and edit the mask. Select by color, choosing either black or white. - Most likely you will see unselected specks that are not quite the expected - color. Invert the selection, then paint these away using the pencil tool. - Do this operation for both white and black.

- -
- -

Replace the fringe and junk pixels:

-
- -

Still viewing the mask, select by color. Choose black. Shrink the - selection by several pixels, being sure to NOT shrink from the edges of - the mask (the shrink helps you avoid and recover from mistakes).

- -

Now disable the mask. View and edit the unmasked WIP layer. Using the - color picker tool, choose a color that is average for the object. - Drag-and-drop this color into the selection, thus removing most of the - non-object pixels.

- -

This solid color will compress well and will help prevent ugly color - fringes when Tux Paint scales the image down. If the edge of the - object has multiple colors that are very different, you should split up - your selection so that you can color the nearby background to be - similar.

- -

Now you will paint away the existing edge fringe. Be sure that you are - editing and viewing the WIP image. Frequent layer visibility changes will - help you to see what you are doing. You are likely to use all of:

- - - -

To reduce accidents, you may wish to select only those pixels that are - not grey in the mask. (Select by color from the mask, choose black, add - mode, choose white, invert. Alternately: Select all, select by color from - the mask, subtract mode, choose black, choose white.) If you do this, - you'll probably want to expand the selection a bit and/or hide the - "crawling ants" line that marks the selection.

- -

Use the clone tool and the brush tool. Vary the opacity as needed. - Use small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. - (It is generally nice to pair up fuzzy brushes with 100% opacity and - non-fuzzy brushes with about 70% opacity.) Unusual drawing modes can be - helpful with semi-transparent objects.

- -

The goal is to remove the edge fringe, both inside and outside of - the object. The inside fringe, visible when the object is composited - over magenta or green, must be removed for obvious reasons. The - outside fringe must also be removed because it will become visible - when the image is scaled down. As an example, consider a 2x2 region of - pixels at the edge of a sharp-edged object. The left half is black - and 0% opaque. The right half is white and 100% opaque. That is, we - have a white object on a black background. When Tux Paint scales this - to 50% (a 1x1 pixel area), the result will be a grey 50% opaque pixel. - The correct result would be a white 50% opaque pixel. To get this - result, we would paint away the black pixels. They matter, despite - being 0% opaque.

- -

Tux Paint can scale images down by a very large factor, so it is - important to extend the edge of your object outward by a great deal. - Right at the edge of your object, you should be very accurate about this. - As you go outward away from the object, you can get a bit sloppy. It is - reasonable to paint outward by a dozen pixels or more. The farther you go, - the more Tux Paint can scale down without creating ugly color fringes. - For areas that are more than a few pixels away from the object edge, you - should use the pencil tool (or sloppy select with drag-and-drop color) to - ensure that the result will compress well.

-
- -

Save the image for Tux Paint

-
- -

It is very easy to ruin your hard work. Image editors can silently - destroy pixels in 0% opaque areas. The conditions under which this - happens may vary from version to version. If you are very trusting, - you can try saving your image directly as a PNG. Be sure to read it - back in again to verify that the 0% opaque areas didn't turn black or - white, which would create fringes when Tux Paint scales the image down. - If you need to scale your image to save space (and hide your mistakes), you - are almost certain to destroy all the 0% opaque areas. So here is a better - way...

- -

A Safer Way to Save:

-
- -

Drag the mask from the layers dialog to the unused portion of - the toolbar (right after the last drawing tool). This will create a - new image consisting of one layer that contains the mask data. Scale - this as desired, remembering the settings you use. Often you should - start with an image that is about 700 to 1500 pixels across, and end - up with one that is 300 to 400.

- -

Save the mask image as a NetPBM portable greymap (".pgm") - file. (If you are using an old release of The GIMP, you might need - to convert the image to greyscale before you can save it.) Choose the - more compact "RAW PGM" format. (The second character of the file - should be the ASCII digit "5", hex byte 0x35.)

- -

You may close the mask image.

- -

Going back to the multi-layer image, now select the WIP layer. As you - did with the mask, drag this from the layers dialog to the toolbar. You - should get a single-layer image of your WIP data. If the mask came along - too, get rid of it. You should be seeing the object and the painted-away - surroundings, without any mask thumbnail in the layers dialog. If you - scaled the mask, then scale this image in exactly the same way. Save - this image as a NetPBM portable pixmap (".ppm") file. - (Note: ppm, not pgm.) (If you choose the RAW PPM format, the - second byte of the file should be the ASCII digit "6", hex byte 0x36.)

- -

Now you need to merge the two files into one. Do that with the - pnmtopng command, like - this:

- -

- pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > - final-stamp.png -

-
-
- - - + + + + + Tux Paint Advanced Stamps HOWTO + + + + +
+

+ Tux Paint
+ version 0.9.25
+ Advanced Stamps HOWTO +

+ +

+ Copyright 2006-2008 by Albert Cahalan for the Tux Paint + project
+ New Breed Software +

+ +

+ albert@users.sf.net
+ http://www.tuxpaint.org/ +

+
+ +

+ About this HOWTO +

+ +
+

+ This HOWTO assumes that you want to make an excellent + Tux Paint stamp, in PNG bitmapped format, from a JPEG + image (e.g., a digital photograph). There are easier and + faster methods that produce lower quality. +

+ +

+ This HOWTO assumes you are dealing with normal opaque + objects. Dealing with semi-transparent objects (fire, + moving fan blade, kid's baloon) or light-giving objects + (fire, lightbulb, sun) is best done with custom software. + Images with perfect solid-color backgrounds are also best + done with custom software, but are not troublesome to do as + follows. +

+
+ +

+ Image choice is crucial +

+ +
+

+ License +

+ +
+

+ If you wish to submit artwork to the Tux Paint + developers for consideration for inclusion in the + official project, or if you wish to release your own copy + of Tux Paint, bundled with your own graphics, you + need an image that is compatible with the GNU General Public License used by + Tux Paint. +

+ +

+ Images produced by the US government are Public Domain, + but be aware that the US government sometimes uses other + images on the web. Google image queries + including either site:gov or + site:mil will supply many suitable images. + (Note: the *.mil sites include non-military content, + too!) +

+ +

+ Your own images can be placed in the Public Domain + by declaring it so. (Hire a lawyer if you feel the need + for legal advice.) +

+ +

+ For personal use, any image you can legitimately modify + and use for your own personal use should be fine. +

+
+ +

+ Image Size and Orientation: +

+ +
+

+ You need an image that has a useful orientation. + Perspective is an enemy. Images that show an object from + the corner are difficult to fit into a nice drawing. As a + general rule, telephoto side views are the best. The + impossible ideal is that, for example, two wheels of a + car are perfectly hidden behind the other two. +

+ +

+ Rotating an image can make it blurry, especially if you + only rotate by a few degrees. Images that don't need + rotation are best, images that need lots of rotation (30 + to 60 degrees) are next best, and images that need just a + few degrees are worst. Rotation will also make an image + darker because most image editing software is very bad + about gamma handling. (Rotation is only legitimate for + gamma=1.0 images.) +

+ +

+ Very large images are more forgiving of mistakes, and + thus easier to work with. Choose an image with an object + that is over 1000 pixels across if you can. You can + shrink this later to hide your mistakes. +

+ +

+ Be sure that the image is not too grainy, dim, or washed + out. +

+ +

+ Pay attention to feet and wheels. If they are buried in + something, you will need to draw new ones. If only one is + buried, you might be able to copy the other one as a + replacement. +

+
+
+ +

+ Prepare the image: +

+ +
+

+ First of all, be sure to avoid re-saving the image as a + JPEG. This causes quality loss. There is a special tool + called jpegtran + that lets you crop an image without the normal quality + loss. If you want a GUI for it, use ljcrop. + Otherwise, use it like this: +

+ +
+

+ jpegtran -trim -copy none -crop 512x1728+160+128 + < src.jpg > cropped.jpg +

+
+ +

+ Bring that image up in your image editor. If you didn't + crop it yet, you may find that your image editor is very + slow. Rotate and crop the image as needed. Save the image — + choose whatever native format supports layers, masks, + alpha, etc. GIMP users + should choose "XCF", and Adobe Photoshop users should + choose "PSD", for example. +

+ +

+ If you have rotated or cropped the image in your image + editor, flatten it now. You need to have just one RGB layer + without mask or alpha. +

+ +

+ Open the layers dialog box. Replicate the one layer several + times. From top to bottom you will need something like + this: +

+ +
    +
  1. unmodified image (write-protect this if you can) +
    2. + +
  2. an image you will modify — the "WIP" layer +
    3. + +
  3. solid green (write-protect this if you can) +
    4. + +
  4. solid magenta (write-protect this if you can) +
    5. + +
  5. unmodified image (write-protect this if you can) +
    6. +
+ +

+ Give the WIP layer a rough initial mask. You might start + with a selection, or by using the grayscale value of the + WIP layer. You might invert the mask. +

+ +

+ Warning: once you have the mask, you may not rotate + or scale the image normally. This would cause data loss. + You will be given special scaling instructions later. +

+
+ +

+ Prepare the mask: +

+ +
+

+ Get used to doing Ctrl-click and Alt-click on the thumbnail + images in the layers dialog. You will need this to control + what you are looking at and what you are editing. Sometimes + you will be editing things you can't see. For example, you + might edit the mask of the WIP layer while looking at the + unmodified image. Pay attention so you don't screw up. + Always verify that you are editing the right thing. +

+ +

+ Set an unmodified image as what you will view (the top one + is easiest). Set the WIP mask as what you will edit. At + some point, perhaps not immediately, you should magnify the + image to about 400% (each pixel of the image is seen and + edited as a 4x4 block of pixels on your screen). +

+ +

+ Select parts of the image that need to be 100% opaque or 0% + opaque. If you can select the object or background somewhat + accurately by color, do so. As needed to avoid selecting + any pixels that should be partially opaque (generally at + the edge of the object) you should grow, shrink, and invert + the selection. +

+ +

+ Fill the 100% opaque areas with white, and the 0% opaque + areas with black. This is most easily done by drag-and-drop + from the foreground/background color indicator. You should + not see anything happen, because you are viewing the + unmodified image layer while editing the mask of the WIP + layer. Large changes might be noticable in the thumbnail. +

+ +

+ Now you must be zoomed in. +

+ +

+ Check your work. Hide the top unmodified image layer. + Display just the mask, which should be a white object on a + black background (probably with unedited grey at the edge). + Now display the WIP layer normally, so that the mask is + active. This should show your object over top of the next + highest enabled layer, which should be green or magenta as + needed for maximum contrast. You might wish to flip back + and forth between those backgrounds by repeatedly clicking + to enable/disable the green layer. Fix any obvious and easy + problems by editing the mask while viewing the mask. +

+ +

+ Go back to viewing the top unmodified layer while editing + the WIP mask. Set your drawing tool the paintbrush. For the + brush, choose a small fuzzy circle. The 5x5 size is good + for most uses. +

+ +

+ With a steady hand, trace around the image. Use black + around the outside, and white around the inside. Avoid + making more than one pass without switching colors (and + thus sides). +

+ +

+ Flip views a bit, checking to see that the mask is working + well. When the WIP layer is composited over the green or + magenta, you should see a tiny bit of the original + background as an ugly fringe around the edge. If this + fringe is missing, then you made the object mask too small. + The fringe consists of pixels that are neither 100% object + nor 0% object. For them, the mask should be neither 100% + nor 0%. The fringe gets removed soon. +

+ +

+ View and edit the mask. Select by color, choosing either + black or white. Most likely you will see unselected specks + that are not quite the expected color. Invert the + selection, then paint these away using the pencil tool. Do + this operation for both white and black. +

+
+ +

+ Replace the fringe and junk pixels: +

+ +
+

+ Still viewing the mask, select by color. Choose black. + Shrink the selection by several pixels, being sure to NOT + shrink from the edges of the mask (the shrink helps you + avoid and recover from mistakes). +

+ +

+ Now disable the mask. View and edit the unmasked WIP layer. + Using the color picker tool, choose a color that is average + for the object. Drag-and-drop this color into the + selection, thus removing most of the non-object pixels. +

+ +

+ This solid color will compress well and will help prevent + ugly color fringes when Tux Paint scales the image + down. If the edge of the object has multiple colors that + are very different, you should split up your selection so + that you can color the nearby background to be similar. +

+ +

+ Now you will paint away the existing edge fringe. Be sure + that you are editing and viewing the WIP image. Frequent + layer visibility changes will help you to see what you are + doing. You are likely to use all of: +

+ + + +

+ To reduce accidents, you may wish to select only those + pixels that are not grey in the mask. (Select by color from + the mask, choose black, add mode, choose white, invert. + Alternately: Select all, select by color from the mask, + subtract mode, choose black, choose white.) If you do this, + you'll probably want to expand the selection a bit and/or + hide the "crawling ants" line that marks the selection. +

+ +

+ Use the clone tool and the brush tool. Vary the opacity as + needed. Use small round brushes mostly, perhaps 3x3 or 5x5, + fuzzy or not. (It is generally nice to pair up fuzzy + brushes with 100% opacity and non-fuzzy brushes with about + 70% opacity.) Unusual drawing modes can be helpful with + semi-transparent objects. +

+ +

+ The goal is to remove the edge fringe, both inside and + outside of the object. The inside fringe, visible when the + object is composited over magenta or green, must be removed + for obvious reasons. The outside fringe must also be + removed because it will become visible when the image is + scaled down. As an example, consider a 2x2 region of pixels + at the edge of a sharp-edged object. The left half is black + and 0% opaque. The right half is white and 100% opaque. + That is, we have a white object on a black background. When + Tux Paint scales this to 50% (a 1x1 pixel area), the + result will be a grey 50% opaque pixel. The correct result + would be a white 50% opaque pixel. To get this result, we + would paint away the black pixels. They matter, despite + being 0% opaque. +

+ +

+ Tux Paint can scale images down by a very large + factor, so it is important to extend the edge of your + object outward by a great deal. Right at the edge of your + object, you should be very accurate about this. As you go + outward away from the object, you can get a bit sloppy. It + is reasonable to paint outward by a dozen pixels or more. + The farther you go, the more Tux Paint can scale down + without creating ugly color fringes. For areas that are + more than a few pixels away from the object edge, you + should use the pencil tool (or sloppy select with + drag-and-drop color) to ensure that the result will + compress well. +

+
+ +

+ Save the image for Tux Paint +

+ +
+

+ It is very easy to ruin your hard work. Image editors can + silently destroy pixels in 0% opaque areas. The conditions + under which this happens may vary from version to version. + If you are very trusting, you can try saving your image + directly as a PNG. Be sure to read it back in again to + verify that the 0% opaque areas didn't turn black or white, + which would create fringes when Tux Paint scales the + image down. If you need to scale your image to save space + (and hide your mistakes), you are almost certain to destroy + all the 0% opaque areas. So here is a better way... +

+ +

+ A Safer Way to Save: +

+ +
+

+ Drag the mask from the layers dialog to the unused + portion of the toolbar (right after the last drawing + tool). This will create a new image consisting of one + layer that contains the mask data. Scale this as desired, + remembering the settings you use. Often you should start + with an image that is about 700 to 1500 pixels across, + and end up with one that is 300 to 400. +

+ +

+ Save the mask image as a NetPBM portable greymap + (".pgm") file. (If you are using an old + release of The GIMP, you might need to convert the + image to greyscale before you can save it.) Choose the + more compact "RAW PGM" format. (The second character + of the file should be the ASCII digit "5", hex byte + 0x35.) +

+ +

+ You may close the mask image. +

+ +

+ Going back to the multi-layer image, now select the WIP + layer. As you did with the mask, drag this from the + layers dialog to the toolbar. You should get a + single-layer image of your WIP data. If the mask came + along too, get rid of it. You should be seeing the object + and the painted-away surroundings, without any mask + thumbnail in the layers dialog. If you scaled the mask, + then scale this image in exactly the same way. Save this + image as a NetPBM portable pixmap (".ppm") + file. (Note: ppm, not pgm.) (If you choose the + RAW PPM format, the second byte of the file should + be the ASCII digit "6", hex byte 0x36.) +

+ +

+ Now you need to merge the two files into one. Do that + with the pnmtopng command, + like this: +

+ +
+

+ pnmtopng -force -compression 9 -alpha mask.pgm + fg.ppm > final-stamp.png +

+
+
+
+ + diff --git a/docs/en/html/EXTENDING.html b/docs/en/html/EXTENDING.html index 1c8b6cb04..d96945943 100644 --- a/docs/en/html/EXTENDING.html +++ b/docs/en/html/EXTENDING.html @@ -1,909 +1,1419 @@ -Extending Tux Paint - - + + + + + Extending Tux Paint + + + + +
+

+ Tux Paint
+ version 0.9.25
+ Extending Tux Paint +

- - -
-


- -version - -0.9.25 - -
-Extending Tux Paint

- -

Copyright (c) 2002-2020 by various contributors; see AUTHORS.txt
-http://www.tuxpaint.org/

- -

June 14, 2002 - - June 22, 2020

-
- -
- -

If you wish to add or change things like Brushes and Rubber Stamps -used by Tux Paint, you can do it fairly easily by simply putting -or removing files on your hard disk.

- -

Note: You'll need to restart Tux Paint for the changes to take -effect.

- -

Where Files Go

-
-

Standard Files

-
-

Tux Paint looks for its various data files in its - 'data' directory.

- -

Linux and Unix

-
-

Where this directory goes depends on what value was set for - "DATA_PREFIX" when Tux Paint was built. See - INSTALL.txt for details.

- -

By default, though, the directory is:

- -
- /usr/local/share/tuxpaint/ -
- -

If you installed from a package, it is more likely to be:

- -
- /usr/share/tuxpaint/ -
- -
- - -

Windows

-
-

Tux Paint looks for a directory called 'data' in the same - directory as the executable. This is the directory that the - installer used when installing Tux Paint e.g.:

- -
- C:\Program Files\TuxPaint\data -
- -
- - -

Mac OS X

-
-

Tux Paint stores its data files inside the "Tux Paint" - application (which is actually a special kind of folder on - Mac OS X). The following steps explain how to get to - the folders within:

- -
    -
  1. Bring up a 'context' menu by holding the [Control] key and clicking - the Tux Paint icon the in Finder. (If you have a mouse with more - than one button, you can simply right-click the icon.)
    2. -
  2. Select "Show Contents" from the menu that appears. - A new Finder window will appear with a folder inside called - "Contents."
    3. -
  3. Open the "Contents" folder and open the "Resources" folder found - inside.
    4. -
  4. There, you will find the "starters", "stamps" and "brushes" - folders. Adding new content to these folders will make the content - available to any user that launches this copy (icon) of - Tux Paint.
    5. -
- -

Note: If you install a newer version of Tux Paint - and replace or discard the old version, you will lose changes made - by following the instructions above, so keep backups of your new - content (stamps, brushes, etc.).

- -

Tux Paint also looks for files in a "TuxPaint" folder - that you can place in your system's "Application Support" folder - (found under "Library" at the root of your hard disk):

- -
- /Library/Application Support/TuxPaint/ -
- -

It also looks for files in the user's "Application Support" folder: +

+ Copyright (c) 2002-2020 by various contributors; see + AUTHORS.txt
+ http://www.tuxpaint.org/

-
- /Users/(user name)/Library/Application Support/TuxPaint/ -
- -

When you upgrade to a newer version of Tux Paint, the contents of this - TuxPaint folder will stay the same and remain accessible by all users - of Tux Paint.

+

+ June 14, 2002 - July 27, 2020 +

+
- - - +
-
- +

+ If you wish to add or change things like Brushes and Rubber + Stamps used by Tux Paint, you can do it fairly easily by + simply putting or removing files on your hard disk. +

-

Personal Files

-
-

You can also create brushes, stamps, fonts and 'starters' in your - own directory (folder) for Tux Paint to find.

- +

+ Note: You'll need to restart Tux Paint for the changes + to take effect. +

+ +

+ Where Files Go +

-

Windows

-

Your personal Tux Paint folder is stored in your - "Application Data". For example, on newer Windows (set up - for an English-speaking user):

- -
- C:\Documents and Settings\(user name)\Application - Data\TuxPaint\ -
- -
+

+ Standard Files +

-

Mac OS X

-
-

Your personal Tux Paint folder is stored in your - "Application Support" folder: - -

- /Users/(user name)/Library/Application Support/ - TuxPaint/ -
-
- -

Linux and Unix

-
-

Your personal Tux Paint directory is - "$(HOME)/.tuxpaint/" (also known as - "~/.tuxpaint/".

- -

That is, if your home directory is "/home/karl", then - your Tux Paint directory is - "/home/karl/.tuxpaint/".

- -

Don't forget the period (".") before the - 'tuxpaint'!

-
- -

To add brushes, stamps fonts, and 'starters,' create subdirectories - under your personal Tux Paint directory named - "brushes", "stamps", - "fonts" and - "starters" respectively.

- -

(For example, if you created a brush named "flower.png", - you would put it in "~/.tuxpaint/brushes/" under Linux or - Unix.)

-
- - -
- - -

Brushes

-
-

The brushes used for drawing with the 'Brush' and 'Lines' tools in - Tux Paint are simply PNG image files.

- - - -

The alpha (transparency) of the PNG image is used to determine the shape - of the brush, which means that the shape can be 'anti-aliased' and even - partially-transparent!

- -

Greyscale pixels in the brush PNG will be drawn using the - currently-selected color in Tux Paint. Color pixels will be - tinted.

- -

Brush images should be no wider than 40 pixels across and - no taller than 40 pixels high. (i.e., the maximum size - can be 40 x 40.)

- - -

Brush Options

-
-

Aside from a graphical shape, brushes can also be given other - attributes. To do this, you need to create a 'data file' - for the brush.

- -

A brush data file is simply a text file containing the options.

- -

The file has the same name as the PNG image, but a ".dat" - extension. (e.g., "brush.png"'s data file is the text - file "brush.dat" in the same directory.)

- -

Brush Spacing

-
-

As of Tux Paint version 0.9.16, you can now specify the spacing - for brushes (that is, how often they are drawn). By default, the - spacing will be the brush's height, divided by 4.

- -

Add a line containing the line "spacing=N" - to the brush's data file, where N is the spacing you want - for the brush. (The lower the number, the more often the brush is - drawn.)

-
- -

Animated Brushes

-
-

As of Tux Paint version 0.9.16, you may now create animated - brushes. As the brush is used, each frame of the animation is - drawn.

- -

Lay each frame out across a wide PNG image. For example, - if your brush is 30x30 and you have 5 frames, the image should - be 150x30.

- -

Add a line containing the line "frames=N" - to the brush's data file, where N is the number of frames - in the brush.

- -

Note: If you'd rather the frames be flipped through - randomly, rather than sequentially, also add a line containing - "random" to the brush's data file.

-
- -

Directional Brushes

-
-

As of Tux Paint version 0.9.16, you may now create directional - brushes. As the brush is used, different shapes are drawn, depending - on the direction the brush is going.

- -

The directional shapes are divided into a 3x3 square in a PNG image. - For example, if your brush is 30x30, the image should be 90x90, and - each of the direction's shapes placed in a 3x3 grid. The center - region is used for no motion. The top right is used for motion that's - both up, and to the right. And so on.

- -

Add a line containing the line "directional" - to the brush's data file.

-
- -

Animated Directional Brushes

-
-

You may mix both animated and directional features into one - brush. Use both options ("frames=N" and - "directional"), in separate lines in the - brush's "".dat" file.

- -

Lay the brush out so that each 3x3 set of directional shapes are - laid out across a wide PNG image. For example, if the brush is 30x30 - and there are 5 frames, it would be 450x90. (The leftmost 150x90 pixels - of the image represent the 9 direction shapes for the first frame, - for example.)

-
-
- -

Place the brush image PNGs (and any data text files) in the - "brushes" directory.

- -

Note: If your new brushes all come out as solid squares or rectangles, - it's because you forgot to use alpha transparency! See the documentation - file "PNG.txt" for more information and tips.

- -
-
- -
- - -

Stamps

-
-

All stamp-related files go in the "stamps" directory. - It's useful to create subdirectories and sub-subdirectories - there to organize the stamps. (For example, you can have a - "holidays" folder with "halloween" and - "christmas" sub-folders.)

- -

Images

-
-

Rubber Stamps in Tux Paint can be made up of a number of separate - files. The one file that is required is, of course, the picture - itself.

- - - -

As of Tux Paint version 0.9.17, Stamps may be either PNG - bitmap images or SVG vector images. They can be full-color or greyscale. - The alpha (transparency) channel of PNGs is used to determine the actual - shape of the picture (otherwise you'll stamp a large rectangle on your - drawings).

- -

PNGs can be any size, and Tux Paint (by default) provides - a set of sizing buttons to let the user scale the stamp up (larger) - and down (smaller).

- -

SVGs are vector-based, and will be scaled appropriately for the - canvas being used in Tux Paint.

- -

Note: If your new PNG stamps all have solid rectangular-shaped outlines - of a solid color (e.g., white or black), it's because you forgot to use - alpha transparency! See the documentation file - "PNG.txt" for more information and tips.

- -

Note: If your new SVG stamps seem to have a lot of whitespace, - make sure the SVG 'document' is no larger than the shape(s) within. - If they are being clipped, make sure the 'document' is large enough - to contain the shape(s). See the documentation file - "SVG.txt" for more information and tips.

- -

Advanced Users: The - Advanced Stamps HOWTO describes, - in detail, how to make PNG images which will scale perfectly when used as - stamps in Tux Paint.

- -
-
- -
- -

Description Text

-
-

Text (".TXT") files with the same name as the PNG or SVG. - (e.g., "picture.png"'s description is stored in - "picture.txt" in the same directory.)

- -

The first line of the text file will be used as the US English - description of the stamp's image. It must be encoded in UTF-8.

- -

Language Support

-
-

Additional lines can be added to the text file to provide - translations of the description, to be displayed when Tux Paint - is running in a different locale (like French or Spanish).

- -

The beginning of the line should correspond to the language code - of the language in question (e.g., "fr" for French, and - "zh_TW" for Traditional Chinese), followed by - ".utf8=" and the translated description (encoded - in UTF-8).

- -

There are scripts in the "po" directory for converting - the text files to PO format (and back) for easy translation to - different languages. Therefore you should never add or change translations - in the .txt files directly.

- -

If no translation is available for the language Tux Paint - is currently running in, the US English text is used.

-
- -

Windows Users

-
-

Use NotePad or WordPad to edit/create these files. - Be sure to save them as Plain Text, and make sure they have - ".txt" at the end of the filename...

-
-
- -
- -

Sound Effects

-
-

WAVE (".wav") or OGG Vorbis (".ogg") - files with the same name as the PNG or SVG. - (e.g., "picture.svg"'s sound effect is the sound file - "picture.wav" in the same directory.)

- -

Language Support

-
-

For sounds for different locales (e.g., if the sound is someone - saying a word, and you want translated versions of the word said), - also create WAV or OGG files with the locale's label in the filename, in - the form: "STAMP_LOCALE.EXT"

- -

"picture.png"'s sound effect, when Tux Paint is run - in Spanish mode, would be "picture_es.wav". - In French mode, "picture_fr.wav". In Brazilian - Portuguese mode, "picture_pt_BR.wav". And so on...

- -

If no localized sound effect can be loaded, Tux Paint will - attempt to load the 'default' sound file. - (e.g., "picture.wav")

-
- -

Note: For descriptive sounds (not sound effects, like a bang or - a bird chirping), consider using the Descriptive Sounds, - described below.

-
- -
- -

Descriptive Sound

-
-

WAVE (".wav") or OGG Vorbis (".ogg") - files with the same name as the PNG or SVG, followed by - "_desc" (e.g., "picture.svg"'s descriptive - sound is the sound file "picture_desc.ogg" in the same - directory.)

- -

Language Support

-
-

For descriptions in different languages, - also create WAV or OGG files with both "_desc" and - the locale's label in the filename, in - the form: "STAMP_desc_LOCALE.EXT"

- -

"picture.png"'s descriptive sound, when Tux Paint - is run in Spanish mode, would be "picture_desc_es.wav". - In French mode, "picture_desc_fr.wav". In - Brazilian Portuguese mode, "picture_desc_br_PT.wav". - And so on...

- -

If no localized descriptive sound can be loaded, Tux Paint will - attempt to load the 'default' descriptive sound file. - (e.g., "picture_desc.wav")

-
-
- -
- -

Stamp Options

-
-

Aside from a graphical shape, a textual description, and a sound - effect, stamps can also be given other attributes. To do this, you need - to create a 'data file' for the stamp.

- -

A stamp data file is simply a text file containing the options.

- -

The file has the same name as the PNG or SVG image, but a - ".dat" extension. (e.g., "picture.png"'s - data file is the text file "picture.dat" in the same - directory.)

- -

Colored Stamps

-
-

Stamps can be made to be either "colorable" or "tintable."

- -
Colorable
-

"Colorable" stamps they work much like brushes - you pick the stamp - to get the shape, and then pick the color you want it to be. - (Symbol stamps, like the mathematical and musical ones, are an - example.)

+

+ Tux Paint looks for its various data files in its + 'data' directory. +

-

Nothing about the original image is used except the transparency - (from "alpha" channel). The color of the stamp comes out solid.

+

+ Linux and Unix +

-
- -

Add a line containing the word "colorable" - to the stamp's data file.

-
+
+

+ Where this directory goes depends on what value was set + for "DATA_PREFIX" when Tux Paint was + built. See INSTALL.txt for details. +

-
Tinted
-
-

"Tinted" stamps are similar to "colorable" ones, except the - details of the original image are kept. (To put it technically, - the original image is used, but its hue is changed, based on the - currently-selected color.)

+

+ By default, though, the directory is: +

-
+
+ /usr/local/share/tuxpaint/ +
-

Add a line containing the word "tintable" - to the stamp's data file.

+

+ If you installed from a package, it is more likely to + be: +

-
Tinting Options:
-
-

Depending on the contents of your stamp, you might want to - have Tux Paint use one of a number of methods when tinting it. - Add one of the following lines to the stamp's data file:

+
+ /usr/share/tuxpaint/ +
+
-
-
"tinter=normal" (default)
-
This is the normal tinting mode. (Hue range is - +/- 18 degrees, 27 replace.)
+

+ Windows +

-
"tinter=anyhue"
-
This remaps all hues in the stamp. (Hue range is - +/- 180 degrees.)
+
+

+ Tux Paint looks for a directory called 'data' in + the same directory as the executable. This is the + directory that the installer used when installing + Tux Paint e.g.: +

-
"tinter=narrow"
-
This like 'anyhue', but a narrower hue angle. - (Hue range is +/- 6 degrees, 9 replace.)
+
+ C:\Program Files\TuxPaint\data +
+
-
"tinter=vector"
-
This is map 'black through white' to - 'black through destination'.
-
+

+ Mac OS X +

+
+

+ Tux Paint stores its data files inside the + "Tux Paint" application (which is actually a + special kind of folder on Mac OS X). The + following steps explain how to get to the folders + within: +

+ +
    +
  1. Bring up a 'context' menu by holding the [Control] + key and clicking the Tux Paint icon the in Finder. + (If you have a mouse with more than one button, you can + simply right-click the icon.) +
    2. + +
  2. Select "Show Contents" from the menu that + appears. A new Finder window will appear with a folder + inside called "Contents." +
    3. + +
  3. Open the "Contents" folder and open the "Resources" + folder found inside. +
    4. + +
  4. There, you will find the "starters", "stamps" and + "brushes" folders. Adding new content to these folders + will make the content available to any user that + launches this copy (icon) of Tux Paint. +
    5. +
+ +

+ Note: If you install a newer version of + Tux Paint and replace or discard the old version, + you will lose changes made by following the + instructions above, so keep backups of your new content + (stamps, brushes, etc.). +

+ +

+ Tux Paint also looks for files in a "TuxPaint" + folder that you can place in your system's + "Application Support" folder (found under + "Library" at the root of your hard disk): +

+ +
+ /Library/Application Support/TuxPaint/ +
+ +

+ It also looks for files in the user's "Application + Support" folder: +

+ +
+ /Users/(user name)/Library/Application + Support/TuxPaint/ +
+ +

+ When you upgrade to a newer version of Tux Paint, the + contents of this TuxPaint folder will stay the same and + remain accessible by all users of Tux Paint. +

+ +
+ +

+ Personal Files +

+ +
+

+ You can also create brushes, stamps, fonts and 'starters' + in your own directory (folder) for Tux Paint to + find. +

+ +

+ Windows +

+ +
+

+ Your personal Tux Paint folder is stored in your + "Application Data". For example, on newer Windows (set + up for an English-speaking user): +

+ +
+ C:\Documents and + Settings\(user name)\Application + Data\TuxPaint\ +
+
+ +

+ Mac OS X +

+ +
+

+ Your personal Tux Paint folder is stored in your + "Application Support" folder: +

+ +
+ /Users/(user name)/Library/Application + Support/ TuxPaint/ +
+
+ +

+ Linux and Unix +

+ +
+

+ Your personal Tux Paint directory is + "$(HOME)/.tuxpaint/" (also known as + "~/.tuxpaint/". +

+ +

+ That is, if your home directory is + "/home/karl", then your Tux Paint + directory is "/home/karl/.tuxpaint/". +

+ +

+ Don't forget the period (".") before the + 'tuxpaint'! +

+
+ +

+ To add brushes, stamps fonts, and 'starters,' create + subdirectories under your personal Tux Paint + directory named "brushes", + "stamps", "fonts" + and "starters" respectively. +

+ +

+ (For example, if you created a brush named + "flower.png", you would put it in + "~/.tuxpaint/brushes/" under Linux or Unix.) +

+
-

Unalterable Stamps

+
+ +

+ Brushes +

+
-

By default, a stamp can be flipped upside down, shown as a mirror - image, or both. This is done using the control buttons below the - stamp selector, at the lower right side of the screen in - Tux Paint.

+

+ The brushes used for drawing with the 'Brush' and 'Lines' + tools in Tux Paint are simply PNG image files. +

+ +

+ The alpha (transparency) of the PNG image is used to + determine the shape of the brush, which means that the + shape can be 'anti-aliased' and even partially-transparent! +

-

Sometimes, it doesn't make sense for a stamp to be flippable or - mirrored; for example, stamps of letters or numbers. - Sometimes stamps are symmetrical, so letting the user flip or mirror - them isn't useful.

+

+ Greyscale pixels in the brush PNG will be drawn using the + currently-selected color in Tux Paint. Color pixels + will be tinted. +

-

To make a stamp un-flippable, add the option - "noflip" to the stamp's data file.

+

+ Brush images should be no wider than 40 pixels across + and no taller than 40 pixels high. (i.e., the maximum + size can be 40 x 40.) +

-

To keep a stamp from being mirrored, add a line containing the word - "nomirror" to the stamp's data file.

+

+ Brush Options +

+ +
+

+ Aside from a graphical shape, brushes can also be given + other attributes. To do this, you need to create a + 'data file' for the brush. +

+ +

+ A brush data file is simply a text file containing the + options. +

+ +

+ The file has the same name as the PNG image, but a + ".dat" extension. (e.g., + "brush.png"'s data file is the text file + "brush.dat" in the same directory.) +

+ +

+ Brush Spacing +

+ +
+

+ As of Tux Paint version 0.9.16, you can now + specify the spacing for brushes (that is, how often + they are drawn). By default, the spacing will be the + brush's height, divided by 4. +

+ +

+ Add a line containing the line + "spacing=N" to the brush's + data file, where N is the spacing you want for + the brush. (The lower the number, the more often the + brush is drawn.) +

+
+ +

+ Animated Brushes +

+ +
+

+ As of Tux Paint version 0.9.16, you may now create + animated brushes. As the brush is used, each frame of + the animation is drawn. +

+ +

+ Lay each frame out across a wide PNG image. For + example, if your brush is 30x30 and you have 5 frames, + the image should be 150x30. +

+ +

+ Add a line containing the line + "frames=N" to the brush's + data file, where N is the number of frames in + the brush. +

+ +

+ Note: If you'd rather the frames be flipped + through randomly, rather than sequentially, also add a + line containing "random" to the + brush's data file. +

+
+ +

+ Directional Brushes +

+ +
+

+ As of Tux Paint version 0.9.16, you may now create + directional brushes. As the brush is used, different + shapes are drawn, depending on the direction the brush + is going. +

+ +

+ The directional shapes are divided into a 3x3 square in + a PNG image. For example, if your brush is 30x30, the + image should be 90x90, and each of the direction's + shapes placed in a 3x3 grid. The center region is used + for no motion. The top right is used for motion that's + both up, and to the right. And so on. +

+ +

+ Add a line containing the line + "directional" to the brush's data + file. +

+
+ +

+ Animated Directional Brushes +

+ +
+

+ You may mix both animated and directional features into + one brush. Use both options + ("frames=N" and + "directional"), in separate lines + in the brush's "".dat" file. +

+ +

+ Lay the brush out so that each 3x3 set of directional + shapes are laid out across a wide PNG image. For + example, if the brush is 30x30 and there are 5 frames, + it would be 450x90. (The leftmost 150x90 pixels of the + image represent the 9 direction shapes for the first + frame, for example.) +

+
+
+ +

+ Place the brush image PNGs (and any data text files) in the + "brushes" directory. +

+ +

+ Note: If your new brushes all come out as solid squares or + rectangles, it's because you forgot to use alpha + transparency! See the documentation file "PNG.txt" for more + information and tips. +

+
-

Initial Stamp Size

+
+ +

+ Stamps +

+
-

By default, Tux Paint assumes that your stamp is sized - appropriately for unscaled display on a 608x472 canvas. This is - the original Tux Paint canvas size, provided by a 640x480 screen. - Tux Paint will then adjust the stamp according to the current - canvas size and, if enabled, the user's stamp size controls.

+

+ All stamp-related files go in the + "stamps" directory. It's useful to + create subdirectories and sub-subdirectories there to + organize the stamps. (For example, you can have a + "holidays" folder with + "halloween" and "christmas" + sub-folders.) +

-

If your stamp would be too big or too small, you can specify - a scale factor. If your stamp would be 2.5 times as wide (or tall) - as it should be, add the option "scale 40%" or - "scale 5/2" or "scale 2.5" - or "scale 2:5" to your image. You may include - an "=" if you wish, as in - "scale=40%".

+

+ Images +

+ +
+

+ Rubber Stamps in Tux Paint can be made up of a + number of separate files. The one file that is required + is, of course, the picture itself. +

+ +

+ As of Tux Paint version 0.9.17, Stamps may be either + PNG bitmap images or SVG vector images. They can be + full-color or greyscale. The alpha (transparency) channel + of PNGs is used to determine the actual shape of the + picture (otherwise you'll stamp a large rectangle on your + drawings). +

+ +

+ PNGs can be any size, and Tux Paint (by default) + provides a set of sizing buttons to let the user scale + the stamp up (larger) and down (smaller). +

+ +

+ SVGs are vector-based, and will be scaled appropriately + for the canvas being used in Tux Paint. +

+ +

+ Note: If your new PNG stamps all have solid + rectangular-shaped outlines of a solid color (e.g., white + or black), it's because you forgot to use alpha + transparency! See the documentation file "PNG.txt" for more information and tips. +

+ +

+ Note: If your new SVG stamps seem to have a lot of + whitespace, make sure the SVG 'document' is no larger + than the shape(s) within. If they are being clipped, make + sure the 'document' is large enough to contain the + shape(s). See the documentation file "SVG.txt" for more information and tips. +

+ +

+ Advanced Users: The Advanced Stamps HOWTO + describes, in detail, how to make PNG images which will + scale perfectly when used as stamps in Tux Paint. +

+
+
+ +
+ +

+ Description Text +

+ +
+

+ Text (".TXT") files with the same name as the PNG or SVG. + (e.g., "picture.png"'s description is stored + in "picture.txt" in the same directory.) +

+ +

+ The first line of the text file will be used as the US + English description of the stamp's image. It must be + encoded in UTF-8. +

+ +

+ Language Support +

+ +
+

+ Additional lines can be added to the text file to + provide translations of the description, to be + displayed when Tux Paint is running in a different + locale (like French or Spanish). +

+ +

+ The beginning of the line should correspond to the + language code of the language in question (e.g., + "fr" for French, and "zh_TW" + for Traditional Chinese), followed by + ".utf8=" and the translated description + (encoded in UTF-8). +

+ +

+ There are scripts in the "po" directory + for converting the text files to PO format (and back) + for easy translation to different languages. Therefore + you should never add or change translations in the .txt + files directly. +

+ +

+ If no translation is available for the language + Tux Paint is currently running in, the US English + text is used. +

+
+ +

+ Windows Users +

+ +
+

+ Use NotePad or WordPad to edit/create these files. Be + sure to save them as Plain Text, and make sure they + have ".txt" at the end of the filename... +

+
+
+ +
+ +

+ Sound Effects +

+ +
+

+ WAVE (".wav") or OGG Vorbis (".ogg") files with the same + name as the PNG or SVG. (e.g., + "picture.svg"'s sound effect is the sound + file "picture.wav" in the same directory.) +

+ +

+ Language Support +

+ +
+

+ For sounds for different locales (e.g., if the sound is + someone saying a word, and you want translated versions + of the word said), also create WAV or OGG files with + the locale's label in the filename, in the form: + "STAMP_LOCALE.EXT" +

+ +

+ "picture.png"'s sound effect, when + Tux Paint is run in Spanish mode, would be + "picture_es.wav". In French mode, + "picture_fr.wav". In Brazilian Portuguese + mode, "picture_pt_BR.wav". And so on... +

+ +

+ If no localized sound effect can be loaded, + Tux Paint will attempt to load the 'default' sound + file. (e.g., "picture.wav") +

+
+ +

+ Note: For descriptive sounds (not sound effects, like a + bang or a bird chirping), consider using the + Descriptive Sounds, described below. +

+
+ +
+ +

+ Descriptive Sound +

+ +
+

+ WAVE (".wav") or OGG Vorbis (".ogg") files with the same + name as the PNG or SVG, followed by "_desc" + (e.g., "picture.svg"'s descriptive sound is + the sound file "picture_desc.ogg" in the + same directory.) +

+ +

+ Language Support +

+ +
+

+ For descriptions in different languages, also create + WAV or OGG files with both "_desc" and the + locale's label in the filename, in the form: + "STAMP_desc_LOCALE.EXT" +

+ +

+ "picture.png"'s descriptive sound, when + Tux Paint is run in Spanish mode, would be + "picture_desc_es.wav". In French mode, + "picture_desc_fr.wav". In Brazilian + Portuguese mode, "picture_desc_br_PT.wav". + And so on... +

+ +

+ If no localized descriptive sound can be loaded, + Tux Paint will attempt to load the 'default' + descriptive sound file. (e.g., + "picture_desc.wav") +

+
+
+ +
+ +

+ Stamp Options +

+ +
+

+ Aside from a graphical shape, a textual description, and + a sound effect, stamps can also be given other + attributes. To do this, you need to create a + 'data file' for the stamp. +

+ +

+ A stamp data file is simply a text file containing the + options. +

+ +

+ The file has the same name as the PNG or SVG image, but a + ".dat" extension. (e.g., + "picture.png"'s data file is the text file + "picture.dat" in the same directory.) +

+ +

+ Colored Stamps +

+ +
+

+ Stamps can be made to be either "colorable" or + "tintable." +

+ +
+ Colorable +
+ +
+

+ "Colorable" stamps they work much like brushes - you + pick the stamp to get the shape, and then pick the + color you want it to be. (Symbol stamps, like the + mathematical and musical ones, are an example.) +

+ +

+ Nothing about the original image is used except the + transparency (from "alpha" channel). The color of the + stamp comes out solid. +

+ +
+ +
+ +

+ Add a line containing the word + "colorable" to the stamp's data + file. +

+
+ +
+ Tinted +
+ +
+

+ "Tinted" stamps are similar to "colorable" ones, + except the details of the original image are kept. + (To put it technically, the original image is used, + but its hue is changed, based on the + currently-selected color.) +

+ +
+ +
+ +

+ Add a line containing the word + "tintable" to the stamp's data + file. +

+ +
+ Tinting Options: +
+ +
+

+ Depending on the contents of your stamp, you might + want to have Tux Paint use one of a number of + methods when tinting it. Add one of the following + lines to the stamp's data file: +

+ +
+
+ "tinter=normal" (default) +
+ +
+ This is the normal tinting mode. (Hue range is + +/- 18 degrees, 27 replace.) +
+ +
+ "tinter=anyhue" +
+ +
+ This remaps all hues in the stamp. (Hue range is + +/- 180 degrees.) +
+ +
+ "tinter=narrow" +
+ +
+ This like 'anyhue', but a narrower hue angle. + (Hue range is +/- 6 degrees, 9 + replace.) +
+ +
+ "tinter=vector" +
+ +
+ This is map 'black through white' to 'black + through destination'. +
+
+
+
+
+ +

+ Unalterable Stamps +

+ +
+

+ By default, a stamp can be flipped upside down, shown + as a mirror image, or both. This is done using the + control buttons below the stamp selector, at the lower + right side of the screen in Tux Paint. +

+ +

+ Sometimes, it doesn't make sense for a stamp to be + flippable or mirrored; for example, stamps of letters + or numbers. Sometimes stamps are symmetrical, so + letting the user flip or mirror them isn't useful. +

+ +

+ To make a stamp un-flippable, add the option + "noflip" to the stamp's data file. +

+ +

+ To keep a stamp from being mirrored, add a line + containing the word "nomirror" to + the stamp's data file. +

+
+ +

+ Initial Stamp Size +

+ +
+

+ By default, Tux Paint assumes that your stamp is + sized appropriately for unscaled display on a 608x472 + canvas. This is the original Tux Paint canvas + size, provided by a 640x480 screen. Tux Paint will + then adjust the stamp according to the current canvas + size and, if enabled, the user's stamp size controls. +

+ +

+ If your stamp would be too big or too small, you can + specify a scale factor. If your stamp would be 2.5 + times as wide (or tall) as it should be, add the option + "scale 40%" or "scale + 5/2" or "scale 2.5" or + "scale 2:5" to your image. You may + include an "=" if you wish, as in + "scale=40%". +

+
+ +

+ Windows Users +

+ +
+

+ You can use NotePad or WordPad to create these file. Be + sure to save it as Plain Text, and make sure the + filename has ".dat" at the end, and not + ".txt"... +

+
+
+ +

+ Pre-Mirrored and Flipped Images +

+ +
+

+ In some cases, you may wish to provide a pre-drawn + version of a stamp's mirror-image, flipped image, or even + both. For example, imagine a picture of a fire truck + with the words "Fire Department" written + across the side. You probably do not want that text to + appear backwards when the image is flipped! +

+ +

+ To create a mirrored version of a stamp that you want + Tux Paint to use, rather than mirroring one on its + own, simply create a second ".png" or + ".svg" graphics file with the same name, + except with "_mirror" before the + filename extension. +

+ +

+ For example, for the stamp + "truck.png" you would create another + file named "truck_mirror.png", which + will be used when the stamp is mirrored (rather than + using a backwards version of 'truck.png'). +

+ +

+ As of Tux Paint 0.9.18, you may similarly provide a + pre-flipped image with "_flip" in the + name, and/or an image that is both mirrored and flipped, + by naming it "_mirror_flip". +

+ +

+ Note: If the user flips and mirrors an image, and + a pre-drawn "_mirror_flip" doesn't exist, + but either "_flip" or "_mirror" + does, it will be used, and mirrored or flipped, + respectively. +

+
+
+ +

+ Fonts +

-

Windows Users

-

You can use NotePad or WordPad to create these file. - Be sure to save it as Plain Text, and make sure the filename - has ".dat" at the end, and not ".txt"...

+ +

+ The fonts used by Tux Paint are TrueType Fonts + (TTF). +

+ +

+ Simply place them in the "fonts" + directory. Tux Paint will load the font and provide + four different sizes in the 'Letters' selector when using + the 'Text' tool. +

+
-
-

Pre-Mirrored and Flipped Images

-
-

In some cases, you may wish to provide a pre-drawn version of - a stamp's mirror-image, flipped image, or even both. For example, - imagine a picture of a fire truck with the words - "Fire Department" written across the side. You probably - do not want that text to appear backwards when the image is flipped!

+
-

To create a mirrored version of a stamp that you want Tux Paint - to use, rather than mirroring one on its own, simply create a second - ".png" or ".svg" graphics file with the - same name, except with "_mirror" before the filename - extension.

- -

For example, for the stamp "truck.png" you would - create another file named "truck_mirror.png", which - will be used when the stamp is mirrored (rather than using a - backwards version of 'truck.png').

+

+ 'Starters' +

-

As of Tux Paint 0.9.18, you may similarly provide a pre-flipped - image with "_flip" in the name, and/or an image that - is both mirrored and flipped, by naming it - "_mirror_flip".

+
+ +

+ 'Starter' images appear in the 'New' dialog, along with + solid color background choices. (Note: In earlier versions + of Tux Paint, they appeared in the 'Open' dialog, + together with saved drawings.) +

-

Note: If the user flips and mirrors an image, and a pre-drawn - "_mirror_flip" doesn't exist, but either "_flip" - or "_mirror" does, it will be used, and mirrored or flipped, - respectively.

-
- -
+

+ Unlike pictures drawn in Tux Paint by users and then + opened later, opening a 'starter' creates a new drawing. + When you save, the 'starter' image is not overwritten. + Additionally, as you edit your new picture, the contents of + the original 'starter' affect it. +

+ Coloring-Book Style +
+

+ The most basic kind of 'starter' is similar to a picture + in a coloring book. It's an outline of a shape which you + can then color in and add details to. In Tux Paint, + as you draw, type text, or stamp stamps, the outline + remains 'above' what you draw. You can erase the parts of + the drawing you made, but you can't erase the outline. +

-
+

+ To create this kind of 'starter' image, simply draw an + outlined picture in a paint program, make the rest of the + graphic transparent (that will come out as white in + Tux Paint), and save it as a PNG format file. +

+

+ Note: Previous to Tux Paint 0.9.21, images needed + to be black and transparent. As of 0.9.21, if a Starter + is black and white, with no transparency, white will be + converted to transparent when the Starter is opened. +

-

Fonts

-
- +

+ Note: Previous to Tux Paint 0.9.22, Starters had + to be in PNG or JPEG (backgrounds only) format. As of + 0.9.22, they may be in SVG (vector graphics) or KPX + (templates from Kid Pix, another childrens' drawing + program; they are special files which simply contain a + JPEG within). +

+
+ Scene-Style +
+

+ Along with the 'coloring-book' style overlay, you can + also provide a separate background image as part of a + 'starter' picture. The overlay acts the same: it can't be + drawn over, erased, or affected by 'Magic' tools. + However, the background can be! +

-

The fonts used by Tux Paint are TrueType Fonts (TTF).

- -

Simply place them in the "fonts" directory. - Tux Paint will load the font and provide four different sizes - in the 'Letters' selector when using the 'Text' tool.

+

+ When the 'Eraser' tool is used on a picture based on this + kind of 'starter' image, rather than turning the canvas + to a solid color, such as white, it returns that part of + the canvas to the original background picture from the + 'starter'. +

-
-
+

+ By creating both an overlay and a background, you can + create a 'starter' which simulates depth. Imagine a + background that shows the ocean, and an overlay that's a + picture of a reef. You can then draw (or stamp) fish in + the picture. They'll appear in the ocean, but never 'in + front of' the reef. +

-
+

+ To create this kind of 'starter' picture, simply create + an overlay (with transparency) as described above, and + save it as a PNG. Then create another image (without + transparency), and save it with the same filename, but + with "-back" appended to the name. (e.g., + "reef-back.png" would be the background + ocean picture that corresponds to the + "reef.png" overlay, or foreground.) +

+
+

+ The 'starter' images should be the same size as + Tux Paint's canvas. (See the "Loading Other Pictures + into Tux Paint" section of README for details on sizing.) If they + are not, they will be stretched, without affecting the + shape ("aspect ratio"); however some smudging may be + applied to the edges. +

-

'Starters'

-
- +

+ Place them in the "starters" directory. + When the 'New' dialog is accessed in Tux Paint, the + 'starter' images will appear in the screen that appears, + after the various solid color choices. +

-

'Starter' images appear in the 'New' dialog, along with solid - color background choices. (Note: In earlier versions of Tux Paint, - they appeared in the 'Open' dialog, together with saved drawings.)

- -

Unlike pictures drawn in Tux Paint by users and then opened - later, opening a 'starter' creates a new drawing. When you save, the - 'starter' image is not overwritten. Additionally, as you edit your new - picture, the contents of the original 'starter' affect it.

+

+ Note: 'Starters' can't be saved over from within + Tux Paint, since loading a 'starter' is really like + creating a new image. (Instead of being blank, though + there's already something there to work with.) The 'Save' + command simply creates a new picture, like it would if the + 'New' command had been used. +

- Coloring-Book Style - -
-

The most basic kind of 'starter' is similar to a picture in a coloring - book. It's an outline of a shape which you can then color in and - add details to. In Tux Paint, as you draw, type text, or stamp - stamps, the outline remains 'above' what you draw. You can erase the - parts of the drawing you made, but you can't erase the outline.

+

+ Note: 'Starters' are 'attached' to saved pictures, + via a small text file that has the same name as the saved + file, but with ".dat" as the extension. This + allows the overlay and background, if any, to continue to + affect the drawing even after Tux Paint has been quit, + or another picture loaded or started. (In other words, if + you base a drawing on a 'starter' image, it will always be + affected by it.) +

+
+
-

To create this kind of 'starter' image, simply draw an outlined - picture in a paint program, make the rest of the graphic transparent - (that will come out as white in Tux Paint), and save it as a - PNG format file.

+
-

Note: Previous to Tux Paint 0.9.21, images needed to be - black and transparent. As of 0.9.21, if a Starter is black and white, - with no transparency, white will be converted to transparent when the - Starter is opened.

+

+ 'Templates' +

-

Note: Previous to Tux Paint 0.9.22, Starters had to be in - PNG or JPEG (backgrounds only) format. As of 0.9.22, they may be in - SVG (vector graphics) or KPX (templates from Kid Pix, another childrens' - drawing program; they are special files which simply contain a JPEG - within).

-
+
+ +

+ 'Template' images also appear in the 'New' dialog, along + with solid color background choices and 'Starters'. (Note: + Tux Paint prior to version 0.9.22 did not have the + 'Template' feature.) +

- Scene-Style +

+ Unlike pictures drawn in Tux Paint by users and then + opened later, opening a 'template' creates a new drawing. + When you save, the 'template' image is not overwritten. + Unlike 'starters', there is no immutable 'layer' above the + canvas. You may draw over any part of it. +

-
-

Along with the 'coloring-book' style overlay, you can also provide - a separate background image as part of a 'starter' picture. The - overlay acts the same: it can't be drawn over, erased, or affected by - 'Magic' tools. However, the background can be!

+

+ When the 'Eraser' tool is used on a picture based on a + 'template', rather than turning the canvas to a solid + color, such as white, it returns that part of the canvas to + the original picture from the 'template'. +

-

When the 'Eraser' tool is used on a picture based on this kind of - 'starter' image, rather than turning the canvas to a solid color, - such as white, it returns that part of the canvas to the original - background picture from the 'starter'.

+

+ 'Templates' are simply image files (in PNG, JPG, SVG or KPX + format). No preparation or conversion should be required. +

-

By creating both an overlay and a background, you can create a - 'starter' which simulates depth. Imagine a background that shows - the ocean, and an overlay that's a picture of a reef. You can then - draw (or stamp) fish in the picture. They'll appear in the ocean, - but never 'in front of' the reef.

+

+ The 'template' images should be the same size as + Tux Paint's canvas. (See the "Loading Other Pictures + into Tux Paint" section of README for details on sizing.) If they + are not, they will be stretched, without affecting the + shape ("aspect ratio"); however some smudging may be + applied to the edges. +

-

To create this kind of 'starter' picture, simply create an overlay - (with transparency) as described above, and save it as a PNG. - Then create another image (without transparency), and save it with - the same filename, but with "-back" appended to the - name. (e.g., "reef-back.png" would be the background - ocean picture that corresponds to the "reef.png" - overlay, or foreground.)

-
- -

The 'starter' images should be the same size as Tux Paint's - canvas. (See the "Loading Other Pictures into Tux Paint" section of - README for details on sizing.) If they are not, - they will be stretched, without affecting the shape ("aspect ratio"); - however some smudging may be applied to the edges.

- -

Place them in the "starters" directory. - When the 'New' dialog is accessed in Tux Paint, the 'starter' - images will appear in the screen that appears, after the various solid color - choices.

- -

Note: 'Starters' can't be saved over from within Tux Paint, - since loading a 'starter' is really like creating a new image. - (Instead of being blank, though there's already something there to work - with.) The 'Save' command simply creates a new picture, like it would - if the 'New' command had been used.

+

+ Place them in the "templates" + directory. When the 'New' dialog is accessed in + Tux Paint, the 'template' images will appear in the + screen that appears, after the various solid color choices + and 'starters'. +

-

Note: 'Starters' are 'attached' to saved pictures, via a - small text file that has the same name as the saved file, but with - ".dat" as the extension. This allows the overlay and - background, if any, to continue to affect the drawing even after - Tux Paint has been quit, or another picture loaded or started. - (In other words, if you base a drawing on a 'starter' image, it will - always be affected by it.)

+

+ Note: 'Templates' can't be saved over from within + Tux Paint, since loading a 'template' is really like + creating a new image. (Instead of being blank, though + there's already something there to work with.) The 'Save' + command simply creates a new picture, like it would if the + 'New' command had been used. +

-
-
+

+ Note: 'Templates' are 'attached' to saved pictures, + via a small text file that has the same name as the saved + file, but with ".dat" as the extension. This + allows the background to continue to be available to the + drawing (e.g., when using the 'Eraser' tool) even after + Tux Paint has been quit, or another picture loaded or + started. (In other words, if you base a drawing on a + 'template' image, it will always be affected by it.) +

+
+
-
+
-

'Templates'

-
- +

+ Translations +

-

'Template' images also appear in the 'New' dialog, along with solid - color background choices and 'Starters'. (Note: Tux Paint prior to - version 0.9.22 did not have the 'Template' feature.)

- -

Unlike pictures drawn in Tux Paint by users and then opened - later, opening a 'template' creates a new drawing. When you save, the - 'template' image is not overwritten. Unlike 'starters', there is no - immutable 'layer' above the canvas. You may draw over any part of it.

+
+

+ Tux Paint supports numerous languages, thanks to use of the + "gettext" localization library. (See OPTIONS for how to change locales in + Tux Paint.) +

-

When the 'Eraser' tool is used on a picture based on a 'template', - rather than turning the canvas to a solid color, such as white, it - returns that part of the canvas to the original picture from the - 'template'.

+

+ To translate Tux Paint to a new language, copy the + translation template file, "tuxpaint.pot" + (found in Tux Paint's source code, in the folder + "src/po/"). Rename the copy as a + ".po" file, with an appropriate name for the + locale you're translating to (e.g., "es.po" + for Spanish; or "pt_BR.po" for + Brazilian Portuguese, versus "pt.po" or + "pt_PT.po" for Portuguese spoken in Portugal.) +

-

'Templates' are simply image files (in PNG, JPG, SVG or KPX format). - No preparation or conversion should be required.

- -

The 'template' images should be the same size as Tux Paint's - canvas. (See the "Loading Other Pictures into Tux Paint" section of - README for details on sizing.) If they are not, - they will be stretched, without affecting the shape ("aspect ratio"); - however some smudging may be applied to the edges.

- -

Place them in the "templates" directory. - When the 'New' dialog is accessed in Tux Paint, the 'template' - images will appear in the screen that appears, after the various solid color - choices and 'starters'.

- -

Note: 'Templates' can't be saved over from within Tux Paint, - since loading a 'template' is really like creating a new image. - (Instead of being blank, though there's already something there to work - with.) The 'Save' command simply creates a new picture, like it would - if the 'New' command had been used.

+

+ Open the newly-created ".po" file — you can + edit in a plain text edtior, such as Emacs, Pico or + VI on Linux, or NotePad on Windows. The original English + text used in Tux Paint is listed in lines starting + with "msgid". Enter your translations of each + of these pieces of text in the empty "msgstr" + lines directly below the corresponding "msgid" + lines. (Note: Do not remove the quotes.) +

-

Note: 'Templates' are 'attached' to saved pictures, via a - small text file that has the same name as the saved file, but with - ".dat" as the extension. This allows the background - to continue to be available to the drawing (e.g., when using the 'Eraser' - tool) even after Tux Paint has been quit, or another picture loaded - or started. (In other words, if you base a drawing on a 'template' image, - it will always be affected by it.)

+

+ Example: +

-
-
+
+

+ msgid "Smudge"
+ msgstr "Manchar"
+  
+ msgid "Click and drag to draw large bricks."
+ msgstr "Haz clic y arrastra para dibujar ladrillos + grandes." +

+
-
+

+ A graphical tool, called poEdit (http://www.poedit.net/), is + available for Linux, Windows and Mac OS X. +

+

+ Note: It is best to always work off of the + latest Tux Paint text catalog template + ("tuxpaint.pot"), since new text is added, and + old text is occasionally changed. The text catalog for the + upcoming, unreleased version of Tux Paint can be found + in Tux Paint's CVS repository (see: http://www.tuxpaint.org/download/source/cvs/), + and on the Tux Paint website at http://www.tuxpaint.org/help/po/. +

-

Translations

-
-

Tux Paint supports numerous languages, thanks to use of the - "gettext" localization library. (See OPTIONS - for how to change locales in Tux Paint.)

+

+ To edit an existing translation, download the latest + ".po" file for that language, and edit it as + described above. +

-

To translate Tux Paint to a new language, copy the translation - template file, "tuxpaint.pot" (found in Tux Paint's - source code, in the folder "src/po/"). Rename the copy as a - ".po" file, with an appropriate name for the locale you're - translating to (e.g., "es.po" for Spanish; or - "pt_BR.po" for Brazilian Portuguese, versus - "pt.po" or "pt_PT.po" for Portuguese spoken in - Portugal.)

+

+ You may send new or edited translation files to + Bill Kendrick, lead developer of Tux Paint, at: + bill@newbreedsoftware.com, + or post them to the "tuxpaint-i18n" mailing list (see: + http://www.tuxpaint.org/lists/). +

-

Open the newly-created ".po" file — you can edit - in a plain text edtior, such as Emacs, Pico or VI on Linux, or - NotePad on Windows. The original English text used in Tux Paint - is listed in lines starting with "msgid". Enter your - translations of each of these pieces of text in the empty - "msgstr" lines directly below the corresponding - "msgid" lines. (Note: Do not remove the quotes.)

+

+ Alternatively, if you have an account with SourceForge.net, you can + request to be added to the "tuxpaint" project + and receive write-access to the CVS source code repository + so that you may commit your changes directly. +

-

Example:

+

+ Note: Additional locale support also requires + additions to Tux Paint's source code + (/src/i18n.h and /src/i18n.c), + and requires updates to the Makefile, to have + the ".po" gettext catalog source files + compiled into ".mo" files, and installed, for + use at runtime. +

+
-
-

msgid "Smudge"
- msgstr "Manchar"
-  
- msgid "Click and drag to draw large bricks."
- msgstr "Haz clic y arrastra para dibujar ladrillos grandes." -

-
+

+ Alternative Input Methods +

-

A graphical tool, called poEdit - (http://www.poedit.net/), is available - for Linux, Windows and Mac OS X.

+
+

+ As of version 0.9.17, Tux Paint's "Text" tool can + provide alternative input methods for some languages. For + example, when Tux Paint is running with a Japanese + locale, the right [Alt] key can be pressed to + cycle between Latin, Romanized Hiragana and Romanized + Katakana modes. This allows native characters and words to + be entered into the "Text" tool by typing one or more keys + on a keyboard with Latin characters (e.g., a US QWERTY + keyboard). +

-

Note: It is best to always work off of the latest - Tux Paint text catalog template ("tuxpaint.pot"), - since new text is added, and old text is occasionally changed. - The text catalog for the upcoming, unreleased version of Tux Paint - can be found in Tux Paint's CVS repository - (see: http://www.tuxpaint.org/download/source/cvs/), - and on the Tux Paint website at - http://www.tuxpaint.org/help/po/.

+

+ To create an input method for a new locale, create a text + file with a name based on the locale (e.g., + "ja" for Japanese), with ".im" as + the extension (e.g., "ja.im"). +

-

To edit an existing translation, download the latest ".po" - file for that language, and edit it as described above.

+

+ The ".im" file can have multiple character + mapping sections for different character mapping modes. For + example, on a Japanese typing system, typing + [K] [A] in Hiragana mode generates a + different Unicode character than typing + [K] [A] in Katakana mode. +

-

You may send new or edited translation files to Bill Kendrick, - lead developer of Tux Paint, at: - bill@newbreedsoftware.com, - or post them to the "tuxpaint-i18n" mailing list - (see: http://www.tuxpaint.org/lists/).

- -

Alternatively, if you have an account with - SourceForge.net, you can request - to be added to the "tuxpaint" project and receive write-access - to the CVS source code repository so that you may commit your changes - directly.

+

+ List the character mappings in this file, one per line. + Each line should contain (separated by whitespace): +

-

Note: Additional locale support also requires additions - to Tux Paint's source code (/src/i18n.h and - /src/i18n.c), and requires updates to the Makefile, - to have the ".po" gettext catalog source files compiled into - ".mo" files, and installed, for use at runtime.

+
    +
  • the Unicode value of the character, in hexadecimal + (more than one character can be listed, separated by a + colon (':'), this allowing some sequences to map to words) +
    • -
+
  • the keycode sequence (the ASCII characters that must be + entered to generate the Unicode character) +
    • -

    Alternative Input Methods

    -
    -

    As of version 0.9.17, Tux Paint's "Text" tool can provide - alternative input methods for some languages. For example, when - Tux Paint is running with a Japanese locale, the - right [Alt] key can be pressed to cycle between Latin, - Romanized Hiragana and Romanized Katakana modes. - This allows native characters and words to be entered into the "Text" tool by - typing one or more keys on a keyboard with Latin characters (e.g., a - US QWERTY keyboard).

    +
  • a flag (or "-") +
    • + -

    To create an input method for a new locale, create a text file - with a name based on the locale (e.g., "ja" for Japanese), - with ".im" as the extension (e.g., "ja.im").

    +

    + Start additional character mapping sections with a line + containign the word "section". +

    -

    The ".im" file can have multiple character mapping sections - for different character mapping modes. For example, on a Japanese typing - system, typing [K] [A] in Hiragana mode generates a - different Unicode character than typing - [K] [A] in Katakana mode.

    +

    + Example: +

    -

    List the character mappings in this file, one per line. Each line should - contain (separated by whitespace):

    - -
      -
    • the Unicode value of the character, in hexadecimal - (more than one character can be listed, separated by a colon (':'), - this allowing some sequences to map to words) -
    • the keycode sequence (the ASCII characters that must be entered to - generate the Unicode character) -
    • a flag (or "-") -
    +
    +

    + # Hiragana
    + 304B   ka   -
    + 304C   ga   -
    + 304D   ki   -
    + 304E   gi   -
    + 304D:3083   kya   -
    + 3063:305F   tta   -
    +  
    + # Katakana
    + section
    + 30AB   ka   -
    + 30AC   ga   -
    + 30AD   ki   -
    + 30AE   gi   -     +

    +
    -

    Start additional character mapping sections with a line containign the word - "section".

    +

    + Note: Blank lines within the ".im" file + will be ignored, as will any text following a + "#" (pound/hash) character — it can be used to + denote comments, as seen in the example above. +

    -

    Example:

    - -
    -

    # Hiragana
    - 304B   ka   -
    - 304C   ga   -
    - 304D   ki   -
    - 304E   gi   -
    - 304D:3083   kya   -
    - 3063:305F   tta   -
    -  
    - # Katakana
    - section
    - 30AB   ka   -
    - 30AC   ga   -
    - 30AD   ki   -
    - 30AE   gi   - -

    -
    - -

    Note: Blank lines within the ".im" file - will be ignored, as will any text following a "#" - (pound/hash) character — it can be used to denote comments, - as seen in the example above.

    - -

    Note: Meanings of the flags are locale-specific, and are processed - by the language-specific source code in "src/im.c". - For example, "b" is used in Korean to handle - Batchim, which may carry over to the next character.

    - -

    Note: Additional input method support also requires additions - to Tux Paint's source code (/src/im.c), and requires - updates to the Makefile, - to have the ".im" files installed, for use at runtime.

    -
    - - +

    + Note: Meanings of the flags are locale-specific, and + are processed by the language-specific source code in + "src/im.c". For example, "b" is + used in Korean to handle Batchim, which may carry over to + the next character. +

    +

    + Note: Additional input method support also requires + additions to Tux Paint's source code + (/src/im.c), and requires updates to the + Makefile, to have the ".im" files + installed, for use at runtime. +

    +
    + + diff --git a/docs/en/html/FAQ.html b/docs/en/html/FAQ.html index 455ed40bf..ff3df3486 100644 --- a/docs/en/html/FAQ.html +++ b/docs/en/html/FAQ.html @@ -1,713 +1,1177 @@ -Tux Paint Frequently Asked Questions - - + + + + + Tux Paint Frequently Asked Questions + + + + +
    +

    + Tux Paint
    + version 0.9.25
    + Frequently Asked Questions +

    - +

    + Copyright (c) 2002-2020 by various contributors; see + AUTHORS.txt
    + http://www.tuxpaint.org/ +

    -
    -


    -version +

    + September 14, 2002 - July 27, 2020 +

    +

    -0.9.25 - -
    -Frequently Asked Questions - -

    Copyright (c) 2002-2020 by various contributors; see AUTHORS.txt
    -http://www.tuxpaint.org/

    - -

    September 14, 2002 - - - July 27, 2020

    -
    - -

    Drawing-related

    - - - -

    Interface Problems

    - - -

    Printing

    - - -

    Saving

    - - -

    Audio Problems

    - + + +

    + Other Probelms +

    + + + +

    + Help / Contact +

    + +

    + Any questions you don't see answered? Let me know! +

    + +
    +

    + bill@newbreedsoftware.com +

    +
    + +

    + Or post to our 'tuxpaint-users' mailing list: +

    + +
    +

    + http://www.tuxpaint.org/lists/ +

    +
    + + diff --git a/docs/en/html/OPTIONS.html b/docs/en/html/OPTIONS.html index 18dc11670..90cf1f468 100644 --- a/docs/en/html/OPTIONS.html +++ b/docs/en/html/OPTIONS.html @@ -1,2735 +1,5562 @@ -Tux Paint Options Documentation - - + + + + + Tux Paint Options Documentation + + + + +
    +

    + Tux Paint
    + version 0.9.25 +

    - +

    + Options Documentation +

    -
    -

    Tux Paint
    +

    + Copyright (c) 2002-2020 by various contributors; see + AUTHORS.txt
    + http://www.tuxpaint.org/ +

    -version +

    + July 27, 2020 +

    +

    -0.9.25 +
    - -

    Options Documentation

    +

    + Tux Paint Config. +

    -

    Copyright (c) 2002-2020 by various contributors; see AUTHORS.txt
    -http://www.tuxpaint.org/

    - -

    July 26, 2020

    - - -
    - -
    - -

    Tux Paint Config.

    -
    -

    As of Tux Paint version 0.9.14, a graphical tool is available - that allows you to change Tux Paint's behavior. However, if you'd - rather not install and use this tool, or want a better understanding of - the available options, please continue reading.

    -
    - -
    - -

    Configuration File

    -
    -

    You can create a simple configuration file for Tux Paint, which it - will read each time you start it up.

    - -

    The file is simply a plain text file containing the options - you want enabled:

    - -

    Linux and Unix Users

    -
    -

    The file you should create is called - ".tuxpaintrc" - and it should be placed in your home directory. - (a.k.a. "~/.tuxpaintrc" or - "$HOME/.tuxpaintrc")

    - -

    System-Wide Configuration File

    -

    Before this file is read, a system-wide configuration file is - read. (By default, this configuration has no settings enabled.) - It is located at:

    +

    + As of Tux Paint version 0.9.14, a graphical tool + is available that allows you to change Tux Paint's + behavior. However, if you'd rather not install and use this + tool, or want a better understanding of the available + options, please continue reading. +

    +
    + +
    + +

    + Configuration File +

    + +
    +

    + You can create a simple configuration file for + Tux Paint, which it will read each time you start it + up. +

    + +

    + The file is simply a plain text file containing the options + you want enabled: +

    + +

    + Linux and Unix Users +

    - /etc/tuxpaint/tuxpaint.conf +

    + The file you should create is called + ".tuxpaintrc" and it should be placed + in your home directory. (a.k.a. + "~/.tuxpaintrc" or + "$HOME/.tuxpaintrc") +

    + +

    + System-Wide Configuration File +

    + +
    +

    + Before this file is read, a system-wide configuration + file is read. (By default, this configuration has no + settings enabled.) It is located at: +

    + +
    + /etc/tuxpaint/tuxpaint.conf +
    + +

    + You can disable reading of this file altogether, + leaving the settings as defaults (which can then be + overridden by your ".tuxpaintrc" file + and/or command-line arguments) by using the + command-line option: +

    + +
    + --nosysconfig +
    +
    - -

    You can disable reading of this file altogether, leaving the - settings as defaults (which can then be overridden by your - ".tuxpaintrc" file and/or command-line arguments) - by using the command-line option:

    + +

    + Mac OS X Users +

    - --nosysconfig +

    + The file you should create is called + "tuxpaint.cfg" and it should be + placed in your home folder, under the sub-folder: + Library/Application Support/TuxPaint +

    + +

    + System-Wide Configuration File +

    + +
    +

    + Before this file is read, a system-wide configuration + file is read. (By default, this configuration has no + settings enabled.) It is located at: +

    + +
    + /Library/Application + Support/TuxPaint/tuxpaint.cfg +
    +
    -
    -
    -

    Mac OS X Users

    -
    -

    The file you should create is called - "tuxpaint.cfg" - and it should be placed in your home folder, under the sub-folder: - Library/Application Support/TuxPaint -

    - -

    System-Wide Configuration File

    -
    -

    Before this file is read, a system-wide configuration file is - read. (By default, this configuration has no settings enabled.) - It is located at:

    +

    + Windows Users +

    - /Library/Application Support/TuxPaint/tuxpaint.cfg +

    + The file you should create is called + "tuxpaint.cfg" and it should be + placed in Tux Paint's folder. +

    + +

    + You can use NotePad or WordPad to create this file. Be + sure to save it as Plain Text, and make sure the filename + doesn't have ".txt" at the end... +

    -
    - -

    Windows Users

    -
    -

    The file you should create is called - "tuxpaint.cfg" and it - should be placed in Tux Paint's folder.

    - -

    You can use NotePad or WordPad to create this file. - Be sure to save it as Plain Text, and make sure the filename - doesn't have ".txt" at the end...

    -
    -
    - -
    - -

    Available Options

    -
    -

    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
    -
    - Run the program in full screen mode, rather than in a window. -
    - -
    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. -

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

    - -
    nosound=yes
    -
    - Disable sound effects. (Note: Pressing [Alt] + [S] - cannot be used to reenable sounds if they were disabled using this option.) -
    - -
    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.) -
    - -
    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].

    -
    - -
    noprint=yes
    -
    - Disable the printing feature. -
    - -
    printdelay=SECONDS
    -
    - Restrict printing so that printing can occur only once every - SECONDS seconds. -
    - -
    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 - Mac OS X.)

    - -

    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.

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

    -
    - -
    simpleshapes=yes
    -
    - Disable the rotation step of the 'Shape' tool. - Click, drag and release is all that will be needed to draw a shape. -
    - -
    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. -
    - -
    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.

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

    -
    - -
    nowheelmouse=yes
    -
    - This disables support for the wheel on mice that have it. - (Normally, the wheel will scroll the selector menu on the right.) -
    - -
    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.

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

    -
    - -
    hidecursor=yes
    -
    -

    This completely hides the mouse pointer shapes in Tux Paint.

    - -

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

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

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

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

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

    -
    - -
    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. -
    - -
    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). -
    - -
    nolabel=yes
    -
    - Disables the Label tool: the tool that allows text entry - which can be edited later. -
    - -
    newcolorslast=yes
    -
    - Places the blank color options in the New dialog at the end, - so that any Starters and/or Templates are shown first. -
    - -
    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.

    -
    - -
    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. -
    - - -
    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 shortcurt to select the brush tool. -
    - -
    joystick-btn-stamp=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt to select the stamp tool. -
    - -
    joystick-btn-lines=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt to select the lines tool. -
    - -
    joystick-btn-shapes=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt to select the shapes tool. -
    - -
    joystick-btn-text=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt to select the text tool. -
    - -
    joystick-btn-label=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt to select the label tool. -
    - -
    joystick-btn-magic=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt to select the magic tool. -
    - -
    joystick-btn-undo=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt to the undo tool. -
    - -
    joystick-btn-redo=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt to the redo tool. -
    - -
    joystick-btn-eraser=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt for selecting the eraser tool. -
    - -
    joystick-btn-new=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt to launch the dialog for opening a new draw. -
    - -
    joystick-btn-open=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt to launch the dialog for opening an existing draw. -
    - -
    joystick-btn-save=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt for saving the draw. -
    - -
    joystick-btn-pgsetup=BUTTON NUMBER
    -
    - Selects the joystick button number, as seen by SDL, that will be a shortcurt 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 shortcurt to print. -
    - -
    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. -
    - - - - -
    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.

    - -

    Specifc "default" to let Tux Paint decide - (it's standard behavior).

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

    - -

    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" secton 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) -
      • -
    -
    - -
    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 - determined as follows: -

      -
    • 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 — TBD! -
      • - -
    • 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). - It is expected that the parent directory exists. (The directory itself - will be created, if it doesn't.) -

    - -

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

    - -

    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. -
    - -
    autosave=yes
    -
    - This prevents Tux Paint from asking whether you want to save - the current picture when quitting, and assumes you do. -
    - -
    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. -
    - -
    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".

    -
    - -
    lang=LANGUAGE
    -
    -

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

    - -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    englishamerican-english 
    acholiacoli 
    afrikaans  
    akantwi-fante 
    albanian  
    amharic  
    arabic  
    aragones  
    armenianhayeren 
    assamese  
    asturian  
    australian-english  
    azerbaijani  
    bambara  
    basqueeuskara 
    belarusianbielaruskaja 
    bengali  
    bodo  
    bokmal  
    bosnian  
    brazilian-portugueseportugues-brazilianbrazilian
    bretonbrezhoneg 
    british-englishbritish 
    bulgarian  
    canadian-english  
    catalancatala 
    chinesesimplified-chinese 
    croatianhrvatski 
    czechcesky 
    danishdansk 
     dogri 
    dutchnederlands 
    esperanto  
    estonian  
    faroese  
    finnishsuomi 
    frenchfrancais 
    fulafulahpulaar-fulfulde
    gaelicgaidhligirish-gaelic
    galiciangalego 
    georgian  
    germandeutsch 
    greek  
    groningszudelk-veenkelonioals 
    gujarati  
    hebrew  
    hindi  
    hungarianmagyar 
    icelandicislenska 
    indonesianbahasa-indonesia 
    inuktitut  
    italianitaliano 
    japanese  
    kabyle kabylian
    kannada  
    kashmiri-devanagari  
    kashmiri-perso-arabic  
    khmer  
    kigachiga 
    kinyarwanda  
    klingontlhIngan 
    konkani-devaganari  
    konkani-roman  
    korean  
    kurdish  
    latvian  
    lithuanianlietuviu 
    luganda  
    luxembourgishletzebuergesch 
    macedonian  
    maithili  
    malay  
    malayalam  
    manipuri-bengali  
    manipuri-meitei-mayek  
    marathi  
    mexican-spanishespanol-mejicanomexican
    mongolian  
    ndebele  
    nepali  
    northern-sothosesotho-sa-leboa 
    norwegiannynorsknorsk
    occitan  
    odiaoriya 
    ojibweojibway 
    persian  
    polishpolski 
    portugueseportugues 
    punjabipanjabi 
    romanian  
    russianrusskiy 
    sanskrit  
    santali-devaganari  
    santali-ol-chiki  
    scottishghaidhligscottish-gaelic
    serbian  
    serbian-latin  
    shuswapsecwepemctin 
    sindhi-devanagari  
    sindhi-perso-arabic  
    slovak  
    slovenianslovensko 
    songhay  
    southafrican-english  
    spanishespanol 
    sundanese  
    swahili  
    swedishsvenska 
    tagalog  
    tamil  
    telugu  
    thai  
    tibetan  
    traditional-chinese  
    turkish  
    twi  
    ukrainian  
    urdu  
    venda  
    venetianveneto 
    vietnamese  
    walloonwalon 
    welshcymraeg 
    wolof  
    xhosa  
    miahuatlan-zapotec zapotec
    zulu zulu
    -
    -
    -
    -
    - -
    - -

    Overriding System Config. Options using .tuxpaintrc

    -
    -

    (For Linux and Unix users)

    - -

    If any of the above options are set in - "/etc/tuxpaint/tuxpaint.config", you can override them in your - own "~/.tuxpaintrc" file.

    - -

    For true/false options, like "noprint" and - "grab", you can simply say they equal 'no' in - your "~/.tuxpaintrc" file:

    - -
    - noprint=no
    - uppercase=no -
    - -

    Or, you can use options similar to the command-line override - options described below. For example:

    - -
    - print=yes
    - mixedcase=yes -
    -
    - -
    - -

    Command-Line Options

    -
    - Options can also be issued on the command-line when you start - Tux Paint. - -
    -
    -
    - --fullscreen
    - --WIDTHxHEIGHT
    - --orient=portrait
    - --native
    - --allowscreensaver
    - --startblank
    - --nosound
    - --nostereo
    - --noquit
    - --noprint
    - --printdelay=SECONDS
    - --printcfg
    - --altprintnever
    - --altprintalways
    - --papersize=PAPERSIZE
    - --nolockfile
    - --simpleshapes
    - --uppercase
    - --grab
    - --noshortcuts
    - --nowheelmouse
    - --nobuttondistinction
    - --nofancycursors
    - --hidecursor
    - --nooutlines
    - --nostamps
    - --nostampcontrols
    - --nomagiccontrols
    - --nolabel
    - --newcolorslast
    - --mouse-accessibility
    - --onscreen-keyboard
    - --onscreen-keyboard-layout
    - --onscreen-keyboard-disable-change
    - --joystick-dev
    - --joystick-slowness
    - --joystick-threshold
    - --joystick-maxsteps
    - --joystick-hat-slowness
    - --joystick-hat-timeout
    - --joystick-btn-escape
    - --joystick-btn-brush
    - --joystick-btn-stamp
    - --joystick-btn-lines
    - --joystick-btn-shapes
    - --joystick-btn-text
    - --joystick-btn-label
    - --joystick-btn-magic
    - --joystick-btn-undo
    - --joystick-btn-redo
    - --joystick-btn-eraser
    - --joystick-btn-new
    - --joystick-btn-open
    - --joystick-btn-save
    - --joystick-btn-pgsetup
    - --joystick-btn-print
    - --joystick-buttons-ignore
    - --sysfonts
    - --alllocalefonts
    - --mirrorstamps
    - --stampsize=SIZE
    - --keyboard
    - --savedir DIRECTORY
    - --datadir DIRECTORY
    - --exportdir DIRECTORY
    - --saveover
    - --saveovernew
    - --nosave
    - --autosave
    - --lang LANGUAGE
    - --colorfile FILE
    -
    -
    - These enable or correspond to the configuration file options - described above. -
    -
    - -
    - --windowed
    - --800x600
    - --orient=landscape
    - --disablescreensaver
    - --startlast
    - --sound
    - --stereo
    - --quit
    - --print
    - --printdelay=0
    - --noprintcfg
    - --altprintmod
    - --lockfile
    - --complexshapes
    - --mixedcase
    - --dontgrab
    - --shortcuts
    - --wheelmouse
    - --buttondistinction
    - --fancycursors
    - --showcursor
    - --outlines
    - --stamps
    - --stampcontrols
    - --magiccontrols
    - --label
    - --newcolorsfirst
    - --nosysfonts
    - --currentlocalefont
    - --dontmirrorstamps
    - --stampsize=default
    - --mouse
    - --saveoverask
    - --save
    - --noautosave
    -
    -
    - These options can be used to override any settings made in - the configuration file. (If the option isn't set in the - configuration file(s), no overriding option is necessary.) -
    -
    - - -
    --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 configuration - file, "/etc/tuxpaint/tuxpaint.conf", from being read.

    - -

    Only your own configuration file, "~/.tuxpaintrc", - if it exists, will be used.

    -
    -
    -
    - -
    - -

    Command-Line Informational Options

    -
    -

    The following options display some informative text on the screen. - Tux Paint doesn't actually start up and run afterwards, however.

    - -
    -
    -
    --version
    - --verbose-version
    -
    - Display the version number and date of the copy of Tux Paint - you are running. The "--verbose-version" also lists what compile-time - options were set. (See INSTALL.txt and FAQ.txt). -
    - -
    --copying
    -
    - Show brief license information about copying Tux Paint. -
    - -
    --usage
    -
    - Display the list of available command-line options. -
    - -
    --help
    -
    - Display brief help on using Tux Paint. -
    - -
    --lang help
    -
    - Display a list of available languages in Tux Paint. -
    - -
    --joystick-dev list
    -
    - Display list of attached joysticks available to Tux Paint. -
    -
    -
    -
    -
    - -
    - - -

    Choosing a Different Language

    -
    -

    Tux Paint has been translated into a number of languages. - To access the translations, you can use the "--lang" - option on the command-line to set the language (e.g. - "--lang spanish") - or use the "lang=" setting in the configuration file - (e.g., "lang=spanish").

    - -

    Tux Paint also honors your environment's current locale. - (You can override it on the command-line using the - "--locale" option; see above.)

    - -

    Use the option "--lang help" to list the - available language options available.

    - -

    Available Languages

    - -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Locale CodeLanguage
    - (native name)    		Language
    - (English name)    		Input Method Cycle Key Combination
    C English 
    ach_UGAcoliAcholi 
    af_ZA Afrikaans 
    ak_GH Akan 
    am_ET Amharic 
    an_ES Aragones 
    ar_SA Arabic 
    as_IN Assamese 
    ast_ES Asturian 
    az_AZ Azerbaijani 
    bm_ML Bambara 
    bn_IN Bengali 
    be_BYBielaruskajaBelarusian 
    bg_BG Bulgarian 
    bo_CN (*) Tibetan 
    br_FRBrezhonegBreton 
    brx_IN Bodo 
    bs_BA Bosnian 
    ca_ESCatalàCatalan 
    ca_ES@valenciaValenciaValencian 
    cgg_UGChigaKiga 
    cs_CZCeskyCzech 
    cy_GBCymraegWelsh 
    da_DKDanskDanish 
    de_DEDeutschGerman 
    doi_IN Dogri 
    et_EE Estonian 
    el_GR (*) Greek 
    en_AU Australian English 
    en_CA Canadian English 
    en_GB British English 
    en_ZA South African English 
    eo Esperanto 
    es_ESEspañolSpanish 
    es_MXEspañol-MejicanoMexican Spanish 
    eu_ESEuskaraBasque 
    fa_IR Persian 
    ff_SNFulahFula 
    fi_FISuomiFinnish 
    fo_FO Faroese 
    fr_FRFrançaisFrench 
    ga_IEGàidhligIrish Gaelic 
    gd_GBGhaidhligScottish Gaelic 
    gl_ESGalegoGalician 
    gos_NLZudelk VeenkelonioalsGronings 
    gu_IN Gujarati 
    he_IL (*) Hebrew 
    hi_IN (*) Hindi 
    hr_HRHrvatskiCroatian 
    hu_HUMagyarHungarian 
    hy_AMHayerenArmenian 
    id_IDBahasa IndonesiaIndonesian 
    is_ISÍslenskaIcelandic 
    it_ITItalianoItalian 
    iu_CA Inuktitut 
    ja_JP (*) Japaneseright [Alt]
    ka_GE Georgian 
    kab Kabyle 
    km_KH Khmer 
    kn_IN Kannada 
    ko_KR (*) Koreanright [Alt] or left [Alt]
    kok_IN Konkani (Devaganari) 
    kok@roman Konkani (Roman) 
    ks_IN@devanagari Kashmiri (Devanagari) 
    ks_IN Kashmiri (Perso-Arabic) 
    ku_TR Kurdish 
    lb_LULetzebuergeschLuxembourgish 
    lg_UG Luganda 
    lt_LTLietuviuLithuanian 
    lv_LV Latvian 
    mk_MK Macedonian 
    mai_IN Maithili 
    ml_IN Malayalam 
    mn_MN Mongolian 
    mni_IN Manipuri (Bengali) 
    mni@meiteimayek Manipuri (Meitei Mayek) 
    mr_IN Marathi 
    ms_MY Malay 
    nb_NONorsk (bokmål)Norwegian Bokmål 
    ne_NPNepali  
    nl_NL Dutch 
    nn_NONorsk (nynorsk)Norwegian Nynorsk 
    nr_ZA Ndebele 
    nso_ZASesotho sa LeboaNorthern Sotho 
    oc_FR Occitan 
    oj_CA OjibweOjibway
    pa_IN Punjabi 
    or_IN OdiaOriya
    pl_PLPolskiPolish 
    pt_BRPortugês BrazileiroBrazilian Portuguese 
    pt_PTPortugêsPortuguese 
    ro_RO Romanian 
    ru_RURusskiyRussian 
    rw_RW Kinyarwanda 
    sa_IN Sanskrit 
    sat_IN Santali (Devaganari) 
    sat@olchiki Santali (Ol-Chikii) 
    shs_CASecwepemctinShuswap 
    si_LK Sinhala 
    sd_IN@devanagari Sindhi (Devanagari) 
    sd_IN Sindhi 
    sk_SK Slovak 
    sl_SI Slovenian 
    son Songhay 
    sq_AL Albanian 
    sr_YU Serbian (cyrillic) 
    sr_RS@latin Serbian (latin) 
    su_ID Sundanese 
    sv_SESvenskaSwedish 
    sw_TZ Swahili 
    ta_IN (*) Tamil 
    te_IN (*) Telugu 
    th_TH (*) Thai 
    tl_PH (*) Tagalog 
    tlhtlhInganKlingon 
    tr_TR Turkish 
    tw_GH Twi 
    uk_UA Ukrainian 
    ur_IN Urdu 
    ve_ZA Venda 
    vecVenètoVenetian 
    vi_VN Vietnamese 
    wa_BE Walloon 
    wo_SN Wolof 
    xh_ZA Xhosa 
    zh_CN (*) Chinese (Simplified) 
    zh_TW (*) Chinese (Traditional) 
    zam Zapotec (Miahuatlan) 
    zu_ZA Zulu 
    - -

    (*) - These languages require their own fonts, since they - are not represented using a Latin character set, like the others. - See the "Special Fonts" - section, below.

    - -

    Note: Tux Paint provides an alternative input method for - entering characters with the Text tool in some locales. - The key comibation(s) listed can be used to cycle through the - supported input methods while the Text tool is active.

    - -
    - -

    Setting Your Environment's Locale

    -
    -

    Changing your locale will affect much of your environment.

    - -

    As stated above, along with letting you choose the language at - runtime using command-line options ("--lang" and - "--locale"), - Tux Paint honors the global locale setting in your environment.

    - -

    If you haven't already set your environment's locale, the following - will briefly explain how:

    - -

    Linux/Unix Users

    -
    -

    First, be sure the locale you want to use is enabled by - editing the file "/etc/locale.gen" on your system and - then running the program "locale-gen" as root.

    - -

    Note: Debian users may be able to simply run the command - "dpkg-reconfigure locales" as root to bring up a - configuration dialog. Ubuntu users may be able to run - "sudo dpkg-reconfigure localeconf" - (the "localeconf" package may need to be installed first), or - may need to edit the file - "/var/lib/locales/supported.d/local" - first, and add locales they want, from the list found in - "/usr/share/i18n/SUPPORTED".

    - -

    Then, before running Tux Paint, set your "$LANG" - environment variable to one of the locales listed above. (If you - want all programs that can be translated to be, you may wish to place - the following in your login script; e.g. ~/.profile, - ~/.bashrc, ~/.cshrc, etc.)

    - - -

    For example, in a Bourne Shell (like BASH):

    - -
    - export LANG=es_ES ; \
    - tuxpaint -
    - - -

    And in a C Shell (like TCSH):

    - -
    - setenv LANG es_ES ; \
    - tuxpaint -
    -
    +
    + +

    + Available Options +

    -

    Windows Users

    -

    Tux Paint will recognize the current locale and use the - appropriate files by default. So this section is only for people - trying different languages.

    +

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

    -

    The simplest thing to do is to use the '--lang' - switch in the shortcut (see "INSTALL.txt"). However, by using - an MSDOS Prompt window, it is also possible to issue a command - like this:

    +
    +
    + fullscreen=yes +
    -
    - set LANG=es_ES -
    +
    + Run the program in full screen mode, rather than in a + window. +
    -

    ...which will set the language for the lifetime of that DOS - window.

    +
    + fullscreen=native +
    -

    For something more permanent, try editing your computer's - 'autoexec.bat' file using Windows' "sysedit" - tool:

    +
    + Run the program in full screen mode. Additionally, assume + the screen's current resolution (set by the operating + system). +
    -
    Windows 95/98
    -
      -
    1. Click on the 'Start' button, and select 'Run...'.
      2. -
    2. Type "sysedit" into the 'Open:' box (with or without quotes).
      3. -
    3. Click 'OK'.
      4. -
    4. Locate the AUTOEXEC.BAT window in the System Configuration - Editor.
      5. -
    5. Add the following at the bottom of the file: +
      + windowsize=SIZE +
      -
      - set LANG=es_ES -
      -
      6. -
    6. Close the System Configuration Editor, answering yes to save - the changes.
      7. -
    7. Restart your machine.
      8. -
    +
    +

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

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

    +
    + +
    + nosound=yes +
    + +
    + Disable sound effects. (Note: Pressing + [Alt] + [S] cannot be used to + reenable sounds if they were disabled using this option.) +
    + +
    + 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.) +
    + +
    + 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]. +

    +
    + +
    + noprint=yes +
    + +
    + Disable the printing feature. +
    + +
    + printdelay=SECONDS +
    + +
    + Restrict printing so that printing can occur only once + every SECONDS seconds. +
    + +
    + 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 + Mac OS X.) +

    + +

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

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

    +
    + +
    + simpleshapes=yes +
    + +
    + Disable the rotation step of the 'Shape' tool. Click, + drag and release is all that will be needed to draw a + shape. +
    + +
    + 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. +
    + +
    + 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. +

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

    +
    + +
    + nowheelmouse=yes +
    + +
    + This disables support for the wheel on mice that have it. + (Normally, the wheel will scroll the selector menu on the + right.) +
    + +
    + 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. +

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

    +
    + +
    + hidecursor=yes +
    + +
    +

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

    + +

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

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

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

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

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

    +
    + +
    + 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. +
    + +
    + 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). +
    + +
    + nolabel=yes +
    + +
    + Disables the Label tool: the tool that allows text + entry which can be edited later. +
    + +
    + newcolorslast=yes +
    + +
    + Places the blank color options in the New dialog + at the end, so that any Starters and/or Templates are + shown first. +
    + +
    + 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. +

    +
    + +
    + 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. +
    + +
    + 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 shortcurt to select the brush tool. +
    + +
    + joystick-btn-stamp=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt to select the stamp tool. +
    + +
    + joystick-btn-lines=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt to select the lines tool. +
    + +
    + joystick-btn-shapes=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt to select the shapes tool. +
    + +
    + joystick-btn-text=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt to select the text tool. +
    + +
    + joystick-btn-label=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt to select the label tool. +
    + +
    + joystick-btn-magic=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt to select the magic tool. +
    + +
    + joystick-btn-undo=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt to the undo tool. +
    + +
    + joystick-btn-redo=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt to the redo tool. +
    + +
    + joystick-btn-eraser=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt for selecting the eraser tool. +
    + +
    + joystick-btn-new=BUTTON NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt to launch the dialog for opening a + new draw. +
    + +
    + joystick-btn-open=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt to launch the dialog for opening an + existing draw. +
    + +
    + joystick-btn-save=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt for saving the draw. +
    + +
    + joystick-btn-pgsetup=BUTTON + NUMBER +
    + +
    + Selects the joystick button number, as seen by SDL, that + will be a shortcurt 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 shortcurt to print. +
    + +
    + 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. +
    + +
    + 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. +

    + +

    + Specifc "default" to let Tux Paint + decide (it's standard behavior). +

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

    + +

    + 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" secton 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) +
      • +
    +
    + +
    + 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 determined as follows: +

    + +
      +
    • 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 — TBD! +
      • + +
    • 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). It is + expected that the parent directory exists. (The + directory itself will be created, if it doesn't.) +

    + +

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

    + +

    + 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. +
    + +
    + autosave=yes +
    + +
    + This prevents Tux Paint from asking whether you want + to save the current picture when quitting, and assumes + you do. +
    + +
    + 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. +
    + +
    + 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". +

    +
    + +
    + 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-devaganari + +   + +   +
    + konkani-roman + +   + +   +
    + korean + +   + +   +
    + kurdish + +   + +   +
    + latvian + +   + +   +
    + lithuanian + + lietuviu + +   +
    + luganda + +   + +   +
    + luxembourgish + + letzebuergesch + +   +
    + macedonian + +   + +   +
    + maithili + +   + +   +
    + malay + +   + +   +
    + malayalam + +   + +   +
    + manipuri-bengali + +   + +   +
    + manipuri-meitei-mayek + +   + +   +
    + marathi + +   + +   +
    + mexican-spanish + + espanol-mejicano + + mexican +
    + mongolian + +   + +   +
    + ndebele + +   + +   +
    + nepali + +   + +   +
    + northern-sotho + + sesotho-sa-leboa + +   +
    + norwegian + + nynorsk + + norsk +
    + occitan + +   + +   +
    + odia + + oriya + +   +
    + ojibwe + + ojibway + +   +
    + persian + +   + +   +
    + polish + + polski + +   +
    + portuguese + + portugues + +   +
    + punjabi + + panjabi + +   +
    + romanian + +   + +   +
    + russian + + russkiy + +   +
    + sanskrit + +   + +   +
    + santali-devaganari + +   + +   +
    + 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 +
    +
    +
    +
    +
    + +
    + +

    + Overriding System Config. Options using + .tuxpaintrc +

    + +
    +

    + (For Linux and Unix users) +

    + +

    + If any of the above options are set in + "/etc/tuxpaint/tuxpaint.config", you can + override them in your own "~/.tuxpaintrc" + file. +

    + +

    + For true/false options, like "noprint" and + "grab", you can simply say they equal 'no' in + your "~/.tuxpaintrc" file: +

    - To affect the entire machine, and all applications, - it is possible to use the "Regional Settings" control panel: + noprint=no
    + uppercase=no
    -
      -
    1. Click on the 'Start' button, and select - 'Settings | Control Panel'.
      2. -
    2. Double click on the "Regional Settings" globe.
      3. -
    3. Select a language/region from the drop down list.
      4. -
    4. Click 'OK'.
      5. -
    5. Restart your machine when prompted.
      6. -
    +

    + Or, you can use options similar to the command-line + override options described below. For example: +

    +
    + print=yes
    + mixedcase=yes     +
    -
    -

    Special Fonts

    -
    -

    Some languages require special fonts be installed. These font - files (which are in TrueType format (TTF)), are much too large to - include with the Tux Paint download, and are available - separately. (See the table above, under the - "Choosing a Different Language" - section.)

    +
    -

    Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" - library, which utilizes the "Pango" library to render text in the user - interface, rather than using "SDL_ttf" directly. Unless your copy of - Tux Paint was built without Pango support, special fonts should - no longer be necessary.

    - -

    When running Tux Paint in a language that requires its own font, - Tux Paint will try to load the font file from its system-wide - "fonts" directory (under a - "locale" subdirectory). The name of the file - corresponds to the first two letters in the 'locale' code of the - language (e.g., "ko" for Korean, "ja" for Japanese, - "zh_tw" for Traditional Chinese).

    - -

    For example, under Linux or Unix, when Tux Paint is run in Korean - (e.g., with the option "--lang korean"), - Tux Paint will attempt to load the following font file:

    +

    + Command-Line Options +

    -

    /usr/share/tuxpaint/fonts/locale/ko.ttf

    + Options can also be issued on the command-line when you start + Tux Paint. +
    +
    +
    + --fullscreen
    + --WIDTHxHEIGHT
    + --orient=portrait
    + --native
    + --allowscreensaver
    + --startblank
    + --nosound
    + --nostereo
    + --noquit
    + --noprint
    + --printdelay=SECONDS
    + --printcfg
    + --altprintnever
    + --altprintalways
    + --papersize=PAPERSIZE
    + --nolockfile
    + --simpleshapes
    + --uppercase
    + --grab
    + --noshortcuts
    + --nowheelmouse
    + --nobuttondistinction
    + --nofancycursors
    + --hidecursor
    + --nooutlines
    + --nostamps
    + --nostampcontrols
    + --nomagiccontrols
    + --nolabel
    + --newcolorslast
    + --mouse-accessibility
    + --onscreen-keyboard
    + --onscreen-keyboard-layout
    + --onscreen-keyboard-disable-change
    + --joystick-dev
    + --joystick-slowness
    + --joystick-threshold
    + --joystick-maxsteps
    + --joystick-hat-slowness
    + --joystick-hat-timeout
    + --joystick-btn-escape
    + --joystick-btn-brush
    + --joystick-btn-stamp
    + --joystick-btn-lines
    + --joystick-btn-shapes
    + --joystick-btn-text
    + --joystick-btn-label
    + --joystick-btn-magic
    + --joystick-btn-undo
    + --joystick-btn-redo
    + --joystick-btn-eraser
    + --joystick-btn-new
    + --joystick-btn-open
    + --joystick-btn-save
    + --joystick-btn-pgsetup
    + --joystick-btn-print
    + --joystick-buttons-ignore
    + --sysfonts
    + --alllocalefonts
    + --mirrorstamps
    + --stampsize=SIZE
    + --keyboard
    + --savedir DIRECTORY
    + --datadir DIRECTORY
    + --exportdir DIRECTORY
    + --saveover
    + --saveovernew
    + --nosave
    + --autosave
    + --lang LANGUAGE
    + --colorfile FILE
     +
    + +
    + These enable or correspond to the configuration file + options described above. + +
    +
    + +
    + --windowed
    + --800x600
    + --orient=landscape
    + --disablescreensaver
    + --startlast
    + --sound
    + --stereo
    + --quit
    + --print
    + --printdelay=0
    + --noprintcfg
    + --altprintmod
    + --lockfile
    + --complexshapes
    + --mixedcase
    + --dontgrab
    + --shortcuts
    + --wheelmouse
    + --buttondistinction
    + --fancycursors
    + --showcursor
    + --outlines
    + --stamps
    + --stampcontrols
    + --magiccontrols
    + --label
    + --newcolorsfirst
    + --nosysfonts
    + --currentlocalefont
    + --dontmirrorstamps
    + --stampsize=default
    + --mouse
    + --saveoverask
    + --save
    + --noautosave
     +
    + +
    + These options can be used to override any settings made + in the configuration file. (If the option isn't set in + the configuration file(s), no overriding option is + necessary.) + +
    +
    + +
    + --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 + configuration file, + "/etc/tuxpaint/tuxpaint.conf", from + being read. +

    + +

    + Only your own configuration file, + "~/.tuxpaintrc", if it exists, will be + used. +

    +
    +
    +
    + +
    + +

    + Command-Line Informational Options +

    + +
    +

    + The following options display some informative text on + the screen. Tux Paint doesn't actually start up and + run afterwards, however. +

    + +
    +
    +
    + --version
    + --verbose-version +
    + +
    + Display the version number and date of the copy of + Tux Paint you are running. The + "--verbose-version" also lists what compile-time + options were set. (See INSTALL.txt and FAQ.txt). +
    + +
    + --copying +
    + +
    + Show brief license information about copying + Tux Paint. +
    + +
    + --usage +
    + +
    + Display the list of available command-line options. +
    + +
    + --help +
    + +
    + Display brief help on using Tux Paint. +
    + +
    + --lang help +
    + +
    + Display a list of available languages in + Tux Paint. +
    + +
    + --joystick-dev list +
    + +
    + Display list of attached joysticks available to + Tux Paint. +
    +
    +
    +
    -

    You can download fonts for supported languages from Tux Paint's - website, - http://www.tuxpaint.org/. - (Look in the 'Fonts' section under 'Download.')

    +
    -

    Under Unix and Linux, you can use the Makefile that comes - with the font to install the font in the appropriate location.

    -
    - -
    +

    + Choosing a Different Language +

    -
    +
    +

    + Tux Paint has been translated into a number of + languages. To access the translations, you can use the + "--lang" option on the command-line to set the + language (e.g. "--lang spanish") or use + the "lang=" setting in the configuration file + (e.g., "lang=spanish"). +

    - +

    + Tux Paint also honors your environment's current + locale. (You can override it on the command-line using the + "--locale" option; see above.) +

    +

    + Use the option "--lang help" to list the + available language options available. +

    + +

    + Available Languages +

    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + Locale Code + + Language
    + (native name) +     		+ Language
    + (English name) +     		+ Input Method Cycle Key Combination +
    + C + +   + + English + +   +
    + ach_UG + + Acoli + + Acholi + +   +
    + af_ZA + +   + + Afrikaans + +   +
    + ak_GH + +   + + Akan + +   +
    + am_ET + +   + + Amharic + +   +
    + an_ES + +   + + Aragones + +   +
    + ar_SA + +   + + Arabic + +   +
    + as_IN + +   + + Assamese + +   +
    + ast_ES + +   + + Asturian + +   +
    + az_AZ + +   + + Azerbaijani + +   +
    + bm_ML + +   + + Bambara + +   +
    + bn_IN + +   + + Bengali + +   +
    + be_BY + + Bielaruskaja + + Belarusian + +   +
    + bg_BG + +   + + Bulgarian + +   +
    + bo_CN (*) + +   + + Tibetan + +   +
    + br_FR + + Brezhoneg + + Breton + +   +
    + brx_IN + +   + + Bodo + +   +
    + bs_BA + +   + + Bosnian + +   +
    + ca_ES + + Català + + Catalan + +   +
    + ca_ES@valencia + + Valencia + + Valencian + +   +
    + cgg_UG + + Chiga + + Kiga + +   +
    + cs_CZ + + Cesky + + Czech + +   +
    + cy_GB + + Cymraeg + + Welsh + +   +
    + da_DK + + Dansk + + Danish + +   +
    + de_DE + + Deutsch + + German + +   +
    + doi_IN + +   + + Dogri + +   +
    + et_EE + +   + + Estonian + +   +
    + el_GR (*) + +   + + Greek + +   +
    + en_AU + +   + + Australian English + +   +
    + en_CA + +   + + Canadian English + +   +
    + en_GB + +   + + British English + +   +
    + en_ZA + +   + + South African English + +   +
    + eo + +   + + Esperanto + +   +
    + es_ES + + Español + + Spanish + +   +
    + es_MX + + Español-Mejicano + + Mexican Spanish + +   +
    + eu_ES + + Euskara + + Basque + +   +
    + fa_IR + +   + + Persian + +   +
    + ff_SN + + Fulah + + Fula + +   +
    + fi_FI + + Suomi + + Finnish + +   +
    + fo_FO + +   + + Faroese + +   +
    + fr_FR + + Français + + French + +   +
    + ga_IE + + Gàidhlig + + Irish Gaelic + +   +
    + gd_GB + + Ghaidhlig + + Scottish Gaelic + +   +
    + gl_ES + + Galego + + Galician + +   +
    + gos_NL + + Zudelk Veenkelonioals + + Gronings + +   +
    + gu_IN + +   + + Gujarati + +   +
    + he_IL (*) + +   + + Hebrew + +   +
    + hi_IN (*) + +   + + Hindi + +   +
    + hr_HR + + Hrvatski + + Croatian + +   +
    + hu_HU + + Magyar + + Hungarian + +   +
    + hy_AM + + Hayeren + + Armenian + +   +
    + id_ID + + Bahasa Indonesia + + Indonesian + +   +
    + is_IS + + Íslenska + + Icelandic + +   +
    + it_IT + + Italiano + + Italian + +   +
    + iu_CA + +   + + Inuktitut + +   +
    + ja_JP (*) + +   + + Japanese + + right [Alt] +
    + ka_GE + +   + + Georgian + +   +
    + kab + +   + + Kabyle + +   +
    + km_KH + +   + + Khmer + +   +
    + kn_IN + +   + + Kannada + +   +
    + ko_KR (*) + +   + + Korean + + right [Alt] or left [Alt] +
    + kok_IN + +   + + Konkani (Devaganari) + +   +
    + kok@roman + +   + + Konkani (Roman) + +   +
    + ks_IN@devanagari + +   + + Kashmiri (Devanagari) + +   +
    + ks_IN + +   + + Kashmiri (Perso-Arabic) + +   +
    + ku_TR + +   + + Kurdish + +   +
    + lb_LU + + Letzebuergesch + + Luxembourgish + +   +
    + lg_UG + +   + + Luganda + +   +
    + lt_LT + + Lietuviu + + Lithuanian + +   +
    + lv_LV + +   + + Latvian + +   +
    + mk_MK + +   + + Macedonian + +   +
    + mai_IN + +   + + Maithili + +   +
    + ml_IN + +   + + Malayalam + +   +
    + mn_MN + +   + + Mongolian + +   +
    + mni_IN + +   + + Manipuri (Bengali) + +   +
    + mni@meiteimayek + +   + + Manipuri (Meitei Mayek) + +   +
    + mr_IN + +   + + Marathi + +   +
    + ms_MY + +   + + Malay + +   +
    + nb_NO + + Norsk (bokmål) + + Norwegian Bokmål + +   +
    + ne_NP + + Nepali + +   + +   +
    + nl_NL + +   + + Dutch + +   +
    + nn_NO + + Norsk (nynorsk) + + Norwegian Nynorsk + +   +
    + nr_ZA + +   + + Ndebele + +   +
    + nso_ZA + + Sesotho sa Leboa + + Northern Sotho + +   +
    + oc_FR + +   + + Occitan + +   +
    + oj_CA + +   + + Ojibwe + + Ojibway +
    + pa_IN + +   + + Punjabi + +   +
    + or_IN + +   + + Odia + + Oriya +
    + pl_PL + + Polski + + Polish + +   +
    + pt_BR + + Portugês Brazileiro + + Brazilian Portuguese + +   +
    + pt_PT + + Portugês + + Portuguese + +   +
    + ro_RO + +   + + Romanian + +   +
    + ru_RU + + Russkiy + + Russian + +   +
    + rw_RW + +   + + Kinyarwanda + +   +
    + sa_IN + +   + + Sanskrit + +   +
    + sat_IN + +   + + Santali (Devaganari) + +   +
    + sat@olchiki + +   + + Santali (Ol-Chikii) + +   +
    + shs_CA + + Secwepemctin + + Shuswap + +   +
    + si_LK + +   + + Sinhala + +   +
    + sd_IN@devanagari + +   + + Sindhi (Devanagari) + +   +
    + sd_IN + +   + + Sindhi + +   +
    + sk_SK + +   + + Slovak + +   +
    + sl_SI + +   + + Slovenian + +   +
    + son + +   + + Songhay + +   +
    + sq_AL + +   + + Albanian + +   +
    + sr_YU + +   + + Serbian (cyrillic) + +   +
    + sr_RS@latin + +   + + Serbian (latin) + +   +
    + su_ID + +   + + Sundanese + +   +
    + sv_SE + + Svenska + + Swedish + +   +
    + sw_TZ + +   + + Swahili + +   +
    + ta_IN (*) + +   + + Tamil + +   +
    + te_IN (*) + +   + + Telugu + +   +
    + th_TH (*) + +   + + Thai + +   +
    + tl_PH (*) + +   + + Tagalog + +   +
    + tlh + + tlhIngan + + Klingon + +   +
    + tr_TR + +   + + Turkish + +   +
    + tw_GH + +   + + Twi + +   +
    + uk_UA + +   + + Ukrainian + +   +
    + ur_IN + +   + + Urdu + +   +
    + ve_ZA + +   + + Venda + +   +
    + vec + + Venèto + + Venetian + +   +
    + vi_VN + +   + + Vietnamese + +   +
    + wa_BE + +   + + Walloon + +   +
    + wo_SN + +   + + Wolof + +   +
    + xh_ZA + +   + + Xhosa + +   +
    + zh_CN (*) + +   + + Chinese (Simplified) + +   +
    + zh_TW (*) + +   + + Chinese (Traditional) + +   +
    + zam + +   + + Zapotec (Miahuatlan) + +   +
    + zu_ZA + +   + + Zulu + +   +
    + +

    + (*) - These languages require their own fonts, + since they are not represented using a Latin character + set, like the others. See the "Special Fonts" section, + below. +

    + +

    + Note: Tux Paint provides an alternative input + method for entering characters with the Text tool + in some locales. The key comibation(s) listed can be used + to cycle through the supported input methods while the + Text tool is active. +

    +
    + +

    + Setting Your Environment's Locale +

    + +
    +

    + Changing your locale will affect much of your + environment. +

    + +

    + As stated above, along with letting you choose the + language at runtime using command-line options + ("--lang" and "--locale"), + Tux Paint honors the global locale setting in your + environment. +

    + +

    + If you haven't already set your environment's locale, the + following will briefly explain how: +

    + +

    + Linux/Unix Users +

    + +
    +

    + First, be sure the locale you want to use is enabled by + editing the file "/etc/locale.gen" on your + system and then running the program + "locale-gen" as root. +

    + +

    + Note: Debian users may be able to simply run the + command "dpkg-reconfigure locales" as + root to bring up a configuration dialog. Ubuntu users + may be able to run + "sudo dpkg-reconfigure localeconf" + (the "localeconf" package may need to be installed + first), or may need to edit the file + "/var/lib/locales/supported.d/local" + first, and add locales they want, from the list found + in "/usr/share/i18n/SUPPORTED". +

    + +

    + Then, before running Tux Paint, set your + "$LANG" environment variable to one of the + locales listed above. (If you want all programs that + can be translated to be, you may wish to place the + following in your login script; e.g. + ~/.profile, ~/.bashrc, + ~/.cshrc, etc.) +

    + +

    + For example, in a Bourne Shell (like BASH): +

    + +
    + export LANG=es_ES ; \
    + tuxpaint     +
    + +

    + And in a C Shell (like TCSH): +

    + +
    + setenv LANG es_ES ; \
    + tuxpaint     +
    +
    + +
    + +

    + Windows Users +

    + +
    +

    + Tux Paint will recognize the current locale and + use the appropriate files by default. So this section + is only for people trying different languages. +

    + +

    + The simplest thing to do is to use the + '--lang' switch in the shortcut (see + "INSTALL.txt"). However, by using an MSDOS Prompt + window, it is also possible to issue a command like + this: +

    + +
    + set LANG=es_ES +
    + +

    + ...which will set the language for the lifetime of that + DOS window. +

    + +

    + For something more permanent, try editing your + computer's 'autoexec.bat' file using + Windows' "sysedit" tool: +

    + +
    + Windows 95/98 +
    + +
      +
    1. Click on the 'Start' button, and select 'Run...'. +
      2. + +
    2. Type "sysedit" into the 'Open:' box (with or + without quotes). +
      3. + +
    3. Click 'OK'. +
      4. + +
    4. Locate the AUTOEXEC.BAT window in the System + Configuration Editor. +
      5. + +
    5. Add the following at the bottom of the file: +
      + set LANG=es_ES +
      +
      6. + +
    6. Close the System Configuration Editor, answering + yes to save the changes. +
      7. + +
    7. Restart your machine. +
      8. +
    + +
    + To affect the entire machine, and all + applications, it is possible to use the "Regional + Settings" control panel: +
    + +
      +
    1. Click on the 'Start' button, and select + 'Settings | Control Panel'. +
      2. + +
    2. Double click on the "Regional Settings" globe. +
      3. + +
    3. Select a language/region from the drop down list. +
      4. + +
    4. Click 'OK'. +
      5. + +
    5. Restart your machine when prompted. +
      6. +
    +
    +
    + +

    + Special Fonts +

    + +
    +

    + Some languages require special fonts be installed. These + font files (which are in TrueType format (TTF)), are much + too large to include with the Tux Paint download, + and are available separately. (See the table above, under + the "Choosing a + Different Language" section.) +

    + +

    + Note: As of version 0.9.18, Tux Paint uses + the "SDL_Pango" library, which utilizes the "Pango" + library to render text in the user interface, rather than + using "SDL_ttf" directly. Unless your copy of + Tux Paint was built without Pango support, special + fonts should no longer be necessary. +

    + +

    + When running Tux Paint in a language that requires + its own font, Tux Paint will try to load the font + file from its system-wide "fonts" + directory (under a "locale" + subdirectory). The name of the file corresponds to the + first two letters in the 'locale' code of the language + (e.g., "ko" for Korean, "ja" for Japanese, "zh_tw" for + Traditional Chinese). +

    + +

    + For example, under Linux or Unix, when Tux Paint is + run in Korean (e.g., with the option + "--lang korean"), Tux Paint will + attempt to load the following font file: +

    + +
    +

    + /usr/share/tuxpaint/fonts/locale/ko.ttf +

    +
    + +

    + You can download fonts for supported languages from + Tux Paint's website, http://www.tuxpaint.org/. + (Look in the 'Fonts' section under 'Download.') +

    + +

    + Under Unix and Linux, you can use the + Makefile that comes with the font to install + the font in the appropriate location. +

    +
    +
    + +
    + + diff --git a/docs/en/html/README.html b/docs/en/html/README.html index 27a211cb2..ab29bc40f 100644 --- a/docs/en/html/README.html +++ b/docs/en/html/README.html @@ -1,1219 +1,2004 @@ -Tux Paint README - - + + + + + Tux Paint README + + + + +
    +

    + Tux Paint
    + version 0.9.25 +

    - +

    + A simple drawing program for children +

    -
    -


    +

    + Copyright 2002-2020 by various contributors; see + AUTHORS.txt
    + http://www.tuxpaint.org/ +

    -version +

    + June 14, 2002 - July 27, 2020 +

    +

    -0.9.25 +
    - -

    A simple drawing program for children

    + + + + -

    Copyright 2002-2020 by various contributors; see AUTHORS.txt
    -http://www.tuxpaint.org/

    + + + +
    + Table of Contents +
    + +
    - - - -
    Table of Contents
    - -
    +
    -
    +

    + About +

    -

    About

    -
    - -

    What Is 'Tux Paint?'

    -
    -

    Tux Paint is a free drawing program designed for young children - (kids ages 3 and up). It has a simple, easy-to-use interface, fun - sound effects, and an encouraging cartoon mascot who helps guide - children as they use the program. It provides a blank canvas and - a variety of drawing tools to help your child be creative.

    -
    - -

    License:

    -
    -

    Tux Paint is an Open Source project, Free Software - released under the GNU General Public License (GPL). It is free, and - the 'source code' behind the program is available. (This allows - others to add features, fix bugs, and use parts of the program in their - own GPL'd software.)

    - -

    See COPYING.txt for the full text of - the GPL license.

    -
    - -

    Objectives:

    -
    -
    -
    Easy and Fun
    -
    - Tux Paint is meant to be a simple drawing program for young children. - It is not meant as a general-purpose drawing tool. It is meant to - be fun and easy to use. Sound effects and a cartoon character help let - the user know what's going on, and keeps them entertained. - There are also extra-large cartoon-style mouse pointer shapes. -
    - -
    Extensibility
    -
    - Tux Paint is extensible. Brushes and "rubber stamp" shapes can be - dropped in and pulled out. For example, a teacher can drop in a - collection of animal shapes and ask their students to draw an - ecosystem. Each shape can have a sound which is played, and - textual facts which are displayed, when the child selects the shape. -
    - -
    Portability
    -
    - Tux Paint is portable among various computer platforms: - Windows, Macintosh, Linux, etc. The interface looks the same among - them all. Tux Paint runs suitably well on older systems (like a - Pentium 133), and can be built to run better on slow systems. -
    - -
    Simplicity
    -
    - There is no direct access to the computer's underlying intricacies. - The current image is kept when the program quits, and reappears when - it is restarted. Saving images requires no need to create filenames - or use the keyboard. Opening an image is done by selecting it from - a collection of thumbnails. Access to other files on the computer is - restricted. -
    -
    -
    -
    - -
    - - -

    Using Tux Paint

    -
    - -

    Loading Tux Paint

    -
    -

    Linux/Unix Users

    -

    Tux Paint should have placed a laucher icon in your KDE and/or GNOME - menus, under 'Graphics.'

    - -

    Alternatively, you can run the following command at a shell prompt - (e.g., "$"):

    +

    + What Is 'Tux Paint?' +

    - $ tuxpaint +

    + Tux Paint is a free drawing program designed for young + children (kids ages 3 and up). It has a simple, + easy-to-use interface, fun sound effects, and an + encouraging cartoon mascot who helps guide children as + they use the program. It provides a blank canvas and a + variety of drawing tools to help your child be creative. +

    -

    If any errors occur, they will be displayed on the terminal - (to "stderr").

    -
    +

    + License: +

    -
    - - -

    Windows Users

    -
    -
    - [Icon]
    - Tux Paint -
    - -

    If you installed Tux Paint on your computer using the - 'Tux Paint Installer,' it will have asked you whether you - wanted a 'Start' menu short-cut, and/or a desktop shortcut. If you - agreed, you can simply run Tux Paint from the 'Tux Paint' - section of your 'Start' menu (e.g., under "All Programs" on - Windows XP), or by double-clicking the "Tux Paint" icon - on your desktop.

    - -

    If you installed Tux Paint using the 'ZIP-file' download, - or if you used the 'Tux Paint Installer,' but chose not to - have shortcuts installed, you'll need to double-click the - "tuxpaint.exe" icon in the 'Tux Paint' folder on - your computer.

    - -

    By default, the 'Tux Paint Installer' will put - Tux Paint's folder in "C:\Program Files\", - though you may have changed this when the installer ran.

    - -

    If you used the 'ZIP-file' download, Tux Paint's folder will - be wherever you put it when you unzipped the ZIP file.

    - -
    -
    - -
    - - -

    macOS Users

    -
    -

    Simply double-click the "Tux Paint" icon.

    -
    -
    - -
    - - -

    Title Screen

    -
    -

    When Tux Paint first loads, a title/credits screen will appear.

    - -

    [Title Screenshot]

    - -

    Once loading is complete, press a key or click on the mouse to continue. - (Or, after about 30 seconds, the title screen will go away - automatically.)

    -
    - -
    - - -

    Main Screen

    -
    - The main screen is divided into the following sections: - -
    -
    Left Side: Toolbar
    -
    -

    The toolbar contains the drawing and editing controls.

    - - -

    [Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, - Eraser, New, Open, Save, Print, Quit]

    -
    - -
    Middle: Drawing Canvas
    -
    -

    The largest part of the screen, in the center, is the drawing - canvas. This is, obviously, where you draw!

    - -

    [(Canvas)]

    - -

    Note: The size of the drawing canvas depends on the size - of Tux Paint. You can change the size of Tux Paint using - the Tux Paint Config. configuration tool, or - by other means. See the OPTIONS documentation - for more details.

    -
    - - -
    Right Side: Selector
    -
    -

    Depending on the current tool, the selector shows different - things. e.g., when the Paint Brush tool is selected, it shows - the various brushes available. When the Rubber Stamp tool - is selected, it shows the different shapes you can use.

    - -

    [Selectors - Brushes, Letters, Shapes, Stamps]

    -
    - - -
    Lower: Colors
    -
    -

    A palette of available colors are shown near the bottom of the - screen.

    - -

    [Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, - Blue, Purple, Brown, Grey]

    - -

    On the far right are two special color options, the - "color picker", which has an outline of an eye-dropper, - and allows you to pick a color found within your drawing, and - the rainbow palette, which allows you to pick a color from - within a box containing thousands of colors.

    - -

    (NOTE: You can define your own colors for Tux Paint. - See the "Options" - documentation.)

    -
    - - -
    Bottom: Help Area
    -
    -

    At the very bottom of the screen, Tux, the Linux Penguin, - provides tips and other information while you draw.

    - -

    (For example: 'Pick a shape. Click to pick the center, drag, then - let go when it is the size you want. Move around to rotate it, and - click to draw it.)

    -
    -
    -
    - -
    - - -

    Available Tools

    -
    -

    Drawing Tools

    -
    -
    -
    Paint (Brush)
    -
    - - -

    The Paint Brush tool lets you draw freehand, using various - brushes (chosen in the Selector on the right) and colors - (chosen in the Color palette towards the bottom).

    - -

    If you hold the mouse button down, and move the mouse, it will - draw as you move.

    - -

    As you draw, a sound is played. The bigger the brush, the - lower the pitch.

    - -
    - -

    - -
    -
    - - -
    Stamp (Rubber Stamp)
    -
    - - -

    The Stamp tool is like a set of rubber stamps or stickers. - It lets you paste pre-drawn or photographic images (like a picture - of a horse, or a tree, or the moon) in your picture.

    - -

    As you move the mouse around the canvas, an outline follows the - mouse, showing where the stamp will be placed, and how big it will - be.

    - -

    - - -

    There can be numerous categories of stamps (e.g., animals, - plants, outer space, vehicles, people, etc.). Use the - Left and Right arrows to cycle through the collections.

    - -

    Prior to 'stamping' an image onto your drawing, various - effects can sometimes be applied (depending on the stamp):

    -
      -
    • Some stamps can be colored or tinted. If the color palette - below the canvas is activated, you can click the colors to change - the tint or color of the stamp before placing it in the picture.
      • -
    • Stamps can be shrunk and expanded, by clicking within the - triangular-shaped series of bars at the bottom right; - the larger the bar, the larger the stamp will appear in your - picture.
      • -
    • Many stamps may be flipped vertically, or displayed as a - mirror-image, using the control buttons at the bottom right.
      • -
    - -

    - +

    +

    + Tux Paint is an Open Source project, + Free Software released under the GNU General Public + License (GPL). It is free, and the 'source code' + behind the program is available. (This allows others to + add features, fix bugs, and use parts of the program in + their own GPL'd software.)

    - -

    Different stamps can have different sound effects and/or - descriptive (spoken) sounds. Buttons at the lower left - (near Tux, the Linux penguin) allow you to re-play the sound effects - and descriptive sounds for the currently-selected stamp.

    +

    + See COPYING.txt for the full + text of the GPL license. +

    +
    -

    (NOTE: If the "nostampcontrols" option is set, - Tux Paint won't display the Mirror, Flip, Shrink and Grow - controls for stamps. - See the "Options" - documentation.)

    - -
    -
    - - -
    Lines
    -
    - - -

    This tool lets you draw straight lines using the various - brushes and colors you normally use with the Paint Brush.

    - -

    Click the mouse and hold it to choose the starting point of the - line. As you move the mouse around, a thin 'rubber-band' line - will show where the line will be drawn.

    - -

    Let go of the mouse to complete the line. A "sproing!" sound will - play.

    - -
    - -

    - -
    -
    - - -
    Shapes
    -
    - - -

    This tool lets you draw some simple filled, and un-filled shapes.

    - -

    Select a shape from the selector on the right (circle, square, - oval, etc.).

    - -

    In the canvas, click the mouse and hold it to stretch the shape - out from where you clicked. Some shapes can change proportion - (e.g., rectangle and oval), others cannot (e.g., square and circle).

    - -

    Let go of the mouse when you're done stretching.

    +

    + Objectives: +

    +
    -
    Normal Mode
    -
    -

    Now you can move the mouse around the canvas to rotate the - shape.

    +
    + Easy and Fun +
    -

    Click the mouse button again and the shape will be drawn in the - current color.

    +
    + Tux Paint is meant to be a simple drawing program + for young children. It is not meant as a + general-purpose drawing tool. It is meant to be + fun and easy to use. Sound effects and a cartoon + character help let the user know what's going on, and + keeps them entertained. There are also extra-large + cartoon-style mouse pointer shapes.
    -
    Simple Shapes Mode
    +
    + Extensibility +
    +
    - If simple shapes are enabled (e.g., with the - "--simpleshapes" option), - the shape will be drawn on the canvas when you let go of the - mouse button. (There's no rotation step.) + Tux Paint is extensible. Brushes and "rubber + stamp" shapes can be dropped in and pulled out. For + example, a teacher can drop in a collection of animal + shapes and ask their students to draw an ecosystem. + Each shape can have a sound which is played, and + textual facts which are displayed, when the child + selects the shape. +
    + +
    + Portability +
    + +
    + Tux Paint is portable among various computer + platforms: Windows, Macintosh, Linux, etc. The + interface looks the same among them all. Tux Paint + runs suitably well on older systems (like a + Pentium 133), and can be built to run better on + slow systems. +
    + +
    + Simplicity +
    + +
    + There is no direct access to the computer's underlying + intricacies. The current image is kept when the program + quits, and reappears when it is restarted. Saving + images requires no need to create filenames or use the + keyboard. Opening an image is done by selecting it from + a collection of thumbnails. Access to other files on + the computer is restricted.
    +
    +
    -
    +
    -

    +

    + Using Tux Paint +

    -
    - +
    +

    + Loading Tux Paint +

    +
    +

    + Linux/Unix Users +

    -
    Text and Label
    -
    - - -

    Choose a font (from the 'Letters' available on the right) and a color - (from the color palette near the bottom). Click on the screen and a - cursor will appear. Type text and it will show up on the screen.

    - -

    Press [Enter] or [Return] and the text will be drawn - onto the picture and the cursor will move down one line.

    - -

    Alternatively, press [Tab] and the text will be drawn onto - the picture, but the cursor will move to the right of the text, - rather than down a line, and to the left. (This can be useful to - create a line of text with mixed colors, fonts, styles and sizes: - Like this.)

    - -

    Clicking elsewhere in the picture while the text entry is still - active causes the current line of text to move to that location - (where you can continue editing it).

    - -

    - -
    -
    Text versus Label
    -
    -

    The Text tool is the original text-entry tool in - Tux Paint. Text entered using this tool can't be modified - or moved later, since it becomes part of the drawing. However, - because the text becomes part of the picture, it can be drawn - over or modified using Magic tool effects (e.g., smudged, - tinted, embossed, etc.)

    - -

    When using the Label tool (which was added to - Tux Paint in version 0.9.22), the text 'floats' over the - image, and the details of the label (the text, the position of - the label, the font choice and the color) get stored separately. - This allows the label to be repositioned or edited later.

    - -

    The Label tool can be disabled (e.g., by selecting - "Disable 'Label' Tool" in Tux Paint Config. - or running Tux Paint with the "--nolabel" - command-line option).

    -
    - -
    International Character Input
    -
    -

    Tux Paint allows inputting characters in different languages. - Most Latin characters (A-Z, - ñ, è, etc.) can by entered directly. - Some languages require that Tux Paint be switched into an - alternate input mode before entering, and some characters must be - composed using numerous keypresses.

    - -

    When Tux Paint's locale is set to one of the - languages that provide alternate input modes, a key is used to - cycle through normal (Latin character) and locale-specific - mode or modes.

    - -

    Currently supported locales, the input methods available, and - the key to toggle or cycle modes, are listed below. - Note: Many fonts do not include all characters for - all languages, so sometimes you'll need to change fonts to see the - characters you're trying to type. +

    +

    + Tux Paint should have placed a laucher icon in your KDE + and/or GNOME menus, under 'Graphics.'

    -
      -
    • Japanese — Romanized Hiragana and Romanized Katakana - — right [Alt] -
      • -
    • Korean — Hangul 2-Bul - — right [Alt] or left [Alt] -
      • -
    • Traditional Chinese - — right [Alt] or left [Alt] -
      • -
    • Thai - — right [Alt] -
      • -
    -
    -
    -
    - +

    + Alternatively, you can run the following command at a + shell prompt (e.g., "$"): +

    -
    Fill
    -
    - +
    + $ tuxpaint +
    -

    The 'Fill' tool 'flood-fills' a contiguous area of your drawing - with a solid color of your choice.

    - -

    Note: Prior to Tux Paint 0.9.24, this was a "Magic" tool (see below).

    - -
    -
    - -
    Magic (Special Effects)
    -
    - - -

    The 'Magic' tool is actually a set of special tools. Select one of - the "magic" effects from the selector on the right. Then, depending - on the tool, you can either click and drag around the picture, - and/or simply click the picture once, to apply the effect.

    - -

    If the tool can be used by clicking and dragging, a 'painting' - button will be available on the left, below the list of "magic" tools - on the right side of the screen. If the tool can affect the entire - picture at once, an 'entire picture' button will be available - on the right.

    - -
    - -

    See the instructions for each Magic tool (in the 'magic-docs' folder).

    - -
    -
    - - -
    Eraser
    -
    - - -

    This tool is similar to the Paint Brush. Wherever you click - (or click and drag), the picture will be erased. (This may be - white, some other color, or to a background picture, depending on - the picture.)

    - -

    A number of eraser sizes are available, both round and square..

    - -

    As you move the mouse around, a square outline follows - the pointer, showing what part of the picture will be erased to - white.

    - -

    As you erase, a "squeaky clean" eraser/wiping sound is played.

    - -
    -
    - -
    - -
    - - -

    Other Controls

    -
    -
    -
    Undo
    -
    - - -

    Clicking this tool will undo the last drawing action. You can - even undo more than once!

    - -

    Note: You can also press [Control]-[Z] on the keyboard to - undo.

    - -
    - -
    -
    - - -
    Redo
    -
    - - -

    Clicking this tool will redo the drawing action you just "undid" - with the 'Undo' button.

    - -

    As long as you don't draw again, you can redo as many times as you - had "undone!"

    - -

    Note: You can also press [Control]-[R] on the keyboard to - redo.

    - -
    - -
    -
    - - -
    New
    -
    - - -

    Clicking the "New" button will start a new drawing. - A dialog will appear where you may choose to start a new picture - using a solid background color, or using a 'Starter' image (see below). - You will first be asked whether you really want to do this.

    - -

    Note: You can also press [Control]-[N] on the keyboard to - start a new drawing.

    - - 'Starter' Images - -
    -

    'Starters' can be like a page from a coloring book (a - black-and-white outline of a picture, which you can then - color in), or like a 3D photograph, where you draw the bits - in between.

    - -

    When you load a 'Starter,' draw on it, and then click 'Save,' - it creates a new picture file (it doesn't overwrite the original - 'Starter,' so you can use it again later).

    +

    + If any errors occur, they will be displayed on the + terminal (to "stderr"). +

    -
    +
    -
    -
    - - -
    Open
    -
    - - -

    This shows you a list of all of the pictures you've saved. - If there are more than can fit on the screen, use the "Up" - and "Down" arrows at the top and bottom of the list to scroll - through the list of pictures.

    - -
    - -

    - -

    Click a picture to select it, then...

    +

    + Windows Users +

    -
      -
    • - + + + + +
      + [Icon]
      + Tux Paint +
      -

      Click the green "Open" button at the lower left of the list to - load the selected picture.

      +

      + If you installed Tux Paint on your computer using + the 'Tux Paint Installer,' it will have asked + you whether you wanted a 'Start' menu short-cut, and/or + a desktop shortcut. If you agreed, you can simply run + Tux Paint from the 'Tux Paint' section of + your 'Start' menu (e.g., under "All Programs" on + Windows XP), or by double-clicking the + "Tux Paint" icon on your desktop. +

      -

      (Alternatively, you can double-click a picture's icon to load - it.)

      +

      + If you installed Tux Paint using the 'ZIP-file' + download, or if you used the + 'Tux Paint Installer,' but chose not to have + shortcuts installed, you'll need to double-click the + "tuxpaint.exe" icon in the + 'Tux Paint' folder on your computer. +

      -
      -
      • +

      + By default, the 'Tux Paint Installer' will + put Tux Paint's folder in + "C:\Program Files\", though you may + have changed this when the installer ran. +

      -
    • - - -

      Click the brown "Erase" (trash can) button at the lower right of - the list to erase the selected picture. (You will be asked to - confirm.)

      - -

      Note: As of version 0.9.22, the picture will be - placed in your desktop's trash can, on Linux only.

      - -
      -
      • - -
    • - - -

      Click the blue "Slides" (slide projector) button at the lower - left to go to slideshow mode. See "Slides", - below, for details.

      - -
      -
      • - -
    • - - -

      Or click the red "Back" arrow button at the lower right of the - list to cancel and return to the picture you were drawing.

      - -
      -
      • -
    +

    + If you used the 'ZIP-file' download, Tux Paint's + folder will be wherever you put it when you unzipped + the ZIP file. +

    +
    -

    If choose to open a picture, and your current drawing hasn't been - saved, you will be prompted as to whether you want to save it or not. - (See "Save," below.)

    - -

    Note: You can also press [Control]-[O] on the keyboard to get - the 'Open' dialog.

    - -
    +
    -
    -
    +

    + macOS Users +

    +
    +

    + Simply double-click the "Tux Paint" icon. +

    +
    +
    -
    Save
    -
    - +
    -

    This saves your current picture.

    - -

    If you haven't saved it before, it will create a new entry in - the list of saved images. (i.e., it will create a new file)

    +

    + Title Screen +

    -

    Note: It won't ask you anything (e.g., for a filename). - It will simply save the picture, and play a "camera shutter" sound - effect.

    +
    +

    + When Tux Paint first loads, a title/credits screen + will appear. +

    -

    If you HAVE saved the picture before, or this is a picture you - just loaded using the "Open" command, you will first be asked - whether you want to save over the old version, or create a new - entry (a new file).

    +

    + [Title Screenshot] +

    -

    +

    + Once loading is complete, press a key or click on the + mouse to continue. (Or, after about 30 seconds, the + title screen will go away automatically.) +

    +
    -

    (NOTE: If either the "saveover" or - "saveovernew" options are set, it won't ask before saving - over. - See the "Options" - documentation.)

    - -

    Note: You can also press [Control]-[S] on the keyboard to - save.

    - -
    +
    -
    -
    - - -
    Print
    -
    - - -

    Click this button and your picture will be printed!

    - -

    On most platforms, you can also hold the [Alt] key - (called [Option] on Macs) while clicking the 'Print' button - to get a printer dialog. Note that this may not work if you're - running Tux Paint in fullscreen mode. See below.

    +

    + Main Screen +

    +
    + The main screen is divided into the following sections:
    -
    Disabling Printing
    -
    -

    If the "noprint" option was set (either with - "noprint=yes" in Tux Paint's configuration file, - or using "--noprint" on the - command-line), the "Print" button will be disabled.

    +
    + Left Side: Toolbar +
    -

    See the "Options" - documentation.)

    -
    - - -
    Restricting Printing
    -
    -

    If the "printdelay" option was used (either with - "printdelay=SECONDS" in the configuration file, - or using "--printdelay=SECONDS" on the - command-line), you can only print once every SECONDS - seconds.

    +
    +

    + The toolbar contains the drawing and editing + controls. +

    + -

    For example, with "printdelay=60", you can print only - once a minute.

    +

    + + +

    +
    -

    See the "Options" - documentation.)

    - +
    + Middle: Drawing Canvas +
    - -
    Printing Commands
    -
    -

    (Linux and Unix only)

    +
    +

    + The largest part of the screen, in the center, is the + drawing canvas. This is, obviously, where you draw! +

    -

    Tux Paint prints by generating a PostScript - representation of the drawing and sending it to an external - program. By default, the program is:

    +

    + [(Canvas)] +

    -
    - lpr -
    +

    + Note: The size of the drawing canvas depends + on the size of Tux Paint. You can change the + size of Tux Paint using the + Tux Paint Config. configuration + tool, or by other means. See the OPTIONS documentation for more + details. +

    +
    -

    This command can be changed by setting the "printcommand" value - in Tux Paint's configuration file.

    +
    + Right Side: Selector +
    -

    If the [Alt] key on the keyboard is being pushed - while clicking the 'Print' button, as long as you're not in - fullscreen mode, an alternative program is run. By default, - the program is KDE's graphical print dialog:

    +
    +

    + Depending on the current tool, the selector shows + different things. e.g., when the Paint Brush + tool is selected, it shows the various brushes + available. When the Rubber Stamp tool is + selected, it shows the different shapes you can use. +

    -
    - kprinter -
    +

    + + +

    +
    -

    This command can be changed by setting the "altprintcommand" value - in Tux Paint's configuration file.

    +
    + Lower: Colors +
    -

    For information on how to change the printing commands, - see the "Options" - documentation.

    - +
    +

    + A palette of available colors are shown near the + bottom of the screen. +

    +

    + + +

    -
    Printer Settings
    -
    -

    (Windows and macOS)

    +

    + On the far right are two special color options, the + "color picker", which has an outline of an + eye-dropper, and allows you to pick a color found + within your drawing, and the rainbow palette, which + allows you to pick a color from within a box + containing thousands of colors. +

    -

    By default, Tux Paint simply prints to the default - printer with default settings when the 'Print' button is - pushed.

    +

    + (NOTE: You can define your own colors for + Tux Paint. See the "Options" documentation.) +

    +
    -

    However, if you hold the [Alt] (or [Option]) key - on the keyboard while pushing the button, as long as you're - not in fullscreen mode, your operating system's printer dialog - will appear, where you can change the settings.

    +
    + Bottom: Help Area +
    -

    You can have the printer configuration changes stored - by using the "printcfg" option, either by using - "--printcfg" on the command-line, or - "printcfg=yes" in Tux Paint's own configuration - file ("tuxpaint.cfg").

    +
    +

    + At the very bottom of the screen, Tux, the Linux + Penguin, provides tips and other information while + you draw. +

    -

    If the "printcfg" option is used, printer settings will - be loaded from the file "print.cfg" in your - personal folder (see below). - Any changes will be saved there as well.

    - -

    See the "Options" - documentation.)

    -
    - -
    Printer Dialog Options
    -
    -

    By default, Tux Paint only shows the printer dialog - (or, on Linux/Unix, runs the "altprintcommand", e.g., - "kprinter" instead of "lpr") if the [Alt] - (or [Option]) key is held while clicking the 'Print' - button.

    - -

    However, this behavior can be changed. You can have the - printer dialog always appear by using - "--altprintalways" on the command-line, or - "altprint=always" in Tux Paint's configuration - file. Or, you can prevent the [Alt]/[Option] - key from having any effect by using "--altprintnever", or - "altprint=never".

    - -

    See the "Options" - documentation.)

    -
    - +

    + + +

    + -
    +
    -
    - +
    -
    Slides (under "Open")
    -
    - +

    + Available Tools +

    -

    The "Slides" button is available in the "Open" dialog. - It displays a list of your saved files, just like the "Open" dialog.

    +
    +

    + Drawing Tools +

    -

    Click each of the images you wish to display in a slideshow-style - presentation, one by one. A digit will appear over each image, - letting you know in which order they will be displayed.

    +
    +
    +
    + Paint (Brush) +
    -

    You can click a selected image to unselect it (take it out of your - slideshow).

    +
    + +

    + The Paint Brush tool lets you draw freehand, + using various brushes (chosen in the Selector on + the right) and colors (chosen in the Color palette + towards the bottom). +

    -

    A sliding scale at the lower left of the screen (next to the "Play" - button) can be used to adjust the speed of the slideshow, from slowest - to fastest. Choose the leftmost setting to disable automatic - advancement — you will need to press a key or click to go to - the next slide (see below).

    +

    + If you hold the mouse button down, and move the + mouse, it will draw as you move. +

    -

    Note: The slowest setting does not automatically advance - through the slides. Use it for when you want to step through them - manually.

    +

    + As you draw, a sound is played. The bigger the + brush, the lower the pitch. +

    +
    -

    When you're ready, click the "Play" button to begin the slideshow. - (Note: If you hadn't selected ANY images, then ALL images will be - played in the slideshow.)

    +

    + +

    -

    During the slideshow, press [Space], [Enter] or - [Return] or the [Right Arrow], or click the "Next" - button at the lower left, to manually advance to the next slide. - Press [Left] to go back to the previous slide.

    +
    +
    -

    Press [Escape], or click the "Back" button at the - lower right, to exit the slideshow and return to the slideshow - image selection screen.

    +
    + Stamp (Rubber Stamp) +
    -

    Click "Back" in the slideshow image selection screen to return to - the "Open" dialog.

    +
    + +

    + The Stamp tool is like a set of rubber stamps or + stickers. It lets you paste pre-drawn or + photographic images (like a picture of a horse, or + a tree, or the moon) in your picture. +

    -
    -
    +

    + As you move the mouse around the canvas, an outline + follows the mouse, showing where the stamp will be + placed, and how big it will be. +

    -
    Quit
    -
    - +

    + +

    + +

    + There can be numerous categories of stamps (e.g., + animals, plants, outer space, vehicles, people, + etc.). Use the Left and Right arrows to cycle + through the collections. +

    -

    Clicking the "Quit" button, closing the Tux Paint window, or - pushing the [Escape] key will quit Tux Paint.

    - -

    You will first be prompted as to whether you really want to quit.

    +

    + Prior to 'stamping' an image onto your drawing, + various effects can sometimes be applied (depending + on the stamp): +

    -

    If you choose to quit, and you haven't saved the current picture, - you will first be asked if wish to save it. If it's not a new image, - you will then be asked if you want to save over the old version, - or create a new entry. (See "Save" above.)

    - -

    NOTE: If the image is saved, it will be reloaded automatically - the next time you run Tux Paint!

    +
      +
    • Some stamps can be colored or tinted. If the + color palette below the canvas is activated, you + can click the colors to change the tint or color of + the stamp before placing it in the picture. +
      • -

      NOTE: The "Quit" button and [Escape] key can be - disabled (e.g., by selecting "Disable 'Quit' Button" in - Tux Paint Config. or running Tux Paint - with the "--noquit" command-line option).

      - -

      In that case, the "window close" button on - Tux Paint's title bar (if not in fullscreen mode) or - the [Alt] + [F4] key sequence may be used - to quit.

      +
    • Stamps can be shrunk and expanded, by clicking + within the triangular-shaped series of bars at the + bottom right; the larger the bar, the larger the + stamp will appear in your picture. +
      • -

      If neither of those are possible, the key sequence of - [Shift] + [Control] + [Escape] - may be used to quit. (See the - "Options" documentation.)

      - -
      -
    +
  • Many stamps may be flipped vertically, or + displayed as a mirror-image, using the control + buttons at the bottom right. +
    • + -
    Sound Muting
    -
    -

    There is no on-screen control button at this time, but - by pressing [Alt] + [S], sound effects - can be disabled and re-enabled (muted and unmuted) while the - program is running.

    +

    + +

    + +

    + Different stamps can have different sound effects + and/or descriptive (spoken) sounds. Buttons at the + lower left (near Tux, the Linux penguin) allow you + to re-play the sound effects and descriptive sounds + for the currently-selected stamp. +

    -

    Note that if sounds are completely disabled - (e.g., by unselecting "Enable Sound Effects" in - Tux Paint Config or running Tux Paint - with the "--nosound" command-line option), - the [Alt] + [S] key sequence has no - effect. (i.e., it cannot be used to turn on sounds when the - parent/teacher wants them disabled.)

    +

    + (NOTE: If the "nostampcontrols" option + is set, Tux Paint won't display the Mirror, + Flip, Shrink and Grow controls for stamps. See the + "Options" + documentation.) +

    + +
    +
    + +
    + Lines +
    + +
    + +

    + This tool lets you draw straight lines using the + various brushes and colors you normally use with + the Paint Brush. +

    + +

    + Click the mouse and hold it to choose the starting + point of the line. As you move the mouse around, a + thin 'rubber-band' line will show where the line + will be drawn. +

    + +

    + Let go of the mouse to complete the line. A + "sproing!" sound will play. +

    +
    + +

    + +

    + +
    +
    + +
    + Shapes +
    + +
    + +

    + This tool lets you draw some simple filled, and + un-filled shapes. +

    + +

    + Select a shape from the selector on the right + (circle, square, oval, etc.). +

    + +

    + In the canvas, click the mouse and hold it to + stretch the shape out from where you clicked. Some + shapes can change proportion (e.g., rectangle and + oval), others cannot (e.g., square and circle). +

    + +

    + Let go of the mouse when you're done stretching. +

    + +
    +
    + Normal Mode +
    + +
    +

    + Now you can move the mouse around the canvas to + rotate the shape. +

    + +

    + Click the mouse button again and the shape will + be drawn in the current color. +

    +
    + +
    + Simple Shapes Mode +
    + +
    + If simple shapes are enabled (e.g., with the + "--simpleshapes" option), the shape + will be drawn on the canvas when you let go of + the mouse button. (There's no rotation step.) +
    +
    +
    + +

    + +

    + +
    +
    + +
    + Text and Label +
    + +
    + +

    + Choose a font (from the 'Letters' available on the + right) and a color (from the color palette near the + bottom). Click on the screen and a cursor will + appear. Type text and it will show up on the + screen. +

    + +

    + Press [Enter] or [Return] and the + text will be drawn onto the picture and the cursor + will move down one line. +

    + +

    + Alternatively, press [Tab] and the text will + be drawn onto the picture, but the cursor will move + to the right of the text, rather than down a line, + and to the left. (This can be useful to create a + line of text with mixed colors, fonts, styles and + sizes: Like this.) +

    + +

    + Clicking elsewhere in the picture while the text + entry is still active causes the current line of + text to move to that location (where you can + continue editing it). +

    + +

    + +

    + +
    +
    + Text versus Label +
    + +
    +

    + The Text tool is the original text-entry + tool in Tux Paint. Text entered using this + tool can't be modified or moved later, since it + becomes part of the drawing. However, because + the text becomes part of the picture, it can be + drawn over or modified using Magic tool + effects (e.g., smudged, tinted, embossed, etc.) +

    + +

    + When using the Label tool (which was + added to Tux Paint in version 0.9.22), the + text 'floats' over the image, and the details + of the label (the text, the position of the + label, the font choice and the color) get + stored separately. This allows the label to be + repositioned or edited later. +

    + +

    + The Label tool can be disabled (e.g., by + selecting "Disable 'Label' Tool" in + Tux Paint Config. or running + Tux Paint with the + "--nolabel" command-line option). +

    +
    + +
    + International Character Input +
    + +
    +

    + Tux Paint allows inputting characters in + different languages. Most Latin characters + (A-Z, ñ, è, etc.) + can by entered directly. Some languages require + that Tux Paint be switched into an + alternate input mode before entering, and some + characters must be composed using numerous + keypresses. +

    + +

    + When Tux Paint's locale is set to one of the + languages that provide alternate input modes, a + key is used to cycle through normal (Latin + character) and locale-specific mode or modes. +

    + +

    + Currently supported locales, the input methods + available, and the key to toggle or cycle + modes, are listed below. Note: Many + fonts do not include all characters for all + languages, so sometimes you'll need to change + fonts to see the characters you're trying to + type. +

    + +
      +
    • Japanese — Romanized Hiragana and Romanized + Katakana — right [Alt] +
      • + +
    • Korean — Hangul 2-Bul — + right [Alt] or + left [Alt] +
      • + +
    • Traditional Chinese — + right [Alt] or + left [Alt] +
      • + +
    • Thai — right [Alt] +
      • +
    +
    +
    +
    + +
    +
    +
    + +
    + Fill +
    + +
    + +

    + The 'Fill' tool 'flood-fills' a contiguous area of + your drawing with a solid color of your choice. +

    + +

    + Note: Prior to Tux Paint 0.9.24, this was a + "Magic" tool (see below). +

    + +
    +
    + +
    + Magic (Special Effects) +
    + +
    + +

    + The 'Magic' tool is actually a set of special + tools. Select one of the "magic" effects from the + selector on the right. Then, depending on the tool, + you can either click and drag around the picture, + and/or simply click the picture once, to apply the + effect. +

    + +

    + If the tool can be used by clicking and dragging, a + 'painting' button will be available on the left, + below the list of "magic" tools on the right side + of the screen. If the tool can affect the entire + picture at once, an 'entire picture' button + will be available on the right. +

    +
    + +

    + See the instructions for + each Magic tool (in the 'magic-docs' folder). +

    + +
    +
    + +
    + Eraser +
    + +
    + +

    + This tool is similar to the Paint Brush. Wherever + you click (or click and drag), the picture will be + erased. (This may be white, some other color, or to + a background picture, depending on the picture.) +

    + +

    + A number of eraser sizes are available, both round + and square.. +

    + +

    + As you move the mouse around, a square outline + follows the pointer, showing what part of the + picture will be erased to white. +

    + +

    + As you erase, a "squeaky clean" eraser/wiping sound + is played. +

    +
    +
    +
    +
    + +
    + +

    + Other Controls +

    + +
    +
    +
    + Undo +
    + +
    + +

    + Clicking this tool will undo the last drawing + action. You can even undo more than once! +

    + +

    + Note: You can also press [Control]-[Z] on + the keyboard to undo. +

    +
    + +
    +
    + +
    + Redo +
    + +
    + +

    + Clicking this tool will redo the drawing action you + just "undid" with the 'Undo' button. +

    + +

    + As long as you don't draw again, you can redo as + many times as you had "undone!" +

    + +

    + Note: You can also press [Control]-[R] on + the keyboard to redo. +

    +
    + +
    +
    + +
    + New +
    + +
    + +

    + Clicking the "New" button will start a new drawing. + A dialog will appear where you may choose to start + a new picture using a solid background color, or + using a 'Starter' image (see below). You will first + be asked whether you really want to do this. +

    + +

    + Note: You can also press [Control]-[N] on + the keyboard to start a new drawing. +

    + 'Starter' Images +
    +

    + 'Starters' can be like a page from a coloring + book (a black-and-white outline of a picture, + which you can then color in), or like a 3D + photograph, where you draw the bits in between. +

    + +

    + When you load a 'Starter,' draw on it, and then + click 'Save,' it creates a new picture file (it + doesn't overwrite the original 'Starter,' so you + can use it again later). +

    +
    +
    + +
    +
    + +
    + Open +
    + +
    + +

    + This shows you a list of all of the pictures you've + saved. If there are more than can fit on the + screen, use the "Up" and "Down" arrows at the top + and bottom of the list to scroll through the list + of pictures. +

    +
    + +

    + +

    + +

    + Click a picture to select it, then... +

    + +
    +
      +
    • + +

      + Click the green "Open" button at the lower + left of the list to load the selected + picture. +

      + +

      + (Alternatively, you can double-click a + picture's icon to load it.) +

      +
      +
      • + +
    • + +

      + Click the brown "Erase" (trash can) button at + the lower right of the list to erase the + selected picture. (You will be asked to + confirm.) +

      + +

      + Note: As of version 0.9.22, the + picture will be placed in your desktop's + trash can, on Linux only. +

      +
      +
      • + +
    • + +

      + Click the blue "Slides" (slide projector) + button at the lower left to go to slideshow + mode. See "Slides", + below, for details. +

      +
      +
      • + +
    • + +

      + Or click the red "Back" arrow button at the + lower right of the list to cancel and return + to the picture you were drawing. +

      +
      +
      • +
    +
    + +

    + If choose to open a picture, and your current + drawing hasn't been saved, you will be prompted as + to whether you want to save it or not. (See + "Save," below.) +

    + +

    + Note: You can also press [Control]-[O] on + the keyboard to get the 'Open' dialog. +

    +
    + +
    +
    + +
    + Save +
    + +
    + +

    + This saves your current picture. +

    + +

    + If you haven't saved it before, it will create a + new entry in the list of saved images. (i.e., it + will create a new file) +

    + +

    + Note: It won't ask you anything (e.g., for a + filename). It will simply save the picture, and + play a "camera shutter" sound effect. +

    + +

    + If you HAVE saved the picture before, or this is a + picture you just loaded using the "Open" command, + you will first be asked whether you want to save + over the old version, or create a new entry (a new + file). +

    + +

    + +

    + +

    + (NOTE: If either the "saveover" or + "saveovernew" options are set, it + won't ask before saving over. See the "Options" documentation.) +

    + +

    + Note: You can also press [Control]-[S] on + the keyboard to save. +

    +
    + +
    +
    + +
    + Print +
    + +
    + +

    + Click this button and your picture will be printed! +

    + +

    + On most platforms, you can also hold the + [Alt] key (called [Option] on Macs) + while clicking the 'Print' button to get a printer + dialog. Note that this may not work if you're + running Tux Paint in fullscreen mode. See + below. +

    + +
    +
    + Disabling Printing +
    + +
    +

    + If the "noprint" option was set (either with + "noprint=yes" in Tux Paint's + configuration file, or using + "--noprint" on the command-line), + the "Print" button will be disabled. +

    + +

    + See the "Options" + documentation.) +

    +
    + +
    + Restricting Printing +
    + +
    +

    + If the "printdelay" option was used (either + with "printdelay=SECONDS" + in the configuration file, or using + "--printdelay=SECONDS" on + the command-line), you can only print once + every SECONDS seconds. +

    + +

    + For example, with "printdelay=60", + you can print only once a minute. +

    + +

    + See the "Options" + documentation.) +

    +
    + +
    + Printing Commands +
    + +
    +

    + (Linux and Unix only) +

    + +

    + Tux Paint prints by generating a + PostScript representation of the drawing and + sending it to an external program. By default, + the program is: +

    + +
    + lpr +
    + +

    + This command can be changed by setting the + "printcommand" value in Tux Paint's + configuration file. +

    + +

    + If the [Alt] key on the keyboard is + being pushed while clicking the 'Print' button, + as long as you're not in fullscreen mode, an + alternative program is run. By default, the + program is KDE's graphical print dialog: +

    + +
    + kprinter +
    + +

    + This command can be changed by setting the + "altprintcommand" value in Tux Paint's + configuration file. +

    + +

    + For information on how to change the printing + commands, see the "Options" + documentation. +

    +
    + +
    + Printer Settings +
    + +
    +

    + (Windows and macOS) +

    + +

    + By default, Tux Paint simply prints to the + default printer with default settings when the + 'Print' button is pushed. +

    + +

    + However, if you hold the [Alt] (or + [Option]) key on the keyboard while + pushing the button, as long as you're not in + fullscreen mode, your operating system's + printer dialog will appear, where you can + change the settings. +

    + +

    + You can have the printer configuration changes + stored by using the "printcfg" option, either + by using "--printcfg" on the + command-line, or "printcfg=yes" in + Tux Paint's own configuration file + ("tuxpaint.cfg"). +

    + +

    + If the "printcfg" option is used, printer + settings will be loaded from the file + "print.cfg" in your personal + folder (see below). Any changes will be saved + there as well. +

    + +

    + See the "Options" + documentation.) +

    +
    + +
    + Printer Dialog Options +
    + +
    +

    + By default, Tux Paint only shows the + printer dialog (or, on Linux/Unix, runs the + "altprintcommand", e.g., "kprinter" instead of + "lpr") if the [Alt] (or [Option]) + key is held while clicking the 'Print' button. +

    + +

    + However, this behavior can be changed. You can + have the printer dialog always appear by using + "--altprintalways" on the + command-line, or "altprint=always" + in Tux Paint's configuration file. Or, you + can prevent the [Alt]/[Option] + key from having any effect by using + "--altprintnever", or + "altprint=never". +

    + +

    + See the "Options" + documentation.) +

    +
    +
    +
    + +
    +
    + +
    + Slides (under "Open") +
    + +
    + +

    + The "Slides" button is available in the "Open" + dialog. It displays a list of your saved files, + just like the "Open" dialog. +

    + +

    + Click each of the images you wish to display in a + slideshow-style presentation, one by one. A digit + will appear over each image, letting you know in + which order they will be displayed. +

    + +

    + You can click a selected image to unselect it (take + it out of your slideshow). +

    + +

    + A sliding scale at the lower left of the screen + (next to the "Play" button) can be used to adjust + the speed of the slideshow, from slowest to + fastest. Choose the leftmost setting to disable + automatic advancement — you will need to press a + key or click to go to the next slide (see below). +

    + +

    + Note: The slowest setting does not + automatically advance through the slides. Use it + for when you want to step through them manually. +

    + +

    + When you're ready, click the "Play" button to begin + the slideshow. (Note: If you hadn't selected ANY + images, then ALL images will be played in the + slideshow.) +

    + +

    + During the slideshow, press [Space], + [Enter] or [Return] or the + [Right Arrow], or click the "Next" + button at the lower left, to manually advance to + the next slide. Press [Left] to go back to + the previous slide. +

    + +

    + Press [Escape], or click the "Back" button + at the lower right, to exit the slideshow and + return to the slideshow image selection screen. +

    + +

    + Click "Back" in the slideshow image selection + screen to return to the "Open" dialog. +

    +
    +
    + +
    + Quit +
    + +
    + +

    + Clicking the "Quit" button, closing the + Tux Paint window, or pushing the + [Escape] key will quit Tux Paint. +

    + +

    + You will first be prompted as to whether you really + want to quit. +

    + +

    + If you choose to quit, and you haven't saved the + current picture, you will first be asked if wish to + save it. If it's not a new image, you will then be + asked if you want to save over the old version, or + create a new entry. (See "Save" + above.) +

    + +

    + NOTE: If the image is saved, it will be reloaded + automatically the next time you run Tux Paint! +

    + +

    + NOTE: The "Quit" button and [Escape] + key can be disabled (e.g., by selecting + "Disable 'Quit' Button" in + Tux Paint Config. or running + Tux Paint with the + "--noquit" command-line option). +

    + +

    + In that case, the "window close" button on + Tux Paint's title bar (if not in + fullscreen mode) or the + [Alt] + [F4] key sequence + may be used to quit. +

    + +

    + If neither of those are possible, the key sequence + of + [Shift] + [Control] + [Escape] + may be used to quit. (See the "Options" documentation.) +

    +
    +
    + +
    + Sound Muting +
    + +
    +

    + There is no on-screen control button at this time, + but by pressing + [Alt] + [S], sound effects + can be disabled and re-enabled (muted and unmuted) + while the program is running. +

    + +

    + Note that if sounds are completely disabled (e.g., + by unselecting "Enable Sound Effects" in + Tux Paint Config or running + Tux Paint with the + "--nosound" command-line option), the + [Alt] + [S] key sequence + has no effect. (i.e., it cannot be used to turn on + sounds when the parent/teacher wants them + disabled.) +

    +
    +
    +
    +
    +
    + +
    + +

    + Loading Other Pictures into + Tux Paint +

    + +
    +

    + Since Tux Paint's 'Open' dialog only displays pictures + you created with Tux Paint, what if you want to load + some other picture or photograph into Tux Paint to + edit? +

    + +

    + To do so, you simply need to convert the picture into a PNG + (Portable Network Graphic) image file, and place it in + Tux Paint's "saved" directory: +

    + +
    +
    + Windows Vista +
    + +
    + Inside the user's "AppData" folder, e.g.: + "C:\Users\(user name)\AppData\Roaming\TuxPaint\saved\" +
    + +
    + Windows 95, 98, ME, 2000, XP +
    + +
    + Inside the user's "Application Data" + folder, e.g.: "C:\Documents and + Settings\(user name)\Application + Data\TuxPaint\saved\" +
    + +
    + macOS +
    + +
    + Inside the user's "Library" folder: + "/Users/(user name)/Library/Application + Support/Tux Paint/saved/" +
    + +
    + Linux/Unix +
    + +
    + Inside a hidden ".tuxpaint" directory, in + the user's home directory: + "$(HOME)/.tuxpaint/saved/" +
    -
    -
    -
    -
    +

    + Note: It is from this folder that you can copy or + open pictures drawn in Tux Paint using other + applications. +

    +

    + Using 'tuxpaint-import' +

    -

    Loading Other Pictures into Tux Paint

    -
    -

    Since Tux Paint's 'Open' dialog only displays pictures you created - with Tux Paint, what if you want to load some other picture or - photograph into Tux Paint to edit?

    +
    +

    + Linux and Unix users can use the + "tuxpaint-import" shell script which + gets installed when you install Tux Paint. It uses + some NetPBM tools to convert the image + ("anytopnm"), resize it so that it will fit + in Tux Paint's canvas ("pnmscale"), and + convert it to a PNG ("pnmtopng"). +

    -

    To do so, you simply need to convert the picture into - a PNG (Portable Network Graphic) image file, and place it in Tux Paint's - "saved" directory:

    - -
    -
    Windows Vista
    -
    Inside the user's "AppData" folder, - e.g.: "C:\Users\(user name)\AppData\Roaming\TuxPaint\saved\"
    +

    + It also uses the "date" command to get the + current time and date, which is the file-naming + convention Tux Paint uses for saved files. + (Remember, you are never asked for a 'filename' when you + go to Save or Open pictures!) +

    -
    Windows 95, 98, ME, 2000, XP
    -
    Inside the user's "Application Data" folder, - e.g.: "C:\Documents and Settings\(user name)\Application - Data\TuxPaint\saved\"
    - -
    macOS
    -
    Inside the user's "Library" folder: - "/Users/(user name)/Library/Application Support/Tux Paint/saved/"
    - -
    Linux/Unix
    -
    Inside a hidden ".tuxpaint" directory, in the user's - home directory: "$(HOME)/.tuxpaint/saved/"
    -
    +

    + To use 'tuxpaint-import', simply run the + command from a command-line prompt and provide it the + name(s) of the file(s) you wish to convert. +

    -

    Note: It is from this folder that you can copy or open pictures - drawn in Tux Paint using other applications.

    +

    + They will be converted and placed in your Tux Paint + 'saved' directory. (Note: If you're doing this for a + different user - e.g., your child, you'll need to make + sure to run the command under their account.) +

    -

    Using 'tuxpaint-import'

    -
    -

    Linux and Unix users can use the "tuxpaint-import" - shell script which gets installed when you install Tux Paint. - It uses some NetPBM tools to convert the image ("anytopnm"), - resize it so that it will fit in Tux Paint's canvas - ("pnmscale"), and convert it to a PNG - ("pnmtopng").

    +

    + Example: +

    -

    It also uses the "date" command to get the current time and - date, which is the file-naming convention Tux Paint uses for saved - files. (Remember, you are never asked for a 'filename' when you go to - Save or Open pictures!)

    +
    + $ tuxpaint-import grandma.jpg
    + grandma.jpg -> + /home/username/.tuxpaint/saved/20020921123456.png
    + jpegtopnm: WRITING A PPM FILE     +
    -

    To use 'tuxpaint-import', simply run the command from a - command-line prompt and provide it the name(s) of the file(s) you wish - to convert.

    +

    + The first line + ("tuxpaint-import grandma.jpg") is the + command to run. The following two lines are output from + the program while it's working. +

    -

    They will be converted and placed in your Tux Paint 'saved' - directory. (Note: If you're doing this for a different user - e.g., - your child, you'll need to make sure to run the command under their - account.)

    +

    + Now you can load Tux Paint, and a version of that + original picture will be available under the 'Open' + dialog. Just double-click its icon! +

    +
    -

    Example:

    +

    + Doing it Manually +

    -
    - $ tuxpaint-import grandma.jpg
    - grandma.jpg -> /home/username/.tuxpaint/saved/20020921123456.png
    - jpegtopnm: WRITING A PPM FILE -
    +
    +

    + Windows, macOS, BeOS, and Haiku users must currently do the conversion manually. +

    -

    The first line ("tuxpaint-import grandma.jpg") is the - command to run. The following two lines are output from the program while - it's working.

    - -

    Now you can load Tux Paint, and a version of that original picture - will be available under the 'Open' dialog. Just double-click its icon!

    -
    +

    + Load a graphics program that is capable of both loading + your picture and saving a PNG format file. (See the + documentation file "PNG.txt" for + a list of suggested software, and other references.) +

    +

    + When Tux Paint loads an image that's not the same size as + its drawing canvas, it scales (and sometimes smears the + edges of) the image so that it fits within the canvas. +

    -

    Doing it Manually

    -
    -

    Windows, macOS, BeOS, and Haiku users must currently do the conversion - manually.

    +

    + To avoid having the image stretched or smeared, you can + resize it to Tux Paint's canvas size. This size + depends on the size of the Tux Paint window, or + resolution at which Tux Paint is run, if in + fullscreen. (Note: The default resolution is + 800x600.) See "Calculating Image Dimensions", below. +

    -

    Load a graphics program that is capable of both loading your picture - and saving a PNG format file. (See the documentation file - "PNG.txt" for a list of suggested software, - and other references.)

    +

    + Save the picture in PNG format. It is highly + recommended that you name the filename using the current + date and time, since that's the convention Tux Paint + uses: +

    -

    When Tux Paint loads an image that's not the same size as its drawing - canvas, it scales (and sometimes smears the edges of) the image so that - it fits within the canvas.

    +
    + YYYYMMDDhhmmss.png +
    -

    To avoid having the image stretched or smeared, you can resize it - to Tux Paint's canvas size. This size depends on the size of - the Tux Paint window, or resolution at which Tux Paint is - run, if in fullscreen. (Note: The default resolution is 800x600.) - See "Calculating Image Dimensions", below.

    +
      +
    • YYYY = Year +
      • -

      Save the picture in PNG format. It is highly recommended that you - name the filename using the current date and time, since that's - the convention Tux Paint uses:

      +
    • MM = Month (01-12) +
      • -
      - YYYYMMDDhhmmss.png +
    • DD = Day (01-31) +
      • + +
    • HH = Hour, in 24-hour format (00-23) +
      • + +
    • mm = Minute (00-59) +
      • + +
    • ss = Second (00-59) +
      • +
    + +

    + e.g.: +

    + +
    + 20020921130500 - for September 21, 2002, + 1:05:00pm +
    + +

    + Place this PNG file in your Tux Paint + 'saved' directory. (See above.) +

    + +

    + Calculating Image Dimensions +

    + +
    +

    + The width of Tux Paint's canvas is simply the + width of the window (e.g., 640, 800 or 1024 pixels), + minus 192. +

    + +

    + Calculating the height of Tux Paint's canvas + requires multiple steps: +

    + +
      +
    1. Take the height of the window (e.g, 480, 600 or 768 + pixels) and subtract 144 +
      2. + +
    2. Take the result of Step 1 and divide it by 48 +
      3. + +
    3. Take the result of Step 2 and round it down + (e.g., 9.5 becomes simply 9) +
      4. + +
    4. Take the result of Step 3 and multiply it by + 48 +
      5. + +
    5. Finally, take the result of Step 4 and add 40 +
      6. +
    + +

    + Example: Tux Paint running at fullscreen on + a 1440x900 display. +

    + +
      +
    • The canvas width is simply 1440 - 192, or + 1248. +
      • + +
    • The canvas height is calculated as: +
        +
      1. 900 - 144, or 756 +
        2. + +
      2. 756 / 48, or 15.75 +
        3. + +
      3. 15.75 rounded down, or 15 +
        4. + +
      4. 15 * 48, or 720 +
        5. + +
      5. 720 + 40, or 760 +
        6. +
      +
      • +
    + +

    + So the canvas within a 1440x900 Tux Paint window + is 1248x760. +

    +
    +
    - +
    -

    e.g.:

    +

    + Further Reading +

    - 20020921130500 - for September 21, 2002, 1:05:00pm -
    - -

    Place this PNG file in your Tux Paint 'saved' - directory. (See above.)

    - -

    Calculating Image Dimensions

    -
    -

    The width of Tux Paint's canvas is simply the width of the - window (e.g., 640, 800 or 1024 pixels), minus 192.

    - -

    Calculating the height of Tux Paint's canvas requires multiple - steps:

    -
      -
    1. Take the height of the window (e.g, 480, 600 or 768 pixels) and - subtract 144
      2. -
    2. Take the result of Step 1 and divide it by 48
      3. -
    3. Take the result of Step 2 and round it down (e.g., 9.5 becomes - simply 9)
      4. -
    4. Take the result of Step 3 and multiply it by 48
      5. -
    5. Finally, take the result of Step 4 and add 40
      6. -
    - -

    Example: Tux Paint running at fullscreen on a 1440x900 - display.

    + Other documentation included with Tux Paint (in the + "docs" folder/directory) include:
      -
    • The canvas width is simply 1440 - 192, or 1248.
      • -
    • The canvas height is calculated as: -
        -
      1. 900 - 144, or 756
        2. -
      2. 756 / 48, or 15.75
        3. -
      3. 15.75 rounded down, or 15
        4. -
      4. 15 * 48, or 720
        5. -
      5. 720 + 40, or 760
        6. -
      -
      • +
    • + "Magic" Tool Documentation + ("magic-docs")
      + Documentation for each of the currently-installed "Magic" + tools. +
      • + +
    • + AUTHORS.txt
      + List of authors and contributors. +
      • + +
    • + CHANGES.txt
      + Summary of changed between releases. +
      • + +
    • + COPYING.txt
      + Copying license (The GNU General Public License). +
      • + +
    • + INSTALL.txt
      + Instructions for compiling/installing, when applicable. +
      • + +
    • + EXTENDING.html
      + Detailed instructions on creating brushes, stamps and + starters, and adding fonts, to extend Tux Paint. +
      • + +
    • + OPTIONS.html
      + Detailed instructions on command-line and + configuration-file options, for those who don't want to + use Tux Paint Config. +
      • + +
    • + PNG.txt
      + Notes on creating PNG format bitmapped images for use in + Tux Paint. +
      • + +
    • + SVG.txt
      + Notes on creating SVG format vector images for use in + Tux Paint. +
      • + +
    • + SIGNALS.txt
      + Information about POSIX signals Tux Paint responds + to. +
    -

    So the canvas within a 1440x900 Tux Paint window is 1248x760.

    -
    -
    -
    +
    +

    + How to Get Help +

    -

    Further Reading

    -
    - Other documentation included with Tux Paint (in the "docs" - folder/directory) include: +
    +

    + If you need help, feel free to contact New Breed Software: +

    - -
    - -
    - - -

    How to Get Help

    -
    -

    If you need help, feel free to contact New Breed Software:

    - -
    - http://www.newbreedsoftware.com/ -
    - -

    You may also wish to participate in the numerous Tux Paint mailing - lists:

    - -
    - http://www.tuxpaint.org/lists/ -
    - -
    - - +

    + You may also wish to participate in the numerous + Tux Paint mailing lists: +

    +
    + http://www.tuxpaint.org/lists/ +
    +
    + +