PK_ENTITY_copy_2

PK_ERROR_code_t            PK_ENTITY_copy_2
(
--- received arguments ---
PK_ENTITY_t                entity,      --- an entity
const PK_ENTITY_copy_o_t  *options,     --- options structure

--- returned arguments ---
PK_ENTITY_t         *const entity_copy, --- copy of given entity
PK_ENTITY_track_r_t *const tracking     --- tracking information
)


This function produces a new entity which is a copy of the given entity.


Specific Errors:
    PK_ERROR_wrong_entity         (MILD) this class of entity can not be copied
    PK_ERROR_part_not_isolated    (MILD) copy would instance true-sub-part of
                                         stored part
    PK_ERROR_bad_combination      (MILD) the options requested are not
                                         compatible with the class of entity
    PK_ERROR_child_body           (MILD) 'entity' is a child body
    PK_ERROR_compound_body        (MILD) 'entity' is a compound body
    PK_ERROR_cyclic_assy          (MILD) copying the instance would create a
                                         cyclic assembly graph.


PK_ENTITY_copy_2 returns a copy of 'entity' in 'entity_copy'.

The classes of entity which may be copied are:
assembly; instance; body; surface; curve; point; transformation and group

The structure PK_ENTITY_copy_o_t contains user control options. Finer control
over the copying process (including setting the destination of the copies,
and whether any attributes owned by the input geometries are copied) is
available in the options structure. See its documentation for more details.