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.

This command returns information for a point on a NURBS curve. If no flag is specified, it assumes p/position by default.

Return value

float[3]
float
string

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

Flags

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