                               Tux Paint Config.
                                 version 0.0.7

                        Configuration tool for Tux Paint

                Copyright 2002-2006 by Bill Kendrick and others
                               New Breed Software

                           bill@newbreedsoftware.com
                            http://www.tuxpaint.org/

                     September 22, 2004 - September 9, 2006

   --------------------------------------------------------------------------

                                     About

     "Tux Paint Config." is a graphical configuration tool for "Tux Paint."
     It provides a point-and-click interface that allows parents and teachers
     to alter Tux Paint's behavior -- disable sound effects, run in
     full-screen mode, etc. -- without needing to manipulate a text-based
     configuration file.

   --------------------------------------------------------------------------

                                    License

     Tux Paint Config. 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.

   --------------------------------------------------------------------------

                              Other Documentation

     Other documentation included with Tux Paint Config. (in the "docs"
     folder/directory) include:

       * AUTHORS.txt
         List of authors and contributors
       * CHANGES.txt
         Summary of changed between releases
       * INSTALL.txt
         Instructions on how to compile and install
       * COPYING.txt
         Copying license (The GPL)
       * README.txt
         (This file)
       * TODO.txt
         A list of pending features or bugs needing fixed

   --------------------------------------------------------------------------

                            Using Tux Paint Config.

     Tux Paint Config.'s interface is divided into seven (7) tabs, each
     containing a different category of options that you can change in
     Tux Paint. (For full details on Tux Paint's options, we recommend
     reading Tux Paint's own documentation.)

     At the bottom of the screen are three buttons:

       * Defaults - This sets the options shown on the current tab to their
         default settings. (In other words, how Tux Paint would operate if
         you didn't make any changes to the options.)
       * Apply - This saves settings of all the options, on all the tabs, to
         your Tux Paint configuration file. (On Linux and Unix, this is
         "~/.tuxpaintrc". On Windows, this is "tuxpaint.cfg".)
       * Reset - This discards all unsaved changes on all the tabs. It loads
         whatever settings are currently stored in your Tux Paint
         configuration file.

     The various tabs, and the options found within, are described below:

About

       This tab simply contains some information about Tux Paint Config.

Video & Sound

         * Fullscreen - This causes Tux Paint to (attempt to) run in
           fullscreen mode, rather than in a window on your desktop. It
           causes Tux Paint to display across your entire screen (or as much
           as it can, with a border around the outside), in essense turning
           your monitor into a Tux Paint-only display.
         * Resolution / Window Size - By default, Tux Paint creates a
           relatively small window (640 pixels across by 480 pixels high).
           Since many people prefer a larger drawing canvas, Tux Paint can be
           told to create an 800x600 window, instead. (If running in
           fullscreen, this also determines the monitor resolution Tux Paint
           will try to switch into.)
         * Enable Sound Effects - By default, Tux Paint plays sounds for
           practically every action that takes place... drawing with the
           brush, displaying a pop-up dialog, painting a rainbow. By
           un-checking this option, you can turn sounds off.

Mouse & Keyboard

         * Fancy Cursor Shapes - Normally, Tux Paint changes the shape of
           your mouse pointer when the mouse is inside the Tux Paint window.
           It turns into a large brush when painting, and a cross-hair when
           drawing lines, for example. However, the large brushes can cause
           problems on some systems, so you can disable this option if the
           brushes don't work right for you.
         * Grab Mouse Pointer - If you'd rather not run Tux Paint in
           fullscreen mode, but you want to keep children from getting at
           your desktop files or other applications, you can have Tux Paint
           'grab' the mouse pointer, which prevents it from leaving the
           Tux Paint window.
         * Mouse Wheen Support - If your mouse has a scroll wheel, Tux Paint
           will let you use it to scroll up and down through the selection
           menu on the right (e.g., the brush or stamp collections). However,
           if your child still lacks dexterity with the mouse, they may hit
           the scroll wheel accidentally, and get frustrated. You can tell
           Tux Paint to ignore the mouse wheel, if that is the case.
         * Enable Keyboard Shortcuts - Tux Paint supports some keyboard
           shortcuts ('accelerators'), like Control + S to Save and
           Control + Z to Undo. If your child hits the keyboard accidentally,
           you can disable these shortcuts to prevent them from being used
           accidentally.

Simplification

       If your child is very young, or is handicapped, the 'Simplification'
       options can help make Tux Paint even easier to use.

         * Disable Shape Rotation - Tux Paint's 'Shape' tool works in three
           steps: (1) click where you want the center of your shape to be,
           (2) drag out from the center to determine the size of the shape,
           and (3) move the mouse to rotate the shape, and click once more to
           finalize it. The third step (rotation) can be tricky to get the
           hang of, and very young children are more interested in the shapes
           themselves, not the angles they can be drawn at. Hence, you can
           disable shape rotation by selecting this option.
         * Simple Stamp Outlines - If your computer is very slow, or you're
           using Tux Paint on a thin client (displaying over a network), you
           can simplify the outlines drawn around stamps to help speed up the
           display.
         * Show Uppercase Text Only - If your child is just learning to read,
           and hasn't yet mastered the lowercase alphabet, you can tell
           Tux Paint to display everything in uppercase. (LIKE THIS.)
         * Disable Quit Button - This greys out the 'Quit' button in
           Tux Paint. The Escape key and the close button in the window's
           toolbar still work (though the latter can be made inaccessible by
           running Tux Paint in fullscreen mode, or in mouse-grab mode.)
         * Disable Stamps Tool - This prevents Tux Paint from loading any
           stamps at start-up, this speeding up the load process and, of
           course, causing the 'Stamps' tool button to be greyed out.
         * Disable Stamp Controls - Tux Paint allows stamps to be shrunk and
           grown, and many stamps can be flipped and/or mirrored. These
           options add four buttons to the Stamp tool's selector, however,
           which can confuse the younger users. Disable those controls with
           this option.

Languages

         * Language - Tux Paint has been translated into dozens of languages.
           While it can use your system's global language preference, you may
           prefer to run your desktop in one language, and have your children
           use Tux Paint in another. Select the language you want Tux Paint
           to run in from the pull-down menu. (Select "Use system's setting"
           to use your system's global language preference.)
         * Mirror Stamps - Some people are used to things going
           right-to-left, rather than left-to-right. (Hebrew is written
           right-to-left, for example.) Most stamps are oriented
           left-to-right, and many can be mirrored using the 'Mirror' stamp
           control. You can tell Tux Paint to mirror all such stamps, by
           default, when it starts up.

Printing

         * Allow Printing - If you wish to disable the 'Print' button in
           Tux Paint, un-check this option.
         * Print Delay - If you wish to allow printing in Tux Paint, but
           limit it to, say, only once every 5 minutes, you can enter a delay
           value (in seconds). After printing, Tux Paint will wait that long
           before the 'Print' button works again.
         * Use Alternative Print Command / Alternative Print Command:
           (Advanced! Unix/Linux only!) By default, Tux Paint under Linux and
           Unix uses the external program 'lpr' for printing pictures. You
           can specify a different command here. The command you specify must
           accept PostScript format on it's standard input (STDIN).

Saving

  Save Over Earlier Work

         Tux Paint has one 'Save' command, which works with one click. If
         you're done drawing a picture, click 'Save' and it is saved, no
         questions asked!

         However, if you're re-saving a picture that you loaded using the
         'Open' command, Tux Paint needs to know whether you want to save
         over the original, or save a new image. (In most other programs,
         this would be 'Save' versus 'Save As...', respectively.)

         By default, Tux Paint will pop up a prompt asking whether to 'save
         over the older version of [the] picture.' Choosing 'Yes' will wipe
         out the old version, replacing it with the updated drawing. Choosing
         'No' will preserve the old version, and save a completely new file.

         To simplify the 'Save' process by never asking the 'save over?'
         question, you can tell Tux Paint what to do ahead of time:

           * Ask Before Overwriting - This is the default behavior, described
             above. (Ask whether to save over, or not.)
           * Always Overwrite Older Version - This will always wipe out the
             old version, replacing it with any updates to the drawing. (It's
             like 'Save' in other desktop applications.)
           * Always Save New Picture - This will never wipe out older work,
             this preserving every single change that's ever been saved.
             (It's like always using 'Save As...' in other desktop
             applications.) Warning: Using this option obviously creates the
             potential for many files being stored in Tux Paint! You may want
             to go in and manually remove files for your child. (Tux Paint's
             'Open' dialog uses thumbnails to show the saved pictures, and
             includes an 'Erase' button, so you can do this from within
             Tux Paint.)

  Save Directory

         Since Tux Paint never asks where to save pictures (or what filename
         to use when creating the files), it keeps all of its pictures in its
         own special directory.

         If you wish to change where Tux Paint saves pictures (and, of
         course, where it looks for them when the 'Open' command is used),
         you can do so here.

         This can be useful in a school lab where all of the computers are
         shared by students, and students must log into a special network
         drive to save their files. You can tell Tux Paint to save on the
         mapped network drive, rather than on the local hard drive.

         See Tux Paint's own documentation for more on the subject.

  Disable Saving

         If you wish for Tux Paint to be used only as a 'scratch pad' for
         drawing, you may disable the 'Save' button. Obviously, this makes it
         impossible to save any drawings, so most people will have no use for
         this option.

   --------------------------------------------------------------------------

                                More Information

     For more information, see the other documentation files that come with
     Tux Paint.

     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/
