PK_FACE_make_sheet_bodies

PK_ERROR_code_t                PK_FACE_make_sheet_bodies
(
--- received arguments ---
int                                   n_faces,  --- number of faces
const PK_FACE_t                       faces[],  --- array of faces
const PK_FACE_make_sheet_bodies_o_t  *options,  --- options structure

--- returned arguments ---
int                            *const n_bodies, --- number of bodies
PK_BODY_t                     **const bodies,   --- sheet bodies
PK_TOPOL_track_r_t             *const tracking  --- tracking information
)


This function creates sheet bodies from a collection of faces.


Specific Errors:
    PK_ERROR_not_in_same_part       (MILD) 'faces' not all from the same body
    PK_ERROR_missing_geom           (MILD)  a face in 'faces'
                                            does not have a surface
    PK_ERROR_non_manifold           (MILD) 'faces' would only make a
                                            disconnected or a general body




A sheet body or bodies are created from the given 'faces'.

The given 'faces', with all the edges, vertices and fins of 'faces'
and their associated geometries and attributes are copied and,
depending on the value of the 'make_from' option,
either:
* The copied entities are used to create a sheet body or bodies.
* The original entities are used to create a sheet body or bodies,
  with the copied entities replacing the original entities
  in the original body.


Attributes follow the associated topology i.e. the copied
attribute follow the copied topology. If 'transfer_attribs' is set to
PK_LOGICAL_false and 'make_from' is set to PK_BODY_make_from_original_c,
then the created sheet body (or bodies) are devoid of attributes and the
copied topologies get the copied attributes on the original body.


If any of the topological entities associated with the given 'faces'
are contained within groups, then these entities with their groups plus their
attributes are copied, and their destination is governed by 'make_from' option
value as described above.

If 'make_from' is set to PK_BODY_make_from_copy_c:
If any of the copied topological entities are contained within groups, then
these groups plus their attributes are copied into the appropriate new
sheet body or bodies.  The original groups remain with the original topologies.

If 'make_from' is set to PK_BODY_make_from_original_c:
If any of the copied topological entities are contained within groups, then
these original groups plus their attributes are moved into the appropriate new
sheet body or bodies, along with their member topologies.  The copied groups
remain in the original body with the copied topologies, in addition to owning
any of the other members of original groups which did not move
to new sheet body or bodies.

Geometries associated with the copied topologies follow the same rule as
groups