PK_FACE_is_coincident

PK_ERROR_code_t                  PK_FACE_is_coincident
(
--- received arguments ---
PK_FACE_t                        face1,         --- first face
PK_FACE_t                        face2,         --- second face
double                           tol,           --- distance tolerance
const PK_FACE_is_coincident_o_t *options,       --- option structure

--- returned arguments ---
PK_FACE_coi_t             *const result,        --- coincidence information
PK_VECTOR_t               *const point          --- non-coincidence point
)


This function checks if two faces, possibly under transformation,  are
coincident to tolerance.

This function does not support facet geometry [NF]


For two faces to be considered coincident they must have similar corresponding
loops and all points on one face must be within tolerance of the other face
and vice versa. The possible values of result are described in the
documentation for PK_FACE_coi_t. In some cases of non-coincidence a
position vector is returned in 'point' indicating where the faces are
different. If transforms are supplied to the function then this position vector
represents the point on the face before transformation. PK_FACE_is_coincident
is not guaranteed to detect equivalence but it should not claim two faces are
equivalent when they are not. General affine transformations or those with a
perspective or scaling term are not allowed.