Evaluate the curve position, tangency, and normal at a given length or ratio.

Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference so you need to use the best workaround for your situation:

For scripting languages this command returns an ISIVTCollection which you can use to get the output arguments.

For C# you can use the XSIApplication.ExecuteCommand method to call this command. ExecuteCommand packs the output arguments into a C# System.Object containing an Array of the output arguments (see Calling Commands from C#).

EvaluateCurveAt( InputObj, Value, [Local], [PosX], [PosY], [PosZ], [TanX], [TanY], [TanZ], [NorX], [NorY], [NorZ] );

Parameter	Type	Description
InputObj	String	Curve to evaluate.
Value	Double	A percentage or a length, depending on the value of the Percentage parameter.
Local	Boolean	True to evaluate at a certain percentage along the curve, False to evaluate at a specific length. Default Value: False
PosX	Double	Returns the X component of the postion of the evaluated point
PosY	Double	Returns the Y component of the Postion of the evaluated point
PosZ	Double	Returns the Z component of the Postion of the evaluated point
TanX	Double	Returns the X component of the Tangent of the evaluated point
TanY	Double	Returns the Y component of the Tangent of the evaluated point
TanZ	Double	Returns the Z component of the Tangent of the evaluated point
NorX	Double	Returns the X component of the Normal of the evaluated point
NorY	Double	Returns the Y component of the Normal of the evaluated point
NorZ	Double	Returns the Z component of the Normal of the evaluated point

VBScript Example

'This example shows how to evaluate a curve by percentage.

newscene

dim posx, posy, posz, tanx, tany, tanz, normx, normy, normz

CreatePrim "Spiral", "NurbsCurve"	

' Evaluate at a point 50% along the curve length

set rtn = EvaluateCurveAt( "Spiral", .5, True, posx, posy, posz, tanx, tany, tanz, normx, normy, normz )	

logmessage "Position : ("& posx & ", " & posy & ", " &  posz & ")"

logmessage "tangent  : ("& tanx & ", " & tany & ", " &  tanz & ")"

logmessage "Normal   : ("& normx & ", " & normy & ", " &  normz & ")"

CreateCurve GetCurveLength GetCurvePercentageAtKnotIndex GetNumberOfKnots SISetCurvePoints SIAddPointOnCurveAtStart SIAddPointOnCurveAtEnd SIAddPointOnCurve SICreateCurve NurbsCurve.EvaluatePosition NurbsCurveList.GetClosestCurvePosition2