Package com.luciad.format.raster

Class TLcdImageDecoder

java.lang.Object

com.luciad.format.raster.TLcdImageDecoder

All Implemented Interfaces:

ILcdTileDecoder, ImageObserver

public class TLcdImageDecoder
extends Object
implements ILcdTileDecoder, ImageObserver

TLcdImageDecoder is an ILcdTileDecoder for images supported by the platform's native implementation of the Toolkit, i.e., Toolkit.getDefaultToolkit(). There is no guarantee to the type of images supported by a given toolkit. Therefore, using TLcdImageDecoder makes your application platform specific to the extent that a format may be supported by one toolkit implementation, but not by the other.

This class is not thread safe. Create a new instance in every separate thread.

Field Summary

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
TLcdImageDecoder()

Method Summary

Modifier and Type	Method	Description
boolean	imageUpdate(Image img, int infoflags, int x, int y, int width, int height)	The following flags are checked: WIDTH and HEIGHT.
boolean	isTraceOn()	Deprecated. This method has been deprecated.
ILcdTileInfo	readTile(String aFileName, int aImageIndex, int aSubTileWidth, int aSubTileHeight, int aRowIndex, int aColumnIndex, ILcdBuffer aBuffer)	Reads a sub-tile from a file.
ILcdTileInfo	readTile(URL aURL, int aImageIndex, int aSubTileWidth, int aSubTileHeight, int aRowIndex, int aColumnIndex, ILcdBuffer aBuffer)	Reads a sub-tile from a URL.
static void	setClassTraceOn(boolean aClassTraceOn)	Deprecated. This method has been deprecated.
void	setTraceOn(boolean aTraceOn)	Deprecated. This method has been deprecated.

Methods inherited from class java.lang.Object

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

Constructor Details

TLcdImageDecoder

public TLcdImageDecoder()

Method Details

setClassTraceOn

public static void setClassTraceOn(boolean aClassTraceOn)

Deprecated.

This method has been deprecated. It is recommended to use the standard Java logging framework directly.

Enables tracing for all instances of this class. If the argument is true then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.

Parameters:

aClassTraceOn - if true then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.

setTraceOn

public void setTraceOn(boolean aTraceOn)

Deprecated.

This method has been deprecated. It is recommended to use the standard Java logging framework directly.

Enables tracing for this class instance. Calling this method with either true or false as argument automatically turns off tracing for all other class instances for which setTraceOn has not been called. If the argument is false then only the informative, warning and error log messages are recorded.

Parameters:

aTraceOn - if true then all log messages are recorded for this instance. If false, then only the informative, warning and error log messages are recorded.

isTraceOn

public boolean isTraceOn()

Deprecated.

This method has been deprecated. It is recommended to use the standard Java logging framework directly.

Returns true if tracing is enabled for this class.

Returns:

true if tracing is enabled for this class, false otherwise.

readTile

public ILcdTileInfo readTile(String aFileName,
 int aImageIndex,
 int aSubTileWidth,
 int aSubTileHeight,
 int aRowIndex,
 int aColumnIndex,
 ILcdBuffer aBuffer)
                      throws TLcdCodecException

Description copied from interface: ILcdTileDecoder

Reads a sub-tile from a file.

Specified by:

readTile in interface ILcdTileDecoder

Parameters:

aFileName - the name of the file containing the tile.

aImageIndex - the index of the tile in the given file (if applicable).

aSubTileWidth - the width of the sub-tiles, expressed in pixels.

aSubTileHeight - the height of the sub-tiles, expressed in pixels.

aRowIndex - the row number of the sub-tile to be decoded.

aColumnIndex - the column number of the sub-tile to be decoded.

aBuffer - the buffer in which the decoded bytes will be stored.

Returns:

ILcdTileInfo information about the decoded tile.

Throws:

TLcdCodecException - in case of decoding problems.

readTile

public ILcdTileInfo readTile(URL aURL,
 int aImageIndex,
 int aSubTileWidth,
 int aSubTileHeight,
 int aRowIndex,
 int aColumnIndex,
 ILcdBuffer aBuffer)
                      throws TLcdCodecException

Description copied from interface: ILcdTileDecoder

Reads a sub-tile from a URL.

Specified by:

readTile in interface ILcdTileDecoder

Parameters:

aURL - the URL containing the tile.

aImageIndex - the index of the tile in the given URL (if applicable).

aSubTileWidth - the width of the sub-tiles, expressed in pixels.

aSubTileHeight - the height of the sub-tiles, expressed in pixels.

aRowIndex - the row number of the sub-tile to be decoded.

aColumnIndex - the column number of the sub-tile to be decoded.

aBuffer - the buffer in which the decoded bytes will be stored.

Returns:

ILcdTileInfo information about the decoded tile.

Throws:

TLcdCodecException - in case of decoding problems.

imageUpdate

public boolean imageUpdate(Image img,
 int infoflags,
 int x,
 int y,
 int width,
 int height)

The following flags are checked: WIDTH and HEIGHT.

Specified by:

imageUpdate in interface ImageObserver