PK_BODY_add_to_compound

PK_ERROR_code_t                    PK_BODY_add_to_compound
(
--- received arguments ---
int                                n_bodies, --- number of bodies
const PK_BODY_t                    bodies[], --- bodies
PK_BODY_t                          compound, --- compound body
const PK_BODY_add_to_compound_o_t *options   --- options
)


This function adds 'bodies' to an existing 'compound' body, so they become
child bodies with the compound body as their parent.


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 as 'compound' (MILD)
    PK_ERROR_instanced_body             a given body is instanced (MILD)
    PK_ERROR_size_mismatch              a given body was created with different
                                        modeller resolution settings (MILD)
    PK_ERROR_unsuitable_entity          a given body contains an entity
                                        with a negative identifier (MILD)


The array 'bodies' must not contain compound bodies, children of existing
compound bodies, 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 as 'compound'.

Boundary geometry in 'bodies' will be shared if identical to geometry in other
'bodies' or in 'compound'. 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.