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.
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.
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.
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).
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.
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.
TLcdLinearRasterValueConverter	A raster value converter that uses a linear transformation to convert between raster and data values.
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`.
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 `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.
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.
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.

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