Go to: Synopsis. Return value. Flags. MEL examples.
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.
In query mode, return type is based on queried flag.
constructionHistory,
curvatureCenter, curvatureRadius, normal, normalizedNormal, normalizedTangent, parameter, position, tangent,
turnOnPercentage
Long name (short name) |
Argument types |
Properties |
-parameter(-pr) |
float |
|
|
The parameter value on curve
Default: 0.0 |
|
-turnOnPercentage(-top) |
boolean |
|
|
Whether the parameter is normalized (0,1) or not
Default: false |
|
-position(-p) |
|
|
|
Returns the (x,y,z) position 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 |
|
-tangent(-t) |
|
|
|
Returns the (x,y,z) tangent of the specified point on the
curve |
|
-normalizedTangent(-nt) |
|
|
|
Returns the (x,y,z) normalized tangent of the specified point
on the curve |
|
-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 |
|
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. |
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.