## CreateCurve

### Description

Creates a curve of the specified degree.
Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference so you need to use the best workaround for your situation:
For scripting languages this command returns an ISIVTCollection which you can use to get the output arguments.
For C# you can use the XSIApplication.ExecuteCommand method to call this command. ExecuteCommand packs the output arguments into a C# System.Object containing an Array of the output arguments (see Calling Commands from C#).

### Scripting Syntax

    CreateCurve( [Degree], CurveType, [Points], [Local], [Value] );

### Parameters

Parameter | Type | Description
--- | --- | ---
Degree | Integer | Degree of curve Default Value: 3
Possible Values: | Description:
3 | Cubic NURBS Curve
1 | Linear NURBS Curve
CurveType | Integer | Specifies whether the curve is interpolated Default Value: 1
Possible Values: | Description:
1 | Interpolated Curve
0 | Non-Interpolated Curve
Points | String | Comma-separated list of points. At least one point is necessary. For example, "(0,1,0),(0,2,0),(3,3,0)".
Local | Boolean | True if points are in local coordinates, False if they are in global coordinates. Default Value: False
Value | X3DObject | Returns the curve

### Examples

#### VBScript Example

    ' This example creates curves:
    ' 1) Cubic  non-interpolated curve
    ' 2) Cubic      interpolated curve
    ' 3) Linear non-interpolated curve
    ' NOTE: That a linear interpolated curve will give the same trace as linear non-interpolated curve.
    ' NOTE: Put no spaces in point list.
    newscene
    Dim CubicInterpolated, CubicNonInterpolated, LinearNonInterpolated
    'Create curves.  Points are in global coordinates.
    CreateCurve 3, 0, "(-2,0,0),(-2,0,-2),(2,0,-2),(2,0,0)", FALSE, CubicNonInterpolated
    CreateCurve 3, 1, "(-2,0,0),(-2,0,-2),(2,0,-2),(2,0,0)", FALSE, CubicInterpolated
    CreateCurve 1, 0, "(-2,0,0),(-2,0,-2),(2,0,-2),(2,0,0)", FALSE, LinearNonInterpolated
    'Name the curves.
    SetValue CubicNonInterpolated & ".Name", "CubicNonInterpolated"
    SetValue CubicInterpolated & ".Name", "CubicInterpolated"
    SetValue LinearNonInterpolated & ".Name", "LinearNonInterpolated"

### See Also

SISetCurvePoints SIAddPointOnCurve SIAddPointOnCurveAtStart SIAddPointOnCurveAtEnd GetCurveLength EvaluateCurveAt