Go to: Synopsis. Return value. Flags. Python examples.
manipPivot([ori=[float, float, float]], [oriValid=boolean], [pinPivot=boolean], [pos=[float, float, float]], [posValid=boolean], [reset=boolean], [resetOri=boolean], [resetPos=boolean], [snapOri=boolean], [snapPos=boolean], [valid=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
manipPivot is undoable, queryable, and NOT editable.
Changes transform component pivot used by the move/rotate/scale manipulators.
None
In query mode, return type is based on queried flag.
ori, oriValid, pinPivot, pos, posValid, reset, resetOri, resetPos, snapOri, snapPos, valid
| Long name (short name) |
Argument types |
Properties |
|
ori(o)
|
[float, float, float]
|
 
|
|
Component pivot orientation in world-space.
|
|
oriValid(ov)
|
boolean
|
|
|
Returns true if component pivot orientation is valid.
|
|
pinPivot(pin)
|
boolean
|
|
|
Pin component pivot. Selection changes will not reset the pivot position/orientation
when a custom pivot is set and pinning is on.
|
|
pos(p)
|
[float, float, float]
|
|
|
Component pivot position in world-space.
|
|
posValid(pv)
|
boolean
|
|
|
Returns true if component pivot position is valid.
|
|
reset(r)
|
boolean
|
|
|
Clear the saved component pivot position and orientation.
|
|
resetOri(ro)
|
boolean
|
|
|
Clear the saved component pivot orientation.
|
|
resetPos(rp)
|
boolean
|
|
|
Clear the saved component pivot position.
|
|
snapOri(so)
|
boolean
|
|
|
Snap pivot orientation. Modify pivot orientation when snapping the pivot to a component.
|
|
snapPos(sp)
|
boolean
|
|
|
Snap pivot position. Modify pivot position when snapping the pivot to a component.
|
|
valid(v)
|
boolean
|
|
|
Returns true if component pivot position or orientation is valid.
|
|
|
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
// Set tool component pivot to <1,0,0>
cmds.manipPivot( p=(1, 0, 0) )