1153 lines
39 KiB
HTML
1153 lines
39 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.21
|
|
|
|
</h1>
|
|
<h3>A simple drawing program for children</h3>
|
|
|
|
<p>Copyright 2002-2009 by Bill Kendrick and others<br>
|
|
<a href="http://www.newbreedsoftware.com/">New Breed Software &
|
|
<a href="http://tux4kids.alioth.debian.org/">Tux4Kids</a></p>
|
|
|
|
<p><a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a><br>
|
|
<a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a></p>
|
|
|
|
<p>June 14, 2002 -
|
|
|
|
April 28, 2009</p>
|
|
|
|
</center>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
<table border=2 cellspacing=0 cellpadding=2>
|
|
<tr><th>Table of Contents</th></tr>
|
|
<tr><td>
|
|
<ul>
|
|
<li><a href="#about">About</a>
|
|
<li><a href="#using">Using Tux Paint</a>
|
|
<li><a href="#loading_into">Loading Other Pictures into Tux Paint</a>
|
|
<li><a href="#further">Further Reading</a>
|
|
<li><a href="#help">How to Get Help</a>
|
|
</ul>
|
|
</td></tr>
|
|
</table>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
<h1><a name="about">About</a></h1>
|
|
<blockquote>
|
|
|
|
<h2>What Is 'Tux Paint?'</h2>
|
|
<blockquote>
|
|
<p>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.</p>
|
|
</blockquote>
|
|
|
|
<h2>License:</h2>
|
|
<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 <a href="../COPYING.txt">COPYING.txt</a> for the full text of
|
|
the GPL license.</p>
|
|
</blockquote>
|
|
|
|
<h2>Objectives:</h2>
|
|
<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>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1><a name="using">Using Tux Paint</a></h1>
|
|
<blockquote>
|
|
|
|
<h2>Loading Tux Paint</h2>
|
|
<blockquote>
|
|
<h3>Linux/Unix Users</h3>
|
|
<blockquote>
|
|
<p>Tux Paint should have placed a laucher icon in your KDE and/or GNOME
|
|
menus, under 'Graphics.'</p>
|
|
|
|
<p>Alternatively, you can run the following command at a shell prompt
|
|
(e.g., "$"):</p>
|
|
|
|
<blockquote>
|
|
<code>$ tuxpaint</code>
|
|
</blockquote>
|
|
|
|
<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>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.</p>
|
|
|
|
<p>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
|
|
"<code>tuxpaint.exe</code>" icon in the 'Tux Paint' folder on
|
|
your computer.</p>
|
|
|
|
<p>By default, the 'Tux Paint Installer' will put
|
|
Tux Paint's folder in "<code>C:\Program Files\</code>",
|
|
though you may have changed this when the installer ran.</p>
|
|
|
|
<p>If you used the 'ZIP-file' download, Tux Paint's folder will
|
|
be wherever you put it when you unzipped the ZIP file.</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>Title Screen</h2>
|
|
<blockquote>
|
|
<p>When Tux Paint first loads, a title/credits screen will appear.</p>
|
|
|
|
<p align=center><img src="images/tuxpaint-title.jpg" width=324 height=254
|
|
alt="[Title Screenshot]"></p>
|
|
|
|
<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>
|
|
|
|
<p align=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]"></p>
|
|
</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>
|
|
|
|
<p align=center><img src="images/canvas.jpg" width=324 height=254
|
|
alt="[(Canvas)]"></p>
|
|
|
|
<p><b>Note:</b> The size of the drawing canvas depends on the size
|
|
of Tux Paint. You can change the size of Tux Paint using
|
|
the <i>Tux Paint Config.</i> configuration tool, or
|
|
by other means. See the <a href="OPTIONS.html">OPTIONS</a> documentation
|
|
for more details.</p>
|
|
</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>
|
|
|
|
<p align=center><img src="images/selector.jpg" width=324 height=254
|
|
alt="[Selectors - Brushes, Letters, Shapes, Stamps]"></p>
|
|
</dd>
|
|
|
|
|
|
<dt>Lower: Colors</dt>
|
|
<dd>
|
|
<p>A palette of available colors are shown near the bottom of the
|
|
screen.</p>
|
|
|
|
<p align=center><img src="images/colors.jpg" width=324 height=254
|
|
alt="[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan,
|
|
Blue, Purple, Brown, Grey]"></p>
|
|
|
|
<p>(NOTE: You can define your own colors for Tux Paint.
|
|
See the "<a href="OPTIONS.html"><i>Options</i></a>"
|
|
documentation.)</p>
|
|
</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>
|
|
|
|
<p align=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.)"></p>
|
|
</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>
|
|
|
|
<p align=center><img src="images/ex_paint.png" width=120 height=95
|
|
alt=""></p>
|
|
|
|
<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 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.</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<p align=center><img src="images/ex_stamps.png" width=182 height=156
|
|
alt=""></p>
|
|
|
|
<img src="images/tool_stamp_categories.png" width=96 height=48 alt=""
|
|
align=right>
|
|
<p>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.</p>
|
|
|
|
<p>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.</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 align=center>
|
|
<img src="images/tool_stamp_controls.png" width=96 height=96 alt="">
|
|
</p>
|
|
|
|
<img src="images/tool_sfx.png" width=48 height=24 alt="" align=right>
|
|
<p>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.</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.html"><i>Options</i></a>"
|
|
documentation.)</p>
|
|
|
|
<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>
|
|
|
|
<p align=center><img src="images/ex_lines.png" width=76 height=103
|
|
alt=""></p>
|
|
|
|
<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>
|
|
|
|
<p align=center><img src="images/ex_shapes.png" width=177 height=104
|
|
alt=""></p>
|
|
|
|
<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>Alternatively, press <b>[Tab]</b> 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:
|
|
<code>Like</code> <font color="#880000"><i><b>this</b></i></font>.)</p>
|
|
|
|
<p>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).</p>
|
|
|
|
<p align=center><img src="images/ex_text.png" width=139 height=69
|
|
alt=""></p>
|
|
|
|
<dl>
|
|
<dt><b>International Character Input</b></dt>
|
|
<dd>
|
|
<p>Tux Paint allows inputting characters in different languages.
|
|
Most Latin characters (<i>A</i>-<i>Z</i>,
|
|
<i>ñ</i>, <i>è</i>, 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.</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<p>Currently supported locales, the input methods available, and
|
|
the key to toggle or cycle modes, are listed below.
|
|
<b>Note:</b> 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.
|
|
<ul>
|
|
<li>Japanese — Romanized Hiragana and Romanized Katakana
|
|
— <b>right [Alt]</b>
|
|
<li>Korean — Hangul 2-Bul
|
|
— <b>right [Alt]</b> or <b>left [Alt]</b>
|
|
<li>Traditional Chinese
|
|
— <b>right [Alt]</b> or <b>left [Alt]</b>
|
|
<li>Thai
|
|
— <b>right [Alt]</b>
|
|
</ul>
|
|
</p>
|
|
</dl>
|
|
</dd>
|
|
|
|
<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. 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.</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<br clear=all>
|
|
|
|
<p>See the <a href="../magic-docs/html/index.html">instructions for each Magic tool</a> (in the 'magic-docs' folder).</p>
|
|
|
|
<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. (This may be
|
|
white, some other color, or to a background picture, depending on
|
|
the picture.)</p>
|
|
|
|
<p>A number of eraser sizes are available, both round and square..</p>
|
|
|
|
<p>As you move the mouse around, a 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.
|
|
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.</p>
|
|
|
|
<p>Note: You can also press <b>[Control]-[N]</b> on the keyboard to
|
|
start a new drawing.</p>
|
|
|
|
<b>'Starter' Images</b>
|
|
|
|
<blockquote>
|
|
<p>'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.</p>
|
|
|
|
<p>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).</p>
|
|
</blockquote>
|
|
|
|
<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>
|
|
|
|
<p align=center><img src="images/open_dialog.jpg" width=194 height=152
|
|
alt=""></p>
|
|
|
|
<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_slides.png" width=48 height=48 alt=""
|
|
align=right>
|
|
|
|
<p>Click the blue "Slides" (slide projector) button at the lower
|
|
left to go to slideshow mode. See "<a href="#slides">Slides</a>",
|
|
below, for details.</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>
|
|
|
|
<p align=center><img src="images/saveover.png" width=177 height=110
|
|
alt=""></p>
|
|
|
|
<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.html"><i>Options</i></a>"
|
|
documentation.)</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>
|
|
|
|
<p>On most platforms, you can also hold the <b>[Alt]</b> key
|
|
(called <b>[Option]</b> 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.</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.html"><i>Options</i></a>"
|
|
documentation.)</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.html"><i>Options</i></a>"
|
|
documentation.)</p>
|
|
</dd>
|
|
|
|
|
|
<dt>Printing Commands</dt>
|
|
<dd>
|
|
<p><i>(Linux and Unix only)</i></p>
|
|
|
|
<p><i>Tux Paint</i> prints by generating a PostScript
|
|
representation of the drawing and sending it to an external
|
|
program. By default, the program is:</p>
|
|
|
|
<blockquote><code>
|
|
lpr
|
|
</code></blockquote>
|
|
|
|
<p>This command can be changed by setting the "printcommand" value
|
|
in Tux Paint's configuration file.</p>
|
|
|
|
<p>If the <b>[Alt]</b> 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:</p>
|
|
|
|
<blockquote><code>
|
|
kprinter
|
|
</code></blockquote>
|
|
|
|
<p>This command can be changed by setting the "altprintcommand" value
|
|
in Tux Paint's configuration file.</p>
|
|
|
|
<p>For information on how to change the printing commands,
|
|
see the "<a href="OPTIONS.html"><i>Options</i></a>"
|
|
documentation.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>Printer Settings</dt>
|
|
<dd>
|
|
<p><i>(Windows and Mac OS X)</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> (or <b>[Option]</b>) 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.</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>print.cfg</code>" in your
|
|
personal folder (see below).
|
|
Any changes will be saved there as well.</p>
|
|
|
|
<p>See the "<a href="OPTIONS.html"><i>Options</i></a>"
|
|
documentation.)</p>
|
|
</dd>
|
|
|
|
<dt>Printer Dialog Options</dt>
|
|
<dd>
|
|
<p>By default, Tux Paint only shows the printer dialog
|
|
(or, on Linux/Unix, runs the "altprintcommand", e.g.,
|
|
"kprinter" instead of "lpr") if the <b>[Alt]</b>
|
|
(or <b>[Option]</b>) key is held while clicking the 'Print'
|
|
button.</p>
|
|
|
|
<p>However, this behavior can be changed. You can have the
|
|
printer dialog always appear by using
|
|
"<code>--altprintalways</code>" on the command-line, or
|
|
"<code>altprint=always</code>" in Tux Paint's configuration
|
|
file. Or, you can prevent the <b>[Alt]</b>/<b>[Option]</b>
|
|
key from having any effect by using "<code>--altprintnever</code>", or
|
|
"<code>altprint=never</code>".</p>
|
|
|
|
<p>See the "<a href="OPTIONS.html"><i>Options</i></a>"
|
|
documentation.)</p>
|
|
</dd>
|
|
|
|
</dl>
|
|
<br clear=all>
|
|
|
|
<hr size=1>
|
|
</dd>
|
|
|
|
<dt><a name="slides"><b>Slides</b> (under "Open")</a></dt>
|
|
<dd>
|
|
<img src="images/open_slides.png" width=48 height=48 alt=""
|
|
align=right>
|
|
|
|
<p>The "Slides" button is available in the "Open" dialog.
|
|
It displays a list of your saved files, just like the "Open" dialog.</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<p>You can click a selected image to unselect it (take it out of your
|
|
slideshow).</p>
|
|
|
|
<p>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).</p>
|
|
|
|
<p><b>Note:</b> The slowest setting does not automatically advance
|
|
through the slides. Use it for when you want to step through them
|
|
manually.</p>
|
|
|
|
<p>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.)</p>
|
|
|
|
<p>During the slideshow, press <b>[Space]</b>, <b>[Enter]</b> or
|
|
<b>[Return]</b> or the <b>[Right Arrow]</b>, or click the "Next"
|
|
button at the lower left, to manually advance to the next slide.
|
|
Press <b>[Left]</b> to go back to the previous slide.</p>
|
|
|
|
<p>Press <b>[Escape]</b>, or click the "Back" button at the
|
|
lower right, to exit the slideshow and return to the slideshow
|
|
image selection screen.</p>
|
|
|
|
<p>Click "Back" in the slideshow image selection screen to return to
|
|
the "Open" dialog.</p>
|
|
|
|
<br clear=all>
|
|
</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 <b>[Escape]</b> key will quit Tux Paint.</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>
|
|
|
|
<p><b>NOTE:</b> The "Quit" button and <b>[Escape]</b> key can be
|
|
disabled (e.g., by selecting "Disable 'Quit' Button" in
|
|
<i>Tux Paint Config.</i> or running <i>Tux Paint</i>
|
|
with the "<code>--noquit</code>" command-line option).</p>
|
|
|
|
<p>In that case, the "window close" button on
|
|
<i>Tux Paint's</i> title bar (if not in fullscreen mode) or
|
|
the <b>[Alt]</b> + <b>[F4]</b> key sequence may be used
|
|
to quit.</p>
|
|
|
|
<p>If neither of those are possible, the key sequence of
|
|
<b>[Shift]</b> + <b>[Control]</b> + <b>[Escape]</b>
|
|
may be used to quit. (See the
|
|
"<a href="OPTIONS.html"><i>Options</i></a>" documentation.)</p>
|
|
|
|
<br clear=all>
|
|
</dd>
|
|
|
|
<dt><b>Sound Muting</b></dt>
|
|
<dd>
|
|
<p>There is no on-screen control button at this time, but
|
|
by pressing <b>[Alt]</b> + <b>[S]</b>, sound effects
|
|
can be disabled and re-enabled (muted and unmuted) while the
|
|
program is running.</p>
|
|
|
|
<p>Note that if sounds are completely disabled
|
|
(e.g., by unselecting "Enable Sound Effects" in
|
|
<i>Tux Paint Config</i> or running <i>Tux Paint</i>
|
|
with the "<code>--nosound</code>" command-line option),
|
|
the <b>[Alt]</b> + <b>[S]</b> key sequence has no
|
|
effect. (i.e., it cannot be used to turn on sounds when the
|
|
parent/teacher wants them disabled.)</p>
|
|
</dl>
|
|
</blockquote>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1><a name="loading_into">Loading Other Pictures into Tux Paint</a></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:</p>
|
|
|
|
<dl>
|
|
<dt>Windows Vista</dt>
|
|
<dd>Inside the user's "<code>AppData</code>" folder,
|
|
e.g.: <code>"C:\Users\<i>(user name)</i>\AppData\Roaming\TuxPaint\saved\</code>"</dd>
|
|
|
|
<dt>Windows 95, 98, ME, 2000, XP</dt>
|
|
<dd>Inside the user's "<code>Application Data</code>" folder,
|
|
e.g.: <code>"C:\Documents and Settings\<i>(user name)</i>\Application
|
|
Data\TuxPaint\saved\</code>"</dd>
|
|
|
|
<dt>Mac OS X</dt>
|
|
<dd>Inside the user's "<code>Library</code>" folder:
|
|
<code>"/Users/<i>(user name)</i>/Library/Application Support/Tux Paint/saved/</code>"</dd>
|
|
|
|
<dt>Linux/Unix</dt>
|
|
<dd>Inside a hidden "<code>.tuxpaint</code>" directory, in the user's
|
|
home directory: "<code>$(HOME)/.tuxpaint/saved/</code>"</dd>
|
|
</dl>
|
|
|
|
<p><b>Note:</b> It is from this folder that you can copy or open pictures
|
|
drawn in Tux Paint using other applications.</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
|
|
"<a href="../PNG.txt">PNG.txt</a>" for a list of suggested software,
|
|
and other references.)</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<p>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. (<b>Note:</b> The default resolution is 800x600.)
|
|
See "Calculating Image Dimensions", below.</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>
|
|
|
|
<h3>Calculating Image Dimensions</h3>
|
|
<blockquote>
|
|
<p>The width of Tux Paint's canvas is simply the width of the
|
|
window (e.g., 640, 800 or 1024 pixels), minus 192.</p>
|
|
|
|
<p>Calculating the height of Tux Paint's canvas requires multiple
|
|
steps:
|
|
<ol>
|
|
<li>Take the height of the window (e.g, 480, 600 or 768 pixels) and
|
|
subtract 144
|
|
<li>Take the result of Step 1 and divide it by 48
|
|
<li>Take the result of Step 2 and round it down (e.g., 9.5 becomes
|
|
simply 9)
|
|
<li>Take the result of Step 3 and multiply it by 48
|
|
<li>Finally, take the result of Step 4 and add 40
|
|
</ol></p>
|
|
|
|
<p><b>Example:</b> Tux Paint running at fullscreen on a 1440x900
|
|
display.
|
|
<ul>
|
|
<li>The canvas width is simply 1440 - 192, or 1248.
|
|
<li>The canvas height is calculated as:
|
|
<ol>
|
|
<li>900 - 144, or 756
|
|
<li>756 / 48, or 15.75
|
|
<li>15.75 rounded down, or 15
|
|
<li>15 * 48, or 720
|
|
<li>720 + 40, or 760
|
|
</ol>
|
|
</ul>
|
|
So the canvas within a 1440x900 Tux Paint window is 1248x760.</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1><a name="further">Further Reading</a></h1>
|
|
<blockquote>
|
|
Other documentation included with Tux Paint (in the "<code>docs</code>"
|
|
folder/directory) include:
|
|
|
|
<ul>
|
|
<li><a href="../magic-docs/html/">"Magic" Tool Documentation
|
|
("magic-docs")</a><br>
|
|
Documentation for each of the currently-installed "Magic" tools.
|
|
|
|
<li><a href="../AUTHORS.txt">AUTHORS.txt</a><br>
|
|
List of authors and contributors.
|
|
|
|
<li><a href="../CHANGES.txt">CHANGES.txt</a><br>
|
|
Summary of changed between releases.
|
|
|
|
<li><a href="../COPYING.txt">COPYING.txt</a><br>
|
|
Copying license (The GNU General Public License).
|
|
|
|
<li><a href="../INSTALL.txt">INSTALL.txt</a><br>
|
|
Instructions for compiling/installing, when applicable.
|
|
|
|
<li><a href="EXTENDING.html">EXTENDING.html</a><br>
|
|
Detailed instructions on creating brushes, stamps and starters,
|
|
and adding fonts, to extend Tux Paint.
|
|
|
|
<li><a href="OPTIONS.html">OPTIONS.html</a><br>
|
|
Detailed instructions on command-line and configuration-file options,
|
|
for those who don't want to use Tux Paint Config.
|
|
|
|
<li><a href="../PNG.txt">PNG.txt</a><br>
|
|
Notes on creating PNG format bitmapped images for use in Tux Paint.
|
|
|
|
<li><a href="../SVG.txt">SVG.txt</a><br>
|
|
Notes on creating SVG format vector images for use in Tux Paint.
|
|
|
|
</ul>
|
|
</blockquote>
|
|
|
|
<hr size=2 noshade>
|
|
|
|
|
|
<h1><a name="help">How to Get Help</a></h1>
|
|
<blockquote>
|
|
<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.tuxpaint.org/lists/">http://www.tuxpaint.org/lists/</a>
|
|
</blockquote>
|
|
|
|
</blockquote>
|
|
|
|
</body></html>
|
|
|