api_copy_entity
List of: Functions
Subjects: Model Geometry, Model Object
Contents: Kernel

Action: Creates a copy of an entity and all its associated entities.

Prototype: outcome api_copy_entity (


ENTITY* entity, // entity to be copied


ENTITY*& new_entity, // 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/data/entity.hxx"

#include "kernel/kernapi/api/acis_options.hxx"

Description: This API copies the given entity and all its 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 entity is copied.

Errors: The NULL pointer is given to entity.

Limitations: Refer to description.

Library: kernel

Filename: kern/kernel/kernapi/api/kernapi.hxx

Effect: Changes model
PDF/KERN/16FNA.PDF
HTM/DATA/KERN/KERN/16FNA/0023.HTM