Go to: Synopsis. Return value. Flags. Python examples.
pointPosition(
[object]
, [local=boolean], [world=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
pointPosition is undoable, NOT queryable, and NOT editable.
This command returns the world or local space position for any type of
point object. Valid selection items are:
- curve and surface CVs
- poly vertices
- lattice points
- particles
- curve and surface edit points
- curve and surface parameter points
- poly uvs
- rotate/scale/joint pivots
- selection handles
- locators, param locators and arc length locators
It works on the selected object or you can specify the object in
the command. By default, if no flag is specified then the world
position is returned.
local, world
| Long name (short name) |
Argument types |
Properties |
|
local(l)
|
boolean
|
|
|
Return the point in local space coordinates.
|
|
world(w)
|
boolean
|
|
|
Return the point in world space coordinates.
|
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
cmds.pointPosition( 'curve1.cv[3]' )
# Returns the (x,y,z) world position of curve1's 3rd CV.
cmds.pointPosition( 'particle1.pt[1]', l=True )
# Returns the (x,y,z) local position of the particle point.