iPath

PathEngine home

previous: iObstacleSet::updatePathfindingPreprocessFor()

next: iPath::advanceAlong()

Contents, API Reference, Interfaces, iPath

Interface iPath

Description

A sequence of positions on a mesh. Returned by Pathfinding queries.

Defined in SDKRoot/include/i_pathengine.h.

Pooling

iPath objects are pooled internally, with iPathEngine::setPathPoolParameters() providing control over the pool parameters.

Special cases

Paths with one position are used to indicate that an agent has arrived at their target or are already at their target when a pathfinding query is made.
Since release 5.00, paths always contain one or more positions.

Construction and Deletion

iPath objects are generally constructed and returned by pathfinding queries, but can also be constructed directly by calling iMesh::constructPath() or iMesh::constructPath_Reversed().
iPath objects can be deleted explicitly by calling delete on the pointer or by calling the object's destroy() function. All iPath objects are deleted by a call to iPathEngine::deleteAllObjects().
A pointer to an iPath object must not be used after the object has been deleted.

All paths created on a mesh get destroyed automatically when the mesh is destroyed.

Methods:

advanceAlong		Provides the same functionality as iAgent::advanceAlongPathWithPrecision(), but without requiring creation of an iAgent.
connectionIndex		Enables the client application to determine whether a given segment in a path corresponds to an 'off-mesh connection'.
getConnectionIndexArray		Returns a pointer to a buffer containing all of the connection indices in the path.
getLength		Returns the total length of the path.
getPositionArray		Returns a pointer to a buffer containing all of the positions in the path.
position		Returns a position in the path at a specified index.
renderOnGround		A helper method for drawing paths flush with the surface of the 3D ground mesh.
size		Returns the number of points that comprise the path.

next: iPath::advanceAlong()