Python API 2.0 Reference
OpenMayaUI.MFnScaleManip Class Reference
+ Inheritance diagram for OpenMayaUI.MFnScaleManip:

Public Member Functions

def __init__ ()
 
def connectToScaleCenterPlug ()
 
def connectToScalePlug ()
 
def create ()
 
def displayWithNode ()
 
def scaleCenterIndex ()
 
def scaleIndex ()
 
def setInitialScale ()
 
- Public Member Functions inherited from OpenMayaUI.MFnManip3D
def __init__ ()
 
def rotateXYZValue ()
 
- Public Member Functions inherited from OpenMaya.MFnTransform
def __init__ ()
 
def clearRestPosition ()
 
def create ()
 
def enableLimit ()
 
def isLimited ()
 
def limitValue ()
 
def resetFromRestPosition ()
 
def restPosition ()
 
def rotateBy ()
 
def rotateByComponents ()
 
def rotateOrientation ()
 
def rotatePivot ()
 
def rotatePivotTranslation ()
 
def rotation ()
 
def rotationComponents ()
 
def rotationOrder ()
 
def scale ()
 
def scaleBy ()
 
def scalePivot ()
 
def scalePivotTranslation ()
 
def setLimit ()
 
def setRestPosition ()
 
def setRotateOrientation ()
 
def setRotatePivot ()
 
def setRotatePivotTranslation ()
 
def setRotation ()
 
def setRotationComponents ()
 
def setRotationOrder ()
 
def setScale ()
 
def setScalePivot ()
 
def setScalePivotTranslation ()
 
def setShear ()
 
def setTransformation ()
 
def setTranslation ()
 
def shear ()
 
def shearBy ()
 
def transformation ()
 
def translateBy ()
 
def translation ()
 
- Public Member Functions inherited from OpenMaya.MFnDagNode
def __init__ ()
 
def addChild ()
 
def child ()
 
def childCount ()
 
def create ()
 
def dagPath ()
 
def dagRoot ()
 
def duplicate ()
 
def fullPathName ()
 
def getAllPaths ()
 
def getConnectedSetsAndMembers ()
 
def getPath ()
 
def hasChild ()
 
def hasParent ()
 
def instanceCount ()
 
def isChildOf ()
 
def isInstanced ()
 
def isInstancedAttribute ()
 
def isParentOf ()
 
def parent ()
 
def parentCount ()
 
def partialPathName ()
 
def removeChild ()
 
def removeChildAt ()
 
def setObject ()
 
def transformationMatrix ()
 
- Public Member Functions inherited from OpenMaya.MFnDependencyNode
def __init__ ()
 
def absoluteName ()
 
def addAttribute ()
 
def addExternalContentForFileAttr ()
 
def affectsAnimation ()
 
def attribute ()
 
def attributeClass ()
 
def attributeCount ()
 
def canBeWritten ()
 
def create ()
 
def dgCallbackIds ()
 
def dgCallbacks ()
 
def dgTimer ()
 
def dgTimerOff ()
 
def dgTimerOn ()
 
def dgTimerQueryState ()
 
def dgTimerReset ()
 
def findAlias ()
 
def findPlug ()
 
def getAffectedAttributes ()
 
def getAffectingAttributes ()
 
def getAliasAttr ()
 
def getAliasList ()
 
def getConnections ()
 
def getExternalContent ()
 
def hasAttribute ()
 
def hasUniqueName ()
 
def isFlagSet ()
 
def isNewAttribute ()
 
def isTrackingEdits ()
 
def name ()
 
def plugsAlias ()
 
def removeAttribute ()
 
def reorderedAttribute ()
 
def setAffectsAnimation ()
 
def setAlias ()
 
def setDoNotWrite ()
 
def setExternalContent ()
 
def setExternalContentForFileAttr ()
 
def setFlag ()
 
def setName ()
 
def setUuid ()
 
def uniqueName ()
 
def userNode ()
 
def uuid ()
 
- Public Member Functions inherited from OpenMaya.MFnBase
def __init__ ()
 
def hasObj ()
 
def object ()
 
def setObject ()
 
def type ()
 

Static Public Member Functions

def __new__ ()
 
- Static Public Member Functions inherited from OpenMayaUI.MFnManip3D
def __new__ ()
 
def deleteManipulator ()
 
def drawPlaneHandles ()
 
def globalSize ()
 
def handleSize ()
 
def lineSize ()
 
def setDrawPlaneHandles ()
 
def setGlobalSize ()
 
def setHandleSize ()
 
def setLineSize ()
 
- Static Public Member Functions inherited from OpenMaya.MFnTransform
def __new__ ()
 
- Static Public Member Functions inherited from OpenMaya.MFnDagNode
def __new__ ()
 
- Static Public Member Functions inherited from OpenMaya.MFnDependencyNode
def __new__ ()
 
def allocateFlag ()
 
def classification ()
 
def deallocateAllFlags ()
 
def deallocateFlag ()
 
- Static Public Member Functions inherited from OpenMaya.MFnBase
def __new__ ()
 

Static Public Attributes

int kArbitraryOrientation = 1
 
int kDefaultOrientation = 0
 
- Static Public Attributes inherited from OpenMaya.MFnTransform
int kRotateMaxX = 13
 
int kRotateMaxY = 15
 
int kRotateMaxZ = 17
 
int kRotateMinX = 12
 
int kRotateMinY = 14
 
int kRotateMinZ = 16
 
int kScaleMaxX = 1
 
int kScaleMaxY = 3
 
int kScaleMaxZ = 5
 
int kScaleMinX = 0
 
int kScaleMinY = 2
 
int kScaleMinZ = 4
 
int kShearMaxXY = 7
 
int kShearMaxXZ = 9
 
int kShearMaxYZ = 11
 
int kShearMinXY = 6
 
int kShearMinXZ = 8
 
int kShearMinYZ = 10
 
int kTranslateMaxX = 19
 
int kTranslateMaxY = 21
 
int kTranslateMaxZ = 23
 
int kTranslateMinX = 18
 
int kTranslateMinY = 20
 
int kTranslateMinZ = 22
 
- Static Public Attributes inherited from OpenMaya.MFnDagNode
int kNextPos = 255
 
- Static Public Attributes inherited from OpenMaya.MFnDependencyNode
int kTimerMetrics = 9
 
int kTimerTypes = 3
 
int kExtensionAttr = 3
 
int kInvalidAttr = 4
 
int kLocalDynamicAttr = 1
 
int kNormalAttr = 2
 
int kTimerInvalidState = 3
 
int kTimerOff = 0
 
int kTimerOn = 1
 
int kTimerUninitialized = 2
 
int kTimerMetric_callback = 0
 
int kTimerMetric_callbackNotViaAPI = 6
 
int kTimerMetric_callbackViaAPI = 5
 
int kTimerMetric_compute = 1
 
int kTimerMetric_computeDuringCallback = 7
 
int kTimerMetric_computeNotDuringCallback = 8
 
int kTimerMetric_dirty = 2
 
int kTimerMetric_draw = 3
 
int kTimerMetric_fetch = 4
 
int kTimerType_count = 2
 
int kTimerType_inclusive = 1
 
int kTimerType_self = 0
 

Properties

 isSnapModeOn = property(...)
 
 orientation = property(...)
 
 orientationMode = property(...)
 
 snapIncrement = property(...)
 
- Properties inherited from OpenMayaUI.MFnManip3D
 isOptimizePlaybackOn = property(...)
 
 isVisible = property(...)
 
 manipScale = property(...)
 
- Properties inherited from OpenMaya.MFnDagNode
 boundingBox = property(...)
 
 inModel = property(...)
 
 inUnderWorld = property(...)
 
 isInstanceable = property(...)
 
 isIntermediateObject = property(...)
 
 objectColor = property(...)
 
 objectColorRGB = property(...)
 
 objectColorType = property(...)
 
 useObjectColor = property(...)
 
- Properties inherited from OpenMaya.MFnDependencyNode
 isDefaultNode = property(...)
 
 isFromReferencedFile = property(...)
 
 isLocked = property(...)
 
 isShared = property(...)
 
 namespace = property(...)
 
 pluginName = property(...)
 
 typeId = property(...)
 
 typeName = property(...)
 

Detailed Description

This class provides access to the built-in Maya scale manipulator.

Method resolution order:
-   MFnScaleManip
-   MFnManip3D
-   OpenMaya.MFnTransform
-   OpenMaya.MFnDagNode
-   OpenMaya.MFnDependencyNode
-   OpenMaya.MFnBase
-   builtins.object

Constructor & Destructor Documentation

def OpenMayaUI.MFnScaleManip.__init__ ( )
Initialize self.  See help(type(self)) for accurate signature.

Member Function Documentation

def OpenMayaUI.MFnScaleManip.__new__ ( )
static
Create and return a new object.  See help(type) for accurate signature.
def OpenMayaUI.MFnScaleManip.connectToScaleCenterPlug ( )
connectToScaleCenterPlug(scaleCenterPlug) -> self

Create a 1-1 association of the scale center on the manipulator and the scaleCenterPlug parameter.  When both the scale center is attached to a plug and the displayWithNode() method has been called, the manipulator will display with the node regardless of the connection made to the scale center.

The plug must have a data type of MFnNumericData.k3Double.

* scaleCenterPlug (MPlug) - The plug to connect the scale center to
def OpenMayaUI.MFnScaleManip.connectToScalePlug ( )
connectToScalePlug(scalePlug) -> self

Create a 1-1 connection from the scale manipVal to the scalePlug parameter.  Any changes to the scale manipVal will be immediately reflected in the connected plug.  Connecting to the "scale" plug on a transform node will produce similar behavior to the built-in scale manipulator.

The plug must have a data type of MFnNumericData.k3Double.

* scalePlug (MPlug) - The plug to connect the scale value to
def OpenMayaUI.MFnScaleManip.create ( )
create(manipName=None, scaleName=None) -> MObject

Creates a new ScaleManip, and attaches this function set to the new manipulator.

This method should only be used to create a non-composite manipulator, meaning that the manipulator is standalone and not part of a container.

When the manipulator is being used, the feedback line will display a string including scaleName, indicating that this manipulator is in use.

* manipName (string) - Name of the manip for UI purposes.
* scaleName (string) - Label for the scale value displayed in the feedback line.
def OpenMayaUI.MFnScaleManip.displayWithNode ( )
displayWithNode(node) -> self

Configures the manipulator to display with the node, causing the position of the manipulator to follow the position of the node whenever the node is moved.  The node must be a DAG object.

* node (MObject) - The node the manipulator should display with
def OpenMayaUI.MFnScaleManip.scaleCenterIndex ( )
scaleCenterIndex() -> int

Returns the index of the scale center manipVal for this manipulator.

Note that the scale center is only used for display of the manipulator and has no effect on scale values produced by the manipulator.
def OpenMayaUI.MFnScaleManip.scaleIndex ( )
scaleIndex() -> int

Returns the index of the scale manipVal for this manipulator.
def OpenMayaUI.MFnScaleManip.setInitialScale ( )
setInitialScale(scale) -> self

Sets the initial scale for the scale manipulator.  Setting the initial scale will prevent the manipulator from jumping back to the default scale when there is already an existing scale on the target plug.

* scale (MVector) - The initial scale

Property Documentation

OpenMayaUI.MFnScaleManip.isSnapModeOn = property(...)
static
 Whether or not the snap mode is on.
OpenMayaUI.MFnScaleManip.orientation = property(...)
static
 The arbitrary orientation of the MFnScaleManip. This only has any effect when the orientation mode is set to kArbitraryOrientation.
OpenMayaUI.MFnScaleManip.orientationMode = property(...)
static
 When the manipulator's orientationMode is set to kArbitraryOrientation the manipulator will be oriented according to oritentation value. When the orientationMode is set to kDefaultOrientation the manipulator will be aligned with the world-space axes.
OpenMayaUI.MFnScaleManip.snapIncrement = property(...)
static
 The snap increment is specified in the working  unit, and is the distance between snap points when dragging the scale handles.