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

iMesh::findShortestPath6_MultipleStartPositions()

Description

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

Syntax

std::unique_ptr<iPath> findShortestPath6_MultipleStartPositions(const iShape& shape, const iCollisionContext* context, cPosition const * startPositions_Buffer, uint32_t startPositions_BufferEntries, 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 nullptr for this argument.
startPositions_Buffer, startPositions_BufferEntries (See Passing Arrays.) The start positions for pathfinding.
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

Not all pathfinding features are supported, currently, with version 6 preprocess. (Ask, for more details.)

C# Mapping

Path findShortestPath6_MultipleStartPositions(Shape shape, CollisionContext context, PathEngine.Position[] startPositions, PathEngine.Position goal, QueryCallBack queryCallBack);

Documentation for PathEngine release 6.03 - Copyright © 2002-2021 PathEnginenext: iMesh::findShortestPath_MultipleStartPositions()