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 are coincident per tolerance.


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. PK_FACE_is_coincident is not guaranteed to detect equivalence but
it will never claim two faces are equivalent when they are not.