HC_Show_Selection_Source_Elem

void HC_Show_Selection_Source_Elem(int *vertex, int *edge, int *face, Point *hit_location)
void HC_Show_Selection_Source_Elem(int vertex, int edge, int face, Point hit_location)

Returns the location on a shell where a hit would occur if that shell was moved along the vector to the nearest piece of geometry.

This function can be used in conjunction with the point returned from Show_Selection_Position() to establish the vector to the object that is closest to a given shell. This vector can then be used as input in a call to Compute_Selection_Distance_By_Shell(), to find the exact distance the shell would have to be moved before hitting another piece of geometry.

HC_Compute_Selection_Distance_By_Shell, HC_Show_Selection, HC_Show_Selection_Element, HC_Show_Selection_Position, HC_Show_Selection_Pathname, HC_Show_Selection_Keys.

Parameters

vertex: Index into the pointlist that defines the nearest vertex. Passed by reference. Returned to user.

edge: Index into the pointlist that together with point i defines the nearest edge of the hit point. Passed by reference. Returned to user.

face: Index into the facelist that defines the face where the hit occurs. Passed by reference. Returned to user.

hit_location: The exact (x, y, z) location of the hit. This coordinate is in the object space of the specified shell. Passed by reference. Returned to user.