PK_GROUP_create_from_entities_2

PK_ERROR_code_t                      PK_GROUP_create_from_entities_2
(
--- received arguments ---
PK_PART_t                            part,         --- part within which group
                                                   --- is to be created
PK_CLASS_t                           entity_class, --- allowed class of
                                                   --- entities in group
int                                  n_entities,   --- number of entities (>=0)
const PK_ENTITY_t                    entities[],   --- entities
const PK_GROUP_create_from_ents_o_t *options,      --- options

--- returned arguments ---
PK_GROUP_t                          *const group   --- group created
)


This function creates a group within the given part containing the given
set of entities.


Specific Errors:
    PK_ERROR_wrong_group_class      (MILD) this part may not have a group with
                                           this entity class
    PK_ERROR_invalid_group_class    (MILD) not allowed as a group's entity
                                           class
    PK_ERROR_wrong_class_for_group  (MILD) entity is of a class not allowed in
                                           this group
    PK_ERROR_not_in_same_part       (MILD) some entity is not within the part
    PK_ERROR_child_body             (MILD) 'part' is a child body
    PK_ERROR_closed_group           (MILD) 'entities' contains a closed group


'entity_class' specifies the allowed class of entities in the group.

If 'part' is a body, then 'entity_class' must be one of:

    PK_CLASS_region
    PK_CLASS_face
    PK_CLASS_edge
    PK_CLASS_vertex
    PK_CLASS_lattice
    PK_CLASS_surf
    PK_CLASS_curve
    PK_CLASS_point
    PK_CLASS_group
    PK_CLASS_entity   Entities of any of the above classes, or of class
                      PK_CLASS_loop, are allowed.

All the entities in a group within a body must themselves belong to that
body.

If 'part' is an assembly, then 'entity_class' must be one of:

    PK_CLASS_instance
    PK_CLASS_lattice
    PK_CLASS_surf
    PK_CLASS_curve
    PK_CLASS_point
    PK_CLASS_group
    PK_CLASS_entity   Entities of any of the above classes are allowed.

The only lattices, surfaces, curves and points allowed in a group within
an assembly are construction geometry owned by the assembly.
Instances in a group within an assembly must themselves be owned by that
assembly.

Additionally, groups of entity class PK_CLASS_group may also contain groups
that belong to the same part. Cyclic groups, i.e. groups that contain
themselves or groups higher up in the hierarchy, are not allowed.