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.

  1. 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.

  2. Only facetted geometries such as shells, meshes, NURBS surfaces, polygons, and polycylinders are selectable.

  3. 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.