pymel.core.context.manipScaleContext

manipScaleContext(*args, **kwargs)

This command can be used to create, edit, or query a scale manip context.

Flags:

Long Name / Short Name Argument Types Properties
activeHandle / ah int ../../../_images/query.gif ../../../_images/edit.gif
  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 - Center handle (all axes) is active (default)
alignAlong / aa float, float, float ../../../_images/create.gif ../../../_images/edit.gif
  Aligns active handle along vector.
constrainAlongNormal / xn bool ../../../_images/query.gif ../../../_images/edit.gif
  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 ../../../_images/query.gif ../../../_images/edit.gif
  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 - Center handle (all axes) is active4 - XY plane handle is active5 - YZ plane handle is active6 - XZ plane handle is active
editPivotMode / epm bool ../../../_images/query.gif
  Returns true manipulator is in edit pivot mode
editPivotPosition / epp bool ../../../_images/query.gif
  Returns the current position of the edit pivot manipulator.
exists / ex bool ../../../_images/create.gif
  Returns true or false depending upon whether the specified object exists. Other flags are ignored.
image1 / i1 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  First of three possible icons representing the tool associated with the context.
image2 / i2 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Second of three possible icons representing the tool associated with the context.
image3 / i3 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Third of three possible icons representing the tool associated with the context.
lastMode / lm int ../../../_images/query.gif
  Returns the previous scaling mode.
manipVisible / vis bool ../../../_images/query.gif
  Returns true if the scale manipulator is visible.
mode / m int ../../../_images/query.gif ../../../_images/edit.gif
  Translate mode: 0 - Object Space1 - Local Space2 - World Space (default)3 - Move Along Vertex Normal4 - Move Along Rotation Axis5 - Move Along Live Object Axis6 - Custom Axis Orientation9 - Component Space
orientAxes / oa float, float, float ../../../_images/query.gif ../../../_images/edit.gif
  Orients manipulator rotating around axes by specified angles
orientObject / oo unicode ../../../_images/create.gif ../../../_images/edit.gif
  Orients manipulator to the passed in object/component
orientTowards / ot float, float, float ../../../_images/create.gif ../../../_images/edit.gif
  Orients active handle towards world point
pinPivot / pin bool ../../../_images/query.gif ../../../_images/edit.gif
  Pin component pivot. When the component pivot is set and pinned selection changes will not reset the pivot position and orientation.
pivotOriHandle / poh bool ../../../_images/query.gif ../../../_images/edit.gif
  When true, the pivot manipulator will show the orientation handle during editing. Default is true.
position / p bool ../../../_images/query.gif
  Returns the current position of the manipulator.
postCommand / psc script ../../../_images/create.gif ../../../_images/edit.gif
  Specifies a command to be executed when the tool is exited.
postDragCommand / pod script, <type ‘unicode’> ../../../_images/create.gif ../../../_images/edit.gif
  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 ../../../_images/create.gif ../../../_images/edit.gif
  Specifies a command to be executed when the tool is entered.
preDragCommand / prd script, <type ‘unicode’> ../../../_images/create.gif ../../../_images/edit.gif
  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 ../../../_images/query.gif ../../../_images/edit.gif
  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 ../../../_images/query.gif ../../../_images/edit.gif
  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.
preventNegativeScale / pns bool ../../../_images/query.gif
  When this is true, negative scale is not allowed.
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.
scale / sc float, float, float ../../../_images/query.gif ../../../_images/edit.gif
  Returns the scale of the manipulator for its current orientation/mode.
snap / s bool  
   
snapPivotOri / spo bool ../../../_images/query.gif ../../../_images/edit.gif
  Snap pivot orientation. Modify pivot orientation when snapping the pivot to a component.
snapPivotPos / spp bool ../../../_images/query.gif ../../../_images/edit.gif
  Snap pivot position. Modify pivot position when snapping the pivot to a component.
snapRelative / sr bool  
   
snapValue / sv float  
   
tweakMode / twk bool ../../../_images/query.gif ../../../_images/edit.gif
  When true, the manipulator is hidden and highlighted components can be selected and scaled in one step using a click-drag interaction.
useManipPivot / ump bool  
   
useObjectPivot / uop bool  
   
xformConstraint / xc unicode ../../../_images/query.gif ../../../_images/edit.gif
  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.manipScaleContext

Example:

import pymel.core as pm

# To create a new scale context:
pm.manipScaleContext()
# Result: u'manipScaleContext1' #

# To query the active handle of an existing scale context:
pm.manipScaleContext( 'manipScaleContext1', q=True, ah=True )
# Result: 3 #

# To edit an exiting scale context so that it comes up with the X axis
# handle active by default:
pm.manipScaleContext( 'manipScaleContext1', e=True, ah=0 )
# Result: u'manipScaleContext1' #