IlvDTEDLayer Class Reference

A layer that displays a DTED coverage using the load-on-demand mechanism. More...

#include <ilviews/maps/format/dted/dtedlayer.h>

Inheritance diagram for IlvDTEDLayer:

List of all members.

Public Member Functions
	IlvDTEDLayer (const char *dirName, IlUInt level, const IlvMapAdapter *adapter, IlvTileCache *cache=0)
	Creates an instance of IlvDTEDLayer.
const IlvMapAdapter *	getAdapter ()
	Retrieves the current adapter.
const IlString *	getDirName ()
	Returns the name of the parent DTED directory.
IlString *	getFileName (IlInt row, IlInt column)
	Returns the DTED file name corresponding to the specified row and column.
const IlvFeatureRenderer *	getRasterRenderer () const
	Retrieves the raster renderer used to create graphic objects.
void	setAdapter (IlvMapAdapter *a)
	Sets a new adapter.
void	setRasterRenderer (IlvFeatureRenderer *renderer)
	Sets a new feature renderer.

---

Detailed Description

A layer that displays a DTED coverage using the load-on-demand mechanism.

Library: ilvmaps

This layer automatically loads the tiles that are visible in the views of its manager and unloads the tiles that are not visible.

The file name of the tiles are computed from the usual naming specifications for DTED files:
The DTED file names are named LXX.dtY where L can be 'n' (North) or 's' (South). XX is the latitude of the tile and Y the suffix of the DTED file depending on the DTED level (0, 1 or 2). For example, n09.dt0 is a tile of level 0, located at the latitude 9 North.
The DTED file parent directories are named LXXX where L can be 'e' (East) or 'w' (West) and XXX is the longitude of the DTED tiles contained in a parent directory. For example, w001/ is the directory containing dted tiles located at longitude 1 West.
The characters described above can be uppercase or lowercase. For example, n30.dt1 and N30.DT1 are two valid names for the same DTED tile. The case you use, however, depends on your file system.

The IlvDTEDLayer works only in the geographic projection.

---

Constructor & Destructor Documentation

IlvDTEDLayer::IlvDTEDLayer	(	const char *	dirName,
		IlUInt	level,
		const IlvMapAdapter *	adapter,
		IlvTileCache *	cache = 0
	)

Creates an instance of IlvDTEDLayer.

This constructor uses a cache that is shared by all the IlvDTEDLayer instances initialized with this default constructor.

Parameters:

	dirName	The name of the parent DTED directory (usually [any_path]/dted)
	level	The level of the files to be loaded (0, 1 or 2).
	adapter	The adapter used to create the graphic object.
	cache	This optional argument specifies the cache of the layer. If this argument is not passed, the singleton cache returned by IlvDefaultTileCache::GetDefaultCache() is used.

---

Member Function Documentation

const IlvMapAdapter* IlvDTEDLayer::getAdapter

(

)

Retrieves the current adapter.

Returns:

The current adapter.

const IlString* IlvDTEDLayer::getDirName

(

)

Returns the name of the parent DTED directory.

Returns:

The name of the parent DTED directory.

IlString* IlvDTEDLayer::getFileName	(	IlInt	row,
		IlInt	column
	)

Returns the DTED file name corresponding to the specified row and column.

For example, getFileName(36, -113) returns "w113/n36.dt0".

Parameters:

	row	The row number of the DTED file given in the load-on-demand grid.
	col	The column number of the DTED file given in the load-on-demand grid.

Returns:

the DTED file name corresponding to the specified row and column.

const IlvFeatureRenderer* IlvDTEDLayer::getRasterRenderer

(

)

const

Retrieves the raster renderer used to create graphic objects.

This renderer is still owned by the layer.

Returns:

The current raster renderer.

void IlvDTEDLayer::setAdapter

(

IlvMapAdapter *

a

)

Sets a new adapter.

Parameters:

The

new adapter. The layer becomes owner of the adapter.

void IlvDTEDLayer::setRasterRenderer

(

IlvFeatureRenderer *

renderer

)

Sets a new feature renderer.

Sets the feature renderer used to create graphic objects representing the DTED rasters. The image renderer must support the IlvMapRaster geometry.

Parameters:

renderer

The feature renderer. The old renderer (if any) is destroyed and the layer becomes owner of the new renderer.