PK_ERROR_code_t PK_EDGE_propagate_orientation
(
--- received arguments ---
PK_EDGE_t       edge  --- orientation edge
)


This function orientates the edges of a wire body to be in the same direction
as the given edge.


Specific Errors:
    PK_ERROR_wrong_entity           body is not a wire body
    PK_ERROR_orientation_failed     operation failed


All edges in the wire body are made to point along the wire body in the same
direction as the given edge.  Upon completion of this function every internal
vertex of the wire body has one edge directed into it and one edge directed
away from it.  The operation performed on each edge which is initially in the
wrong direction is the same as that performed by PK_EDGE_reverse.