2070 lines
64 KiB
HTML
2070 lines
64 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<meta name="generator"
|
|
content="HTML Tidy for HTML5 for Linux version 5.6.0">
|
|
<title>
|
|
Tux Paint README
|
|
</title>
|
|
<meta http-equiv="Content-Type"
|
|
content="text/html; charset=utf-8">
|
|
</head>
|
|
<body bgcolor="#FFFFFF"
|
|
text="#000000"
|
|
link="#0000FF"
|
|
vlink="#FF0000"
|
|
alink="#FF00FF">
|
|
<center>
|
|
<h1>
|
|
<img src="../../html/images/tuxpaint-title.png"
|
|
width="205"
|
|
height="210"
|
|
alt="Tux Paint"><br>
|
|
version 0.9.25
|
|
</h1>
|
|
|
|
<h3>
|
|
A simple drawing program for children
|
|
</h3>
|
|
|
|
<p>
|
|
Copyright 2002-2020 by various contributors; see
|
|
AUTHORS.txt<br>
|
|
<a href=
|
|
"http://www.tuxpaint.org/">http://www.tuxpaint.org/</a>
|
|
</p>
|
|
|
|
<p>
|
|
June 14, 2002 - July 27, 2020
|
|
</p>
|
|
</center>
|
|
|
|
<hr size="2"
|
|
noshade>
|
|
|
|
<table border="2"
|
|
cellspacing="0"
|
|
cellpadding="2"
|
|
summary="Table of Contents">
|
|
<tr>
|
|
<th>
|
|
Table of Contents
|
|
</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>
|
|
<ul>
|
|
<li>
|
|
<a href="#about">About</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="#using">Using Tux Paint</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="#loading_into">Loading Other Pictures into
|
|
Tux Paint</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="#further">Further Reading</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="#help">How to Get Help</a>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<hr size="2"
|
|
noshade>
|
|
|
|
<h1>
|
|
<a name="about"
|
|
id="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"
|
|
id="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="../../html/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>
|
|
macOS Users
|
|
</h3>
|
|
|
|
<blockquote>
|
|
<p>
|
|
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="../../html/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>
|
|
<!-- FIXME: Update screenshot to add "Fill" tool -->
|
|
|
|
<p align="center">
|
|
<img src="../../html/images/tools.jpg"
|
|
width="324"
|
|
height="254"
|
|
alt=
|
|
"[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, 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="../../html/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="../../html/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="../../html/images/colors.jpg"
|
|
width="324"
|
|
height="254"
|
|
alt=
|
|
"[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, Purple, Brown, Grey]">
|
|
</p>
|
|
|
|
<p>
|
|
On the far right are two special color options, the
|
|
"color picker", which has an outline of an
|
|
eye-dropper, and allows you to pick a color found
|
|
within your drawing, and the rainbow palette, which
|
|
allows you to pick a color from within a box
|
|
containing thousands of colors.
|
|
</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="../../html/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="../../html/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="../../html/images/ex_paint.png"
|
|
width="120"
|
|
height="95"
|
|
alt="">
|
|
</p>
|
|
|
|
<hr size="1">
|
|
</dd>
|
|
|
|
<dt>
|
|
<b>Stamp (Rubber Stamp)</b>
|
|
</dt>
|
|
|
|
<dd>
|
|
<img src="../../html/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="../../html/images/ex_stamps.png"
|
|
width="182"
|
|
height="156"
|
|
alt="">
|
|
</p>
|
|
<img src=
|
|
"../../html/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>
|
|
Prior to 'stamping' an image onto your drawing,
|
|
various effects can sometimes be applied (depending
|
|
on the stamp):
|
|
</p>
|
|
|
|
<ul>
|
|
<li>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.
|
|
</li>
|
|
|
|
<li>Stamps can be shrunk and expanded, by clicking
|
|
within the triangular-shaped series of bars at the
|
|
bottom right; the larger the bar, the larger the
|
|
stamp will appear in your picture.
|
|
</li>
|
|
|
|
<li>Many stamps may be flipped vertically, or
|
|
displayed as a mirror-image, using the control
|
|
buttons at the bottom right.
|
|
</li>
|
|
</ul>
|
|
|
|
<p align="center">
|
|
<img src=
|
|
"../../html/images/tool_stamp_controls.png"
|
|
width="96"
|
|
height="96"
|
|
alt="">
|
|
</p>
|
|
<img src="../../html/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="../../html/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="../../html/images/ex_lines.png"
|
|
width="76"
|
|
height="103"
|
|
alt="">
|
|
</p>
|
|
|
|
<hr size="1">
|
|
</dd>
|
|
|
|
<dt>
|
|
<b>Shapes</b>
|
|
</dt>
|
|
|
|
<dd>
|
|
<img src="../../html/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="../../html/images/ex_shapes.png"
|
|
width="177"
|
|
height="104"
|
|
alt="">
|
|
</p>
|
|
|
|
<hr size="1">
|
|
</dd>
|
|
|
|
<dt>
|
|
<b>Text</b> and <b>Label</b>
|
|
</dt>
|
|
|
|
<dd>
|
|
<img src="../../html/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="../../html/images/ex_text.png"
|
|
width="139"
|
|
height="69"
|
|
alt="">
|
|
</p>
|
|
|
|
<dl>
|
|
<dt>
|
|
<b>Text versus Label</b>
|
|
</dt>
|
|
|
|
<dd>
|
|
<p>
|
|
The <b>Text</b> tool is the original text-entry
|
|
tool in Tux Paint. Text entered using this
|
|
tool can't be modified or moved later, since it
|
|
becomes part of the drawing. However, because
|
|
the text becomes part of the picture, it can be
|
|
drawn over or modified using <b>Magic</b> tool
|
|
effects (e.g., smudged, tinted, embossed, etc.)
|
|
</p>
|
|
|
|
<p>
|
|
When using the <b>Label</b> tool (which was
|
|
added to Tux Paint in version 0.9.22), the
|
|
text 'floats' over the image, and the details
|
|
of the label (the text, the position of the
|
|
label, the font choice and the color) get
|
|
stored separately. This allows the label to be
|
|
repositioned or edited later.
|
|
</p>
|
|
|
|
<p>
|
|
The <b>Label</b> tool can be disabled (e.g., by
|
|
selecting "Disable 'Label' Tool" in
|
|
<i>Tux Paint Config.</i> or running
|
|
<i>Tux Paint</i> with the
|
|
"<code>--nolabel</code>" command-line option).
|
|
</p>
|
|
</dd>
|
|
|
|
<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.
|
|
</p>
|
|
|
|
<ul>
|
|
<li>Japanese — Romanized Hiragana and Romanized
|
|
Katakana — <b>right [Alt]</b>
|
|
</li>
|
|
|
|
<li>Korean — Hangul 2-Bul —
|
|
<b>right [Alt]</b> or
|
|
<b>left [Alt]</b>
|
|
</li>
|
|
|
|
<li>Traditional Chinese —
|
|
<b>right [Alt]</b> or
|
|
<b>left [Alt]</b>
|
|
</li>
|
|
|
|
<li>Thai — <b>right [Alt]</b>
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
|
|
<dd>
|
|
<hr size="1">
|
|
</dd>
|
|
|
|
<dt>
|
|
<b>Fill</b>
|
|
</dt>
|
|
|
|
<dd>
|
|
<img src="../../html/images/tool_fill.png"
|
|
width="48"
|
|
height="48"
|
|
alt=""
|
|
align="right">
|
|
<p>
|
|
The 'Fill' tool 'flood-fills' a contiguous area of
|
|
your drawing with a solid color of your choice.
|
|
</p>
|
|
|
|
<p>
|
|
Note: Prior to Tux Paint 0.9.24, this was a
|
|
"Magic" tool (see below).
|
|
</p>
|
|
|
|
<hr size="1">
|
|
</dd>
|
|
|
|
<dt>
|
|
<b>Magic (Special Effects)</b>
|
|
</dt>
|
|
|
|
<dd>
|
|
<img src="../../html/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="../../html/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="../../html/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="../../html/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="../../html/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="../../html/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="../../html/images/open_dialog.jpg"
|
|
width="194"
|
|
height="152"
|
|
alt="">
|
|
</p>
|
|
|
|
<p>
|
|
Click a picture to select it, then...
|
|
</p>
|
|
|
|
<blockquote>
|
|
<ul>
|
|
<li>
|
|
<img src="../../html/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>
|
|
|
|
<li>
|
|
<img src="../../html/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>
|
|
|
|
<p>
|
|
<b>Note:</b> As of version 0.9.22, the
|
|
picture will be placed in your desktop's
|
|
trash can, on Linux only.
|
|
</p>
|
|
<br clear="all">
|
|
</li>
|
|
|
|
<li>
|
|
<img src="../../html/images/open_export.png"
|
|
width="48"
|
|
height="48"
|
|
alt=""
|
|
align="right">
|
|
<p>
|
|
Click the "Export" button near the lower right
|
|
to export the image to your export folder.
|
|
(e.g., "<code>~/Pictures/TuxPaint/</code>")
|
|
</p>
|
|
<br clear="all">
|
|
</li>
|
|
|
|
<li>
|
|
<img src="../../html/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>
|
|
|
|
<li>
|
|
<img src="../../html/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">
|
|
</li>
|
|
</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"
|
|
id="save">Save</a></b>
|
|
</dt>
|
|
|
|
<dd>
|
|
<img src="../../html/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="../../html/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="../../html/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 macOS)</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"
|
|
id="slides"><b>Slides</b> (under "Open")</a>
|
|
</dt>
|
|
|
|
<dd>
|
|
<img src="../../html/images/open_slides.png"
|
|
width="48"
|
|
height="48"
|
|
alt=""
|
|
align="right">
|
|
<p>
|
|
The "Slides" button is available in the "Open"
|
|
dialog. It can be used to play a simple animation
|
|
within Tux Paint, or a slideshow of pictures.
|
|
It can also export an animated GIF based on the
|
|
chosen images.
|
|
</p>
|
|
|
|
<dl>
|
|
<dt><b>Chosing pictures</b></dt>
|
|
<dd>
|
|
<p>
|
|
When you enter the "Slides" section of Tux Paint,
|
|
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). Click it again if you
|
|
wish to add it to the end of the list.
|
|
</p>
|
|
</dd>
|
|
|
|
<dt><b>Set playback speed</b></dt>
|
|
<dd>
|
|
<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 or animated GIF,
|
|
from slowest to fastest. Choose the leftmost setting
|
|
to disable automatic advancement during playback within
|
|
Tux Paint — 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.
|
|
(This does not apply to an exported animated GIF.)
|
|
</p>
|
|
</dd>
|
|
|
|
<dt><b>Playback in Tux Paint</b></dt>
|
|
<dd>
|
|
<p>
|
|
To play a slideshow within Tux Paint, click the
|
|
"Play" button. (Note: If you hadn't selected ANY
|
|
images, then ALL of your saved 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>
|
|
</dd>
|
|
|
|
<dt><b>Exporting an animated GIF</b></dt>
|
|
<dd>
|
|
<p>
|
|
<img src="../../html/images/open_slides_export_gif.png"
|
|
width="48"
|
|
height="48"
|
|
alt=""
|
|
align="right">
|
|
Click the "GIF Export" button near the lower right
|
|
to have Tux Paint generate an animated GIF file
|
|
based on the selected images.
|
|
</p>
|
|
<p>
|
|
<b>Note:</b> At least two images must be selected.
|
|
(To export a single image, use the "Export" option
|
|
from the "Open" dialog.) If no images are selected,
|
|
Tux Paint will NOT attempt to generate a GIF
|
|
based on all saved images.
|
|
</p>
|
|
<p>
|
|
Pressing [Escape] during export will abort the process,
|
|
and return you to the "Slideshow" dialog.
|
|
</p>
|
|
<br clear="all" />
|
|
</dd>
|
|
</dl>
|
|
|
|
<p>
|
|
Click "Back" in the slideshow image selection
|
|
screen to return to the "Open" dialog.
|
|
</p>
|
|
<br clear="all">
|
|
|
|
<hr size="1">
|
|
</dd>
|
|
|
|
<dt>
|
|
<b>Quit</b>
|
|
</dt>
|
|
|
|
<dd>
|
|
<img src="../../html/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">
|
|
|
|
<hr size="1">
|
|
</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>
|
|
</dd>
|
|
</dl>
|
|
</blockquote>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size="2"
|
|
noshade>
|
|
|
|
<h1>
|
|
<a name="loading_into"
|
|
id="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>
|
|
macOS
|
|
</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, macOS, BeOS, and Haiku 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>
|
|
|
|
<li>MM = Month (01-12)
|
|
</li>
|
|
|
|
<li>DD = Day (01-31)
|
|
</li>
|
|
|
|
<li>HH = Hour, in 24-hour format (00-23)
|
|
</li>
|
|
|
|
<li>mm = Minute (00-59)
|
|
</li>
|
|
|
|
<li>ss = Second (00-59)
|
|
</li>
|
|
</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:
|
|
</p>
|
|
|
|
<ol>
|
|
<li>Take the height of the window (e.g, 480, 600 or 768
|
|
pixels) and subtract 144
|
|
</li>
|
|
|
|
<li>Take the result of Step 1 and divide it by 48
|
|
</li>
|
|
|
|
<li>Take the result of Step 2 and round it down
|
|
(e.g., 9.5 becomes simply 9)
|
|
</li>
|
|
|
|
<li>Take the result of Step 3 and multiply it by
|
|
48
|
|
</li>
|
|
|
|
<li>Finally, take the result of Step 4 and add 40
|
|
</li>
|
|
</ol>
|
|
|
|
<p>
|
|
<b>Example:</b> Tux Paint running at fullscreen on
|
|
a 1440x900 display.
|
|
</p>
|
|
|
|
<ul>
|
|
<li>The canvas width is simply 1440 - 192, or
|
|
1248.
|
|
</li>
|
|
|
|
<li>The canvas height is calculated as:
|
|
<ol>
|
|
<li>900 - 144, or 756
|
|
</li>
|
|
|
|
<li>756 / 48, or 15.75
|
|
</li>
|
|
|
|
<li>15.75 rounded down, or 15
|
|
</li>
|
|
|
|
<li>15 * 48, or 720
|
|
</li>
|
|
|
|
<li>720 + 40, or 760
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>
|
|
So the canvas within a 1440x900 Tux Paint window
|
|
is 1248x760.
|
|
</p>
|
|
</blockquote>
|
|
</blockquote>
|
|
</blockquote>
|
|
|
|
<hr size="2"
|
|
noshade>
|
|
|
|
<h1>
|
|
<a name="further"
|
|
id="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>
|
|
|
|
<li>
|
|
<a href="../AUTHORS.txt">AUTHORS.txt</a><br>
|
|
List of authors and contributors.
|
|
</li>
|
|
|
|
<li>
|
|
<a href="../CHANGES.txt">CHANGES.txt</a><br>
|
|
Summary of changed between releases.
|
|
</li>
|
|
|
|
<li>
|
|
<a href="../COPYING.txt">COPYING.txt</a><br>
|
|
Copying license (The GNU General Public License).
|
|
</li>
|
|
|
|
<li>
|
|
<a href="../INSTALL.txt">INSTALL.txt</a><br>
|
|
Instructions for compiling/installing, when applicable.
|
|
</li>
|
|
|
|
<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>
|
|
|
|
<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>
|
|
|
|
<li>
|
|
<a href="../PNG.txt">PNG.txt</a><br>
|
|
Notes on creating PNG format bitmapped images for use in
|
|
Tux Paint.
|
|
</li>
|
|
|
|
<li>
|
|
<a href="../SVG.txt">SVG.txt</a><br>
|
|
Notes on creating SVG format vector images for use in
|
|
Tux Paint.
|
|
</li>
|
|
|
|
<li>
|
|
<a href="../SIGNALS.txt">SIGNALS.txt</a><br>
|
|
Information about POSIX signals Tux Paint responds
|
|
to.
|
|
</li>
|
|
</ul>
|
|
</blockquote>
|
|
|
|
<hr size="2"
|
|
noshade>
|
|
|
|
<h1>
|
|
<a name="help"
|
|
id="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>
|