------------------------------------------------------------
  Release Notes for Transform SWF for Java, Version 2.1.2.
------------------------------------------------------------

This a minor release fixing bugs.

Bug Fixes     
    FSImageConstructor: transparent, indexed, png files are now displayed correctly.     
    FSTextConstructor: Fixed bug in calculating the bounds of a block of text.
    FSTextConstructor: Fixed bug when creating font definitions on Macintoshes.
    FSTextConstructor: Character codes in font definitions are now set correctly.
    FSCoder: Fixed bug when expanding size of buffer on writes.     
 
Class Changes    
    Fixed Javadoc errors in documentation for FSTextConstructor and FSCharacterTable.     
 
Testing Changes    
    FSTextConstructorTest now displays bounding boxes around glyphs.     
  
Documentation Changes    
    Fixed Javadoc errors in documentation for FSTextConstructor and FSCharacterTable.     

Package Changes     
    Fixed bug in docs target of build.xml so utilities datasheets are generated.     
 
-------------
  Bug Fixes  
-------------

1. FSImageConstructor: transparent, indexed, png files are now displayed correctly.  

Transparent PNG files which were indexed rather than true colour would be 
displayed with an opaque background. The root cause was that the image format 
was not being updated to indicate alpha channel information was included when
the transparency block defined in the image was decoded. Now fixed. 

2. FSTextConstructor: Fixed bug in calculating the bounds of a block of text.  

The bounding box for blocks of text was not taking into account the ascent of 
the first line and the descent of the last line. Only the line spacing time the 
number of lines was used. While this was accurate it did not cover part of the 
last line of the text and so for text that was animated or placed close together
the last line would not be redrawn correctly. Now Fixed.

3. FSTextConstructor: Fixed bug when creating font definitions on Macintoshes.  

When an AWT Font object was decoded the font coordinates were being translated
so the glyph would fit within the EM Square. For Java code running on Windows or
linux this would work (though the translation was actually being ignored). 
However on Mac OS X the translation was being implemented. As a result glyphs 
were drawn outside of the bounding box and were not displayed correctly. Now
Fixed. 

4. FSTextConstructor: Character codes in font definitions are now set correctly.  

The character codes in a font definition were being set to the index of the 
glyph on the definition rather than the actual code for the character that the 
glyph represented. For static text this did not represent much of a problem
however text fields that used the font definition would not display correctly.
Now Fixed. 

5. FSCoder: Fixed bug when expanding size of buffer on writes.  

When writing a bit field within 32 bits of the end of the internal buffer 
used by the FSCoder object an ArrayIndexOutOfBoundsException would be thrown.
The buffer would not be resized to accomodate the overflow. Now Fixed. 

-----------------
  Class Changes  
-----------------

1. FSTextConstructor: added advanceForChar(char, int).  

Added advanceForChar(char c, int fontSize) method to FSTextConstrutor so 
individual characters can be laid out in a sequence rather than as a string. 
While it has some practical use it is currently used to lay out individual 
characters when testing the alignment of the bounding box with respect to the 
glyph outline.

-------------------
  Testing Changes  
-------------------

1. FSTextConstructorTest now displays bounding boxes around glyphs.  

A blue bounding box is now drawn around text generated when testing the 
FSTextConstructor class. This is used to check the alignment of the glyph 
outlines with the bounding box defined for the FSDefineText2 object that contains
the text.

-------------------------
  Documentation Changes  
-------------------------

1. Fixed Javadoc errors in documentation for FSTextConstructor and FSCharacterTable.  

Corrected errors in the method documentation for FSTextConstructor and 
FSCharacterTable.

-------------------
  Package Changes  
-------------------

1. Fixed bug in docs target of build.xml so utilities datasheets are generated.  

The 'docs' target in the Ant build file now generates Javadoc datasheets 
for all the classes in the package com.flagstone.transform.util.