IlvDefaultSDOTileLoader Class Reference

This tile loader loads a complete SDO layer with tiles that are equivalent to the SDO tiles. More...

#include <ilviews/maps/format/oracle/sdotileload.h>

Inheritance diagram for IlvDefaultSDOTileLoader:

List of all members.

Public Member Functions
	IlvDefaultSDOTileLoader (const IlvMapAdapter *mapadapter, IldDbms *dbms, const char *layerName)
	Initializes an instance of IlvDefaultSDOTileLoader, which loads tiles from the specified layer of an SDO database.
virtual IlvMapsError	dbmsRestored ()
	Called by the IlvSDOLayer read from an .ilv file, after the connection to an Oracle SDO database has been restored.
const char *	getLayerName ()
	Returns the name of the SDO layer of this tile loader.
virtual IldRequest *	getRequest (IlvTile *tile)
	Returns an IldRequest containing all the geometries that intersect the tile.
const char *	getSDOCode (IlvTile *tile)
	Returns the SDO code associated with the tile.
virtual IlvRect *	getSize ()
	Returns the bounding box of the data set managed by the tile loader.
IlUShort	getTileGroupingCount () const
	Returns the number of tiles to be loaded in one unique request.
const IlvRect &	getTileOrigin () const
	Returns the bounding box of the upper-left SDO tile.
virtual IlvMapsError	load (IlvTile *tile)
	Loads a tile from the Oracle database and adds the graphic objects to the layer of the tile.
void	setTileGroupingCount (IlUShort nb)
	Sets the number of tiles to be loaded in one unique request.
Protected Member Functions
IlvSDOFeatureIterator *	getFeatureIterator (IldRequest *request, IlvMapsError &status)
	Returns the instance of IlvSDOFeatureIterator that is used by the tile loader.

---

Detailed Description

This tile loader loads a complete SDO layer with tiles that are equivalent to the SDO tiles.

Library: ilvdbmaps

This tile loader is optimized for speed performance thanks to the tile grouping capacity that can be used through the IlvDefaultSDOTileLoader#setTileGroupingCount method.

See also:

IlvSDOLayer

---

Constructor & Destructor Documentation

IlvDefaultSDOTileLoader::IlvDefaultSDOTileLoader	(	const IlvMapAdapter *	mapadapter,
		IldDbms *	dbms,
		const char *	layerName
	)

Initializes an instance of IlvDefaultSDOTileLoader, which loads tiles from the specified layer of an SDO database.

Parameters:

	mapadapter	The map adapter of the tile loader.
	dbms	The IldDbms.
	layerName	The name of the layer.

---

Member Function Documentation

virtual IlvMapsError IlvDefaultSDOTileLoader::dbmsRestored

(

)

[virtual]

Called by the IlvSDOLayer read from an .ilv file, after the connection to an Oracle SDO database has been restored.

Returns:

An IlvMapsError code.

Reimplemented from IlvSDOTileLoader.

IlvSDOFeatureIterator* IlvDefaultSDOTileLoader::getFeatureIterator	(	IldRequest *	request,
		IlvMapsError &	status
	)			[protected]

Returns the instance of IlvSDOFeatureIterator that is used by the tile loader.

You can override this method in order to use your own feature iterator.

Parameters:

	request	The IldRequest from which geometries are read.
	status	The error that may have been produced by the method.

Returns:

The instance of IlvSDOFeatureIterator used by the tile loader.

virtual IldRequest* IlvDefaultSDOTileLoader::getRequest

(

IlvTile *

tile

)

[virtual]

Returns an IldRequest containing all the geometries that intersect the tile.

This method is called by the load(IlvTile tile) method to define the list of geometries that have to be loaded in a tile. The implementation of this class returns all the geometries that have the same SDO_CODE as the specified tile.

See also:

IlvDefaultSDOTileLoader::GetSDOCode

Parameters:

tile

The tile.

Reimplemented from IlvSDOTileLoader.

const char* IlvDefaultSDOTileLoader::getSDOCode

(

IlvTile *

tile

)

Returns the SDO code associated with the tile.

Parameters:

tile

The tile for the load-on-demand mechanism.

Returns:

The SDO code associated with the tile.

virtual IlvRect* IlvDefaultSDOTileLoader::getSize

(

)

[virtual]

Returns the bounding box of the data set managed by the tile loader.

If the bounding box cannot be computed, this method can return 0. The IlvSDOLayer using this object will have an undefined size.

Returns:

0

Reimplemented from IlvSDOTileLoader.

IlUShort IlvDefaultSDOTileLoader::getTileGroupingCount

(

)

const

Returns the number of tiles to be loaded in one unique request.

See also:

IlvDefaultSDOTileLoader::setTileGroupingCount

virtual IlvMapsError IlvDefaultSDOTileLoader::load

(

IlvTile *

tile

)

[virtual]

Loads a tile from the Oracle database and adds the graphic objects to the layer of the tile.

This method calls getRequest to get the SDO geometries, transforms them into graphic objects using the renderer of the layer, and then adds the objects to the layer.

See also:

IlvSDOTileLoader::getRequest

Parameters:

tile

The tile to be loaded.

Reimplemented from IlvSDOTileLoader.

void IlvDefaultSDOTileLoader::setTileGroupingCount

(

IlUShort

nb

)

Sets the number of tiles to be loaded in one unique request.

This is particularly useful for the load on demand where you can group a given number of tiles to be loaded together (when for instance the zoom factor is important so that you are visualizing a certain number of tiles at the same time).