pymel.core.modeling.pointOnSurface¶

pointOnSurface(*args, **kwargs)¶

This command returns information for a point on a surface. If no flag is specified, this command assumes p/position by default. If more than one flag is specifed, then a string array is returned.

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.
frozen / fzn		bool
nodeState / nds		int
normal / no		bool
	Returns the (x,y,z) normal of the specified point on the surface
normalizedNormal / nn		bool
	Returns the (x,y,z) normalized normal of the specified point on the surface
normalizedTangentU / ntu		bool
	Returns the (x,y,z) normalized U tangent of the specified point on the surface
normalizedTangentV / ntv		bool
	Returns the (x,y,z) normalized V tangent of the specified point on the surface
parameterU / u		float
	The U parameter value on surface Default:0.0
parameterV / v		float
	The V parameter value on surface Default:0.0
position / p		bool
	Returns the (x,y,z) positon of the specified point on the surface
tangentU / tu		bool
	Returns the (x,y,z) U tangent of the specified point on the surface
tangentV / tv		bool
	Returns the (x,y,z) V tangent of the specified point on the surface
turnOnPercentage / top		bool
	Whether the parameter is normalized (0,1) or not Default:false Common flags

Derived from mel command maya.cmds.pointOnSurface

Example:

import pymel.core as pm

pm.pointOnSurface( 'surface1', u=0.5, v=1.0, position=True )
# Returns the (x,y,z) position of the surface at parameter (u=0.5,v=1.0).

infoNode = pm.pointOnSurface('surface1', ch= True, u=0.55, v=0.33)
pm.getAttr(infoNode + ".position" )  # returns the position
# The pointOnSurface command returns  a string which is the name of
# a new pointOnSurfaceInfo dependency node.  With this node connected
# to the surface, the output values of the pointOnSurfaceInfo node
# are always current even if, for example, the surface parameters are
# being animated.