IlvDTEDReader Class Reference

This class can be used to read DTED files. More...

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

Inheritance diagram for IlvDTEDReader:

List of all members.

Public Member Functions
	IlvDTEDReader (IlIUrlStream &input)
	Creates an instance of the DTED reader from a IlIUrlStream.
	IlvDTEDReader (istream &input)
	Creates an instance of the DTED reader from a istream.
	IlvDTEDReader (const char *filename)
	Creates an instance of the DTED reader for the specified file name.
IlvFeatureRenderer *	getDefaultFeatureRenderer (IlvDisplay *)
	Returns an instance of IlvDefaultFeatureRenderer.
virtual IlvMapsError	getInitStatus () const
	Checks the initialization status of this feature iterator.
virtual IlBoolean	getLowerRightCorner (IlvCoordinate &coordinate) const
	Returns the lower right corner of the rectangle containing all the map features of this iterator.
virtual const IlvMapFeature *	getNextFeature (IlvMapsError &status)
	Returns the next map feature of the iterator, or 0 if the iteration is finished. The returned feature is owned by the feature iterator.
const IlvProjection *	getProjection () const
	Returns the projection used in the DTED file.
virtual IlBoolean	getUpperLeftCorner (IlvCoordinate &) const
	Returns the upper left corner of the rectangle containing all the map features of this iterator.

---

Detailed Description

This class can be used to read DTED files.

Library: ilvmaps

The Digital Terrain Elevation Data (DTED) format is a map format for representing terrain elevations, which is published by the US National Imagery and Mapping Agency (NIMA).

This reader produces only one map feature which is an IlvMapRaster.

The DTED reader provided in this package is based on the specification document MIL-PRF-89020A of 19 April 1996.

DTED files are available with various precision levels: DTED0, DTED1 and DTED2, with DTED2 offering the greatest precision.

Samples of DTED files can be downloaded from the Geospatial Engine

---

Constructor & Destructor Documentation

IlvDTEDReader::IlvDTEDReader

(

const char *

filename

)

Creates an instance of the DTED reader for the specified file name.

Parameters:

filename

The name of the DTED file to be read.

IlvDTEDReader::IlvDTEDReader

(

istream &

input

)

Creates an instance of the DTED reader from a istream.

Parameters:

input

A stream opened on a DTED file.

IlvDTEDReader::IlvDTEDReader

(

IlIUrlStream &

input

)

Creates an instance of the DTED reader from a IlIUrlStream.

Parameters:

input

A stream opened on a DTED URL.

---

Member Function Documentation

IlvFeatureRenderer* IlvDTEDReader::getDefaultFeatureRenderer

(

IlvDisplay *

)

[virtual]

Returns an instance of IlvDefaultFeatureRenderer.

Returns:

An instance of IlvDefaultFeatureRenderer.

Implements IlvMapFeatureIterator.

virtual IlvMapsError IlvDTEDReader::getInitStatus

(

)

const [virtual]

Checks the initialization status of this feature iterator.

Returns:

The error code that may have happened during the iterator initialization.

Implements IlvMapFeatureIterator.

virtual IlBoolean IlvDTEDReader::getLowerRightCorner

(

IlvCoordinate &

result

)

const [virtual]

Returns the lower right corner of the rectangle containing all the map features of this iterator.

Returns:

IlFalse if lower right is unknown.

Implements IlvMapFeatureIterator.

virtual const IlvMapFeature* IlvDTEDReader::getNextFeature

(

IlvMapsError &

status

)

[virtual]

Returns the next map feature of the iterator, or 0 if the iteration is finished. The returned feature is owned by the feature iterator.

Parameters:

status

Stores the status of the operation. This status is IlvMaps::NoError() if no error occurs.

Returns:

The next map feature available.

Implements IlvMapFeatureIterator.

const IlvProjection* IlvDTEDReader::getProjection

(

)

const [virtual]

Returns the projection used in the DTED file.

The projection is an IlvGeographicProjection.

Returns:

The projection.

Implements IlvMapFeatureIterator.

virtual IlBoolean IlvDTEDReader::getUpperLeftCorner

(

IlvCoordinate &

result

)

const [virtual]

Returns the upper left corner of the rectangle containing all the map features of this iterator.

Returns:

IlFalse if upper left is unknown.

Implements IlvMapFeatureIterator.