public abstract class ALcdBasicImage extends ALcdImage
A basic image is defined by its width and height in pixels as defined in its ALcdBasicImage.Configuration. The number of tiles in each dimension and the resolution of each tile can be obtained from the ALcdBasicImage.Configuration as well.
Basic images are the building block to construct more complex images, such as ALcdMultilevelImage which consists of multiple levels of basic images, ALcdImageMosaic which is a mosaic where each tile is a single basic image, and ALcdMultilevelImageMosaic, where each level is a mosaic consisting of multiple basic images.
Extracting the data from a basic image should be done through an
ALcdImagingEngine. Consider the image's tiling
structure when doing so to obtain optimal performance. Pixels use the AWT coordinate
convention: the origin is in the upper left corner. The geographic location of the pixels depends on the
sampling mode
:
ELcdImageSamplingMode.AREA
: pixel (i,j)
is centered at
x = bounds_left_x + (i + 0.5) * bounds_width / width;
y = bounds_upper_y - (j + 0.5) * bounds_height / height;
ELcdImageSamplingMode.POINT
: pixel (i,j)
is at
x = bounds_left_x + i * bounds_width / (width - 1);
y = bounds_upper_y - j * bounds_height / (height - 1);
The following image shows a 4x4 area-sampled basic image. The pixel (0,0) is in the upper-left corner.
You can obtain a basic image from one of the model decoders or using one of the available builders:
TLcdImageBuilder
: basic images and multi-level imagesTLcdRasterImageBuilder
: adapt a legacy rasterModifier and Type | Class and Description |
---|---|
static class |
ALcdBasicImage.Configuration
Describes the configuration of an ALcdBasicImage.
|
Modifier and Type | Field and Description |
---|---|
static TLcdDataType |
BASIC_IMAGE_DATA_TYPE
Data type for basic images, used by ALcdImageOperator
to represent input images.
|
IMAGE_DATA_TYPE
Modifier | Constructor and Description |
---|---|
protected |
ALcdBasicImage()
This class is not intended to be implemented by users.
|
Modifier and Type | Method and Description |
---|---|
abstract ALcdBasicImage.Configuration |
getConfiguration()
Returns an image configuration object describing the properties of this image's data.
|
asMultilevelMosaic, fromDomainObject, getBounds
public static final TLcdDataType BASIC_IMAGE_DATA_TYPE
protected ALcdBasicImage()
public abstract ALcdBasicImage.Configuration getConfiguration()
getConfiguration
in class ALcdImage