PathEngine home previous: iMesh::findShortestPath()next: iMesh::findShortestPath_MultipleStartPositions()
Contents, API Reference, Interfaces, iMesh, findShortestPath6

iMesh::findShortestPath6()

Description

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

Syntax

iPath* findShortestPath6(const iShape* shape, const iCollisionContext* context, const cPosition& start, const cPosition& goal, iQueryCallBack* queryCallBack) 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, and must not be obstructed by the base mesh or burnt-in obstacles.
goal The target point for pathfinding.
This position must be a valid position on this mesh.
queryCallBack A pointer to a valid implementation of the iQueryCallBack interface, or else null.

Requirements

Requires that (release 6 type) pathfind preprocess has been generated on this mesh for the collision shape specified.

Return Value

A newly created Interface iPath object, if a path can be found.
Otherwise a zero pointer is returned.

Remarks

Dynamic obstacles are currently not supported with release 6 type preprocess, and the context passed in should therefore be empty.

C# Mapping

Path findShortestPath6(Shape shape, CollisionContext context, PathEngine.Position start, PathEngine.Position goal, QueryCallBack queryCallBack);

Java Mapping

Path findShortestPath6(Shape shape, CollisionContext context, Position start, Position goal, QueryCallBack queryCallBack);

Documentation for PathEngine release 6.00 - Copyright © 2002-2016 PathEnginenext: iMesh::findShortestPath_MultipleStartPositions()