PK_LOOP_euler_transfer

PK_ERROR_code_t PK_LOOP_euler_transfer
(
--- received arguments ---
PK_LOOP_t       loop,    --- loop to transfer
PK_FACE_t       face     --- destination face
)


This function transfers a loop from one face to another.


Specific Errors:
    PK_ERROR_different_shells       faces are in different shells
    PK_ERROR_face_contains_loop     'loop' is already in destination face
    PK_ERROR_only_one_loop          attempt to remove the last loop from face


The originating face of 'loop' and its destination face must have the same
front and back shells.  'loop' must not already be in 'face' and must not be
the only loop in its originating face.

See here for an illustration.