* Updated version to 0.9.17

* Stamps now supports SVG vector-based graphics!  (Via Cairo library)
* Discussed SVG Stamps in "Extending Tux Paint."
* Created an "SVG.txt" document, covering SVG software.
* Mentioned descriptive sounds (e.g., "stamp_desc_ll.ogg") in "Extending..."
* Listing new www.tuxpaint.org website URL.
This commit is contained in:
William Kendrick 2006-10-26 08:54:24 +00:00
parent f802626da4
commit b765c86e50
14 changed files with 622 additions and 120 deletions

View file

@ -1,20 +1,20 @@
Tux Paint
version 0.9.16
Advanced Stamps HOWTO
version 0.9.17
Advanced Stamps HOWTO
Copyright 2006 by Albert Cahalan for the Tux Paint project
New Breed Software
albert@users.sf.net
http://www.newbreedsoftware .com/tuxpaint/
http://www.tuxpaint.org/
March 8, 2006 - March 8, 2006
March 8, 2006 - October 26, 2006
About this HOWTO
This HOWTO assumes that you want to make an excellent Tux Paint stamp
from a JPEG image. There are easier and faster methods that produce
lower quality.
This HOWTO assumes that you want to make an excellent Tux Paint stamp,
in PNG bitmapped format, from a JPEG image (e.g., a digital photograph).
There are easier and faster methods that produce lower quality.
This HOWTO assumes you are dealing with normal opaque objects. Dealing
with semi-transparent objects (fire, moving fan blade, kid's baloon) or

View file

@ -9,6 +9,25 @@ http://www.newbreedsoftware.com/tuxpaint/
$Id$
2006.October.26 (0.9.17)
* Tool Improvements:
------------------
* Stamps now supports SVG vector-based graphics! (Via Cairo library)
(Experimental; build with "make nosvg" to disable SVG support and
Cairo dependency.)
* Documentation Improvements:
---------------------------
* Discussed SVG Stamps in "Extending Tux Paint."
* Created an "SVG.txt" document, covering SVG software.
* Mentioned descriptive sounds (e.g., "stamp_desc_ll.ogg") in "Extending..."
* Listing new www.tuxpaint.org website URL.
2006.October.19 (0.9.16)
* Interface improvements:

View file

@ -1,14 +1,14 @@
Tux Paint
version 0.9.16
version 0.9.17
Extending Tux Paint
Copyright 2002-2006 by Bill Kendrick and others
New Breed Software
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/tuxpaint/
http://www.tuxpaint.org/
June 14, 2002 - September 28, 2006
June 14, 2002 - October 26, 2006
--------------------------------------------------------------------------
@ -217,28 +217,39 @@ Stamps
files. The one file that is required is, of course, the picture
itself.
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).
As of Tux Paint version 0.9.17, Stamps may be either PNG bitmap images
or SVG vector images. They can be full-color or greyscale. The alpha
(transparency) channel of PNGs is used to determine the actual shape
of the picture (otherwise you'll stamp a large rectangle on your
drawings).
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.
PNGs can be any size, and Tux Paint (by default) provides a set of
sizing buttons to let the user scale the stamp up (larger) and down
(smaller).
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
SVGs are vector-based, and will be scaled appropriately for the canvas
being used in Tux Paint.
Note: If your new PNG stamps all have solid rectangular-shaped
outlines of a solid color (e.g., white or black), it's because you
forgot to use alpha transparency! See the documentation file "PNG.txt"
for more information and tips.
Note: If your new SVG stamps seem to have a lot of whitespace, make
sure the SVG 'document' is no larger than the shape(s) within. If they
are being clipped, make sure the 'document' is large enough to contain
the shape(s). See the documentation file "SVG.txt" for more
information and tips.
Advanced Users: The Advanced Stamps HOWTO describes, in detail, how to
make images which will scale perfectly when used as stamps in
make PNG images which will scale perfectly when used as stamps in
Tux Paint.
--------------------------------------------------------------------------
Description Text
Text (".TXT") files with the same name as the PNG. (e.g.,
Text (".TXT") files with the same name as the PNG or SVG. (e.g.,
"picture.png"'s description is stored in "picture.txt" in the same
directory.)
@ -274,16 +285,16 @@ Stamps
Sound Effects
WAVE (".WAV") files with the same name as the PNG. (e.g.,
"picture.png"'s sound effect is the sound "picture.wav" in the same
directory.)
WAVE (".wav") or OGG Vorbis (".ogg") files with the same name as the
PNG or SVG. (e.g., "picture.svg"'s sound effect is the sound file
"picture.wav" in the same directory.)
Language Support
For sounds for different locales (e.g., if the sound is someone
saying a word, and you want translated versions of the word said),
also create WAV files with the locale's label in the filename, in
the form: "STAMP_LOCALE.wav"
also create WAV or OGG files with the locale's label in the
filename, in the form: "STAMP_LOCALE.EXT"
"picture.png"'s sound effect, when Tux Paint is run in Spanish mode,
would be "picture_es.wav". In French mode, "picture_fr.wav". And so
@ -292,6 +303,31 @@ Stamps
If no localized sound effect can be loaded, Tux Paint will attempt
to load the 'default' sound file. (e.g., "picture.wav")
Note: For descriptive sounds (not sound effects, like a bang or a bird
chirping), consider using the Descriptive Sounds, described below.
--------------------------------------------------------------------------
Descriptive Sound
WAVE (".wav") or OGG Vorbis (".ogg") files with the same name as the
PNG or SVG, followed by "_desc" (e.g., "picture.svg"'s descriptive
sound is the sound file "picture_desc.ogg" in the same directory.)
Language Support
For descriptions in different languages, also create WAV or OGG
files with both "_desc" and the locale's label in the filename, in
the form: "STAMP_desc_LOCALE.EXT"
"picture.png"'s descriptive sound, when Tux Paint is run in Spanish
mode, would be "picture_desc_es.wav". In French mode,
"picture_desc_fr.wav". And so on...
If no localized descriptive sound can be loaded, Tux Paint will
attempt to load the 'default' descriptive sound file. (e.g.,
"picture_desc.wav")
--------------------------------------------------------------------------
Stamp Options
@ -302,9 +338,9 @@ Stamps
A stamp data file is simply a text file containing the options.
The file has the same name as the PNG image, but a ".dat" extension.
(e.g., "picture.png"'s data file is the text file "picture.dat" in the
same directory.)
The file has the same name as the PNG or SVG image, but a ".dat"
extension. (e.g., "picture.png"'s data file is the text file
"picture.dat" in the same directory.)
Colored Stamps

View file

@ -1,14 +1,14 @@
Tux Paint
version 0.9.16
version 0.9.17
Frequently Asked Questions
Copyright 2002-2006 by Bill Kendrick and others
New Breed Software
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/tuxpaint/
http://www.tuxpaint.org/
September 14, 2002 - March 8, 2006
September 14, 2002 - October 26, 2006
Drawing-related
@ -168,7 +168,7 @@ Interface Problems
The appropriate fonts for such locales can be downloaded
from the Tux Paint website:
http://www.newbreedsoftware.com/tuxpaint/download/fonts/
http://www.tuxpaint,org/download/fonts/
Printing
@ -571,4 +571,4 @@ Help / Contact
Or post to our 'tuxpaint-users' mailing list:
http://www.newbreedsoftware.com/tuxpaint/lists/
http://www.tuxpaint.org/lists/

View file

@ -2,11 +2,11 @@ INSTALL.txt for Tux Paint
Tux Paint - A simple drawing program for children.
Copyright 2005 by Bill Kendrick and others
Copyright 2006 by Bill Kendrick and others
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/tuxpaint/
http://www.tuxpaint.org/
June 27, 2002 - February 26, 2005
June 27, 2002 -October 26, 2006
$Id$
@ -76,7 +76,14 @@ Requirements:
http://www.gnu.org/software/gettext/
NetPBM Tools [OPTIONAL]
Cairo, libsvg, svg-cairo [EXPERIMENTAL] [can be disabled]
----------------------------------------
As of Tux Paint 0.9.17, SVG vector graphics are supported by the
'Stamps' tool.
http://www.cairographics.org/
NetPBM Tools [OPTIONAL] [No longer used, by default]
------------------------
Under Linux and Unix, the NetPBM tools are what are currently
used for printing. (A PNG is generated by TuxPaint, and converted
@ -183,6 +190,15 @@ Compiling and Installation:
$ make
Disabling SVG support (and hence Cairo, libSVG and svg-cairo dependencies):
---------------------------------------------------------------------------
To disable SVG support (e.g., if your system is not currently supported
by the Cairo library or other SVG-related dependencies), you can
run "make" with "nosvg" as the 'target', instead:
$ make nosvg
Disabling Sound at Compile-time:
--------------------------------
Alternatively, if you don't have a sound card, or would prefer to build

View file

@ -1,5 +1,5 @@
Tux Paint
version 0.9.16
version 0.9.17
Options Documentation
@ -7,9 +7,9 @@
New Breed Software
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/tuxpaint/
http://www.tuxpaint.org/
October 11, 2006
October 26, 2006
--------------------------------------------------------------------------
@ -899,8 +899,8 @@ Setting Your Environment's Locale
/usr/share/tuxpaint/fonts/locale/ko.ttf
You can download fonts for supported languages from Tux Paint's
website, http://www.newbreedsoftware.com/tuxpaint/. (Look in the
'Fonts' section under 'Download.')
website, http://www.tuxpaint.org/. (Look in the 'Fonts' section under
'Download.')
Under Unix and Linux, you can use the Makefile that comes with the
font to install the font in the appropriate location.

View file

@ -1,5 +1,5 @@
Tux Paint
version 0.9.16
version 0.9.17
A simple drawing program for children
@ -7,9 +7,9 @@
New Breed Software
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/tuxpaint/
http://www.tuxpaint.org/
June 14, 2002 - September 9, 2006
June 14, 2002 - October 26, 2006
--------------------------------------------------------------------------
@ -785,7 +785,9 @@ Doing it Manually
Detailed instructions on command-line and configuration-file
options, for those who don't want to use Tux Paint Config.
* PNG.txt
Notes on creating PNG format images for use in Tux Paint
Notes on creating PNG format bitmapped images for use in Tux Paint
* SVG.txt
Notes on creating SVG format vector images for use in Tux Paint
--------------------------------------------------------------------------
@ -798,4 +800,4 @@ Doing it Manually
You may also wish to participate in the numerous Tux Paint mailing
lists:
http://www.newbreedsoftware.com/tuxpaint/lists/
http://www.tuxpaint.org/lists/

View file

@ -11,7 +11,7 @@ alink="#FF00FF">
alt="Tux&nbsp;Paint"><br>
version
0.9.16
0.9.17
<br>
Advanced Stamps HOWTO</h1>
@ -19,10 +19,9 @@ Advanced Stamps HOWTO</h1>
<p>Copyright 2006 by Albert Cahalan for the Tux Paint project<br>
New Breed Software</p>
<p><a href="mailto:albert@users.sf.net">albert@users.sf.net</a><br>
<a href="http://www.newbreedsoftware.com/tuxpaint/">http://www.newbreedsoftware
.com/tuxpaint/</a></p>
<a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a></p>
<p>March 8, 2006 - March 8, 2006</p>
<p>March 8, 2006 - October 26, 2006</p>
</center>
@ -30,7 +29,8 @@ New Breed Software</p>
<blockquote>
<p>This HOWTO assumes that you want to make an excellent Tux&nbsp;Paint
stamp from a JPEG image. There are easier and faster methods that
stamp, in PNG bitmapped format, from a JPEG image (e.g., a digital
photograph). There are easier and faster methods that
produce lower quality.</p>
<p>This HOWTO assumes you are dealing with normal opaque objects. Dealing

View file

@ -12,7 +12,7 @@ alt="Tux&nbsp;Paint"><br>
version
0.9.16
0.9.17
<br>
Extending Tux Paint</h1>
@ -21,9 +21,9 @@ Extending Tux Paint</h1>
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>
<a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a></p>
<p>June 14, 2002 - September 28, 2006</p>
<p>June 14, 2002 - October 26, 2006</p>
</center>
<hr size=2 noshade>
@ -307,23 +307,34 @@ effect.</p>
<img src="images/stamp_edit.png" width=128 height=147 alt="" align=right>
<p>The Stamps used by Tux&nbsp;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>As of Tux&nbsp;Paint version 0.9.17, Stamps may be either PNG
bitmap images or SVG vector images. They can be full-color or greyscale.
The alpha (transparency) channel of PNGs is used to determine the actual
shape of the picture (otherwise you'll stamp a large rectangle on your
drawings).</p>
<p>The PNGs can be any size, but in practice, a 100&nbsp;pixels wide by
100&nbsp;pixels tall (100&nbsp;x&nbsp;100) is quite large for
Tux&nbsp;Paint.</p>
<p>PNGs can be any size, and Tux&nbsp;Paint (by default) provides
a set of sizing buttons to let the user scale the stamp up (larger)
and down (smaller).</p>
<p>Note: If your new stamps all have solid rectangular-shaped outlines
<p>SVGs are vector-based, and will be scaled appropriately for the
canvas being used in Tux&nbsp;Paint.</p>
<p>Note: If your new PNG stamps all have solid rectangular-shaped outlines
of a solid color (e.g., white or black), it's because you forgot to use
alpha transparency! See the documentation file
"<a href="../PNG.txt">PNG.txt</a>" for more information and tips.</p>
<p><b>Advanced Users:</b> The <a href="ADVANCED-STAMPS-HOWTO.html">Advanced
Stamps HOWTO</a> describes, in detail, how to make images which will
scale perfectly when used as stamps in Tux&nbsp;Paint.</p>
<p>Note: If your new SVG stamps seem to have a lot of whitespace,
make sure the SVG 'document' is no larger than the shape(s) within.
If they are being clipped, make sure the 'document' is large enough
to contain the shape(s). See the documentation file
"<a href="../SVG.txt">SVG.txt</a>" for more information and tips.</p>
<p><b>Advanced Users:</b> The
<a href="ADVANCED-STAMPS-HOWTO.html">Advanced Stamps HOWTO</a> describes,
in detail, how to make PNG images which will scale perfectly when used as
stamps in Tux&nbsp;Paint.</p>
<br clear=all>
</blockquote>
@ -332,7 +343,7 @@ effect.</p>
<h3>Description Text</h3>
<blockquote>
<p>Text (".TXT") files with the same name as the PNG.
<p>Text (".TXT") files with the same name as the PNG or SVG.
(e.g., "<code>picture.png</code>"'s description is stored in
"<code>picture.txt</code>" in the same directory.)</p>
@ -372,17 +383,18 @@ effect.</p>
<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
<p>WAVE (".wav") or OGG Vorbis (".ogg")
files with the same name as the PNG or SVG.
(e.g., "<code>picture.svg</code>"'s sound effect is the sound file
"<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>
also create WAV or OGG files with the locale's label in the filename, in
the form: "<code><b>STAMP_LOCALE.EXT</b></code>"</p>
<p>"<code>picture.png</code>"'s sound effect, when Tux&nbsp;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>
@ -391,6 +403,37 @@ effect.</p>
attempt to load the 'default' sound file.
(e.g., "<code>picture.wav</code>")</p>
</blockquote>
<p>Note: For descriptive sounds (not sound effects, like a bang or
a bird chirping), consider using the Descriptive&nbsp;Sounds,
described below.</p>
</blockquote>
<hr size=1 noshade>
<h3>Descriptive Sound</h3>
<blockquote>
<p>WAVE (".wav") or OGG Vorbis (".ogg")
files with the same name as the PNG or SVG, followed by
"<code>_desc</code>" (e.g., "<code>picture.svg</code>"'s descriptive
sound is the sound file "<code>picture_desc.ogg</code>" in the same
directory.)</p>
<h4>Language Support</h4>
<blockquote>
<p>For descriptions in different languages,
also create WAV or OGG files with both "<code>_desc</code>" and
the locale's label in the filename, in
the form: "<code><b>STAMP_desc_LOCALE.EXT</b></code>"</p>
<p>"<code>picture.png</code>"'s descriptive sound, when Tux&nbsp;Paint
is run in Spanish mode, would be "<code>picture_desc_es.wav</code>".
In French mode, "<code>picture_desc_fr.wav</code>". And so on...</p>
<p>If no localized descriptive sound can be loaded, Tux&nbsp;Paint will
attempt to load the 'default' descriptive sound file.
(e.g., "<code>picture_desc.wav</code>")</p>
</blockquote>
</blockquote>
<hr size=1 noshade>
@ -403,9 +446,10 @@ effect.</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>
<p>The file has the same name as the PNG or SVG 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>

View file

@ -11,7 +11,7 @@ alink="#FF00FF">
alt="Tux&nbsp;Paint"><br>
version
0.9.16
0.9.17
<br>
Frequently Asked Questions</h1>
@ -20,9 +20,9 @@ Frequently Asked Questions</h1>
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>
<a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a></p>
<p>September 14, 2002 - March 8, 2006</p>
<p>September 14, 2002 - October 26, 2006</p>
</center>
<h2>Drawing-related</h2>
@ -197,8 +197,8 @@ New Breed Software</p>
Tux&nbsp;Paint website:</p>
<blockquote><p>
<a href="http://www.newbreedsoftware.com/tuxpaint/download/fonts/"
>http://www.newbreedsoftware.com/tuxpaint/download/fonts/</a>
<a href="http://www.tuxpaint.org/download/fonts/"
>http://www.tuxpaint,org/download/fonts/</a>
</p></blockquote>
</li>
</ul>
@ -648,8 +648,7 @@ New Breed Software</p>
<p>Or post to our 'tuxpaint-users' mailing list:</p>
<blockquote><p><a href="http://www.newbreedsoftware.com/tuxpaint/lists/"
>http://www.newbreedsoftware.com/tuxpaint/lists/</a></p></blockquote>
<blockquote><p><a href="http://www.tuxpaint.org/lists/">http://www.tuxpaint.org/lists/</a></p></blockquote>
</body></html>

View file

@ -11,7 +11,7 @@ alink="#FF00FF">
version
0.9.16
0.9.17
</h1>
<h2>Options Documentation</h2>
@ -20,9 +20,9 @@ version
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>
<a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a></p>
<p>October 11, 2006</p>
<p>October 26, 2006</p>
</center>
<hr size=2 noshade>
@ -1477,8 +1477,7 @@ New Breed Software</p>
You can download fonts for supported languages from Tux&nbsp;Paint's
website,
<a href="http://www.newbreedsoftware.com/tuxpaint/">
http://www.newbreedsoftware.com/tuxpaint/</a>.
<a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a>.
(Look in the 'Fonts' section under 'Download.')<p>
Under Unix and Linux, you can use the <code>Makefile</code> that comes

View file

@ -12,7 +12,7 @@ alt="Tux&nbsp;Paint"><br>
version
0.9.16
0.9.17
</h1>
<h3>A simple drawing program for children</h3>
@ -21,9 +21,9 @@ version
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>
<a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a></p>
<p>June 14, 2002 - September 9, 2006</p>
<p>June 14, 2002 - October 26, 2006</p>
</center>
<hr size=2 noshade>
@ -1005,8 +1005,9 @@ New Breed Software</p>
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>
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>Reduce the size of the image to no wider than 448&nbsp;pixels across and
no taller than 376&nbsp;pixels tall. (i.e., the maximum size
@ -1070,7 +1071,10 @@ New Breed Software</p>
for those who don't want to use Tux&nbsp;Paint&nbsp;Config.
<li><a href="../PNG.txt">PNG.txt</a><br>
Notes on creating PNG format images for use in Tux&nbsp;Paint
Notes on creating PNG format bitmapped images for use in Tux&nbsp;Paint
<li><a href="../SVG.txt">SVG.txt</a><br>
Notes on creating SVG format vector images for use in Tux&nbsp;Paint
</ul>
</blockquote>
@ -1090,7 +1094,7 @@ New Breed Software</p>
lists:</p>
<blockquote>
<a href="http://www.newbreedsoftware.com/tuxpaint/lists/">http://www.newbreedsoftware.com/tuxpaint/lists/</a>
<a href="http://www.tuxpaint.org/lists/">http://www.tuxpaint.org/lists/</a>
</blockquote>
</blockquote>