IlvShapeFileTileLoader Class Reference

This class implements a tile loader to read tiles from an ESRI Shapefile whose spatial index has been created. More...

#include <ilviews/maps/format/shapefile/shptloader.h>

Inheritance diagram for IlvShapeFileTileLoader:

List of all members.

Public Member Functions
	IlvShapeFileTileLoader (const char *shpFilename, const char *dbfFilename, const char *shxFilename, const char *indexFilename, const IlvMapAdapter *adapter)
	Constructs a new .shp file tile loader.
const char *	getDBFFilename () const
	Returns the .dbf file from which this tile loader loads attributes.
virtual IlvFeatureRenderer *	getDefaultFeatureRenderer (IlvDisplay *display)
	Returns the default feature renderer for this tile loader.
virtual IlvMapFeatureIterator *	getFeatureIterator (IlvTile *tile)
	Returns the feature iterator to load features from the specified tile.
virtual IlBoolean	getLowerRightCorner (IlvCoordinate &c) const
	Returns the lower right corner of data read by this tile loader.
virtual IlvMapInfo *	getMapInfo ()
	Returns the IlvMapInfo used to generate the IlvGraphic objects.
const char *	getSHPFilename () const
	Returns the .shp file from which this tile loader loads geometries.
const char *	getSHXFilename () const
	Returns the .shx file used as the shape index file.
const char *	getSpatialIndexFilename () const
	Returns the spatial index file used by this tile loader to index geometries by tile.
virtual IlvRect &	getTileOrigin ()
	Returns the tile origin.
virtual IlBoolean	getUpperLeftCorner (IlvCoordinate &c) const
	Returns the upper left corner of data read by this tile loader.
virtual IlBoolean	isPersistent () const
	Returns IlTrue if this tile loader must be saved by a tile controller.
Protected Member Functions
virtual IlvShapeFileReader *	getReader (const char *shpFilename, const char *dbfFilename, const char *shxFilename)
	Creates the IlvShapeFileReader to read from specified files.

---

Detailed Description

This class implements a tile loader to read tiles from an ESRI Shapefile whose spatial index has been created.

Library: ilvmaps

An ESRI Shapefile can be opened in load-on-demand mode if:

• The main file of the ESRI Shapefile is present (.shp file).
• The index file of the ESRI Shapefile is present (.shx file).
• A Rogue Wave Views Maps spatial index for the Shapefile is present (typically, .idx files).

If an attribute table (.dbf file) is available, the attributes can be attached to objects.

---

Constructor & Destructor Documentation

IlvShapeFileTileLoader::IlvShapeFileTileLoader	(	const char *	shpFilename,
		const char *	dbfFilename,
		const char *	shxFilename,
		const char *	indexFilename,
		const IlvMapAdapter *	adapter
	)

Constructs a new .shp file tile loader.

Parameters:

	shpFilename	The name of the .shp filename.
	dbfFilename	The name of the .dbf filename.
	shxFilename	The name of the .shx filename.
	indexFilename	The name of the Rogue Wave Views spatial index filename.

---

Member Function Documentation

virtual IlvMapFeatureIterator* IlvShapeFileTileLoader::getFeatureIterator

(

IlvTile *

tile

)

[virtual]

Returns the feature iterator to load features from the specified tile.

This implementation returns an IlvLookAheadFeatureIterator to read features for the specified tile.

Parameters:

tile

The tile.

Returns:

The feature iterator.

Implements IlvMapTileLoader.

virtual IlBoolean IlvShapeFileTileLoader::getLowerRightCorner

(

IlvCoordinate &

c

)

const [virtual]

Returns the lower right corner of data read by this tile loader.

Returns:

The lower right corner.

virtual IlvShapeFileReader* IlvShapeFileTileLoader::getReader	(	const char *	shpFilename,
		const char *	dbfFilename,
		const char *	shxFilename
	)			[protected, virtual]

Creates the IlvShapeFileReader to read from specified files.

Subclasses of IlvShapeFileTileLoader can override this method to produce a reader with the customized parameters for specific applications.

Parameters:

	shpFilename	The name of the .shp filename.
	dbfFilename	The name of the .dbf filename.
	shxFilename	The name of the .shx filename.

Returns:

The default implementation returns an IlvShapeFileReader with the specified files.

virtual IlvRect& IlvShapeFileTileLoader::getTileOrigin

(

)

[virtual]

Returns the tile origin.

Returns:

The tile origin.

virtual IlBoolean IlvShapeFileTileLoader::getUpperLeftCorner

(

IlvCoordinate &

c

)

const [virtual]

Returns the upper left corner of data read by this tile loader.

Returns:

The upper left corner.

virtual IlBoolean IlvShapeFileTileLoader::isPersistent

(

)

const [virtual]

Returns IlTrue if this tile loader must be saved by a tile controller.

Returns:

IlTrue since this tile loader is to be saved by a tile controller.

Implements IlvMapTileLoader.