• Wiki
• SVN repository
• Sanselan Incubation Status
• mailing list archive
• http://incubator.apache.org/sanselan
• https://issues.apache.org/jira/browse/SANSELAN

 
import org.cmc.sanselan.*;

BufferedImage someImage = null;
byte someBytes[] = null;
File someFile = null;
InputStream someInputStream = null;
OutputStream someOutputStream = null;

// The Sanselan class provides a simple interface to the library. 

// how to read an image: 
byte imageBytes[] = someBytes;
BufferedImage image_1 = Sanselan.getBufferedImage(imageBytes);

// methods of Sanselan usually accept files, byte arrays, or inputstreams as arguments. 
BufferedImage image_2 = Sanselan.getBufferedImage(imageBytes);
File file = someFile;
BufferedImage image_3 = Sanselan.getBufferedImage(file);
InputStream is = someInputStream;
BufferedImage image_4 = Sanselan.getBufferedImage(is);

// Write an image. 
BufferedImage image = someImage;
File dst = someFile;
ImageFormat format = ImageFormat.IMAGE_FORMAT_PNG;
Map optional_params = new Hashtable();
Sanselan.write(image, dst, format, optional_params);

OutputStream os = someOutputStream;
Sanselan.write(image, os, format, optional_params);

// get the image's embedded ICC Profile, if it has one. 
byte icc_profile_bytes[] = Sanselan.getICCProfileBytes(imageBytes);

ICC_Profile icc_profile = Sanselan.getICCProfile(imageBytes);

// get the image's width and height. 
Dimension d = Sanselan.getImageSize(imageBytes);

// get all of the image's info (ie. bits per pixel, size, transparency, etc.) 
ImageInfo image_info = Sanselan.getImageInfo(imageBytes);

if (image_info.getColorType() == ImageInfo.COLOR_TYPE_GRAYSCALE)
	System.out.println("Grayscale image.");
if (image_info.getHeight() > 1000)
	System.out.println("Large image.");

// try to guess the image's format. 
ImageFormat image_format = Sanselan.guessFormat(imageBytes);
image_format.equals(ImageFormat.IMAGE_FORMAT_PNG);

// get all metadata stored in EXIF format (ie. from JPEG or TIFF). 
// org.w3c.dom.Node node = Sanselan.getMetadataObsolete(imageBytes); 
IImageMetadata metdata = Sanselan.getMetadata(imageBytes);

// print a dump of information about an image to stdout. 
Sanselan.dumpImageFile(imageBytes);

// get a summary of format errors. 
FormatCompliance format_compliance = Sanselan
		.getFormatCompliance(imageBytes);

• SampleUsage.java (includes the above code)
• MetadataExample.java (illustrates how to find JPEG EXIF metadata such as GPS, date & time photo taken, etc.
• ImageWriteExample.java (illustrates how to write an image).
• ImageReadExample.java (illustrates how to write an image).
• WriteExifMetadataExample.java (illustrates how to update/insert/remove EXIF metadata from a Jpeg image).

• Fixed a couple of bugs around adding Exif data to files without an existing Exif segment. Thanks to Arnaud Mondit for finding this problem and providing a great bug report.

• Added some convenience functions for reading and writing GPS data. These are demonstrated in the metadata sample usage classes.

• Added EXIF insert/update/remove functionality. See WriteExifMetadataExample.java for examples.
• Rewrote JPEG and TIFF parsing.
• Greatly elaborated the unit test suite and test image suite. In the process found and resolved many bugs.
• Once again, I hope this is the last non-apache release. =)

• Restored original package structure. (org.apache.sanselan.* -> org.cmc.sanselan.*)
• Refactored "byte sources," improving performance reading image data from InputStreams.
• More code cleanup, mostly removing debugging code and applying naming conventions.
• Fixed two bugs around pngs: alpha channels weren't be written properly, and alpha channel was not being preserved when reading grayscale pngs.
• Improved javadocs.

• Fixed a number of bugs.
• Began adding javadocs, starting with the facade classes: Sanselan, and every class returned by its methods.
• This is probably the last pre-apache release.

• Fixed bug with writing grayscale pngs.
• Fixed bug with gamma correction when reading pngs.
• Added image read param that allows control over BufferedImage creation.
• Removed an erroneous javadoc.
• Minor cleanup.

• Cleaned up Tiff image parser and writer.
• Added compression parameter to tiff image writer.
• Added an example that illustrates image writing, optional parameters, etc.

• Fixed Tiff/Exif bug wherein rational number fields with a zero divisor prevented the metadata from being read, due to a "divide by zero" error.

• Fixed Tiff/Exif bug wherein Private IFD Tags were not being properly read.
• Added better metadata sample code.

• Complete refactor of the image metadata methods. See the new MetadataExample class for a simple example.
• Converted all of the Sanselan class's methods to static.
• Cleaned up some old code.

• Made a couple of methods of ImageInfo public (getColorType() and getColorTypeDescription()).

• I've begun a overhaul of the codebase in anticipation of becoming an Apache Incubator project.
• I've changed the package names (again) to be org.apache.sanselan.*.
• I've removed the dependency on sharedlib.
• I've removed a great deal of old cruft.
• I've begun to apply a consistent naming convention to variables (lowerCamelCase) and constant names (ALL_CAPS).

• I've fixed that pernicious bug in LZW compression. I've switched the default TIFF compression scheme back to LZW.
• TIFF uses an unusual variation of LZW. For details, see this article.
• In this case, the bug was: trailing EndOfInformation codes are sometimes omitted. That is, if a EndOfInformation code is the last code of a block, it may not appear.

• LZW compression is buggy; this only effects writing TIFF. I've switched the default TIFF compression scheme to packbits which performs worse until this can be corrected.

• I've open sourced the last dependency of this project, sharedlib.
• I've also renamed almost all of the package names. Sorry about this; a simple global search and replace should be easy to do.

• Refactor interface. Rename Sanselan methods and public class names. Formats should subclass imagemetadata class to include format-specific info ie. GIF's transparency index.
• More control over writing.
• Share test image suite with comments.
• Improve Javadoc & write more FAQs / examples.
• Allow user to disable autoconvesion to sRGB/Grayscale.
• Add support for more than 8 bits per channel.
• Reading all images from .gif files isn't working. see: getAllBufferedImages().
• Add request/hint params to ImageFactory, per Endre's suggestion.
• Add DNG metadata/image info read. Perhaps some RAW formats as well.
• Publish image library (possibly) and links to other libraries.
• Develop suite of unit tests that only depend on images in the public domain.