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_Path

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() ).

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.