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.