Function IMatchedBoolean3( _
   ByVal OperationType As Integer, _
   ByVal ToolBodyCount As Integer, _
   ByRef ToolBodyArr As Body2, _
   ByVal NumOfMatchingFaces As Integer, _
   ByRef FaceList1 As Face2, _
   ByRef FaceList2 As Face2, _
   ByRef ErrorCode As Integer _
) As EnumBodies2

Dim instance As IBody2
Dim OperationType As Integer
Dim ToolBodyCount As Integer
Dim ToolBodyArr As Body2
Dim NumOfMatchingFaces As Integer
Dim FaceList1 As Face2
Dim FaceList2 As Face2
Dim ErrorCode As Integer
Dim value As EnumBodies2
 
value = instance.IMatchedBoolean3(OperationType, ToolBodyCount, ToolBodyArr, NumOfMatchingFaces, FaceList1, FaceList2, ErrorCode)

EnumBodies2 IMatchedBoolean3( 
   int OperationType,
   int ToolBodyCount,
   ref Body2 ToolBodyArr,
   int NumOfMatchingFaces,
   ref Face2 FaceList1,
   ref Face2 FaceList2,
   out int ErrorCode
)

EnumBodies2^ IMatchedBoolean3( 
&   int OperationType,
&   int ToolBodyCount,
&   Body2^% ToolBodyArr,
&   int NumOfMatchingFaces,
&   Face2^% FaceList1,
&   Face2^% FaceList2,
&   [Out] int ErrorCode
) 

Parameters

OperationType

One of these operation types:

• SWBODYADD

• SWBODYCUT

• SWCODYINTERSECT

ToolBodyCount

Number of bodies

ToolBodyArr

Array of bodies of size ToolBodyCount

NumOfMatchingFaces

Number of matching faces

FaceList1

First face list (see Remarks)

FaceList2

Second face list  (see Remarks)

ErrorCode

Error indicated as defined inswBodyOperationError_e

Return Value

Pointer to the IEnumBodies2 object for a list of matches

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