HC_Compute_Points_Distance_F_S2
-
int
HC_Compute_Points_Distance_F_S2(int test_pcount, Point const test_pt[], double tolerance, int point_count1, Point const points1[], int face_list_length1, int const face_list1[], char const *options, float results[], int face_results[]) - int HC_Compute_Points_Distance_F_S2(int test_pcount, Point const test_pt, double tolerance, int point_count1, Point const points1, int face_list_length1, int const face_list1, char const options, float results, int face_results)
Similar to HC_Compute_Points_Distance_F_Sh, 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.