PIERCE   

Equivalent PK functions: PK_FACE_delete_from_sheet_body

PIERCE ( face, ifail )
======================

  Remove face from sheet

Receives:
  KI_tag_face              *face           --- face to remove

Returns:
  KI_cod_error             *ifail          --- failure indicator

Specific errors:
  KI_bad_wire               invalid wire would result
  KI_fragment               sheet would break apart
  KI_not_sheet              body is not a sheet

Description:

  This routine deletes a face from a sheet body. The given face must be
  a face of a sheet body, with or without a surface attached. Removal of
  the face must not break the sheet into two or more parts.

  If the body has more than one face, it remains a sheet body; edges and
  vertices belonging to the face, but which are shared with no other
  face, will be deleted along with it.

  If the face is the only face of the sheet body, the result will be
  either a wire or minimal body; none of the body's edges and vertices
  will be deleted by the operation. The edges and vertices must form a
  valid wire or minimal body, i.e. they must be connected (in a single
  loop or a pair of bi-wire loops) and no vertex may be used by more
  than two edges.