Package com.luciad.imaging

Class ALcdBasicImage.Configuration

java.lang.Object

com.luciad.imaging.ALcdImage.Configuration

com.luciad.imaging.ALcdBasicImage.Configuration

Enclosing class:

ALcdBasicImage

public static class ALcdBasicImage.Configuration
extends ALcdImage.Configuration

Describes the configuration of an ALcdBasicImage. Image configurations can be created using the supplied ALcdBasicImage.Configuration.Builder.

The key properties of a basic image are:

• Width and Height: the image's dimensions in pixel coordinates.
• Bounds: the image's extents in geographic coordinates.
• Semantics: describe the image's pixel interpretation and format.
• Image Reference: the image's reference.
• Tile column and row count, tile width and height: indicates if and how the image's internal representation is subdivided into tiles. When reading pixel data out of an image, aligning the reads to the image's tile grid typically results in improved performance.
• Pixel Size (X) and Pixel Size (Y): indicates the approximate size of the pixel along the related axis, measured in model coordinates.

Since:

2014.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ALcdBasicImage.Configuration.Builder	Builder for ALcdBasicImage.Configuration objects.

Method Summary

Modifier and Type	Method	Description
ALcdBasicImage.Configuration.Builder	asBuilder()	Creates a builder which is pre-initialized with the properties of this Configuration.
boolean	equals(Object o)
int	getHeight()	Returns the height of the image in pixels.
double	getPixelSizeX()	Returns the approximate size of a pixel of the image along the x axis, measured in model coordinates.
double	getPixelSizeY()	Returns the approximate size of a pixel of the image along the y axis, measured in model coordinates.
ELcdImageSamplingMode	getSamplingMode()	Returns the sampling mode of the image
int	getTileColumnCount()	Returns the width of the tile grid in the image.
int	getTileHeight()	Returns the height of the tiles in the image (in pixels).
Rectangle	getTilePixelBounds(int aTileX, int aTileY)	Retrieves the bounds in pixel coordinates for a single tile in the image.
int	getTileRowCount()	Returns the height of the tile grid in the image.
int	getTileWidth()	Returns the width of the tiles in the image (in pixels).
int	getWidth()	Returns the width of the image in pixels.
int	hashCode()
static ALcdBasicImage.Configuration.Builder	newBuilder()	Creates a new, uninitialized builder.
String	toString()

Methods inherited from class com.luciad.imaging.ALcdImage.Configuration

getBounds, getImageReference, getSemantics

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Details

getWidth

public int getWidth()

Returns the width of the image in pixels.

Returns:

the width of the image in pixels

getHeight

public int getHeight()

Returns the height of the image in pixels.

Returns:

the height of the image in pixels

getTileColumnCount

public int getTileColumnCount()

Returns the width of the tile grid in the image. For non-tiled images, the width is 1.

Returns:

the number of tile columns in the image

getTileRowCount

public int getTileRowCount()

Returns the height of the tile grid in the image. For non-tiled images, the height is 1.

Returns:

the number of tile rows in the image

getTileWidth

public int getTileWidth()

Returns the width of the tiles in the image (in pixels). If the image is not tiled, the dimensions are the same as those returned by getWidth() and getHeight().

Returns:

the width of the tiles in the image

getTileHeight

public int getTileHeight()

Returns the height of the tiles in the image (in pixels). If the image is not tiled, the dimensions are the same as those returned by getWidth() and getHeight().

Returns:

the height of the tiles in the image

getPixelSizeX

public double getPixelSizeX()

Returns the approximate size of a pixel of the image along the x axis, measured in model coordinates.

In case of point-sampled data this indicates the distance between 2 samples.

Returns:

the horizontal pixel size of the image

getPixelSizeY

public double getPixelSizeY()

Returns the approximate size of a pixel of the image along the y axis, measured in model coordinates.

In case of point-sampled data this indicates the distance between 2 samples.

Returns:

the vertical pixel size of the image

getTilePixelBounds

public Rectangle getTilePixelBounds(int aTileX,
 int aTileY)

Retrieves the bounds in pixel coordinates for a single tile in the image.

Parameters:

aTileX - the tile x coordinate in [0, columnCount[

aTileY - the tile y coordinate in [0, rowCount[

Returns:

the region

Throws:

IllegalArgumentException - if the tile coordinate is out of bounds

getSamplingMode

public ELcdImageSamplingMode getSamplingMode()

Returns the sampling mode of the image

Returns:

the sampling mode

equals

public boolean equals(Object o)

Overrides:

equals in class ALcdImage.Configuration

hashCode

public int hashCode()

Overrides:

hashCode in class ALcdImage.Configuration

toString

public String toString()

Overrides:

toString in class Object

newBuilder

public static ALcdBasicImage.Configuration.Builder newBuilder()

Creates a new, uninitialized builder.

Returns:

a new image configuration builder

asBuilder

public ALcdBasicImage.Configuration.Builder asBuilder()

Creates a builder which is pre-initialized with the properties of this Configuration. This allows the user to create a copy of a configuration and selectively modify properties.

Returns:

a builder initialized with the properties of this Configuration