IlvMapFeatureIterator Class Reference

This class is the base class for feature iterators. More...

#include <ilviews/maps/mapfeature.h>

Inheritance diagram for IlvMapFeatureIterator:

List of all members.

Public Member Functions
virtual IlvClassInfo *	getClassInfo () const =0
	Returns the class information for this feature iterator.
virtual IlvFeatureRenderer *	getDefaultFeatureRenderer (IlvDisplay *display)=0
	Returns the default renderer for this feature iterator.
virtual IlvMapsError	getInitStatus () const =0
	Checks the initialization status of this feature iterator.
virtual IlBoolean	getLowerRightCorner (IlvCoordinate &result) const =0
	Returns the lower right corner of the rectangle containing all the map features of this iterator.
virtual const IlvMapFeature *	getNextFeature (IlvMapsError &status)=0
	Returns the next map feature of the iterator, or 0 if the iteration is finished. The returned feature is owned by the feature iterator.
virtual const IlvProjection *	getProjection () const =0
	Returns the projection in which the geometric coordinates of the map features are expressed or 0 if the feature iterator returns ungeoreferenced map features.
virtual IlBoolean	getUpperLeftCorner (IlvCoordinate &result) const =0
	Returns the upper left corner of the rectangle containing all the map features of this iterator.
virtual void	setSourceProjection (IlvProjection *projection)
	Sets the projection of geometries generated by this feature iterator. This method is to be used when feature source is not georeferenced. The default implementation of this method does nothing.
Static Public Member Functions
static IlvClassInfo *	ClassInfo ()
	Returns the class information of the class.
static IlvClassInfo **	ClassInfoRef ()
	Returns the address of the class information of the class.

---

Detailed Description

This class is the base class for feature iterators.

Library: ilvmaps

A feature iterator is a convenient interface to access various map feature sources transparently. Feature iterators can be implemented by:

• classes of map readers that read simple map file formats;
• classes representing query results, such as queries to a map server.

See also:

IlvMapFeature

---

Member Function Documentation

static IlvClassInfo* IlvMapFeatureIterator::ClassInfo

(

)

[static]

Returns the class information of the class.

Returns:

The IlvClassInfo of the class.

static IlvClassInfo** IlvMapFeatureIterator::ClassInfoRef

(

)

[static]

Returns the address of the class information of the class.

This function is used when subclassing IlvMapFeatureIterator.

Returns:

The address is the IlvClassInfo of the class.

virtual IlvClassInfo* IlvMapFeatureIterator::getClassInfo

(

)

const [pure virtual]

Returns the class information for this feature iterator.

Returns:

The class information for this feature iterator.

virtual IlvFeatureRenderer* IlvMapFeatureIterator::getDefaultFeatureRenderer

(

IlvDisplay *

display

)

[pure virtual]

Returns the default renderer for this feature iterator.

Returns a renderer that can be used to translate the map features returned by this iterator into graphic objects. Feature iterators that store some rendering information in the attributes of the map features, such as color, text font, line thickness and so on, can return a specific renderer which is able to take these attributes into account during the rendering process.

Returns:

The default renderer for this feature iterator.

Implemented in IlvCADRGFrameReader, IlvDTEDReader, IlvGeoTIFFReader, IlvImageReader, IlvObjectSDOFeatureIterator, IlvSDOFeatureIterator, IlvS57Loader, IlvShapeFileReader, and IlvShapeSHPReader.

virtual IlvMapsError IlvMapFeatureIterator::getInitStatus

(

)

const [pure virtual]

Checks the initialization status of this feature iterator.

Returns:

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

Implemented in IlvCADRGFrameReader, IlvDTEDReader, IlvGeoTIFFReader, IlvImageReader, IlvObjectSDOFeatureIterator, IlvSDOFeatureIterator, IlvS57Loader, IlvShapeFileReader, and IlvShapeSHPReader.

virtual IlBoolean IlvMapFeatureIterator::getLowerRightCorner

(

IlvCoordinate &

result

)

const [pure virtual]

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

Returns:

IlFalse if lower right is unknown.

Implemented in IlvCADRGFrameReader, IlvDTEDReader, IlvGeoTIFFReader, IlvImageReader, IlvObjectSDOFeatureIterator, IlvSDOFeatureIterator, IlvS57Loader, IlvShapeFileReader, and IlvShapeSHPReader.

virtual const IlvMapFeature* IlvMapFeatureIterator::getNextFeature

(

IlvMapsError &

status

)

[pure 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.

Implemented in IlvCADRGFrameReader, IlvDTEDReader, IlvGeoTIFFReader, IlvImageReader, IlvObjectSDOFeatureIterator, IlvSDOFeatureIterator, IlvS57Loader, IlvShapeFileReader, and IlvShapeSHPReader.

virtual const IlvProjection* IlvMapFeatureIterator::getProjection

(

)

const [pure virtual]

Returns the projection in which the geometric coordinates of the map features are expressed or 0 if the feature iterator returns ungeoreferenced map features.

Returns:

The projection of the geometry.

Implemented in IlvCADRGFrameReader, IlvDTEDReader, IlvGeoTIFFReader, IlvImageReader, IlvObjectSDOFeatureIterator, IlvSDOFeatureIterator, IlvS57Loader, IlvShapeFileReader, and IlvShapeSHPReader.

virtual IlBoolean IlvMapFeatureIterator::getUpperLeftCorner

(

IlvCoordinate &

result

)

const [pure virtual]

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

Returns:

IlFalse if upper left is unknown.

Implemented in IlvCADRGFrameReader, IlvDTEDReader, IlvGeoTIFFReader, IlvImageReader, IlvObjectSDOFeatureIterator, IlvSDOFeatureIterator, IlvS57Loader, IlvShapeFileReader, and IlvShapeSHPReader.

virtual void IlvMapFeatureIterator::setSourceProjection

(

IlvProjection *

projection

)

[virtual]

Sets the projection of geometries generated by this feature iterator. This method is to be used when feature source is not georeferenced. The default implementation of this method does nothing.

Parameters:

projection

The projection to be set. This projection becomes shared and is locked by this feature iterator.

Reimplemented in IlvGeoTIFFReader, IlvImageReader, IlvObjectSDOFeatureIterator, IlvSDOFeatureIterator, IlvShapeFileReader, and IlvShapeSHPReader.