PathEngine home previous: iMesh::findPathAway_WithQueryCallBack()next: iMesh::findShortestPath_WithQueryCallBack()
Contents, API Reference, Interfaces, iMesh, findShortestPath

iMesh::findShortestPath()

Description

Finds the shortest path from a given start position to a given end position for agents with a specified collision shape.

Syntax

iPath* findShortestPath(iShape* shape, const iCollisionContext* context, const cPosition& start, const cPosition& goal) 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.
goal The target point for pathfinding. This position must be a valid position on this mesh.

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::findShortestPath_WithQueryCallBack(), with null for the callback parameter.


Documentation for PathEngine release 5.17 - Copyright © 2002-2008 PathEnginenext: iMesh::findShortestPath_WithQueryCallBack()