IlvTile Class Reference

This class represents the elementary element used by the load-on-demand process. More...

#include <ilviews/maps/tiling/tile.h>

List of all members.

Public Member Functions
void	addObject (IlvGraphic *g, IlvMapFeatureId *id=0)
	Adds a graphic object to an IlvTiledLayer.
void	boundingBox (IlvRect &rect) const
	Returns the bounding box of the tile in the manager coordinate system.
void	deleteAll ()
	Empties the tile except for the objects that are shared by another non empty tile.
IlInt	getColumn () const
	Returns the column of the tile.
IlvTileController *	getController () const
	Returns the controller of the tile.
IlvDisplay *	getDisplay () const
	Returns the display of controller manager.
IlvGraphic *	getObject (IlvMapFeatureId *id) const
	Returns the object of the specified ID if it is already loaded in the layer.
IlInt	getRow () const
	Returns the row of the tile.
IlvTileStatus	getStatus () const
	Returns the status of the tile.
IlBoolean	isLoadComplete () const
	Returns IlTrue if the tile is fully loaded.
IlBoolean	isObjectShared (IlvGraphic *graphic) const
	Returns IlTrue if the object graphic is shared by other tiles.
void	loadComplete ()
	Notifies the tile that it has been fully loaded, thus, the method must be called by the tile loaders.
void	reDraw () const
	Redraws a tile.

---

Detailed Description

This class represents the elementary element used by the load-on-demand process.

Library: ilvmaps

A tile represents an elementary rectangular area that is loaded or released when needed by the application. Tiles are managed by an IlvTileController.

In most cases, the tile controller will be associated with an IlvTiledLayer. This means that the tiles represent areas that must be filled with graphic objects when they become visible due to the user of the application scrolling or zooming on a view.

More sophisticated applications can use a tile controller without attaching it to a layer, for example, to load data that is needed to process an area that becomes visible.

---

Member Function Documentation

void IlvTile::addObject	(	IlvGraphic *	g,
		IlvMapFeatureId *	id = 0
	)

Adds a graphic object to an IlvTiledLayer.

When implementing an IlvTileLoader, objects should not be added to a manager using IlvManager::addObject. This method must be called only if the tile controller is attached to a layer.

Parameters:

	g	The graphic object to be added.
	id	The ID of the object. This parameter can take the null value. The ID is owned by the tile and will be deleted when the tile will be released.

See also:

IlvTile::getObject

IlvTileLoader

void IlvTile::boundingBox

(

IlvRect &

rect

)

const

Returns the bounding box of the tile in the manager coordinate system.

Parameters:

rect

The returned IlvRect object containing the bounding box.

void IlvTile::deleteAll

(

)

Empties the tile except for the objects that are shared by another non empty tile.

This method must be called only if the tile controller is attached to a layer.

IlInt IlvTile::getColumn

(

)

const

Returns the column of the tile.

Returns:

The column of the tile.

IlvTileController* IlvTile::getController

(

)

const

Returns the controller of the tile.

Returns:

The IlvTileController object that controls this tile.

IlvDisplay* IlvTile::getDisplay

(

)

const

Returns the display of controller manager.

Returns:

The IlvDisplay.

IlvGraphic* IlvTile::getObject

(

IlvMapFeatureId *

id

)

const

Returns the object of the specified ID if it is already loaded in the layer.

This method must be called only if the tile is attached to a layer.

Parameters:

id

The ID of the object.

Returns:

The corresponding object.

See also:

IlvTile::addObject

IlInt IlvTile::getRow

(

)

const

Returns the row of the tile.

Returns:

The row of the tile.

IlvTileStatus IlvTile::getStatus

(

)

const

Returns the status of the tile.

Returns:

The status of the tile.

See also:

IlvTileStatus

IlBoolean IlvTile::isLoadComplete

(

)

const

Returns IlTrue if the tile is fully loaded.

Returns:

IlTrue if the load is complete, IlFalse otherwise.

See also:

IlvTile::loadComplete.

IlBoolean IlvTile::isObjectShared

(

IlvGraphic *

graphic

)

const

Returns IlTrue if the object graphic is shared by other tiles.

This method must be called only if the tile controller is attached to a layer. This method only tests objects against currently locked or cached tiles.

Parameters:

graphic

The graphic object.

Returns:

IlTrue if the object is shared, IlFalse otherwise.

void IlvTile::loadComplete

(

)

Notifies the tile that it has been fully loaded, thus, the method must be called by the tile loaders.

See also:

IlvTileLoader.

void IlvTile::reDraw

(

)

const

Redraws a tile.

Should be called only if the tile is attached to a layer.