iCollisionContext::getNumberOfConnectedRegions()

Description

Returns the number of connected regions in connected region preprocess associated with this object.

Syntax

int32_t getNumberOfConnectedRegions(const iShape& shape) const;

Parameters

Requirements

Requires that the collision context includes an obstacle set that is 'marked for preprocessing', or that connected region preprocess has been generated against the mesh for the query agent shape.

See Obstacle Management for details about setting up preprocessed obstacle sets.

Return Value

Remarks

If there is a preprocessed obstacle set included in this context then this query will effectively forward the query on to a call to iObstacleSet::getNumberOfConnectedRegions() for that obstacle set.

Otherwise the query will be forwarded on to base mesh connected region preprocess iMesh::getNumberOfConnectedRegions().

C# Mapping

int getNumberOfConnectedRegions(Shape shape);