pointOnCurve

Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

pointOnCurve [-constructionHistory boolean] [-curvatureCenter] [-curvatureRadius] [-normal] [-normalizedNormal] [-normalizedTangent] [-parameter float] [-position] [-tangent] [-turnOnPercentage boolean] [objects]

pointOnCurve is undoable, queryable, and editable.

Return value

In query mode, return type is based on queried flag.

Flags

Long name (short name)	Argument types	Properties
-curvatureCenter(-cc)
Returns the (x,y,z) center of curvature of the specified point on the curve
-curvatureRadius(-cr)
Returns the radius of curvature of the specified point on the curve
-normal(-no)
Returns the (x,y,z) normal of the specified point on the curve
-normalizedNormal(-nn)
Returns the (x,y,z) normalized normal of the specified point on the curve
-normalizedTangent(-nt)
Returns the (x,y,z) normalized tangent of the specified point on the curve
-parameter(-pr)	float
The parameter value on curve Default: 0.0
-position(-p)
Returns the (x,y,z) position of the specified point on the curve
-tangent(-t)
Returns the (x,y,z) tangent of the specified point on the curve
-turnOnPercentage(-top)	boolean
Whether the parameter is normalized (0,1) or not Default: false
Common flags
-constructionHistory(-ch)	boolean
Turn the construction history on or off.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command.

MEL examples

pointOnCurve -pr 0.5 -p curve1;
// Returns the (x,y,z) position of curve1 at parameter 0.5.

pointOnCurve -pr 0.5 curve1;
// Returns the (x,y,z) position of curve1 at parameter 0.5, since
// position is the default information.

pointOnCurve -pr 0.5 -nn curve1;
// Returns the (x,y,z) normalized normal of curve1 at parameter 0.5.

pointOnCurve -pr 0.5 -cr curve1;
// Returns the curvature radius of curve1 at parameter 0.5.

string $infoNode = `pointOnCurve -ch on -pr 0.55 curve1`;
getAttr ($infoNode + ".position");    // returns the position
getAttr ($infoNode + ".normal");      // returns the normal
// Returns a string which is the name of a new pointOnCurveInfo
// dependency node.  With this node connected to the curve,
// the output values of the pointOnCurveInfo node are always current
// even if, for example, the parameter is being animated.