pymel.core.context.manipRotateContext¶
- manipRotateContext(*args, **kwargs)¶
This command can be used to create, edit, or query a rotate manip context.
Flags:
Long Name / Short Name Argument Types Properties activeHandle / ah int Sets the default active handle for the manip. That is, the handle which should be initially active when the tool is activated. Values can be: 0 - X axis handle is active1 - Y axis handle is active2 - Z axis handle is active3 - View rotation handle (outer ring) is active (default) alignAlong / aa float, float, float Aligns active handle along vector. centerTrackball / ctb bool Specify if the center is to be handled like a trackball constrainAlongNormal / xn bool When true, transform constraints are applied along the vertex normal first and only use the closest point when no intersection is found along the normal. currentActiveHandle / cah int Sets the active handle for the manip. Values can be: 0 - X axis handle is active1 - Y axis handle is active2 - Z axis handle is active3 - View rotation handle (outer ring) is active4 - Arc Ball is active editPivotMode / epm bool Returns true manipulator is in edit pivot mode editPivotPosition / epp bool Returns the current position of the edit pivot manipulator. exists / ex bool Returns true or false depending upon whether the specified object exists. Other flags are ignored. image1 / i1 unicode First of three possible icons representing the tool associated with the context. image2 / i2 unicode Second of three possible icons representing the tool associated with the context. image3 / i3 unicode Third of three possible icons representing the tool associated with the context. lastMode / lm int Returns the previous rotation mode. manipVisible / vis bool Returns true if the rotate manipulator is visible. mode / m int Rotate mode: 0 - Object Space (default)1 - World Space2 - Gimbal Mode3 - Custom Axis Orientation10 - Component Space modifyTranslation / mt bool When false, and an object is rotated about a point other than its rotate pivot, its rotateTranslate attribute is modified to put the object at the correct position. When true, its translate attribute is used instead. Default is false. orientAxes / oa float, float, float Orients manipulator rotating around axes by specified angles orientObject / oo unicode Orients manipulator to the passed in object/component orientTowards / ot float, float, float Orients active handle towards world point pinPivot / pin bool Pin component pivot. When the component pivot is set and pinned selection changes will not reset the pivot position and orientation. pivotOriHandle / poh bool When true, the pivot manipulator will show the orientation handle during editing. Default is true. position / p bool Returns the current position of the manipulator. postCommand / psc script Specifies a command to be executed when the tool is exited. postDragCommand / pod script, <type ‘unicode’> Specifies a command and a node type. The command will be executed at the end of a drag when a node of the specified type is in the selection. preCommand / prc script Specifies a command to be executed when the tool is entered. preDragCommand / prd script, <type ‘unicode’> Specifies a command and a node type. The command will be executed at the start of a drag when a node of the specified type is in the selection. preserveChildPosition / pcp bool When false, the children objects move when their parent is rotated. When true, the worldspace position of the children will be maintained as the parent is moved. Default is false. preserveUV / puv bool When false, the uvs are not changes to match the vertex edit. When true, the uvs are edited to project to new values to stop texture swimming as vertices are moved. reflection / rfl bool This flag is obsolete. Reflection is now managed as part of selection itself using the symmetricModeling command. reflectionAbout / rab int This flag is obsolete. Reflection is now managed as part of selection itself using the symmetricModeling command. reflectionAxis / rfa int This flag is obsolete. Reflection is now managed as part of selection itself using the symmetricModeling command. reflectionTolerance / rft float This flag is obsolete. Reflection is now managed as part of selection itself using the symmetricModeling command. rotate / ro float, float, float Returns the rotation of the manipulator for its current orientation/mode. snap / s bool Specify that the manipulation is to use absolute snap snapPivotOri / spo bool Snap pivot orientation. Modify pivot orientation when snapping the pivot to a component. snapPivotPos / spp bool Snap pivot position. Modify pivot position when snapping the pivot to a component. snapRelative / sr bool Specify that the manipulation is to use relative snap snapValue / sv float Specify the snapping value tweakMode / twk bool When true, the manipulator is hidden and highlighted components can be selected and rotated in one step using a click-drag interaction. useCenterPivot / ucp bool When true, use the center of the selection’s bounding box as the center of the rotation (for all objects). useManipPivot / ump bool When true, use the manipulator’s center as the center of the rotation (for all objects). useObjectPivot / uop bool When true, use each object’s pivot as the center of its rotation. xformConstraint / xc unicode none - no transform constraintedge - edge transform constraintsurface - surface transform constraintFlag can have multiple arguments, passed either as a tuple or a list. Derived from mel command maya.cmds.manipRotateContext
Example:
import pymel.core as pm # To create a new rotate context: pm.manipRotateContext() # Result: u'manipRotateContext2' # # To query the mode of an existing context: pm.manipRotateContext( 'manipRotateContext1', q=True, mode=True ) # Result: 0 # # To edit an existing context to come up with the X axis # handle active by default: pm.manipRotateContext( 'manipRotateContext1', e=True, ah=0 ) # Result: u'manipRotateContext1' #