com.twelvemonkeys.imageio.plugins.iff

Class IFFImageReader

java.lang.Object

javax.imageio.ImageReader

com.twelvemonkeys.imageio.ImageReaderBase

com.twelvemonkeys.imageio.plugins.iff.IFFImageReader

public final class IFFImageReader
extends ImageReaderBase

Reader for Commodore Amiga (Electronic Arts) IFF ILBM (InterLeaved BitMap) and PBM format (Packed BitMap). Also supports IFF RGB8 (Impulse) and IFF DEEP (TVPaint). The IFF format (Interchange File Format) is the standard file format supported by allmost all image software for the Amiga computer.

This reader supports the original palette-based 1-8 bit formats, including EHB (Extra Half-Bright), HAM (Hold and Modify), and the more recent "deep" formats, 8 bit gray, 24 bit RGB and 32 bit ARGB. Uncompressed and ByteRun1 compressed (run length encoding) files are supported.

Palette based images are read as BufferedImage of TYPE_BYTE_INDEXED or BufferedImage# depending on the bit depth. Gray images are read as TYPE_BYTE_GRAY. 24 bit true-color images are read as TYPE_3BYTE_BGR. 32 bit true-color images are read as TYPE_4BYTE_ABGR.

Issues: HAM and HAM8 (Hold and Modify) formats are converted to RGB (24 bit), as it seems to be very hard to create an IndexColorModel subclass that would correctly describe these formats. These formats utilizes the special display hardware in the Amiga computers. HAM (6 bits) needs 12 bits storage/pixel, if unpacked to RGB (4 bits/gun). HAM8 (8 bits) needs 18 bits storage/pixel, if unpacked to RGB (6 bits/gun). See Wikipedia: HAM for more information.
EHB palette is expanded to an IndexColorModel with 64 entries. See Wikipedia: EHB for more information.

Version:

$Id: IFFImageReader.java,v 1.0 29.aug.2004 20:26:58 haku Exp $

Author:

Harald Kuhr, last modified by $Author: haku $

See Also:

Wikipedia: IFF, Wikipedia: IFF ILBM

Field Summary

Fields inherited from class com.twelvemonkeys.imageio.ImageReaderBase

imageInput

Fields inherited from class javax.imageio.ImageReader

availableLocales, ignoreMetadata, input, locale, minIndex, originatingProvider, progressListeners, seekForwardOnly, updateListeners, warningListeners, warningLocales

Method Summary

Modifier and Type	Method and Description
int	getHeight(int imageIndex)
IIOMetadata	getImageMetadata(int imageIndex)
Iterator<ImageTypeSpecifier>	getImageTypes(int imageIndex)
int	getNumThumbnails(int imageIndex)
ImageTypeSpecifier	getRawImageType(int pIndex)
int	getThumbnailHeight(int imageIndex, int thumbnailIndex)
int	getThumbnailWidth(int imageIndex, int thumbnailIndex)
int	getWidth(int imageIndex)
boolean	hasThumbnails(int imageIndex)
static void	main(String[] args)
BufferedImage	read(int imageIndex, ImageReadParam param)
boolean	readerSupportsThumbnails()
BufferedImage	readThumbnail(int imageIndex, int thumbnailIndex)
protected void	resetMembers()

Methods inherited from class com.twelvemonkeys.imageio.ImageReaderBase

assertInput, checkBounds, dispose, fakeAOI, fakeSubsampling, getDestination, getNumImages, getStreamMetadata, hasExplicitDestination, reset, setInput, showIt

Methods inherited from class javax.imageio.ImageReader

abort, abortRequested, addIIOReadProgressListener, addIIOReadUpdateListener, addIIOReadWarningListener, canReadRaster, checkReadParamBandSettings, clearAbortRequest, computeRegions, getAspectRatio, getAvailableLocales, getDefaultReadParam, getFormatName, getImageMetadata, getInput, getLocale, getMinIndex, getOriginatingProvider, getSourceRegion, getStreamMetadata, getTileGridXOffset, getTileGridYOffset, getTileHeight, getTileWidth, isIgnoringMetadata, isImageTiled, isRandomAccessEasy, isSeekForwardOnly, processImageComplete, processImageProgress, processImageStarted, processImageUpdate, processPassComplete, processPassStarted, processReadAborted, processSequenceComplete, processSequenceStarted, processThumbnailComplete, processThumbnailPassComplete, processThumbnailPassStarted, processThumbnailProgress, processThumbnailStarted, processThumbnailUpdate, processWarningOccurred, processWarningOccurred, read, readAll, readAll, readAsRenderedImage, readRaster, readTile, readTileRaster, removeAllIIOReadProgressListeners, removeAllIIOReadUpdateListeners, removeAllIIOReadWarningListeners, removeIIOReadProgressListener, removeIIOReadUpdateListener, removeIIOReadWarningListener, setInput, setInput, setLocale

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

resetMembers

protected void resetMembers()

Specified by:

resetMembers in class ImageReaderBase

read

public BufferedImage read(int imageIndex,
                          ImageReadParam param)
                   throws IOException

Specified by:

read in class ImageReader

Throws:

IOException

readerSupportsThumbnails

public boolean readerSupportsThumbnails()

Overrides:

readerSupportsThumbnails in class ImageReader

hasThumbnails

public boolean hasThumbnails(int imageIndex)
                      throws IOException

Overrides:

hasThumbnails in class ImageReader

Throws:

IOException

getNumThumbnails

public int getNumThumbnails(int imageIndex)
                     throws IOException

Overrides:

getNumThumbnails in class ImageReader

Throws:

IOException

getThumbnailWidth

public int getThumbnailWidth(int imageIndex,
                             int thumbnailIndex)
                      throws IOException

Overrides:

getThumbnailWidth in class ImageReader

Throws:

IOException

getThumbnailHeight

public int getThumbnailHeight(int imageIndex,
                              int thumbnailIndex)
                       throws IOException

Overrides:

getThumbnailHeight in class ImageReader

Throws:

IOException

readThumbnail

public BufferedImage readThumbnail(int imageIndex,
                                   int thumbnailIndex)
                            throws IOException

Overrides:

readThumbnail in class ImageReader

Throws:

IOException

getWidth

public int getWidth(int imageIndex)
             throws IOException

Specified by:

getWidth in class ImageReader

Throws:

IOException

getHeight

public int getHeight(int imageIndex)
              throws IOException

Specified by:

getHeight in class ImageReader

Throws:

IOException

getImageMetadata

public IIOMetadata getImageMetadata(int imageIndex)
                             throws IOException

Overrides:

getImageMetadata in class ImageReaderBase

Throws:

IOException

getImageTypes

public Iterator<ImageTypeSpecifier> getImageTypes(int imageIndex)
                                           throws IOException

Specified by:

getImageTypes in class ImageReader

Throws:

IOException

getRawImageType

public ImageTypeSpecifier getRawImageType(int pIndex)
                                   throws IOException

Overrides:

getRawImageType in class ImageReader

Throws:

IOException

main

public static void main(String[] args)