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)
	Initializes a new image reader instance from a file name. More...
	IlvImageReader (IlvDisplay *display, IlIUrlStream &input, IlvCoordinate &ul, IlvCoordinate &lr)
	Initializes a new image reader instance from an IlIUrlStream. More...
	IlvImageReader (IlvDisplay *display, std::istream &input, IlvCoordinate &ul, IlvCoordinate &lr)
	Initializes a new image reader instance from an istream. 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 &) const
	Computes the lower right corner of the rectangle containing all the map features of this iterator. More...
virtual const IlvMapFeature *	getNextFeature (IlvMapsError &)
	Returns the next map feature of the iterator. More...
const IlvProjection *	getProjection () const
	Returns the projection in which the geometric coordinates of the map features are expressed. More...
virtual IlBoolean	getUpperLeftCorner (IlvCoordinate &) const
	Computes 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
	)

Initializes a new image reader instance from a file name.

Parameters

display	The display instance to use.
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,
		std::istream &	input,
		IlvCoordinate &	ul,
		IlvCoordinate &	lr
	)

Initializes a new image reader instance from an istream.

Parameters

display	The display instance to use.
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
	)

Initializes a new image reader instance from an IlIUrlStream.

Parameters

display	The display instance to use.
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

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

Parameters

result

Set on return to 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.

Parameters

status

Set on return to the status of the operation. This status is IlvMaps::NoError() if no error occurs.

Returns

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

Implements IlvMapFeatureIterator.

getProjection()

const IlvProjection* IlvImageReader::getProjection ( ) const

virtual

Returns the projection in which the geometric coordinates of the map features are expressed.

Returns

The projection of the geometry, or 0 if the feature iterator returns ungeoreferenced map features.

Implements IlvMapFeatureIterator.

getUpperLeftCorner()

virtual IlBoolean IlvImageReader::getUpperLeftCorner ( IlvCoordinate &  result ) const

virtual

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

Parameters

result

Set on return to 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.