com.luciad.earth.tileset.raster

LuciadLightspeedClass ALcdEarthTileSetMultilevelRaster

java.lang.Object

com.luciad.earth.tileset.util.ALcdEarthTileSetWrapper

com.luciad.earth.tileset.raster.ALcdEarthTileSetMultilevelRaster

All Implemented Interfaces:

ILcdEarthTileSet, ILcdMultilevelRaster, ILcdBounded, ILcdCache, ILcdDisposable, AutoCloseable

Direct Known Subclasses:

TLcdEarthTileSetElevationMultilevelRaster, TLcdEarthTileSetMultilevelRaster

public abstract class ALcdEarthTileSetMultilevelRaster
extends ALcdEarthTileSetWrapper
implements ILcdMultilevelRaster

Views an ILcdEarthTileSet as an ILcdMultilevelRaster.

Since:

8.2

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ALcdEarthTileSetMultilevelRaster(ILcdEarthTileSet aTileSet) Creates a multilevel raster wrapper for the given tileset.
protected	ALcdEarthTileSetMultilevelRaster(ILcdEarthTileSet aTileSet, ILcdEarthTileSetCoverage aCoverage) Creates a multilevel raster wrapper for the given tileset.

Method Summary

Modifier and Type	Method and Description
void	clearCache() Clears the cache.
protected abstract ILcdRaster	createRaster(int aLevel) Creates the raster at the given level.
Object	getCachedObject(Object o) Looks up and returns the cached Object corresponding to the given key.
ILcdRaster	getRaster(int i)
int	getRasterCount()
ILcdEarthTileSet	getRasterTileSet() Returns the tileset used to retrieve the raster data.
ILcdEarthTileSetCoverage	getRasterTileSetCoverage() Returns the data coverage that is used to retrieve the raster data.
void	insertIntoCache(Object o, Object o1) Inserts a cache Object corresponding to the given key Object.
protected abstract boolean	isValidRasterCoverage(ILcdEarthTileSetCoverage aCoverage) Returns whether the given coverage is a valid raster coverage for this multi level raster.
Object	removeCachedObject(Object o) Looks up and removes the cached Object corresponding to the given key.

Methods inherited from class com.luciad.earth.tileset.util.ALcdEarthTileSetWrapper

cancelTile, containsTile, containsTileSetCoverage, dispose, getBounds, getDelegateTileSet, getLevelCount, getTileColumnCount, getTileRowCount, getTileSetCoverage, getTileSetCoverage, getTileSetCoverageCount, isFormatSupported, isGeoReferenceSupported, produceTile, produceTile, updateTile, updateTile

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.luciad.shape.ILcdBounded

getBounds

Methods inherited from interface com.luciad.util.ILcdDisposable

close

Constructor Detail

ALcdEarthTileSetMultilevelRaster

protected ALcdEarthTileSetMultilevelRaster(ILcdEarthTileSet aTileSet)

Creates a multilevel raster wrapper for the given tileset. The first valid coverage in the given tileset will be used to retrieve the raster data.

Parameters:

aTileSet - A tileset.

Throws:

IllegalArgumentException - If no valid coverage is available.

See Also:

isValidRasterCoverage(com.luciad.earth.tileset.ILcdEarthTileSetCoverage)

ALcdEarthTileSetMultilevelRaster

protected ALcdEarthTileSetMultilevelRaster(ILcdEarthTileSet aTileSet,
                                           ILcdEarthTileSetCoverage aCoverage)

Creates a multilevel raster wrapper for the given tileset. If the given coverage is not null, it will be used to retrieve the data. Otherwise the first valid coverage is used instead.

Parameters:

aTileSet - A tileset.

aCoverage - The coverage that contains the raster data or null to use the first valid coverage from the given tileset.

Throws:

IllegalArgumentException - If the given coverage is not null and not valid or no valid coverage is available.

See Also:

isValidRasterCoverage(com.luciad.earth.tileset.ILcdEarthTileSetCoverage)

Method Detail

getRasterTileSetCoverage

public ILcdEarthTileSetCoverage getRasterTileSetCoverage()

Returns the data coverage that is used to retrieve the raster data.

Returns:

A data coverage.

getRasterTileSet

public ILcdEarthTileSet getRasterTileSet()

Returns the tileset used to retrieve the raster data.

Returns:

A tileset.

isValidRasterCoverage

protected abstract boolean isValidRasterCoverage(ILcdEarthTileSetCoverage aCoverage)

Returns whether the given coverage is a valid raster coverage for this multi level raster.

Parameters:

aCoverage - An earth coverage.

Returns:

True if the coverage can be used as the raster data source.

createRaster

protected abstract ILcdRaster createRaster(int aLevel)

Creates the raster at the given level.

Parameters:

aLevel - A level.

Returns:

A raster.

getRasterCount

public int getRasterCount()

Specified by:

getRasterCount in interface ILcdMultilevelRaster

Returns:

the number of ILcdRaster objects in this ILcdMultilevelRaster.

getRaster

public ILcdRaster getRaster(int i)

Specified by:

getRaster in interface ILcdMultilevelRaster

Returns:

the ILcdRaster at level aLevel.

insertIntoCache

public void insertIntoCache(Object o,
                            Object o1)

Description copied from interface: ILcdCache

Inserts a cache Object corresponding to the given key Object.

Specified by:

insertIntoCache in interface ILcdCache

Parameters:

o - the key Object that will be used to identify the Object. The key must therefore be a unique identifier, typically the caller itself: insertIntoCache(this, ...).

o1 - the Object to be cached.

removeCachedObject

public Object removeCachedObject(Object o)

Description copied from interface: ILcdCache

Looks up and removes the cached Object corresponding to the given key.

Specified by:

removeCachedObject in interface ILcdCache

Parameters:

o - the key Object that was used for storing the cache Object.

Returns:

the cached Object, or null if there was no Object corresponding to the given key.

clearCache

public void clearCache()

Description copied from interface: ILcdCache

Clears the cache.

Specified by:

clearCache in interface ILcdCache

getCachedObject

public Object getCachedObject(Object o)

Description copied from interface: ILcdCache

Looks up and returns the cached Object corresponding to the given key.

Specified by:

getCachedObject in interface ILcdCache

Parameters:

o - the key Object that was used for storing the cache Object.

Returns:

the cached Object, or null if there is no Object corresponding to the given key.