positionFor3DPoint

previous: iMesh::placeLargeStaticObstacle()

Contents, API Reference, Interfaces, iMesh, positionFor3DPoint

iMesh::positionFor3DPoint()

Description

Enables you to obtain a positions on a mesh underneath a point in 3D space.

Syntax

cPosition positionFor3DPoint(const tSigned32* point) const;

Parameters

point

This parameter must point to an array of three elements.
These are interpreted as x,y,z, where z is height.

Return Value

A cPosition representing a point on the mesh directly underneath the specified 3D point.
If there is no such position then an explicitly invalid position is returned (i.e. a cPosition with cell set to -1).

Remarks

If there is no mesh face directly underneath the specified point then an invalid position is returned. (cell=-1)
If there is more than one layer of overlapping geometry directly under the point then a position on the highest layer is returned.
Layers above the point are ignored.

To obtain a position for an object that might be lying flush against the mesh it is advisable to add a small amount to the height of the 3d point passed in to these functions, to ensure the 3D point is actually above the desired ground.

Use iMesh::positionNear3DPoint() when you need to resolve points that may not be directly above the ground mesh.

See Converting to and from PathEngine's Position Representation for more information, and for an overview of all the position conversion methods.

next: iMesh::positionFor3DPointF()