PK_ERROR_code_t  PK_EDGE_euler_slit
(
--- received arguments ---
PK_EDGE_t        edge,      --- Edge to be slit
PK_LOGICAL_t     on_left,   --- New face is on left of edge

--- returned arguments ---
PK_FACE_t *const new_face,  --- New face created by slit
PK_EDGE_t *const new_edge   --- New edge created by slit
)


This function replaces an edge by a 2-edge face.


Specific Errors:
    PK_ERROR_edge_not_manifold    edge is not manifold or laminar
    PK_ERROR_not_laminar_side     attempt to slit wrong side of laminar edge


This function slits an edge lengthwise, creating a new slit face. The
on_left argument specifies whether the new face will lie on the left
or right side of the given edge. The edge must be manifold or laminar.

The new edge will have the same direction as the original. new_edge
and new_face will not have any geometry attached and the resulting
body will be invalid.

If edge is laminar then on_left must specify that the new face lies on
the laminar side of the edge. The edge will become manifold and the
new edge will be laminar.

If edge is a ring edge, the new face will have two loops.

The inverse to this function is PK_FACE_euler_unslit.