PK_BODY_make_compound

PK_ERROR_code_t                  PK_BODY_make_compound
(
--- received arguments ---
int                              n_bodies, --- number of bodies
const PK_BODY_t                  bodies[], --- bodies
const PK_BODY_make_compound_o_t *options,  --- options

--- returned arguments ---
PK_BODY_t                 *const compound  --- compound body
)


This function creates a compound body containing 'bodies'.


Specific Errors:

    PK_ERROR_compound_body              a given body is a compound body (MILD)
    PK_ERROR_child_body                 a given body is a child body (MILD)
    PK_ERROR_not_in_same_partition      'bodies' are not all in the same
                                        partition (MILD)
    PK_ERROR_instanced_body             a given body is instanced (MILD)
    PK_ERROR_size_mismatch              bodies were created with different
                                        modeller resolution settings (MILD)
    PK_ERROR_unsuitable_entity          one of the bodies contains an entity
                                        with a negative identifier (MILD)


'bodies' must not contain compound bodies or children of existing compound
bodies.

'bodies' must not contain duplicates or instanced bodies.

The bodies in 'bodies' must not contain entities with negative identifiers.

The given bodies must all be in the same partition. If n_bodies is greater than
zero, the compound body is created in that partition. If n_bodies is zero, an
empty compound body is created in the current partition.

Boundary geometry in 'bodies' will be shared if identical. Facet geometry and
construction geometry will not be shared.

All attributes and groups are preserved by this operation, with the exception
of attributes on geometric entities, whose behaviour is determined by the
'geom_attr' option.