A container of Layer(s). More...

#include <map.h>

Inheritance diagram for FIFE::Map:

Collaboration diagram for FIFE::Map:

Public Member Functions
	Map (const std::string &identifier, RenderBackend renderbackend, const std::vector< RendererBase > &renderers, TimeProvider *tp_master=NULL)
	Construct a map To add map to model, one should call Model::addMap (otherwise map is not registered with the engine properly) More...

	~Map ()
	Destructor. More...

const std::string &	getId () const
	Get the identifier for this map. More...

void	setId (const std::string &id)
	Sets the identifier for this map. More...

Layer *	createLayer (const std::string &identifier, CellGrid *grid)
	Add a Layer to this Map. More...

void	deleteLayer (Layer *)
	Delete a layer from the map. More...

const std::list< Layer * > &	getLayers () const
	Get the layers on this map. More...

Layer *	getLayer (const std::string &identifier)
	Get the layer with the given id. More...

uint32_t	getLayerCount () const
	Get the overall number of layers. More...

void	deleteLayers ()
	Delete all layers from the map. More...

void	getMatchingCoordinates (const ModelCoordinate &coord_to_map, const Layer from_layer, const Layer to_layer, std::vector< ModelCoordinate > &matching_coords) const
	Maps coordinate from one layer to another. More...

void	getMinMaxCoordinates (ExactModelCoordinate &min, ExactModelCoordinate &max)
	Retrieves the minimum/maximum coordinates of instances on the map. More...

bool	update ()
	Called periodically to update events on map. More...

void	setTimeMultiplier (float multip)
	Sets speed for the map. More...

float	getTimeMultiplier () const
	Gets model speed. More...

TimeProvider *	getTimeProvider ()
	Gets timeprovider used in the map. More...

void	addChangeListener (MapChangeListener *listener)
	Adds new change listener. More...

void	removeChangeListener (MapChangeListener *listener)
	Removes associated change listener. More...

bool	isChanged ()
	Returns true, if map information was changed during previous update round. More...

std::vector< Layer * > &	getChangedLayers ()
	Returns layers that were changed during previous update round. More...

Camera *	addCamera (const std::string &id, Layer *layer, const Rect &viewport)
	Adds camera to the map. More...

void	removeCamera (const std::string &id)
	Removes a camera from the map. More...

Camera *	getCamera (const std::string &id)
	Get a camera by its identifier. More...

const std::vector< Camera * > &	getCameras () const
	Get a list containing all cameras. More...

uint32_t	getActiveCameraCount () const
	Return the number of enabled cameras in this map. More...

void	setFilename (const std::string &file)

const std::string &	getFilename () const

void	addInstanceForTransfer (Instance *instance, const Location &target)
	Adds instance that is to be transferred to another layer. More...

void	removeInstanceForTransfer (Instance *instance)
	Removes instance that should be transferred to another layer. More...

void	initializeCellCaches ()
	Creates cellcaches for this map. More...

void	finalizeCellCaches ()
	Creates cellcaches for this map. More...

TriggerController *	getTriggerController () const

Public Member Functions inherited from FIFE::FifeClass
	FifeClass ()

virtual	~FifeClass ()

fifeid_t	getFifeId ()
	Gets unique id of this instance inside the engine. More...

Private Member Functions
	Map (const Map &map)

Map &	operator= (const Map &map)

Private Attributes
std::string	m_id

std::string	m_filename

std::list< Layer * >	m_layers

TimeProvider	m_timeProvider

std::vector< MapChangeListener * >	m_changeListeners
	listeners for map changes More...

std::vector< Layer * >	m_changedLayers
	holds changed layers after each update More...

std::vector< Camera * >	m_cameras
	holds the cameras attached to this map More...

RenderBackend *	m_renderBackend
	pointer to renderbackend More...

std::vector< RendererBase * >	m_renderers
	holds handles to all created renderers More...

bool	m_changed
	true, if something was changed on map during previous update (layer change, creation, deletion) More...

std::map< Instance *, Location >	m_transferInstances
	holds instances which should be transferred on the next update More...

TriggerController *	m_triggerController

Detailed Description

A container of Layer(s).

The actual data is contained in Layer objects

See also: Layer

Definition at line 88 of file map.h.

Constructor & Destructor Documentation

FIFE::Map::Map	(	const std::string &	identifier,
		RenderBackend *	renderbackend,
		const std::vector< RendererBase * > &	renderers,
		TimeProvider *	tp_master = `NULL`
	)

Construct a map To add map to model, one should call Model::addMap (otherwise map is not registered with the engine properly)

Definition at line 47 of file map.cpp.

References m_triggerController.

FIFE::Map::~Map ( )

Destructor.

Definition at line 61 of file map.cpp.

References deleteLayers(), m_cameras, and m_triggerController.

FIFE::Map::Map ( const Map & map )

private

Member Function Documentation

Camera * FIFE::Map::addCamera	(	const std::string &	id,
		Layer *	layer,
		const Rect &	viewport
	)

Adds camera to the map.

The Map takes ownership of the camera so don't delete it.

Definition at line 245 of file map.cpp.

References FIFE::Camera::addRenderer(), getCamera(), m_cameras, m_renderBackend, and m_renderers.

Referenced by FIFE::MapLoader::load().

Here is the caller graph for this function:

void FIFE::Map::addChangeListener ( MapChangeListener * listener )

Adds new change listener.

Parameters

listener to add

Definition at line 230 of file map.cpp.

References m_changeListeners.

Referenced by FIFE::Camera::updateMap().

Here is the caller graph for this function:

void FIFE::Map::addInstanceForTransfer	(	Instance *	instance,
		const Location &	target
	)

Adds instance that is to be transferred to another layer.

Parameters

instance	A pointer to the instance that is to be transferred.
target	A const reference to the target location.

Definition at line 310 of file map.cpp.

References FIFE::Location::getExactLayerCoordinates(), FIFE::Location::getLayer(), m_transferInstances, FIFE::Location::setExactLayerCoordinates(), and FIFE::Location::setLayer().

Referenced by FIFE::Instance::processMovement().

Here is the caller graph for this function:

Layer * FIFE::Map::createLayer	(	const std::string &	identifier,
		CellGrid *	grid
	)

Add a Layer to this Map.

Map owns the returned pointer to the new Layer, so don't delete it!

Definition at line 86 of file map.cpp.

References m_changed, m_changeListeners, and m_layers.

Referenced by FIFE::MapLoader::load().

Here is the caller graph for this function:

void FIFE::Map::deleteLayer ( Layer * layer )

Delete a layer from the map.

Definition at line 105 of file map.cpp.

References m_changed, m_changeListeners, and m_layers.

void FIFE::Map::deleteLayers ( )

Delete all layers from the map.

Definition at line 122 of file map.cpp.

References m_changeListeners, and m_layers.

Referenced by ~Map().

Here is the caller graph for this function:

void FIFE::Map::finalizeCellCaches ( )

Creates cellcaches for this map.

Called from maploader.

Definition at line 350 of file map.cpp.

References FIFE::CellCache::createCells(), FIFE::CellCache::forceUpdate(), and m_layers.

Referenced by FIFE::MapLoader::load().

Here is the caller graph for this function:

uint32_t FIFE::Map::getActiveCameraCount ( ) const

Return the number of enabled cameras in this map.

Definition at line 299 of file map.cpp.

References m_cameras.

Camera * FIFE::Map::getCamera ( const std::string & id )

Get a camera by its identifier.

Definition at line 284 of file map.cpp.

References m_cameras.

Referenced by addCamera().

Here is the caller graph for this function:

const std::vector< Camera * > & FIFE::Map::getCameras ( ) const

Get a list containing all cameras.

Definition at line 295 of file map.cpp.

References m_cameras.

Referenced by FIFE::MapSaver::save().

Here is the caller graph for this function:

std::vector<Layer*>& FIFE::Map::getChangedLayers ( )

inline

Returns layers that were changed during previous update round.

Definition at line 178 of file map.h.

References m_changedLayers.

const std::string& FIFE::Map::getFilename ( ) const

inline

Definition at line 202 of file map.h.

References m_filename.

const std::string& FIFE::Map::getId ( ) const

inline

Get the identifier for this map.

Definition at line 104 of file map.h.

References m_id.

Referenced by FIFE::MapSaver::save().

Here is the caller graph for this function:

Layer * FIFE::Map::getLayer ( const std::string & identifier )

Get the layer with the given id.

Definition at line 73 of file map.cpp.

References m_layers.

Referenced by initializeCellCaches(), FIFE::MapLoader::load(), and FIFE::Layer::~Layer().

Here is the caller graph for this function:

uint32_t FIFE::Map::getLayerCount ( ) const

Get the overall number of layers.

Definition at line 82 of file map.cpp.

References m_layers.

Referenced by FIFE::Layer::getLayerCount(), and FIFE::Layer::getZOffset().

Here is the caller graph for this function:

const std::list<Layer*>& FIFE::Map::getLayers ( ) const

inline

Get the layers on this map.

Definition at line 120 of file map.h.

References m_layers.

Referenced by FIFE::RendererBase::activateAllLayers(), FIFE::Layer::getZOffset(), FIFE::Camera::render(), FIFE::MapSaver::save(), FIFE::MultiLayerSearch::searchBetweenTargetsMap(), FIFE::Camera::updateMap(), and FIFE::Camera::updateRenderLists().

Here is the caller graph for this function:

void FIFE::Map::getMatchingCoordinates	(	const ModelCoordinate &	coord_to_map,
		const Layer *	from_layer,
		const Layer *	to_layer,
		std::vector< ModelCoordinate > &	matching_coords
	)		const

Maps coordinate from one layer to another.

void FIFE::Map::getMinMaxCoordinates	(	ExactModelCoordinate &	min,
		ExactModelCoordinate &	max
	)

Retrieves the minimum/maximum coordinates of instances on the map.

Parameters

min	A reference to a ExactModelCoordinate that will hold the minimum coordinate.
max	A reference to a ExactModelCoordinate that will hold the maximum coordinate.

Definition at line 142 of file map.cpp.

References FIFE::Location::getMapCoordinates(), m_layers, FIFE::Location::setExactLayerCoordinates(), FIFE::PointType3D< T >::x, and FIFE::PointType3D< T >::y.

float FIFE::Map::getTimeMultiplier ( ) const

inline

Gets model speed.