org.apache.batik.ext.awt.image.codec.util

Interface ImageDecoder

public interface ImageDecoder

An interface describing objects that transform an InputStream into a BufferedImage or Raster.
Method Summary
RasterdecodeAsRaster()
Returns a Raster that contains the decoded contents of the SeekableStream associated with this ImageDecoder.
RasterdecodeAsRaster(int page)
Returns a Raster that contains the decoded contents of the SeekableStream associated with this ImageDecoder.
RenderedImagedecodeAsRenderedImage()
Returns a RenderedImage that contains the decoded contents of the SeekableStream associated with this ImageDecoder.
RenderedImagedecodeAsRenderedImage(int page)
Returns a RenderedImage that contains the decoded contents of the SeekableStream associated with this ImageDecoder.
SeekableStreamgetInputStream()
Returns the SeekableStream associated with this ImageDecoder.
intgetNumPages()
Returns the number of pages present in the current stream.
ImageDecodeParamgetParam()
Returns the current parameters as an instance of the ImageDecodeParam interface.
voidsetParam(ImageDecodeParam param)
Sets the current parameters to an instance of the ImageDecodeParam interface.

Method Detail

decodeAsRaster

public Raster decodeAsRaster()
Returns a Raster that contains the decoded contents of the SeekableStream associated with this ImageDecoder. Only the first page of a multi-page image is decoded.

decodeAsRaster

public Raster decodeAsRaster(int page)
Returns a Raster that contains the decoded contents of the SeekableStream associated with this ImageDecoder. The given page of a multi-page image is decoded. If the page does not exist, an IOException will be thrown. Page numbering begins at zero.

Parameters: page The page to be decoded.

decodeAsRenderedImage

public RenderedImage decodeAsRenderedImage()
Returns a RenderedImage that contains the decoded contents of the SeekableStream associated with this ImageDecoder. Only the first page of a multi-page image is decoded.

decodeAsRenderedImage

public RenderedImage decodeAsRenderedImage(int page)
Returns a RenderedImage that contains the decoded contents of the SeekableStream associated with this ImageDecoder. The given page of a multi-page image is decoded. If the page does not exist, an IOException will be thrown. Page numbering begins at zero.

Parameters: page The page to be decoded.

getInputStream

public SeekableStream getInputStream()
Returns the SeekableStream associated with this ImageDecoder.

getNumPages

public int getNumPages()
Returns the number of pages present in the current stream.

getParam

public ImageDecodeParam getParam()
Returns the current parameters as an instance of the ImageDecodeParam interface. Concrete implementations of this interface will return corresponding concrete implementations of the ImageDecodeParam interface. For example, a JPEGImageDecoder will return an instance of JPEGDecodeParam.

setParam

public void setParam(ImageDecodeParam param)
Sets the current parameters to an instance of the ImageDecodeParam interface. Concrete implementations of ImageDecoder may throw a RuntimeException if the param argument is not an instance of the appropriate subclass or subinterface. For example, a JPEGImageDecoder will expect param to be an instance of JPEGDecodeParam.
Copyright B) 2008 Apache Software Foundation. All Rights Reserved.