InsertCurveKnot

Inserts a new knot with the given multiplicity at the specified curve location. A multiplicity of one will create only one CV (control vertex) for this knot but without discontinuity control (unless the curve is linear). A multiplicity of three for a cubic curve will create three CVs for this knot and thus will let you have full control of the discontinuity (creating a corner, for example).

Scripting Syntax

Return Value

Parameters

Parameter

Type

Description

ConnectionSet

Specifies the curve location for inserting the new knot.

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

Examples

1. VBScript Example

' 

'	This example creates a simple curve, selects an isopoint, and creates a bezier-knot

'	at this location.

' 

SICreateCurve "crvlist", 3, 0

SIAddPointOnCurveAtEnd "crvlist", -4, 2, 0, False, 0

SIAddPointOnCurveAtEnd "crvlist", -5, -2, 0, False, 0

SIAddPointOnCurveAtEnd "crvlist", -2, -2, 0, False, 0

SIAddPointOnCurveAtEnd "crvlist", -1, 2, 0, False, 0

SIAddPointOnCurveAtEnd "crvlist", 2, 2, 0, False, 0

SIAddPointOnCurveAtEnd "crvlist", 2, -2, 0, False, 0

SetSelFilter "Isopoint"

SelectObj "crvlist.isopnt[(0,0.489)]"

InsertCurveKnot "crvlist.isopnt[(0,0.489)]", 3, siPersistentOperation

2. JScript Example

/*

	This example creates a simple curve, selects an isopoint, and creates a bezier-knot

	at this location.

*/

SICreateCurve("crvlist", 3, 0);

SIAddPointOnCurveAtEnd("crvlist", -4, 2, 0, false, 0);

SIAddPointOnCurveAtEnd("crvlist", -5, -2, 0, false, 0);

SIAddPointOnCurveAtEnd("crvlist", -2, -2, 0, false, 0);

SIAddPointOnCurveAtEnd("crvlist", -1, 2, 0, false, 0);

SIAddPointOnCurveAtEnd("crvlist", 2, 2, 0, false, 0);

SIAddPointOnCurveAtEnd("crvlist", 2, -2, 0, false, 0);

SetSelFilter("Isopoint");

SelectObj("crvlist.isopnt[(0,0.489)]", null, null);

InsertCurveKnot("crvlist.isopnt[(0,0.489)]", 3, siPersistentOperation);