HC_Compute_Selection_By_Sh_W_Op
-
int
HC_Compute_Selection_By_Sh_W_Op(char const *action, char const *start_seg, int point_count, Point const points[], int face_list_length, int const face_list[], char const *options) - int HC_Compute_Selection_By_Sh_W_Op(char const action, char const start_seg, int point_count, Point const points, int face_list_length, int const face_list, char const options)
Allows users to set additional criteria that should be considered when performing a selection event between the supplied shell and a specified portion of a segment tree.
This function performs exactly like Compute_Selection_By_Shell() except that the options string gives users more control over the internal selection algorithm.
The following choices for options are recognized:
clearance = x
A floating point value in object-relative units (oru) which defines how far away a shell can be from the input shell and still be regarded as “clashing”. The default value is “clearance = 0”.
tolerance = x
A floating point value in object-relative units (oru) that determines how far two shells can penetrate and still not be regarded as “clashing” (this is also know as a soft clash). A special value “tolerance = -1” specifies a tolerance based on the bounding boxes of the two shells involved in the clash. The value “tolerance = 0” indicates that penetrating geometry as well as coincident geometry (geometry that touches but does not penetrate) is considered to be a clash. The default value is “no tolerance” which means that coincident geometry will not cause a clash.
If the ‘tolerance’ value and/or selection shells (“probes”) meet any of the following criteria, false positives or negatives may result:
- The tolerance is much larger than the actual intersection of the shells. An example would be a shell that represents a thin plate or a thinly-walled tube, and the tolerance is larger than the thickness of the plate or tube.
- Selection shells have vertices with complex intersections.
- Selection shells have concavities, especially multiple adjacent concavities.
NOTE: If “clearance” is specified, any “tolerance” setting will be ignored.
HC_Compute_Swept_Shell, HC_Compute_Swept_Shell_Along_PathParameters
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() ).
options: A string through which a user can set options that affect the selections.
Returns
count The number of objects that are touched by any part of the specified geometry.