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.


Specific Errors:
    PK_ERROR_wrong_group_class      this part may not have a group with this
                                    entity class
    PK_ERROR_invalid_group_class    not allowed as a group's entity class
    PK_ERROR_wrong_class_for_group  entity is of a class not allowed in
                                    this group
    PK_ERROR_not_in_same_part       some entity is not within the part


Groups within a body may contain entities of one of the following classes:

    PK_CLASS_face
    PK_CLASS_edge
    PK_CLASS_vertex
    PK_CLASS_surf
    PK_CLASS_curve
    PK_CLASS_point
    PK_CLASS_region
    PK_CLASS_entity   each entity may be of any of those classes above

All the entities in a group within a body must themselves belong to that
body.  For geometric entities, the entity may either be attached to a
topological entity of the body, or be construction geometry of the body.

Groups within an assembly may contain entities of one of the following
classes:

    PK_CLASS_instance
    PK_CLASS_surf
    PK_CLASS_curve
    PK_CLASS_point
    PK_CLASS_entity  each entity may be of any of those classes above

The only 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.