RFNurbsCurve.CreateCanonical

Description

Creates the NURBS curve equation from specified canonical values.

Syntax

Function RFNurbsCurve.CreateCanonical(dim As Long, degree As Long, knotType As RFEndKnotType, knotCount As Long, pKnots As Double, ctrlPtsType As RFControlPointType, ctrlPtsCount As Long, ctrlPtsStride As Long, pCtrlPts As Double) As RFErrorCode

The CreateCanonical syntax has these parts:

Part	Description
dim	[IN] Long Required. Dimension of the NURBS curve.
degree	[IN] Long Required. Degree of the NURBS curve ranging from 1 to 32.
knotType	[IN] RFEndKnotType Required. Knot type at end parameters.
knotCount	[IN] Long Required. Number of knots.
pKnots	[IN] Double Required. The first element of a Double array containing knot values.
ctrlPtsType	[IN] RFControlPointType Required. Control point type.
ctrlPtsCount	[IN] Long Required. Number of control points.
ctrlPtsStride	[IN] Long Required. Number of elements to represent a single control point.
pCtrlPts	[IN] Double Required. First element of a Double array containing control point coordinates.

Settings

The dim has these settings:

Value	Description
2	2D NURBS curve. All control points should be coordinated in the 2D space.
3	3D NURBS curve. All control points should be coordinated in the 3D space.

The ctrlPtsStride has these settings:

Value	Description
2	Dimension of the NURBS curve is 2 and control point type is RF_CP_NON_RATIONAL.
3	Dimension of the NURBS curve is 2 and control point type is not RF_CP_NON_RATIONAL, or dimension of the NURBS curve is 3 and control point type is RF_CP_NON_RATIONAL.
4	Dimension of the NURBS curve is 3 and control point type is not RF_CP_NON_RATIONAL.

Remarks

The knot value array pKnots should have appropriate multiplicities at end parameters based on the knotType.
The size of control point coordinate array pCtrlPts should be ctrlPtsCount x ctrlPtsStride.
In case value of dim is 2 and ctrlPtsType is RF_CP_NON_RATIONAL, each control point has ( X, Y) coordinate values. In this case, ctrlPtsStride would be 2 and pCtrlPts contains control point coordinates in the order of ( X0, Y0, X1, Y1,!&,Xn-1, Yn-1 ), where ctrlPtscount is n.
In case value of dim is 3 and ctrlPtsType is not RF_CP_NON_RATIONAL, each control point has ( X, Y, H ) coordinate values where H indicates homogeneous coordinate value. In this case, ctrlPtsStride would be 3 and pCtrlPts contains control point coordinates in the order of ( X0, Y0, H0, X1, Y1, H1, !&,Xn-1, Yn-1, Hn-1 ), where ctrlPtscount is n.
In case value of dim is 3 and ctrlPtsType is RF_CP_NON_RATIONAL, each control point has ( X, Y, Z ) coordinate values. In this case, ctrlPtsStride would be 3 and pCtrlPts contains control point coordinates in the order of ( X0, Y0, X1, Y1, Z1,!&,Xn-1, Yn-1, Zn-1 ), where ctrlPtscount is n.
In case value of dim is 3 and ctrlPtsType is not RF_CP_NON_RATIONAL, each control point has ( X, Y, Z, H ) coordinate values where H indicates homogeneous coordinate value. In this case, ctrlPtsStride would be 4 and pCtrlPts contains control point coordinates in the order of ( X0, Y0, Z0, H0, X1, Y1, Z1, H1, !&,Xn-1, Yn-1, Zn-1, Hn-1 ), where ctrlPtscount is n.

Return to Rapidform Index

Your Ad Here