Exact Stitching


The API api_stitch operates in Exact Stitching mode when the stitch_options object that is passed into api_stitch is of class exact_stitch_options. Exact Stitching allows stitching of faces with edges that are coincident within ACIS tolerance. In Exact Stitching mode, the API operates only on BODYs. It should only be used to reconnect faces that have been split by boolean operations or to connect faces that have been explicitly constructed to have coincident edges. Tolerant Stitching should be used when non-coincident edges are expected.

Exact Stitching also requires compatible topology between the entities being stitched. Two edges (and their corresponding co-edges) are considered incompatible when they have coincident geometry but belong to single-sided faces of incompatible orientation (that is, they have the same coedge direction, and thus incompatible face normals). Exact stitching returns an error from api_stitch if incompatible edges are encountered. Any other combination of faces that share coincident edges are stitched, even if the final edge has more than two faces around it after the stitch (that is, nonmanifold). If incompatible edges are encountered in exact stitching, it is recommended that the user attempt to stitch the model using tolerant stitching, which will perform the appropriate face reversals.

Exact Stitching provides a flag to control whether an edge should be split when it is coincident with another edge along only part of its length.

Figure. Exact Stitching with No Split Option

In the previous figure, CD is stitched to FG, but AB is not stitched to EDGH because of the split at D/G.

Figure. Exact Stitching with Split Option

In the previous figure, Vertex I is inserted by stitcher and AI IB are stitched to ED and GH, respectively.

Note:  In Exact Stitching mode, the API operates only on BODYs.

[Top]