Function MatchedBoolean4( _
   ByVal OperationType As Integer, _
   ByVal ToolBody As Object, _
   ByVal NumOfMatchingFaces As Integer, _
   ByVal FaceList1 As Object, _
   ByVal FaceList2 As Object, _
   ByVal MatchingTolerance As Double, _
   ByRef ErrorCode As Integer _
) As Object

Dim instance As IBody2
Dim OperationType As Integer
Dim ToolBody As Object
Dim NumOfMatchingFaces As Integer
Dim FaceList1 As Object
Dim FaceList2 As Object
Dim MatchingTolerance As Double
Dim ErrorCode As Integer
Dim value As Object
 
value = instance.MatchedBoolean4(OperationType, ToolBody, NumOfMatchingFaces, FaceList1, FaceList2, MatchingTolerance, ErrorCode)

object MatchedBoolean4( 
   int OperationType,
   object ToolBody,
   int NumOfMatchingFaces,
   object FaceList1,
   object FaceList2,
   double MatchingTolerance,
   out int ErrorCode
)

Object^ MatchedBoolean4( 
&   int OperationType,
&   Object^ ToolBody,
&   int NumOfMatchingFaces,
&   Object^ FaceList1,
&   Object^ FaceList2,
&   double MatchingTolerance,
&   [Out] int ErrorCode
) 

Parameters

OperationType

One of the following operation types:

• SWBODYADD

• SWBODYCUT

• SWBODYINTERSECT

ToolBody

Array of bodies

NumOfMatchingFaces

Number of matching faces

FaceList1

First face list (see Remarks)

FaceList2

Number of matching faces

MatchingTolerance

Tolerance to use to check matching faces

ErrorCode

Error indicated as defined in swBodyOperationError_e

The concept of match means that the caller tells the boolean operator beforehand which faces can be considered to coincide. Basically the caller performs part of the boolean operation.

Sometimes the application knows that two faces match because of the way the bodies are constructed; i.e., the application knows which faces are intended to match.

Having a list of matching face pairs may allow the matched boolean operator to resolve other geometric operations that otherwise it would not be able to work out. In general, providing matched faces speeds up the boolean operation and makes results more reliable.

The arguments FaceList1 and FaceList2 arguments can be empty lists. If matching face pairs are passed in, these faces must match such that:

• the surface geometry is coinciding.

•  for each edge in a face, there is an edge in the other face that coincides.

If MatchingTolerance is less than 1.0e-8 or 0.0, then a default tolerance of 2.0e-6 is used. You decide the tolerance value based on the similarities and subtle differences between the two bodies.

This method supports multibody parts.