Detailed Description

This class is used to return data for a single tile of the terrain database.

For a TSLTerrainDatabase, the size of the tile may vary. For a TSLDTEDTerrainDatabase, this class will represent a single 1x1 degree tile.

The data contained within this class is the raw data from the terrain database, without any interpolation.

This object is reference counted. If the application is finished with it, the dec() method should be called.

Public Member Functions
TSLMUExtent	queryExtent () const

const double *	getData () const

double	getNullValue () const

unsigned int	width () const

unsigned int	height () const

double	getDataAt (unsigned int x, unsigned int y) const

double	postDistanceX () const

double	postDistanceY () const

void	inc ()

void	dec ()

Member Function Documentation

◆ dec()

void TSLTerrainTileDataItem::dec ( )

Decrement this object's reference count.

◆ getData()

const double * TSLTerrainTileDataItem::getData ( ) const

Query the start of the data buffer.

Note: This buffer is (width() * height()) elements in length. The index (0,0) in the data buffer maps to the bottom-left coordinate of the tile. The index ((width-1),(height-1)) in the data buffer mas to the top-right coordinate of the tile.

Null values from the terrain data are represented by the result of getNull Value().

Returns a pointer to the start of the data buffer.

◆ getDataAt()

double TSLTerrainTileDataItem::getDataAt	(	unsigned int	x,
		unsigned int	y ) const

Query a height value from the tile.

Note: The index (0,0) in the data buffer maps to the bottom-left coordinate of the tile. The index ((width-1),(height-1)) in the data buffer mas to the top-right coordinate of the tile.

Null values from the terrain data are represented by the result of getNull Value().

Parameters

x	The horizontal index of the element to query.
y	The vertical index of the element to query.

Returns: the height value, for the given location.

◆ getNullValue()

double TSLTerrainTileDataItem::getNullValue ( ) const

Query the 'null value' from the tile.

This is the value which was supplied to TSLTerrainDatabaseLayer::queryTileAt.

Returns the 'null value' used when this tile was queried.

◆ height()

unsigned int TSLTerrainTileDataItem::height ( ) const

Query the number of data points of this tile, in the y direction.

◆ inc()

void TSLTerrainTileDataItem::inc ( )

Increment this object's reference count.

◆ postDistanceX()

double TSLTerrainTileDataItem::postDistanceX ( ) const

Query the distance between data points, in the x direction.

This value is in the same units as the tiles extent.

◆ postDistanceY()

double TSLTerrainTileDataItem::postDistanceY ( ) const

Query the distance between data points, in the y direction.

This value is in the same units as the tiles extent.

◆ queryExtent()

TSLMUExtent TSLTerrainTileDataItem::queryExtent ( ) const

Query the extent of this tile.

The extent is in the same units as the source terrain database.

Returns the extent of this tile.

◆ width()

unsigned int TSLTerrainTileDataItem::width ( ) const

Query the number of data points of this tile, in the x direction.