#include <positiononlivepath.h>

Class Description

This class aggregates all necessary information to describe a position on a LivePath, namely:

a PositionOnPath and
PathEventList related information.

Be careful with instances of this class: they are intended to be kept alive but, up to now, only the instance in Bot is maintained accordingly to LivePath updates. As a consequence, all the other instances can not be used through several frames.

You are not intended to create or manage instances of this class. Nevertheless, it is fully documented since you will probably need to read and interpret it.

Examples:: gamekit/Tutorial_CrowdDispersion.cpp.

Main API Functions
	PositionOnLivePath ()

void	BindToPathEventList (PathEventList *pathEventList)

PathEventList *	GetPathEventList () const

void	Clear ()

void	ClearEventListLocation ()

Comparison Operators
bool	operator== (const PositionOnLivePath &positionOnLivePath) const

bool	operator!= (const PositionOnLivePath &positionOnLivePath) const

Raw Path Related Functions
Path *	GetPath ()

const Path *	GetPath () const

const Vec3f &	GetPosition () const

const PositionOnPath &	GetPositionOnPath () const

PositionOnPathStatus	GetPositionOnPathStatus () const

PathEdgeType	GetPathEdgeType () const

bool	IsAtFirstNodeOfPath () const

bool	IsAtLastNodeOfPath () const

bool	IsAtFirstEdgeOfPath () const

bool	IsAtLastEdgeOfPath () const

KyUInt32	GetPathEdgeIndex () const

KyUInt32	GetEdgeIdxToMoveOnForward () const

PathEdgeType	GetEdgeTypeToMoveOnForward () const

PathEdgeType	GetEdgeTypeToMoveOnBackward () const

KyUInt32	GetEdgeIdxToMoveOnBackward () const

bool	DoesPrecede (const PositionOnLivePath &other) const

bool	IsStrictlyBefore (const PositionOnLivePath &other) const

PositionOnLivePath initialization on Path----------------------------------
void	InitOnPathFirstNode (Path *path)

void	InitOnPathLastNode (Path *path)

void	InitOnPathNode (Path *path, KyUInt32 pathNodeIdx)

void	InitOnPathEdge (Path *path, const Vec3f &positionOnEdge, KyUInt32 pathEdgeIdx)

void	InitOnPositionOnPath (const PositionOnPath &positionOnPath)

void	FindLocationOnEventListFromScratch ()

OnEventListStatus	GetOnEventListStatus () const

PathEvent	GetPathEvent (KyUInt32 pathEventIdx) const

PathEvent	GetCurrentPathEvent () const

KyUInt32	GetOnEventListIndex () const

KyUInt32	GetNextPathEventIdx () const

KyUInt32	GetPrevPathEventIdx () const

bool	IsAtLowerBoundOfLivePath () const

bool	IsAtUpperBoundOfLivePath () const

bool	IsAtACheckPoint () const

const PositionOnPath *	GetUpcomingEventPositionOnPath () const

const NavTag *	GetCurrentOrNextNavTag () const

const NavTag *	GetCurrentOrPreviousNavTag () const

Move Functions
void	MoveForward (KyFloat32 distanceMove)

void	MoveBackward (KyFloat32 distanceMove)

void	MoveForward_StopAtPathNode (KyFloat32 distanceMove)

void	MoveBackward_StopAtPathNode (KyFloat32 distanceMove)

void	MoveForward_StopAtEvent (KyFloat32 distanceMove)

void	MoveBackward_StopAtEvent (KyFloat32 distanceMove)

void	MoveForward_StopAtEventOrAtPathNode (KyFloat32 distanceMove)

void	MoveBackward_StopAtEventOrAtPathNode (KyFloat32 distanceMove)

void	MoveToNextEventOrPathNode ()

void	MoveToPrevEventOrPathNode ()

void	MoveForward_StopAtCheckPoint (KyFloat32 distanceMove)

void	MoveForwardToNextPathNode ()

void	MoveBackwardToPrevPathNode ()

void	MoveToPathEvent (KyUInt32 pathEventIdx)

void	MoveForwardToNextPathEvent ()

void	MoveBackwardToPrevPathEvent ()

void	MoveForwardToNextPathEdge ()

void	MoveBackwardToPrevPathEdge ()

void	MoveForwardToNextPathEventInterval ()

void	MoveForwardToNextCheckPoint ()

void	MoveBackwardToPrevCheckPoint ()

KyFloat32	MoveForwardToClosestPositionOnPath (const Vec3f &position)

void	MoveForwardToNextPathEventWithPredicate (IMovePositionOnLivePathPredicate *predicate)

void	MoveBackwardToPreviousEventWithPredicate (IMovePositionOnLivePathPredicate *predicate)

void	SetNewPositionOnPathForward (const PositionOnPath &newPositionOnPathForward)

void	SetNewPositionOnPathBackward (const PositionOnPath &newPositionOnPathBackward)

Move Functions with Cost
template<class TraverseLogic >
void	MoveForwardAndGetCost_StopAtEventOrAtPathNode (void *traverseLogicUserData, KyFloat32 distanceMove, RayCanGoMarginMode rayCanGoMarginMode, KyFloat32 &cost)

Unsafe Version of Functions
These functions are unsafe in regard to the pre-conditions mentioned in the functions of similar name without the _Unsafe prefix.
KyUInt32	GetNextPathEventIdx_Unsafe () const

KyUInt32	GetPrevPathEventIdx_Unsafe () const

void	MoveForwardToNextPathEvent_Unsafe ()

void	MoveBackwardToPrevPathEvent_Unsafe ()

void	MoveForwardToNextPathEventInterval_Unsafe ()

Deprecated functions
const NavTag *	GetUpcomingEventNavTag () const

const NavTag *	GetPreviousEventNavTag () const

Member Function Documentation

bool Kaim::PositionOnLivePath::DoesPrecede ( const PositionOnLivePath & other ) const

inline

Returns true when this PositionOnLivePath precede or is at same position on the Path that the other one.

It just test the PositionOnPath, it does not consider the location on the event list.

void Kaim::PositionOnLivePath::FindLocationOnEventListFromScratch ( )

This function computes the location on the PathEventList from the PositionOnPath.

const NavTag * Kaim::PositionOnLivePath::GetCurrentOrNextNavTag ( ) const

inline

Returns a pointer to the navTag along the path after the position on path.

If position on path is on a PathEvent, it returns the NavTag between this PathEvent and the next PathEvent. If it lies strictly within two PathEvents, it returns the NavTag along this PathEventInterval Note: if position on path is at the upper bound of the validity interval, it will return KY_NULL.

const NavTag * Kaim::PositionOnLivePath::GetCurrentOrPreviousNavTag ( ) const

inline

Returns a pointer to the navTag along the path before the position on path.

If position on path is on a PathEvent, it returns the NavTag between this PathEvent and the previous PathEvent. If it lies strictly within two PathEvents, it returns the NavTag along this PathEventInterval Note: if position on path is at the lower bound of the validity interval, it will return KY_NULL.

KyUInt32 Kaim::PositionOnLivePath::GetEdgeIdxToMoveOnBackward ( ) const

inline

If this in on a Path node, it returns the index of the edge ending at this Path node, else it returns the index of the edge it lies on.

Precondition: Current instance must not be at the first node of the path.

KyUInt32 Kaim::PositionOnLivePath::GetEdgeIdxToMoveOnForward ( ) const

inline

If this in on a Path node, it returns the index of the edge starting at this path node, else it returns the index of the edge it lies on.

Precondition: Current instance must not be at the last node of the path.

PathEdgeType Kaim::PositionOnLivePath::GetEdgeTypeToMoveOnBackward ( ) const

inline

return the type of the edge given by GetEdgeIdxToMoveOnBackward()

PathEdgeType Kaim::PositionOnLivePath::GetEdgeTypeToMoveOnForward ( ) const

inline

return the type of the edge given by GetEdgeIdxToMoveOnForward()

KyUInt32 Kaim::PositionOnLivePath::GetNextPathEventIdx ( ) const

inline

This function has to be used carefully:

if this in on an PathEvent different from the UpperBound, it returns the index of the next PathEvent,
if this in on an EventInterval, it returns the index of the ending PathEvent.

Can return KyUInt32MAXVAL if current instance is on the Upper bound or if it is not located on the PathEventList. if IsEventListStatusValid() == false, does nothing

KyUInt32 Kaim::PositionOnLivePath::GetOnEventListIndex ( ) const

inline

This function has to be used carefully:

if the GetOnEventListStatus() == OnEvent, it returns the index of the PathEvent in the PathEventList,
if the GetOnEventListStatus() == OnEventInterval, it returns the index of the PathEventInterval in the PathEventList.

KyUInt32 Kaim::PositionOnLivePath::GetPathEdgeIndex ( ) const

inline

If this is at a Path node, it returns the index of the edge ending at this Path node, except if it is at the first Path node, in which case it returns the first edge index (0).

If this is on a Path edge it returns the index of the edge it lies on.

KyUInt32 Kaim::PositionOnLivePath::GetPrevPathEventIdx ( ) const

inline

This function has to be used carefully:

if this in on an PathEvent different from the LowerBound, it returns the index of the previous PathEvent,
if this in on an EventInterval, it returns the index of the starting PathEvent.

Can return KyUInt32MAXVAL if current instance is on the Upper bound or if it is not located on the PathEventList. if IsEventListStatusValid() == false, does nothing

const PositionOnPath * Kaim::PositionOnLivePath::GetUpcomingEventPositionOnPath ( ) const

inline

Returns a pointer to the PositionOnPath along the path after positionOnLivePath.

If positionOnLivePath is on a PathEvent, it returns the current PositionOnPath of the event. If it lies strictly within two PathEvents, it returns the PositionOnPath at the end of this PathEventInterval Note: if position on path is at the upper bound of the validity interval, it will return KY_NULL.

void Kaim::PositionOnLivePath::InitOnPathFirstNode ( Path * path )

inline

The 5 Init functions initialize the positionOnPath, but they also clear all the data concerning the location on the PathEventList.

You can then call FindLocationOnEventListFromScratch() to have this object on a valid state.

bool Kaim::PositionOnLivePath::IsAtACheckPoint ( ) const

inline

Indicates if the PositionOnLIvePath is at an event that is a check point.

bool Kaim::PositionOnLivePath::IsStrictlyBefore ( const PositionOnLivePath & other ) const

inline

Returns true when this PositionOnLivePath precede than the other one; returns false if it as as the same pos.

It just test the PositionOnPath, it does not consider the location on the event list.

Examples:: gamekit/Tutorial_CrowdDispersion.cpp.

void Kaim::PositionOnLivePath::MoveBackward ( KyFloat32 distanceMove )

inline

This function moves backward the position along distanceMove meters measured on the broken-line.

If the LowerBound of the PathValidityInterval is reached, this instance is stopped at this lower bound.

Precondition: distanceMove >= 0.0f if IsEventListStatusValid() == false, does nothing

void Kaim::PositionOnLivePath::MoveBackward_StopAtEvent ( KyFloat32 distanceMove )

inline

This function moves backward the position along distanceMove meters measured on the broken-line.

If a PathEvent is reached before covering the distanceMove, this instance is stopped at this path event.

Precondition: distanceMove >= 0.0f if IsEventListStatusValid() == false, does nothing

void Kaim::PositionOnLivePath::MoveBackward_StopAtEventOrAtPathNode ( KyFloat32 distanceMove )

inline

This function moves backward the position along distanceMove meters measured on the broken-line.

If a PathEvent or a Path node is reached before covering the distanceMove, this instance is stopped at this PathEvent or Path node.

Precondition: distanceMove >= 0.0f if IsEventListStatusValid() == false, does nothing

void Kaim::PositionOnLivePath::MoveBackward_StopAtPathNode ( KyFloat32 distanceMove )

inline

This function moves backward the position along distanceMove meters measured on the broken-line.

If a Path node is reached before covering the distanceMove, this instance is stopped at this Path node.

If the LowerBound of the PathValidityInterval is reached, this instance is stopped at this lower bound.

Precondition: distanceMove >= 0.0f if IsEventListStatusValid() == false, does nothing

void Kaim::PositionOnLivePath::MoveBackwardToPrevCheckPoint ( )

This function moves backward the position up to the previous path event that is a check point.

If located on the LowerBound, does nothing. if IsEventListStatusValid() == false, does nothing

void Kaim::PositionOnLivePath::MoveBackwardToPreviousEventWithPredicate ( IMovePositionOnLivePathPredicate * predicate )

This function will move positionOnLivePath backward until the predicate returns false.

If it reaches the LowerBound, it stops.

void Kaim::PositionOnLivePath::MoveBackwardToPrevPathEdge ( )

inline

This function moves forward the position up to the start of the next path edge.

If located on the LowerBound, does nothing. if IsEventListStatusValid() == false, does nothing.

void Kaim::PositionOnLivePath::MoveBackwardToPrevPathEvent ( )

inline

This function moves backward the position up to the previous path event.

If located on the LowerBound, does nothing. if IsEventListStatusValid() == false, does nothing.

void Kaim::PositionOnLivePath::MoveBackwardToPrevPathNode ( )

inline

This function moves backward the position up to the previous Path node.

If located on the LowerBound, does nothing. if IsEventListStatusValid() == false, does nothing.

void Kaim::PositionOnLivePath::MoveForward ( KyFloat32 distanceMove )

inline

This function moves forward the position along distanceMove meters measured on the broken-line.

If the UpperBound of the PathValidityInterval is reached, this instance is stopped at this upper bound.

Precondition: distanceMove >= 0.0f if IsEventListStatusValid() == false, does nothing

void Kaim::PositionOnLivePath::MoveForward_StopAtCheckPoint ( KyFloat32 distanceMove )

inline

This function moves forward the position along distanceMove meters measured on the broken-line.

If a PathEvent which is a checkpoint is reached before covering the distanceMove, this instance is stopped at this path event.

If located on the UpperBound, does nothing.

Precondition: distanceMove >= 0.0f if IsEventListStatusValid() == false, does nothing

void Kaim::PositionOnLivePath::MoveForward_StopAtEvent ( KyFloat32 distanceMove )

inline

This function moves forward the position along distanceMove meters measured on the broken-line.

If a PathEvent is reached before covering the distanceMove, this instance is stopped at this path event.

Precondition: distanceMove >= 0.0f if IsEventListStatusValid() == false, does nothing

void Kaim::PositionOnLivePath::MoveForward_StopAtEventOrAtPathNode ( KyFloat32 distanceMove )

inline

This function moves forward the position along distanceMove meters measured on the broken-line.

If a PathEvent or a Path node is reached before covering the distanceMove, this instance is stopped at this PathEvent or Path node.

Precondition: distanceMove >= 0.0f if IsEventListStatusValid() == false, does nothing

void Kaim::PositionOnLivePath::MoveForward_StopAtPathNode ( KyFloat32 distanceMove )

inline

This function moves forward the position along distanceMove meters measured on the broken-line.

If a Path node is reached before covering the distanceMove, this instance is stopped at this Path node.

If the UpperBound of the PathValidityInterval is reached, this instance is stopped at this upper bound.

Precondition: distanceMove >= 0.0f if IsEventListStatusValid() == false, does nothing

template<class TLogic >

void Kaim::PositionOnLivePath::MoveForwardAndGetCost_StopAtEventOrAtPathNode	(	void *	traverseLogicUserData,
		KyFloat32	distanceMove,
		RayCanGoMarginMode	rayCanGoMarginMode,
		KyFloat32 &	cost
	)

inline

This function moves forward the position along distanceMove meters measured on the broken-line.

If a PathEvent or a Path node is reached before covering the distanceMove, this instance is stopped at this PathEvent or Path node. It compute the cost that corresponds to that move according to the the NavTag and the cost multipliers of the TraverseLogic

Precondition: distanceMove >= 0.0f if IsEventListStatusValid() == false, does nothing

KyFloat32 Kaim::PositionOnLivePath::MoveForwardToClosestPositionOnPath ( const Vec3f & position )

inline

Move forward to the closest position on path from originalPosition.

Returns the distance between position and the positionOnPath found.

If located on the LowerBound, does nothing. if IsEventListStatusValid() == false, does nothing.

void Kaim::PositionOnLivePath::MoveForwardToNextCheckPoint ( )

This function moves forward the position up to the next path event that is a check point.

Precondition: This current instance must not be located on the UpperBound. if IsEventListStatusValid() == false, does nothing.

void Kaim::PositionOnLivePath::MoveForwardToNextPathEdge ( )

inline

This function moves forward the position up to the start of the next path edge.

If located on the UpperBound, does nothing. if IsEventListStatusValid() == false, does nothing.

void Kaim::PositionOnLivePath::MoveForwardToNextPathEvent ( )

inline

This function moves forward the position up to the next path event.

If located on the UpperBound, does nothing. if IsEventListStatusValid() == false, does nothing.

void Kaim::PositionOnLivePath::MoveForwardToNextPathEventInterval ( )

inline

This function moves forward the position up to the next path event interval.

If located on the UpperBound, does nothing. if IsEventListStatusValid() == false, does nothing.

void Kaim::PositionOnLivePath::MoveForwardToNextPathEventWithPredicate ( IMovePositionOnLivePathPredicate * predicate )

This function will move positionOnLivePath forward until the predicate returns false.

If it reaches the UpperBound, it stops.

void Kaim::PositionOnLivePath::MoveForwardToNextPathNode ( )

inline

This function moves forward the position up to the next Path node.

If located on the UpperBound, does nothing. if IsEventListStatusValid() == false, does nothing.

void Kaim::PositionOnLivePath::MoveToNextEventOrPathNode ( )

inline

This function moves forward the position until an event or a pathNode is reached.

void Kaim::PositionOnLivePath::MoveToPathEvent ( KyUInt32 pathEventIdx )

inline

This function moves the position to the specified path event.

if IsEventListStatusValid() == false, does nothing.

void Kaim::PositionOnLivePath::MoveToPrevEventOrPathNode ( )

inline

This function moves backward the position until an event or a pathNode is reached.

void Kaim::PositionOnLivePath::SetNewPositionOnPathBackward ( const PositionOnPath & newPositionOnPathBackward )

inline

Moves this PositionOnLivePath backward to the provided PositionOnPath and updates PathEventList related informations.

Precondition: This current instance must be located after newPositionOnPathBackward.

void Kaim::PositionOnLivePath::SetNewPositionOnPathForward ( const PositionOnPath & newPositionOnPathForward )

inline

Moves this PositionOnLivePath forward to the provided PositionOnPath and updates PathEventList related informations.

Precondition: This current instance must be located before newPositionOnPathForward.

The documentation for this class was generated from the following files:

gwnavruntime/path/positiononlivepath.h
gwnavruntime/path/positiononlivepath.inl

Kaim::PositionOnLivePath Class Reference

Class Description

Main API Functions

Comparison Operators

Raw Path Related Functions

PositionOnLivePath initialization on Path----------------------------------

Move Functions

Move Functions with Cost

Unsafe Version of Functions

Deprecated functions

Member Function Documentation