Author: damjan
Date: Thu Dec 15 02:34:44 2011
New Revision: 1214602
URL: http://svn.apache.org/viewvc?rev=1214602&view=rev
Log:
Some changes in preparation for the next (0.98) release.
Modified:
commons/proper/sanselan/trunk/RELEASE_NOTES
commons/proper/sanselan/trunk/pom.xml
commons/proper/sanselan/trunk/src/site/xdoc/download_sanselan.xml
commons/proper/sanselan/trunk/src/site/xdoc/formatsupport.xml
Modified: commons/proper/sanselan/trunk/RELEASE_NOTES
URL:
http://svn.apache.org/viewvc/commons/proper/sanselan/trunk/RELEASE_NOTES?rev=1214602&r1=1214601&r2=1214602&view=diff
==============================================================================
--- commons/proper/sanselan/trunk/RELEASE_NOTES (original)
+++ commons/proper/sanselan/trunk/RELEASE_NOTES Thu Dec 15 02:34:44 2011
@@ -12,7 +12,7 @@ http://commons.apache.org/sanselan/
Version History:
----------------
-Next Release
+Release 0.98
------------
* SANSELAN-44 - JpegImageMetadata getEXIFThumbnail may raise a null pointer
exception
* Fixed a problem in the metadata example code not using exact matching for
GPS values.
@@ -26,6 +26,22 @@ Next Release
* Fixed a couple of platform-dependent paths in the tests.
* Constant-ized the magic numbers used when guessing formats.
* Added a test for the format guessing.
+ * Improvements to ICO parsing and support for PNG images in ICO files.
+ * Added support for the ICNS icon format.
+ * Added support for the PCX and DCX image formats.
+ * Improvements to BMP parsing.
+ * Added support for the WBMP format.
+ * Added support for reading simple baseline YCbCr JPEG images.
+ * Added support for XBM and XPM images.
+ * SANSELAN-54 - TIFF float and double values are written in the wrong
byteorder.
+ * SANSELAN-52 - fixed PNG transparency in getImageInfo().
+ * SANSELAN-13, SANSELAN-47, SANSELAN-55, others - made TIFF tag parsing a lot
+ more rigorous, allowing EXIF to be read even from very corrupt files.
+ * Added the ability to read comments from a JPEG file using getImageInfo().
+ * Added support for compression=2 TIFF images.
+ * SANSELAN-46 - allowed all Sanselan tests to pass.
+ * SANSELAN-59 - deleted confusing redefinition of some constants.
+ * Altered TIFF tag searching to do an exact directory match when possible.
Release 0.97
------------
Modified: commons/proper/sanselan/trunk/pom.xml
URL:
http://svn.apache.org/viewvc/commons/proper/sanselan/trunk/pom.xml?rev=1214602&r1=1214601&r2=1214602&view=diff
==============================================================================
--- commons/proper/sanselan/trunk/pom.xml (original)
+++ commons/proper/sanselan/trunk/pom.xml Thu Dec 15 02:34:44 2011
@@ -68,6 +68,9 @@
<commons.jira.id>SANSELAN</commons.jira.id>
<commons.jira.pid>12310720</commons.jira.pid>
<commons.osgi.export>org.apache.sanselan.*;version=${project.version};-noimport:=true</commons.osgi.export>
+ <commons.binary.suffix />
+ <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+ <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>
<build>
Modified: commons/proper/sanselan/trunk/src/site/xdoc/download_sanselan.xml
URL:
http://svn.apache.org/viewvc/commons/proper/sanselan/trunk/src/site/xdoc/download_sanselan.xml?rev=1214602&r1=1214601&r2=1214602&view=diff
==============================================================================
--- commons/proper/sanselan/trunk/src/site/xdoc/download_sanselan.xml (original)
+++ commons/proper/sanselan/trunk/src/site/xdoc/download_sanselan.xml Thu Dec
15 02:34:44 2011
@@ -95,32 +95,32 @@ limitations under the License.
</p>
</subsection>
</section>
- <section name="Commons Sanselan incubating-0.97 ">
+ <section name="Commons Sanselan 0.98 ">
<subsection name="Binaries">
<table>
<tr>
- <td><a
href="[preferred]/commons/sanselan/binaries/apache-sanselan-incubating-0.97-bin.tar.gz">apache-sanselan-incubating-0.97-bin.tar.gz</a></td>
- <td><a
href="http://www.apache.org/dist/commons/sanselan/binaries/apache-sanselan-incubating-0.97-bin.tar.gz.md5";>md5</a></td>
- <td><a
href="http://www.apache.org/dist/commons/sanselan/binaries/apache-sanselan-incubating-0.97-bin.tar.gz.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/sanselan/binaries/commons-sanselan-0.98-bin.tar.gz">commons-sanselan-0.98-bin.tar.gz</a></td>
+ <td><a
href="http://www.apache.org/dist/commons/sanselan/binaries/commons-sanselan-0.98-bin.tar.gz.md5";>md5</a></td>
+ <td><a
href="http://www.apache.org/dist/commons/sanselan/binaries/commons-sanselan-0.98-bin.tar.gz.asc";>pgp</a></td>
</tr>
<tr>
- <td><a
href="[preferred]/commons/sanselan/binaries/apache-sanselan-incubating-0.97-bin.zip">apache-sanselan-incubating-0.97-bin.zip</a></td>
- <td><a
href="http://www.apache.org/dist/commons/sanselan/binaries/apache-sanselan-incubating-0.97-bin.zip.md5";>md5</a></td>
- <td><a
href="http://www.apache.org/dist/commons/sanselan/binaries/apache-sanselan-incubating-0.97-bin.zip.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/sanselan/binaries/commons-sanselan-0.98-bin.zip">commons-sanselan-0.98-bin.zip</a></td>
+ <td><a
href="http://www.apache.org/dist/commons/sanselan/binaries/commons-sanselan-0.98-bin.zip.md5";>md5</a></td>
+ <td><a
href="http://www.apache.org/dist/commons/sanselan/binaries/commons-sanselan-0.98-bin.zip.asc";>pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
- <td><a
href="[preferred]/commons/sanselan/source/apache-sanselan-incubating-0.97-src.tar.gz">apache-sanselan-incubating-0.97-src.tar.gz</a></td>
- <td><a
href="http://www.apache.org/dist/commons/sanselan/source/apache-sanselan-incubating-0.97-src.tar.gz.md5";>md5</a></td>
- <td><a
href="http://www.apache.org/dist/commons/sanselan/source/apache-sanselan-incubating-0.97-src.tar.gz.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/sanselan/source/commons-sanselan-0.98-src.tar.gz">commons-sanselan-0.98-src.tar.gz</a></td>
+ <td><a
href="http://www.apache.org/dist/commons/sanselan/source/commons-sanselan-0.98-src.tar.gz.md5";>md5</a></td>
+ <td><a
href="http://www.apache.org/dist/commons/sanselan/source/commons-sanselan-0.98-src.tar.gz.asc";>pgp</a></td>
</tr>
<tr>
- <td><a
href="[preferred]/commons/sanselan/source/apache-sanselan-incubating-0.97-src.zip">apache-sanselan-incubating-0.97-src.zip</a></td>
- <td><a
href="http://www.apache.org/dist/commons/sanselan/source/apache-sanselan-incubating-0.97-src.zip.md5";>md5</a></td>
- <td><a
href="http://www.apache.org/dist/commons/sanselan/source/apache-sanselan-incubating-0.97-src.zip.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/sanselan/source/commons-sanselan-0.98-src.zip">commons-sanselan-0.98-src.zip</a></td>
+ <td><a
href="http://www.apache.org/dist/commons/sanselan/source/commons-sanselan-0.98-src.zip.md5";>md5</a></td>
+ <td><a
href="http://www.apache.org/dist/commons/sanselan/source/commons-sanselan-0.98-src.zip.asc";>pgp</a></td>
</tr>
</table>
</subsection>
Modified: commons/proper/sanselan/trunk/src/site/xdoc/formatsupport.xml
URL:
http://svn.apache.org/viewvc/commons/proper/sanselan/trunk/src/site/xdoc/formatsupport.xml?rev=1214602&r1=1214601&r2=1214602&view=diff
==============================================================================
--- commons/proper/sanselan/trunk/src/site/xdoc/formatsupport.xml (original)
+++ commons/proper/sanselan/trunk/src/site/xdoc/formatsupport.xml Thu Dec 15
02:34:44 2011
@@ -22,7 +22,7 @@ limitations under the License.
</properties>
<body>
<!-- ================================================== -->
-<section name="Format Support">
+<section name="Image Format Support">
<table>
<tr>
@@ -33,16 +33,16 @@ limitations under the License.
<th>References</th>
</tr>
- <!-- PNG Format -->
+ <!-- BMP Format -->
<tr>
- <td>PNG</td><td>yes</td><td>yes</td>
+ <td>BMP</td><td>yes</td><td>yes</td>
<td>
- Supported through version 1.2/ISO/IEC standard (15948:2003).
+ Mostly Complete. May not read some cursors, icons and OS/2 bitmaps.
Controlling the exact format when writing is incomplete.
</td>
<td>
- <a href="http://www.libpng.org/pub/png/";>spec</a>
- <a
href="http://en.wikipedia.org/wiki/Portable_Network_Graphics";>wikipedia</a>
+ No spec, see:
+ <a href="http://en.wikipedia.org/wiki/Windows_bitmap";>wikipedia</a>
</td>
</tr>
@@ -60,30 +60,14 @@ limitations under the License.
</td>
</tr>
- <!-- TIFF Format -->
- <tr>
- <td>TIFF</td><td>yes</td><td>yes</td>
- <td>
- Supported through version 6.0. TIFFs is a open-ended container format,
so it's not
- possible to support every possibly variation. JPEG-compressed TIFFs
are not supported.
- Supports Bi-Level, Palette/Indexed, RGB, CMYK, YCbCr, CIELab and
LOGLUV images.
- Supports LZW, CCITT/Huffman and Packbits/RLE compression. Notably
missing other forms
- of compression, though, including CCITT 4 and 6 bilevel and JPEG.
- Supports Tiled images.
- </td>
- <td>
- <a
href="http://partners.adobe.com/public/developer/tiff/index.html";>Adobe</a>
- <a
href="http://partners.adobe.com/public/developer/en/tiff/TIFF6.pdf";>spec</a>
- <a href="http://en.wikipedia.org/wiki/TIFF";>wikipedia</a>
- <a href="http://www.awaresystems.be/imaging/tiff/tifftags.html";>AWare
Systems TIFF Tag Reference</a>
- </td>
- </tr>
-
<!-- JPEG/JFIF Format -->
<tr>
- <td>JPEG/JFIF</td><td>no</td><td>no</td>
+ <td>JPEG/JFIF</td><td>some</td><td>no</td>
<td>
+ Reads only simple grayscale and YCbCr baseline sequential JPEG images
without RST markers,
+ which must use 8 bits per component and be Huffman encoded.
Can read image info, metadata and extract ICC Profiles. Both JFIF and
DCF/EXIF.
+ Provides JPEG comments in ImageInfo.
</td>
<td>
<a href="http://www.jpeg.org/public/jfif.pdf";>JFIF spec</a>
@@ -92,68 +76,66 @@ limitations under the License.
</td>
</tr>
- <!-- JPEG/JFIF EXIF Metadata -->
+ <!-- ICNS Format -->
<tr>
- <td>JPEG/JFIF EXIF Metadata</td><td>yes</td><td>yes</td>
+ <td>ICNS</td><td>mostly</td><td>mostly</td>
<td>
- Can read and write EXIF data to and from exsiting JPEG/JFIF files
WITHOUT modifying image data.
+ Missing support for JPEG2000 icons, but all other formats and sizes
are correctly read and written.
+ Extensively tested for correctness against MacOS X, including behavior
with missing masks.
</td>
<td>
- <a href="http://www.exif.org/";>Exif Specs, etc.</a>
- <a href="http://en.wikipedia.org/wiki/Exif";>wikipedia</a>
- <a href="http://www.awaresystems.be/imaging/tiff/tifftags.html";>AWare
Systems TIFF Tag Reference</a> (JPEG EXIF metadata is stored in TIFF
directories)
- <a href="http://www.sno.phy.queensu.ca/~phil/exiftool/index.html";>Phil
Harvey's exiftool and metadata reference</a>
- <a
href="http://www.sno.phy.queensu.ca/~phil/exiftool/writing.html";>Phil Harvey on
writing EXIF</a>
+ <a href="http://en.wikipedia.org/wiki/Apple_Icon_Image";>wikipedia</a>
</td>
</tr>
- <!-- JPEG/JFIF IPTC Metadata -->
+ <!-- ICO/CUR Format -->
<tr>
- <td>JPEG/JFIF IPTC Metadata</td><td>yes</td><td>soon</td>
+ <td>ICO/CUR</td><td>yes</td><td>mostly</td>
<td>
- Can read IPTC data from exsiting JPEG/JFIF files WITHOUT modifying
image data.
+ Reads 1/4/8/16/24/32 bpp .ico and .cur files. Supports the new Windows
Vista ICO files with embedded PNGs.
+ Deals correctly with alpha vs bitmask transparency issues in 32 bpp.
Supports bitfield compressed bitmaps.
+ Extensively tested. Probably the best open-source implementation under
the sun.
</td>
<td>
- <a href="http://www.iptc.org/cms/site/index.html?channel=CH0108";>IPTC
Specs, etc.</a>
- <a
href="http://en.wikipedia.org/wiki/IPTC_(image_meta-data)">wikipedia</a>
- <a
href="http://www2.computer.org/portal/web/csdl/doi/10.1109/MMUL.2005.50";>IEEE
article</a>
+ No spec, see:
+ <a
href="http://en.wikipedia.org/wiki/ICO_(icon_image_file_format)">wikipedia</a>
</td>
</tr>
- <!-- BMP Format -->
+ <!-- PCX/DCX -->
<tr>
- <td>BMP</td><td>yes</td><td>yes</td>
+ <td>PCX/DCX</td><td>yes</td><td>yes</td>
<td>
- Mostly Complete. May not read some cursors, icons and OS/2 bitmaps.
- Controlling the exact format when writing is incomplete.
+ Reads 1 plane 1/2/4/8 bit, 1 bit 1/2/3/4 plane, 3 plane 8 bit, 1 plane
24 bit, and 1 plane 32 bit images.
+ Monochrome is parsed correctly. Reads and can write the undocumented
uncompressed PCX format.
+ Reading short DCX tables is supported. Thoroughly tested.
</td>
<td>
- No spec, see:
- <a href="http://en.wikipedia.org/wiki/Windows_bitmap";>wikipedia</a>
</td>
</tr>
- <!-- ico Format -->
+ <!-- PNM/PGM/PBM/PPM Portable Pixmap -->
<tr>
- <td>ico</td><td>yes</td><td>no</td>
+ <td>PNM/PGM/PBM/PPM Portable Pixmap</td><td>yes</td><td>yes</td>
<td>
- Not complete. Can do simple reads.
+ Complete.
</td>
<td>
No spec, see:
- <a
href="http://en.wikipedia.org/wiki/ICO_(icon_image_file_format)">wikipedia</a>
+ <a href="http://en.wikipedia.org/wiki/Portable_pixmap";>wikipedia</a>
</td>
</tr>
- <!-- PNM/PGM/PBM/PPM Portable Pixmap -->
+ <!-- PNG Format -->
<tr>
- <td>PNM/PGM/PBM/PPM Portable Pixmap</td><td>yes</td><td>yes</td>
+ <td>PNG</td><td>yes</td><td>yes</td>
<td>
- Complete.
+ Supported through version 1.2/ISO/IEC standard (15948:2003).
+ Controlling the exact format when writing is incomplete.
</td>
<td>
- No spec, see:
- <a href="http://en.wikipedia.org/wiki/Portable_pixmap";>wikipedia</a>
+ <a href="http://www.libpng.org/pub/png/";>spec</a>
+ <a
href="http://en.wikipedia.org/wiki/Portable_Network_Graphics";>wikipedia</a>
</td>
</tr>
@@ -171,6 +153,106 @@ limitations under the License.
</td>
</tr>
+ <!-- TIFF Format -->
+ <tr>
+ <td>TIFF</td><td>yes</td><td>yes</td>
+ <td>
+ Supported through version 6.0. TIFFs is a open-ended container format,
so it's not
+ possible to support every possibly variation. JPEG-compressed TIFFs
are not supported.
+ Supports Bi-Level, Palette/Indexed, RGB, CMYK, YCbCr, CIELab and
LOGLUV images.
+ Supports LZW, CCITT/Huffman and Packbits/RLE compression. Notably
missing other forms
+ of compression, though, including CCITT 4 and 6 bilevel and JPEG.
+ Supports Tiled images.
+ </td>
+ <td>
+ <a
href="http://partners.adobe.com/public/developer/tiff/index.html";>Adobe</a>
+ <a
href="http://partners.adobe.com/public/developer/en/tiff/TIFF6.pdf";>spec</a>
+ <a href="http://en.wikipedia.org/wiki/TIFF";>wikipedia</a>
+ <a href="http://www.awaresystems.be/imaging/tiff/tifftags.html";>AWare
Systems TIFF Tag Reference</a>
+ </td>
+ </tr>
+
+ <!-- WBMP Format -->
+ <tr>
+ <td>WBMP</td><td>yes</td><td>yes</td>
+ <td>
+ Complete support for WBMP type 0 bitmaps.
+ </td>
+ <td>
+ <a href="http://en.wikipedia.org/wiki/WBMP";>wikipedia</a>
+ <a
href="http://www.wapforum.org/what/technical/SPEC-WAESpec-19990524.pdf";>spec</a>
+ </td>
+ </tr>
+
+ <!-- XBM Format -->
+ <tr>
+ <td>XBM</td><td>yes</td><td>yes</td>
+ <td>
+ Complete.
+ </td>
+ <td>
+ <a href="http://en.wikipedia.org/wiki/XBM";>wikipedia</a>
+ <a href="www.xfree86.org/current/xlib.pdf">spec</a>
+ </td>
+ </tr>
+
+ <!-- XPM Format -->
+ <tr>
+ <td>XPM</td><td>mostly</td><td>yes</td>
+ <td>
+ Only XPM version 3 is currently supported, but the other versions are
obsolete.
+ Reads XPM files, except those with colors given by rgb.txt name.
Writing only writes color data.
+ </td>
+ <td>
+ <a href="http://en.wikipedia.org/wiki/X_PixMap";>wikipedia</a>
+ <a href="http://www.xfree86.org/current/xpm.pdf";>spec</a>
+ </td>
+ </tr>
+</table>
+
+</section>
+
+<!-- ================================================== -->
+
+<section name="Metadata Format Support">
+
+<table>
+ <tr>
+ <th>Format</th>
+ <th>Read</th>
+ <th>Write</th>
+ <th>Notes</th>
+ <th>References</th>
+ </tr>
+
+ <!-- JPEG/JFIF EXIF Metadata -->
+ <tr>
+ <td>JPEG/JFIF EXIF Metadata</td><td>yes</td><td>yes</td>
+ <td>
+ Can read and write EXIF data to and from exsiting JPEG/JFIF files
WITHOUT modifying image data.
+ </td>
+ <td>
+ <a href="http://www.exif.org/";>Exif Specs, etc.</a>
+ <a href="http://en.wikipedia.org/wiki/Exif";>wikipedia</a>
+ <a href="http://www.awaresystems.be/imaging/tiff/tifftags.html";>AWare
Systems TIFF Tag Reference</a> (JPEG EXIF metadata is stored in TIFF
directories)
+ <a href="http://www.sno.phy.queensu.ca/~phil/exiftool/index.html";>Phil
Harvey's exiftool and metadata reference</a>
+ <a
href="http://www.sno.phy.queensu.ca/~phil/exiftool/writing.html";>Phil Harvey on
writing EXIF</a>
+ </td>
+ </tr>
+
+ <!-- JPEG/JFIF IPTC Metadata -->
+ <tr>
+ <td>JPEG/JFIF IPTC Metadata</td><td>yes</td><td>soon</td>
+ <td>
+ Can read IPTC data from exsiting JPEG/JFIF files WITHOUT modifying
image data.
+ </td>
+ <td>
+ <a href="http://www.iptc.org/cms/site/index.html?channel=CH0108";>IPTC
Specs, etc.</a>
+ <a
href="http://en.wikipedia.org/wiki/IPTC_(image_meta-data)">wikipedia</a>
+ <a
href="http://www2.computer.org/portal/web/csdl/doi/10.1109/MMUL.2005.50";>IEEE
article</a>
+ </td>
+ </tr>
+
<!-- XMP Format -->
<tr>
<td>XMP</td><td>yes</td><td>yes</td>
@@ -184,9 +266,9 @@ limitations under the License.
<a
href="http://en.wikipedia.org/wiki/Extensible_Metadata_Platform";>wikipedia</a>
</td>
</tr>
-
</table>
</section>
+
</body>
</document>
![http://www.jpeg.org/public/jfif.pdf"](http://www.jpeg.org/public/jfif.pdf"){kind=link}