Component:Stitching
From DocR23
Stitching Component
The Stitch Component (STITCH) provides a way to connect unconnected faces to make a sheet or solid body that is topologically complete. Stitching essentially involves replacing groups of coincident edges or vertices with a single edge or vertex.
What's New in Stitching
Stitching Topics
General Topics
- Tolerant Stitching Sample Code – Sample code demonstrates how to perform tolerant stitching using api_stitch and api_stitch_nonmanifold.
- Stitch Progress Callback – The stitch progress callback mechanism provides the information needed by customers to implement a progress widget.
- Non-manifold Stitching – Describes how to stitch more than two faces on an edge.
Options
Note: Stitching options object are derived from abstract base class stitch_options
The main Stitching API functions take an options object to control their behavior. An options object is passed as an argument to the API function using one of the following derived classes:
- exact_stitch_options – This object is passed as an argument to api_stitch to specify stitching of faces with edges strictly within the ACIS tolerance SPAresabs.
- tolerant_stitch_options – This object is passed as an argument to api_stitch and api_stitch_nonmanifold to specify stitching of faces with edges where edges have gaps greater than the ACIS tolerance SPAresabs.
- edge_tolstitch_options – This object is passed to api_stitch to specify stitching of faces with edges where edges have gaps greater than the ACIS tolerance SPAresabs.
Journaling
Journaling is available for Stitching through the standard AcisOptions journaling mechanism.
Versioning
- Main article: Versioning
Versioning is available for Stitching through the standard AcisOptions versioning mechanism.
Stitching Operations
| Operation | Description |
|---|---|
| Exact Stitching | This operation allows stitching faces with edges that are coincident within ACIS tolerance (see SPAresabs). |
| Tolerant Stitching | This operation stitches two faces only if the common edges/vertices have approximately the same geometry. |
| Restricted Tolerant Stitching | This operation uses the same algorithm as Tolerant Stitching, except that you specify a list of candidate edges. |
Stitching Interface
API Functions
The API to stitch together given entities is api_stitch.
Error Codes
Upon failure of an Stitching API, Error Codes will be returned that explain the failure and suggest possible actions for correction.
Scheme Extensions
The Scheme extension to call api_stitch is entity:stitch.
Refer to the complete list of all Scheme extensions related to the Stitching component.
See Also
Related Operations
- Non-manifold bodies can also be unstitched. Refer to api_unstitch_nonmani.
Components