Class ALcdImageMosaic.Configuration
 Enclosing class:
ALcdImageMosaic
The key properties of an image mosaic are:
Semantics
: describe the image's pixel interpretation and format.Image Reference
: the image's model reference.Bounds
: the image's extents in geographic coordinates.Grid Bounds
: the image's grid extents in geographic coordinates.Column Count
: the number of tiles in this mosaic along the x axisRow Count
: the number of tiles in this mosaic along the x axisPixel Size X
: the approximate size of a pixel of the mosaic along the x axis, measured in model coordinates.Pixel Size Y
: the approximate size of a pixel of the mosaic along the y axis, measured in model coordinates.
 Since:
 2014.0

Nested Class Summary

Method Summary
Modifier and TypeMethodDescriptionCreates a builder which is preinitialized with the properties of thisConfiguration
.boolean
long
Returns the number of tiles in this mosaic along the x axis.final double
Returns the width of a single tile in model coordinates.final double
getColumnWidth
(long aColumn) Returns the width of a single tile in a particular column in model coordinates.double
Returns the approximate size of a pixel of the mosaic along the x axis, measured in model coordinates.double
Returns the approximate size of a pixel of the mosaic along the y axis, measured in model coordinates.long
Returns the number of tiles in this mosaic along the y axis.final double
Returns the height of a single tile in model coordinates.final double
getRowHeight
(long aRow) Returns the height of a single tile in a particular row in model coordinates.Returns the sampling mode of the image.Returns the tile grid bounds of this image.int
hashCode()
Creates a new builder which can be used to createConfiguration
objects.Methods inherited from class com.luciad.imaging.ALcdImage.Configuration
getBounds, getImageReference, getSemantics

Method Details

getColumnCount
public long getColumnCount()Returns the number of tiles in this mosaic along the x axis.This is also referred to as the number of tile columns.
 Returns:
 the number of tile along the x direction.

getRowCount
public long getRowCount()Returns the number of tiles in this mosaic along the y axis.This is also referred to as the number of tile rows.
 Returns:
 the number of tiles along the y direction

getColumnWidth
public final double getColumnWidth()Returns the width of a single tile in model coordinates.Note that the tiles in the first and last column may be smaller as indicated by
getTileGridBounds()
. You can usegetColumnWidth(long)
to conveniently compute the width of a particular column. Returns:
 the width of a single tile in model coordinates
 See Also:

getRowHeight
public final double getRowHeight()Returns the height of a single tile in model coordinates.Note that the tiles in the first and last row may be smaller as indicated by
getTileGridBounds()
. You can usegetRowHeight(long)
to conveniently compute the height of a particular row. Returns:
 the height of a single tile in model coordinates

getColumnWidth
public final double getColumnWidth(long aColumn) Returns the width of a single tile in a particular column in model coordinates.The width of a column is:
 first:
columnWidth  (bounds.minX  tileGridBounds.minX)
 last:
columnWidth  (tileGridBounds.maxX  bounds.maxX)
 others:
columnWidth
 Parameters:
aColumn
 the column in[0, getColumnCount[
 Returns:
 the width of a single tile in model coordinates
 See Also:
 first:

getRowHeight
public final double getRowHeight(long aRow) Returns the height of a single tile in a particular row in model coordinates.The height of a row is:
 first:
rowHeight  (bounds.minY  tileGridBounds.minY)
 last:
rowHeight  (tileGridBounds.maxY  bounds.maxY)
 others:
rowHeight
 Returns:
 the height of a single tile in model coordinates
 See Also:
 first:

getPixelSizeX
public double getPixelSizeX()Returns the approximate size of a pixel of the mosaic along the x axis, measured in model coordinates. The actual size of a pixel of the mosaic may vary, as not all tiles are required to have the same pixel resolution. Returns:
 the horizontal pixel size of the mosaic

getPixelSizeY
public double getPixelSizeY()Returns the approximate size of a pixel of the mosaic along the y axis, measured in model coordinates. The actual size of a pixel of the mosaic may vary, as not all tiles are required to have the same pixel resolution. Returns:
 the vertical pixel size of the mosaic

getSamplingMode
Returns the sampling mode of the image.All tiles of the mosaic use this sampling mode.
 Returns:
 the sampling mode

getTileGridBounds
Returns the tile grid bounds of this image.The tile grid bounds are the bounds of the uniform tile grid associated with this mosaic. The
geographic bounds
on the other hand indicate the bounds of all tiles in the mosaic. Typically they are exactly the same (e.g. all tiles cover the same geographic area in model units). For some formats (for example CADRG) the tiles at the edges can be smaller than other tiles. In that case the uniform tile grid is larger than the geographic bounds (e.g. the tile grid has some padding w.r.t. the geographic bounds).The tile grid bounds always fully contain the geographic bounds, but may be larger. A larger tile grid bounds indicates that some tiles at the edges of the mosaic are (geographically) smaller then other tiles. The tile grid bounds always covers exactly an area of
getColumnWidth()
bygetRowHeight()
. Hence, the width of the tile grid bounds isgetColumnWidth() * getColumnCount()
and its height isgetRowHeight() * getRowCount()
.As an example, consider a mosaic which covers the entire world with tiles that have a geographical area of 25 x 25 degrees. Such a mosaic would need 15 x 12 tiles. However, the last column of tiles would extend 15 degrees beyond the edge of the map (15 colums x 25 degrees = 375 degrees). In this case, the tile grid bounds would have a width of 375, but the mosaic's main bounds would be clamped to 360 degrees wide. This discrepancy can alert clients (e.g. painters) that the last column needs to be handled differently from the others.
You can use
getColumnWidth(long)
andgetRowHeight(long)
to conveniently compute the width or height of a particular row or column. Returns:
 the tile grid bounds

asBuilder
Creates a builder which is preinitialized with the properties of thisConfiguration
. 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

newBuilder
Creates a new builder which can be used to createConfiguration
objects. Returns:
 a new configuration builder

equals
 Overrides:
equals
in classALcdImage.Configuration

hashCode
public int hashCode() Overrides:
hashCode
in classALcdImage.Configuration
