public abstract class ALcdImage extends Object implements ILcdBounded
ALcdImage
.
The subclasses of ALcdImage
introduce additional semantics and structure.
ALcdBasicImage describes a uniform two-dimensional
pixel grid and is used as the basic building block
for modeling pixel data. A number of concepts are layered on top of
ALcdBasicImage
:
ALcdBasicImage
objects which can represent, for instance, multiple levels
of detail of the same data.ALcdBasicImage
.
You can get access to the underlying image data via ALcdImagingEngine
for ALcdBasicImage
.
You can perform image processing operations on an image by constructing an ALcdImageOperator and applying it to the image.
ALcdImage's are immutable. To model changing data you must use a has-an-image approach (seefromDomainObject(java.lang.Object)
). As a result one should never check if an Object
is an ALcdImage
using
instanceof
, but use the fromDomainObject
method instead and perform a null
-check on
the result.Modifier and Type | Class and Description |
---|---|
static class |
ALcdImage.Configuration
Describes the configuration of an ALcdImage.
|
Modifier and Type | Field and Description |
---|---|
static TLcdDataType |
IMAGE_DATA_TYPE
Data type for images, used by ALcdImageOperator
to represent input images.
|
Modifier | Constructor and Description |
---|---|
protected |
ALcdImage()
This class is not intended to be implemented by users.
|
Modifier and Type | Method and Description |
---|---|
ALcdMultilevelImageMosaic |
asMultilevelMosaic()
Converts this image to an
ALcdMultilevelImageMosaic ,
which is the most general image representation. |
static ALcdImage |
fromDomainObject(Object aObject)
Returns an image for the given object.
|
ILcdBounds |
getBounds()
Returns the bounds of the image.
|
abstract ALcdImage.Configuration |
getConfiguration()
Returns an image configuration object describing the properties of this image's data.
|
public static final TLcdDataType IMAGE_DATA_TYPE
protected ALcdImage()
public static ALcdImage fromDomainObject(Object aObject)
Returns an image for the given object. The given object is usually a domain object, i.e. an object retrieved from the model. It returns an image in the following cases:
Object
is an ALcdImage
.Object
is an ILcdDataObject
whose type contains a TLcdHasGeometryAnnotation
with an ALcdImage
property.In other cases, this method returns null
.
One should never check if an Object
is an image using instanceof
, but use this method
instead and perform a null
-check on the result.
Note that this method does not adapt or convert the given object to an ALcdImage
. It only tries
to retrieve an image from it for the above cases.
aObject
- an object, usually the domain object in a model.null
.public abstract ALcdImage.Configuration getConfiguration()
public ILcdBounds getBounds()
getBounds
in interface ILcdBounded
public final ALcdMultilevelImageMosaic asMultilevelMosaic()
ALcdMultilevelImageMosaic
,
which is the most general image representation. This can be useful for
applications which prefer not to deal with the different possible image
representations.