manipPivot

Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

manipPivot [-bakeOri boolean] [-moveToolOri int] [-ori float float float] [-oriValid] [-pinPivot boolean] [-pos float float float] [-posValid] [-reset] [-resetMode int] [-resetOri] [-resetPos] [-rotateToolOri int] [-scaleToolOri int] [-snapOri boolean] [-snapPos boolean] [-valid]

manipPivot is undoable, queryable, and NOT editable.

Return value

None

In query mode, return type is based on queried flag.

Flags

Long name (short name)	Argument types	Properties
-bakeOri(-bo)	boolean
Bake pivot orientation. Automatically bake pivot orientation changes into the transform hierarchy / geometry.
-moveToolOri(-mto)	int
Change move tool's axis orientation to the specified mode. This flag is the same as using "manipMoveContext -e -mode" on the Move tool except that this command is undoable.
-ori(-o)	float float float
Component pivot orientation in world-space.
-oriValid(-ov)
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)
Returns true if component pivot position is valid.
-reset(-r)
Clear the saved component pivot position and orientation.
-resetMode(-rm) 2025	int
Specifies the mode used when resetting the pivot position. Available modes are: 0: Center pivot (on bounding box) 1: Zero pivot (object-space origin)
-resetOri(-ro)
Clear the saved component pivot orientation.
-resetPos(-rp)
Clear the saved component pivot position.
-rotateToolOri(-rto)	int
Change rotate tool's axis orientation to the specified mode. This flag is the same as using "manipRotateContext -e -mode" on the Rotate tool except that this command is undoable.
-scaleToolOri(-sto)	int
Change scale tool's axis orientation to the specified mode. This flag is the same as using "manipScaleContext -e -mode" on the Scale tool except that this command is undoable.
-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)
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 be used more than once in a command.

MEL examples

// Set tool component pivot to <1,0,0>
manipPivot -p 1 0 0;