28#ifndef PXR_BASE_GF_MATRIX3F_H
29#define PXR_BASE_GF_MATRIX3F_H
35#include "pxr/base/gf/api.h"
37#include "pxr/base/gf/matrixData.h"
39#include "pxr/base/gf/traits.h"
45PXR_NAMESPACE_OPEN_SCOPE
84 typedef float ScalarType;
86 static const size_t numRows = 3;
87 static const size_t numColumns = 3;
96 float m10,
float m11,
float m12,
97 float m20,
float m21,
float m22) {
134 explicit GfMatrix3f(
const std::vector< std::vector<double> >& v);
143 explicit GfMatrix3f(
const std::vector< std::vector<float> >& v);
173 return GfVec3f(_mtx[i][0], _mtx[i][1], _mtx[i][2]);
178 return GfVec3f(_mtx[0][i], _mtx[1][i], _mtx[2][i]);
185 float m10,
float m11,
float m12,
186 float m20,
float m21,
float m22) {
187 _mtx[0][0] = m00; _mtx[0][1] = m01; _mtx[0][2] = m02;
188 _mtx[1][0] = m10; _mtx[1][1] = m11; _mtx[1][2] = m12;
189 _mtx[2][0] = m20; _mtx[2][1] = m21; _mtx[2][2] = m22;
196 _mtx[0][0] = m[0][0];
197 _mtx[0][1] = m[0][1];
198 _mtx[0][2] = m[0][2];
199 _mtx[1][0] = m[1][0];
200 _mtx[1][1] = m[1][1];
201 _mtx[1][2] = m[1][2];
202 _mtx[2][0] = m[2][0];
203 _mtx[2][1] = m[2][1];
204 _mtx[2][2] = m[2][2];
229 float*
Get(
float m[3][3])
const;
291 return !(*
this == m);
297 return !(*
this == m);
415 return GfVec3f(vec[0] * m._mtx[0][0] + vec[1] * m._mtx[0][1] + vec[2] * m._mtx[0][2],
416 vec[0] * m._mtx[1][0] + vec[1] * m._mtx[1][1] + vec[2] * m._mtx[1][2],
417 vec[0] * m._mtx[2][0] + vec[1] * m._mtx[2][1] + vec[2] * m._mtx[2][2]);
422 return GfVec3f(vec[0] * m._mtx[0][0] + vec[1] * m._mtx[1][0] + vec[2] * m._mtx[2][0],
423 vec[0] * m._mtx[0][1] + vec[1] * m._mtx[1][1] + vec[2] * m._mtx[2][1],
424 vec[0] * m._mtx[0][2] + vec[1] * m._mtx[1][2] + vec[2] * m._mtx[2][2]);
479 void _SetRotateFromQuat(
float r,
const GfVec3f& i);
501PXR_NAMESPACE_CLOSE_SCOPE
Stores a 3x3 matrix of double elements.
Stores a 3x3 matrix of float elements.
GF_API GfMatrix3f(const GfQuatf &rot)
Constructor. Initialize matrix from a quaternion.
const float * GetArray() const
Returns vector components as a const array of float values.
float * data()
Returns raw access to components of matrix as an array of float values.
GF_API GfMatrix3f & operator+=(const GfMatrix3f &m)
Adds matrix m to this matrix.
friend size_t hash_value(GfMatrix3f const &m)
Hash.
GfVec3f GetColumn(int i) const
Gets a column of the matrix as a Vec3.
GfMatrix3f & SetIdentity()
Sets the matrix to the identity matrix.
GfMatrix3f & SetZero()
Sets the matrix to zero.
GF_API GfMatrix3f & SetRotate(const GfRotation &rot)
Sets the matrix to specify a rotation equivalent to rot.
GfMatrix3f()=default
Default constructor. Leaves the matrix component values undefined.
GF_API GfMatrix3f GetInverse(double *det=NULL, double eps=0) const
Returns the inverse of the matrix, or FLT_MAX * SetIdentity() if the matrix is singular.
GF_API GfMatrix3f & SetDiagonal(float s)
Sets the matrix to s times the identity matrix.
GfMatrix3f(float m00, float m01, float m02, float m10, float m11, float m12, float m20, float m21, float m22)
Constructor.
GF_API GfMatrix3f & operator-=(const GfMatrix3f &m)
Subtracts matrix m from this matrix.
GF_API GfQuaternion ExtractRotationQuaternion() const
Returns the quaternion corresponding to this matrix.
GfVec3f GetRow(int i) const
Gets a row of the matrix as a Vec3.
const float * data() const
Returns const raw access to components of matrix as an array of float values.
GF_API GfMatrix3f & SetDiagonal(const GfVec3f &)
Sets the matrix to have diagonal (v[0], v[1], v[2]).
GF_API GfMatrix3f(const std::vector< std::vector< float > > &v)
Constructor.
GF_API GfMatrix3f & SetRotate(const GfQuatf &rot)
Sets the matrix to specify a rotation equivalent to rot.
GF_API double GetDeterminant() const
Returns the determinant of the matrix.
GF_API GfVec3f DecomposeRotation(const GfVec3f &axis0, const GfVec3f &axis1, const GfVec3f &axis2) const
Decompose the rotation corresponding to this matrix about 3 orthogonal axes.
GfMatrix3f(const GfVec3f &v)
Constructor.
GF_API GfMatrix3f & SetScale(float scaleFactor)
Sets matrix to specify a uniform scaling by scaleFactor.
GF_API friend GfMatrix3f operator-(const GfMatrix3f &m)
Returns the unary negation of matrix m.
friend GfMatrix3f operator*(const GfMatrix3f &m1, double d)
Returns the product of a matrix and a float.
GF_API bool operator==(const GfMatrix3d &m) const
Tests for element-wise matrix equality.
GF_API GfMatrix3f GetTranspose() const
Returns the transpose of the matrix.
friend GfMatrix3f operator/(const GfMatrix3f &m1, const GfMatrix3f &m2)
Divides matrix m1 by m2 (that is, m1 * inv(m2)).
GF_API GfMatrix3f(const GfRotation &rot)
Constructor. Initialize matrix from rotation.
friend GfMatrix3f operator+(const GfMatrix3f &m1, const GfMatrix3f &m2)
Adds matrix m2 to m1.
float * operator[](int i)
Accesses an indexed row i of the matrix as an array of 3 float values so that standard indexing (such...
GfMatrix3f & Set(float m00, float m01, float m02, float m10, float m11, float m12, float m20, float m21, float m22)
Sets the matrix from 9 independent float values, specified in row-major order.
GfMatrix3f & Set(const float m[3][3])
Sets the matrix from a 3x3 array of float values, specified in row-major order.
GF_API double GetHandedness() const
Returns the sign of the determinant of the matrix, i.e.
GF_API GfMatrix3f & SetScale(const GfVec3f &scaleFactors)
Sets the matrix to specify a nonuniform scaling in x, y, and z by the factors in vector scaleFactors.
float * GetArray()
Returns vector components as an array of float values.
GF_API GfMatrix3f(const std::vector< std::vector< double > > &v)
Constructor.
GfMatrix3f(const float m[3][3])
Constructor.
void SetColumn(int i, const GfVec3f &v)
Sets a column of the matrix from a Vec3.
GF_API GfMatrix3f GetOrthonormalized(bool issueWarning=true) const
Returns an orthonormalized copy of the matrix.
GF_API float * Get(float m[3][3]) const
Fills a 3x3 array of float values with the values in the matrix, specified in row-major order.
GfMatrix3f(int s)
This explicit constructor initializes the matrix to s times the identity matrix.
bool operator!=(const GfMatrix3d &m) const
Tests for element-wise matrix inequality.
GF_API GfMatrix3f(const class GfMatrix3d &m)
This explicit constructor converts a "double" matrix to a "float" matrix.
GF_API bool Orthonormalize(bool issueWarning=true)
Makes the matrix orthonormal in place.
bool IsLeftHanded() const
Returns true if the vectors in matrix form a left-handed coordinate system.
void SetRow(int i, const GfVec3f &v)
Sets a row of the matrix from a Vec3.
GfMatrix3f(float s)
Constructor.
bool IsRightHanded() const
Returns true if the vectors in the matrix form a right-handed coordinate system.
GF_API GfRotation ExtractRotation() const
Returns the rotation corresponding to this matrix.
GF_API GfMatrix3f & operator*=(const GfMatrix3f &m)
Post-multiplies matrix m into this matrix.
A class template used by GfMatrixXX to store values.
T * GetData()
Return a pointer to the start of all the data.
Basic type: complex number with scalar real part and vector imaginary part.
Basic type: a quaternion, a complex number with a real coefficient and three imaginary coefficients,...
Basic type: 3-space rotation specification.
Basic type for a vector of 3 float components.
static size_t Combine(Args &&... args)
Produce a hash code by combining the hash codes of several objects.
GF_API std::ostream & operator<<(std::ostream &, const GfBBox3d &)
Output a GfBBox3d using the format [(range) matrix zeroArea].
GF_API bool GfIsClose(GfMatrix3f const &m1, GfMatrix3f const &m2, double tolerance)
Tests for equality within a given tolerance, returning true if the difference between each component ...
A metafunction with a static const bool member 'value' that is true for GfMatrix types,...