iObstacleSet::getNumberOfConnectedRegions()

Description

Returns the number of distinct connected regions in the unobstructed space for a given shape.

Syntax

tSigned32 getNumberOfConnectedRegions(iShape* shape) const;

Parameters

Requirements

Requires that this obstacle set has been marked for preprocessing and that connected region queries have been enabled with the relevant preprocess generation attribute.

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

Return Value

Remarks

This method enables you to query against the set of 'semi-dynamic' obstacles in a 'preprocessed obstacle set', in addition to static geometry.
For queries against just the static geometry on this mesh (i.e. external edges and burnt in obstacles), use iMesh::getNumberOfConnectedRegions().