|
Action:
|
Creates a copy of all entities in an entity list and all their associated entities.
|
|
|
Prototype:
|
outcome api_copy_entity_list (
|
|
|
ENTITY_LIST& entity_list,
|
// list to copy
|
|
|
ENTITY_LIST& copied_entity_list,// copy returned
|
|
|
AcisOptions* ao = NULL
|
|
// acis options
|
|
|
);
|
|
|
Includes:
|
#include "kernel/acis.hxx"
|
|
#include "kernel/kernapi/api/api.hxx"
|
|
#include "kernel/kernapi/api/kernapi.hxx"
|
|
#include "kernel/kerndata/lists/lists.hxx"
|
|
#include "kernel/kernapi/api/acis_options.hxx"
|
|
|
Description:
|
This API copies the entities in the given entity list and all their associated ("connected") entities, if any, using each entity's copy and fix-up methods (e.g. ,
copy_scan,
copy_data,
fix_pointers, etc.). This includes entities that are above and/or below the given entity in the topological hierarchy. For example, copying an edge copies the coedges, loops, faces, shells, etc., as well as all the associated curves, vertices, points, attributes, etc. If there are no associated entities, only the given entities are copied. The returned entity list's entities are in the same order as the given entity list.
|
|
|
Errors:
|
The entity_list is empty.
|
|
|
Limitations:
|
Refer to description.
|
|
|
Library:
|
kernel
|
|
|
Filename:
|
kern/kernel/kernapi/api/kernapi.hxx
|
|
|
Effect:
|
Changes model
|