EvaluateCurveAt
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 |
'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