public static class ALcdImageMosaic.Configuration extends ALcdImage.Configuration
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.Modifier and Type | Class and Description |
---|---|
static class |
ALcdImageMosaic.Configuration.Builder
Builder for ALcdImageMosaic.Configuration objects.
|
Modifier and Type | Method and Description |
---|---|
ALcdImageMosaic.Configuration.Builder |
asBuilder()
Creates a builder which is pre-initialized with the properties of this
Configuration . |
boolean |
equals(Object o) |
long |
getColumnCount()
Returns the number of tiles in this mosaic along the x axis.
|
double |
getColumnWidth()
Returns the width of a single tile in model coordinates.
|
double |
getColumnWidth(long aColumn)
Returns the width of a single tile in a particular column in model coordinates.
|
double |
getPixelSizeX()
Returns the approximate size of a pixel of the mosaic along the x axis,
measured in model coordinates.
|
double |
getPixelSizeY()
Returns the approximate size of a pixel of the mosaic along the y axis,
measured in model coordinates.
|
long |
getRowCount()
Returns the number of tiles in this mosaic along the y axis.
|
double |
getRowHeight()
Returns the height of a single tile in model coordinates.
|
double |
getRowHeight(long aRow)
Returns the height of a single tile in a particular row in model coordinates.
|
ELcdImageSamplingMode |
getSamplingMode()
Returns the sampling mode of the image.
|
ILcdBounds |
getTileGridBounds()
Returns the tile grid bounds of this image.
|
int |
hashCode() |
static ALcdImageMosaic.Configuration.Builder |
newBuilder()
Creates a new builder which can be used to create
Configuration objects. |
getBounds, getImageReference, getSemantics
public long getColumnCount()
public long getRowCount()
public final double getColumnWidth()
getTileGridBounds()
. You
can use getColumnWidth(long)
to conveniently compute the width of a particular column.getColumnWidth(long)
public final double getRowHeight()
getTileGridBounds()
. You
can use getRowHeight(long)
to conveniently compute the height of a particular row.public final double getColumnWidth(long aColumn)
columnWidth - (bounds.minX - tileGridBounds.minX)
columnWidth - (tileGridBounds.maxX - bounds.maxX)
columnWidth
aColumn
- the column in [0, getColumnCount[
getColumnWidth()
,
getTileGridBounds()
public final double getRowHeight(long aRow)
rowHeight - (bounds.minY - tileGridBounds.minY)
rowHeight - (tileGridBounds.maxY - bounds.maxY)
rowHeight
getRowHeight()
,
getTileGridBounds()
public double getPixelSizeX()
public double getPixelSizeY()
public ELcdImageSamplingMode getSamplingMode()
public ILcdBounds getTileGridBounds()
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()
by getRowHeight()
. Hence, the width of
the tile grid bounds is getColumnWidth() * getColumnCount()
and its height is getRowHeight() * 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)
and getRowHeight(long)
to conveniently
compute the width or height of a particular row or column.public ALcdImageMosaic.Configuration.Builder asBuilder()
Configuration
. This allows the user to create a copy of a
configuration and selectively modify properties.Configuration
public static ALcdImageMosaic.Configuration.Builder newBuilder()
Configuration
objects.public boolean equals(Object o)
equals
in class ALcdImage.Configuration
public int hashCode()
hashCode
in class ALcdImage.Configuration