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