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:

3: Cubic NURBS Curve

1: Linear NURBS Curve

CurveType

Integer

Specifies whether the curve is interpolated

Default Value: 1

Possible Values:

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 [out]

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

 

 



SOFTIMAGE|XSI v6.01     

Return to Softimage XSI Index