com.luciad.format.raster

LuciadFusionInterface ILcdTile

All Known Subinterfaces:

ILcdSubtiledTile

All Known Implementing Classes:

TLcdBufferedTile, TLcdByteArrayTile, TLcdCADRGTile, TLcdClippedTile, TLcdDTEDTile, TLcdECRGTile, TLcdIntArrayTile, TLcdRenderedImageTile, TLcdShortArrayTile, TLcdUSRPTile

public interface ILcdTile

Important notice: the package com.luciad.imaging presents a new API for the modeling of raster data. For new projects, it is recommended to use this API instead of ILcdRaster et al. This interface represents a regular matrix of integer values.

A tile is defined over a rectangle in a discrete coordinate system. The tile width, height, and coordinates are expressed as integers. The x and y axes are pointing to the right and down, respectively. Tile coordinates (0, 0) correspond to the upper-left corner of the tile.

The interface defines methods for retrieving the tile contents as images or as individual values.

A tile can optionally have a color model that specifies how the tile values can be displayed.

Field Summary

Fields

Modifier and Type	Field and Description
static int	BYTE
static int	INT
static int	SHORT

Method Summary

Modifier and Type	Method and Description
Image	createImage() Creates an image of the entire tile, using the tile's own color model.
Image	createImage(ColorModel aColorModel) Creates an image of the entire tile, using the given color model.
Image	createImage(int aX, int aY, int aWidth, int aHeight) Creates an image of the specified rectangular area of the tile, using the tile's own color model.
Image	createImage(int aX, int aY, int aWidth, int aHeight, ColorModel aColorModel) Creates an image of the specified rectangular area of the tile, using the given color model.
ColorModel	getColorModel() Returns the optional color model of the tile.
int	getHeight() Returns the height of the tile, expressed in pixels.
int	getPixelSize() Returns the pixel size of the tile values, expressed in bits.
int	getType() Returns the internal storage type of the tile values.
int	getWidth() Returns the width of the tile, expressed in pixels.
boolean	isAllDefault() Returns whether all values in the tile are equal to a default value.
int	retrieveValue(int aX, int aY) Retrieves the tile value at the specified location.

Field Detail

BYTE

static final int BYTE

See Also:

Constant Field Values

SHORT

static final int SHORT

See Also:

Constant Field Values

INT

static final int INT

See Also:

Constant Field Values

Method Detail

getWidth

int getWidth()

Returns the width of the tile, expressed in pixels.

getHeight

int getHeight()

Returns the height of the tile, expressed in pixels.

getType

int getType()

Returns the internal storage type of the tile values.

Returns:

one of BYTE, SHORT, or INT.

getPixelSize

int getPixelSize()

Returns the pixel size of the tile values, expressed in bits.

getColorModel

ColorModel getColorModel()

Returns the optional color model of the tile.

Returns:

the color model, or null if the raster doesn't have an explicit color model.

isAllDefault

boolean isAllDefault()

Returns whether all values in the tile are equal to a default value.

retrieveValue

int retrieveValue(int aX,
                  int aY)

Retrieves the tile value at the specified location.

Parameters:

aX - the x ordinate of the value, expressed in tile coordinates.

aY - the y ordinate of the value, expressed in tile coordinates.

Returns:

the integer tile value at the specified location.

createImage

Image createImage()

Creates an image of the entire tile, using the tile's own color model.

createImage

Image createImage(ColorModel aColorModel)

Creates an image of the entire tile, using the given color model.

Parameters:

aColorModel - the color model to be used for the image. The color model should be compatible with the pixel values of the tile.

createImage

Image createImage(int aX,
                  int aY,
                  int aWidth,
                  int aHeight)

Creates an image of the specified rectangular area of the tile, using the tile's own color model.

Parameters:

aX - the x ordinate of the area, expressed in tile coordinates.

aY - the y ordinate of the area, expressed in tile coordinates.

aWidth - the width of the area, expressed in tile coordinates.

aHeight - the height of the area, expressed in tile coordinates.

createImage

Image createImage(int aX,
                  int aY,
                  int aWidth,
                  int aHeight,
                  ColorModel aColorModel)

Creates an image of the specified rectangular area of the tile, using the given color model.

Parameters:

aX - the x ordinate of the area, expressed in tile coordinates.

aY - the y ordinate of the area, expressed in tile coordinates.

aWidth - the width of the area, expressed in tile coordinates.

aHeight - the height of the area, expressed in tile coordinates.

aColorModel - the color model to be used for the image. The color model should be compatible with the pixel values of the tile.