PK_REGION_imprint_point

PK_ERROR_code_t   PK_REGION_imprint_point
(
--- received arguments ---
PK_REGION_t        region,      --- region
PK_POINT_t         point,       --- point to imprint onto region

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


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


Specific Errors:
    PK_ERROR_not_general        region does not belong to a general body


The new vertex, will be an acorn vertex in 'region' and a corresponding acorn
shell will be created to contain it.  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 in the interior of
'region'.