IlvImageReader Class Reference

This class is an IlvMapFeatureIterator specialized for reading image files. The supported image formats are those supported by Rogue Wave Views. More...

#include <ilviews/maps/format/image/imgreader.h>

Inheritance diagram for IlvImageReader:

Public Member Functions
	IlvImageReader (IlvDisplay *display, const char *filename, IlvCoordinate &ul, IlvCoordinate &lr)
	Creates an instance of the image reader from a file name. More...
	IlvImageReader (IlvDisplay *display, istream &input, IlvCoordinate &ul, IlvCoordinate &lr)
	Creates an instance of the image reader from an istream. More...
	IlvImageReader (IlvDisplay *display, IlIUrlStream &input, IlvCoordinate &ul, IlvCoordinate &lr)
	Creates an instance of the image reader from an IlIUrlStream. More...
IlvFeatureRenderer *	getDefaultFeatureRenderer (IlvDisplay *display)
	Returns an instance of IlvDefaultFeatureRenderer. More...
virtual IlvMapImage *	getGeometry ()
	Returns the IlvMapImage geometry. More...
virtual IlvMapsError	getInitStatus () const
	Checks the initialization status of this feature iterator. More...
virtual IlBoolean	getLowerRightCorner (IlvCoordinate &coordinate) const
	Returns the lower right corner of the rectangle containing all the map features of this iterator. More...
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. More...
const IlvProjection *	getProjection () const
	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 &coordinate) const
	Returns the upper left corner of the rectangle containing all the map features of this iterator. More...
void	setSourceProjection (IlvProjection *projection)
	Sets the projection of geometries generated by this feature iterator. More...
Public Member Functions inherited from IlvMapFeatureIterator
virtual IlvClassInfo *	getClassInfo () const =0
	Returns the class information for this feature iterator. More...

Additional Inherited Members
Static Public Member Functions inherited from IlvMapFeatureIterator
static IlvClassInfo *	ClassInfo ()
	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 an IlvMapFeatureIterator specialized for reading image files. The supported image formats are those supported by Rogue Wave Views.

Library: ilvmaps

Constructor & Destructor Documentation

IlvImageReader() [1/3]

IlvImageReader::IlvImageReader	(	IlvDisplay *	display,
		const char *	filename,
		IlvCoordinate &	ul,
		IlvCoordinate &	lr
	)

Creates an instance of the image reader from a file name.

Constructs an IlvImageReader by specifying the name of the image file to read and the coordinates of the image.

Parameters

display	The display.
filename	The name of the image file.
ul	The upper left coordinate of the image.
lr	The lower right coordinate of the image.

IlvImageReader() [2/3]

IlvImageReader::IlvImageReader	(	IlvDisplay *	display,
		istream &	input,
		IlvCoordinate &	ul,
		IlvCoordinate &	lr
	)

Creates an instance of the image reader from an istream.

Constructs an IlvImageReader by specifying a stream opened on the image file to read and the coordinates of the image.

Parameters

display	The display.
input	A stream opened on an image file.
ul	The upper left coordinate of the image.
lr	The lower right coordinate of the image.

IlvImageReader() [3/3]

IlvImageReader::IlvImageReader	(	IlvDisplay *	display,
		IlIUrlStream &	input,
		IlvCoordinate &	ul,
		IlvCoordinate &	lr
	)

Creates an instance of the image reader from an IlIUrlStream.

Parameters

display	The display.
input	A stream opened on an image URL.
ul	The upper left coordinate of the image.
lr	The lower right coordinate of the image.

Member Function Documentation

getDefaultFeatureRenderer()

IlvFeatureRenderer* IlvImageReader::getDefaultFeatureRenderer ( IlvDisplay *  display )

virtual

Returns an instance of IlvDefaultFeatureRenderer.

Returns

An instance of IlvDefaultImageRenderer.

Implements IlvMapFeatureIterator.

getGeometry()

virtual IlvMapImage* IlvImageReader::getGeometry ( )

virtual

Returns the IlvMapImage geometry.

Returns

The IlvMapImage geometry. The geometry is owned by the reader.

getInitStatus()

virtual IlvMapsError IlvImageReader::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.

getLowerRightCorner()

virtual IlBoolean IlvImageReader::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.

getNextFeature()

virtual const IlvMapFeature* IlvImageReader::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.

getProjection()

const IlvProjection* IlvImageReader::getProjection ( ) const

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.

Implements IlvMapFeatureIterator.

getUpperLeftCorner()

virtual IlBoolean IlvImageReader::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.

setSourceProjection()

void IlvImageReader::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 from IlvMapFeatureIterator.