PK_ERROR_code_t   PK_FACE_imprint_point
(
--- received arguments ---
PK_FACE_t          face,        --- face
PK_POINT_t         point,       --- point to imprint onto face

--- returned arguments ---
PK_VERTEX_t *const new_vertex   --- new vertex
)


This function imprints a point onto a face, thereby creating a new vertex.


The new vertex will be an isolated vertex of face and a new isolated loop
will be created to contain it.  The body of face may be a sheet, solid or
general body.  If point was an orphan then it will be attached to the new
vertex.  If point was not an orphan, then a copy of it will be attached to
the new vertex.

The function does not check that point does in fact lie on the surface of
face or that it is inside face.