16 component (4x4) transform matrix - column MAJOR as per GL.
Provides limited support for adjusting the translation, scale and rotation components.
This is part of collection of simple utility classes for GL only in TGLUtil.h/cxx. These provide const and non-const accessors Arr() & CArr() to a GL compatible internal field - so can be used directly with OpenGL C API calls - which TVector3 etc cannot (easily). They are not intended to be fully featured just provide minimum required.
Public Member Functions | |
TGLMatrix () | |
Construct default identity matrix: | |
TGLMatrix (const Double_t vals[16]) | |
Construct matrix using the 16 Double_t 'vals' passed, ordering is maintained - i.e. | |
TGLMatrix (const TGLMatrix &other) | |
Construct matrix from 'other'. | |
TGLMatrix (const TGLVertex3 &origin, const TGLVector3 &zAxis) | |
Construct matrix which when applied puts local origin at 'origin' and the local Z axis in direction 'z'. | |
TGLMatrix (const TGLVertex3 &origin, const TGLVector3 &zAxis, const TGLVector3 &xAxis) | |
Construct matrix which when applied puts local origin at 'origin' and the local Z axis in direction 'z'. | |
TGLMatrix (const TGLVertex3 &translation) | |
Construct matrix with translation components x,y,z: | |
TGLMatrix (Double_t x, Double_t y, Double_t z) | |
Construct matrix with translation components x,y,z: | |
virtual | ~TGLMatrix () |
Destroy matrix object. | |
Double_t * | Arr () |
const Double_t * | CArr () const |
void | Dump () const |
Output 16 matrix components to std::cout. | |
TGLVector3 | GetBaseVec (Int_t b) const |
void | GetBaseVec (Int_t b, Double_t *x) const |
void | GetBaseVec (Int_t b, TGLVector3 &v) const |
TGLVector3 | GetScale () const |
Get local axis scaling factors. | |
TGLVector3 | GetTranslation () const |
Return the translation component of matrix. | |
Double_t | Invert () |
Invert the matrix, returns determinant. | |
virtual TClass * | IsA () const |
Bool_t | IsScalingForRender () const |
Return true if matrix is to be considered a scaling matrix for rendering. | |
void | Move3LF (Double_t x, Double_t y, Double_t z) |
Translate in local frame along all base vectors simultaneously. | |
void | MoveLF (Int_t ai, Double_t amount) |
Translate in local frame. | |
TGLVector3 | Multiply (const TGLVector3 &v, Double_t w=1) const |
Multiply vector. | |
void | MultiplyIP (TGLVector3 &v, Double_t w=1) const |
Multiply vector in-place. | |
void | MultLeft (const TGLMatrix &lhs) |
Multiply with matrix lhs on left. | |
void | MultRight (const TGLMatrix &rhs) |
Multiply with matrix rhs on right. | |
TGLMatrix & | operator*= (const TGLMatrix &rhs) |
TGLMatrix & | operator= (const TGLMatrix &rhs) |
Double_t & | operator[] (Int_t index) |
Double_t | operator[] (Int_t index) const |
TGLVector3 | Rotate (const TGLVector3 &v) const |
Rotate vector. Translation is not applied. | |
void | Rotate (const TGLVertex3 &pivot, const TGLVector3 &axis, Double_t angle) |
Update matrix so resulting transform has been rotated about 'pivot' (in parent frame), round vector 'axis', through 'angle' (radians) Equivalent to glRotate function, but with addition of translation and compounded on top of existing. | |
void | RotateIP (TGLVector3 &v) const |
Rotate vector in-place. Translation is not applied. | |
void | RotateLF (Int_t i1, Int_t i2, Double_t amount) |
Rotate in local frame. | |
void | RotatePF (Int_t i1, Int_t i2, Double_t amount) |
Rotate in parent frame. Does optimised version of MultLeft. | |
void | Scale (const TGLVector3 &scale) |
Set matrix axis scales to 'scale'. | |
void | Set (const Double_t vals[16]) |
Set matrix using the 16 Double_t 'vals' passed, ordering is maintained - i.e. | |
void | Set (const TGLVertex3 &origin, const TGLVector3 &zAxis, const TGLVector3 &xAxis=nullptr) |
Set matrix which when applied puts local origin at 'origin' and the local Z axis in direction 'z'. | |
void | SetBaseVec (Int_t b, const TGLVector3 &v) |
void | SetBaseVec (Int_t b, Double_t *x) |
void | SetBaseVec (Int_t b, Double_t x, Double_t y, Double_t z) |
void | SetIdentity () |
Set matrix to identity. | |
void | SetTranslation (const TGLVertex3 &translation) |
Set matrix translation components x,y,z. | |
void | SetTranslation (Double_t x, Double_t y, Double_t z) |
Set matrix translation components x,y,z. | |
virtual void | Streamer (TBuffer &) |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
void | TransformVertex (TGLVertex3 &vertex) const |
Transform passed 'vertex' by this matrix - converts local frame to parent. | |
void | Translate (const TGLVector3 &vect) |
Shift matrix translation components by 'vect' in parent frame. | |
void | Transpose3x3 () |
Transpose the top left 3x3 matrix component along major diagonal Supported as currently incompatibility between TGeo and GL matrix layouts for this 3x3 only. | |
Static Public Member Functions | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
Private Member Functions | |
Bool_t | ValidIndex (UInt_t index) const |
Private Attributes | |
Double_t | fVals [16] |
#include <TGLUtil.h>
TGLMatrix::TGLMatrix | ( | ) |
Construct default identity matrix:
1 0 0 0 0 1 0 0 0 0 1 0 0 0 0 1
Definition at line 600 of file TGLUtil.cxx.
Construct matrix with translation components x,y,z:
1 0 0 x 0 1 0 y 0 0 1 z 0 0 0 1
Definition at line 613 of file TGLUtil.cxx.
TGLMatrix::TGLMatrix | ( | const TGLVertex3 & | translation | ) |
Construct matrix with translation components x,y,z:
1 0 0 translation.X() 0 1 0 translation.Y() 0 0 1 translation.Z() 0 0 0 1
Definition at line 627 of file TGLUtil.cxx.
TGLMatrix::TGLMatrix | ( | const TGLVertex3 & | origin, |
const TGLVector3 & | zAxis, | ||
const TGLVector3 & | xAxis ) |
Construct matrix which when applied puts local origin at 'origin' and the local Z axis in direction 'z'.
Both 'origin' and 'zAxisVec' are expressed in the parent frame
Definition at line 662 of file TGLUtil.cxx.
TGLMatrix::TGLMatrix | ( | const TGLVertex3 & | origin, |
const TGLVector3 & | zAxis ) |
Construct matrix which when applied puts local origin at 'origin' and the local Z axis in direction 'z'.
Both 'origin' and 'zAxisVec' are expressed in the parent frame
Definition at line 638 of file TGLUtil.cxx.
Construct matrix using the 16 Double_t 'vals' passed, ordering is maintained - i.e.
should be column major as we are
Definition at line 673 of file TGLUtil.cxx.
Construct matrix from 'other'.
Definition at line 681 of file TGLUtil.cxx.
|
virtual |
Destroy matrix object.
Definition at line 689 of file TGLUtil.cxx.
void TGLMatrix::Dump | ( | ) | const |
Output 16 matrix components to std::cout.
0 4 8 12 1 5 9 13 2 6 10 14 3 7 11 15
Definition at line 1126 of file TGLUtil.cxx.
|
inline |
|
inline |
TGLVector3 TGLMatrix::GetScale | ( | ) | const |
Get local axis scaling factors.
Definition at line 1093 of file TGLUtil.cxx.
TGLVector3 TGLMatrix::GetTranslation | ( | ) | const |
Return the translation component of matrix.
Definition at line 788 of file TGLUtil.cxx.
Double_t TGLMatrix::Invert | ( | ) |
Invert the matrix, returns determinant.
Copied from TMatrixFCramerInv.
Definition at line 965 of file TGLUtil.cxx.
Bool_t TGLMatrix::IsScalingForRender | ( | ) | const |
Return true if matrix is to be considered a scaling matrix for rendering.
Definition at line 1105 of file TGLUtil.cxx.
Translate in local frame along all base vectors simultaneously.
Definition at line 816 of file TGLUtil.cxx.
Translate in local frame.
i1, i2 are axes indices: 1 ~ x, 2 ~ y, 3 ~ z.
Definition at line 807 of file TGLUtil.cxx.
TGLVector3 TGLMatrix::Multiply | ( | const TGLVector3 & | v, |
Double_t | w = 1 ) const |
Multiply vector.
Definition at line 1043 of file TGLUtil.cxx.
void TGLMatrix::MultiplyIP | ( | TGLVector3 & | v, |
Double_t | w = 1 ) const |
Multiply vector in-place.
Definition at line 1069 of file TGLUtil.cxx.
Multiply with matrix lhs on left.
Definition at line 712 of file TGLUtil.cxx.
Multiply with matrix rhs on right.
Definition at line 696 of file TGLUtil.cxx.
TGLVector3 TGLMatrix::Rotate | ( | const TGLVector3 & | v | ) | const |
Rotate vector. Translation is not applied.
Definition at line 1056 of file TGLUtil.cxx.
void TGLMatrix::Rotate | ( | const TGLVertex3 & | pivot, |
const TGLVector3 & | axis, | ||
Double_t | angle ) |
Update matrix so resulting transform has been rotated about 'pivot' (in parent frame), round vector 'axis', through 'angle' (radians) Equivalent to glRotate function, but with addition of translation and compounded on top of existing.
Definition at line 864 of file TGLUtil.cxx.
void TGLMatrix::RotateIP | ( | TGLVector3 & | v | ) | const |
Rotate vector in-place. Translation is not applied.
Definition at line 1081 of file TGLUtil.cxx.
Rotate in local frame.
Does optimised version of MultRight. i1, i2 are axes indices: 1 ~ x, 2 ~ y, 3 ~ z.
Definition at line 891 of file TGLUtil.cxx.
Rotate in parent frame. Does optimised version of MultLeft.
Definition at line 908 of file TGLUtil.cxx.
void TGLMatrix::Scale | ( | const TGLVector3 & | scale | ) |
Set matrix axis scales to 'scale'.
Note - this really sets the overall (total) scaling for each axis - it does NOT apply compounded scale on top of existing one
Definition at line 828 of file TGLUtil.cxx.
Set matrix using the 16 Double_t 'vals' passed, ordering is maintained - i.e.
should be column major.
Definition at line 749 of file TGLUtil.cxx.
void TGLMatrix::Set | ( | const TGLVertex3 & | origin, |
const TGLVector3 & | zAxis, | ||
const TGLVector3 & | xAxis = nullptr ) |
Set matrix which when applied puts local origin at 'origin' and the local Z axis in direction 'z'.
Both 'origin' and 'z' are expressed in the parent frame
Definition at line 730 of file TGLUtil.cxx.
|
inline |
void TGLMatrix::SetIdentity | ( | ) |
Set matrix to identity.
Definition at line 759 of file TGLUtil.cxx.
void TGLMatrix::SetTranslation | ( | const TGLVertex3 & | translation | ) |
Set matrix translation components x,y,z.
Definition at line 778 of file TGLUtil.cxx.
Set matrix translation components x,y,z.
Definition at line 770 of file TGLUtil.cxx.
|
inline |
void TGLMatrix::TransformVertex | ( | TGLVertex3 & | vertex | ) | const |
Transform passed 'vertex' by this matrix - converts local frame to parent.
Definition at line 927 of file TGLUtil.cxx.
void TGLMatrix::Translate | ( | const TGLVector3 & | vect | ) |
Shift matrix translation components by 'vect' in parent frame.
Definition at line 796 of file TGLUtil.cxx.
void TGLMatrix::Transpose3x3 | ( | ) |
Transpose the top left 3x3 matrix component along major diagonal Supported as currently incompatibility between TGeo and GL matrix layouts for this 3x3 only.
To be resolved.
Definition at line 941 of file TGLUtil.cxx.