# MFnTransform

## Base Class

MFnDagNode

## Constants

Name | Type | Description
--- | --- | ---
Limit Types
kScaleMinX | int |
kScaleMaxX | int |
kScaleMinY | int |
kScaleMaxY | int |
kScaleMinZ | int |
kScaleMaxZ | int |
kShearMinXY | int |
kShearMaxXY | int |
kShearMinXZ | int |
kShearMaxXZ | int |
kShearMinYZ | int |
kShearMaxYZ | int |
kRotateMinX | int |
kRotateMaxX | int |
kRotateMinY | int |
kRotateMaxY | int |
kRotateMinZ | int |
kRotateMaxZ | int |
kTranslateMinX | int |
kTranslateMaxX | int |
kTranslateMinY | int |
kTranslateMaxY | int |
kTranslateMinZ | int |
kTranslateMaxZ | int |

## Static Methods

None.

## Constructors

Signature | Parameters | Description
--- | --- | ---
MFnTransform() |  | Default constructor. Returns a new MFnTransform function set with no Maya object attached.
MFnTransform(object) | object - MObject | Returns a new MFnTransform function set, attached to the specified Maya object.
MFnTransform(path) | object - MDagPath | Returns a new MFnTransform function set, attached to the specified DAG path.

## Object Methods

Signature | Parameters | Returns | Description
--- | --- | --- | ---
clearRestPosition() |  | Reference to self. | Clears the transform's rest position matrix, effectively setting it to the identity matrix.
create(parent=MObject.kNullObj) | parent - MObject | MObject | Creates a new transform node, parents it under parent, attaches it to the function set and returns it in an MObject. If parent is MObject.kNullObj then the new transform will be parented under the world.
enableLimit(limitType, state) | limitType - Limit Type constant state - bool | Reference to self | Enables or disables the specified limitType.
isLimited(limitType) | limitType - Limit Type constant | bool | Returns True if the specified limitType is enabled.
limitValue(limitType) | limitType - Limit Type constant | float | Returns the value of the specified limit.
resetFromRestPosition() |  | Reference to self. | Resets the transform from its rest position matrix.
restPosition() |  | MTransformationMatrix | Returns the transform's rest position matrix, or the identity matrix if no rest position has been set.
rotateBy(rot, space) | rot - MQuaternion or MEulerRotation space - MSpace constant | Reference to self. | Adds rot to the transform's rotation component.
rotateByComponents(seq, space, asQuaternion=False) | seq - sequence of 4 floats or 3 floats and a Rotation Order constant space - MSpace constant asQuaternion - bool | Reference to self. | Adds the rotation represented by the four parameter values to the transform's rotate component. If asQuaternion is True then seq must contain four floats representing the x, y, z and w components of a quaternion rotation. If asQuaternion is False then seq must contain three floats representing the x, y and z angles, followed by an MTransformationMatrix Rotation Order constant, which together form an Euler rotation.
rotateOrientation(space) | space - MSpace constant | MQuaternion | Returns the rotation which orients the local rotation space.
rotatePivot(space) | space - MSpace constant | MPoint | Returns the transform's rotate pivot component.
rotatePivotTranslation(space) | space - MSpace constant | MVector | Returns the transform's rotate pivot translation component.
rotation(space=MSpace.kTransform, asQuaternion=False) | space - MSpace constant asQuaternion - bool | MEulerRotation or MQuaternion | Returns the transform's rotation component as either an Euler rotation or a quaternion.
rotationComponents(space=MSpace.kTransform, asQuaternion=False) | space - MSpace constant asQuaternion - bool | [x, y, z, order] or [x, y, z, w] | Returns a list containing the four components of the transform's rotate component. If asQuaternion is True then the first three elements are the quaternion's unreal x, y, and z components, and the fourth is its real w component. If asQuaternion is False then the first three components are the x, y and z Euler rotation angles and the fourth is an MTransformationMatrix Rotation Order constant.
rotationOrder() |  | MTransformationMatrix Rotation Order constant | Returns the order of rotations when the transform's rotate component is expressed as an euler rotation.
scale() |  | [sx, sy, sz] | Returns a list containing the transform's scale components.
scaleBy(seq) | seq - sequence of 3 floats | Reference to self. | Multiplies the transform's scale components by the three floats in seq.
scalePivot(space) | space - MSpace constant | MPoint | Returns the transform's scale pivot component.
scalePivotTranslation(space) | space - MSpace constant | MVector | Returns the transform's scale pivot translation component.
setLimit(limitType, value) | limitType - Limit Type constant value - float | Reference to self | Sets the value of the specified limit.
setRestPosition(matrix) | matrix - MTransformationMatrix | Reference to self. | Sets the transform's rest position matrix.
setRotateOrientation(rot, space, balance) | rot - MQuaternion space - MSpace constant balance - bool |  | Sets the rotation which orients the local rotation space. If balance is True then the transform's other components will be adjusted to give the same overall transformation as before.
setRotatePivot(pivot, space, balance)) | pivot - MPoint space - MSpace constant balance - bool | Reference to self. | Sets the transform's rotate pivot component.
setRotatePivotTranslation(trans, space) | trans - MVector space - MSpace constant | Reference to self. | Sets the transform's rotate pivot translation component.
setRotation(rot, space) | rot - MQuaternion or MEulerRotation space - MSpace constant | Reference to self. | Sets the transform's rotation component to rot.
setRotationComponents(seq, space=MSpace.kTransform, asQuaternion=False) | seq - sequence of 4 floats or 3 floats and a Rotation Order constant space - MSpace constant asQuaternion - bool | Reference to self. | Sets the transform's rotate component. If asQuaternion is True then seq must contain four floats representing the x, y, z and w components of a quaternion rotation. If asQuaternion is False then seq must contain three floats representing the x, y and z angles, followed by an MTransformationMatrix Rotation Order constant, which together form an Euler rotation.
setRotationOrder(order, reorder) | order - MTransformationMatrix Rotation Order constant reorder - bool | Reference to self. | Sets the transform's rotation order. If reorder is True then the X, Y and Z rotations will be modified so that the resulting rotation under the new order is the same as it was under the old. If reorder is False then the X, Y and Z rotations are unchanged.
setScale(seq) | seq - sequence of 3 floats | Reference to self. | Sets the transform's scale components to the three floats in seq.
setScalePivot(pivot, space, balance) | pivot - MPoint space - MSpace constant balance - bool | Reference to self. | Sets the transform's scale pivot component.
setScalePivotTranslation(trans, space) | trans - MVector space - MSpace constant | Reference to self. | Sets the transform's scale pivot translation component.
setShear(seq) | seq - sequence of 3 floats | Reference to self. | Sets the transform's shear component.
setTransformation(transformation) | transformation - MTransformationMatrix | Reference to self | Sets this transform's attribute values to represent the given transformation matrix.
setTranslation(trans, space) | trans - MVector space - MSpace constant | Reference to self. | Sets the transform's translation component.
shear() |  | [x, y, z] | Returns a list containing the transform's shear component.
shearBy(seq) | seq - sequence of 3 floats | Reference to self. | Multiplies the transform's shear components by the elements of seq.
transformation() |  | MTransformationMatrix | Returns the transformation matrix represented by this transform.
translateBy(vec, space) | vec - MVector space - MSpace constant | Reference to self. | Adds vec to the transform's translation component.
translation(space) | space - MSpace constant | MVector | Returns the transform's translation component as a vector.

## Object Attributes

None.

## Sequence Support

None.

## Number Support

None.

## Comparison Support

None.

© 2011 Autodesk, Inc. All rights reserved.