PK_FACE_imprint_point

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'.