All Frameworks  Class Hierarchy  This Framework  Indexes

SPAintr Global Function raytest_face

hit* raytest_face(	ray&	`this_ray`,
	FACE*	`this_face`)

Tests a ray against the given face.

Role: The routine raytest fires a ray at a body and returns on the heap a list of hits or NULL if no hits are found. The heap contains the entity hit, the type of hit, and the parameter value at the hit. A value of zero for hits permitted means all hits are returned. Logicals allow shells or wires or both to be selected as targets for the ray. Only entities in the forward direction along the ray can be hit.

If the ray hits the interior of a face, the face is returned; if it hits an edge of a face (i.e., two adjacent faces), the edge is returned; and if it hits all faces adjacent at a vertex, the vertex is returned.

Limitations: A call to this routine may cause boxes to be computed and thus the model may change.

Effect: Read-only

Parameters:

this_ray: ray.
this_face: target face.

This object is included in the file: raytest.hxx