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 | ![]() |
|
|
|||
frozen / fzn | bool | ||
nodeState / nds | int | ||
normal / no | bool | ![]() ![]() ![]() |
|
|
|||
normalizedNormal / nn | bool | ![]() ![]() ![]() |
|
|
|||
normalizedTangentU / ntu | bool | ![]() ![]() ![]() |
|
|
|||
normalizedTangentV / ntv | bool | ![]() ![]() ![]() |
|
|
|||
parameterU / u | float | ![]() ![]() |
|
|
|||
parameterV / v | float | ![]() ![]() |
|
|
|||
position / p | bool | ![]() ![]() ![]() |
|
|
|||
tangentU / tu | bool | ![]() ![]() ![]() |
|
|
|||
tangentV / tv | bool | ![]() ![]() ![]() |
|
|
|||
turnOnPercentage / top | bool | ![]() ![]() |
|
|
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.