PK_FACE_reverse

PK_ERROR_code_t           PK_FACE_reverse
(
--- received arguments ---
int                        n_faces,    --- number of faces
const PK_FACE_t            faces[],    --- faces
const PK_FACE_reverse_o_t *options     --- options
)


This function reverses the orientation of a given set of faces, but will
not change any of their associated geometry.


Specific Errors:

    PK_ERROR_not_in_same_body   (MILD)  faces belong to different bodies

    PK_ERROR_wrong_entity       (MILD)  faces do not belong to a general body



For each face in the array 'faces', their orientation gets reversed and their
front and back shells get swapped. In terms of their edges, the loops on the
faces get reversed, and the fins have their orientation flipped. Note that
this function only changes the topology of the faces, their geometry and
associated body's type remains unaltered.

The function only supports general bodies, provided all the faces
in the array are from the same body.