com.luciad.earth.metadata.preprocessor.combiner

LuciadLightspeedClass ALcdEarthTileCombiner

java.lang.Object

com.luciad.earth.metadata.preprocessor.combiner.ALcdEarthTileCombiner

All Implemented Interfaces:

ILcdEarthTileCombiner

Direct Known Subclasses:

TLcdEarthElevationDataCombiner, TLcdEarthImageCombiner, TLcdEarthTerrainTileVertexArrayCombiner

public abstract class ALcdEarthTileCombiner
extends Object
implements ILcdEarthTileCombiner

Base class for ILcdEarthTileCombiner implementations. Derived classes need only implement the abstract combineTileData() method, which combines the data objects of four input tiles. Creating a new tile, with the appropriate properties and containing the combined data, is handled by this class.

By default, combineTiles() returns instances of TLcdEarthTile. This behaviour can be changed by overriding createCombinedTile().

Since:

8.2

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ALcdEarthTileCombiner() Constructs a new ALcdEarthTileCombiner.

Method Summary

Modifier and Type	Method and Description
abstract Object	combineTileData(ALcdEarthTile[][] aInputTiles, Object[][] aInputData) Combines the data present in the four input tiles.
ALcdEarthTile	combineTiles(ALcdEarthTile[][] aInputs) Combines four tiles into one.
ALcdEarthTile	combineTiles(ALcdEarthTile[][] aInputs, ALcdEarthTile[] aContext) The default implementation of this method simply calls combineTiles(com.luciad.earth.tileset.ALcdEarthTile[][]), ignoring the tiles passed in aContext.
protected ALcdEarthTile	createCombinedTile(ILcd3DEditableBounds aCombinedBounds, Object aCombinedData, int aLevel, long aX, long aY, ILcdEarthTileSetCoverage aCoverage, ILcdGeoReference aGeoreference, TLcdEarthTileFormat aFormat) Returns a new TLcdEarthTile with the given properties.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.luciad.earth.metadata.preprocessor.combiner.ILcdEarthTileCombiner

getDataFormat

Constructor Detail

ALcdEarthTileCombiner

protected ALcdEarthTileCombiner()

Constructs a new ALcdEarthTileCombiner.

Method Detail

combineTileData

public abstract Object combineTileData(ALcdEarthTile[][] aInputTiles,
                                       Object[][] aInputData)

Combines the data present in the four input tiles. Returns a new data object to be contained in the result of combineTiles().

Parameters:

aInputTiles - the four source tiles

aInputData - the data objects of four source tiles

Returns:

a new data object for the combined tiles

Throws:

IllegalArgumentException - if the data cannot be combined

combineTiles

public ALcdEarthTile combineTiles(ALcdEarthTile[][] aInputs)

Combines four tiles into one. All properties of the tile are set in this method, except for the tile's actual data. This is created by calling combineTileData(), with the data objects of the four source tiles as an argument.

The returned tile is instantiated using the method createCombinedTile().

Specified by:

combineTiles in interface ILcdEarthTileCombiner

Parameters:

aInputs - 2x2 matrix of tiles of level N

Returns:

the corresponding tile for level N-1

Throws:

IllegalArgumentException - if the tiles cannot be combined

createCombinedTile

protected ALcdEarthTile createCombinedTile(ILcd3DEditableBounds aCombinedBounds,
                                           Object aCombinedData,
                                           int aLevel,
                                           long aX,
                                           long aY,
                                           ILcdEarthTileSetCoverage aCoverage,
                                           ILcdGeoReference aGeoreference,
                                           TLcdEarthTileFormat aFormat)

Returns a new TLcdEarthTile with the given properties. This method can be overridden if some other implementation of ALcdEarthTile is needed.

Parameters:

aCombinedBounds - the bounds of the new tile

aCombinedData - the data of the new tile

aLevel - the level of the new tile

aX - the column index of the new tile

aY - the row index of the new tile

aCoverage - the coverage of the new tile

aGeoreference - the georeference of the new tile

aFormat - the data format of the new tile

Returns:

a new tile with the specified properties

combineTiles

public ALcdEarthTile combineTiles(ALcdEarthTile[][] aInputs,
                                  ALcdEarthTile[] aContext)

The default implementation of this method simply calls combineTiles(com.luciad.earth.tileset.ALcdEarthTile[][]), ignoring the tiles passed in aContext.

Specified by:

combineTiles in interface ILcdEarthTileCombiner

Parameters:

aInputs - 2x2 matrix of tiles of level N

aContext - additional neighboring tiles that may be used by the combiner

Returns:

the corresponding tile for level N-1

Throws:

IllegalArgumentException - if the tiles cannot be combined