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.
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  
   
image1 (i1) unicode  
   
image2 (i2) unicode  
   
image3 (i3) unicode  
   
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 Orientation

orientAxes (oa) float, float, float ../../../_images/query.gif ../../../_images/edit.gif
 
Orients manipulator rotating around axes by specified angles
orientTowards (ot) float, float, float ../../../_images/create.gif ../../../_images/edit.gif
 
Orients active handle towards world point
position (p) bool ../../../_images/query.gif
 
Returns the current position of the manipulator
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.
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.Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

preserveUV (puv) bool  
   
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.
snap (s) bool  
   
snapRelative (sr) bool  
   
snapValue (sv) float  
   
useManipPivot (ump) bool  
   
useObjectPivot (uop) bool  
   

Derived from mel command maya.cmds.manipScaleContext

Example:

import pymel.core as pm

import maya.cmds as cmds

# 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' #

Previous topic

pymel.core.context.manipRotateLimitsCtx

Next topic

pymel.core.context.manipScaleLimitsCtx

Core

Core Modules

Other Modules

This Page