28 #ifndef PXR_BASE_GF_MATRIX3D_H
29 #define PXR_BASE_GF_MATRIX3D_H
35 #include "pxr/base/gf/api.h"
37 #include "pxr/base/gf/matrixData.h"
39 #include "pxr/base/gf/traits.h"
41 #include <boost/functional/hash.hpp>
46 PXR_NAMESPACE_OPEN_SCOPE
85 typedef double ScalarType;
87 static const size_t numRows = 3;
88 static const size_t numColumns = 3;
97 double m10,
double m11,
double m12,
98 double m20,
double m21,
double m22) {
135 explicit GfMatrix3d(
const std::vector< std::vector<double> >& v);
144 explicit GfMatrix3d(
const std::vector< std::vector<float> >& v);
174 return GfVec3d(_mtx[i][0], _mtx[i][1], _mtx[i][2]);
179 return GfVec3d(_mtx[0][i], _mtx[1][i], _mtx[2][i]);
186 double m10,
double m11,
double m12,
187 double m20,
double m21,
double m22) {
188 _mtx[0][0] = m00; _mtx[0][1] = m01; _mtx[0][2] = m02;
189 _mtx[1][0] = m10; _mtx[1][1] = m11; _mtx[1][2] = m12;
190 _mtx[2][0] = m20; _mtx[2][1] = m21; _mtx[2][2] = m22;
197 _mtx[0][0] = m[0][0];
198 _mtx[0][1] = m[0][1];
199 _mtx[0][2] = m[0][2];
200 _mtx[1][0] = m[1][0];
201 _mtx[1][1] = m[1][1];
202 _mtx[1][2] = m[1][2];
203 _mtx[2][0] = m[2][0];
204 _mtx[2][1] = m[2][1];
205 _mtx[2][2] = m[2][2];
230 double*
Get(
double m[3][3])
const;
270 boost::hash_combine(h, *p++);
287 return !(*
this == m);
293 return !(*
this == m);
411 return GfVec3d(vec[0] * m._mtx[0][0] + vec[1] * m._mtx[0][1] + vec[2] * m._mtx[0][2],
412 vec[0] * m._mtx[1][0] + vec[1] * m._mtx[1][1] + vec[2] * m._mtx[1][2],
413 vec[0] * m._mtx[2][0] + vec[1] * m._mtx[2][1] + vec[2] * m._mtx[2][2]);
418 return GfVec3d(vec[0] * m._mtx[0][0] + vec[1] * m._mtx[1][0] + vec[2] * m._mtx[2][0],
419 vec[0] * m._mtx[0][1] + vec[1] * m._mtx[1][1] + vec[2] * m._mtx[2][1],
420 vec[0] * m._mtx[0][2] + vec[1] * m._mtx[1][2] + vec[2] * m._mtx[2][2]);
485 void _SetRotateFromQuat(
double r,
const GfVec3d& i);
507 PXR_NAMESPACE_CLOSE_SCOPE
509 #endif // PXR_BASE_GF_MATRIX3D_H
GF_API bool Orthonormalize(bool issueWarning=true)
Makes the matrix orthonormal in place.
void SetColumn(int i, const GfVec3d &v)
Sets a column of the matrix from a Vec3.
GfMatrix3d(int s)
This explicit constructor initializes the matrix to s times the identity matrix.
GF_API GfMatrix3d GetOrthonormalized(bool issueWarning=true) const
Returns an orthonormalized copy of the matrix.
const double * data() const
Returns const raw access to components of matrix as an array of double values.
double * GetArray()
Returns vector components as an array of double values.
GfMatrix3d(double s)
Constructor.
bool GfIsClose(double a, double b, double epsilon)
Returns true if a and b are with epsilon of each other.
bool IsLeftHanded() const
Returns true if the vectors in matrix form a left-handed coordinate system.
GF_API GfMatrix3d & operator+=(const GfMatrix3d &m)
Adds matrix m to this matrix.
GfMatrix3d()=default
Default constructor. Leaves the matrix component values undefined.
GfMatrix3d & Set(double m00, double m01, double m02, double m10, double m11, double m12, double m20, double m21, double m22)
Sets the matrix from 9 independent double values, specified in row-major order.
GfMatrix3d(const double m[3][3])
Constructor.
GF_API GfMatrix3d & SetScale(double scaleFactor)
Sets matrix to specify a uniform scaling by scaleFactor.
GfMatrix3d & Set(const double m[3][3])
Sets the matrix from a 3x3 array of double values, specified in row-major order.
GfMatrix3d & SetZero()
Sets the matrix to zero.
Basic type for a vector of 3 float components.
Basic type: complex number with scalar real part and vector imaginary part.
GfVec3d GetColumn(int i) const
Gets a column of the matrix as a Vec3.
GF_API double * Get(double m[3][3]) const
Fills a 3x3 array of double values with the values in the matrix, specified in row-major order...
GfMatrix3d(double m00, double m01, double m02, double m10, double m11, double m12, double m20, double m21, double m22)
Constructor.
GF_API GfMatrix3d & SetDiagonal(double s)
Sets the matrix to s times the identity matrix.
GF_API GfRotation ExtractRotation() const
Returns the rotation corresponding to this matrix.
GF_API bool operator==(const GfMatrix3d &m) const
Tests for element-wise matrix equality.
Stores a 3x3 matrix of float elements.
GfMatrix3d & SetIdentity()
Sets the matrix to the identity matrix.
friend GfMatrix3d operator*(const GfMatrix3d &m1, double d)
Returns the product of a matrix and a double.
GF_API GfMatrix3d GetTranspose() const
Returns the transpose of the matrix.
GF_API double GetDeterminant() const
Returns the determinant of the matrix.
T * GetData()
Return a pointer to the start of all the data.
A metafunction with a static const bool member 'value' that is true for GfMatrix types, like GfMatrix3d, GfMatrix4f, etc and false for all other types.
friend GfMatrix3d operator+(const GfMatrix3d &m1, const GfMatrix3d &m2)
Adds matrix m2 to m1.
GF_API friend GfMatrix3d operator-(const GfMatrix3d &m)
Returns the unary negation of matrix m.
GF_API GfMatrix3d & operator-=(const GfMatrix3d &m)
Subtracts matrix m from this matrix.
GF_API GfMatrix3d & SetRotate(const GfQuatd &rot)
Sets the matrix to specify a rotation equivalent to rot.
GF_API GfMatrix3d & operator*=(const GfMatrix3d &m)
Post-multiplies matrix m into this matrix.
GF_API GfMatrix3d GetInverse(double *det=NULL, double eps=0) const
Returns the inverse of the matrix, or FLT_MAX * SetIdentity() if the matrix is singular.
double * operator[](int i)
Accesses an indexed row i of the matrix as an array of 3 double values so that standard indexing (suc...
bool IsRightHanded() const
Returns true if the vectors in the matrix form a right-handed coordinate system.
GF_API std::ostream & operator<<(std::ostream &, const GfBBox3d &)
Output a GfBBox3d using the format [(range) matrix zeroArea].
const double * GetArray() const
Returns vector components as a const array of double values.
GfMatrix3d(const GfVec3d &v)
Constructor.
double * data()
Returns raw access to components of matrix as an array of double values.
GF_API GfQuaternion ExtractRotationQuaternion() const
Returns the quaternion corresponding to this matrix.
Basic type for a vector of 3 double components.
bool operator!=(const GfMatrix3d &m) const
Tests for element-wise matrix inequality.
Stores a 3x3 matrix of double elements.
GF_API GfVec3d DecomposeRotation(const GfVec3d &axis0, const GfVec3d &axis1, const GfVec3d &axis2) const
Decompose the rotation corresponding to this matrix about 3 orthogonal axes.
Basic type: a quaternion, a complex number with a real coefficient and three imaginary coefficients...
Basic type: 3-space rotation specification.
GF_API double GetHandedness() const
Returns the sign of the determinant of the matrix, i.e.
GfVec3d GetRow(int i) const
Gets a row of the matrix as a Vec3.
void SetRow(int i, const GfVec3d &v)
Sets a row of the matrix from a Vec3.
friend GfMatrix3d operator/(const GfMatrix3d &m1, const GfMatrix3d &m2)
Divides matrix m1 by m2 (that is, m1 * inv(m2)).
friend size_t hash_value(GfMatrix3d const &m)
Hash.