HC_Compute_Selection_By_Shell
-
int
HC_Compute_Selection_By_Shell(char const *action, char const *start_seg, int point_count, Point const points[], int face_list_length, int const face_list[]) - int HC_Compute_Selection_By_Shell(char const action, char const start_seg, int point_count, Point const points, int face_list_length, int const face_list)
Forces a selection event between the supplied shell and a specified portion of a segment tree.
To allow for fast computation of Compute_Selection_By_Shell(), shells from start_seg can be cross-referenced with spatial data structures (oct trees and/or bsp trees) that are retained between successive computations. To use this functionality, the selection event must be surrounded by calls to Begin_Shell_Selection() and End_Shell_Selection().
This function is identical to Compute_Selection_By_Key(), except that is does not require a shell to already exist.
Use of Begin_Shell_Selection() constitutes a promise not to perform certain operations on anything contained in the segment tree until after the matching call to End_Shell_Selection(). See Begin_Shell_Selection() for details on the restrictions imposed.
Only facetted geometries such as shells, meshes, NURBS surfaces, polygons, and polycylinders are selectable.
If the shell has a hole, the hole is ignored for selection purposes. Visualize version 20 and above remove this restriction.
HC_Compute_Selection_By_Key, HC_Compute_Selection, HC_Begin_Shell_Selection, HC_End_Shell_Selection
Parameters
action: One of “v”, “^”, “*”, or “O”. Action is compared against the selectability attribute settings as testing proceeds. See Set_Selectability() for a detailed explanation of actions.
start_seg: A segment in the tree at which to start selection testing.
point_count: Number of points in the shell that may enclose the points defined in points.
points: Vector of x-y-z triplets for the coordinates of the vertices to be used to build the shell. (A simple N x 3 array may also be used). Passed by reference always.
face_list_length: Size of the array of integers that defines the faces in face_list.
face_list: Encoded description of how to connect the points to build the faces of the shell (see Insert_Shell() ).
Returns
count The number of objects that are touched by any part of the specified geometry.