PK_VERTEX_remove_edge

PK_ERROR_code_t    PK_VERTEX_remove_edge
(
--- received arguments ---
PK_VERTEX_t        vertex,     --- vertex to split
PK_EDGE_t          edge,       --- wireframe edge incident with vertex

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


This function cuts a body at a given vertex.


A new vertex is created to replace 'vertex' on 'edge', introducing a cut in the
body.  'Edge' should be wireframe.  If the body is split into two pieces as a
result of being cut at 'vertex', a new body will be created only if the owning
body is wire.  If 'edge' is the only edge incident with 'vertex' then no new
vertex will be created, and the body will not be changed.  If 'edge' is closed
with the same vertex at its start and end, then the new vertex will be at the
end of the edge.