Home | Download | Screen shots | Discussion | Documentation |
---|
Matrices are stored in row-major order.
Public Member Functions | |
mat4f () throw () | |
Construct. | |
mat4f (float f11, float f12, float f13, float f14, float f21, float f22, float f23, float f24, float f31, float f32, float f33, float f34, float f41, float f42, float f43, float f44) throw () | |
Construct mat4f with given 16 elements in row-major order. | |
mat4f (const float mat[16]) throw () | |
Construct from an array of 16 values. | |
mat4f (const float(&mat)[4][4]) throw () | |
Construct from a 4x4 array. | |
mat4f & | operator *= (float scalar) throw () |
Multiply by a scalar. | |
mat4f & | operator *= (const mat4f &mat) throw () |
Multiply by another matrix. | |
float(& | operator[] (const size_t index) throw())[4] |
Row access. | |
const float(& | operator[] (const size_t index) const throw())[4] |
void | transformation (vec3f &t, openvrml::rotation &r, vec3f &s) const throw () |
Get the translation, rotation and scale from the orthogonal transformation matrix. | |
void | transformation (vec3f &t, openvrml::rotation &r, vec3f &s, vec3f &shear) const throw () |
Get the translation, rotation, scale and shear from affine transformation matrix. | |
const mat4f | inverse () const throw () |
Get the inverse of an affine matrix. | |
const mat4f | transpose () const throw () |
Get the transposition of the matrix. | |
float | det () const throw () |
Determinant. | |
Static Public Member Functions | |
static const mat4f | rotation (const openvrml::rotation &rot) throw () |
Create a rotation matrix. | |
static const mat4f | rotation (const quatf &quat) throw () |
Create a rotation matrix. | |
static const mat4f | scale (float s) throw () |
Create a uniform scale matrix. | |
static const mat4f | scale (const vec3f &s) throw () |
Create a scale matrix. | |
static const mat4f | translation (const vec3f &t) throw () |
Create a translation matrix. | |
static const mat4f | transformation (const vec3f &t, const openvrml::rotation &r, const vec3f &s, const openvrml::rotation &sr, const vec3f &c) throw () |
Create a transformation matrix from a translation, a rotation, a scale, a scaleOrientation, and a center. | |
Private Attributes | |
float | mat [4][4] |
4x4 float matrix. | |
Related Functions | |
(Note that these are not member functions.) | |
const mat4f | operator * (const mat4f &mat, const float scalar) throw() |
Multiply a matrix by a scalar value. | |
const mat4f | operator * (const float scalar, const mat4f &mat) throw() |
Multiply a scalar value by matrix. | |
const mat4f | operator * (const mat4f &lhs, const mat4f &rhs) throw() |
Multiply two matrices. | |
std::ostream & | operator<< (std::ostream &out, const mat4f &mat) |
Stream output. | |
bool | operator== (const mat4f &lhs, const mat4f &rhs) throw() |
Equality comparison operator. | |
bool | operator!= (const mat4f &lhs, const mat4f &rhs) throw() |
Inequality comparison operator. |
openvrml::mat4f::mat4f | ( | ) | throw () |
Construct.
Matrix is initialized to the identity matrix.
openvrml::mat4f::mat4f | ( | float | f11, | |
float | f12, | |||
float | f13, | |||
float | f14, | |||
float | f21, | |||
float | f22, | |||
float | f23, | |||
float | f24, | |||
float | f31, | |||
float | f32, | |||
float | f33, | |||
float | f34, | |||
float | f41, | |||
float | f42, | |||
float | f43, | |||
float | f44 | |||
) | throw () |
Construct mat4f with given 16 elements in row-major order.
f11 | ||
f12 | ||
f13 | ||
f14 | ||
f21 | ||
f22 | ||
f23 | ||
f24 | ||
f31 | ||
f32 | ||
f33 | ||
f34 | ||
f41 | ||
f42 | ||
f43 | ||
f44 |
openvrml::mat4f::mat4f | ( | const float | mat[16] | ) | throw () [explicit] |
Construct from an array of 16 values.
mat | an array of values in row-major order. |
openvrml::mat4f::mat4f | ( | const float & | mat[4][4] | ) | throw () [explicit] |
Construct from a 4x4 array.
mat | a 4x4 array of elements in row-major order. |
const mat4f openvrml::mat4f::rotation | ( | const openvrml::rotation & | rot | ) | throw () [static] |
const mat4f openvrml::mat4f::scale | ( | float | s | ) | throw () [static] |
Create a uniform scale matrix.
s | scale factor. |
Create a scale matrix.
s | a vector. |
Create a translation matrix.
t | translation vector. |
const mat4f openvrml::mat4f::transformation | ( | const vec3f & | t, | |
const openvrml::rotation & | r, | |||
const vec3f & | s, | |||
const openvrml::rotation & | sr, | |||
const vec3f & | c | |||
) | throw () [static] |
mat4f & openvrml::mat4f::operator *= | ( | float | scalar | ) | throw () |
Multiply by a scalar.
scalar | value by which to multiply. |
Multiply by another matrix.
Sets the matrix equal to the matrix multiplied by mat
.
mat | the matrix by which to multiply. |
const float(& openvrml::mat4f::operator[] | ( | const size_t | index | ) | )[4] [inline] |
Row access.
index | row index. |
index
. void openvrml::mat4f::transformation | ( | vec3f & | t, | |
openvrml::rotation & | r, | |||
vec3f & | s | |||
) | const throw () |
Get the translation, rotation and scale from the orthogonal transformation matrix.
Here any projection or shear information in the matrix is ignored. The caller is responsible for assuring that the transformation is in fact orthogonal, otherwise the results are undefined.
t | translation. | |
r | rotation. | |
s | scale. |
void openvrml::mat4f::transformation | ( | vec3f & | t, | |
openvrml::rotation & | r, | |||
vec3f & | s, | |||
vec3f & | shear | |||
) | const throw () |
Get the translation, rotation, scale and shear from affine transformation matrix.
Here any projection information in matrix is ignored. As VRML allows non-uniform scaling, it is safe to call this routine. The caller is responsible for assuring that the transformation is in fact affine, otherwise the results are undefined.
t | translation. | |
r | rotation. | |
s | scale. | |
shear | shear. |
const mat4f openvrml::mat4f::inverse | ( | ) | const throw () |
Get the inverse of an affine matrix.
const mat4f openvrml::mat4f::transpose | ( | ) | const throw () |
Get the transposition of the matrix.
float openvrml::mat4f::det | ( | ) | const throw () |
Determinant.
Multiply a matrix by a scalar value.
mat | matrix. | |
scalar | scalar. |
Multiply a scalar value by matrix.
scalar | scalar. | |
mat | matrix. |
Multiply two matrices.
lhs | left-hand operand. | |
rhs | right-hand operand. |
std::ostream & operator<< | ( | std::ostream & | out, | |
const mat4f & | mat | |||
) | [related] |
Stream output.
out | an output stream. | |
mat | a matrix. |
out
. Equality comparison operator.
All componenents must match exactly.
lhs | a matrix. | |
rhs | a matrix. |
true
if lhs
and rhs
are equivalent; false
otherwise. Inequality comparison operator.
lhs | a matrix. | |
rhs | a matrix. |
true
if lhs
and rhs
are not equivalent; false
otherwise.
float openvrml::mat4f::mat[4][4] [private] |
4x4 float matrix.
For internal use only.