PK_ERROR_code_t PK_EDGE_euler_delete_with_face
(
--- received arguments ---
PK_EDGE_t       edge,   --- Edge to be deleted
PK_LOGICAL_t    on_left --- Face to delete is on left of edge
)


This function deletes an edge and merges two faces and loops into one.


Specific Errors:
    PK_ERROR_edge_not_manifold    edge is not manifold
    PK_ERROR_edge_is_ring         edge is ring
    PK_ERROR_edge_is_wire         edge has same face on both sides


This function deletes an edge and a face.  If on_left is PK_LOGICAL_true then
the face to the left of edge will be deleted otherwise the face on the right
will be deleted.

edge must have different faces on each side and must be manifold.

Any geometry on edge and the deleted face will be deleted and the resulting
body will normally be invalid.

The inverse of this function is PK_LOOP_euler_make_edge_face.