Component:Remove Faces

From DocR23

Jump to: navigation, search
All Remove Faces Articles | C++ APIs | Scheme Extensions | Global Options | Error Codes
edit  

Remove Faces Component


The Remove Faces Component (REM) supports the removal of faces from solid and sheet bodies, the removal of an open gap in a sheet body, and the removal of edges from wire bodies. REM is frequently used to remove blend sequences. In all cases the body is healed by extending the remaining topology to fill the gap. If this is not possible due to geometrical limitations (for example, the removal of one face off a block), the model is left unchanged and an error is raised. The body's shells and lumps are corrected at the end of the operation if they have been split.


edit  

Remove Faces Operations


Operations

Operation Description
Remove Face Removal of one or more faces from a body and the "healing" of the gap by extending the neighboring surfaces.
Remove Open Gap Removal of an open gap in a sheet body by extending the neighboring surfaces.
Remove Wire Edges Removal of one or more edges from a wire body and the "healing" of the gap by extending the neighboring curves.

Options

The main Remove Faces API functions take options objects to control the behavior and/or the shape of local operations. The options are passed in via the class lop_options.

Important: For historical reasons there are some global options that also affect the behavior of Remove Faces operations. Refer to the Remove Faces global options.



edit  

Remove Faces Demo



edit  

Remove Faces Interface


Remove Face(s)

The API function api_remove_faces is used to perform this operation. The API can take one or more faces that all belong to the same sheet or solid body. The body which owns the faces given as input is modified directly: no copy is made.

outcome api_remove_faces(number of faces, face list, bounding box for intersection, options)

For additional information, refer to Remove Face(s) Interface.

Remove Open Gap

The API function api_remove_open_gap is used to close an open gap in a sheet body by extending the neighboring faces.

outcome api_remove_open_gap(edge(s), bounding box for intersection, options)

Remove Wire Edges

The API function api_remove_wire_edges is used to remove edges from a wire.

outcome api_remove_wire_edges(number of edges, edge list, bounding box for intersection, options)

Versioning and Journaling

Versioning and Journaling are available for Remove Faces using the standard AcisOptions mechanism.

Error Information Handling

Main article: Local Operations Error Information Handling

ACIS returns as much information as possible, such as the bad face or edge that caused the failure, in the outcome object returned by api_remove_faces.

Functional Options

All Local Operations API functions accept a lop_options object. Several of these options existed as Global Options in previous releases; however, the recommended interface is to use lop_options.

Global Options

For historical reasons some global options affect the behavior of Local Operations. Refer to Local Operations global options. However, the preferred interface is to use lop_options to control the behavior of the Local Operations API functions.


edit  

See Also

Personal tools