All Frameworks  Class Hierarchy  This Framework  Indexes

SPAbool Global Function api_unhook_faces

outcome api_unhook_faces(	ENTITY_LIST	`given_faces`,
	logical	`copy`,
	ENTITY_LIST&	`unhooked_bodies`,
	AcisOptions*	`ao`	`= NULL` )

Returns copies of selected faces in a new body, and optionally removes them from the original body.

Role: This API creates copies of each face in the list given_faces, and returns them in a new body, added to the list unhooked_bodies. Every input face must belong to the same body.

If the argument copy is set to TRUE, the original model is not modified. If copy is set to FALSE, then the input faces are removed from their owning body and deleted. When edges and vertices are no longer needed to support faces, they are also removed. This behavior differs from that of the API api_uncover_face, which converts redundant edges to wire edges.

Limitations: This API works only on faces that belong to the same owning body.

Effect: Changes model, unless copy is set to TRUE.

Journal: Available

Parameters:

given_faces: (in) List of faces to be unhooked.
copy: (in) Set to TRUE to copy faces only. Set to FALSE to copy and remove faces.
unhooked_bodies: (in/out) New body containing copied faces is added.
ao: (in) ACIS options such as version and journal.

This object is included in the file: boolapi.hxx