v5.0

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.

oReturn = SetCurveKnotMultiplicity( [ConnectionSet], [Multiplicity], [ImmediateMode] );

Returns an XSICollection containing the new SetNurbsCrvKnotMultiplicityOperator.

Parameter	Type	Description
ConnectionSet	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: Description: 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	siOperationMode	Specifies whether or not the operator should be immediately frozen. Default Value: siPersistentOperation

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