PK_ERROR_code_t            PK_FACE_repair
(
--- received arguments ---
PK_FACE_t                  face,     --- face
const PK_FACE_repair_o_t  *options,  --- options structure

--- returned arguments ---
PK_TOPOL_track_r_t  *const tracking  --- tracking information
)


This function attempts to repair an face, i.e. make it valid. The option
structure determines which type of repair is attempted. At present there are
two types of repair provided: splitting the face to remove G1 discontinuities
in the surface, and splitting the face to remove areas of surface
self-intersection which lie outside the face.


Specific Errors:
    PK_ERROR_su_self_intersect      self-intersecting region lies in face


This function is primarily intended for use when a model is being imported into
Parasolid via a data exchange format.

Before this function is called, PK_EDGE_repair (with option ensure_on_surfs)
must be called on all the edges of the face.

Tracking information will be returned in tracking. This is only returned if
the face is split, in which case there will be one track record recording the
split.