pymel.core.modeling.pointOnCurve¶

pointOnCurve(*args, **kwargs)¶

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

Flags:

Long Name / Short Name		Argument Types	Properties
caching / cch		bool
constructionHistory / ch		bool
	Turn the construction history on or off. Flag can have multiple arguments, passed either as a tuple or a list.
curvatureCenter / cc		bool
	Returns the (x,y,z) center of curvature of the specified point on the curve
curvatureRadius / cr		bool
	Returns the radius of curvature of the specified point on the curve
frozen / fzn		bool
nodeState / nds		int
normal / no		bool
	Returns the (x,y,z) normal of the specified point on the curve
normalizedNormal / nn		bool
	Returns the (x,y,z) normalized normal of the specified point on the curve
normalizedTangent / nt		bool
	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		bool
	Returns the (x,y,z) position of the specified point on the curve
tangent / t		bool
	Returns the (x,y,z) tangent of the specified point on the curve
turnOnPercentage / top		bool
	Whether the parameter is normalized (0,1) or not Default:false Common flags

Derived from mel command maya.cmds.pointOnCurve

Example:

import pymel.core as pm

pm.pointOnCurve( 'curve1', pr=0.5, p=True )
# Returns the (x,y,z) position of curve1 at parameter 0.5.

pm.pointOnCurve( 'curve1', pr=0.5 )
# Returns the (x,y,z) position of curve1 at parameter 0.5, since
# position is the default information.

pm.pointOnCurve( 'curve1', pr=0.5, nn=True )
# Returns the (x,y,z) normalized normal of curve1 at parameter 0.5.

pm.pointOnCurve( 'curve1', pr=0.5, cr=True )
# Returns the curvature radius of curve1 at parameter 0.5.

infoNode = pm.pointOnCurve('curve1', ch=True, pr=0.55)
pm.getAttr(infoNode + ".position")  # returns the position
pm.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.