Stores a 2x2 matrix of double elements. More...

Public Types
typedef double	ScalarType

Public Member Functions
	GfMatrix2d ()=default
	Default constructor. Leaves the matrix component values undefined. More...

	GfMatrix2d (double m00, double m01, double m10, double m11)
	Constructor. More...

	GfMatrix2d (const double m[2][2])
	Constructor. More...

	GfMatrix2d (double s)
	Constructor. More...

	GfMatrix2d (int s)
	This explicit constructor initializes the matrix to `s` times the identity matrix. More...

	GfMatrix2d (const GfVec2d &v)
	Constructor. More...

GF_API	GfMatrix2d (const std::vector< std::vector< double > > &v)
	Constructor. More...

GF_API	GfMatrix2d (const std::vector< std::vector< float > > &v)
	Constructor. More...

GF_API	GfMatrix2d (const class GfMatrix2f &m)
	This explicit constructor converts a "float" matrix to a "double" matrix. More...

void	SetRow (int i, const GfVec2d &v)
	Sets a row of the matrix from a Vec2. More...

void	SetColumn (int i, const GfVec2d &v)
	Sets a column of the matrix from a Vec2. More...

GfVec2d	GetRow (int i) const
	Gets a row of the matrix as a Vec2. More...

GfVec2d	GetColumn (int i) const
	Gets a column of the matrix as a Vec2. More...

GfMatrix2d &	Set (double m00, double m01, double m10, double m11)
	Sets the matrix from 4 independent `double` values, specified in row-major order. More...

GfMatrix2d &	Set (const double m[2][2])
	Sets the matrix from a 2x2 array of `double` values, specified in row-major order. More...

GfMatrix2d &	SetIdentity ()
	Sets the matrix to the identity matrix. More...

GfMatrix2d &	SetZero ()
	Sets the matrix to zero. More...

GF_API GfMatrix2d &	SetDiagonal (double s)
	Sets the matrix to s times the identity matrix. More...

GF_API GfMatrix2d &	SetDiagonal (const GfVec2d &)
	Sets the matrix to have diagonal (`v[0], v[1]`). More...

GF_API double *	Get (double m[2][2]) const
	Fills a 2x2 array of `double` values with the values in the matrix, specified in row-major order. More...

double *	data ()
	Returns raw access to components of matrix as an array of `double` values. More...

const double *	data () const
	Returns const raw access to components of matrix as an array of `double` values. More...

double *	GetArray ()
	Returns vector components as an array of `double` values. More...

const double *	GetArray () const
	Returns vector components as a const array of `double` values. More...

double *	operator [] (int i)
	Accesses an indexed row i of the matrix as an array of 2 `double` values so that standard indexing (such as `m[0][1]`) works correctly. More...

const double *	operator [] (int i) const
	Accesses an indexed row i of the matrix as an array of 2 `double` values so that standard indexing (such as `m[0][1]`) works correctly. More...

GF_API bool	operator== (const GfMatrix2d &m) const
	Tests for element-wise matrix equality. More...

GF_API bool	operator== (const GfMatrix2f &m) const
	Tests for element-wise matrix equality. More...

bool	operator != (const GfMatrix2d &m) const
	Tests for element-wise matrix inequality. More...

bool	operator != (const GfMatrix2f &m) const
	Tests for element-wise matrix inequality. More...

GF_API GfMatrix2d	GetTranspose () const
	Returns the transpose of the matrix. More...

GF_API GfMatrix2d	GetInverse (double *det=NULL, double eps=0) const
	Returns the inverse of the matrix, or FLT_MAX * SetIdentity() if the matrix is singular. More...

GF_API double	GetDeterminant () const
	Returns the determinant of the matrix. More...

GF_API GfMatrix2d &	operator *= (const GfMatrix2d &m)
	Post-multiplies matrix m into this matrix. More...

GF_API GfMatrix2d &	operator *= (double)
	Multiplies the matrix by a double. More...

GF_API GfMatrix2d &	operator+= (const GfMatrix2d &m)
	Adds matrix m to this matrix. More...

GF_API GfMatrix2d &	operator -= (const GfMatrix2d &m)
	Subtracts matrix m from this matrix. More...

Static Public Attributes
static const size_t	numRows = 2

static const size_t	numColumns = 2

Friends
class	GfMatrix2f

size_t	hash_value (GfMatrix2d const &m)
	Hash. More...

GfMatrix2d	operator * (const GfMatrix2d &m1, double d)
	Returns the product of a matrix and a double. More...

GfMatrix2d	operator * (double d, const GfMatrix2d &m)

GF_API friend GfMatrix2d	operator - (const GfMatrix2d &m)
	Returns the unary negation of matrix m. More...

GfMatrix2d	operator+ (const GfMatrix2d &m1, const GfMatrix2d &m2)
	Adds matrix m2 to m1. More...

GfMatrix2d	operator - (const GfMatrix2d &m1, const GfMatrix2d &m2)
	Subtracts matrix m2 from m1. More...

GfMatrix2d	operator * (const GfMatrix2d &m1, const GfMatrix2d &m2)
	Multiplies matrix m1 by m2. More...

GfMatrix2d	operator/ (const GfMatrix2d &m1, const GfMatrix2d &m2)
	Divides matrix m1 by m2 (that is, `m1 * inv(m2)`). More...

GfVec2d	operator * (const GfMatrix2d &m, const GfVec2d &vec)
	Returns the product of a matrix m and a column vector vec. More...

GfVec2d	operator * (const GfVec2d &vec, const GfMatrix2d &m)
	Returns the product of row vector vec and a matrix m. More...

GF_API friend GfVec2f	operator * (const GfMatrix2d &m, const GfVec2f &vec)
	Returns the product of a matrix m and a column vector vec. More...

GF_API friend GfVec2f	operator * (const GfVec2f &vec, const GfMatrix2d &m)
	Returns the product of row vector vec and a matrix m. More...

Detailed Description

Stores a 2x2 matrix of double elements.

A basic type.

Matrices are defined to be in row-major order, so matrix[i][j] indexes the element in the i th row and the j th column.

Definition at line 61 of file matrix2d.h.

Constructor & Destructor Documentation

◆ GfMatrix2d() [1/9]

GfMatrix2d ( )

default

Default constructor. Leaves the matrix component values undefined.

◆ GfMatrix2d() [2/9]

GfMatrix2d	(	double	m00,
		double	m01,
		double	m10,
		double	m11
	)

inline

Constructor.

Initializes the matrix from 4 independent double values, specified in row-major order. For example, parameter m10 specifies the value in row 1 and column 0.

Definition at line 75 of file matrix2d.h.

◆ GfMatrix2d() [3/9]

GfMatrix2d ( const double m[2][2] )

inline

Constructor.

Initializes the matrix from a 2x2 array of double values, specified in row-major order.

Definition at line 83 of file matrix2d.h.

◆ GfMatrix2d() [4/9]

GfMatrix2d ( double s )

inlineexplicit

Constructor.

Explicitly initializes the matrix to s times the identity matrix.

Definition at line 89 of file matrix2d.h.

◆ GfMatrix2d() [5/9]

GfMatrix2d ( int s )

inlineexplicit

This explicit constructor initializes the matrix to s times the identity matrix.

Definition at line 95 of file matrix2d.h.

◆ GfMatrix2d() [6/9]

GfMatrix2d ( const GfVec2d & v )

inlineexplicit

Constructor.

Explicitly initializes the matrix to diagonal form, with the i th element on the diagonal set to v[i].

Definition at line 101 of file matrix2d.h.

◆ GfMatrix2d() [7/9]

GF_API GfMatrix2d ( const std::vector< std::vector< double > > & v )

explicit

Constructor.

Initialize the matrix from a vector of vectors of double. The vector is expected to be 2x2. If it is too big, only the first 2 rows and/or columns will be used. If it is too small, uninitialized elements will be filled in with the corresponding elements from an identity matrix.

◆ GfMatrix2d() [8/9]

GF_API GfMatrix2d ( const std::vector< std::vector< float > > & v )

explicit

Constructor.

Initialize the matrix from a vector of vectors of float. The vector is expected to be 2x2. If it is too big, only the first 2 rows and/or columns will be used. If it is too small, uninitialized elements will be filled in with the corresponding elements from an identity matrix.

◆ GfMatrix2d() [9/9]

GF_API GfMatrix2d ( const class GfMatrix2f & m )

explicit

This explicit constructor converts a "float" matrix to a "double" matrix.

Member Function Documentation

◆ data() [1/2]

double* data ( )

inline

Returns raw access to components of matrix as an array of double values.

Components are in row-major order.

Definition at line 194 of file matrix2d.h.

◆ data() [2/2]

const double* data ( ) const

inline

Returns const raw access to components of matrix as an array of double values.

Components are in row-major order.

Definition at line 200 of file matrix2d.h.

◆ Get()

GF_API double* Get ( double m[2][2] ) const

Fills a 2x2 array of double values with the values in the matrix, specified in row-major order.

◆ GetArray() [1/2]

double* GetArray ( )

inline

Returns vector components as an array of double values.

Definition at line 205 of file matrix2d.h.

◆ GetArray() [2/2]

const double* GetArray ( ) const

inline

Returns vector components as a const array of double values.

Definition at line 210 of file matrix2d.h.

◆ GetColumn()

GfVec2d GetColumn ( int i ) const

inline

Gets a column of the matrix as a Vec2.

Definition at line 145 of file matrix2d.h.

◆ GetDeterminant()

GF_API double GetDeterminant ( ) const

Returns the determinant of the matrix.

◆ GetInverse()

GF_API GfMatrix2d GetInverse	(	double *	det = `NULL`,
		double	eps = `0`
	)		const

Returns the inverse of the matrix, or FLT_MAX * SetIdentity() if the matrix is singular.

(FLT_MAX is the largest value a float can have, as defined by the system.) The matrix is considered singular if the determinant is less than or equal to the optional parameter eps. If det is non-null, *det is set to the determinant.

◆ GetRow()

GfVec2d GetRow ( int i ) const

inline

Gets a row of the matrix as a Vec2.

Definition at line 140 of file matrix2d.h.

◆ GetTranspose()

GF_API GfMatrix2d GetTranspose ( ) const

Returns the transpose of the matrix.

◆ operator !=() [1/2]

bool operator != ( const GfMatrix2d & m ) const

inline

Tests for element-wise matrix inequality.

All elements must match exactly for matrices to be considered equal.

Definition at line 246 of file matrix2d.h.

◆ operator !=() [2/2]

bool operator != ( const GfMatrix2f & m ) const

inline

Tests for element-wise matrix inequality.

All elements must match exactly for matrices to be considered equal.

Definition at line 252 of file matrix2d.h.

◆ operator *=() [1/2]

GF_API GfMatrix2d& operator *= ( const GfMatrix2d & m )

Post-multiplies matrix m into this matrix.

◆ operator *=() [2/2]

GF_API GfMatrix2d& operator *= ( double )

Multiplies the matrix by a double.

◆ operator -=()

GF_API GfMatrix2d& operator -= ( const GfMatrix2d & m )

Subtracts matrix m from this matrix.

◆ operator []() [1/2]

double* operator [] ( int i )

inline

Accesses an indexed row i of the matrix as an array of 2 double values so that standard indexing (such as m[0][1]) works correctly.

Definition at line 217 of file matrix2d.h.

◆ operator []() [2/2]

const double* operator [] ( int i ) const

inline

Accesses an indexed row i of the matrix as an array of 2 double values so that standard indexing (such as m[0][1]) works correctly.

Definition at line 222 of file matrix2d.h.

◆ operator+=()

GF_API GfMatrix2d& operator+= ( const GfMatrix2d & m )

Adds matrix m to this matrix.

◆ operator==() [1/2]

GF_API bool operator== ( const GfMatrix2d & m ) const

Tests for element-wise matrix equality.

All elements must match exactly for matrices to be considered equal.

◆ operator==() [2/2]

GF_API bool operator== ( const GfMatrix2f & m ) const

Tests for element-wise matrix equality.

All elements must match exactly for matrices to be considered equal.

◆ Set() [1/2]

GfMatrix2d& Set	(	double	m00,
		double	m01,
		double	m10,
		double	m11
	)

inline

Sets the matrix from 4 independent double values, specified in row-major order.

For example, parameter m10 specifies the value in row 1 and column 0.

Definition at line 152 of file matrix2d.h.

◆ Set() [2/2]

GfMatrix2d& Set ( const double m[2][2] )

inline

Sets the matrix from a 2x2 array of double values, specified in row-major order.

Definition at line 161 of file matrix2d.h.

◆ SetColumn()

void SetColumn	(	int	i,
		const GfVec2d &	v
	)

inline

Sets a column of the matrix from a Vec2.

Definition at line 134 of file matrix2d.h.

◆ SetDiagonal() [1/2]

GF_API GfMatrix2d& SetDiagonal ( double s )

Sets the matrix to s times the identity matrix.

◆ SetDiagonal() [2/2]

GF_API GfMatrix2d& SetDiagonal ( const GfVec2d & )

Sets the matrix to have diagonal (v[0], v[1]).

◆ SetIdentity()

GfMatrix2d& SetIdentity ( )

inline

Sets the matrix to the identity matrix.

Definition at line 170 of file matrix2d.h.

◆ SetRow()

void SetRow	(	int	i,
		const GfVec2d &	v
	)

inline

Sets a row of the matrix from a Vec2.

Definition at line 128 of file matrix2d.h.

◆ SetZero()

GfMatrix2d& SetZero ( )

inline

Sets the matrix to zero.

Definition at line 175 of file matrix2d.h.

Friends And Related Function Documentation

◆ hash_value

size_t hash_value ( GfMatrix2d const & m )

friend

Hash.

Definition at line 225 of file matrix2d.h.

◆ operator * [1/6]

GfMatrix2d operator *	(	const GfMatrix2d &	m1,
		double	d
	)

friend

Returns the product of a matrix and a double.

Definition at line 282 of file matrix2d.h.

◆ operator * [2/6]

GfMatrix2d operator *	(	const GfMatrix2d &	m1,
		const GfMatrix2d &	m2
	)

friend

Multiplies matrix m1 by m2.

Definition at line 324 of file matrix2d.h.

◆ operator * [3/6]

GfVec2d operator *	(	const GfMatrix2d &	m,
		const GfVec2d &	vec
	)

friend

Returns the product of a matrix m and a column vector vec.

Definition at line 338 of file matrix2d.h.

◆ operator * [4/6]

GfVec2d operator *	(	const GfVec2d &	vec,
		const GfMatrix2d &	m
	)

friend

Returns the product of row vector vec and a matrix m.

Definition at line 344 of file matrix2d.h.

◆ operator * [5/6]

GF_API friend GfVec2f operator *	(	const GfMatrix2d &	m,
		const GfVec2f &	vec
	)

friend

Returns the product of a matrix m and a column vector vec.

Note that the return type is a GfVec2f.

◆ operator * [6/6]

GF_API friend GfVec2f operator *	(	const GfVec2f &	vec,
		const GfMatrix2d &	m
	)

friend

Returns the product of row vector vec and a matrix m.

Note that the return type is a GfVec2f.

◆ operator - [1/2]

GF_API friend GfMatrix2d operator - ( const GfMatrix2d & m )

friend

Returns the unary negation of matrix m.

◆ operator - [2/2]

GfMatrix2d operator -	(	const GfMatrix2d &	m1,
		const GfMatrix2d &	m2
	)

friend

Subtracts matrix m2 from m1.

Definition at line 316 of file matrix2d.h.

◆ operator+

GfMatrix2d operator+	(	const GfMatrix2d &	m1,
		const GfMatrix2d &	m2
	)

friend

Adds matrix m2 to m1.

Definition at line 308 of file matrix2d.h.

◆ operator/

GfMatrix2d operator/	(	const GfMatrix2d &	m1,
		const GfMatrix2d &	m2
	)

friend

Divides matrix m1 by m2 (that is, m1 * inv(m2)).

Definition at line 332 of file matrix2d.h.

The documentation for this class was generated from the following file:

pxr/base/gf/matrix2d.h

Public Types

Public Member Functions

Static Public Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ GfMatrix2d() [1/9]

◆ GfMatrix2d() [2/9]

◆ GfMatrix2d() [3/9]

◆ GfMatrix2d() [4/9]

◆ GfMatrix2d() [5/9]

◆ GfMatrix2d() [6/9]

◆ GfMatrix2d() [7/9]

◆ GfMatrix2d() [8/9]

◆ GfMatrix2d() [9/9]

Member Function Documentation

◆ data() [1/2]

◆ data() [2/2]

◆ Get()

◆ GetArray() [1/2]

◆ GetArray() [2/2]

◆ GetColumn()

◆ GetDeterminant()

◆ GetInverse()

◆ GetRow()

◆ GetTranspose()

◆ operator !=() [1/2]

◆ operator !=() [2/2]

◆ operator *=() [1/2]

◆ operator *=() [2/2]

◆ operator -=()

◆ operator []() [1/2]

◆ operator []() [2/2]

◆ operator+=()

◆ operator==() [1/2]

◆ operator==() [2/2]

◆ Set() [1/2]

◆ Set() [2/2]

◆ SetColumn()

◆ SetDiagonal() [1/2]

◆ SetDiagonal() [2/2]

◆ SetIdentity()

◆ SetRow()

◆ SetZero()

Friends And Related Function Documentation

◆ hash_value

◆ operator * [1/6]

◆ operator * [2/6]

◆ operator * [3/6]

◆ operator * [4/6]

◆ operator * [5/6]

◆ operator * [6/6]

◆ operator - [1/2]

◆ operator - [2/2]

◆ operator+

◆ operator/