Sub IAddTrimmingLoop2( _
   ByVal CurveCount As Integer, _
   ByRef Order As Integer, _
   ByRef Dim As Integer, _
   ByRef Periodic As Integer, _
   ByRef NumKnots As Integer, _
   ByRef NumCtrlPoints As Integer, _
   ByRef Knots As Double, _
   ByRef CtrlPointDbls As Double, _
   ByRef UvRange As Double _
) 

Dim instance As ISurface
Dim CurveCount As Integer
Dim Order As Integer
Dim Dim As Integer
Dim Periodic As Integer
Dim NumKnots As Integer
Dim NumCtrlPoints As Integer
Dim Knots As Double
Dim CtrlPointDbls As Double
Dim UvRange As Double
 
instance.IAddTrimmingLoop2(CurveCount, Order, Dim, Periodic, NumKnots, NumCtrlPoints, Knots, CtrlPointDbls, UvRange)

void IAddTrimmingLoop2( 
   int CurveCount,
   ref int Order,
   ref int Dim,
   ref int Periodic,
   ref int NumKnots,
   ref int NumCtrlPoints,
   ref double Knots,
   ref double CtrlPointDbls,
   ref double UvRange
)

void IAddTrimmingLoop2( 
&   int CurveCount,
&   int% Order,
&   int% Dim,
&   int% Periodic,
&   int% NumKnots,
&   int% NumCtrlPoints,
&   double% Knots,
&   double% CtrlPointDbls,
&   double% UvRange
) 

Parameters

CurveCount

Number of surface parametric (UV) curves constituting the loop; it is also directly related (see Remarks) to the dimension of each of the arrays Order, Dim, Periodic, NumKnots, NumControlPnts, which must be loaded with the information regarding each of the curves; specifically the dimension of those arrays is ArraySize = CurveCount

Order

Array of <ArraySize> longs (see CurveCount argument)

Dim

Array of <ArraySize> longs (see CurveCount argument); if you set the first value in this array to negative its absolute value, then 3D trim curves are expected

Periodic

Array of <ArraySize> longs (see CurveCount argument)

NumKnots

Array of <ArraySize> longs (see CurveCount argument)

NumCtrlPoints

Array of <ArraySize> longs (see CurveCount argument)

Knots

Array of <TotalNumKnots> doubles, where TotalNumKnots = numKnotsInCurve[i] from i = 1 to CurveCount

CtrlPointDbls

Array of <TotalNumCPCoords> doubles, where TotalNumCPCoords = ( dimensionOfCPinCurve[i] * numControlPntsInCurve[i] ) from i = 1 to CurveCount

UvRange

Array of four doubles defining U Low U High V Low V High

The list is created by a previous call to one of the base surface creation functions (for example, IBody2::CreateRevolutionSurface or IBody2::ICreateRevolutionSurface).

The information on each UV-curve is in b-spline form (knots and control point coordinates) all of which are compacted into the two arrays Knots and CtrlPointDbls.

For non-rational curves the dimension value in Dim is 2. For rational curves the dimension value in Dim is 3. The minimum order value in Order is 2. An order 2 curve must consist of only one segment.

For each curve the number of control points in NumCtrlPoints >= its order.

For non-periodic curves there must be (NumCtrlPoints + Order) knot values, the maximum multiplicity of an internal knot value is (Order 96 1), and the maximum multiplicity of an end knot value is Order.

For periodic curves there must be (NumCtrlPoints + 1) knot values and the maximum multiplicity of any knot value is (Order 96 1). If the periodic knot has multiplicity greater than 1, repetitions must be given at the end of the knot vector.

This method expects 2D-polyomial (x,y) or 2D-rational (x,y,w) curves to be passed as trimming curves. However, you can set a flag so that this method accepts 3D-polyomial (x,y,z) or 3D-rational (x,y,z,w) trim curves. To do this, set the first value in the Dim array to negative its absolute value (for example, if the value is 3, set it to -3). When you do this, 3D trim curves will be expected.

Upon adding this trimming loop, you can generate a trimmed surface by calling IBody2::CreateTrimmedSurface.

NOTE: If you do not want to specify a UV Range in the last parameter, pass in a NULL value.