## 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