C++ API Reference
|
Base class for user defined transforms. More...
#include <MPxTransform.h>
Public Member Functions | |
MPxTransform () | |
Class constructor. | |
MPxTransform (const MPxTransform &) | |
Default copy constructor MPxTransform is a weak-reference to the internal maya node, copying it has the same semantic as copying a raw-pointer. | |
MPxTransform & | operator= (const MPxTransform &) |
Default copy assignment operator MPxTransform is a weak-reference to the internal maya node, copying it has the same semantic as copying a raw-pointer. | |
virtual | ~MPxTransform () |
Class destructor. | |
virtual void | postConstructor () |
Post constructor. More... | |
virtual MPxNode::Type | type () const |
This method returns the type of the node. More... | |
virtual MPxTransformationMatrix * | createTransformationMatrix () |
This method returns a new transformation matrix. More... | |
virtual bool | isBounded () const |
This method should be overridden to return true if the user supplies a bounding box routine. More... | |
virtual MBoundingBox | boundingBox () const |
This method should be overridden to return a bounding box for the transform. More... | |
virtual bool | treatAsTransform () const |
Maya's base transform node type is treated differently from node types which are derived from it. More... | |
const MPxTransformationMatrix & | transformationMatrix () const |
This method returns a reference to the cached transformation matrix for current context. More... | |
MPxTransformationMatrix * | transformationMatrixPtr () const |
This function returns a pointer to the cached transformation matrix for current context. More... | |
virtual void | resetTransformation (const MMatrix &) |
This method will reset the transformation matrix to one that is constructed with the passed MMatrix. More... | |
virtual void | resetTransformation (MPxTransformationMatrix *) |
This method will reset the transformation matrix to the one specified by the passed transformation matrix pointer. More... | |
virtual MStatus | compute (const MPlug &plug, MDataBlock &data) |
The transform's compute method. More... | |
virtual MStatus | computeLocalTransformation (MPxTransformationMatrix *, MDataBlock &) |
This method computes the transformation matrix for a passed data block and places the output into a passed transformation matrix. More... | |
virtual MStatus | clearLimits () |
This method turns off all of the limits and sets them to their default values. More... | |
bool | isLimited (MFnTransform::LimitType, MStatus *ReturnStatus=NULL) const |
Determine if the specified limit attribute is enabled or disabled. More... | |
double | limitValue (MFnTransform::LimitType, MStatus *ReturnStatus=NULL) const |
Returns the current value of the specified limit in internal units as a double. More... | |
MStatus | setLimit (MFnTransform::LimitType, double value) |
Change the limit value for the specified limit type, and automatically enable the limit to be true. More... | |
MStatus | enableLimit (MFnTransform::LimitType, bool flag) |
Enable or disable the limit value for the specified limit type. More... | |
virtual MStatus | validateAndSetValue (const MPlug &, const MDataHandle &) |
When a plug's value is set, and the plug is on a default transform attribute, or has been flagged by the mustCallValidateAndSet() method, then this method will be called. More... | |
virtual MMatrix | getMatrix (MStatus *ReturnStatus=NULL) |
This method returns a 4x4 matrix that is produced by applying all of the components of the transform. More... | |
virtual MMatrix | getMatrixInverse (MStatus *ReturnStatus=NULL) |
This method returns the inverse of the 4x4 matrix that describes this transformation in the current evaluation context. More... | |
virtual MVector | getTranslation (MSpace::Space=MSpace::kTransform, MStatus *ReturnStatus=NULL) |
This method returns the translation component of the transform as a MVector in internal units (centimeters). More... | |
virtual MStatus | translateTo (const MVector &, MSpace::Space=MSpace::kTransform) |
Set the translation component of the transform in centimeters. More... | |
virtual MStatus | translateBy (const MVector &, MSpace::Space=MSpace::kTransform) |
Add to the translation component by translating relative to the existing transform. More... | |
virtual MQuaternion | getRotation (MSpace::Space=MSpace::kTransform, MStatus *ReturnStatus=NULL) |
This method returns the rotation of the transform as a quaternion. More... | |
virtual MEulerRotation | getEulerRotation (MSpace::Space=MSpace::kTransform, MStatus *ReturnStatus=NULL) |
Returns the rotation component of the transform as a euler rotation. More... | |
virtual MStatus | rotateTo (const MQuaternion &, MSpace::Space=MSpace::kTransform) |
Sets the rotation component of the transform using a quaternion. More... | |
virtual MStatus | rotateBy (const MQuaternion &, MSpace::Space=MSpace::kTransform) |
Adds to the rotation component of the transform by rotating relative to the existing transformation using a quaternion. More... | |
virtual MStatus | rotateTo (const MEulerRotation &, MSpace::Space=MSpace::kTransform) |
Sets the rotation component of the transform using an euler rotation. More... | |
virtual MStatus | rotateBy (const MEulerRotation &, MSpace::Space=MSpace::kTransform) |
Adds to the rotation component of the transform by rotating relative to the existing transform using a euler rotation. More... | |
virtual MVector | getScale (MSpace::Space=MSpace::kTransform, MStatus *ReturnStatus=NULL) |
Returns the scale component of the transform. More... | |
virtual MStatus | scaleTo (const MVector &, MSpace::Space=MSpace::kTransform) |
This method will set the scale of the transform to the passed value. More... | |
virtual MStatus | scaleBy (const MVector &, MSpace::Space=MSpace::kTransform) |
This method will apply a relative scale to an existing scale. More... | |
virtual MVector | getShear (MSpace::Space=MSpace::kTransform, MStatus *ReturnStatus=NULL) |
Get the shear value for this transform. More... | |
virtual MStatus | shearTo (const MVector &, MSpace::Space=MSpace::kTransform) |
The method sets the shear component of the transform. More... | |
virtual MStatus | shearBy (const MVector &, MSpace::Space=MSpace::kTransform) |
This method will apply a relative shear to the existing shear. More... | |
virtual MPoint | getScalePivot (MSpace::Space=MSpace::kTransform, MStatus *ReturnStatus=NULL) |
This method returns the position of the pivot used by the scale component of the transform. More... | |
virtual MPoint | getRotatePivot (MSpace::Space=MSpace::kTransform, MStatus *ReturnStatus=NULL) |
This method returns the position of the pivot used by the rotate component of the transform. More... | |
virtual MVector | getScalePivotTranslation (MSpace::Space=MSpace::kTransform, MStatus *ReturnStatus=NULL) |
This method returns the scale pivot translation in internal units (centimeters). More... | |
virtual MVector | getRotatePivotTranslation (MSpace::Space=MSpace::kTransform, MStatus *ReturnStatus=NULL) |
This method returns the rotate pivot translation in internal units (centimeters). More... | |
virtual MStatus | setScalePivot (const MPoint &, MSpace::Space=MSpace::kTransform, bool balance=true) |
This method sets the position of the scale pivot. More... | |
virtual MStatus | setScalePivotTranslation (const MVector &, MSpace::Space=MSpace::kTransform) |
This method sets the scale pivot translation in internal units (centimeters). More... | |
virtual MStatus | setRotatePivot (const MPoint &, MSpace::Space=MSpace::kTransform, bool balance=true) |
This method sets the position of the rotate pivot. More... | |
virtual MStatus | setRotatePivotTranslation (const MVector &, MSpace::Space=MSpace::kTransform) |
This method sets the rotate pivot translation in internal units (centimeters). More... | |
virtual MTransformationMatrix::RotationOrder | getRotationOrder () |
Returns the rotation order used by the rotation component of the transformation matrix. More... | |
virtual MStatus | setRotationOrder (MTransformationMatrix::RotationOrder ro, bool reorder=true) |
Sets the rotation order used by the rotation component of the transformation matrix. More... | |
virtual MQuaternion | getRotateOrientation (MSpace::Space apiSpace=MSpace::kTransform, MStatus *ReturnStatus=NULL) |
Returns the rotate orientation for the transformation matrix as a quaternion. More... | |
virtual MStatus | setRotateOrientation (const MQuaternion &q, MSpace::Space apiSpace=MSpace::kTransform, bool balance=true) |
This method sets the rotate orientation for this transform. More... | |
MStatus | updateMatrixAttrs () |
This method is used only for the MPxTransform and MPxTransform derived classes. More... | |
MStatus | updateMatrixAttrs (MObject &attr) |
This method ensures that a passed attribute will have its values current. More... | |
virtual void | copyInternalData (MPxNode *) |
This function copies the internal data of the transform node. More... | |
MPxTransform (MPxTransformationMatrix *) | |
This method is obsolete. More... | |
virtual MStatus | validateAndSetValue (const MPlug &, const MDataHandle &, const MDGContext &) |
This method is obsolete. More... | |
MStatus | updateMatrixAttrs (const MDGContext &) |
This method is obsolete. More... | |
MStatus | updateMatrixAttrs (MObject &attr, const MDGContext &) |
This method is obsolete. More... | |
virtual MMatrix | getMatrix (const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MMatrix | getMatrixInverse (const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MVector | getTranslation (MSpace::Space, const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MStatus | translateTo (const MVector &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MStatus | translateBy (const MVector &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MQuaternion | getRotation (MSpace::Space, const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MEulerRotation | getEulerRotation (MSpace::Space, const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MStatus | rotateTo (const MQuaternion &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MStatus | rotateBy (const MQuaternion &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MStatus | rotateTo (const MEulerRotation &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MStatus | rotateBy (const MEulerRotation &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MVector | getScale (MSpace::Space, const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MStatus | scaleTo (const MVector &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MStatus | scaleBy (const MVector &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MVector | getShear (MSpace::Space, const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MStatus | shearTo (const MVector &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MStatus | shearBy (const MVector &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MPoint | getScalePivot (MSpace::Space, const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MPoint | getRotatePivot (MSpace::Space, const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MVector | getScalePivotTranslation (MSpace::Space, const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MVector | getRotatePivotTranslation (MSpace::Space, const MDGContext &, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MStatus | setScalePivot (const MPoint &, MSpace::Space, bool balance, const MDGContext &) |
This method is obsolete. More... | |
virtual MStatus | setScalePivotTranslation (const MVector &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MStatus | setRotatePivot (const MPoint &, MSpace::Space, bool balance, const MDGContext &) |
This method is obsolete. More... | |
virtual MStatus | setRotatePivotTranslation (const MVector &, MSpace::Space, const MDGContext &) |
This method is obsolete. More... | |
virtual MTransformationMatrix::RotationOrder | getRotationOrder (const MDGContext &) |
This method is obsolete. More... | |
virtual MStatus | setRotationOrder (MTransformationMatrix::RotationOrder, bool reorder, const MDGContext &) |
This method is obsolete. More... | |
virtual MQuaternion | getRotateOrientation (MSpace::Space apiSpace, const MDGContext &apiContext, MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
virtual MStatus | setRotateOrientation (const MQuaternion &q, MSpace::Space, bool balance, const MDGContext &) |
This method is obsolete. More... | |
Public Member Functions inherited from MPxNode | |
MPxNode () | |
Constructor. More... | |
virtual | ~MPxNode () |
Destructor. | |
virtual bool | getInternalValue (const MPlug &, MDataHandle &) |
This method is overridden by nodes that store attribute data in some internal format. More... | |
virtual bool | setInternalValue (const MPlug &, const MDataHandle &) |
This method is overridden by nodes that store attribute data in some internal format. More... | |
virtual int | internalArrayCount (const MPlug &) const |
This method is overridden by nodes that have internal array attributes which are not stored in Maya's datablock. More... | |
virtual MStatus | legalConnection (const MPlug &, const MPlug &, bool asSrc, bool &isLegal) const |
This method allows you to check for legal connections being made to attributes of this node. More... | |
virtual MStatus | legalDisconnection (const MPlug &, const MPlug &, bool asSrc, bool &isLegal) const |
This method allows you to check for legal disconnections being made to attributes of this node. More... | |
virtual MStatus | setDependentsDirty (const MPlug &plug, MPlugArray &plugArray) |
This method can be overridden in user defined nodes to specify which plugs should be set dirty based upon an input plug {plugBeingDirtied} which Maya is marking dirty. More... | |
virtual MStatus | preEvaluation (const MDGContext &context, const MEvaluationNode &evaluationNode) |
Prepare a node's internal state for threaded evaluation. More... | |
virtual MStatus | postEvaluation (const MDGContext &context, const MEvaluationNode &evaluationNode, PostEvaluationType evalType) |
Clean up node's internal state after threaded evaluation. More... | |
virtual SchedulingType | schedulingType () const |
When overridden this method controls the degree of parallelism supported by the node during threaded evaluation. More... | |
virtual void | getCacheSetup (const MEvaluationNode &, MNodeCacheDisablingInfo &, MNodeCacheSetupInfo &, MObjectArray &) const |
Provide node-specific setup info for the Cached Playback system. More... | |
virtual void | configCache (const MEvaluationNode &, MCacheSchema &) const |
Defines the node's behavior when participating in Cached Playback. More... | |
virtual MTimeRange | transformInvalidationRange (const MPlug &source, const MTimeRange &input) const |
Override this method to register this node as an Invalidation-Range-Transformation kernel (IRT kernel) An IRT kernel node will change the invalidation time range for its downstream nodes For example, Dynamics-solver will transform invalidation time range [a,b] to [a,+inf) And Clip-Time-Editor will send out the invalidation range for each of the clip [a,b] to ( [t0+a,t0+b] U [t1+a,t1+b] U [t2+a,t2+b] U ... More... | |
bool | hasInvalidationRangeTransformation () const |
Checks if this MPxNode derived node overrides the MPxNode::transformInvalidationRange method. | |
virtual MStatus | connectionMade (const MPlug &, const MPlug &, bool asSrc) |
This method gets called when connections are made to attributes of this node. More... | |
virtual MStatus | connectionBroken (const MPlug &, const MPlug &, bool asSrc) |
This method gets called when connections are broken with attributes of this node. More... | |
virtual MStatus | dependsOn (const MPlug &, const MPlug &, bool &depends) const |
This method may be overridden by the user defined node. More... | |
virtual bool | isPassiveOutput (const MPlug &) const |
This method may be overridden by the user defined node if it wants to provide output attributes which do not prevent value modifications to the destination attribute. More... | |
virtual MStatus | shouldSave (const MPlug &, bool &isSaving) |
This method may be overridden by the user defined node. More... | |
virtual MPlug | passThroughToOne (const MPlug &) const |
This method may be overridden by nodes that have a one-to-one relationship between an input attribute and a corresponding output attribute. More... | |
virtual bool | passThroughToMany (const MPlug &, MPlugArray &) const |
This method is overridden by nodes that want to control the traversal behavior of some Maya search algorithms which traverse the history/future of shape nodes looking for directly related nodes. More... | |
virtual bool | isAbstractClass () const |
Override this class to return true if this node is an abstract node. More... | |
virtual bool | isTrackingTopology () const |
Override this class to return true if this node wants to track topology. More... | |
virtual MStringArray | getFilesToArchive (bool shortName=false, bool unresolvedName=false, bool markCouldBeImageSequence=false) const |
Use this method to return all external files used by this node. More... | |
virtual void | getExternalContent (MExternalContentInfoTable &table) const |
Returns the external content (files) that this node depends on. More... | |
bool | addExternalContentForFileAttr (MExternalContentInfoTable &, const MObject &attr) const |
Adds content info to the specified table from a file path attribute. More... | |
bool | setExternalContentForFileAttr (const MObject &attr, const MExternalContentLocationTable &) |
Sets content info in the specified attribute from the table. More... | |
virtual void | setExternalContent (const MExternalContentLocationTable &) |
Changes the location of external content in batch. More... | |
virtual MTypeId | typeId () const |
Returns the TYPEID of this node. More... | |
virtual MString | typeName () const |
Returns the type name of this node. More... | |
virtual MString | name () const |
Returns the name of this particular instance of this class. More... | |
virtual MObject | thisMObject () const |
Returns the MObject associated with this user defined node. More... | |
virtual MStatus | setExistWithoutInConnections (bool flag) |
This method specifies whether or not the node can exist without input connections. More... | |
virtual bool | existWithoutInConnections (MStatus *ReturnStatus=NULL) const |
Determines whether or not this node can exist without input connections. More... | |
virtual MStatus | setExistWithoutOutConnections (bool flag) |
This method specifies whether or not the node can exist without output connections. More... | |
virtual bool | existWithoutOutConnections (MStatus *ReturnStatus=NULL) const |
Determines whether or not this node can exist without output connections. More... | |
void | _setMPSafe (bool isMPSafe) |
This method is obsolete. More... | |
MDataBlock | _forceCache (const MDGContext &) |
This method is obsolete. More... | |
virtual bool | getInternalValueInContext (const MPlug &, MDataHandle &, MDGContext &) |
This method is obsolete. More... | |
virtual bool | setInternalValueInContext (const MPlug &, const MDataHandle &, MDGContext &) |
This method is obsolete. More... | |
virtual int | internalArrayCount (const MPlug &, const MDGContext &) const |
This method is obsolete. More... | |
Static Public Member Functions | |
static void | mustCallValidateAndSet (MObject &) |
This method must be called in the initialize() method for all attributes that affect the matrix of the transform. More... | |
static MStatus | setNonAffineMatricesEnabled (bool) |
Normal Maya transforms consist of translate, rotate, scale, and shear. More... | |
static bool | isNonAffineMatricesEnabled (MStatus *ReturnStatus) |
This method returns true is non-affine matrix calculations are being used for transforms. More... | |
static const char * | className () |
Returns the name of this class. More... | |
Static Public Member Functions inherited from MPxNode | |
static MStatus | addAttribute (const MObject &attr) |
This method adds a new attribute to a user defined node type during the type's initialization. More... | |
static MStatus | inheritAttributesFrom (const MString &parentClassName) |
This method allows a class of plugin node to inherit all of the attributes of a second class of plugin node. More... | |
static MStatus | attributeAffects (const MObject &whenChanges, const MObject &isAffected) |
This method specifies that a particular input attribute affects a specific output attribute. More... | |
static MStatus | attributeAffects (const MObject &whenChanges, const MObject &isAffected, bool affectsTopology) |
This method is an extension to the other version of the attributeAffects method. More... | |
static const char * | className () |
Returns the name of this class. More... | |
Public Attributes | |
MPxTransformationMatrix * | baseTransformationMatrix |
Cached MPxTransformationMatrix for normal-context (same as returned by transformationMatrix() method in normal-context). More... | |
Static Public Attributes | |
static MObject | nodeBoundingBox |
bounding box attribute | |
static MObject | nodeBoundingBoxMin |
bounding box minimum point | |
static MObject | nodeBoundingBoxMinX |
X component of nodeBoundingBoxMin. | |
static MObject | nodeBoundingBoxMinY |
Y component of nodeBoundingBoxMin. | |
static MObject | nodeBoundingBoxMinZ |
Z component of nodeBoundingBoxMin. | |
static MObject | nodeBoundingBoxMax |
bounding box maximum point | |
static MObject | nodeBoundingBoxMaxX |
X component of nodeBoundingBoxMax. | |
static MObject | nodeBoundingBoxMaxY |
Y component of nodeBoundingBoxMax. | |
static MObject | nodeBoundingBoxMaxZ |
Z component of nodeBoundingBoxMax. | |
static MObject | nodeBoundingBoxSize |
bounding box size vector | |
static MObject | nodeBoundingBoxSizeX |
X component of nodeBoundingBoxSize. | |
static MObject | nodeBoundingBoxSizeY |
Y component of nodeBoundingBoxSize. | |
static MObject | nodeBoundingBoxSizeZ |
Z component of nodeBoundingBoxSize. | |
static MObject | center |
object center attribute | |
static MObject | boundingBoxCenterX |
X component of the bounding box center. | |
static MObject | boundingBoxCenterY |
Y component of the bounding box center. | |
static MObject | boundingBoxCenterZ |
Z component of the bounding box center. | |
static MObject | matrix |
matrix attribute | |
static MObject | inverseMatrix |
inverse matrix attribute | |
static MObject | worldMatrix |
world matrix attribute | |
static MObject | worldInverseMatrix |
Inverse world matrix attribute. | |
static MObject | parentMatrix |
Parent matrix attribute. | |
static MObject | parentInverseMatrix |
Inverse parent matrix attribute. | |
static MObject | visibility |
Visibility attribute. | |
static MObject | intermediateObject |
Intermediate object attribute. | |
static MObject | isTemplated |
Template attribute. | |
static MObject | ghosting |
Ghosting attribute. | |
static MObject | instObjGroups |
Instances object group info attribute. | |
static MObject | objectGroups |
Object groups attributes. | |
static MObject | objectGrpCompList |
Component in object groups attribute. | |
static MObject | objectGroupId |
Group id attribute. | |
static MObject | objectGroupColor |
Group color attribute. | |
static MObject | useObjectColor |
Controls choice of wireframe dormant object color. | |
static MObject | objectColor |
The per object dormant wireframe color. | |
static MObject | drawOverride |
Draw override attribute. | |
static MObject | overrideDisplayType |
Draw override display type attribute. | |
static MObject | overrideLevelOfDetail |
Draw override LOD attribute. | |
static MObject | overrideShading |
Draw override shading attribute. | |
static MObject | overrideTexturing |
Draw override texturing attribute. | |
static MObject | overridePlayback |
Draw override playback attribute. | |
static MObject | overrideEnabled |
Draw override enabled attribute. | |
static MObject | overrideVisibility |
Draw override visibility attribute. | |
static MObject | overrideColor |
Draw override color attribute. | |
static MObject | lodVisibility |
LOD visibility attribute. | |
static MObject | renderInfo |
This method is obsolete. More... | |
static MObject | identification |
This method is obsolete. More... | |
static MObject | layerRenderable |
This method is obsolete. More... | |
static MObject | layerOverrideColor |
This method is obsolete. More... | |
static MObject | renderLayerInfo |
Render layer Info attribute. | |
static MObject | renderLayerId |
Render layer ID attribute. | |
static MObject | renderLayerRenderable |
Render layer Renderable attribute. | |
static MObject | renderLayerColor |
Render layer Color attribute. | |
static MObject | translate |
translate attribute | |
static MObject | translateX |
translateX attribute | |
static MObject | translateY |
translateY attribute | |
static MObject | translateZ |
translateZ attribute | |
static MObject | rotate |
rotate attribute | |
static MObject | rotateX |
rotateX attribute | |
static MObject | rotateY |
rotateY attribute | |
static MObject | rotateZ |
rotateZ attribute | |
static MObject | rotateOrder |
Rotate order attribute. | |
static MObject | scale |
scale attribute | |
static MObject | scaleX |
scaleX attribute | |
static MObject | scaleY |
scaleY attribute | |
static MObject | scaleZ |
scaleZ attribute | |
static MObject | shear |
shear attribute | |
static MObject | shearXY |
shearXY attribute | |
static MObject | shearXZ |
shearXZ attribute | |
static MObject | shearYZ |
shearYZ attribute | |
static MObject | rotatePivot |
rotate pivot attribute | |
static MObject | rotatePivotX |
rotate pivot X attribute | |
static MObject | rotatePivotY |
rotate pivot Y attribute | |
static MObject | rotatePivotZ |
rotate pivot Z attribute | |
static MObject | rotatePivotTranslate |
rotate pivot translate attribute | |
static MObject | rotatePivotTranslateX |
rotate pivot translate X attribute | |
static MObject | rotatePivotTranslateY |
rotate pivot translate Y attribute | |
static MObject | rotatePivotTranslateZ |
rotate pivot translate Z attribute | |
static MObject | scalePivot |
scale pivot attribute | |
static MObject | scalePivotX |
scale pivot X attribute | |
static MObject | scalePivotY |
scale pivot Y attribute | |
static MObject | scalePivotZ |
scale pivot Z attribute | |
static MObject | scalePivotTranslate |
Scale pivot translate attribute. | |
static MObject | scalePivotTranslateX |
scale pivot translate X attribute | |
static MObject | scalePivotTranslateY |
scale pivot translate Y attribute | |
static MObject | scalePivotTranslateZ |
scale pivot translate Z attribute | |
static MObject | rotateAxis |
Rotate orientation attribute. | |
static MObject | rotateAxisX |
rotate orientation X attribute | |
static MObject | rotateAxisY |
rotate orientation Y attribute | |
static MObject | rotateAxisZ |
rotate orientation Z attribute | |
static MObject | transMinusRotatePivot |
translate minus rotate pivot attribute | |
static MObject | transMinusRotatePivotX |
translateX minus rotate pivotX attribute | |
static MObject | transMinusRotatePivotY |
translateY minus rotate pivotY attribute | |
static MObject | transMinusRotatePivotZ |
translateZ minus rotate pivotZ attribute | |
static MObject | minTransLimit |
Minumum translation limits attribute. | |
static MObject | minTransXLimit |
minimum translate X limit attribute | |
static MObject | minTransYLimit |
minimum translate Y limit attribute | |
static MObject | minTransZLimit |
minimum translate Z limit attribute | |
static MObject | maxTransLimit |
Maximum translation limits attribute. | |
static MObject | maxTransXLimit |
maximum translate X limit attribute | |
static MObject | maxTransYLimit |
maximum translate Y limit attribute | |
static MObject | maxTransZLimit |
maximum translate Z limit attribute | |
static MObject | minTransLimitEnable |
Enable the mimimum translation limits attribute. | |
static MObject | minTransXLimitEnable |
enable the minimum translate X limit attribute | |
static MObject | minTransYLimitEnable |
enable the minimum translate Y limit attribute | |
static MObject | minTransZLimitEnable |
enable the minimum translate Z limit attribute | |
static MObject | maxTransLimitEnable |
Enable the maximum translation limits attribute. | |
static MObject | maxTransXLimitEnable |
enable the maximum translate X limit attribute | |
static MObject | maxTransYLimitEnable |
enable the maximum translate Y limit attribute | |
static MObject | maxTransZLimitEnable |
enable the maximum translate Z limit attribute | |
static MObject | minRotLimit |
Minimum rotation limits attribute. | |
static MObject | minRotXLimit |
minimum rotate X limit attribute | |
static MObject | minRotYLimit |
minimum rotate Y limit attribute | |
static MObject | minRotZLimit |
minimum rotate Z limit attribute | |
static MObject | maxRotLimit |
Maximum rotation limits attribute. | |
static MObject | maxRotXLimit |
maximum rotate X limit attribute | |
static MObject | maxRotYLimit |
maximum rotate Y limit attribute | |
static MObject | maxRotZLimit |
maximum rotate Z limit attribute | |
static MObject | minRotLimitEnable |
Enable minimum rotation limits attribute. | |
static MObject | minRotXLimitEnable |
enable minimum rotate X limit attribute | |
static MObject | minRotYLimitEnable |
enable minimum rotate Y limit attribute | |
static MObject | minRotZLimitEnable |
enable minimum rotate Z limit attribute | |
static MObject | maxRotLimitEnable |
Enable maximum rotation limits attribute. | |
static MObject | maxRotXLimitEnable |
enable maximum rotate X limit attribute | |
static MObject | maxRotYLimitEnable |
enable maximum rotate Y limit attribute | |
static MObject | maxRotZLimitEnable |
enable maximum rotate Z limit attribute | |
static MObject | minScaleLimit |
Minimum scale limit attribute. | |
static MObject | minScaleXLimit |
minimum scale X limit attribute | |
static MObject | minScaleYLimit |
minimum scale Y limit attribute | |
static MObject | minScaleZLimit |
minimum scale Z limit attribute | |
static MObject | maxScaleLimit |
Maximum scale limit attribute. | |
static MObject | maxScaleXLimit |
maximum scale X limit attribute | |
static MObject | maxScaleYLimit |
maximum scale Y limit attribute | |
static MObject | maxScaleZLimit |
maximum scale Z limit attribute | |
static MObject | minScaleLimitEnable |
Enable minimum scale limit attribute. | |
static MObject | minScaleXLimitEnable |
enable minimum scale X limit attribute | |
static MObject | minScaleYLimitEnable |
enable minimum scale Y limit attribute | |
static MObject | minScaleZLimitEnable |
enable minimum scale Z limit attribute | |
static MObject | maxScaleLimitEnable |
Enable maximum scale limit attribute. | |
static MObject | maxScaleXLimitEnable |
enable maximum scale X limit attribute | |
static MObject | maxScaleYLimitEnable |
enable maximum scale Y limit attribute | |
static MObject | maxScaleZLimitEnable |
enable maximum scale Z limit attribute | |
static MObject | geometry |
Geometry attribute. | |
static MObject | xformMatrix |
Xform matrix attribute. | |
static MObject | selectHandle |
Selection handle attribute. | |
static MObject | selectHandleX |
Selection handle X attribute. | |
static MObject | selectHandleY |
Selection handle Y attribute. | |
static MObject | selectHandleZ |
Selection handle Z attribute. | |
static MObject | inheritsTransform |
Inherits transform attribute. | |
static MObject | displayHandle |
Display handle attribute. | |
static MObject | displayScalePivot |
Display scale pivot attribute. | |
static MObject | displayRotatePivot |
Display rotate pivot attribute. | |
static MObject | displayLocalAxis |
Display local axis attribute. | |
static MObject | dynamics |
Dynamics attribute. | |
static MObject | showManipDefault |
Show manipulator default attribute. | |
static MObject | specifiedManipLocation |
Specified manipulator location attribute. | |
static MObject | rotateQuaternion |
Rotate quaternion attribute. | |
static MObject | rotateQuaternionX |
Rotate quaternion X attribute. | |
static MObject | rotateQuaternionY |
Rotate quaternion Y attribute. | |
static MObject | rotateQuaternionZ |
Rotate quaternion Z attribute. | |
static MObject | rotateQuaternionW |
Rotate quaternion W attribute. | |
static MObject | rotationInterpolation |
Rotation interporlation attribute. | |
Static Public Attributes inherited from MPxNode | |
static MObject | message |
message attribute | |
static MObject | isHistoricallyInteresting |
is historically interesting attribute | |
static MObject | caching |
caching attribute | |
static MObject | state |
state attribute | |
static MObject | frozen |
frozen attribute | |
Protected Member Functions | |
virtual MVector | applyTranslationLimits (const MVector &unclampedT, MDataBlock &, MStatus *ReturnStatus=NULL) |
This method returns a copy of the passed translation value with its members limited by any enabled translation limits on this node. More... | |
virtual MVector | applyTranslationLocks (const MVector &toTest, const MVector &savedT, MStatus *ReturnStatus=NULL) |
This method allows the custom transform to apply its own locking mechanism to translation. More... | |
virtual MEulerRotation | applyRotationLimits (const MEulerRotation &unclampedR, MDataBlock &, MStatus *ReturnStatus=NULL) |
This method returns a copy of the passed rotation value with its members limited by any enabled rotation limits on this node. More... | |
virtual MEulerRotation | applyRotationLocks (const MEulerRotation &toTest, const MEulerRotation &savedR, MStatus *ReturnStatus=NULL) |
This method allows the custom transform to apply its own locking mechanism to rotation. More... | |
virtual MVector | applyScaleLimits (const MVector &unclampedS, MDataBlock &, MStatus *ReturnStatus=NULL) |
This method returns a copy of the passed scale value with its members limited by any enabled scale limits on this node. More... | |
virtual MVector | applyScaleLocks (const MVector &toTest, const MVector &savedS, MStatus *ReturnStatus=NULL) |
This method allows the custom transform to apply its own locking mechanism to scale. More... | |
virtual MVector | applyShearLocks (const MVector &toTest, const MVector &savedSh, MStatus *ReturnStatus=NULL) |
This method allows the custom transform to apply its own locking mechanism to shear. More... | |
virtual MEulerRotation | applyRotateOrientationLocks (const MEulerRotation &toTest, const MEulerRotation &savedRO, MStatus *ReturnStatus=NULL) |
This method allows the custom transform to apply its own locking mechanism to rotation orientation. More... | |
virtual MVector | applyScaleLocksPivot (const MPoint &toTest, const MPoint &savedSP, MStatus *ReturnStatus=NULL) |
This method allows the custom transform to apply its own locking mechanism to scale pivot. More... | |
virtual MVector | applyRotatePivotLocks (const MPoint &toTest, const MPoint &savedRP, MStatus *ReturnStatus=NULL) |
This method allows the custom transform to apply its own locking mechanism to rotation pivots. More... | |
virtual MVector | applyScaleLocksPivotTranslate (const MVector &toTest, const MVector &savedSPT, MStatus *ReturnStatus=NULL) |
This method allows the custom transform to apply its own locking mechanism to the scalePivotTranslate attribute. More... | |
virtual MVector | applyRotatePivotLocksTranslate (const MVector &toTest, const MVector &savedRPT, MStatus *ReturnStatus=NULL) |
This method allows the custom transform to apply its own locking mechanism to the rotatePivotTranslate attribute. More... | |
MStatus | dirtyMatrix () |
USE _dirtyMatrix() IN SCRIPT. More... | |
MStatus | dirtyTranslation (const MVector &) |
USE _dirtyTranslation() IN SCRIPT. More... | |
MStatus | dirtyRotation (const MEulerRotation &) |
USE _dirtyRotation() IN SCRIPT. More... | |
MStatus | dirtyScale (const MVector &) |
USE _dirtyScale() IN SCRIPT. More... | |
MStatus | dirtyShear (const MVector &) |
USE _dirtyShear() IN SCRIPT. More... | |
MStatus | dirtyRotateOrientation (const MEulerRotation &) |
USE _dirtyRotateOrientation() IN SCRIPT. More... | |
MStatus | dirtyScalePivot (const MPoint &) |
USE _dirtyScalePivot() IN SCRIPT. More... | |
MStatus | dirtyRotatePivot (const MPoint &) |
USE _dirtyRotatePivot() IN SCRIPT. More... | |
MStatus | dirtyScalePivotTranslation (const MVector &) |
USE _dirtyScalePivotTranslation() IN SCRIPT. More... | |
MStatus | dirtyRotatePivotTranslation (const MVector &) |
USE _dirtyRotatePivotTranslation() IN SCRIPT. More... | |
virtual MStatus | checkAndSetTranslation (MDataBlock &, const MPlug &, const MVector &, MSpace::Space=MSpace::kTransform) |
This method is used to modify and set the new translate values being passed in from the compute method or from the validateAndSetValue. More... | |
virtual MStatus | checkAndSetRotation (MDataBlock &, const MPlug &, const MEulerRotation &, MSpace::Space=MSpace::kTransform) |
This method verifies that the passed value can be set on the rotate plugs. More... | |
virtual MStatus | checkAndSetScale (MDataBlock &, const MPlug &, const MVector &, MSpace::Space=MSpace::kTransform) |
This method verifies that the passed value can be set on the scale plugs. More... | |
virtual MStatus | checkAndSetShear (MDataBlock &, const MPlug &, const MVector &, MSpace::Space=MSpace::kTransform) |
This method verifies that the passed value can be set on the shear plugs. More... | |
virtual MStatus | checkAndSetRotateOrientation (MDataBlock &, const MPlug &, const MEulerRotation &, MSpace::Space=MSpace::kTransform, bool balance=true) |
This method verifies that the passed value can be set on the rotateAxis plugs. More... | |
virtual MStatus | checkAndSetRotatePivot (MDataBlock &, const MPlug &, const MPoint &, MSpace::Space=MSpace::kTransform, bool balance=true) |
This method verifies that the passed value can be set on the rotatePivot plugs. More... | |
virtual MStatus | checkAndSetRotatePivotTranslation (MDataBlock &, const MPlug &, const MVector &, MSpace::Space=MSpace::kTransform) |
This method verifies that the passed value can be set on the rotatePivotTranslate plugs. More... | |
virtual MStatus | checkAndSetScalePivot (MDataBlock &, const MPlug &, const MPoint &, MSpace::Space=MSpace::kTransform, bool=true) |
This method verifies that the passed value can be set on the scalePivot plugs. More... | |
virtual MStatus | checkAndSetScalePivotTranslation (MDataBlock &, const MPlug &, const MVector &, MSpace::Space=MSpace::kTransform) |
This method verifies that the passed value can be set on the scalePivotTranslate plugs. More... | |
Protected Member Functions inherited from MPxNode | |
virtual MDataBlock | forceCache () |
USE _forceCache() IN SCRIPT. More... | |
virtual MStatus | setDoNotWrite (bool flag) |
USE _setDoNotWrite() IN SCRIPT. More... | |
virtual bool | doNotWrite (MStatus *ReturnStatus=NULL) const |
USE _doNotWrite() IN SCRIPT. More... | |
virtual void | setMPSafe (bool isMPSafe) |
This method is obsolete. More... | |
virtual MDataBlock | forceCache (const MDGContext &) |
This method is obsolete. More... | |
Additional Inherited Members | |
Public Types inherited from MPxNode | |
enum | Type { kDependNode, kLocatorNode, kDeformerNode, kManipContainer, kSurfaceShape, kFieldNode, kEmitterNode, kSpringNode, kIkSolverNode, kHardwareShader, kHwShaderNode, kTransformNode, kObjectSet, kFluidEmitterNode, kImagePlaneNode, kParticleAttributeMapperNode, kCameraSetNode, kConstraintNode, kManipulatorNode, kMotionPathNode, kClientDeviceNode, kThreadedDeviceNode, kAssembly, kSkinCluster, kGeometryFilter, kBlendShape, kLast } |
Defines the type of node. More... | |
enum | SchedulingType { kParallel, kSerial, kGloballySerial, kUntrusted , kDefaultScheduling = kSerial, kSerialize = kSerial, kGloballySerialize = kGloballySerial } |
Defines the degree of parallelism of a node. More... | |
Base class for user defined transforms.
MPxTransform allows the creation of user defined transform nodes. User defined transform nodes can introduce new transform types or change the transformation order. They are designed to be an extension of the standard Maya transform node and include all of the normal transform attributes. Standard behaviors such as limit enforcement and attribute locking are managed by this class, but may be overriden in derived classes.
In general, a complete implementation of user defined transforms will require the deriving from two classes; MPxTransform defines the node while MPxTransformationMatrix describes the mathematical functions of the user defined transform.
The MPxTransform class is registered using the MFnPlugin::registerTransform() method. Both the MPxTransform and the MPxTransformationMatrix classes are registered in the same method. This allows for a clear association between a MPxTransform and a MPxTransformationMatrix. Both the MPxTransform and the MPxTransformationMatrix classes need unique MTypeIds.
MPxTransform nodes are DAG nodes and therefore a change to one element will affect every node beneath the changed node. Since this can involve quite a bit of calculation, DAG nodes internally handle clean and dirty differently than other nodes. What this means is that the updateMatrixAttrs() method should be used when getting one of the matrix attributes from a method on this node. Additionally, after a value is changed, the appropriate dirty method (i.e. dirtyTranslate(), dirtyRotate(), etc.) should be called. When in doubt, dirtyMatrix() will flag everything as needing to be updated.
It is up to each transform node to determine if it will obey limits or not. Since transform attributes may have limits or may be involved in some sort of constraint, there needs to be a way to accept, reject, or modify a value when a plug is set on the node. The mustCallValidateAndSet() method allows for this kind of control. When an attribute is flagged with the mustCallValidateAndSet() method in the initialize() method, every plug change will call the validateAndSetValue() method for approval. From the validateAndSetValue() method things like limits and value locking can be enforced. It is important to note that for new attributes on the transform node, any locking or limits are left as an implementation detail.
If any of the public methods are affected by the addition of transform components, or by the order of computation, they should be overriden in the derived class. Many of the public methods are used by internal Maya code and exist for more than just convenience.
The createTransformationMatrix() class must be overloaded if a transformation matrix other than the default MPxTransformationMatrix is used.
NOTES: 1) The setDependentsDirty() virtual method is available in this class since MPxTransform derives from MPxNode. During a call to MPxTransform::setDependentsDirty(), a plug-in should not invoke any of the dirty*() or updateMatrixAttrs() calls of this class. For example, the methods dirtyMatrix(), dirtyTranslation() or updateMatrixAttrs() should not be called. 2) Updating world space attributes is an expensive operation. Maya updates world space attributes on demand such as in the case of a getAttr being issued or a connection exists for the attribute.
MPxTransform | ( | MPxTransformationMatrix * | tm | ) |
This method is obsolete.
Class constructor.
[From Maya 2019]
The passed pointer to a MPxTransformationMatrix derived object will be used for the transformation matrix calculation. This class will assume responsibility to delete this memory.
[in] | tm | A pointer to a MPxTransformationMatrix derived object. |
|
virtual |
Post constructor.
Internally maya creates two objects when a user defined node is created, the internal MObject and the user derived object. The association between the these two objects is not made until after the MPxNode constructor is called. This implies that no MPxNode member function can be called from the MPxNode constructor. The postConstructor will get called immediately after the constructor when it is safe to call any MPxNode member function.
Reimplemented from MPxNode.
|
virtual |
This method returns the type of the node.
This method should not be overridden by the user. It will return MPxNode::kTransformNode.
Reimplemented from MPxNode.
|
virtual |
This method returns a new transformation matrix.
The function that calls this method is responsible for deleting the transformation matrix.
If a derived MPxTransformationMatrix is used as the transformation matrix for the node, then this method must be overridden.
|
virtual |
This method should be overridden to return true if the user supplies a bounding box routine.
Supplying a bounding box routine makes refresh and selection more efficient.
|
virtual |
This method should be overridden to return a bounding box for the transform.
If this method is overridden, then MPxTransform::isBounded should also be overridden to return true.
|
virtual |
Maya's base transform node type is treated differently from node types which are derived from it.
For example, the 'viewFit' command does not include transform nodes in its calculations but does include pointConstraint nodes which are derived from the transform node.
By default, all custom transform node types are treated the same as Maya's base transform node type. Using the same example, by default a custom transform node will be excluded from the 'viewFit' command's calculations.
This method allows that default behaviour to be changed. By overriding this method to return false, a custom node can turn off the special treatment accorded to transform nodes and instead have itself treated the same as Maya treats derived transform nodes.
const MPxTransformationMatrix & transformationMatrix | ( | ) | const |
This method returns a reference to the cached transformation matrix for current context.
MPxTransformationMatrix * transformationMatrixPtr | ( | ) | const |
This function returns a pointer to the cached transformation matrix for current context.
|
virtual |
This method will reset the transformation matrix to one that is constructed with the passed MMatrix.
How the new transformation matrix is created will depend on the transformation matrix class and its decomposeMatrix() method.
[in] | matrix | The matrix used for resetting this transform. |
|
virtual |
This method will reset the transformation matrix to the one specified by the passed transformation matrix pointer.
The contents of the passed transformation matrix are copied into this class's transformation matrix.
[in] | xform | A pointer to the source transformation matrix. |
|
virtual |
The transform's compute method.
The compute method should call any supporting methods to proper handle limits as well as the cases where the plug's value should not change. The MPlug::isFreeToChange() method is used to determine if a plug's value may be changed.
When the compute method on derived classes is invoked for an attribute not handled by the derived class, the derived class should call MPxTransform::compute to allow the base classes to handle the attribute.
[in] | plug | The plug to compute. |
[in] | block | The data block. |
Reimplemented from MPxNode.
|
virtual |
This method computes the transformation matrix for a passed data block and places the output into a passed transformation matrix.
The caller needs to allocate space for the passed transformation matrix.
[in] | xform | The transformation matrix to fill with computed values. |
[in] | block | The data block used for the transformation matrix computation. |
|
virtual |
This method turns off all of the limits and sets them to their default values.
Before this method is called, the base class clears all of the limits on the standard transform attributes, so this method only needs to be implemented for custom transform attributes.
bool isLimited | ( | MFnTransform::LimitType | type, |
MStatus * | ReturnStatus = NULL |
||
) | const |
Determine if the specified limit attribute is enabled or disabled.
[in] | type | An enum specifying the type of limit to query. |
[out] | ReturnStatus | Status. |
double limitValue | ( | MFnTransform::LimitType | type, |
MStatus * | ReturnStatus = NULL |
||
) | const |
Returns the current value of the specified limit in internal units as a double.
[in] | type | An enum indicating the type of limit to query. |
[out] | ReturnStatus | Status. |
MStatus setLimit | ( | MFnTransform::LimitType | type, |
double | value | ||
) |
Change the limit value for the specified limit type, and automatically enable the limit to be true.
[in] | type | An enum indicating the limit to set. |
[in] | value | The new limit value in internal units (centimeters or radians). |
MStatus enableLimit | ( | MFnTransform::LimitType | type, |
bool | flag | ||
) |
Enable or disable the limit value for the specified limit type.
[in] | type | An enum indicating the limit to enable or disable. |
[in] | flag | The enable value; true will enable while false will disable the limit. |
|
virtual |
When a plug's value is set, and the plug is on a default transform attribute, or has been flagged by the mustCallValidateAndSet() method, then this method will be called.
The purpose of validateAndSetValue() is to enforce limits, constraints, or plug value locking.
If the plug passed into this method is not an attribute related to the derived class, the derived class should call the validateAndSetValue method of its parent class in order to allow the base classes to handle their attributes.
If any adjustments or corrections are required, they are placed in the data block and if the context is normal, into the cached transformation matrix. Values on the data block are in transform space.
Formerly the context was passed in; now the context will already be set as the current one for evaluation so it isn't necessary. To retrieve the current evaluation context, call MDGContext::current.
If you have specialty code that calls this method directly you'll have to ensure the current context is set using MDGContextGuard or MDGContext::makeCurrent.
[in] | plug | The plug that is to be set. |
[in] | handle | The inputValue handle of the data. |
This method returns a 4x4 matrix that is produced by applying all of the components of the transform.
[out] | ReturnStatus | Return status. |
This method returns the inverse of the 4x4 matrix that describes this transformation in the current evaluation context.
[out] | ReturnStatus | Return status. |
|
virtual |
This method returns the translation component of the transform as a MVector in internal units (centimeters).
[in] | space | The space used for setting the translation. |
[out] | ReturnStatus | Return status. |
|
virtual |
Set the translation component of the transform in centimeters.
[in] | newTrans | The new translation component in centimeters. |
[in] | space | The space in which to perform the translation. |
|
virtual |
Add to the translation component by translating relative to the existing transform.
The transform value should be in internal units (centimeters).
[in] | transOffset | The relative translation value in centimeters. |
[in] | space | The space in which to perform the translation. |
|
virtual |
This method returns the rotation of the transform as a quaternion.
The rotation is returned in MSpace::kTransform space. If an invalid space is used, MQuaternion::identity will be returned.
[in] | space | The space used for getting the rotate value. |
[out] | ReturnStatus | Return status. |
|
virtual |
Returns the rotation component of the transform as a euler rotation.
The rotation is returned in MSpace::kTransform space. If an invalid space is used, MEulerRotation::identity will be returned.
[in] | space | The space used for getting the rotation. |
[out] | ReturnStatus | Return status. |
|
virtual |
Sets the rotation component of the transform using a quaternion.
The rotation is performed in MSpace::kTransform space. The transform's existing order of rotation is preserved.
[in] | newRot | The new rotation value as a quaternion. |
[in] | space | The space of the passed rotation value. |
|
virtual |
Adds to the rotation component of the transform by rotating relative to the existing transformation using a quaternion.
The only valid transformation spaces for this method are MSpace::kTransform and MSpace::kPreTransform. All other spaces are treated as being equivalent to MSpace::kTransform. The transform's existing order of rotation is preserved.
[in] | rotateOffset | The relative rotation to apply to the transform. |
[in] | space | The space of the passed rotation. |
|
virtual |
Sets the rotation component of the transform using an euler rotation.
If the new rotation's order of rotation is different from that of the transform it will be reordered to match the transform.
[in] | euler | The new rotation value as an euler rotation. |
[in] | space | The space of the passed rotation value. |
|
virtual |
Adds to the rotation component of the transform by rotating relative to the existing transform using a euler rotation.
The only valid transformation spaces for this method are MSpace::kTransform and MSpace::kPreTransform/MSpace::kObject. All other spaces are treated as being equivalent to MSpace::kTransform. If the supplied rotation's order of rotation is different from that of the transform, it will be reordered to match the transform before being added in.
[in] | euler | The rotation value of the relative euler rotation. |
[in] | space | The space used for the relative rotation. |
|
virtual |
Returns the scale component of the transform.
If the space is invalid a <1.0, 1.0, 1.0> vector is returned.
[in] | space | The space used to get the scale. |
[out] | ReturnStatus | The return status. |
|
virtual |
This method will set the scale of the transform to the passed value.
[in] | newScale | A MVector holding the scale components. |
[in] | space | The space of the passed scale value. |
|
virtual |
This method will apply a relative scale to an existing scale.
[in] | scaleOffset | A MVector holding the scale components. |
[in] | space | The space of the passed scale values. |
|
virtual |
Get the shear value for this transform.
[in] | space | The space used for retrieving the shear value. |
[out] | ReturnStatus | Return status. |
|
virtual |
The method sets the shear component of the transform.
[in] | newShear | A MVector holding the new shear value. |
[in] | space | The space of the passed shear value. |
|
virtual |
This method will apply a relative shear to the existing shear.
[in] | shearOffset | The relative shear value as a MVector. |
[in] | space | The space of the passed shear value. |
|
virtual |
This method returns the position of the pivot used by the scale component of the transform.
The position is represented in internal units (centimeters).
[in] | space | The space used to get the scale pivot. |
[out] | ReturnStatus | Return status. |
|
virtual |
This method returns the position of the pivot used by the rotate component of the transform.
The position is represented in internal units (centimeters).
[in] | space | The space used to get the rotate pivot. |
[out] | ReturnStatus | Status code. |
|
virtual |
This method returns the scale pivot translation in internal units (centimeters).
The scale pivot translation is an offset applied to the transform to allow adjustments to the scale pivot to be made without changing the overall transform.
[in] | space | The spaced used to get the scale pivot translation. |
[out] | ReturnStatus | Return status. |
|
virtual |
This method returns the rotate pivot translation in internal units (centimeters).
The rotate pivot translation is an offset applied to the transform to allow adjustments to the rotate pivot to be made without changing the overall transform.
[in] | space | The spaced used to get the rotate pivot translation. |
[out] | ReturnStatus | Return status. |
|
virtual |
This method sets the position of the scale pivot.
The position of the pivot is defined as a MPoint in internal units (centimeters).
If the balance argument is true, then the scale pivot translation will be adjusted such that the overall transform remains unchanged after the new scale pivot is set.
If an invalid space is used, the scale pivot will not change.
[in] | newSP | The position of the new scale pivot. |
[in] | space | The space used to set the scale pivot. |
[in] | balance | Should transform be rebalanced afterward? |
|
virtual |
This method sets the scale pivot translation in internal units (centimeters).
The scale pivot translation is normally used to automatically compensate for changes in the scale pivot when the setScalePivot() method is used.
[in] | newPT | The scale pivot translation as a MVector. |
[in] | space | The space used to set the scale pivot translation. |
|
virtual |
This method sets the position of the rotate pivot.
The position of the pivot is defined as a MPoint in internal units (centimeters).
If the balance argument is true, then the rotate pivot translation will be adjusted such that the overall transform remains unchanged after the new rotate pivot is set.
If an invalid space is used, the rotate pivot will not change.
[in] | newRP | The position of the new rotate pivot. |
[in] | space | The space used to set the rotate pivot. |
[in] | balance | Should transform be rebalanced afterward? |
|
virtual |
This method sets the rotate pivot translation in internal units (centimeters).
The rotate pivot translation is normally used to automatically compensate for changes in the rotate pivot when the setRotatePivot() method is used.
[in] | newPT | The rotate pivot translation as a MVector. |
[in] | space | The space used to set the rotate pivot translation. |
|
virtual |
Returns the rotation order used by the rotation component of the transformation matrix.
Note that there are two different enumerations used to represent order of rotation: MTransformationMatrix::RotationOrder and MEulerRotation::RotationOrder. The actual value stored in the transform's rotateOrder attribute is an MEulerRotation::RotationOrder. The value returned by this method is the corresponding MTransformationMatrix::RotationOrder value. If you need to convert between these two rotation order representations use the MPxTransformationMatrix::convertTransformationRotationOrder and MPxTransformationMatrix::convertEulerRotationOrder methods.
|
virtual |
Sets the rotation order used by the rotation component of the transformation matrix.
See the getRotationOrder method for a discussion of the difference between MTransformationMatrix::RotationOrder values and MEulerRotation::RotationOrder values.
[in] | ro | The new rotation order as a MTransformationMatrix::RotationOrder enum. |
[in] | reorder | If true, rotations will be adjusted so that the net transformation under the new order will be the same as it was under the old order. |
|
virtual |
Returns the rotate orientation for the transformation matrix as a quaternion.
The rotate orientation is the value associated with the rotateAxis attribute on this node. The rotate orientation value is used to orient the local rotation space of the transform.
[in] | space | The space used for getting the rotate orientation. |
[out] | ReturnStatus | Return status. |
|
virtual |
This method sets the rotate orientation for this transform.
The rotate orientation is used to define the local rotation space. The rotate orientation is the value associated with the rotateAxis attribute on this node.
The balance argument allows the rotate orientation to be changed without affecting the overall transformation. The rotate value is adjusted to compensate for the change in rotate orientation.
[in] | newRO | The quaternion used to set the rotate orientation. |
[in] | space | The space used when setting the rotate orientation. |
[in] | balance | If true is used, then the rotation will change to compensate for the change in the rotate orientation. |
_OPENMAYA_DEPRECATION_POP_WARNING MStatus updateMatrixAttrs | ( | ) |
This method is used only for the MPxTransform and MPxTransform derived classes.
It will ensure that the values which change the resulting 4x4 matrix are current. It should be called before getting values that affect the matrix calculation.
If only a specific value needs to be updated, then use the updateMatrixAttrs(MObject &attr, const MDGContext &context) method.
This method ensures that a passed attribute will have its values current.
[in] | attr | The attribute. |
|
static |
This method must be called in the initialize() method for all attributes that affect the matrix of the transform.
It will ensure that the matrix is properly calculated when the passed attribute is changed and that the validateAndSetValue method will get called for this attribute.
It is only for MPxTransform derived classes.
If a custom attribute on an MPxTransform derived classes is declared as "mustValidateAndSetValue", then the validateAndSetValue method must be implemented, so that it takes the data out of the data handle, and sets it into the datablock of the node.
[in] | obj | the attribute |
|
static |
Normal Maya transforms consist of translate, rotate, scale, and shear.
All of these transform types produce an affine matrix. With MPxTransform it is possible to introduce non-affine matrices into places that previously did not consider their effects.
If non-affine matrices are enabled, then all calculations which require additional operations when handling non-affine matrices will perform the addition mathematical operations.
This is a static method and will affect all transforms when enabled.
[in] | enabled | If true, then non-afine calculations will be used. |
|
static |
This method returns true is non-affine matrix calculations are being used for transforms.
[out] | ReturnStatus | The status |
|
virtual |
This function copies the internal data of the transform node.
[in] | node | the node that is being duplicated |
Reimplemented from MPxNode.
|
protectedvirtual |
This method returns a copy of the passed translation value with its members limited by any enabled translation limits on this node.
[in] | unlimitedT | The value before limits are applied. |
[in] | block | The datablock to use. |
[out] | ReturnStatus | Return status. |
|
protectedvirtual |
This method allows the custom transform to apply its own locking mechanism to translation.
Standard dependency graph attribute locking happens automatically and cannot be modified by custom nodes.
If the plug should not be changed, then the value from the passed savedT argument should be return to be used in the transformation matrix.
[in] | toTest | The values to use if the plug is not locked. |
[in] | savedT | The values to revert to if the plug cannot be changed. |
[out] | ReturnStatus | status |
|
protectedvirtual |
This method returns a copy of the passed rotation value with its members limited by any enabled rotation limits on this node.
[in] | unlimitedR | The value before applying the limits. |
[in] | block | The datablock. |
[out] | ReturnStatus | Return status. |
|
protectedvirtual |
This method allows the custom transform to apply its own locking mechanism to rotation.
Standard dependency graph attribute locking happens automatically and cannot be modified by custom nodes.
If the plug should not be changed, then the value from the passed savedR argument should be returned to be used in the transformation matrix.
[in] | toTest | The values to use if the plug is not locked. |
[in] | savedR | The values to revert to if the plug cannot be changed. |
[in] | ReturnStatus | status |
|
protectedvirtual |
This method returns a copy of the passed scale value with its members limited by any enabled scale limits on this node.
[in] | unlimitedS | The scale before applying limits. |
[in] | block | The datablock. |
[out] | ReturnStatus | Return status. |
|
protectedvirtual |
This method allows the custom transform to apply its own locking mechanism to scale.
Standard dependency graph attribute locking happens automatically and cannot be modified by custom nodes.
If the plug should not be changed, then the value from the passed savedS argument should be return to be used in the transformation matrix.
[in] | toTest | The values to use if the plug is not locked. |
[in] | savedS | The values to revert to if the plug cannot be changed. |
[out] | ReturnStatus | status |
|
protectedvirtual |
This method allows the custom transform to apply its own locking mechanism to shear.
Standard dependency graph attribute locking happens automatically and cannot be modified by custom nodes.
If the plug should not be changed, then the value from the passed savedS argument should be return to be used in the transformation matrix.
[in] | toTest | The values to use if the plug is not locked. |
[in] | savedS | The values to revert to if the plug cannot be changed. |
[out] | ReturnStatus | status |
|
protectedvirtual |
This method allows the custom transform to apply its own locking mechanism to rotation orientation.
Standard dependency graph attribute locking happens automatically and cannot be modified by custom nodes.
If the plug should not be changed, then the value from the passed savedRO argument should be return to be used in the transformation matrix.
[in] | toTest | The values to use if the plug is not locked. |
[in] | savedRO | The values to revert to if the plug cannot be changed. |
[out] | ReturnStatus | status |
|
protectedvirtual |
This method allows the custom transform to apply its own locking mechanism to scale pivot.
Standard dependency graph attribute locking happens automatically and cannot be modified by custom nodes.
If the plug should not be changed, then the value from the passed savedSP argument should be return to be used in the transformation matrix.
[in] | toTest | The values to use if the plug is not locked. |
[in] | savedSP | The values to revert to if the plug cannot be changed. |
[out] | ReturnStatus | status |
|
protectedvirtual |
This method allows the custom transform to apply its own locking mechanism to rotation pivots.
Standard dependency graph attribute locking happens automatically and cannot be modified by custom nodes.
If the plug should not be changed, then the value from the passed savedRP argument should be return to be used in the transformation matrix.
[in] | toTest | The values to use if the plug is not locked. |
[in] | savedRP | The values to revert to if the plug cannot be changed. |
[out] | ReturnStatus | status |
|
protectedvirtual |
This method allows the custom transform to apply its own locking mechanism to the scalePivotTranslate attribute.
Standard dependency graph attribute locking happens automatically and cannot be modified by custom nodes.
If the plug should not be changed, then the value from the passed savedR argument should be return to be used in the transformation matrix.
[in] | toTest | The values to use if the plug is not locked. |
[in] | savedSPT | The values to revert to if the plug cannot be changed. |
[out] | ReturnStatus | status |
|
protectedvirtual |
This method allows the custom transform to apply its own locking mechanism to the rotatePivotTranslate attribute.
Standard dependency graph attribute locking happens automatically and cannot be modified by custom nodes.
If the plug should not be changed, then the value from the passed savedR argument should be return to be used in the transformation matrix.
[in] | toTest | The values to use if the plug is not locked. |
[in] | savedRPT | The values to revert to if the plug cannot be changed. |
[out] | ReturnStatus | status |
|
protected |
USE _dirtyMatrix() IN SCRIPT.
This marks the entire matrix dirty.
When a value is changed and that value should also update the matrix, use this method, or one of the specific dirty methods (i.e. dirtyTranslation())
USE _dirtyTranslation() IN SCRIPT.
If the current transformation matrix translation values are different than the passed translation value, then the translation portion of the matrix will be marked dirty.
[in] | savedT | The previous translation values. |
|
protected |
USE _dirtyRotation() IN SCRIPT.
If the current transformation matrix rotation values are different than the passed rotation value, then the rotation portion of the matrix will be marked dirty.
[in] | savedR | The previous rotation values. |
USE _dirtyScale() IN SCRIPT.
If the current transformation matrix scale values are different than the passed scale value, then the scale portion of the matrix will be marked dirty.
[in] | savedS | The previous scale values. |
USE _dirtyShear() IN SCRIPT.
If the current transformation matrix shear values are different than the passed shear value, then the shear portion of the matrix will be marked dirty.
[in] | savedSh | The previous shear values. |
|
protected |
USE _dirtyRotateOrientation() IN SCRIPT.
If the current transformation matrix rotate orientation values are different than the passed rotate orientation value, then the rotate orientation portion of the matrix will be marked dirty.
[in] | savedRO | The previous rotate orientation values. |
USE _dirtyScalePivot() IN SCRIPT.
If the current transformation matrix scale pivot values are different than the passed scale pivot value, then the scale pivot portion of the matrix will be marked dirty.
[in] | savedSP | The previous scale pivot values. |
USE _dirtyRotatePivot() IN SCRIPT.
If the current transformation matrix rotate pivot values are different than the passed rotate pivot value, then the rotate pivot portion of the matrix will be marked dirty.
[in] | savedRP | The previous rotate pivot values. |
USE _dirtyScalePivotTranslation() IN SCRIPT.
If the current transformation matrix scale pivot translation values are different than the passed scale pivot translation value, then the scale pivot translation portion of the matrix will be marked dirty.
[in] | savedST | The previous scale pivot translation values. |
USE _dirtyRotatePivotTranslation() IN SCRIPT.
If the current transformation matrix rotate pivot translation values are different than the passed rotate pivot translation value, then the rotate pivot translation portion of the matrix will be marked dirty.
[in] | savedRT | The previous rotate pivot translation values. |
|
protectedvirtual |
This method is used to modify and set the new translate values being passed in from the compute method or from the validateAndSetValue.
The data block should be set with the corrected values. Corrections would come from enforcing any active limits as well as verifying that the plug's value may be changed. If the plug is locked or if it is the destination in a connection that disallows value changes, then the plug will be set to its unchanged value.
[in] | block | The data block to set. |
[in] | plug | The translate plug (or one of its child plugs). |
[in] | newT | The new translate value. |
[in] | space | The space used for the new translation value. |
|
protectedvirtual |
This method verifies that the passed value can be set on the rotate plugs.
In the base class, limits as well as locking are checked by this method.
The compute, validateAndSetValue, and rotateTo functions all use this method.
[in] | block | The data block |
[in] | plug | The plug. This should be rotate or one of its children. |
[in] | newR | The new rotate value. |
[in] | space | The space that the newR value is using. |
|
protectedvirtual |
This method verifies that the passed value can be set on the scale plugs.
In the base class, limits as well as locking are checked by this method.
The compute, validateAndSetValue, and scaleTo functions all use this method.
[in] | block | The data block |
[in] | plug | The plug. This should be scale or one of its children. |
[in] | newS | The new scale value. |
[in] | space | The space that the newS value is using. |
|
protectedvirtual |
This method verifies that the passed value can be set on the shear plugs.
In the base class, only the locking conditions are enforced.
The compute, validateAndSetValue, and shearTo functions all use this method. If limits are desired on shear, then the limit enforcement should be implemented in this method in a derived class.
[in] | block | The data block |
[in] | plug | The plug. This should be shear or one of its children. |
[in] | newS | The new shear value. |
[in] | space | The space that the newS value is using. |
|
protectedvirtual |
This method verifies that the passed value can be set on the rotateAxis plugs.
In the base class, only the locking conditions are enforced. This method will also update the rotation value if balance is true.
The compute, validateAndSetValue, and setRotateOrientation functions all use this method. If limits are desired on rotateAxis, then the limit enforcement should be implemented in this method in a derived class.
[in] | block | The data block |
[in] | plug | The plug. This should be rotateAxis or one of its children. |
[in] | newRO | The new rotate orientation value. |
[in] | space | The space that the newRO value is using. |
[in] | balance | If balance is true, then the rotation is modified to compensate for the change in rotateAxis such that the transform remains unchanged. |
|
protectedvirtual |
This method verifies that the passed value can be set on the rotatePivot plugs.
In the base class, only the locking conditions are enforced. This method will also update the rotatePivotTranslate value if balance is true.
The compute, validateAndSetValue, and setRotatePivot functions all use this method. If limits are desired on rotatePivot, then the limit enforcement should be implemented in this method in a derived class.
[in] | block | The data block |
[in] | plug | The plug. This should be rotatePivot or one of its children. |
[in] | newRP | The new rotate pivot value. |
[in] | space | The space that the newRP value is using. |
[in] | balance | If balance is true, then the rotatePivotTranslate is modified to compensate for the change in rotatePivot such that the transform remains unchanged. |
|
protectedvirtual |
This method verifies that the passed value can be set on the rotatePivotTranslate plugs.
In the base class, only the locking conditions are enforced.
The compute, validateAndSetValue, and setRotatePivotTranslation functions all use this method. If limits are desired on rotatePivotTranslate, then the limit enforcement should be implemented in this method in a derived class.
[in] | block | The data block |
[in] | plug | The plug. This should be rotatePivotTranslate or one of its children. |
[in] | newPT | The new rotate pivot translate value. |
[in] | space | The space that the newPT value is using. |
|
protectedvirtual |
This method verifies that the passed value can be set on the scalePivot plugs.
In the base class, only the locking conditions are enforced. This method will also update the scalePivotTranslate value if balance is true.
The compute, validateAndSetValue, and setScalePivot functions all use this method. If limits are desired on scalePivot, then the limit enforcement should be implemented in this method in a derived class.
[in] | block | The data block |
[in] | plug | The plug. This should be scalePivot or one of its children. |
[in] | newSP | The new scale pivot value. |
[in] | space | The space that the newSP value is using. |
[in] | balance | If balance is true, then the scalePivotTranslate is modified to compensate for the change in scalePivot such that the transform remains unchanged. |
|
protectedvirtual |
This method verifies that the passed value can be set on the scalePivotTranslate plugs.
In the base class, only the locking conditions are enforced.
The compute, validateAndSetValue, and setScalePivotTranslation functions all use this method. If limits are desired on scalePivotTranslate, then the limit enforcement should be implemented in this method in a derived class.
[in] | block | The data block |
[in] | plug | The plug. This should be scalePivotTranslate or one of its children. |
[in] | newPT | The new scale pivot translate value. |
[in] | space | The space that the newPT value is using. |
|
static |
Returns the name of this class.
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | plug | The plug that is to be set. |
[in] | handle | The inputValue handle of the data. |
[in] | context | The context in which the value is being set |
MStatus updateMatrixAttrs | ( | const MDGContext & | context | ) |
This method is obsolete.
\
[From Maya 2018]
[in] | context |
MStatus updateMatrixAttrs | ( | MObject & | attr, |
const MDGContext & | context | ||
) |
This method is obsolete.
[From Maya 2018]
[in] | attr | |
[in] | context |
|
virtual |
This method is obsolete.
This method returns a 4x4 matrix that is produced by applying all of the components of the transform.
[From Maya 2018]
[in] | context | The context for getting the matrix. |
[out] | ReturnStatus | Return status. |
|
virtual |
This method is obsolete.
This method returns the inverse of the 4x4 matrix that describes this transformation in the given evaluation context.
[From Maya 2018]
[in] | context | The context for getting the inverse MMatrix. |
[out] | ReturnStatus | Return status. |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | space | |
[in] | context | |
[out] | ReturnStatus |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | newTrans | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | transOffset | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | space | |
[in] | context | |
[out] | ReturnStatus |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | space | |
[in] | context | |
[out] | ReturnStatus |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | newRot | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | rotateOffset | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | euler | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | euler | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | space | |
[in] | context | |
[out] | ReturnStatus |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | newScale | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | scaleOffset | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | space | |
[in] | context | |
[out] | ReturnStatus |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | newShear | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | shearOffset | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | space | |
[in] | context | |
[out] | ReturnStatus |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | space | |
[in] | context | |
[out] | ReturnStatus |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | space | |
[in] | context | |
[out] | ReturnStatus |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | space | |
[in] | context | |
[out] | ReturnStatus |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | newSP | |
[in] | space | |
[in] | balance | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | newPT | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | newRP | |
[in] | space | |
[in] | balance | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | newPT | |
[in] | space | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | ro | |
[in] | reorder | |
[in] | context |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | space | |
[in] | context | |
[out] | ReturnStatus |
|
virtual |
This method is obsolete.
[From Maya 2018]
[in] | newRO | |
[in] | space | |
[in] | balance | |
[in] | context |
|
static |
This method is obsolete.
Obsolete attribute
|
static |
This method is obsolete.
Obsolete attribute
|
static |
This method is obsolete.
Obsolete attribute
|
static |
This method is obsolete.
Obsolete attribute
MPxTransformationMatrix* baseTransformationMatrix |
Cached MPxTransformationMatrix for normal-context (same as returned by transformationMatrix() method in normal-context).
This method is obsolete. [From Maya 2019]