PathEngine home previous: iMesh::newObstacleSet_WithAttributes()next: iMesh::placeLargeStatic2DObstacle()
Contents, API Reference, Interfaces, iMesh, placeAgent



Constructs an Interface iAgent object to represent placement of an object of a given shape at a point on the surface of this mesh.


std::unique_ptr<iAgent> placeAgent(const iShape& shape, const cPosition& position) const


shape The shape of the agent. This shape determines how the agent will collide.
position Where to place the agent.
This must be a valid position on this mesh.

Return Value

A newly created Interface iAgent object.


When an iAgent object is going to be used purely as an obstruction (i.e. the agent will not subsequently be moved, and no collision or pathfinding queries are going to be made through the agent), consider using iMesh::placeLargeStaticObstacle() instead, as this avoids the need to construct an iShape object and bypasses query related range constraints.

Some discussion of PathEngine's runtime shape management functionality, in general, can be found here.

See Also


C# Mapping

Agent placeAgent(Shape shape, PathEngine.Position position);

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