Rogue Wave Views
Maps Package API Reference Guide
Product Documentation:

Rogue Wave Views
Documentation Home
List of all members | Public Member Functions | Static Public Member Functions
IlvMapFeatureIterator Class Referenceabstract

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

#include <ilviews/maps/mapfeature.h>

Inheritance diagram for IlvMapFeatureIterator:
IlvCADRGFrameReader IlvDTEDReader IlvGeoTIFFReader IlvImageReader IlvLookAheadFeatureIterator IlvObjectSDOFeatureIterator IlvS57Loader IlvSDOFeatureIterator

Public Member Functions

virtual IlvClassInfogetClassInfo () const =0
 Returns the class information for this feature iterator. More...
 
virtual IlvFeatureRenderergetDefaultFeatureRenderer (IlvDisplay *display)=0
 Returns the default renderer for this feature iterator. More...
 
virtual IlvMapsError getInitStatus () const =0
 Checks the initialization status of this feature iterator. More...
 
virtual IlBoolean getLowerRightCorner (IlvCoordinate &result) const =0
 Returns the lower right corner of the rectangle containing all the map features of this iterator. More...
 
virtual const IlvMapFeaturegetNextFeature (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. More...
 
virtual const IlvProjectiongetProjection () 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. More...
 
virtual IlBoolean getUpperLeftCorner (IlvCoordinate &result) const =0
 Returns the upper left corner of the rectangle containing all the map features of this iterator. More...
 
virtual void setSourceProjection (IlvProjection *projection)
 Sets the projection of geometries generated by this feature iterator. More...
 

Static Public Member Functions

static IlvClassInfoClassInfo ()
 Returns the class information of the class. More...
 
static IlvClassInfo ** ClassInfoRef ()
 Returns the address of the class information of the class. More...
 

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:

See also
IlvMapFeature

Member Function Documentation

§ ClassInfo()

static IlvClassInfo* IlvMapFeatureIterator::ClassInfo ( )
static

Returns the class information of the class.

Returns
The IlvClassInfo of the class.

§ ClassInfoRef()

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.

§ getClassInfo()

virtual IlvClassInfo* IlvMapFeatureIterator::getClassInfo ( ) const
pure virtual

Returns the class information for this feature iterator.

Returns
The class information for this feature iterator.

§ getDefaultFeatureRenderer()

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 IlvShapeFileReader, IlvShapeSHPReader, IlvObjectSDOFeatureIterator, IlvS57Loader, IlvCADRGFrameReader, IlvImageReader, IlvDTEDReader, IlvGeoTIFFReader, and IlvSDOFeatureIterator.

§ getInitStatus()

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 IlvObjectSDOFeatureIterator, IlvSDOFeatureIterator, IlvShapeFileReader, IlvShapeSHPReader, IlvImageReader, IlvS57Loader, IlvCADRGFrameReader, IlvGeoTIFFReader, and IlvDTEDReader.

§ getLowerRightCorner()

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 IlvObjectSDOFeatureIterator, IlvS57Loader, IlvShapeFileReader, IlvShapeSHPReader, IlvSDOFeatureIterator, IlvImageReader, IlvCADRGFrameReader, IlvDTEDReader, and IlvGeoTIFFReader.

§ getNextFeature()

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
statusStores the status of the operation. This status is IlvMaps::NoError() if no error occurs.
Returns
The next map feature available.

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

§ getProjection()

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 IlvObjectSDOFeatureIterator, IlvShapeFileReader, IlvShapeSHPReader, IlvS57Loader, IlvGeoTIFFReader, IlvCADRGFrameReader, IlvImageReader, IlvDTEDReader, and IlvSDOFeatureIterator.

§ getUpperLeftCorner()

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 IlvObjectSDOFeatureIterator, IlvShapeFileReader, IlvS57Loader, IlvShapeSHPReader, IlvCADRGFrameReader, IlvImageReader, IlvSDOFeatureIterator, IlvDTEDReader, and IlvGeoTIFFReader.

§ setSourceProjection()

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
projectionThe projection to be set. This projection becomes shared and is locked by this feature iterator.

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


© Copyright 2017, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.