2395 lines
70 KiB
HTML
2395 lines
70 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html><head><title>Tux Paint README</title>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
|
|
</head>
|
|
|
|
<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
|
|
alink="#FF00FF">
|
|
|
|
<center>
|
|
<h1><img src="images/tuxpaint-title.png" width=220 height=219
|
|
alt="Tux Paint"><br>
|
|
|
|
version
|
|
|
|
0.9.14
|
|
|
|
</h1>
|
|
<h3>A simple drawing program for children</h3>
|
|
|
|
<p>Copyright 2004 by Bill Kendrick<br>
|
|
New Breed Software</p>
|
|
|
|
<p><a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a><br>
|
|
<a href="http://www.newbreedsoftware.com/tuxpaint/">http://www.newbreedsoftware.com/tuxpaint/</a></p>
|
|
|
|
<p>June 14, 2002 - September 13, 2004</p>
|
|
</center>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
<h1>About</h1>
|
|
<blockquote>
|
|
<p>"Tux Paint" is a drawing program for young children.
|
|
It provides a simple interface and fixed canvas size, and provides
|
|
access to previous images using a thumbnail browser (e.g., no access to
|
|
the underlying file-system).</p>
|
|
|
|
<p>Unlike popular drawing programs like "The GIMP," it has a very
|
|
limited tool-set. However, it provides a much simpler interface,
|
|
and has entertaining, child-oriented additions such as sound effects.</p>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1>License:</h1>
|
|
<blockquote>
|
|
<p>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.)</p>
|
|
|
|
<p>See COPYING.txt for the full text of the GPL license.</p>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1>Objectives:</h1>
|
|
<blockquote>
|
|
<dl>
|
|
<dt><b>Easy and Fun</b></dt>
|
|
<dd>
|
|
Tux Paint is meant to be a simple drawing program for young children.
|
|
It is not meant as a general-purpose drawing tool. It <i>is</i> 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.
|
|
</dd>
|
|
|
|
<dt><b>Extensibility</b></dt>
|
|
<dd>
|
|
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.
|
|
</dd>
|
|
|
|
<dt><b>Portability</b></dt>
|
|
<dd>
|
|
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.
|
|
</dd>
|
|
|
|
<dt><b>Simplicity</b></dt>
|
|
<dd>
|
|
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.
|
|
</dd>
|
|
</dl>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1>Other Documentation</h1>
|
|
<blockquote>
|
|
Other documentation included with Tux Paint (in the "<code>docs</code>"
|
|
folder/directory) include:
|
|
|
|
<ul>
|
|
<li>AUTHORS.txt<br>
|
|
List of authors and contributors
|
|
|
|
<li>CHANGES.txt<br>
|
|
Summary of changed between releases
|
|
|
|
<li>COPYING.txt<br>
|
|
Copying license (The GPL)
|
|
|
|
<li>INSTALL.txt<br>
|
|
Instructions for compiling/installing, when applicable
|
|
|
|
<li>PNG.txt<br>
|
|
Notes on creating PNG format images for use in Tux Paint
|
|
|
|
<li>README.txt<br>
|
|
(This file)
|
|
|
|
<li>TODO.txt<br>
|
|
A list of pending features or bugs needing fixed
|
|
</ul>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1>Using Tux Paint</h1>
|
|
<blockquote>
|
|
|
|
<h2>Building Tux Paint</h2>
|
|
<blockquote>
|
|
To compile Tux Paint from source, please refer to INSTALL.txt.
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
<h2>Loading Tux Paint</h2>
|
|
<blockquote>
|
|
<h3>Linux/Unix Users</h3>
|
|
<blockquote>
|
|
<p>Run the following command at a shell prompt (e.g., "$"):</p>
|
|
|
|
<blockquote>
|
|
<code>$ tuxpaint</code>
|
|
</blockquote>
|
|
|
|
<p>It is also possible to make a launcher button or icon
|
|
(e.g. in GNOME or KDE under Linux).
|
|
See your desktop environment's documentation for details...</p>
|
|
|
|
<p>If any errors occur, they will be displayed on the terminal
|
|
(to "stderr").</p>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h3>Windows Users</h3>
|
|
<blockquote>
|
|
<table border=0 cellspacing=0 cellpadding=4 bgcolor="#AAAAFF"
|
|
align=right summary=""><tr><td align=center>
|
|
<img src="images/icon-win32.png" width=32 height=32 alt="[Icon]"><br>
|
|
Tux Paint
|
|
</td></tr></table>
|
|
|
|
<p>Simply double-click the "Tux Paint" icon on the desktop
|
|
(which was created for you by the installer), or double-click the
|
|
"tuxpaint.exe" icon in the 'Tux Paint' folder on your computer.</p>
|
|
|
|
<p>If any errors occur, they will be stored in a file named
|
|
"stderr.txt" in the Tux Paint folder.</p>
|
|
|
|
<p>See "INSTALL.txt" for details on customizing the 'Shortcut' icon to
|
|
Tux Paint, which lets you easily set program options (via the
|
|
command-line).</p>
|
|
|
|
<p>To run Tux Paint and provide command-line options directly, you
|
|
will need to run "<code>tuxpaint.exe</code>" from an MSDOS Prompt window.
|
|
(See "INSTALL.txt" for details.)</p>
|
|
|
|
<br clear=all>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h3>Mac OS X Users</h3>
|
|
<blockquote>
|
|
Simply double-click the "Tux Paint" icon.<p>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h2><a name="options">Options</a></h2>
|
|
<blockquote>
|
|
<h3>Configuration File</h3>
|
|
<blockquote>
|
|
<p>You can create a simple configuration file for Tux Paint, which it
|
|
will read each time you start it up.</p>
|
|
|
|
<p>The file is simply a plain text file containing the options
|
|
you want enabled:</p>
|
|
|
|
<h4>Linux Users</h4>
|
|
<blockquote>
|
|
<p>The file you should create is called "<code><b>.tuxpaintrc</b></code>"
|
|
and it should be placed in your home directory.
|
|
(a.k.a. "<code>~/.tuxpaintrc</code>" or
|
|
"<code>$HOME/.tuxpaintrc</code>")</p>
|
|
|
|
<p>Before this file is read, a system-wide configuration file is
|
|
read. (By default, this configuration has no settings enabled.)
|
|
It is located at:</p>
|
|
|
|
<blockquote>
|
|
<code>/etc/tuxpaint/tuxpaint.conf</code>
|
|
</blockquote>
|
|
|
|
<p>You can disable reading of this file altogether, leaving the
|
|
settings as defaults (which can then be overridden by your
|
|
"<code>.tuxpaintrc</code>" file and/or command-line arguments)
|
|
by using the command-line option:</p>
|
|
|
|
<blockquote>
|
|
<code>--nosysconfig</code>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
|
|
<h4>Windows Users</h4>
|
|
<blockquote>
|
|
<p>The file you should create is called
|
|
"<code><b>tuxpaint.cfg</b></code>" and it
|
|
should be placed in Tux Paint's folder.</p>
|
|
|
|
<p>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...</p>
|
|
</blockquote>
|
|
|
|
|
|
<h4>Available Options</h4>
|
|
<blockquote>
|
|
<p>The following settings can be set in the configuration file.
|
|
(Command-line settings will override these.
|
|
See the "<a href="#command_line"><i>Command-Line Options</i></a>"
|
|
section, below.)</p>
|
|
|
|
<dl>
|
|
<dt><code><b>fullscreen=yes</b></code></dt>
|
|
<dd>
|
|
Run the program in full screen mode, rather than in a window.
|
|
</dd>
|
|
|
|
<dt><code><b>800x600=yes</b></code></dt>
|
|
<dd>
|
|
Run the program at 800x600 resolution (EXPERIMENTAL), rather
|
|
than the smaller 640x480 resolution.
|
|
</dd>
|
|
|
|
<dt><code><b>nosound=yes</b></code></dt>
|
|
<dd>
|
|
Disable sound effects.
|
|
</dd>
|
|
|
|
<dt><code><b>noquit=yes</b></code></dt>
|
|
<dd>
|
|
Disable the on-screen "Quit" button.
|
|
(Pressing the <b>[Escape]</b> key or clicking the window's close
|
|
button still works.)
|
|
</dd>
|
|
|
|
<dt><code><b>noprint=yes</b></code></dt>
|
|
<dd>
|
|
Disable the printing feature.
|
|
</dd>
|
|
|
|
<dt><code><b>printdelay=<i>SECONDS</i></b></code></dt>
|
|
<dd>
|
|
Restrict printing so that printing can occur only once every
|
|
<i>SECONDS</i> seconds.
|
|
</dd>
|
|
|
|
<dt><code><b>printcommand=<i>COMMAND</i></b></code></dt>
|
|
<dd>
|
|
<p><i>(Linux and Unix only)</i></p>
|
|
|
|
<p>Use the command <i>COMMAND</i> to print a PNG file.
|
|
If not set, the default command is:</p>
|
|
|
|
<blockquote>
|
|
<code>pngtopnm | pnmtops | lpr</code>
|
|
</blockquote>
|
|
|
|
<p>Which converts the PNG to a NetPBM 'portable anymap',
|
|
then converts that to a PostScript file, and finally
|
|
sends that to the printer, using the "<code>lpr</code>" command.</p>
|
|
</dd>
|
|
|
|
<dt><code><b>printcfg=yes</b></code></dt>
|
|
<dd>
|
|
<p><i>(Windows only)</i></p>
|
|
|
|
<p>Tux Paint will use a printer configuration file when printing.
|
|
Push the <b>[ALT]</b> key while clicking the 'Print' button in
|
|
Tux Paint to cause a Windows print dialog window to appear.</p>
|
|
|
|
<p>(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 "<code>userdata/print.cfg</code>", and
|
|
used again, as long as the "printcfg" option is set.</p>
|
|
</dd>
|
|
|
|
<dt><code><b>simpleshapes=yes</b></code></dt>
|
|
<dd>
|
|
Disable the rotation step of the 'Shape' tool.
|
|
Click, drag and release is all that will be needed to draw a shape.
|
|
</dd>
|
|
|
|
<dt><code><b>uppercase=yes</b></code></dt>
|
|
<dd>
|
|
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.
|
|
</dd>
|
|
|
|
<dt><code><b>grab=yes</b></code></dt>
|
|
<dd>
|
|
<p>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.</p>
|
|
|
|
<p>This is useful to disable operating system actions that could get
|
|
the user out of Tux Paint <b>[Alt]-[Tab]</b> window cycling,
|
|
<b>[Ctrl]-[Escape]</b>, etc. This is especially useful in
|
|
fullscreen mode.</p>
|
|
</dd>
|
|
|
|
<dt><code><b>noshortcuts=yes</b></code></dt>
|
|
<dd>
|
|
<p>This disable keyboard shortcuts (e.g., <b>[Ctrl]-[S]</b> for save,
|
|
<b>[Ctrl]-[N]</b> for a new image, etc.)</p>
|
|
|
|
<p>This is useful to prevent unwanted commands from being activated
|
|
by children who aren't experienced with keyboards.</p>
|
|
</dd>
|
|
|
|
<dt><code><b>nowheelmouse=yes</b></code></dt>
|
|
<dd>
|
|
This disables support for the wheel on mice that have it.
|
|
(Normally, the wheel will scroll the selector menu on the right.)
|
|
</dd>
|
|
|
|
<dt><code><b>nofancycursors=yes</b></code></dt>
|
|
<dd>
|
|
<p>This disables the fancy mouse pointer shapes in Tux Paint,
|
|
and uses your environment's normal mouse pointer.</p>
|
|
|
|
<p>In some enviornments, the fancy cursors cause problems.
|
|
Use this option to avoid them.</p>
|
|
</dd>
|
|
|
|
<dt><code><b>nooutlines=yes</b></code></dt>
|
|
<dd>
|
|
<p>In this mode, much simpler outlines and 'rubber-band' lines are
|
|
displayed when using the <b>Lines</b>, <b>Shapes</b>,
|
|
<b>Stamps</b> and <b>Eraser</b> tools.</p>
|
|
|
|
<p>This can help when Tux Paint is run on very slow computers,
|
|
or displayed on a remote X-Window display.</p>
|
|
</dd>
|
|
|
|
<dt><code><b>nostamps=yes</b></code></dt>
|
|
<dd>
|
|
<p>This option tells Tux Paint to not load any rubber stamp
|
|
images, which in turn ends up disabling the <b>Stamps</b> tool.</p>
|
|
|
|
<p>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.</p>
|
|
</dd>
|
|
|
|
<dt><code><b>nostampcontrols=yes</b></code></dt>
|
|
<dd>
|
|
Some images in the <b>Stamps</b> tool can be mirrored, flipped,
|
|
and/or have their size changed. This option disables the controls,
|
|
and only provides the basic stamps.
|
|
</dd>
|
|
|
|
<dt><code><b>mirrorstamps=yes</b></code></dt>
|
|
<dd>
|
|
<p>For stamps that can be mirrored, this option sets them to their
|
|
mirrored shape by default.</p>
|
|
|
|
<p>This can be useful for people who prefer things right-to-left,
|
|
rather than left-to-right.</p>
|
|
</dd>
|
|
|
|
<dt><code><b>keyboard=yes</b></code></dt>
|
|
<dd>
|
|
<p>This allows the keyboard arrow keys to be used
|
|
to control the mouse pointer. (e.g., for mouseless environments.)</p>
|
|
|
|
<p>The <b>[Arrow]</b> keys move the mouse pointer.
|
|
<b>[Space]</b> acts as the mouse button.</p>
|
|
</dd>
|
|
|
|
<dt><code><b>savedir=<i>DIRECTORY</i></b></code></dt>
|
|
<dd>
|
|
<p>Use this option to change where Tux Paint saves pictures.
|
|
By default, this is "<code>~/.tuxpaint/saved/</code>" under Linux
|
|
and Unix, and "<code>userdata\</code>" under Windows.</p>
|
|
|
|
<p>This can be useful in a Windows lab, where Tux Paint is
|
|
installed on a server, and children run it from workstations.
|
|
You can set <code>savedir</code> to be a folder in their home
|
|
directory. (e.g., "<code>H:\tuxpaint\</code>")</p>
|
|
|
|
<p><b>Note:</b> When specifying a Windows drive (e.g.,
|
|
"<code>H:\</code>"), you must also specify a subdirectory.</p>
|
|
|
|
<p><b>Example:</b> <code>savedir=Z:\tuxpaint\</code></p>
|
|
</dd>
|
|
|
|
<dt><code><b>saveover=yes</b></code></dt>
|
|
<dd>
|
|
This disables the "<i>Save over the old version...?</i>" prompt when
|
|
saving an existing file. With this option, the older version
|
|
will always be replaced by the new version, automatically.
|
|
</dd>
|
|
|
|
<dt><code><b>saveover=new</b></code></dt>
|
|
<dd>
|
|
This also disables the "<i>Save over the old version...?</i>" prompt
|
|
when saving an existing file. This option, however, will always
|
|
save a new file, rather than overwrite the older version.
|
|
</dd>
|
|
|
|
<dt><code><b>saveover=ask</b></code></dt>
|
|
<dd>
|
|
<p><i>(This option is redundant, since this is the default.)</i></p>
|
|
|
|
When saving an existing drawing, you will be first asked whether
|
|
to save over the older version or not.
|
|
</dd>
|
|
|
|
<dt><code><b>nosave=yes</b></code></dt>
|
|
<dd>
|
|
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.
|
|
</dd>
|
|
|
|
<dt><code><b>lang=<i>LANGUAGE</i></b></code></dt>
|
|
<dd>
|
|
<p>Run Tux Paint in one of the supported languages.
|
|
Possible choice for <i>LANGUAGE</i> currently include:</p>
|
|
|
|
<blockquote>
|
|
<table border=1 cellspacing=0 cellpadding=4
|
|
summary="Possible values for 'lang' language setting">
|
|
<tr>
|
|
<td><code>english</code></td>
|
|
<td><code>american-english</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>afrikaans</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>basque</code></td>
|
|
<td><code>euskara</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>belarusian</code></td>
|
|
<td><code>bielaruskaja</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>bokmal</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>brazilian-portuguese</code></td>
|
|
<td><code>portuges-brazilian</code></td>
|
|
<td><code>brazilian</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>breton</code></td>
|
|
<td><code>brezhoneg</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>british-english</code></td>
|
|
<td><code>british</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>bulgarian</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>catalan</code></td>
|
|
<td><code>catala</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>chinese</code></td>
|
|
<td><code>simplified-chinese</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>croatian</code></td>
|
|
<td><code>hrvatski</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>czech</code></td>
|
|
<td><code>cesky</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>danish</code></td>
|
|
<td><code>dansk</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>dutch</code></td>
|
|
<td><code>nederlands</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>finnish</code></td>
|
|
<td><code>suomi</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>french</code></td>
|
|
<td><code>francais</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>german</code></td>
|
|
<td><code>deutsch</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>greek</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>hebrew</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>hungarian</code></td>
|
|
<td><code>magyar</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>icelandic</code></td>
|
|
<td><code>islenska</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>indonesian</code></td>
|
|
<td><code>bahasa-indonesia</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>italian</code></td>
|
|
<td><code>italiano</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>japanese</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>klingon</code></td>
|
|
<td><code>tlhIngan</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>korean</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>lithuanian</code></td>
|
|
<td><code>lietuviu</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>malay</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>norwegian</code></td>
|
|
<td><code>nynorsk</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>polish</code></td>
|
|
<td><code>polski</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>portuguese</code></td>
|
|
<td><code>portugues</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>romanian</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>russian</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>serbian</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>spanish</code></td>
|
|
<td><code>espanol</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>slovak</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>slovenian</code></td>
|
|
<td><code>slovensko</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>swedish</code></td>
|
|
<td><code>svenska</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>tamil</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>traditional-chinese</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>turkish</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>vietnamese</code></td>
|
|
<td> </td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>walloon</code></td>
|
|
<td><code>walon</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>welsh</code></td>
|
|
<td><code>cymraeg</code></td>
|
|
<td> </td>
|
|
</tr>
|
|
</table>
|
|
</blockquote>
|
|
</dd>
|
|
</dl>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
<h4>Overriding System Config. Options using <code>.tuxpaintrc</code></h4>
|
|
<blockquote>
|
|
<p>If any of the above options are set in
|
|
"<code>/etc/tuxpaint/tuxpaint.config</code>",
|
|
you can override them in your own
|
|
"<code>~/.tuxpaintrc</code>" file.</p>
|
|
|
|
<p>For true/false options, like "<code>noprint</code>" and
|
|
"<code>grab</code>", you can simply say they equal 'no' in
|
|
your "<code>~/.tuxpaintrc</code>" file:</p>
|
|
|
|
<blockquote><code>
|
|
noprint=no<br>
|
|
uppercase=no
|
|
</code></blockquote>
|
|
|
|
<p>Or, you can use options similar to the command-line override
|
|
options described below. For example:</p>
|
|
|
|
<blockquote><code>
|
|
print=yes<br>
|
|
mixedcase=yes
|
|
</code></blockquote>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
<h3><a name="command_line">Command-Line Options</a></h3>
|
|
<blockquote>
|
|
Options can also be issued on the command-line when you start
|
|
Tux Paint.
|
|
|
|
<blockquote>
|
|
<dl>
|
|
<dt><code><b>
|
|
--fullscreen<br>
|
|
--800x600<br>
|
|
--nosound<br>
|
|
--noquit<br>
|
|
--noprint<br>
|
|
--printdelay=SECONDS<br>
|
|
--printcfg<br>
|
|
--simpleshapes<br>
|
|
--uppercase<br>
|
|
--grab<br>
|
|
--noshortcuts<br>
|
|
--nowheelmouse<br>
|
|
--nofancycursors<br>
|
|
--nooutlines<br>
|
|
--nostamps<br>
|
|
--nostampcontrols<br>
|
|
--mirrorstamps<br>
|
|
--keyboard<br>
|
|
--savedir DIRECTORY<br>
|
|
--saveover<br>
|
|
--saveovernew<br>
|
|
--nosave<br>
|
|
--lang LANGUAGE<br>
|
|
</b></code></dt>
|
|
<dd>
|
|
These enable or correspond to the configuration file options
|
|
described above.
|
|
</dd>
|
|
|
|
<dt><code><b>
|
|
--windowed<br>
|
|
--640x480<br>
|
|
--sound<br>
|
|
--quit<br>
|
|
--print<br>
|
|
--printdelay=0<br>
|
|
--noprintcfg<br>
|
|
--complexshapes<br>
|
|
--mixedcase<br>
|
|
--dontgrab<br>
|
|
--shortcuts<br>
|
|
--wheelmouse<br>
|
|
--fancycursors<br>
|
|
--outlines<br>
|
|
--stamps<br>
|
|
--stampcontrols<br>
|
|
--dontmirrorstamps<br>
|
|
--mouse<br>
|
|
--saveoverask<br>
|
|
--save<br>
|
|
</b></code></dt>
|
|
<dd>
|
|
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.)
|
|
</dd>
|
|
|
|
|
|
<dt><code><b><a name="locale">--locale locale</a></b></code></dt>
|
|
<dd>
|
|
<p>Run Tux Paint in one of the support languages.
|
|
See the "<i><a href="#different_language">Choosing a Different
|
|
Language</a></i>" section below for the
|
|
locale strings (e.g., "<code>de_DE@euro</code>" for German) to
|
|
use.</p>
|
|
|
|
<p>(If your locale is already set, e.g. with the "<code>$LANG</code>"
|
|
environment variable, this option is not necessary,
|
|
since Tux Paint honors your environment's setting,
|
|
if possible.)</p>
|
|
</dd>
|
|
|
|
<dt><code><b>--nosysconfig</b></code></dt>
|
|
<dd>
|
|
<p>Under Linux and Unix, this prevents the system-wide configuration
|
|
file, "<code>/etc/tuxpaint/tuxpaint.conf</code>", from being read.</p>
|
|
|
|
<p>Only your own configuration file, "<code>~/.tuxpaintrc</code>",
|
|
if it exists, will be used.</p>
|
|
</dd>
|
|
|
|
<dt><code><b>--nolockfile</b></code></dt>
|
|
<dd>
|
|
<p>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.)</p>
|
|
|
|
<p>To make Tux Paint ignore the lockfile, allowing it to
|
|
run again, even if it was just launched less than 30 seconds
|
|
ago, run Tux Paint with the '<code>--nolockfile</code>' option
|
|
on the command-line.</p>
|
|
|
|
<p>By default, the lockfile is stored in
|
|
"<code>~/.tuxpaint/</code>" under Linux and Unix,
|
|
and "<code>userdata\</code>" under Windows.</p>
|
|
</dd>
|
|
</dl>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h3>Command-Line Informational Options</h3>
|
|
<blockquote>
|
|
<p>The following options display some informative text on the screen.
|
|
Tux Paint doesn't actually start up and run afterwards, however.</p>
|
|
|
|
<blockquote>
|
|
<dl>
|
|
<dt><code><b>--version</b></code></dt>
|
|
<dd>
|
|
Display the version number and date of the copy of Tux Paint
|
|
you are running. It also lists what, if any, compile-time
|
|
options were set. (See INSTALL.txt and FAQ.txt).
|
|
</dd>
|
|
|
|
<dt><code><b>--copying</b></code></dt>
|
|
<dd>
|
|
Show brief license information about copying Tux Paint.
|
|
</dd>
|
|
|
|
<dt><code><b>--usage</b></code></dt>
|
|
<dd>
|
|
Display the list of available command-line options.
|
|
</dd>
|
|
|
|
<dt><code><b>--help</b></code></dt>
|
|
<dd>
|
|
Display brief help on using Tux Paint.
|
|
</dd>
|
|
|
|
<dt><code><b>--lang help</b></code></dt>
|
|
<dd>
|
|
Display a list of available languages in Tux Paint.
|
|
</dd>
|
|
</dl>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h3><a name="different_language">Choosing a Different Language</a></h3>
|
|
<blockquote>
|
|
<p>Tux Paint has been translated into a number of languages.
|
|
To access the translations, you can use the "<code>--lang</code>"
|
|
option on the command-line to set the language (e.g.
|
|
"<code>--lang spanish</code>")
|
|
or use the "<code>lang=</code>" setting in the configuration file
|
|
(e.g., "<code>lang=spanish</code>").</p>
|
|
|
|
<p>Tux Paint also honors your environment's current locale.
|
|
(You can override it on the command-line using the
|
|
"<code>--locale</code>" option; see <a href="#locale">above</a>.)</p>
|
|
|
|
<p>Use the option "<code>--lang help</code>" to list the
|
|
available language options available.</p>
|
|
|
|
<p>The following languages are supported:</p>
|
|
|
|
<blockquote><table border=1 cellspacing=0 cellpadding=2
|
|
summary="Locale values and the languages they represent.">
|
|
<tr>
|
|
<th>Locale Code</th>
|
|
<th>Language<br>
|
|
(native name)</th>
|
|
<th>Language<br>
|
|
(English name)</th>
|
|
</tr>
|
|
<tr>
|
|
<td><code>C</code></td>
|
|
<td> </td>
|
|
<td>English</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>af_ZA</code></td>
|
|
<td> </td>
|
|
<td>Afrikaans</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>be_BY</code></td>
|
|
<td>Bielaruskaja</td>
|
|
<td>Belarusian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>bg_BG</code></td>
|
|
<td> </td>
|
|
<td>Bulgarian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>br_FR</code></td>
|
|
<td>Brezhoneg</td>
|
|
<td>Breton</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>ca_ES</code></td>
|
|
<td>Català</td>
|
|
<td>Catalan</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>cs_CZ</code></td>
|
|
<td>Cesky</td>
|
|
<td>Czech</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>cy_GB</code></td>
|
|
<td>Cymraeg</td>
|
|
<td>Welsh</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>da_DK</code></td>
|
|
<td>Dansk</td>
|
|
<td>Danish</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>de_DE@euro</code></td>
|
|
<td>Deutsch</td>
|
|
<td>German</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>el_GR.UTF8</code> (*)</td>
|
|
<td> </td>
|
|
<td>Greek</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>en_GB</code></td>
|
|
<td> </td>
|
|
<td>British English</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>es_ES@euro</code></td>
|
|
<td>Español</td>
|
|
<td>Spanish</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>eu_ES</code></td>
|
|
<td>Euskara</td>
|
|
<td>Basque</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>fi_FI@euro</code></td>
|
|
<td>Suomi</td>
|
|
<td>Finnish</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>fr_FR@euro</code></td>
|
|
<td>Français</td>
|
|
<td>French</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>he_IL</code> (*)</td>
|
|
<td> </td>
|
|
<td>Hebrew</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>hr_HR</code></td>
|
|
<td>Hrvatski</td>
|
|
<td>Croatian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>hu_HU</code></td>
|
|
<td>Magyar</td>
|
|
<td>Hungarian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>id_ID</code></td>
|
|
<td>Bahasa Indonesia</td>
|
|
<td>Indonesian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>is_IS</code></td>
|
|
<td>Íslenska</td>
|
|
<td>Icelandic</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>it_IT@euro</code></td>
|
|
<td>Italiano</td>
|
|
<td>Italian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>ja_JP.UTF-8</code> (*)</td>
|
|
<td> </td>
|
|
<td>Japanese</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>ko_KR.UTF-8</code> (*)</td>
|
|
<td> </td>
|
|
<td>Korean</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>lt_LT.UTF-8</code></td>
|
|
<td>Lietuviu</td>
|
|
<td>Lithuanian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>ms_MY</code></td>
|
|
<td> </td>
|
|
<td>Malay</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>nb_NO</code></td>
|
|
<td>Norsk (bokmål)</td>
|
|
<td>Norwegian Bokmål</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>nn_NO</code></td>
|
|
<td>Norsk (nynorsk)</td>
|
|
<td>Norwegian Nynorsk</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>nl_NL@euro</code></td>
|
|
<td> </td>
|
|
<td>Dutch</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>pl_PL</code></td>
|
|
<td>Polski</td>
|
|
<td>Polish</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>pt_BR</code></td>
|
|
<td>Portugês Brazileiro</td>
|
|
<td>Brazilian Portuguese</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>pt_PT</code></td>
|
|
<td>Portugês</td>
|
|
<td>Portuguese</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>ro_RO</code></td>
|
|
<td> </td>
|
|
<td>Romanian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>ru_RU</code></td>
|
|
<td> </td>
|
|
<td>Russian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>sk_SK</code></td>
|
|
<td> </td>
|
|
<td>Slovak</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>sl_SI</code></td>
|
|
<td> </td>
|
|
<td>Slovenian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>sr_YU</code></td>
|
|
<td> </td>
|
|
<td>Serbian</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>sv_SE@euro</code></td>
|
|
<td>Svenska</td>
|
|
<td>Swedish</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>ta_IN</code> (*)</td>
|
|
<td> </td>
|
|
<td>Tamil</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>tlh</code> (*)</td>
|
|
<td>tlhIngan</td>
|
|
<td>Klingon</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>tr_TR@euro</code></td>
|
|
<td> </td>
|
|
<td>Turkish</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>vi_VN</code></td>
|
|
<td> </td>
|
|
<td>Vietnamese</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>wa_BE@euro</code></td>
|
|
<td> </td>
|
|
<td>Walloon</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>zh_CN</code> (*)</td>
|
|
<td> </td>
|
|
<td>Chinese (Simplified)</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>zh_TW</code> (*)</td>
|
|
<td> </td>
|
|
<td>Chinese (Traditional)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<b>(*)</b> - These languages require their own fonts, since they
|
|
are not represented using a Latin character set, like the others.
|
|
See the "<a href="#special_fonts"><i>Special Fonts</i></a>"
|
|
section, below.<p>
|
|
|
|
</blockquote>
|
|
|
|
<h4>Setting Your Environment's Locale</h4>
|
|
<blockquote>
|
|
<p>Changing your locale will affect much of your environment.</p>
|
|
|
|
<p>As stated above, along with letting you choose the language at
|
|
runtime using command-line options ("<code>--lang</code>" and
|
|
"<code>--locale</code>"),
|
|
Tux Paint honors the global locale setting in your environment.</p>
|
|
|
|
<p>If you haven't already set your environment's locale, the following
|
|
will briefly explain how:</p>
|
|
|
|
<h5>Linux/Unix Users</h5>
|
|
<blockquote>
|
|
<p>First, be sure the locale you want to use is enabled by
|
|
editing the file "<code>/etc/locale.gen</code>" on your system and
|
|
then running the program "<code>locale-gen</code>" as root.</p>
|
|
|
|
<p><i>Note: Debian users may be able to simply run the command
|
|
"<code>dpkg-reconfigure locales</code>".</i></p>
|
|
|
|
<p>Then, before running Tux Paint, set your "<code>$LANG</code>"
|
|
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. <code>~/.profile</code>,
|
|
<code>~/.bashrc</code>, <code>~/.cshrc</code>, etc.)</p>
|
|
|
|
|
|
<p>For example, in a Bourne Shell (like BASH):</p>
|
|
|
|
<blockquote><code>
|
|
export LANG=es_ES@euro ; \<br>
|
|
tuxpaint
|
|
</code></blockquote>
|
|
|
|
|
|
<p>And in a C Shell (like TCSH):</p>
|
|
|
|
<blockquote><code>
|
|
setenv LANG es_ES@euro ; \<br>
|
|
tuxpaint
|
|
</code></blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
<h5>Windows Users</h5>
|
|
<blockquote>
|
|
<p>Tux Paint will recognize the current locale and use the
|
|
appropriate files by default. So this section is only for people
|
|
trying different languages.</p>
|
|
|
|
<p>The simplest thing to do is to use the '<code>--lang</code>'
|
|
switch in the shortcut (see "INSTALL.txt"). However, by using
|
|
an MSDOS Prompt window, it is also possible to issue a command
|
|
like this:</p>
|
|
|
|
<blockquote><code>
|
|
set LANG=es_ES@euro
|
|
</code></blockquote>
|
|
|
|
<p>...which will set the language for the lifetime of that DOS
|
|
window.</p>
|
|
|
|
<p>For something more permanent, try editing your computer's
|
|
'<code>autoexec.bat</code>' file using Windows' "<b>sysedit</b>"
|
|
tool:</p>
|
|
|
|
<h6>Windows 95/98</h6>
|
|
<ol>
|
|
<li>Click on the 'Start' button, and select 'Run...'.
|
|
<li>Type "sysedit" into the 'Open:' box (with or without quotes).
|
|
<li>Click 'OK'.
|
|
<li>Locate the AUTOEXEC.BAT window in the System Configuration
|
|
Editor.
|
|
<li>Add the following at the bottom of the file:
|
|
|
|
<blockquote><code>
|
|
set LANG=es_ES@euro
|
|
</code></blockquote>
|
|
|
|
<li>Close the System Configuration Editor, answering yes to save
|
|
the changes.
|
|
<li>Restart your machine.
|
|
</ol>
|
|
|
|
<blockquote>
|
|
To affect the <b>entire machine</b>, and <b>all applications</b>,
|
|
it is possible to use the "Regional Settings" control panel:
|
|
</blockquote>
|
|
|
|
<ol>
|
|
<li>Click on the 'Start' button, and select
|
|
'Settings | Control Panel'.
|
|
<li>Double click on the "Regional Settings" globe.
|
|
<li>Select a language/region from the drop down list.
|
|
<li>Click 'OK'.
|
|
<li>Restart your machine when prompted.
|
|
</ol>
|
|
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<h4><a name="special_fonts">Special Fonts</a></h4>
|
|
<blockquote>
|
|
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
|
|
"<a href="#different_language"><i>Choosing a Different Language</i></a>"
|
|
section.)<p>
|
|
|
|
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
|
|
"<code><b>fonts</b></code>" directory (under a
|
|
"<code><b>locale</b></code>" 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" for Chinese).<p>
|
|
|
|
For example, under Linux or Unix, when Tux Paint is run in Korean
|
|
(e.g., with the option "<code>--lang korean</code>"),
|
|
Tux Paint will attempt to load the following font file:<p>
|
|
|
|
<blockquote>
|
|
<code>/usr/share/tuxpaint/fonts/locale/<b>ko.ttf</b></code>
|
|
</blockquote><p>
|
|
|
|
You can download fonts for supported languages from Tux Paint's
|
|
website,
|
|
<a href="http://www.newbreedsoftware.com/tuxpaint/">
|
|
http://www.newbreedsoftware.com/tuxpaint/</a>.
|
|
(Look in the 'Fonts' section under 'Download.')<p>
|
|
|
|
Under Unix and Linux, you can use the <code>Makefile</code> that comes
|
|
with the font to install the font in the appropriate location.<p>
|
|
</blockquote>
|
|
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h2>Title Screen</h2>
|
|
<blockquote>
|
|
<p>When Tux Paint first loads, a title/credits screen will appear.</p>
|
|
|
|
<center><img src="images/tuxpaint-title.jpg" width=324 height=254
|
|
alt="[Title Screenshot]"></center>
|
|
|
|
<p>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.)</p>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h2>Main Screen</h2>
|
|
<blockquote>
|
|
The main screen is divided into the following sections:
|
|
|
|
<dl>
|
|
<dt>Left Side: Toolbar</dt>
|
|
<dd>
|
|
<p>The toolbar contains the drawing and editing controls.</p>
|
|
|
|
<center><img src="images/tools.jpg" width=324 height=254
|
|
alt="[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Undo, Redo,
|
|
Eraser, New, Open, Save, Print, Quit]"></center>
|
|
</dd>
|
|
|
|
<dt>Middle: Drawing Canvas</dt>
|
|
<dd>
|
|
<p>The largest part of the screen, in the center, is the drawing
|
|
canvas. This is, obviously, where you draw!</p>
|
|
|
|
<center><img src="images/canvas.jpg" width=324 height=254
|
|
alt="[(Canvas)]"></center>
|
|
</dd>
|
|
|
|
|
|
<dt>Right Side: Selector</dt>
|
|
<dd>
|
|
<p>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.</p>
|
|
|
|
<center><img src="images/selector.jpg" width=324 height=254
|
|
alt="[Selectors - Brushes, Letters, Shapes, Stamps]"></center>
|
|
</dd>
|
|
|
|
|
|
<dt>Lower: Colors</dt>
|
|
<dd>
|
|
<p>A palette of available colors are shown near the bottom of the
|
|
screen.</p>
|
|
|
|
<center><img src="images/colors.jpg" width=324 height=254
|
|
alt="[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan,
|
|
Blue, Purple, Brown, Grey]"></center>
|
|
</dd>
|
|
|
|
|
|
<dt>Bottom: Help Area</dt>
|
|
<dd>
|
|
<p>At the very bottom of the screen, Tux, the Linux Penguin,
|
|
provides tips and other information while you draw.</p>
|
|
|
|
<center><img src="images/tips.jpg" width=324 height=254
|
|
alt="(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.)"></center>
|
|
</dd>
|
|
</dl>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h2>Available Tools</h2>
|
|
<blockquote>
|
|
<h3>Drawing Tools</h3>
|
|
<blockquote>
|
|
<dl>
|
|
<dt><b>Paint (Brush)</b></dt>
|
|
<dd>
|
|
<img src="images/tool_paint.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>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).</p>
|
|
|
|
<p>If you hold the mouse button down, and move the mouse, it will
|
|
draw as you move.</p>
|
|
|
|
<p>As you draw, a sound is played. The bigger the brush, the
|
|
lower the pitch.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<center><img src="images/ex_paint.png" width=120 height=95
|
|
alt=""></center>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>Stamp (Rubber Stamp)</b></dt>
|
|
<dd>
|
|
<img src="images/tool_stamp.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>The Stamp tool is like a rubber stamp, 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.</p>
|
|
|
|
<p>As you move the mouse around, an outline follows the
|
|
mouse, showing where the stamp will be placed.</p>
|
|
|
|
<p>Different stamps can have different sound effects.
|
|
Some stamps can be colored or tinted.</p>
|
|
|
|
<p>Stamps can be shrunk and expanded, and many stamps can be
|
|
flipped vertically, or displayed as a mirror-image, using
|
|
controls at the bottom right of the screen.</p>
|
|
|
|
<p>(NOTE: If the "<code>nostampcontrols</code>" option is set,
|
|
Tux Paint won't display the Mirror, Flip, Shrink and Grow
|
|
controls for stamps. See the "<a href="#options"><i>Options</i></a>"
|
|
section of this document, above.)</p>
|
|
|
|
<br clear=all>
|
|
|
|
<center><img src="images/ex_stamps.png" width=182 height=156
|
|
alt=""></center>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>Lines</b></dt>
|
|
<dd>
|
|
<img src="images/tool_lines.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>This tool lets you draw straight lines using the various
|
|
brushes and colors you normally use with the Paint Brush.</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<p>Let go of the mouse to complete the line. A "sproing!" sound will
|
|
play.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<center><img src="images/ex_lines.png" width=76 height=103
|
|
alt=""></center>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>Shapes</b></dt>
|
|
<dd>
|
|
<img src="images/tool_shapes.png" width=48 height=48 alt=""
|
|
align=right>
|
|
|
|
<p>This tool lets you draw some simple filled, and un-filled shapes.</p>
|
|
|
|
<p>Select a shape from the selector on the right (circle, square,
|
|
oval, etc.).</p>
|
|
|
|
<p>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).</p>
|
|
|
|
<p>Let go of the mouse when you're done stretching.</p>
|
|
|
|
<dl>
|
|
<dt>Normal Mode</dt>
|
|
<dd>
|
|
<p>Now you can move the mouse around the canvas to rotate the
|
|
shape.</p>
|
|
|
|
<p>Click the mouse button again and the shape will be drawn in the
|
|
current color.</p>
|
|
</dd>
|
|
|
|
<dt>Simple Shapes Mode</dt>
|
|
<dd>
|
|
If simple shapes are enabled (e.g., with the
|
|
"<code>--simpleshapes</code>" option),
|
|
the shape will be drawn on the canvas when you let go of the
|
|
mouse button. (There's no rotation step.)
|
|
</dd>
|
|
</dl>
|
|
|
|
<br clear=all>
|
|
|
|
<center><img src="images/ex_shapes.png" width=177 height=104
|
|
alt=""></center>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>Text</b></dt>
|
|
<dd>
|
|
<img src="images/tool_text.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>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.</p>
|
|
|
|
<p>Press <b>[Enter]</b> or <b>[Return]</b> and the text will be drawn
|
|
onto the picture and the cursor will move down one line.</p>
|
|
|
|
<p>Click elsewhere in the picture and the current line of text will
|
|
move there, where you can continue editing.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<center><img src="images/ex_text.png" width=139 height=69
|
|
alt=""></center>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>Magic (Special Effects)</b></dt>
|
|
<dd>
|
|
<img src="images/tool_magic.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>The 'Magic' tool is actually a set of special tools. Select one of
|
|
the "magic" effects from the selector on the right, and then
|
|
click and drag around the picture to apply the effect.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<dl>
|
|
<dt><b>Rainbow</b></dt>
|
|
<dd>
|
|
This is similar to the paint brush, but as you move the mouse
|
|
around, it goes through all of the colors in the rainbow.
|
|
</dd>
|
|
|
|
<dt><b>Sparkles</b></dt>
|
|
<dd>
|
|
This draws glowing yellow sparkles on the picture.
|
|
</dd>
|
|
|
|
<dt><b>Mirror</b></dt>
|
|
<dd>
|
|
When you click the mouse in your picture with the "Mirror"
|
|
magic effect selected, the entire image will be reversed,
|
|
turning it into a mirror image.
|
|
</dd>
|
|
|
|
<dt><b>Flip</b></dt>
|
|
<dd>
|
|
Similar to "Mirror." Click and the entire image will be turned
|
|
upside-down.
|
|
</dd>
|
|
|
|
<dt><b>Blur</b></dt>
|
|
<dd>
|
|
This makes the picture fuzzy wherever you drag the mouse.
|
|
</dd>
|
|
|
|
<dt><b>Blocks</b></dt>
|
|
<dd>
|
|
This makes the picture blocky looking ("pixelated") wherever
|
|
you drag the mouse.
|
|
</dd>
|
|
|
|
<dt><b>Negative</b></dt>
|
|
<dd>
|
|
This inverts the colors wherever you drag the mouse.
|
|
(e.g., white becomes black, and vice versa.)
|
|
</dd>
|
|
|
|
<dt><b>Fade</b></dt>
|
|
<dd>
|
|
This fades the colors wherever you drag the mouse.
|
|
(Do it to the same spot many times, and it will eventually become
|
|
white.)
|
|
</dd>
|
|
|
|
<dt><b>Chalk</b></dt>
|
|
<dd>
|
|
This makes parts of the picture (where you move the mouse)
|
|
look like a chalk drawing.
|
|
</dd>
|
|
|
|
<dt><b>Drip</b></dt>
|
|
<dd>
|
|
This makes the paint "drip" wherever you move the mouse.
|
|
</dd>
|
|
|
|
<dt><b>Thick</b></dt>
|
|
<dd>
|
|
This makes the darker colors in the picture become thicker
|
|
wherever you drag the mouse.
|
|
</dd>
|
|
|
|
<dt><b>Thin</b></dt>
|
|
<dd>
|
|
Similar to "Thick," except dark colors become thinner
|
|
(light colors become thicker).
|
|
</dd>
|
|
|
|
<dt><b>Fill</b></dt>
|
|
<dd>
|
|
This floods the picture with a color. It lets you quickly
|
|
fill parts of the picture, as if it were a coloring book.
|
|
</dd>
|
|
</dl>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>Eraser</b></dt>
|
|
<dd>
|
|
<img src="images/tool_eraser.png" width=48 height=48 alt=""
|
|
align=right>
|
|
|
|
<p>This tool is similar to the Paint Brush. Wherever you click
|
|
(or click and drag), the picture will be erased to white.</p>
|
|
|
|
<p>As you move the mouse around, a very large square outline follows
|
|
the pointer, showing what part of the picture will be erased to
|
|
white.</p>
|
|
|
|
<p>As you erase, a "squeaky clean" eraser/wiping sound is played.</p>
|
|
|
|
<br clear=all>
|
|
</dd>
|
|
</dl>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h3>Other Controls</h3>
|
|
<blockquote>
|
|
<dl>
|
|
<dt><b>Undo</b></dt>
|
|
<dd>
|
|
<img src="images/tool_undo.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>Clicking this tool will undo the last drawing action. You can
|
|
even undo more than once!</p>
|
|
|
|
<p>Note: You can also press <b>[Control]-[Z]</b> on the keyboard to
|
|
undo.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>Redo</b></dt>
|
|
<dd>
|
|
<img src="images/tool_redo.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>Clicking this tool will redo the drawing action you just "undid"
|
|
with the 'Undo' button.</p>
|
|
|
|
<p>As long as you don't draw again, you can redo as many times as you
|
|
had "undone!"</p>
|
|
|
|
<p>Note: You can also press <b>[Control]-[R]</b> on the keyboard to
|
|
redo.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>New</b></dt>
|
|
<dd>
|
|
<img src="images/tool_new.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>Clicking the "New" button will start a new drawing.
|
|
You will first be asked whether you really want to do this.</p>
|
|
|
|
<p>Note: You can also press <b>[Control]-[N]</b> on the keyboard to start
|
|
a new drawing.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>Open</b></dt>
|
|
<dd>
|
|
<img src="images/tool_open.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>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.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<center><img src="images/open_dialog.jpg" width=194 height=152
|
|
alt=""></center>
|
|
|
|
<p>Click a picture to select it, then...</p>
|
|
|
|
<blockquote>
|
|
<ul>
|
|
<li>
|
|
<img src="images/open_open.png" width=48 height=48 alt=""
|
|
align=right>
|
|
|
|
<p>Click the green "Open" button at the lower left of the list to
|
|
load the selected picture.</p>
|
|
|
|
<p>(Alternatively, you can double-click a picture's icon to load
|
|
it.)</p>
|
|
|
|
<br clear=all>
|
|
|
|
<li>
|
|
<img src="images/open_erase.png" width=48 height=48 alt=""
|
|
align=right>
|
|
|
|
<p>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.)</p>
|
|
|
|
<br clear=all>
|
|
|
|
<li>
|
|
<img src="images/open_back.png" width=48 height=48 alt=""
|
|
align=right>
|
|
|
|
<p>Or click the red "Back" arrow button at the lower right of the
|
|
list to cancel and return to the picture you were drawing.</p>
|
|
|
|
<br clear=all>
|
|
</ul>
|
|
</blockquote>
|
|
|
|
<p>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 "<a href="#save">Save</a>," below.)</p>
|
|
|
|
<p>Note: You can also press <b>[Control]-[O]</b> on the keyboard to get
|
|
the 'Open' dialog.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b><a name="save">Save</a></b></dt>
|
|
<dd>
|
|
<img src="images/tool_save.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>This saves your current picture.</p>
|
|
|
|
<p>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)</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<p>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).</p>
|
|
|
|
<center><img src="images/saveover.png" width=177 height=110
|
|
alt=""></center>
|
|
|
|
<p>(NOTE: If either the "<code>saveover</code>" or
|
|
"<code>saveovernew</code>" options are set, it won't ask before saving
|
|
over. See the "<a href="#options"><i>Options</i></a>"
|
|
section of this document, above.)</p>
|
|
|
|
<p>Note: You can also press <b>[Control]-[S]</b> on the keyboard to
|
|
save.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>Print</b></dt>
|
|
<dd>
|
|
<img src="images/tool_print.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>Click this button and your picture will be printed!</p>
|
|
|
|
<dl>
|
|
<dt>Disabling Printing</dt>
|
|
<dd>
|
|
<p>If the "noprint" option was set (either with
|
|
"<code>noprint=yes</code>" in Tux Paint's configuration file,
|
|
or using "<code>--noprint</code>" on the
|
|
command-line), the "Print" button will be disabled.</p>
|
|
|
|
<p>See the "<a href="#options"><i>Options</i></a>"
|
|
section of this document, above.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>Restricting Printing</dt>
|
|
<dd>
|
|
<p>If the "printdelay" option was used (either with
|
|
"<code>printdelay=<i>SECONDS</i></code>" in the configuration file,
|
|
or using "<code>--printdelay=<i>SECONDS</i></code>" on the
|
|
command-line), you can only print once every <i>SECONDS</i>
|
|
seconds.</p>
|
|
|
|
<p>For example, with "<code>printdelay=60</code>", you can print only
|
|
once a minute.</p>
|
|
|
|
<p>See the "<a href="#options"><i>Options</i></a>"
|
|
section of this document, above.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>Printing Command</dt>
|
|
<dd>
|
|
<p><i>(Linux and Unix only)</i></p>
|
|
|
|
<p>The command used to print is actually a set of commands that
|
|
convert a PNG to a PostScript and send it to the printer:</p>
|
|
|
|
<blockquote><code>
|
|
pngtopnm | pnmtops | lpr
|
|
</code></blockquote>
|
|
|
|
<p>This command can be changed by setting the "printcommand" value
|
|
in Tux Paint's configuration file.</p>
|
|
|
|
<p>See the "<a href="#options"><i>Options</i></a>"
|
|
section of this document, above.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>Printer Settings</dt>
|
|
<dd>
|
|
<p><i>(Windows only)</i></p>
|
|
|
|
<p>By default, Tux Paint simply prints to the default
|
|
printer with default settings when the 'Print' button is
|
|
pushed.</p>
|
|
|
|
<p>However, if you hold the <b>[ALT]</b> key on the keyboard
|
|
while pushing the button, as long as you're not in fullscreen mode,
|
|
a Windows print dialog will appear, where you can change the
|
|
settings.</p>
|
|
|
|
<p>You can have the printer configuration changes stored
|
|
by using the "printcfg" option, either by using
|
|
"<code>--printcfg</code>" on the command-line, or
|
|
"<code>printcfg=yes</code>" in Tux Paint's own configuration
|
|
file ("<code>tuxpaint.cfg</code>").</p>
|
|
|
|
<p>If the "printcfg" option is used, printer settings will
|
|
be loaded from the file "<code>userdata/print.cfg</code>".
|
|
Any changes will be saved there as well.</p>
|
|
|
|
<p>See the "<a href="#options"><i>Options</i></a>"
|
|
section of this document, above.</p>
|
|
</dd>
|
|
|
|
</dl>
|
|
<br clear=all>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
|
|
<dt><b>Quit</b></dt>
|
|
<dd>
|
|
<img src="images/tool_quit.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>Clicking the "Quit" button, closing the Tux Paint window, or
|
|
pushing the "Escape" key will quit Tux Paint.</p>
|
|
|
|
<p>(NOTE: The "Quit" button can be disabled (e.g., with the
|
|
"<code>--noquit</code>" command-line option), but the <b>[Escape]</b>
|
|
key will still work. See the "<a href="#options"><i>Options</i></a>"
|
|
section of this document, above.)</p>
|
|
|
|
<p>You will first be prompted as to whether you really want to quit.</p>
|
|
|
|
<p>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 "<a href="#save">Save</a>" above.)</p>
|
|
|
|
<p>NOTE: If the image is saved, it will be reloaded automatically
|
|
the next time you run Tux Paint!</p>
|
|
|
|
<br clear=all>
|
|
</dd>
|
|
</dl>
|
|
</blockquote>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1>Loading Other Pictures into Tux Paint</h1>
|
|
<blockquote>
|
|
<p>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?</p>
|
|
|
|
<p>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. ("<code>~/.tuxpaint/saved/</code>" under Linux and Unix,
|
|
"<code>userdata\saved\</code>" under Windows,
|
|
"<code>Library/Preferences/tuxpaint/saved/</code>" under Mac OS X.)
|
|
</p>
|
|
|
|
|
|
<h2>Using '<code>tuxpaint-import</code>'</h2>
|
|
<blockquote>
|
|
<p>Linux and Unix users can use the "<code><b>tuxpaint-import</b></code>"
|
|
shell script which gets installed when you install Tux Paint.
|
|
It uses some NetPBM tools to convert the image ("<code>anytopnm</code>"),
|
|
resize it so that it will fit in Tux Paint's canvas
|
|
("<code>pnmscale</code>"), and convert it to a PNG
|
|
("<code>pnmtopng</code>").</p>
|
|
|
|
<p>It also uses the "<code>date</code>" 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!)</p>
|
|
|
|
<p>To use '<code>tuxpaint-import</code>', simply run the command from a
|
|
command-line prompt and provide it the name(s) of the file(s) you wish
|
|
to convert.</p>
|
|
|
|
<p>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.)</p>
|
|
|
|
<p>Example:</p>
|
|
|
|
<blockquote><code>
|
|
$ <b>tuxpaint-import grandma.jpg</b><br>
|
|
grandma.jpg -> /home/username/.tuxpaint/saved/20020921123456.png<br>
|
|
jpegtopnm: WRITING A PPM FILE
|
|
</code></blockquote>
|
|
|
|
<p>The first line ("<code>tuxpaint-import grandma.jpg</code>") is the
|
|
command to run. The following two lines are output from the program while
|
|
it's working.</p>
|
|
|
|
<p>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!</p>
|
|
</blockquote>
|
|
|
|
|
|
<h2>Doing it Manually</h2>
|
|
<blockquote>
|
|
<p>Windows, Mac OS X and BeOS users must currently do the conversion
|
|
manually.</p>
|
|
|
|
<p>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.)</p>
|
|
|
|
<p>Reduce the size of the image to no wider than 448 pixels across and
|
|
no taller than 376 pixels tall. (i.e., the maximum size
|
|
is 448 x 376 pixels)</p>
|
|
|
|
<p>Save the picture in PNG format. It is <b>highly</b> recommended that you
|
|
name the filename using the current date and time, since that's
|
|
the convention Tux Paint uses:</p>
|
|
|
|
<blockquote>
|
|
<code><b>YYYYMMDDhhmmss</b>.png</code>
|
|
</blockquote>
|
|
|
|
<ul>
|
|
<li>YYYY = Year
|
|
<li>MM = Month (01-12)
|
|
<li>DD = Day (01-31)
|
|
<li>HH = Hour, in 24-hour format (00-23)
|
|
<li>mm = Minute (00-59)
|
|
<li>ss = Second (00-59)
|
|
</ul>
|
|
|
|
<p>e.g.:</p>
|
|
|
|
<blockquote>
|
|
<code>20020921130500</code> - for September 21, 2002, 1:05:00pm
|
|
</blockquote>
|
|
|
|
<p>Place this PNG file in your Tux Paint '<code>saved</code>'
|
|
directory. (See above.)</p>
|
|
|
|
<p>Under Windows, this is in the "<code>userdata</code>" folder.
|
|
Under Mac OS X, this is in "<code>Library/Preferences/tuxpaint/</code>"
|
|
in your home directory.</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1>Extending Tux Paint</h1>
|
|
<blockquote>
|
|
<p>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.</p>
|
|
|
|
<p>Note: You'll need to restart Tux Paint for the changes to take
|
|
effect.</p>
|
|
|
|
<h2>Where Files Go</h2>
|
|
<blockquote>
|
|
<h3>Standard Files</h3>
|
|
<blockquote>
|
|
<p>Tux Paint looks for its various data files in its
|
|
'data' directory.</p>
|
|
|
|
<h4>Linux and Unix</h4>
|
|
<blockquote>
|
|
<p>Where this directory goes depends on what value was set for
|
|
"<code>DATA_PREFIX</code>" when Tux Paint was built. See
|
|
INSTALL.txt for details.</p>
|
|
|
|
<p>By default, though, the directory is:</p>
|
|
|
|
<blockquote><code>
|
|
/usr/local/share/tuxpaint/
|
|
</code></blockquote>
|
|
|
|
<p>If you installed from a package, it is more likely to be:</p>
|
|
|
|
<blockquote><code>
|
|
/usr/share/tuxpaint/
|
|
</code></blockquote>
|
|
|
|
</blockquote>
|
|
|
|
|
|
<h4>Windows</h4>
|
|
<blockquote>
|
|
<p>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.:</p>
|
|
|
|
<blockquote><code>
|
|
C:\Program Files\TuxPaint\data
|
|
</code></blockquote>
|
|
|
|
</blockquote>
|
|
|
|
|
|
<h4>Mac OS X</h4>
|
|
<blockquote>
|
|
<p>Tux Paint stores files in your account's
|
|
"Libraries" folder, under "Preferences", e.g.:</p>
|
|
|
|
<blockquote><code>
|
|
/Users/Joe/Library/Preferences/
|
|
</code></blockquote>
|
|
|
|
</blockquote>
|
|
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h3>Personal Files</h3>
|
|
<blockquote>
|
|
<p>You can also create brushes, stamps and fonts in your own directory
|
|
for Tux Paint to find.</p>
|
|
|
|
<h4>Linux and Unix</h4>
|
|
<blockquote>
|
|
<p>Your personal Tux Paint directory is
|
|
"<code>~/.tuxpaint/</code>".</p>
|
|
|
|
<p>That is, if your home directory is "<code>/home/karl</code>", then
|
|
your Tux Paint directory is
|
|
"<code>/home/karl/.tuxpaint/</code>".</p>
|
|
|
|
<p>Don't forget the period ("<code>.</code>") before the
|
|
'<code>tuxpaint</code>'!</p>
|
|
</blockquote>
|
|
|
|
|
|
<h4>Windows</h4>
|
|
<blockquote>
|
|
<p>Your personal Tux Paint directory is named "userdata" and
|
|
is in the same directory as the executable e.g.:</p>
|
|
|
|
<blockquote><code>
|
|
C:\Program Files\TuxPaint\userdata
|
|
</code></blockquote>
|
|
|
|
</blockquote>
|
|
|
|
|
|
<p>To add brushes, stamps and fonts, create subdirectories under
|
|
your personal Tux Paint directory named
|
|
"<code><b>brushes</b></code>", "<code><b>stamps</b></code>" and
|
|
"<code><b>fonts</b></code>", respectively.</p>
|
|
|
|
<p>(For example, if you created a brush named "<code>flower.png</code>",
|
|
you would put it in "<code>~/.tuxpaint/brushes/</code>" under Linux or
|
|
Unix.)</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h2>Brushes</h2>
|
|
<blockquote>
|
|
<p>The brushes used for drawing with the 'Brush' and 'Lines' tools in
|
|
Tux Paint are simply greyscale PNG images.</p>
|
|
|
|
<img src="images/brush_edit.png" width=123 height=147 alt="" align=right>
|
|
|
|
<p>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!</p>
|
|
|
|
<p>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.)</p>
|
|
|
|
<p>Just place them in the "<code><b>brushes</b></code>" directory.</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<br clear=all>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h2>Stamps</h2>
|
|
<blockquote>
|
|
<p>All stamp-related files go in the "<code><b>stamps</b></code>" directory.
|
|
It's useful to create subdirectories and sub-subdirectories
|
|
there to organize the stamps. (For example, you can have a
|
|
"<code>holidays</code>" folder with "<code>halloween</code>" and
|
|
"<code>christmas</code>" sub-folders.)</p>
|
|
|
|
<h3>Images</h3>
|
|
<blockquote>
|
|
<p>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.</p>
|
|
|
|
<img src="images/stamp_edit.png" width=128 height=147 alt="" align=right>
|
|
|
|
<p>The Stamps used by Tux Paint are PNG pictures. They can be
|
|
full-color or greyscale. The alpha (transparency) of the PNG is
|
|
used to determine the actual shape of the picture (otherwise you'll
|
|
stamp a large rectangle on your drawings).</p>
|
|
|
|
<p>The PNGs can be any size, but in practice, a 100 pixels wide by
|
|
100 pixels tall (100 x 100) is quite large for
|
|
Tux Paint.</p>
|
|
|
|
<p>Note: If your new 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.</p>
|
|
|
|
<br clear=all>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
<h3>Description Text</h3>
|
|
<blockquote>
|
|
<p>Text (".TXT") files with the same name as the PNG.
|
|
(e.g., "<code>picture.png</code>"'s description is stored in
|
|
"<code>picture.txt</code>" in the same directory.)</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<h4>Language Support</h4>
|
|
<blockquote>
|
|
<p>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).</p>
|
|
|
|
<p>The beginning of the line should correspond to the language code
|
|
of the language in question (e.g., "<code>fr</code>" for French, and
|
|
"<code>zh_tw</code>" for Traditional Chinese), followed by
|
|
"<code>.utf8=</code>" and the translated description (encoded
|
|
in UTF-8).</p>
|
|
|
|
<p>There are scripts in the "<code>po</code>" 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.</p>
|
|
|
|
<p>If no translation is available for the language Tux Paint
|
|
is currently running in, the US English text is used.</p>
|
|
</blockquote>
|
|
|
|
<h4>Windows Users</h4>
|
|
<blockquote>
|
|
<p>Use NotePad or WordPad to edit/create these files.
|
|
Be sure to save them as Plain Text, and make sure they have
|
|
"<code>.txt</code>" at the end of the filename...</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
<h3>Sound Effects</h3>
|
|
<blockquote>
|
|
<p>WAVE (".WAV") files with the same name as the PNG.
|
|
(e.g., "<code>picture.png</code>"'s sound effect is the sound
|
|
"<code>picture.wav</code>" in the same directory.)</p>
|
|
|
|
<h4>Language Support</h4>
|
|
<blockquote>
|
|
<p>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 files with the locale's label in the filename, in
|
|
the form: "<code><b>STAMP_LOCALE</b>.wav</code>"</p>
|
|
|
|
<p>"<code>picture.png</code>"'s sound effect, when Tux Paint is run
|
|
in Spanish mode, would be "<code>picture_es.wav</code>".
|
|
In French mode, "<code>picture_fr.wav</code>". And so on...</p>
|
|
|
|
<p>If no localized sound effect can be loaded, Tux Paint will
|
|
attempt to load the 'default' sound file.
|
|
(e.g., "<code>picture.wav</code>")</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
<h3>Stamp Options</h3>
|
|
<blockquote>
|
|
<p>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.</p>
|
|
|
|
<p>A stamp data file is simply a text file containing the options.</p>
|
|
|
|
<p>The file has the same name as the PNG image, but a "<code>.dat</code>"
|
|
extension. (e.g., "<code>picture.png</code>"'s data file is the text
|
|
file "<code>picture.dat</code>" in the same directory.)</p>
|
|
|
|
<h4>Colored Stamps</h4>
|
|
<blockquote>
|
|
<p>Stamps can be made to be either "colorable" or "tintable."</p>
|
|
|
|
<h5>Colorable</h5>
|
|
<blockquote>
|
|
<p>"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.)</p>
|
|
|
|
<p>Nothing about the original image is used except the transparency
|
|
("alpha" channel). The color of the stamp comes out solid.</p>
|
|
|
|
<center><img src="images/ex_colorable.png" width=74 height=92
|
|
alt=""></center>
|
|
|
|
<p>Add the word "<code><b>colorable</b></code>" to the stamp's data
|
|
file.</p>
|
|
</blockquote>
|
|
|
|
<h5>Tinted</h5>
|
|
<blockquote>
|
|
<p>"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.)</p>
|
|
|
|
<center><img src="images/ex_tintable.png" width=151 height=78
|
|
alt=""></center>
|
|
|
|
<p>Add the word "<code><b>tintable</b></code>" to the stamp's data
|
|
file.</p>
|
|
|
|
<p>Sometimes you don't want the white or gray parts of an image
|
|
tinted (see for example the dry erase marker stamp in the default
|
|
stamp package). You can add the word "<code><b>notintgray</b></code>"
|
|
to the stamp's data file to accomplish this. Only areas with saturation
|
|
over 25 % are then tinted.</p>
|
|
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<h4>Unalterable Stamps</h4>
|
|
<blockquote>
|
|
<p>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.</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<p>To make a stamp un-flippable, add the option
|
|
"<code><b>noflip</b></code>" to the stamp's data file.</p>
|
|
|
|
<p>To keep a stamp from being mirrored, add the option
|
|
"<code><b>nomirror</b></code>" to the stamp's data file.</p>
|
|
</blockquote>
|
|
|
|
|
|
<h4>Windows Users</h4>
|
|
<blockquote>
|
|
<p>You can use NotePad or WordPad to create these file.
|
|
Be sure to save it as Plain Text, and make sure the filename
|
|
has "<code>.dat</code>" at the end, and not "<code>.txt</code>"...</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<h3>Pre-Mirrored Images</h3>
|
|
<blockquote>
|
|
<p>In some cases, you may wish to provide a pre-drawn version of
|
|
a stamp's mirror-image. For example, imagine a picture of a fire
|
|
truck with the words "<i>Fire Department</i>" written across
|
|
the side. You probably do not want that text to appear backwards
|
|
when the image is flipped!</p>
|
|
|
|
<p>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
|
|
"<code>.png</code>" graphics file with the same name, except with
|
|
the string "<code><b>_mirror</b></code>" before the filename
|
|
extension.</p>
|
|
|
|
<p>For example, for the stamp "<code><b>truck.png</b></code>" you would
|
|
create another file named "<code><b>truck_mirror.png</b></code>", which
|
|
will be used when the stamp is mirrored (rather than using a
|
|
backwards version of '<code>truck.png</code>').</p>
|
|
</blockquote>
|
|
|
|
</blockquote>
|
|
|
|
<hr size=1 noshade>
|
|
|
|
|
|
<h2>Fonts</h2>
|
|
<blockquote>
|
|
<img src="images/fontsizes.png" width=48 height=48 alt="" align=right>
|
|
|
|
<p>The fonts used by Tux Paint are TrueType Fonts (TTF).</p>
|
|
|
|
<p>Simply place them in the "<code><b>fonts</b></code>" directory.
|
|
Tux Paint will load the font and provide four different sizes
|
|
in the 'Letters' selector when using the 'Text' tool.</p>
|
|
|
|
<br clear=all>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1>More Information</h1>
|
|
<blockquote>
|
|
<p>For more information, see the other documentation files that come
|
|
with Tux Paint.</p>
|
|
|
|
<p>If you need help, feel free to contact New Breed Software:</p>
|
|
|
|
<blockquote>
|
|
<a href="http://www.newbreedsoftware.com/">http://www.newbreedsoftware.com/</a>
|
|
</blockquote>
|
|
|
|
<p>You may also wish to participate in the numerous Tux Paint mailing
|
|
lists:</p>
|
|
|
|
<blockquote>
|
|
<a href="http://www.newbreedsoftware.com/tuxpaint/lists/">http://www.newbreedsoftware.com/tuxpaint/lists/</a>
|
|
</blockquote>
|
|
|
|
</blockquote>
|
|
|
|
</body></html>
|
|
|