CreateCurve
 
 
 

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