SetCurveKnotMultip licity

Introduced

5.0

Description

Sets the multiplicity of a knot at the specified curve location. (Raising the multiplicity of a knot adds more control points thus enabling more discontinuity control.) If the new multiplicity is zero the knot is completely removed.

Scripting Syntax

    SetCurveKnotMultiplicity( [ConnectionSet], [Multiplicity], [ImmediateMode] )

Parameters

Parameter | Type | Description
ConnectionSet [in/out] | ConnectionSet | Specifies the knots to set the new multiplicity. See Operator Presets for details on the connection set required for this operator. Default Value: Currently selected components. Warning: An error occurs if the connection set is invalid. Please verify the connection set required for this operator to avoid breaking your scripts.
Multiplicity | Integer | Multiplicity of the knots Default Value: 1 Possible Values: • 0: Knot is completely removed • 1: Simple Knot (Bezier-like knot for a nurbs linear curve) • 2: Double Knot (Bezier-like knot for a nurbs quadratic curve) • 3: Triple Knot (Bezier-like knot for a nurbs cubic curve)
ImmediateMode [in/out] | siOperationMode | Specifies whether or not the operator should be immediately frozen. Default Value: siPersistentOperation

Return Value

Returns an XSICollection containing the new SetNurbsCrvKnotMultiplicity Operator.

Examples

1. VBScript Example

    '
    ' This example creates a simple curve, selects a knot and changes its multiplicity
    '
    NewScene, false
    SICreateCurve "crvlist", 3, 0
    SIAddPointOnCurveAtEnd "crvlist", -4.4368932038835, -0.845035244491313, 0, False, 0
    SIAddPointOnCurveAtEnd "crvlist", -4.47572815533981, 2.74879280679358, 0, False, 0
    SIAddPointOnCurveAtEnd "crvlist", -1.07766990291262, 2.69051451407004, 0, False, 0
    SIAddPointOnCurveAtEnd "crvlist", -0.572815533980583, -1.07814841538547, 0, False, 0
    SIAddPointOnCurveAtEnd "crvlist", 2.80582524271845, -1.03929622023644, 0, False, 0
    SIAddPointOnCurveAtEnd "crvlist", 4.28155339805825, 2.78764500194261, 0, False, 0

    SetSelFilter "Knot"
    SelectObj "crvlist.knot[1]"
    SetCurveKnotMultiplicity , 3

2. JScript Example

    /*
       This example creates a simple curve, selects a knot and changes its multiplicity
    */
    NewScene(null, false);
    SICreateCurve("crvlist", 3, 0);
    SIAddPointOnCurveAtEnd("crvlist", -4.4368932038835, -0.845035244491313, 0, false, 0);
    SIAddPointOnCurveAtEnd("crvlist", -4.47572815533981, 2.74879280679358, 0, false, 0);
    SIAddPointOnCurveAtEnd("crvlist", -1.07766990291262, 2.69051451407004, 0, false, 0);
    SIAddPointOnCurveAtEnd("crvlist", -0.572815533980583, -1.07814841538547, 0, false, 0);
    SIAddPointOnCurveAtEnd("crvlist", 2.80582524271845, -1.03929622023644, 0, false, 0);
    SIAddPointOnCurveAtEnd("crvlist", 4.28155339805825, 2.78764500194261, 0, false, 0);
    SetSelFilter("Knot");
    SelectObj("crvlist.knot[1]", null, null);
    SetCurveKnotMultiplicity(null, 3, siPersistentOperation);

Autodesk Softimage v7.5