com.luciad.format.raster (LuciadLightspeed API documentation)

Interface Summary
Interface	Description
ILcdColorModelFactory	An ILcdColorModelFactory can create a `ColorModel`.
ILcdMultilevelRaster	Important notice: the package `com.luciad.imaging` presents a new API for the modeling of raster data.
ILcdMultivaluedIcon	This interface provides a method to draw icons for multi-dimensional integer values.
ILcdMultivaluedRaster	This interface represents a bounded raster of multi-dimensional values.
ILcdParameterizedIcon	An icon that is based on a set of parameters.
ILcdRaster	Important notice: the package `com.luciad.imaging` presents a new API for the modeling of raster data.
ILcdRasterPainter	An `ILcdRasterPainter` provides additional common methods over `ILcdGXYPainter`, that are typically useful for painting rasters.
ILcdRasterValueConverter	This interface makes it possible to convert between raster and data values.
ILcdSubtiledTile	This interface defines an ILcdTile which is further subdivided into subtiles.
ILcdTile	Important notice: the package `com.luciad.imaging` presents a new API for the modeling of raster data.
ILcdTileDecoder	This interface contains methods to decode a sub-tile from a whole tile (image) contained in a file or URL.
ILcdTileInfo	This interface provides information about an `ILcdTile`: size, type, color model, and data.

Class Summary
Class	Description
ALcdRaster	Base class for ILcdRaster implementations.
ALcdRasterPainter	This abstract class provides a basis for implementing the `ILcdRasterPainter` interface.
ALcdTileDecoder	This class is an abstract basis for implementing `ILcdTileDecoder`.
TLcdAllInMemoryRasterPainter	`TLcdAllInMemoryRasterPainter` implements an `ILcdGXYPainter` for an `ILcdRaster`.
TLcdArcInfoASCIIGridModelDecoder	This model decoder decodes ESRI ArcInfo ASCII Grid format (.asc, .grd) raster files.
TLcdBCIRasterModelDecoder	This model decoder decodes BCI raster files.
TLcdBCIRasterModelDescriptor	This `TLcdRasterModelDescriptor` contains additional information about BCI rasters.
TLcdBCITileDecoder	This class is an `ILcdTileDecoder` for BCI tiles.
TLcdBILModelDecoder	This model decoder decodes Band Interleaved by Line (BIL) raster files.
TLcdBILModelDescriptor	A `TLcdRasterModelDescriptor` for models containing BIL data.
TLcdBILTileDecoder	This `ILcdTileDecoder` decodes BIL (Band Interleaved by Line) tiles.
TLcdBMPImageDecoder	This `ILcdTileDecoder` decodes images in BMP format.
TLcdBufferedTile	This implementation of `ILcdTile` provides lazy decoding of image data that can be retrieved from a file or from a URL.
TLcdByteArrayTile	This basic implementation of `ILcdTile` retrieves its pixel values from a given array of bytes.
TLcdCADRGBoundaryRectangleDescriptor	This descriptor contains the information about a CADRG/CIB frame present in a Boundary Rectangle Record of an A.TOC file.
TLcdCADRGDirectoryModelDecoder	This model decoder decodes directories containing rasters in the CADRG format (Compressed ARC Digital Raster Graphics).
TLcdCADRGFrameDescriptor	This descriptor contains the information about a CADRG/CIB frame present in a Frame File Index Record of an A.TOC file.
TLcdCADRGImageDecoder	This `ILcdTileDecoder` decodes CADRG/CIB frame files.
TLcdCADRGModelDecoder	This model decoder decodes rasters in the CADRG format (Compressed ARC Digital Raster Graphics) and in the CIB format (Controlled Image Base).
TLcdCADRGModelDescriptor	This `TLcdRasterModelDescriptor` contains additional information about CADRG data.
TLcdCADRGMultilevelRasterModelDescriptor	This `ILcdModelDescriptor` describes a model containing CADRG multilevel raster objects.
TLcdCADRGRaster	This `ILcdRaster` contains additional information about the CADRG/CIB Boundary Rectangle that it represents.
TLcdCADRGTile	This `ILcdTile` contains additional information about the CADRG/CIB frame that it represents.
TLcdClippedTile	This `ILcdTile` represents a specified rectangle of a given tile as a new tile.
TLcdColorModelFactory	Utility class containing methods to create `ColorModel` instances.
TLcdDEMModelDecoder	This model decoder decodes elevation rasters in the DEM format (USGS Digital Elevation Model).
TLcdDEMModelDescriptor	This `TLcdRasterModelDescriptor` contains additional information about DEM data.
TLcdDEMTileDecoder	`TLcdDTEDCellDecoder` is an `ILcdTileDecoder` that decodes a DEM tiles.
TLcdDIMAPModelDecoder	This model decoder decodes DIMAP XML files (Digital Image Map).
TLcdDIMAPModelDescriptor	Model descriptor for a model decoded by the TLcdDIMAPModelDecoder.
TLcdDMEDModelDecoder	This model decoder decodes DMED (Digital Mean Elevation Data) files and any available corresponding DTED (Digital Terrain Elevation Data) files.
TLcdDMEDModelDescriptor	This `TLcdRasterModelDescriptor` contains additional information about DMED data.
TLcdDMEDTileDecoder	This `ILcdTileDecoder` decodes DMED cells on the integer grid of 1° by 1°.
TLcdDTEDAccuracySubregionDescription	This class represents a DTED Accuracy Subregion Description.
TLcdDTEDCellDescriptor	This `TLcdRasterModelDescriptor` contains additional information about a DTED cell.
TLcdDTEDColorModelFactory	This `ILcdColorModelFactory` creates `IndexColorModel` instances for use with DTED data.
TLcdDTEDDirectoryModelDecoder	This model decoder decodes directories containing DTED (Digital Terrain Elevation Data) files.
TLcdDTEDModelDecoder	This model decoder decodes individual DTED (Digital Terrain Elevation Data) files.
TLcdDTEDModelDescriptor	A `TLcdRasterModelDescriptor` for models containing DTED data.
TLcdDTEDTile	This `ILcdTile` contains additional information about the DTED cell that it represents.
TLcdDTEDTileDecoder	This `ILcdTileDecoder` decodes 1° by 1° DTED cells of any level (0, 1, or 2).
TLcdECRGMediaMetadata	Contains ECRG media metadata read from TOC.xml See MIL-PRF-32283, Table C-XII
TLcdECRGModelDecoder	This model decoder decodes rasters in the ECRG format (Enhanced Compressed Raster Graphics) and in the CIB format (Controlled Image Base).
TLcdECRGModelDescriptor	This `TLcdRasterModelDescriptor` contains additional information about ECRG data.
TLcdECRGMultilevelRasterModelDescriptor	This `ILcdModelDescriptor` describes a model containing ECRG multilevel raster objects.
TLcdECRGTile	A single tile or frame in an ECRG raster.
TLcdECWConfiguration	This class provides static methods to tune the cache of the native ECW decompression library.
TLcdECWImageDecoder	This class is an `ILcdTileDecoder` for ECW images.
TLcdECWModelDecoder	This model decoder decodes georeferenced ER Mapper ECW (Enhanced Compression Wavelet) files
TLcdECWModelDescriptor	A `TLcdRasterModelDescriptor` for models containing ECW data.
TLcdElevationUtil	This class contains static utility methods related to elevation rasters.
TLcdETOPOModelDecoder	This model decoder decodes the raw ETOPO1, ETOPO2, ETOPO2v2, and ETOPO5 data sets.
TLcdETOPOModelDescriptor	This `TLcdRasterModelDescriptor` contains additional information about ETOPO data.
TLcdGeoSPOTModelDecoder	This model decoder decodes GeoSPOT DSC (description) and REP (report) files.
TLcdGeoSPOTModelDescriptor	This `TLcdRasterModelDescriptor` contains additional information about GeoSPOT data.
TLcdGeoSPOTRaster	This `ILcdRaster` contains additional information about the GeoSPOT tile that it represents.
TLcdGeoSPOTRasterDescriptor	This descriptor contains information corresponding to GeoSPOT IMSPATIO.HDR and IMSPATIO.RSC fields for a given raster.
TLcdGeoSPOTSceneDescriptor	This descriptor contains information corresponding to GeoSPOT IMSPATIO.RSC fields for a given scene.
TLcdGeoSPOTSubsetDescriptor	This descriptor contains information corresponding to GeoSPOT subset fields.
TLcdGeoTIFFField	This class describes a TIFF or GeoTIFF tag and the corresponding field.
TLcdGeoTIFFImageDecoder	This `ILcdTileDecoder` decodes GeoTIFF images and TIFF images in general.
TLcdGeoTIFFModelDecoder	This model decoder decodes GeoTIFF files, or more generally, georeferenced TIFF files.
TLcdGeoTIFFModelDescriptor	A `TLcdRasterModelDescriptor` for models containing GeoTIFF data.
TLcdGeoTIFFModelEncoder	This `ILcdModelEncoder` encodes image or raster models into GeoTIFF files.
TLcdGIFImageDecoder	This `ILcdTileDecoder` can decode GIF images.
TLcdGradientIndexColorModelFactory	This class implements an ILcdColorModelFactory for creating `IndexColorModel` objects whose entries represent a color gradient between 2 colors.
TLcdImageDecoder	`TLcdImageDecoder` is an `ILcdTileDecoder` for images supported by the platform's native implementation of the Toolkit, i.e., `Toolkit.getDefaultToolkit()`.
TLcdIndexColorModelFactory	This class implements an ILcdColorModelFactory for creating general `IndexColorModel` objects.
TLcdIntArrayTile	This basic implementation of `ILcdTile` retrieves its pixel values from a given array of integers.
TLcdInterpolatedRaster	This class provides an implementation of `ILcdRaster` that interpolates between the values of its tiles.
TLcdJAIModelDescriptor	A `TLcdRasterModelDescriptor` for models containing JAI data.
TLcdJAIRasterModelDecoder	This model decoder decodes `jai` files.
TLcdJetIndexColorModelFactory	This `ILcdColorModelFactory` creates `IndexColorModel` instances with smoothly varying colors.
TLcdJPEG2000AssociationBox	A JPEG2000 association box.
TLcdJPEG2000Box	A JPEG2000 box.
TLcdJPEG2000ImageDecoder	This class is an `ILcdTileDecoder` for JPEG2000 images.
TLcdJPEG2000ModelDecoder	This model decoder decodes georeferenced JPEG2000 files.
TLcdJPEG2000ModelDescriptor	This `TLcdMultilevelRasterModelDescriptor` describes models containing JPEG2000 multi-level rasters.
TLcdJPEG2000ModelEncoder	This `ILcdModelEncoder` encodes raster models into georeferenced JPEG2000 files.
TLcdJPIPModelDecoder	This model decoder decodes georeferenced JPEG2000 images retrieved through the JPEG2000 Interactive Protocol (JPIP).
TLcdJPIPModelDescriptor	This `TLcdMultilevelRasterModelDescriptor` describes models containing JPEG2000 multi-level rasters retrieved using the JPIP protocol.
TLcdLinearRasterValueConverter	A raster value converter that uses a linear transformation to convert between raster and data values.
TLcdMrSIDImageDecoder	This class is an `ILcdTileDecoder` for MrSID images.
TLcdMrSIDModelDecoder	This model decoder decodes georeferenced LizardTech MrSID (MultiResolution Seamless Image Database) files.
TLcdMrSIDModelDescriptor	A `TLcdRasterModelDescriptor` for models containing MrSID data.
TLcdMultilevelGeoTIFFModelDescriptor	A `TLcdMultilevelRasterModelDescriptor` for models containing GeoTIFF data.
TLcdMultilevelJAIModelDescriptor	A `TLcdMultilevelRasterModelDescriptor` for models containing JAI data.
TLcdMultilevelRaster	Important notice: the package `com.luciad.imaging` presents a new API for the modeling of raster data.
TLcdMultilevelRasterModelDescriptor	This `ILcdModelDescriptor` describes a model containing `ILcdMultilevelRaster` objects.
TLcdMultilevelRasterPainter	Important notice: the package `com.luciad.imaging` presents a new API for the modeling of raster data.
TLcdMultilevelRSTModelDescriptor	A `TLcdMultilevelRasterModelDescriptor` for models containing RST data.
TLcdMultivaluedRaster	This `ILcdMultivaluedRaster` combines the values from a list of simple rasters into vectors.
TLcdMultivaluedRasterModelDescriptor	This `ILcdModelDescriptor` is used for models that contain a `TLcdMultivaluedRaster` objects.
TLcdMultivaluedRasterPainter	This `ILcdGXYPainter` paints `ILcdMultivaluedRaster` objects from models that have a `TLcdMultivaluedRasterModelDescriptor`.
TLcdNITFGXYLayerFactory	The default layer factory for NITF models.
TLcdNITFModelDecoder	This model decoder decodes rasters in the NITF format (National Imagery Transmission Format, NITF 2.0 and NITF 2.1).
TLcdNITFModelDescriptor	This `ILcdModelDescriptor` is a `TLcdRasterModelDescriptor` that contains the additional properties that are defined in a NITF header.
TLcdNITFTextSegment	This class represents a text segment from an NITF file See MIL-STD-2500c, Table A-6
TLcdNITFUncompressedImageDecoder	This `ILcdTileDecoder` decodes uncompressed images in NITF files.
TLcdNoWarpMultilevelRasterPainter	This `ILcdGXYPainter` can paint `ILcdMultilevelRaster` instances, applying only a scaling transformation.
TLcdNoWarpRasterPainter	This `ILcdGXYPainter` can paint `ILcdRaster` instances, applying only a scaling transformation.
TLcdNumericParameterizedIcon	This `ILcdParameterizedIcon` displays numbers, based on the first value in the array of parameters.
TLcdPNMImageDecoder	This class is an `ILcdTileDecoder` for PNM (Portable aNyMap) images, being PBM (Portable BitMap), PGM (Portable GrayMap), and PPM (Portable PixMap).
~~TLcdPPMImageDecoder~~	Deprecated Use `TLcdPNMImageDecoder`.
TLcdRaster	Important notice: the package `com.luciad.imaging` presents a new API for the modeling of raster data.
TLcdRasterModelDecoder	This model decoder decodes decodes `rst` files.
TLcdRasterModelDescriptor	This `ILcdModelDescriptor` describes a model containing `ILcdRaster` objects.
TLcdRasterOffsetModelXYZWorldTransformation	This `ILcdModelXYZWorldTransformation` implementation takes the values of an `ILcdRaster` into account when transforming model Z coordinates.
TLcdRasterOffsetZTransformation	This `ILcdModelZWorldTransformation` implementation takes the values of `ILcdRaster` into account when transforming the model Z to world Z and back.
TLcdRasterPainter	Important notice: the package `com.luciad.imaging` presents a new API for the modeling of raster data.
TLcdRasterReferencingUtil	This class creates model bounds for rasters, based on a given model reference and on additional information about the raster's position.
TLcdRenderedImageTile	This `ILcdTile` provides a simple wrapper for a `RenderedImage`.
TLcdRSTModelDescriptor	A `TLcdRasterModelDescriptor` for models containing RST data.
TLcdShadedMultilevelRasterPainter	This ILcdRasterPainter paints multilevel elevation rasters as translucent rasters with dark or light shading based on the position of the sun.
TLcdShadedRasterPainter	This ILcdRasterPainter paints elevation rasters as translucent rasters with dark or light shading based on the position of the sun.
TLcdShadedTileDecoder	This class decodes shaded values based on the values returned by another `ILcdTileDecoder`.
TLcdShortArrayTile	Important notice: the package `com.luciad.imaging` presents a new API for the modeling of raster data.
TLcdSingleTileRaster	This class provides a specialized implementation of `ILcdRaster`, containing only a single tile.
TLcdSwissDHMMatrixModelDecoder	This model decoder decodes elevation rasters in the SwissTopo Digital Height Model format (DHM25).
TLcdSwissDHMMatrixModelDescriptor	A `TLcdRasterModelDescriptor` for models containing Swiss DHM matrix data.
TLcdTABRasterModelDecoder	This model decoder decodes MapInfo TAB Raster files.
TLcdTFWRasterModelDecoder	This model decoder decodes TIFF World files (`tfw` files), as well as JPEG World files (`jgw` files), BMP World files (`bpw` files) and PNG World files (`pgw`).
~~TLcdTIFFImageDecoder~~	Deprecated Use `TLcdGeoTIFFImageDecoder`.
TLcdTileDecoder	This `ILcdTileDecoder` decodes uncompressed tiles of bytes, shorts, or integers.
TLcdTileInfo	This class provides an implementation of ILcdTileInfo.
TLcdUSRPAccuracyDescriptor	This class describes the accuracy of USRP/ASRP/ADRG data, as defined in a Quality file (QAL).
TLcdUSRPDatasetModelDescriptor	A `TLcdRasterModelDescriptor` for models containing USRP/ASRP/ADRG data.
TLcdUSRPLegend	This class describes a legend of USRP/ASRP/ADRG data, as defined in a Source file (SOU).
TLcdUSRPModelDecoder	This model decoder decodes rasters in the USRP, ASRP, and ADRG formats.
TLcdUSRPModelDescriptor	A `TLcdRasterModelDescriptor` for models containing USRP/ASRP/ADRG data.
TLcdUSRPTile	This `ILcdTile` contains additional information about the USRP/ASRP/ADRG zone that it represents.
TLcdUSRPZoneDescriptor	This descriptor contains the information about a USRP/ASRP/ADRG zone present in a General Information File (GEN).
TLcdWarpMultilevelRasterPainter	This `ILcdGXYPainter` can paint `ILcdMultilevelRaster` instances, warping them between different coordinate systems as required.
TLcdWarpRasterPainter	This `ILcdGXYPainter` can paint `ILcdRaster` instances, warping them between different coordinate systems as required.

Enum Summary
Enum Description

ELcdNITFBandRepresentation
Enumeration describing the NITF image band representations

TLcdJPEG2000Box.Type
JPEG2000 metadata box type.

Enum Summary
Enum	Description
ELcdNITFBandRepresentation	Enumeration describing the NITF image band representations
TLcdJPEG2000Box.Type	JPEG2000 metadata box type.

Package com.luciad.format.raster Description

Provides representations, decoders, and encoders for rasters.

Domain object types

Important notice: the package com.luciad.imaging presents a new API for the modeling of raster data. For new projects, it is recommended to use this API instead of ILcdRaster et al.

This package contains a number of fundamental interfaces and classes to represent rasters of scalar values:

ILcdTile represents a tile (image), a discrete two-dimensional array of scalar (integer values with an optional color model. Its coordinates are expressed in pixels. The values can be retrieved one at a time, or as AWT images representing rectangular subsets of the tile.
Basic implementations:
- TLcdByteArrayTile: a tile whose values are stored as an array of bytes,
- TLcdShortArrayTile: a tile whose values are stored as an array of shorts,
- TLcdIntArrayTile: a tile whose values are stored as an array of integers,
- TLcdRenderedImageTile: a tile whose values are stored as a RenderedImage.
- TLcdBufferedTile: a tile whose values are loaded lazily and cached in a shared buffer, with the help of an ILcdTileDecoder.
ILcdRaster represents a raster, a regular two-dimensional grid of tiles. It has a position and size in its own raster coordinate system, which is typically the model coordinate system. The raster values can be retrieved one at a time, or as entire tiles. Basic implementation: TLcdRaster.
ILcdMultilevelRaster represents a raster at increasing levels of detail, each of which is represented by a simple raster. It has a position and size in its own raster coordinate system, which is typically the model coordinate system. Basic implementation: TLcdMultilevelRaster.

Furthermore, there is an interface to represent rasters in which each value is not a scalar value, but a multi-dimensional vector of values:

ILcdMultivaluedRaster represents a two-dimensional raster that contains multi-dimensional vectors of values. Just like a scalar raster, it has a position and size in its own raster coordinate system, which is typically the model coordinate system. These vectors or their individual scalar values can be retrieved. Basic implementation: TLcdMultivaluedRaster.

Model decoders

Instances of the above types are most often created with the help of model decoders ILcdModelDecoder that each read a particular data format:

TLcdGeoTIFFModelDecoder decodes GeoTIFF files or georeferenced TIFF files,
TLcdTABRasterModelDecoder decodes TAB files and their associated image files,
TLcdTFWRasterModelDecoder decodes TFW files and their associated TIFF files,
TLcdDMEDModelDecoder decodes DMED files and their associated DTED data sets,
TLcdDTEDModelDecoder decodes invidual DTED files,
TLcdDTEDDirectoryModelDecoder decodes directories containing DTED data sets,
TLcdDEMModelDecoder decodes DEM files,
TLcdUSRPModelDecoder decodes USRP, ASRP, and ADRG files,
TLcdCADRGModelDecoder decodes CADRG files and data sets,
TLcdECRGModelDecoder decodes ECRG files,
TLcdNITFModelDecoder decodes NITF files,
etc...

Model encoders

Models containing rasters and multi-level rasters can be encoded in data formats using the appropriate encoders ILcdModelEncoder:

TLcdGeoTIFFModelEncoder encodes rasters and multi-level rasters as GeoTIFF files.

Lsp Visualization

For visualization in an ILspView you can use TLspRasterLayerBuilder. The layers support both single and multi-leveled rasters. You can use TLspRasterStyle to customize the visualization.

GXY Visualization

For visualization in an ILcdGXYView you can use some standard raster painters.

If the rasters may or may not be defined in the same reference as the view (the model reference of the raster model is not necessarily equal to the world reference of the view), there are two painters that can perform warping if required:

TLcdRasterPainter paints ILcdRaster instances,
TLcdMultilevelRasterPainter paints ILcdMultilevelRaster instances.

If the rasters are known to be defined in the same reference as the view (the model reference of the raster model is equal to the world reference of the view), there are two painters that can paint efficiently without warping:

TLcdNoWarpRasterPainter paints ILcdRaster instances,
TLcdNoWarpMultilevelRasterPainter paints ILcdMultilevelRaster instances.

If the rasters are supposed to be defined in different references as the view (the model reference of the raster model is assumed to be different from the world reference of the view), there are two painters that can paint the rasters, warping them as necessary:

TLcdWarpRasterPainter paints ILcdRaster instances,
TLcdWarpMultilevelRasterPainter paints ILcdMultilevelRaster instances.

Since:: 1.5