HC_DCompute_Points_Distance_FS2
-
int
HC_DCompute_Points_Distance_FS2(int test_pcount, DPoint const test_pt[], double tolerance, int point_count1, DPoint const points1[], int face_list_length1, int const face_list1[], char const *options, double results[], int face_results[]) - int HC_DCompute_Points_Distance_FS2(int test_pcount, DPoint const test_pt, double tolerance, int point_count1, DPoint const points1, int face_list_length1, int const face_list1, char const options, double results, int face_results)
Similar to HC_DCompute_Points_Distance_F_S, but takes another parameter, int face_results[]. This parameter is returned to the caller by reference. As the normal version of this function returns ‘results’ as a distance per input point, the ‘face_results’ parameter tells you which faces each of those distances is measured from (-1 if nothing matched for the corresponding point).
Parameters
test_point_count: Number of points in the point cloud.
test_points: Vector of x-y-z triplets defining the points to be tested. Passed by reference always.
tolerance: The maximum distance, in object space, a point can be from the shell for its distance to be calculated.
point_count: Number of points in the shell that may enclose the points defined in test_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 which define 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() ). Passed by reference always.
options: a string which allows you to specify which algorithm to use to perform the calculation.
results: Array of size test_point_count that specifies the shortest distance the point contained at that index in test_points is from the supplied shell. A -1 will be returned for points which are outside the provided tolerance. Passed by reference. Returned to user.
face_results: - tells you which faces each of the distances returned in ‘results’ is measured from (-1 if nothing matched for the corresponding point). Passed by reference, returned to user.
Returns
count The number of points that were within the given tolerance to the shell.