PK_GROUP_create_from_entities

PK_ERROR_code_t   PK_GROUP_create_from_entities
(
--- 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

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


This function creates a group within the given part containing the given
set of entities.
NOTE: This function is deprecated and has been superseded by
PK_GROUP_create_from_entities_2.


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_face
    PK_CLASS_edge
    PK_CLASS_vertex
    PK_CLASS_lattice
    PK_CLASS_surf
    PK_CLASS_curve
    PK_CLASS_point
    PK_CLASS_region
    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_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_entity 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.