Function GetTrimCurves2( _
   ByVal WantCubic As Boolean, _
   ByVal WantNRational As Boolean _
) As Object

Dim instance As IFace2
Dim WantCubic As Boolean
Dim WantNRational As Boolean
Dim value As Object
 
value = instance.GetTrimCurves2(WantCubic, WantNRational)

object GetTrimCurves2( 
   bool WantCubic,
   bool WantNRational
)

Object^ GetTrimCurves2( 
&   bool WantCubic,
&   bool WantNRational
) 

Parameters

WantCubic

True if the trim curves are to be cubic, false if not

WantNRational

True if the trim curves are to be non-rational, false if not

Return Value

Array (see Remarks)

This method returns an array containing the definition of all of the entities that describe a trimmed face. The data is arranged in collections of surface curves (curves defined in the 2D parametric space of the surface, or SP curves) organized into loops (closed composite curves).

All SP curves are returned as b-splines. To control the tolerance of the SP curves, use IModeler::GetToleranceValue or IModeler::SetToleranceValue.

A call to IFace2::IGetTrimCurveSize2 must precede the call to IFace2::GetTrimCurves2 to get the size of the array required and pre-process the trim curve data.

The surface and trim curve parameterization returned by this method might be different from the parameterization returned by other methods, such as IFace2::GetUVBounds, ISurface::Parameterization, IEdge::GetCurveParams2, and so on.

If you set WantCubic to True, then this method returns the underlying Bsurface definition. If you want to use the Bsurface in combination with its trim curves, set WantCubic=True because it provides better alignment of the trim curves with the Bsurface as they are generated at the same time.

Each face typically has at least 1 outer loop and 0 or more inner loops. Outer loops define the periphery of the face; inner loops define holes in the face. Outer loops are returned before inner loops when possible. If you need to be certain, use ILoop2::IsOuter.

Periodic Faces

Periodic faces present many obstacles in translation. As a general rule, it is best to chop up all periodic surfaces by making a call to IBody2::GetProcessedBody2. This method returns a new body to the caller with periodic faces chopped up into multiple faces. Processing this new body, instead of the original body, avoids many of the pitfalls associated with periodics.

If this face is periodic and crosses the "seam" (0 & 360 location), then this method splits the face into more than one trimmed surface for the purposes of returning this set of data. The first time that this method is called on any face, it returns data for the first trimmed surface on the face. Each subsequent call to this function on the same face returns data for the next trimmed surface, if one exists. The packedDouble8 parameter determines the number of surfaces for this face (details to follow).

To avoid the return of multiple surfaces per face, process the body returned from IBody2::GetProcessedBody2.

Using the IBody2 object returned from IBody2::GetProcessedBody2 usually prevents IFace2::GetTrimCurves2 from returning multiple outer loops when it encounters certain periodic surfaces. In other words, it can prevent IFace2::GetTrimCurves2 from generating multiple faces (each with an outer loop) for a particular periodic surface.

Edges

If your program uses calls to both IFace2::GetEdges and IFace2::GetTrimCurves2 or to both IFace2::EnumEdges and Face2::GetTrimCurves2, then:

IFace2::GetTrimCurves2 stores a temporary buffer containing the edges for this face. If this temporary buffer exists, then calls to IFace2::GetEdges or IFace2::EnumEdges access the buffer. This is beneficial if you are attempting to align the trim curves of the face with their corresponding Edges.

If your call to IFace2::GetEdges or IFace2::EnumEdges is made immediately following your call to IFace2::GetTrimCurves2, then the order of the trim curves aligns with the order of the edges. However, if you are processing all the trim curves and then processing all the edges, your first call to access the edges usew the temporary buffer of edges generated in your last call to IFace2::GetTrimCurves2.

Because your last call to IFace2::GetTrimCurves2 and your current call to get the edges were probably made from different faces, you will see a mismatch of data. This mismatch of data may been seen when IFace2::GetEdgeCount does not match the array size from IFace2::GetEdges or it may be seen when the edge data does not match the face being examined. Therefore, calls to IFace2::GetEdges or IFace2::EnumEdges should be made in the same loop and immediately following your call to IFace2::GetEdges. The temporary buffer of edges is destroyed after each call to IFace2::GetEdges or IFace2::EnumEdges.

A corresponding edge for each trim curve might not exist. This is true for periodic surfaces for which no edge exists along the seam (0 and 360), yet this method returns a trim curve. You can detect this situation by comparing the number of edges on the face, IFace2::GetEdgeCount , with the number of trim (SP) curves on the face, PackedDouble1 (details to follow).

To force edge generation along the seam of a periodic surface, use Body2::GetProcessedBody. This method creates a copy of the body with faces and surfaces chopped up. However, there are still certain situations (poles of a surface, cusps on a surface, and so on) in which this method returns a trim curve where no edge exists. In this situation, the list of edges returned from IFace2::GetEdges or IFace2::EnumEdges does not align with the list of trim curves. Again, you can detect this by comparing the value returned by IFace2::GetEdgeCount with PackedDouble1, but you must handle matching the edges with their corresponding trim curve.

Return Values

The data is returned in a large array of doubles. Integer data is packed among the doubles in pairs.

The format of faceData[] is as follows:

[ packedDouble1, packedDouble2[ ], packedDouble3[ ], knotValues[ ], ctrlPointCoords[ ], packedDouble8 ]

If b-splines were requested (WantCubic = True), then the underlying Bsurface is also returned. The faceData[ ] array would be as follows:

[ packedDouble1, packedDouble2[ ], packedDouble3[ ], knotValues[ ], ctrlPointCoords[ ], packedDouble4, packedDouble5, packedDouble6, packedDouble7, surfaceKnotValuesU[ ], surfaceKnotValuesV[ ], surfaceCtrlPointCoords[ ], packedDouble8 ]