Added 'noflip' and 'nomirror' stamp "*.dat" options to README.

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

docs/html/README.html

@@ -23,7 +23,7 @@ New Breed Software</p>
 <p><a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a><br>
 <a href="http://www.newbreedsoftware.com/tuxpaint/">http://www.newbreedsoftware.com/tuxpaint/</a></p>
 
-<p>June 14, 2002 - September 27, 2003</p>
+<p>June 14, 2002 - September 29, 2003</p>
 </center>
 
 <hr size=2 noshade>
@@ -1236,7 +1236,9 @@ New Breed Software</p>
         <p>As you move the mouse around, an outline follows the
         mouse, showing where the stamp will be placed.</p>
 
-        <p>Different stamps can have different sound effects.</p>
+        <p>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.</p>
 
         <br clear=all>
 
@@ -1348,78 +1350,78 @@ New Breed Software</p>
         <br clear=all>
 
         <dl>
-	<dt>Rainbow</dt>
+	<dt><b>Rainbow</b></dt>
 	<dd>
 	  This is similar to the paint brush, but as you move the mouse
 	  around, it goes through all of the colors in the rainbow.
 	</dd>
 
-	<dt>Sparkles</dt>
+	<dt><b>Sparkles</b></dt>
 	<dd>
 	  This draws glowing yellow sparkles on the picture.
 	</dd>
 
-	<dt>Mirror</dt>
+	<dt><b>Mirror</b></dt>
 	<dd>
 	  When you click the mouse in your picture with the "Mirror"
 	  magic effect selected, the entire image will be reversed,
 	  turning it into a mirror image.
 	</dd>
 	  
-	<dt>Flip</dt>
+	<dt><b>Flip</b></dt>
 	<dd>
 	  Similar to "Mirror."  Click and the entire image will be turned
 	  upside-down.
 	</dd>
 	  
-	<dt>Blur</dt>
+	<dt><b>Blur</b></dt>
 	<dd>
 	  This makes the picture fuzzy wherever you drag the mouse.
 	</dd>
 
-	<dt>Blocks</dt>
+	<dt><b>Blocks</b></dt>
 	<dd>
 	  This makes the picture blocky looking ("pixelated") wherever
 	  you drag the mouse.
 	</dd>
 
-	<dt>Negative</dt>
+	<dt><b>Negative</b></dt>
 	<dd>
 	  This inverts the colors wherever you drag the mouse.
 	  (e.g., white becomes black, and vice versa.)
 	</dd>
 
-	<dt>Fade</dt>
+	<dt><b>Fade</b></dt>
 	<dd>
 	  This fades the colors wherever you drag the mouse.
 	  (Do it to the same spot many times, and it will eventually become
 	  white.)
 	</dd>
 	
-	<dt>Chalk</dt>
+	<dt><b>Chalk</b></dt>
 	<dd>
 	  This makes parts of the picture (where you move the mouse)
 	  look like a chalk drawing.
 	</dd>
 	
-	<dt>Drip</dt>
+	<dt><b>Drip</b></dt>
 	<dd>
 	  This makes the paint "drip" wherever you move the mouse.
 	</dd>
 	 
-        <dt>Thick</dt>
+        <dt><b>Thick</b></dt>
 	<dd>
 	  This makes the darker colors in the picture become thicker
 	  wherever you drag the mouse.
 	</dd>
 
-	<dt>Thin</dt>
+	<dt><b>Thin</b></dt>
 	<dd>
 	  Similar to "Thick," except dark colors become thinner
 	  (light colors become thicker).
 	</dd>
 	
-	<dt>Fill</dt>
+	<dt><b>Fill</b></dt>
 	<dd>
 	  This floods the picture with a color.  It lets you quickly
 	  fill parts of the picture, as if it were a coloring book.
@@ -1845,7 +1847,7 @@ New Breed Software</p>
           /usr/local/share/tuxpaint/
         </code></blockquote>
 	
-	<p>If you installed from a package, it is more likely:</p>
+	<p>If you installed from a package, it is more likely to be:</p>
 
         <blockquote><code>
 	  /usr/share/tuxpaint/
@@ -1865,6 +1867,19 @@ New Breed Software</p>
         </code></blockquote>
 	
       </blockquote>
+
+
+      <h4>Mac OS X</h4>
+      <blockquote>
+        <p>Tux&nbsp;Paint stores files in your account's
+	"Libraries" folder, under "Preferences", e.g.:</p>
+
+	<blockquote><code>
+	  /Users/Joe/Library/Preferences/
+	</code></blockquote>
+
+      </blockquote>
+      
     </blockquote>
 
     <hr size=1 noshade>
@@ -2023,8 +2038,8 @@ New Breed Software</p>
 	  will come out as "&iexcl;Ni&ntilde;os!"</p>
 
 	  <p><b>Note:</b> As in HTML, if you want an actual ampersand ("&amp;")
-	  in your description when using the "<code><b>xx</b>.esc</code>" method,
+	  in your description when using the "<code><b>xx</b>.esc</code>"
-	  you'll need to escape it: "<code>&amp;amp;</code>".<p>
+	  method ,you'll need to escape it: "<code>&amp;amp;</code>".<p>
 	
 	<li><p>Lines beginning with "<code><b>xx</b>.utf8=</code>" can be
 	  used to use UTF-8 encoded text for the description's translation.
@@ -2054,8 +2069,8 @@ New Breed Software</p>
       
       <h4>Language Support</h4>
       <blockquote>
-        <p>For sounds for different locales (e.g., if the sound is someone saying
+        <p>For sounds for different locales (e.g., if the sound is someone
-        a word, and you want translated versions of the word said),
+	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>
 	
@@ -2073,8 +2088,8 @@ New Breed Software</p>
 
     <h3>Stamp Options</h3>
     <blockquote>
-      <p>Aside from a graphical shape, a textual description, and a sound effect,
+      <p>Aside from a graphical shape, a textual description, and a sound
-      stamps can also be given other attributes.  To do this, you need
+      effect, stamps can also be given other attributes.  To do this, you need
       to create a 'data&nbsp;file' for the stamp.</p>
       
       <p>A stamp data file is simply a text file containing the options.</p>
@@ -2119,6 +2134,26 @@ New Breed Software</p>
 	</blockquote>
       </blockquote>
 
+      <h4>Unalterable Stamps</h4>
+      <blockquote>
+        <p>By default, a stamp can be flipped upside down, shown as a mirror
+	image, or both.  This is done using the control buttons below the
+	stamp selector, at the lower right side of the screen in
+	Tux&nbsp;Paint.</p>
+
+	<p>Sometimes, it doesn't make sense for a stamp to be flippable or
+	mirrored; for example, stamps of letters or numbers.
+	Sometimes stamps are symettrical, so letting the user flip or mirror
+	them isn't useful.</p>
+
+	<p>To make a stamp un-flippable, add the option
+	"<code><b>noflip</b></code>" to the stamp's data file.</p>
+
+	<p>To keep a stamp from being mirrored, add the option
+	"<code><b>nomirror</b></code>" to the stamp's data file.</p>
+      </blockquote>
+
+
       <h4>Windows Users</h4>
       <blockquote>
 	<p>You can use NotePad or WordPad to create these file.
@@ -2126,6 +2161,27 @@ New Breed Software</p>
 	has "<code>.dat</code>" at the end, and not "<code>.txt</code>"...</p>
       </blockquote>
     </blockquote>
+
+    <h3>Pre-Mirrored Images</h3>
+    <blockquote>
+      <p>In some cases, you may wish to provide a pre-drawn version of
+      a stamp's mirror-image.  For example, imagine a picture of a fire
+      truck with the words "<i>Fire&nbsp;Department</i>" written across
+      the side.  You probably do not want that text to appear backwards
+      when the image is flipped!</p>
+
+      <p>To create a mirrored version of a stamp that you want Tux&nbsp;Paint
+      to use, rather than mirroring one on its own, simply create a second
+      "<code>.png</code>" graphics file with the same name, except with
+      the string "<code><b>_mirror</b></code>" before the filename
+      extension.</p>
+      
+      <p>For example, for the stamp "<code><b>truck.png</b></code>" you would
+      create another file named "<code><b>truck_mirror.png</b></code>", which
+      will be used when the stamp is mirrored (rather than using a
+      backwards version of '<code>truck.png</code>').</p>
+    </blockquote>
+    
   </blockquote>
   
   <hr size=1 noshade>