autoGenerateConnections

Contents, API Reference, Interfaces, iMesh, autoGenerateConnections

iMesh::autoGenerateConnections()

Description

Enables automatic generation of off-mesh connections based on the generation of sample points around the mesh edge and a callback object that determines whether connection is possible for a given pair of sample points.

Syntax

void autoGenerateConnections(tSigned32 sampleSpacing, tSigned32 localityConstraint, tSigned32 horizontalRange, tSigned32 verticalRange, tSigned32 dropRange, iConnectionTestCallBack& callBack);

Parameters

	sampleSpacing		The distance to allow between the set of sample points that will be generated around the edge of the mesh.
	localityConstraint		The number of samples points to step past around the mesh edge before starting to consider connections.
	horizontalRange		The maximum horizontal distance possible for jump type connections.
	verticalRange		The maximum vertical distance possible for jump type connections.
	dropRange		The maximum vertical distance possible for drop down type connections.
	callBack		Pointer to an object derived from Interface iConnectionTestCallBack, which will be called to assess the possibility for connection between pairs of candidate points.

Remarks

Off-mesh connections will be added to this mesh for each connection generated and permitted by the connection test callback.

This method provides prototype functionality for automatic generation of off-mesh connection candidates across gaps between ground mesh pieces and at points where agents may be able to drop off the mesh edge onto ground below.
This prototype functionality is currently subject to review, and may be changed in future releases.

next: iMesh::buildCollideAndSlidePath()