309 lines
9.3 KiB
C++
Executable File
309 lines
9.3 KiB
C++
Executable File
#ifndef _MPxTransformationMatrix
|
|
#define _MPxTransformationMatrix
|
|
//
|
|
//-
|
|
// ==========================================================================
|
|
// Copyright (C) 1995 - 2005 Alias Systems Corp. and/or its licensors. All
|
|
// rights reserved.
|
|
//
|
|
// The coded instructions, statements, computer programs, and/or related
|
|
// material (collectively the "Data") in these files contain unpublished
|
|
// information proprietary to Alias Systems Corp. ("Alias") and/or its
|
|
// licensors, which is protected by Canadian and US federal copyright law and
|
|
// by international treaties.
|
|
//
|
|
// The Data may not be disclosed or distributed to third parties or be copied
|
|
// or duplicated, in whole or in part, without the prior written consent of
|
|
// Alias.
|
|
//
|
|
// THE DATA IS PROVIDED "AS IS". ALIAS HEREBY DISCLAIMS ALL WARRANTIES RELATING
|
|
// TO THE DATA, INCLUDING, WITHOUT LIMITATION, ANY AND ALL EXPRESS OR IMPLIED
|
|
// WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND/OR FITNESS FOR A
|
|
// PARTICULAR PURPOSE. IN NO EVENT SHALL ALIAS BE LIABLE FOR ANY DAMAGES
|
|
// WHATSOEVER, WHETHER DIRECT, INDIRECT, SPECIAL, OR PUNITIVE, WHETHER IN AN
|
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, OR IN EQUITY,
|
|
// ARISING OUT OF ACCESS TO, USE OF, OR RELIANCE UPON THE DATA.
|
|
// ==========================================================================
|
|
//+
|
|
//
|
|
// Description:
|
|
//
|
|
// This is the API side of user defined transformation matrices.
|
|
// Any MPxTransformationMatrix will have an associated THxformMatrix
|
|
// class to handle the Maya side of things.
|
|
//
|
|
// CLASS: MPxTransformationMatrix
|
|
//
|
|
// *****************************************************************************
|
|
//
|
|
// CLASS DESCRIPTION (MPxTransformationMatrix)
|
|
//
|
|
// *****************************************************************************
|
|
|
|
#if defined __cplusplus
|
|
|
|
// *****************************************************************************
|
|
|
|
// INCLUDED HEADER FILES
|
|
#include <maya/MTypeId.h>
|
|
#include <maya/MStatus.h>
|
|
#include <maya/MTypes.h>
|
|
#include <maya/MTransformationMatrix.h>
|
|
|
|
#include <maya/MMatrix.h>
|
|
#include <maya/MQuaternion.h>
|
|
#include <maya/MEulerRotation.h>
|
|
#include <maya/MVector.h>
|
|
#include <maya/MPoint.h>
|
|
|
|
// DECLARATIONS
|
|
|
|
// CLASS DECLARATION (MPxTransformationMatrix)
|
|
|
|
/// Base class of all user defined transformation matrices.
|
|
/**
|
|
Base class of all user defined transformation matrices.
|
|
*/
|
|
|
|
class OPENMAYA_EXPORT MPxTransformationMatrix {
|
|
public:
|
|
///
|
|
MPxTransformationMatrix();
|
|
///
|
|
MPxTransformationMatrix(const MTransformationMatrix &);
|
|
///
|
|
MPxTransformationMatrix(const MPxTransformationMatrix &);
|
|
///
|
|
MPxTransformationMatrix(const MMatrix &);
|
|
///
|
|
virtual ~MPxTransformationMatrix();
|
|
|
|
///
|
|
virtual void copyValues(MPxTransformationMatrix *);
|
|
|
|
///
|
|
virtual MTypeId typeId() const;
|
|
|
|
///
|
|
MPxTransformationMatrix & operator = (const MPxTransformationMatrix &src);
|
|
///
|
|
MPxTransformationMatrix & operator = (const MMatrix &src);
|
|
///
|
|
MPxTransformationMatrix & operator = (const MTransformationMatrix &src);
|
|
///
|
|
bool operator == (const MPxTransformationMatrix &);
|
|
///
|
|
bool operator != (const MPxTransformationMatrix &);
|
|
///
|
|
bool operator == (const MTransformationMatrix &);
|
|
///
|
|
bool operator != (const MTransformationMatrix &);
|
|
///
|
|
bool operator == (const MMatrix &);
|
|
///
|
|
bool operator != (const MMatrix &);
|
|
///
|
|
|
|
///
|
|
virtual bool isEquivalent(const MPxTransformationMatrix &,
|
|
double tolerance = MMatrix_kTol) const;
|
|
///
|
|
virtual bool isEquivalent(const MTransformationMatrix &,
|
|
double tolerance = MMatrix_kTol) const;
|
|
///
|
|
virtual bool isEquivalent(const MMatrix &,
|
|
double tolerance = MMatrix_kTol) const;
|
|
///
|
|
virtual MPxTransformationMatrix reverse() const;
|
|
///
|
|
virtual MPxTransformationMatrix &transformBy(const MTransformationMatrix &);
|
|
|
|
///
|
|
virtual MMatrix asMatrix() const;
|
|
///
|
|
virtual MMatrix asMatrixInverse() const;
|
|
///
|
|
virtual MMatrix asScaleMatrix() const;
|
|
///
|
|
virtual MMatrix asScaleMatrixInverse() const;
|
|
///
|
|
virtual MMatrix asRotateMatrix() const;
|
|
///
|
|
virtual MMatrix asRotateMatrixInverse() const;
|
|
///
|
|
virtual MMatrix asMatrix(double percent) const;
|
|
///
|
|
virtual MMatrix asInterpolationMatrix(const MTransformationMatrix &toM,
|
|
double percent, bool rot,
|
|
int direction = 0) const;
|
|
///
|
|
virtual MTransformationMatrix asTransformationMatrix() const;
|
|
|
|
//
|
|
// Translation methods:
|
|
//
|
|
|
|
///
|
|
virtual MVector translation(MSpace::Space = MSpace::kTransform,
|
|
MStatus* ReturnStatus = NULL) const;
|
|
///
|
|
virtual MStatus translateTo(const MVector &vector,
|
|
MSpace::Space = MSpace::kTransform);
|
|
///
|
|
virtual MStatus translateBy(const MVector &vector,
|
|
MSpace::Space = MSpace::kTransform);
|
|
|
|
//
|
|
// Rotation methods:
|
|
//
|
|
|
|
///
|
|
virtual MQuaternion rotation(MSpace::Space = MSpace::kTransform,
|
|
MStatus *ReturnStatus = NULL) const;
|
|
///
|
|
virtual MEulerRotation eulerRotation(MSpace::Space = MSpace::kTransform,
|
|
MStatus *ReturnStatus = NULL) const;
|
|
///
|
|
virtual MStatus rotateTo(const MQuaternion &q,
|
|
MSpace::Space = MSpace::kTransform);
|
|
///
|
|
virtual MStatus rotateBy(const MQuaternion &q,
|
|
MSpace::Space = MSpace::kTransform);
|
|
///
|
|
virtual MStatus rotateTo(const MEulerRotation &e,
|
|
MSpace::Space = MSpace::kTransform);
|
|
///
|
|
virtual MStatus rotateBy(const MEulerRotation &e,
|
|
MSpace::Space = MSpace::kTransform);
|
|
///
|
|
virtual MTransformationMatrix::RotationOrder
|
|
rotationOrder(MStatus* ReturnStatus = NULL) const;
|
|
///
|
|
virtual MStatus setRotationOrder(MTransformationMatrix::RotationOrder,
|
|
bool preserve = true);
|
|
///
|
|
virtual MQuaternion rotateOrientation(MSpace::Space = MSpace::kTransform,
|
|
MStatus* ReturnStatus = NULL) const;
|
|
///
|
|
virtual MStatus setRotateOrientation(const MQuaternion &q,
|
|
MSpace::Space = MSpace::kTransform,
|
|
bool balance = true);
|
|
///
|
|
virtual MEulerRotation eulerRotateOrientation(MSpace::Space = MSpace::kTransform,
|
|
MStatus* ReturnStatus = NULL) const;
|
|
virtual MStatus setRotateOrientation(const MEulerRotation &euler,
|
|
MSpace::Space = MSpace::kTransform,
|
|
bool balance = true);
|
|
|
|
//
|
|
// Scale methods:
|
|
//
|
|
|
|
///
|
|
virtual MVector scale(MSpace::Space = MSpace::kTransform,
|
|
MStatus* ReturnStatus = NULL) const;
|
|
///
|
|
virtual MStatus scaleTo(const MVector &,
|
|
MSpace::Space = MSpace::kTransform);
|
|
///
|
|
virtual MStatus scaleBy(const MVector &,
|
|
MSpace::Space = MSpace::kTransform);
|
|
|
|
// Shear methods:
|
|
//
|
|
///
|
|
virtual MVector shear(MSpace::Space = MSpace::kTransform,
|
|
MStatus* ReturnStatus = NULL) const;
|
|
///
|
|
virtual MStatus shearTo(const MVector& shear,
|
|
MSpace::Space = MSpace::kTransform);
|
|
///
|
|
virtual MStatus shearBy(const MVector& shear,
|
|
MSpace::Space = MSpace::kTransform);
|
|
|
|
// Scale pivot methods:
|
|
//
|
|
///
|
|
virtual MPoint scalePivot(MSpace::Space = MSpace::kTransform,
|
|
MStatus* ReturnStatus = NULL) const;
|
|
///
|
|
virtual MStatus setScalePivot(const MPoint &,
|
|
MSpace::Space = MSpace::kTransform,
|
|
bool balance = true);
|
|
///
|
|
virtual MVector scalePivotTranslation(MSpace::Space = MSpace::kTransform,
|
|
MStatus* ReturnStatus = NULL) const;
|
|
///
|
|
virtual MStatus setScalePivotTranslation(const MVector &vector,
|
|
MSpace::Space = MSpace::kTransform);
|
|
|
|
// Rotate pivot methods:
|
|
|
|
///
|
|
virtual MPoint rotatePivot(MSpace::Space = MSpace::kTransform,
|
|
MStatus* ReturnStatus = NULL) const;
|
|
///
|
|
virtual MStatus setRotatePivot(const MPoint &,
|
|
MSpace::Space = MSpace::kTransform,
|
|
bool balance = true);
|
|
///
|
|
virtual MVector rotatePivotTranslation(MSpace::Space = MSpace::kTransform,
|
|
MStatus* ReturnStatus = NULL) const;
|
|
///
|
|
virtual MStatus setRotatePivotTranslation(const MVector &vector,
|
|
MSpace::Space = MSpace::kTransform);
|
|
///
|
|
virtual MStatus unSquishIt();
|
|
///
|
|
virtual MMatrix unSquishMatrix() const;
|
|
|
|
///
|
|
friend IOS_REF(ostream) &operator << (IOS_REF(ostream) &os, const MPxTransformationMatrix &m);
|
|
|
|
static void *creator();
|
|
|
|
///
|
|
static MEulerRotation::RotationOrder
|
|
convertRotationOrder(MTransformationMatrix::RotationOrder,
|
|
MStatus *ReturnStatus = NULL);
|
|
///
|
|
static MTransformationMatrix::RotationOrder
|
|
convertRotationOrder(MEulerRotation::RotationOrder,
|
|
MStatus *ReturnStatus = NULL);
|
|
///
|
|
static const MPxTransformationMatrix identity;
|
|
///
|
|
static MTypeId baseTransformationMatrixId;
|
|
protected:
|
|
///
|
|
virtual MStatus decomposeMatrix(const MMatrix &);
|
|
|
|
///
|
|
MVector scaleValue;
|
|
///
|
|
MEulerRotation rotationValue;
|
|
///
|
|
MVector translationValue;
|
|
///
|
|
MVector shearValue;
|
|
///
|
|
MPoint scalePivotValue;
|
|
///
|
|
MVector scalePivotTranslationValue;
|
|
///
|
|
MPoint rotatePivotValue;
|
|
///
|
|
MVector rotatePivotTranslationValue;
|
|
///
|
|
MQuaternion rotateOrientationValue;
|
|
|
|
private:
|
|
static const char* className();
|
|
void* instance;
|
|
|
|
};
|
|
|
|
// *****************************************************************************
|
|
#endif /* __cplusplus */
|
|
#endif /* _MPxTransformationMatrix */
|