SIAddPointOnCurve

SIAddPointOnCurve

Description

Adds a point afer an existing point on a curve, or adds a knot at a specified percentage of the curve length.

Scripting Syntax

SIAddPointOnCurve( InputObj, [InsertPosition], [X], [Y], [Z], [Local], [CurveType] )

Parameters

Parameter	Type	Description
InputObj	String	Curve to set points on.
InsertPosition	Double	Where to insert the point or knot. Default Value: 0 Possible Values: • Indexofanexistingpointonthecurve.: The new point is added after this point. Points are indexed starting at 0. • Percentage: The new knot is inserted at this percentage along the curve length, at the specified coordinates.
X	Double	X coordinate Default Value: 0
Y	Double	Y coordinate Default Value: 0
Z	Double	Z coordinate Default Value: 0
Local	Boolean	True if points are in local coordinates, False if they are in global coordinates. Default Value: False
CurveType	Integer	Type of curve Default Value: -1

Examples

VBScript Example

'This example shows how to add a point in the middle of a curve
newscene
'Create a curve by adding points at the end
SICreateCurve "crvlist", 3, 0
SIAddPointOnCurveAtEnd "crvlist", -4.0, 0, 1.6, False
SIAddPointOnCurveAtEnd "crvlist", -3.9, 0, -0.3, False
SIAddPointOnCurveAtEnd "crvlist", -2.3, 0, 0.2, False
SIAddPointOnCurveAtEnd "crvlist", -1.9, 0, -2.2, False
SIAddPointOnCurveAtEnd "crvlist", -0.1, 0, -0.9, False
SIAddPointOnCurveAtEnd "crvlist", 0.4, 0, 0.6, False
SIAddPointOnCurveAtEnd "crvlist", 3, 0, -1.7, False
SIAddPointOnCurveAtEnd "crvlist", 3.7, 0, -1.8, False

'Add a point after the fourth control point (indexing is 0 based)
SIAddPointOnCurve "crvlist", 3 , 1.0, 2.0, 3.0, 0

' Add a knot at 0.72 (normalized value between 0 and 1)
SIAddPointOnCurve "crvlist", 0.72, 2.0, 3.0, 4.0, 0

See Also

CreateCurve	SISetCurvePoints	SICreateCurve	SIAddPointOnCurveAtEnd
GetCurveLength	SIAddPointOnCurveAtStart	EvaluateCurveAt

Autodesk Softimage v7.5