From ce608a16f11f73dc094738cf48c158e3d0667e09 Mon Sep 17 00:00:00 2001 From: William Kendrick Date: Mon, 29 Sep 2003 06:54:13 +0000 Subject: [PATCH] Added 'noflip' and 'nomirror' stamp "*.dat" options to README. --- docs/README.txt | 52 ++++++++++++++++++++-- docs/html/README.html | 100 ++++++++++++++++++++++++++++++++---------- 2 files changed, 126 insertions(+), 26 deletions(-) diff --git a/docs/README.txt b/docs/README.txt index bd883f953..6e83c1849 100644 --- a/docs/README.txt +++ b/docs/README.txt @@ -9,7 +9,7 @@ bill@newbreedsoftware.com http://www.newbreedsoftware.com/tuxpaint/ - June 14, 2002 - September 27, 2003 + June 14, 2002 - September 29, 2003 ---------------------------------------------------------------------- @@ -820,7 +820,9 @@ Available Tools As you move the mouse around, an outline follows the mouse, showing where the stamp will be placed. - Different stamps can have different sound effects. + Different stamps can have different sound effects. Some + stamps can be colored or tinted. Many stamps can be flipped + vertically, or displayed as a mirror-image. ---------------------------------------------------------------------- @@ -1260,7 +1262,7 @@ Where Files Go /usr/local/share/tuxpaint/ - If you installed from a package, it is more likely: + If you installed from a package, it is more likely to be: /usr/share/tuxpaint/ @@ -1272,6 +1274,13 @@ Where Files Go C:\Program Files\TuxPaint\data + Mac OS X + + Tux Paint stores files in your account's "Libraries" folder, under + "Preferences", e.g.: + + /Users/Joe/Library/Preferences/ + ---------------------------------------------------------------------- Personal Files @@ -1395,7 +1404,7 @@ Stamps "!Ninos!" Note: As in HTML, if you want an actual ampersand ("&") in - your description when using the "xx.esc" method, you'll need + your description when using the "xx.esc" method ,you'll need to escape it: "&". * Lines beginning with "xx.utf8=" can be used to use UTF-8 @@ -1473,12 +1482,47 @@ Stamps Add the word "tintable" to the stamp's data file. + Unalterable Stamps + + By default, a stamp can be flipped upside down, shown as a mirror + image, or both. This is done using the control buttons below the + stamp selector, at the lower right side of the screen in + Tux Paint. + + Sometimes, it doesn't make sense for a stamp to be flippable or + mirrored; for example, stamps of letters or numbers. Sometimes + stamps are symettrical, so letting the user flip or mirror them + isn't useful. + + To make a stamp un-flippable, add the option "noflip" to the + stamp's data file. + + To keep a stamp from being mirrored, add the option "nomirror" to + the stamp's data file. + Windows Users You can use NotePad or WordPad to create these file. Be sure to save it as Plain Text, and make sure the filename has ".dat" at the end, and not ".txt"... + Pre-Mirrored Images + + In some cases, you may wish to provide a pre-drawn version of a + stamp's mirror-image. For example, imagine a picture of a fire truck + with the words "Fire Department" written across the side. You + probably do not want that text to appear backwards when the image is + flipped! + + To create a mirrored version of a stamp that you want Tux Paint to + use, rather than mirroring one on its own, simply create a second + ".png" graphics file with the same name, except with the string + "_mirror" before the filename extension. + + For example, for the stamp "truck.png" you would create another file + named "truck_mirror.png", which will be used when the stamp is + mirrored (rather than using a backwards version of 'truck.png'). + ---------------------------------------------------------------------- Fonts diff --git a/docs/html/README.html b/docs/html/README.html index 83e0dda55..08c602a3a 100644 --- a/docs/html/README.html +++ b/docs/html/README.html @@ -23,7 +23,7 @@ New Breed Software

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

-

June 14, 2002 - September 27, 2003

+

June 14, 2002 - September 29, 2003

@@ -1236,7 +1236,9 @@ New Breed Software

As you move the mouse around, an outline follows the mouse, showing where the stamp will be placed.

-

Different stamps can have different sound effects.

+

Different stamps can have different sound effects. + Some stamps can be colored or tinted. Many stamps can be + flipped vertically, or displayed as a mirror-image.


@@ -1348,78 +1350,78 @@ New Breed Software


-
Rainbow
+
Rainbow
This is similar to the paint brush, but as you move the mouse around, it goes through all of the colors in the rainbow.
-
Sparkles
+
Sparkles
This draws glowing yellow sparkles on the picture.
-
Mirror
+
Mirror
When you click the mouse in your picture with the "Mirror" magic effect selected, the entire image will be reversed, turning it into a mirror image.
-
Flip
+
Flip
Similar to "Mirror." Click and the entire image will be turned upside-down.
-
Blur
+
Blur
This makes the picture fuzzy wherever you drag the mouse.
-
Blocks
+
Blocks
This makes the picture blocky looking ("pixelated") wherever you drag the mouse.
-
Negative
+
Negative
This inverts the colors wherever you drag the mouse. (e.g., white becomes black, and vice versa.)
-
Fade
+
Fade
This fades the colors wherever you drag the mouse. (Do it to the same spot many times, and it will eventually become white.)
-
Chalk
+
Chalk
This makes parts of the picture (where you move the mouse) look like a chalk drawing.
-
Drip
+
Drip
This makes the paint "drip" wherever you move the mouse.
-
Thick
+
Thick
This makes the darker colors in the picture become thicker wherever you drag the mouse.
-
Thin
+
Thin
Similar to "Thick," except dark colors become thinner (light colors become thicker).
-
Fill
+
Fill
This floods the picture with a color. It lets you quickly fill parts of the picture, as if it were a coloring book. @@ -1845,7 +1847,7 @@ New Breed Software

/usr/local/share/tuxpaint/ -

If you installed from a package, it is more likely:

+

If you installed from a package, it is more likely to be:

/usr/share/tuxpaint/ @@ -1865,6 +1867,19 @@ New Breed Software

+ + +

Mac OS X

+
+

Tux Paint stores files in your account's + "Libraries" folder, under "Preferences", e.g.:

+ +
+ /Users/Joe/Library/Preferences/ +
+ +
+
@@ -2023,8 +2038,8 @@ New Breed Software

will come out as "¡Niños!"

Note: As in HTML, if you want an actual ampersand ("&") - in your description when using the "xx.esc" method, - you'll need to escape it: "&".

+ in your description when using the "xx.esc" + method ,you'll need to escape it: "&".

  • Lines beginning with "xx.utf8=" can be used to use UTF-8 encoded text for the description's translation. @@ -2054,8 +2069,8 @@ New Breed Software

    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), +

    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"

    @@ -2073,8 +2088,8 @@ New Breed Software

    Stamp Options

    -

    Aside from a graphical shape, a textual description, and a sound effect, - stamps can also be given other attributes. To do this, you need +

    Aside from a graphical shape, a textual description, and a sound + effect, stamps can also be given other attributes. To do this, you need to create a 'data file' for the stamp.

    A stamp data file is simply a text file containing the options.

    @@ -2119,6 +2134,26 @@ New Breed Software

    +

    Unalterable Stamps

    +
    +

    By default, a stamp can be flipped upside down, shown as a mirror + image, or both. This is done using the control buttons below the + stamp selector, at the lower right side of the screen in + Tux Paint.

    + +

    Sometimes, it doesn't make sense for a stamp to be flippable or + mirrored; for example, stamps of letters or numbers. + Sometimes stamps are symettrical, so letting the user flip or mirror + them isn't useful.

    + +

    To make a stamp un-flippable, add the option + "noflip" to the stamp's data file.

    + +

    To keep a stamp from being mirrored, add the option + "nomirror" to the stamp's data file.

    +
    + +

    Windows Users

    You can use NotePad or WordPad to create these file. @@ -2126,6 +2161,27 @@ New Breed Software

    has ".dat" at the end, and not ".txt"...

    + +

    Pre-Mirrored Images

    +
    +

    In some cases, you may wish to provide a pre-drawn version of + a stamp's mirror-image. For example, imagine a picture of a fire + truck with the words "Fire Department" written across + the side. You probably do not want that text to appear backwards + when the image is flipped!

    + +

    To create a mirrored version of a stamp that you want Tux Paint + to use, rather than mirroring one on its own, simply create a second + ".png" graphics file with the same name, except with + the string "_mirror" before the filename + extension.

    + +

    For example, for the stamp "truck.png" you would + create another file named "truck_mirror.png", which + will be used when the stamp is mirrored (rather than using a + backwards version of 'truck.png').

    +
    +