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

Autodesk Softimage v7.5