Brief Index      Full Index      Events Index      I.M. Reference

Compute_Capping_Shell

Functions

HC_KEY Compute_Capping_Shell (int shell_count, const HC_KEY *shell_list, const float *plane)
 

Detailed Description

Function Documentation

HC_KEY Compute_Capping_Shell ( int  shell_count,
const HC_KEY shell_list,
const float *  plane 
)

Creates a shell in the currently open segment that contains an exact copy of the cap geometry that a plane would make when applied to the provided shells.

Parameters
shell_count- Number of shells in the shell list array.
shell_list- List of shells for which the cap(s) will be generated.
plane- An array of four floats that define the cap plane.
Returns
cap_key - The key to the shell that will contain the capping geometry.

DETAILS

This function allows developers to access the cap geometry that 3dGS creates when cutting planes are inserted into the scene and capping geometry is turned on. The capping geometry is returned as a single shell and is inserted into the currently open segment. Users must ensure that there is a valid open segment before calling this function.

NOTES

This function does not apply any modelling transforms to the supplied shells. Users must translate the shells into world space to ensure correct results. Also, the shell provided is a copy of the capping geometry and so the deletion and/or modification of the returned shell will not affect the caps in the scene.

RESTRICTIONS

This interface currently supports shell generation for cutting planes only. This function must operate on manifold shells. Non-manifold shells will not work.

See Also
Insert_Shell, Insert_Cutting_Plane, Insert_Cutting_Section

Brief Index      Full Index      Events Index      I.M. Reference