Ensures all regions that need to be loaded are. More...

#include <zonehandler.h>

Public Member Functions
void	HandleDelayAndAnim (int32_t loadDelay, csVector2 start, csVector2 dest, csString background, csString widgetName)
	Handles delay and dot animation.
void	HandleMessage (MsgEntry *me)
	Handles messages from the server.
bool	IsLoading () const
	Returns if this is loading a zone.
bool	IsValid () const
	Returns whether the zone handler is valid.
void	LoadZone (csVector3 pos, float yrot, const char *sector, csVector3 vel, bool force=false)
	Loads a zone and places the user into it.
void	MovePlayerTo (const csVector3 &Pos, float yRot, const csString &newSector, const csVector3 &Vel)
	Moves player to given location.
void	OnDrawingFinished ()
	Called after drawing on screen has finished.
	ZoneHandler (MsgHandler mh, psCelClient cc)
	Basic constructor.
virtual	~ZoneHandler ()
	Basic deconstructor.
Protected Member Functions
bool	FindLoadWindow (bool force=false, const char *widgetName="LoadWindow")
	Finds the loading window.
ZoneLoadInfo *	FindZone (const char *sector) const
	Finds load info for a specific sector.
bool	LoadZoneInfo ()
	Extracts zone information out of a XML.
Protected Attributes
psCelClient *	celclient
	Pointer to cel client instance.
csString	forcedBackgroundImg
	String which holds the background of the loading screen.
csTicks	forcedLoadingEndTime
	Holds how long the loading shall be delayed.
csTicks	forcedLoadingStartTime
	Holds how long the loading shall be delayed.
csString	forcedWidgetName
	Holds the widget name used to replace the load window.
size_t	loadCount
	The number of items that are being loaded.
bool	loading
	Whether a new zone is currently being loaded.
pawsProgressBar *	loadProgressBar
	Used for showing users load progress.
pawsLoadWindow *	loadWindow
	A load window that can be shown to users while loading.
psMoveState	moveState
csRef< MsgHandler >	msghandler
	Message Handler to subscribe to.
csVector3	newPos
	The target location the player will move to after loading.
csVector3	newVel
	The velocity the player will have after loading.
float	newyrot
	The rotation the player will have after loading.
csString	sectorToLoad
	The sector that needs to be loaded.
bool	valid
	Whether the loading was successful.
csHash< ZoneLoadInfo , const char >	zonelist
	Mapping of names of zones to their load info.

Detailed Description

Ensures all regions that need to be loaded are.

Listens for crossing sector boundaries and makes sure that we have all the right stuff loaded in each zone.

Definition at line 105 of file zonehandler.h.

Constructor & Destructor Documentation

ZoneHandler::ZoneHandler	(	MsgHandler *	mh,
		psCelClient *	cc
	)

Basic constructor.

Sets initial values and calls LoadZoneInfo(). Sets valid to true if everything checked out good

Parameters:

mh	The message handler to subscribe messages to
cc	Used to get player information out of

virtual ZoneHandler::~ZoneHandler ( ) [virtual]

Basic deconstructor.

Member Function Documentation

bool ZoneHandler::FindLoadWindow	(	bool	force = `false`,
		const char *	widgetName = `"LoadWindow"`
	)		`[protected]`

Finds the loading window.

Checks if there is a loading window. If there is not a loading window or the loading window does not have a progress bar, false is returned.

Parameters:

force	If true it will force the window to be searched even if we have it already
widgetName	if defined it will hook the loading windows to the defined name

Returns:: True if a valid window was found, false otherwise.

ZoneLoadInfo* ZoneHandler::FindZone ( const char * sector ) const [protected]

Finds load info for a specific sector.

Searches zonelist for the key specified in sector. If it is not found null is returned and an error is printed

Parameters:

sector The sector to look for

Returns:: The load info for the sector or null

void ZoneHandler::HandleDelayAndAnim	(	int32_t	loadDelay,
		csVector2	start,
		csVector2	dest,
		csString	background,
		csString	widgetName
	)

Handles delay and dot animation.

Parameters:

loadDelay	Delay of loading screen
start	Start of dot animation
dest	Destination of dot animation
background	The loading background
widgetName	The name of the widget to use for this loading.

void ZoneHandler::HandleMessage ( MsgEntry * me ) [virtual]

Handles messages from the server.

Handles psNewSectorMessage by loading the target zone and will call ForceLoadScreen if there is no load delay

Parameters:

me	The message to create the psNewSectorMessage out of

Implements psClientNetSubscriber.

bool ZoneHandler::IsLoading ( ) const [inline]

Returns if this is loading a zone.

Returns:: loading

Definition at line 175 of file zonehandler.h.

bool ZoneHandler::IsValid ( ) const [inline]

Returns whether the zone handler is valid.

Returns:: valid

Definition at line 184 of file zonehandler.h.

void ZoneHandler::LoadZone	(	csVector3	pos,
		float	yrot,
		const char *	sector,
		csVector3	vel,
		bool	force = `false`
	)

Loads a zone and places the user into it.

After the zone is found (from the sector parameter), the player is moved to a temporary off screen location. While there the loading screen is displayed and the zone is loaded. After the zone has finished loading, the player is moved to the target position.

Parameters:

pos	The target position in the new zone
yrot	The target rotation angle in the new zone
sector	The name of the target zone
vel	Target velocity
force	Whether to force the loading of the target zone

bool ZoneHandler::LoadZoneInfo ( ) [protected]

Extracts zone information out of a XML.

Checks "/planeshift/data/zoneinfo.xml" for a valid XML. Each element named "zone" under "zonelist" has a ZoneLoadInfo created out of it. All ZoneLoadInfo are then added to zonelist based on their sector