findPathAway

previous: iMesh::findClosestUnobstructedPosition()

next: iMesh::findPathAway_WithQueryCallBack()

Contents, API Reference, Interfaces, iMesh, findPathAway

iMesh::findPathAway()

Description

Finds the shortest path of escape from a specified region from a given start position.

Syntax

iPath* findPathAway(iShape* shape, const iCollisionContext* context, const cPosition& start, const cPosition& awayFrom, tSigned32 distanceAway) const;

Parameters

	shape		The collision shape to use for this query.
	context		The state of dynamic collision that will apply for this query. An empty context can be specified by passing a value of zero for this argument.
	start		The start point for pathfinding. This position must be a valid position on this mesh. This start point must be unobstructed.
	awayFrom		A position defining the centre of a region to escape from. This position must be a valid position on this mesh.
	distanceAway		Controls the size of the region to escape from. Must be greater than zero.

Requirements

Requires that pathfinding preprocess has been generated on this mesh for the collision shape specified.

Return Value

Always returns a newly created Interface iPath object.
If pathfinding fails then this path will be empty.

Remarks

Calling this method is functionally equivalent to calling iMesh::findPathAway_WithQueryCallBack(), with null for the callback parameter.

next: iMesh::findPathAway_WithQueryCallBack()