|
Action:
|
Creates a deep copy of all entities in an entity list and all their associated entities.
|
|
|
Prototype:
|
outcome api_deep_copy_entity_list (
|
|
|
ENTITY_LIST& entity_list,
|
// entities to copy
|
|
|
ENTITY_LIST& new_entity_list,// copies returned
|
|
|
logical dpcpy_skip
|
// flag to skip
|
|
|
|
= FALSE,
|
// attributes not
|
|
|
|
|
// deep-copyable
|
|
|
AcisOptions* ao = NULL
|
// acis options
|
|
|
);
|
|
|
Includes:
|
#include "kernel/acis.hxx"
|
|
#include "baseutil/logical.h"
|
|
#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 deep 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.). The difference between a deep copy and a regular copy is that a regular copy may contain references to shared underlying associated entities, but a deep copy will not. This includes entities that are above and/or below the given entity in the topological hierarchy. For example, deep copying an edge deep 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 deep copied. The returned entity list's entities are in the same order as the given entity list.
|
|
|
Errors:
|
Attempting to copy an entity that has associated entities that do not support a deep copy routine.
|
|
|
|
The
entity_list is empty.
|
|
|
Limitations:
|
Refer to Description.
|
|
|
Library:
|
kernel
|
|
|
Filename:
|
kern/kernel/kernapi/api/kernapi.hxx
|
|
|
Effect:
|
Changes model
|