## X3DObject.AddNurbsSurface

### Description

Creates a NurbsSurfaceMesh object composed of one surface. This is typically used for creating nurbs surface from a set of geometry data.

### C# Syntax

    X3DObject X3DObject.AddNurbsSurface( Object in_vsaControlPoints, Object in_vsaUKnots, Object in_vsaVKnots, Boolean in_bUClosed, Boolean in_bVClosed, Int32 in_lUDegree, Int32 in_lVDegree, siKnotParameterization in_uParameterization, siKnotParameterization in_vParameterization, siNurbsFormat in_eNurbsFormat, String in_bstrName );

### Scripting Syntax

    oReturn = X3DObject.AddNurbsSurface( ControlPoints, [UKnots], [VKnots], [UClosed], [VClosed], [UDegree], [VDegree], [UParam], [VParam], [NurbsFormat], [Name] );

### Return Value

Returns a X3DObject object holding the new geometry, the new X3DObject is parented under this X3DObject.

### Parameters

Parameter | Type | Description
--- | --- | ---
ControlPoints | 1D or 3D Array | The control points used for creating the nurbs surface. The control points can be stored in a 1-dimensional array or in a 3-dimensional matrix (UxVx4) of x,y,z,w values. The 1-dimensional array should contain the number of points in U and V at the beginning followed by a sequence of x,y,z,w values (e.g. {U,V,Xo,Yo,Zo,...X(uv-1),Y(uv-1),Z(uv-1),W(uv-1)}).
UKnots | Array of Doubles | A vector of knot values in the U direction. Default Value: Knots derived from control points.
VKnots | Array of Doubles | A vector of knot values in the V direction. Default Value: Knots derived from control points.
UClosed | Boolean | Specifies whether the nurbs surface is closed or not in U direction. Default Value: False
VClosed | Boolean | Specifies whether the nurbs surface is closed or not in V direction. Default Value: False
UDegree | Long | Degree of the nurbs surface in U direction. Default Value: 3
VDegree | Long | Degree of the nurbs surface in V direction. Default Value: 3
UParam | siKnotParameterization | The parameterization factor of the nurbs surface in U direction. Default Value: siNonUniformParameterization
VParam | siKnotParameterization | The parameterization factor of the nurbs surface in V direction. Default Value: siNonUniformParameterization
NurbsFormat | siNurbsFormat | Specifies how the data is formatted. Default Value: siSINurbs
Name | String | name of object

### Examples

#### VBScript Example

    NewScene , false
    set oRoot = Application.ActiveProject.ActiveScene.Root
    set oOrig = oRoot.AddGeometry( "Sphere", "NurbsSurface" )
    oOrig.radius.Value = 1.000
    oOrig.subdivu.Value = 1.000
    oOrig.subdivv.Value = 1.000
    oOrig.ActivePrimitive.Geometry.Surfaces(0).Get  _
            siSINurbs, _
            aCV, _
            aUKnots,aVKnots, _
            bUClosed,bVClosed, _
            lUDegree,lVDegree, _
            eUParameterization,eVParameterization
    Application.LogMessage "bUClosed: " & bUClosed
    Application.LogMessage "bVClosed: " & bVClosed
    Application.LogMessage "lUDegree: " & lUDegree
    Application.LogMessage "lVDegree: " & lVDegree
    Application.LogMessage "eUParameterization: " & eUParameterization
    Application.LogMessage "eVParameterization: " & eVParameterization
    Application.LogMessage "aCV size:" & ubound(aCV,3)+1 & ":" & ubound(aCV,2)+1 & ":" &ubound(aCV,1)+1
    for i = lbound( aCV, 3 ) to ubound( aCV, 3 )
            for j = lbound( aCV, 2 ) to ubound( aCV, 2 )
                    Application.LogMessage "aCV(" & i & "," & j &") = " & _
                            aCV( 0, j, i ) & "," & aCV( 1, j, i ) & "," & aCV( 2, j, i ) & "," & aCV( 3, j, i )
            next
    next
    for i = lbound( aUKnots, 1 ) to ubound( aUKnots, 1 )
            Application.LogMessage "aUKnots(" & i & ") = " & aUKnots( i )
    next
    for i = lbound( aVKnots, 1 ) to ubound( aVKnots, 1 )
            Application.LogMessage "aVKnots(" & i & ") = " & aVKnots( i )
    next
    set oNurbsSurface = oRoot.AddNurbsSurface( _
            aCV, _
            aUKnots,aVKnots, _
            bUClosed,bVClosed, _
            lUDegree,lVDegree, _
            eUParameterization,eVParameterization, _
            siSINurbs _
            )
    ' Expected results:
    'INFO : bUClosed: True
    'INFO : bVClosed: False
    'INFO : lUDegree: 3
    'INFO : lVDegree: 3
    'INFO : eUParameterization: 1
    'INFO : eVParameterization: 1
    'INFO : aCV size:3:4:4
    'INFO : aCV(0,0) = 0,-1,0,1
    'INFO : aCV(0,1) = -2.66666666666667,-1,0,1
    'INFO : aCV(0,2) = -2.66666666666667,1,0,1
    'INFO : aCV(0,3) = 0,1,0,1
    'INFO : aCV(1,0) = 0,-1,0,1
    'INFO : aCV(1,1) = 1.33333333333333,-1,2.3094010767585,1
    'INFO : aCV(1,2) = 1.33333333333333,1,2.3094010767585,1
    'INFO : aCV(1,3) = 0,1,0,1
    'INFO : aCV(2,0) = 0,-1,0,1
    'INFO : aCV(2,1) = 1.33333333333333,-1,-2.3094010767585,1
    'INFO : aCV(2,2) = 1.33333333333333,1,-2.3094010767585,1
    'INFO : aCV(2,3) = 0,1,0,1
    'INFO : aUKnots(0) = 0
    'INFO : aUKnots(1) = 1
    'INFO : aUKnots(2) = 2
    'INFO : aUKnots(3) = 3
    'INFO : aVKnots(0) = 0
    'INFO : aVKnots(1) = 0
    'INFO : aVKnots(2) = 0
    'INFO : aVKnots(3) = 1
    'INFO : aVKnots(4) = 1
    'INFO : aVKnots(5) = 1

### See Also

NurbsSurface