Role: This API facets the given entity. The accuracy of the facets are
controlled with REFINEMENTs. If the entity is a body, a lump, or a shell, all
the contained faces are faceted. Based on the surface type of a face, the
refinement is first searched from the face, then the owning shell, then the
owning lump, then the owning body, then finally from the defaults of the faceter.
The facets are passed on to the current MESH_MANAGER which appropriately directs
the data. For example, it may display the facets, output them to a file, or
attach them to a face.
Errors: Pointer to given entity must be non-NULL and to a BODY,
LUMP, SHELL, or FACE.