BALL  1.4.79
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
List of all members
BALL::TMatrix4x4< T > Class Template Reference

Default Type. More...

#include <BALL/MATHS/matrix44.h>

Public Member Functions

Constructors and Destructors
 TMatrix4x4 ()
 
 TMatrix4x4 (const T *ptr)
 
 TMatrix4x4 (const T ptr[4][4])
 
 TMatrix4x4 (const TMatrix4x4 &m)
 
 TMatrix4x4 (const TVector4< T > &col1, const TVector4< T > &col2, const TVector4< T > &col3, const TVector4< T > &col4)
 
 TMatrix4x4 (const T &m11, const T &m12, const T &m13, const T &m14, const T &m21, const T &m22, const T &m23, const T &m24, const T &m31, const T &m32, const T &m33, const T &m34, const T &m41, const T &m42, const T &m43, const T &m44)
 
virtual ~TMatrix4x4 ()
 
virtual void clear ()
 
Assignment
void set (const T *ptr)
 
void set (const T ptr[4][4])
 
void set (const TMatrix4x4 &m)
 
void set (const TVector4< T > &col1, const TVector4< T > &col2, const TVector4< T > &col3, const TVector4< T > &col4)
 
void set (const T &m11, const T &m12, const T &m13, const T &m14, const T &m21, const T &m22, const T &m23, const T &m24, const T &m31, const T &m32, const T &m33, const T &m34, const T &m41, const T &m42, const T &m43, const T &m44)
 
TMatrix4x4operator= (const T *ptr)
 
TMatrix4x4operator= (const T ptr[4][4])
 
TMatrix4x4operator= (const TMatrix4x4 &m)
 
void get (T *ptr) const
 
void get (T ptr[4][4]) const
 
void get (TMatrix4x4 &m) const
 
void get (TVector4< T > &col1, TVector4< T > &col2, TVector4< T > &col3, TVector4< T > &col4) const
 
void get (T &m11, T &m12, T &m13, T &m14, T &m21, T &m22, T &m23, T &m24, T &m31, T &m32, T &m33, T &m34, T &m41, T &m42, T &m43, T &m44) const
 
void swap (TMatrix4x4 &m)
 
Predicates
bool operator== (const TMatrix4x4 &m) const
 
bool operator!= (const TMatrix4x4 &m) const
 
bool isIdentity () const
 
bool isRegular () const
 
bool isSingular () const
 
bool isSymmetric () const
 
bool isLowerTriangular () const
 
bool isUpperTriangular () const
 
bool isDiagonal () const
 
Debugging and Diagnostics
bool isValid () const
 
void dump (std::ostream &s=std::cout, Size depth=0) const
 

Public Attributes

Attributes
m11
 1st cell in the 1st row More...
 
m12
 2nd cell in the 1st row More...
 
m13
 3rd cell in the 1st row More...
 
m14
 4th cell in the 1st row More...
 
m21
 1st cell in the 2nd row More...
 
m22
 2nd cell in the 2nd row More...
 
m23
 3rd cell in the 2nd row More...
 
m24
 4th cell in the 2nd row More...
 
m31
 1st cell in the 3rd row More...
 
m32
 2nd cell in the 3rd row More...
 
m33
 3rd cell in the 3rd row More...
 
m34
 4th cell in the 3rd row More...
 
m41
 1st cell in the 4th row More...
 
m42
 2nd cell in the 4th row More...
 
m43
 3rd cell in the 4th row More...
 
m44
 4th cell in the 4th row More...
 

Accessors

getTrace () const
 
void setIdentity ()
 
void set (const T &t=(T) 1)
 
void transpose ()
 
TVector4< T > getRow (Position row) const
 
TVector4< T > getColumn (Position col) const
 
void setRow (Position row, const TVector4< T > &row_value)
 
void setColumn (Position col, const TVector4< T > &col_value)
 
bool isEqual (const TMatrix4x4 &m) const
 
TVector4< T > getDiagonal () const
 
T & operator() (Position row, Position col)
 
const T & operator() (Position row, Position col) const
 
const T & operator[] (Position position) const
 
T & operator[] (Position position)
 
TMatrix4x4 operator+ () const
 
TMatrix4x4 operator- () const
 
TMatrix4x4 operator+ (const TMatrix4x4 &m) const
 
TMatrix4x4operator+= (const TMatrix4x4 &m)
 
TMatrix4x4 operator- (const TMatrix4x4 &m) const
 
TMatrix4x4operator-= (const TMatrix4x4 &m)
 
TMatrix4x4 operator* (const T &scalar) const
 
TMatrix4x4operator*= (const T &scalar)
 
TMatrix4x4 operator/ (const T &scalar) const
 
TMatrix4x4operator/= (const T &scalar)
 
TMatrix4x4 operator* (const TMatrix4x4 &m) const
 
TMatrix4x4operator*= (const TMatrix4x4 &m)
 
TVector4< T > operator* (const TVector4< T > &vector) const
 
bool invert (TMatrix4x4 &inverse) const
 
bool invert ()
 
getDeterminant () const
 
void translate (const T &x, const T &y, const T &z)
 
void translate (const TVector3< T > &v)
 
void setTranslation (const T &x, const T &y, const T &z)
 
void setTranslation (const TVector3< T > &v)
 
void scale (const T &x_scale, const T &y_scale, const T &z_scale)
 
void scale (const T &scale)
 
void scale (const TVector3< T > &v)
 
void setScale (const T &x_scale, const T &y_scale, const T &z_scale)
 
void setScale (const T &scale)
 
void setScale (const TVector3< T > &v)
 
void rotateX (const TAngle< T > &phi)
 
void setRotationX (const TAngle< T > &phi)
 
void rotateY (const TAngle< T > &phi)
 
void setRotationY (const TAngle< T > &phi)
 
void rotateZ (const TAngle< T > &phi)
 
void setRotationZ (const TAngle< T > &phi)
 
void rotate (const TAngle< T > &phi, const T &axis_x, const T &axis_y, const T &axis_z)
 
void rotate (const TAngle< T > &phi, const TVector3< T > &axis)
 
void rotate (const TAngle< T > &phi, const TVector4< T > &axis)
 
void setRotation (const TAngle< T > &phi, const T &axis_x, const T &axis_y, const T &axis_z)
 
void setRotation (const TAngle< T > &phi, const TVector3< T > &axis)
 
void setRotation (const TAngle< T > &phi, const TVector4< T > &axis)
 
static const TMatrix4x4getZero ()
 
static const TMatrix4x4getIdentity ()
 

Detailed Description

template<typename T>
class BALL::TMatrix4x4< T >

Default Type.

Generic 4x4 Matrix Class.

Definition at line 40 of file matrix44.h.

Constructor & Destructor Documentation

template<typename T >
BALL::TMatrix4x4< T >::TMatrix4x4 ( )

Default constructor. This method creates a new TMatrix4x4 object. The components are initialized to 0.

Definition at line 738 of file matrix44.h.

template<typename T>
BALL::TMatrix4x4< T >::TMatrix4x4 ( const T *  ptr)

Array constructor. This constructor creates a TMatrix4x4 object from the first sixteen elements pointed to by ptr.

Parameters
ptrthe array to construct from
Exceptions
NullPointerif ptr == 0

Definition at line 748 of file matrix44.h.

template<typename T>
BALL::TMatrix4x4< T >::TMatrix4x4 ( const T  ptr[4][4])

Array constructor. This constructor creates a TMatrix4x4 object from the sixteen elements in the array assigned by ptr.

Parameters
ptrthe array to construct from
Exceptions
NullPointerif ptr == 0

Definition at line 764 of file matrix44.h.

template<typename T>
BALL::TMatrix4x4< T >::TMatrix4x4 ( const TMatrix4x4< T > &  m)

Copy constructor. Create a new TMatrix4x4 object from another.

Parameters
TMatrix4x4the TMatrix4x4 object to be copied
boolignored (just for interface consistency)

Definition at line 782 of file matrix44.h.

template<typename T>
BALL::TMatrix4x4< T >::TMatrix4x4 ( const TVector4< T > &  col1,
const TVector4< T > &  col2,
const TVector4< T > &  col3,
const TVector4< T > &  col4 
)

Detailed constructor. Create a new TMatrix4x4 object from four TVector4.

Parameters
col1assigned to the first column
col2assigned to the second column
col3assigned to the third column
col4assigned to the fourth column

Definition at line 794 of file matrix44.h.

template<typename T>
BALL::TMatrix4x4< T >::TMatrix4x4 ( const T &  m11,
const T &  m12,
const T &  m13,
const T &  m14,
const T &  m21,
const T &  m22,
const T &  m23,
const T &  m24,
const T &  m31,
const T &  m32,
const T &  m33,
const T &  m34,
const T &  m41,
const T &  m42,
const T &  m43,
const T &  m44 
)

Detailed constructor. Create a new TMatrix4x4 object from sixteen T values.

Parameters
m11- m44 assigned to the components

Definition at line 806 of file matrix44.h.

template<typename T>
virtual BALL::TMatrix4x4< T >::~TMatrix4x4 ( )
inlinevirtual

Destructor. Destructs the TMatrix4x4 object. As there are no dynamic data structures, nothing happens.

Definition at line 136 of file matrix44.h.

Member Function Documentation

template<typename T >
void BALL::TMatrix4x4< T >::clear ( )
virtual

Clear method. The values are set to 0.

Definition at line 819 of file matrix44.h.

template<typename T >
void BALL::TMatrix4x4< T >::dump ( std::ostream &  s = std::cout,
Size  depth = 0 
) const

Internal state dump. Dump the current internal state of {*this} to the output ostream s with dumping depth depth .

Parameters
s- output stream where to output the internal state of {*this}
depth- the dumping depth

Definition at line 2151 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::get ( T *  ptr) const

Assign to an array. Assigns the components to a pointer of an array of sixteen values of type T.

Parameters
ptrthe pointer to assign to
Exceptions
NullPointerif ptr == 0

Definition at line 912 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::get ( ptr[4][4]) const

Assign to an array. Assigns the components to an array of sixteen values of type T.

Parameters
ptrthe array to assign to
Exceptions
NullPointerif ptr == 0

Definition at line 926 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::get ( TMatrix4x4< T > &  m) const

Assign to another instance. Assigns the components to another TMatrix4x4.

Parameters
TMatrix4x4the TMatrix4x4 to be assigned to

Definition at line 942 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::get ( TVector4< T > &  col1,
TVector4< T > &  col2,
TVector4< T > &  col3,
TVector4< T > &  col4 
) const

Assign to four variables of type TVector4 .

Parameters
col1the TVector4 to obtain the values of the first column
col2the TVector4 to obtain the values of the second column
col3the TVector4 to obtain the values of the third column
col4the TVector4 to obtain the values of the fourth column

Definition at line 949 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::get ( T &  m11,
T &  m12,
T &  m13,
T &  m14,
T &  m21,
T &  m22,
T &  m23,
T &  m24,
T &  m31,
T &  m32,
T &  m33,
T &  m34,
T &  m41,
T &  m42,
T &  m43,
T &  m44 
) const

Assign to sixteen variables of type T.

Parameters
m11- m44 the variables to assign to

Definition at line 960 of file matrix44.h.

template<typename T >
TVector4< T > BALL::TMatrix4x4< T >::getColumn ( Position  col) const

Get a column of the matrix.

Parameters
colthe number of the column (0-3)
Returns
TVector4 the column
Exceptions
IndexOverflowif col > 3

Definition at line 1085 of file matrix44.h.

template<typename T >
T BALL::TMatrix4x4< T >::getDeterminant ( ) const

Compute the determinant.

Returns
T the determinant.

Definition at line 1559 of file matrix44.h.

template<typename T >
TVector4< T > BALL::TMatrix4x4< T >::getDiagonal ( ) const

Get the diagonal of the matrix.

Returns
TVector4 the diagonal

Definition at line 1149 of file matrix44.h.

template<typename T >
BALL_INLINE const TMatrix4x4< T > & BALL::TMatrix4x4< T >::getIdentity ( )
static

Create an identity matrix. A new matrix object is created and all elements but the diagonal are set to zero. The diagonal elements are set to 1.

Definition at line 1001 of file matrix44.h.

template<typename T >
TVector4< T > BALL::TMatrix4x4< T >::getRow ( Position  row) const

Get a row of the matrix.

Parameters
rowthe number of the row (0-3)
Returns
TVector4 the row
Exceptions
IndexOverflowif row > 3

Definition at line 1072 of file matrix44.h.

template<typename T >
BALL_INLINE T BALL::TMatrix4x4< T >::getTrace ( ) const

Compute the trace. Get the sum of the diagonal elements (m11 + m22 + m33 + m44).

Returns
T the trace

Definition at line 973 of file matrix44.h.

template<typename T >
BALL_INLINE const TMatrix4x4< T > & BALL::TMatrix4x4< T >::getZero ( )
static

Create a zero matrix. A new matrix object is created and all elements set to 0.

Definition at line 980 of file matrix44.h.

template<typename T >
bool BALL::TMatrix4x4< T >::invert ( TMatrix4x4< T > &  inverse) const

Invert the matrix. Tests if the matrix can be inverted. If possible, the result will be inverted and the result returned in inverse .

Parameters
inverseis assigned the inverse matrix
Returns
bool true if the inverse matrix could be calculated, otherwise false.

First, we compute a QR decomposition, then we use it to solve the system A*A^-1 = I <=> R * A^-1 = Q^t, where R is upper triangular.

This is based on the Householder transform algorithm given in the Numerical Recipes.

Definition at line 1422 of file matrix44.h.

template<typename T >
BALL_INLINE bool BALL::TMatrix4x4< T >::invert ( )

Invert the matrix. Tests if the matrix can be inverted. If this is possible, the result is stored in the matrix.

Returns
bool true if the inverse matrix could be calculated, otherwise false.

Definition at line 1553 of file matrix44.h.

template<typename T >
BALL_INLINE bool BALL::TMatrix4x4< T >::isDiagonal ( ) const

Test whether all cells but the diagonal are zero.

Returns
bool, true or false

Definition at line 2087 of file matrix44.h.

template<typename T >
bool BALL::TMatrix4x4< T >::isEqual ( const TMatrix4x4< T > &  m) const

Test whether two matrices are equal. Two matrices are considered equal, if Maths::isEqual returns true for each pair of corresponding elements.

Parameters
mthe matrix to compare with
Returns
bool, true if all components are equal, false otherwise

Definition at line 1133 of file matrix44.h.

template<typename T >
bool BALL::TMatrix4x4< T >::isIdentity ( ) const

Test whether this matrix is an identity matrix. (I.e. m11, m22, m33, m44 = 1 and the other cells have the value 0)

Returns
bool, true if identity matrix, false otherwise

Definition at line 2020 of file matrix44.h.

template<typename T >
bool BALL::TMatrix4x4< T >::isLowerTriangular ( ) const

Test whether the lower triangular is zero.

Returns
bool, true if (m12 = m13 = m14 = m23 = m24 = m34 = 0), false otherwise

Definition at line 2064 of file matrix44.h.

template<typename T >
BALL_INLINE bool BALL::TMatrix4x4< T >::isRegular ( ) const

Test whether this matrix is regular.

Returns
bool, true if (Determinant != 0), false otherwise

Definition at line 2043 of file matrix44.h.

template<typename T >
BALL_INLINE bool BALL::TMatrix4x4< T >::isSingular ( ) const

Test whether this matrix is singular.

Returns
bool, true if (Determinant == 0), false otherwise

Definition at line 2050 of file matrix44.h.

template<typename T >
bool BALL::TMatrix4x4< T >::isSymmetric ( ) const

Test whether this matrix is symmetric. (m12 = m21, m31 = m13, ...)

Returns
bool, true if symmatric, false otherwise

Definition at line 2056 of file matrix44.h.

template<typename T >
bool BALL::TMatrix4x4< T >::isUpperTriangular ( ) const

Test whether the upper triangular is zero.

Returns
bool, true if (m21 = m31 = m32 = m41 = m42 = m43 = 0), false otherwise

Definition at line 2075 of file matrix44.h.

template<typename T >
bool BALL::TMatrix4x4< T >::isValid ( ) const

Test whether instance is valid. Always returns true.

Returns
bool true

Definition at line 2104 of file matrix44.h.

template<typename T >
bool BALL::TMatrix4x4< T >::operator!= ( const TMatrix4x4< T > &  m) const

Inequality operator. Instead of this operator isEqual should be used. isEqual

Returns
bool, true if the two TMatrix4x4 differ in at least one component, false otherwise

Definition at line 1998 of file matrix44.h.

template<typename T >
BALL_INLINE T & BALL::TMatrix4x4< T >::operator() ( Position  row,
Position  col 
)

Access operator of a cell.

Parameters
rowthe number of the row (0-3)
colthe number of the column (0-3)
Returns
T& a reference to the cell
Exceptions
IndexOverflowif col >3 || row > 3

Definition at line 1156 of file matrix44.h.

template<typename T >
BALL_INLINE const T & BALL::TMatrix4x4< T >::operator() ( Position  row,
Position  col 
) const

Constant access operator of a cell.

Parameters
rowthe number of the row (0-3)
colthe number of the column (0-3)
Returns
T& a const reference to the cell
Exceptions
IndexOverflowif col ||row > 3

Definition at line 1168 of file matrix44.h.

template<typename T>
TMatrix4x4< T > BALL::TMatrix4x4< T >::operator* ( const T &  scalar) const

Multiply by a scalar. Operator for multiplying every cell value with a scalar value.

Returns
TMatrix4x4 the result

Definition at line 1285 of file matrix44.h.

template<typename T>
TMatrix4x4< T > BALL::TMatrix4x4< T >::operator* ( const TMatrix4x4< T > &  m) const

Multiply two matrices.

Returns
TMatrix4x4 the result

Definition at line 1361 of file matrix44.h.

template<typename T>
TVector4< T > BALL::TMatrix4x4< T >::operator* ( const TVector4< T > &  vector) const

Multiplication by an instance of type TVector4 .

Returns
TMatrix4x4&, {*this}

Definition at line 1412 of file matrix44.h.

template<typename T>
TMatrix4x4< T > & BALL::TMatrix4x4< T >::operator*= ( const T &  scalar)

Multiply by a scalar. Operator for multiplying every cell value with a scalar value.

Returns
TMatrix4x4&, {*this}

Definition at line 1305 of file matrix44.h.

template<typename T>
TMatrix4x4< T > & BALL::TMatrix4x4< T >::operator*= ( const TMatrix4x4< T > &  m)

Multiply two matrices

Returns
TMatrix4x4&, {*this}

Definition at line 1386 of file matrix44.h.

template<typename T >
BALL_INLINE TMatrix4x4< T > BALL::TMatrix4x4< T >::operator+ ( ) const

Positive sign.

Definition at line 1202 of file matrix44.h.

template<typename T >
TMatrix4x4< T > BALL::TMatrix4x4< T >::operator+ ( const TMatrix4x4< T > &  m) const

Addition operator. Adds another matrix to this matrix and return the result.

Parameters
mthe matrix to add
Returns
TMatrix4x4 the result

Definition at line 1219 of file matrix44.h.

template<typename T >
TMatrix4x4< T > & BALL::TMatrix4x4< T >::operator+= ( const TMatrix4x4< T > &  m)

Addition operator. Adds another matrix to this matrix.

Parameters
mthe matrix to add
Returns
TMatrix4x4&, {*this}

Definition at line 1229 of file matrix44.h.

template<typename T >
BALL_INLINE TMatrix4x4< T > BALL::TMatrix4x4< T >::operator- ( ) const

Negative sign.

Definition at line 1209 of file matrix44.h.

template<typename T >
TMatrix4x4< T > BALL::TMatrix4x4< T >::operator- ( const TMatrix4x4< T > &  m) const

Subtraction operator. Subtract another matrix from this matrix and return the result

Parameters
mthe matrix to subtract
Returns
TMatrix4x4 the result

Definition at line 1252 of file matrix44.h.

template<typename T >
TMatrix4x4< T > & BALL::TMatrix4x4< T >::operator-= ( const TMatrix4x4< T > &  m)

Subtraction operator. Subtract another matrix from this matrix.

Parameters
mthe matrix to subtract
Returns
TMatrix4x4&, {*this}

Definition at line 1262 of file matrix44.h.

template<typename T>
BALL_INLINE TMatrix4x4< T > BALL::TMatrix4x4< T >::operator/ ( const T &  scalar) const

Divide by a scalar. Operator for dividing every cell value by a scalar value.

Returns
TMatrix4x4 the result
Exceptions
DivisionByZeroif scalar == 0

Definition at line 1338 of file matrix44.h.

template<typename T>
BALL_INLINE TMatrix4x4< T > & BALL::TMatrix4x4< T >::operator/= ( const T &  scalar)

Divide by a scalar. Operator for dividing every cell value by a scalar value.

Returns
TMatrix4x4&, {*this}
Exceptions
DivisionByZeroif scalar == 0

Definition at line 1350 of file matrix44.h.

template<typename T>
BALL_INLINE TMatrix4x4< T > & BALL::TMatrix4x4< T >::operator= ( const T *  ptr)

Assignment operator. Assign the components from the first 16 values assigned by ptr.

Parameters
ptrthe array to construct from
Exceptions
NullPointerif ptr == 0

Definition at line 889 of file matrix44.h.

template<typename T>
BALL_INLINE TMatrix4x4< T > & BALL::TMatrix4x4< T >::operator= ( const T  ptr[4][4])

Assignment operator. Assign the components from the first 16 values assigned by ptr.

Parameters
ptrthe array to construct from
Exceptions
NullPointerif ptr == 0

Definition at line 897 of file matrix44.h.

template<typename T>
BALL_INLINE TMatrix4x4< T > & BALL::TMatrix4x4< T >::operator= ( const TMatrix4x4< T > &  m)

Assignment operator. Assign the components from another instance of TMatrix4x4.

Parameters
TMatrix4x4the TMatrix4x4 to assign from

Definition at line 905 of file matrix44.h.

template<typename T >
bool BALL::TMatrix4x4< T >::operator== ( const TMatrix4x4< T > &  m) const

Equality operator. Instead of this operator isEqual should be used. isEqual

Returns
bool, true if all components are equal, false otherwise

Definition at line 1976 of file matrix44.h.

template<typename T >
BALL_INLINE const T & BALL::TMatrix4x4< T >::operator[] ( Position  position) const

Constant random access operator. Access single elements of the matrix. index may assume values in the range of 0 - 15. The elements of the matrix are returned rows first, i.e., in the following order: m11, m12, m13...

Exceptions
IndexOverflowif position > 15

Definition at line 1180 of file matrix44.h.

template<typename T >
BALL_INLINE T & BALL::TMatrix4x4< T >::operator[] ( Position  position)

Mutable random access operator.

See also
operator[]
Exceptions
IndexOverflowif position > 15

Definition at line 1191 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::rotate ( const TAngle< T > &  phi,
const T &  axis_x,
const T &  axis_y,
const T &  axis_z 
)

Rotate the matrix around a given axis.

Parameters
phithe rotation angle
axis_xthe x component of the axis
axis_ythe y component of the axis
axis_zthe z component of the axis

Definition at line 1887 of file matrix44.h.

template<typename T>
BALL_INLINE void BALL::TMatrix4x4< T >::rotate ( const TAngle< T > &  phi,
const TVector3< T > &  axis 
)

Rotate the matrix around a given axis.

Parameters
phithe rotation angle
axisthe axis vector

Definition at line 1818 of file matrix44.h.

template<typename T>
BALL_INLINE void BALL::TMatrix4x4< T >::rotate ( const TAngle< T > &  phi,
const TVector4< T > &  axis 
)

Rotate the matrix around a given axis.

Parameters
phithe rotation angle
axisthe axis vector, the fourth component of the vector is ignored

Definition at line 1825 of file matrix44.h.

template<typename T>
BALL_INLINE void BALL::TMatrix4x4< T >::rotateX ( const TAngle< T > &  phi)

Rotate the matrix around the x axis.

Parameters
phithe rotation angle

Definition at line 1746 of file matrix44.h.

template<typename T>
BALL_INLINE void BALL::TMatrix4x4< T >::rotateY ( const TAngle< T > &  phi)

Rotate the matrix around the y axis.

Parameters
phithe rotation angle

Definition at line 1771 of file matrix44.h.

template<typename T>
BALL_INLINE void BALL::TMatrix4x4< T >::rotateZ ( const TAngle< T > &  phi)

Rotate the matrix around the z axis.

Parameters
phithe rotation angle

Definition at line 1796 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::scale ( const T &  x_scale,
const T &  y_scale,
const T &  z_scale 
)

Scale the matrix.

Parameters
x_scalethe x scale factor
y_scalethe y scale factor
z_scalethe z scale factor

Definition at line 1646 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::scale ( const T &  scale)

Scale the matrix.

Parameters
scalethe scale factor

Definition at line 1665 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::scale ( const TVector3< T > &  v)

Scale the matrix.

Parameters
vthe vector with the scale factor

Definition at line 1684 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::set ( const T *  ptr)

Assign from array-ptr. Assign from the first sixteen elements pointed to by ptr.

Parameters
ptrthe array to construct from
Exceptions
NullPointerif ptr == 0

Definition at line 825 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::set ( const T  ptr[4][4])

Assign from the first sixteen elements. pointed to by the array assigned by ptr.

Parameters
ptrthe array to construct from
Exceptions
NullPointerif ptr == 0

Definition at line 839 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::set ( const TMatrix4x4< T > &  m)

Assign from another instance.

Parameters
TMatrix4x4the TMatrix4x4 object to assign from

Definition at line 855 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::set ( const TVector4< T > &  col1,
const TVector4< T > &  col2,
const TVector4< T > &  col3,
const TVector4< T > &  col4 
)

Assign from four TVector4.

Parameters
col1assigned to the first column
col2assigned to the second column
col3assigned to the third column
col4assigned to the fourth column

Definition at line 865 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::set ( const T &  m11,
const T &  m12,
const T &  m13,
const T &  m14,
const T &  m21,
const T &  m22,
const T &  m23,
const T &  m24,
const T &  m31,
const T &  m32,
const T &  m33,
const T &  m34,
const T &  m41,
const T &  m42,
const T &  m43,
const T &  m44 
)

Assign from sixteen values of type T.

Parameters
m11- m44 assigned to the components

Definition at line 876 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::set ( const T &  t = (T)1)

Set the diagonal elements to the given value. All other elements are set to 0.

Parameters
Tthe value to fill with (default: 1)

Definition at line 1013 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setColumn ( Position  col,
const TVector4< T > &  col_value 
)

Set a column of the matrix.

Parameters
colthe number of the column (0-3)
col_valuethe new value of the col
Exceptions
IndexOverflowif col > 3

Definition at line 1116 of file matrix44.h.

template<typename T >
BALL_INLINE void BALL::TMatrix4x4< T >::setIdentity ( )

Set to an identity matrix. m11, m22, m33, m44 = 1; the other cells have the value 0;

Definition at line 994 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setRotation ( const TAngle< T > &  phi,
const T &  axis_x,
const T &  axis_y,
const T &  axis_z 
)

Set the matrix to a rotation matrix.

Parameters
phithe rotation angle
axis_xthe x component of the axis
axis_ythe y component of the axis
axis_zthe z component of the axis

Definition at line 1950 of file matrix44.h.

template<typename T>
BALL_INLINE void BALL::TMatrix4x4< T >::setRotation ( const TAngle< T > &  phi,
const TVector3< T > &  axis 
)

Set the matrix to a rotation matrix.

Parameters
phithe rotation angle
axisthe axis vector

Definition at line 1959 of file matrix44.h.

template<typename T>
BALL_INLINE void BALL::TMatrix4x4< T >::setRotation ( const TAngle< T > &  phi,
const TVector4< T > &  axis 
)

Set the matrix to a rotation matrix.

Parameters
phithe rotation angle
axisthe axis vector, the fourth component of the vector is ignored

Definition at line 1968 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setRotationX ( const TAngle< T > &  phi)

Set the matrix to a x rotation matrix.

Parameters
phithe rotation angle

Definition at line 1755 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setRotationY ( const TAngle< T > &  phi)

Set the matrix to a y rotation matrix.

Parameters
phithe rotation angle

Definition at line 1780 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setRotationZ ( const TAngle< T > &  phi)

Set the matrix to a z rotation matrix.

Parameters
phithe rotation angle

Definition at line 1805 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setRow ( Position  row,
const TVector4< T > &  row_value 
)

Set a row of the matrix.

Parameters
rowthe number of the row (0-3)
row_valuethe new value of the row
Exceptions
IndexOverflowif row > 3

Definition at line 1099 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setScale ( const T &  x_scale,
const T &  y_scale,
const T &  z_scale 
)

Set the matrix to a scalation matrix.

Parameters
x_scalethe x scale factor
y_scalethe y scale factor
z_scalethe z scale factor

Definition at line 1703 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setScale ( const T &  scale)

Set the matrix to a scalation matrix.

Parameters
scalethe scale factor

Definition at line 1717 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setScale ( const TVector3< T > &  v)

Set the matrix to a scalation matrix.

Parameters
vthe vector with the scale factor

Definition at line 1731 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setTranslation ( const T &  x,
const T &  y,
const T &  z 
)

Set the matrix to a translation matrix.

Parameters
xthe x-component of the translation
ythe y-component of the translation
zthe z-component of the translation

Definition at line 1616 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::setTranslation ( const TVector3< T > &  v)

Set the matrix to a translation matrix.

Parameters
vthe vector to translate with

Definition at line 1631 of file matrix44.h.

template<typename T >
void BALL::TMatrix4x4< T >::swap ( TMatrix4x4< T > &  m)

Swap the contents of two instances of TMatrix4x4.

Parameters
TMatrix4x4the TMatrix4x4 to swap contents with

Definition at line 1023 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::translate ( const T &  x,
const T &  y,
const T &  z 
)

Translate the matrix.

Parameters
xthe x-component of the translation
ythe y-component of the translation
zthe z-component of the translation

Definition at line 1598 of file matrix44.h.

template<typename T>
void BALL::TMatrix4x4< T >::translate ( const TVector3< T > &  v)

Translate the matrix.

Parameters
vthe vector to translate with

Definition at line 1607 of file matrix44.h.

template<typename T >
void BALL::TMatrix4x4< T >::transpose ( )

Mirror the Matrix at the diagonal. All values are swaped by the mirrored value. (I.e. m12 <=> m21 , m13 <=> m31 , ...)

Definition at line 1044 of file matrix44.h.

Member Data Documentation

template<typename T>
T BALL::TMatrix4x4< T >::m11

1st cell in the 1st row

Definition at line 672 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m12

2nd cell in the 1st row

Definition at line 675 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m13

3rd cell in the 1st row

Definition at line 678 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m14

4th cell in the 1st row

Definition at line 681 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m21

1st cell in the 2nd row

Definition at line 684 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m22

2nd cell in the 2nd row

Definition at line 687 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m23

3rd cell in the 2nd row

Definition at line 690 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m24

4th cell in the 2nd row

Definition at line 693 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m31

1st cell in the 3rd row

Definition at line 696 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m32

2nd cell in the 3rd row

Definition at line 699 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m33

3rd cell in the 3rd row

Definition at line 702 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m34

4th cell in the 3rd row

Definition at line 705 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m41

1st cell in the 4th row

Definition at line 708 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m42

2nd cell in the 4th row

Definition at line 711 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m43

3rd cell in the 4th row

Definition at line 714 of file matrix44.h.

template<typename T>
T BALL::TMatrix4x4< T >::m44

4th cell in the 4th row

Definition at line 717 of file matrix44.h.