Component:Remove Faces
From DocR23
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.
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.
Remove Faces Demo
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.
