Functions | |
HC_KEY | Compute_Capping_Shell (int shell_count, const HC_KEY *shell_list, const float *plane) |
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.
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. |
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.
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.
This interface currently supports shell generation for cutting planes only. This function must operate on manifold shells. Non-manifold shells will not work.