Quick Links: ROOT Homepage Class Index Class Hierarchy

Source: header file source file viewVC header viewVC source

Sections: class description function members data members class charts

class TGLMatrix


TGLMatrix

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.

Function Members (Methods)

public:

	TGLMatrix()
	TGLMatrix(const TGLVertex3& translation)
	TGLMatrix(const Double_t* vals)
	TGLMatrix(const TGLMatrix& other)
	TGLMatrix(const TGLVertex3& origin, const TGLVector3& zAxis)
	TGLMatrix(Double_t x, Double_t y, Double_t z)
	TGLMatrix(const TGLVertex3& origin, const TGLVector3& zAxis, const TGLVector3& xAxis)
virtual	~TGLMatrix()
Double_t*	Arr()
const Double_t*	CArr() const
static TClass*	Class()
void	Dump() const
TGLVector3	GetBaseVec(Int_t b) const
void	GetBaseVec(Int_t b, TGLVector3& v) const
void	GetBaseVec(Int_t b, Double_t* x) const
TGLVector3	GetScale() const
TGLVector3	GetTranslation() const
Double_t	Invert()
virtual TClass*	IsA() const
Bool_t	IsScalingForRender() const
void	Move3LF(Double_t x, Double_t y, Double_t z)
void	MoveLF(Int_t ai, Double_t amount)
TGLVector3	Multiply(const TGLVector3& v, Double_t w = 1) const
void	MultiplyIP(TGLVector3& v, Double_t w = 1) const
void	MultLeft(const TGLMatrix& lhs)
void	MultRight(const TGLMatrix& rhs)
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
void	Rotate(const TGLVertex3& pivot, const TGLVector3& axis, Double_t angle)
void	RotateIP(TGLVector3& v) const
void	RotateLF(Int_t i1, Int_t i2, Double_t amount)
void	RotatePF(Int_t i1, Int_t i2, Double_t amount)
void	Scale(const TGLVector3& scale)
void	Set(const Double_t* vals)
void	Set(const TGLVertex3& origin, const TGLVector3& zAxis, const TGLVector3& xAxis = 0)
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()
void	SetTranslation(const TGLVertex3& translation)
void	SetTranslation(Double_t x, Double_t y, Double_t z)
virtual void	ShowMembers(TMemberInspector&)
virtual void	Streamer(TBuffer&)
void	StreamerNVirtual(TBuffer& ClassDef_StreamerNVirtual_b)
void	TransformVertex(TGLVertex3& vertex) const
void	Translate(const TGLVector3& vect)
void	Transpose3x3()

private:

Bool_t

ValidIndex(UInt_t index) const

Data Members

private:

Double_t	fVals[16]	Column MAJOR as per OGL

Class Charts

Inheritance Inherited Members Includes Libraries

Function documentation

TGLMatrix()

 Construct default identity matrix:

 1 0 0 0
 0 1 0 0
 0 0 1 0
 0 0 0 1

TGLMatrix(Double_t x, Double_t y, Double_t z)

 Construct matrix with translation components x,y,z:

 1 0 0 x
 0 1 0 y
 0 0 1 z
 0 0 0 1

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

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

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

TGLMatrix(const Double_t vals[16])

 Construct matrix using the 16 Double_t 'vals' passed,
 ordering is maintained - i.e. should be column major
 as we are

TGLMatrix(const TGLMatrix& other)

 Construct matrix from 'other'

~TGLMatrix()

 Destroy matirx object

void MultRight(const TGLMatrix& rhs)

 Multiply with matrix rhs on right.

void MultLeft(const TGLMatrix& lhs)

 Multiply with matrix lhs on left.

void Set(const TGLVertex3& origin, const TGLVector3& zAxis, const TGLVector3& xAxis = 0)

 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

void Set(const Double_t* vals)

 Set matrix using the 16 Double_t 'vals' passed,
 ordering is maintained - i.e. should be column major.

void SetIdentity()

 Set matrix to identity.

void SetTranslation(Double_t x, Double_t y, Double_t z)

 Set matrix translation components x,y,z.

void SetTranslation(const TGLVertex3& translation)

 Set matrix translation components x,y,z.

TGLVector3 GetTranslation() const

 Return the translation component of matrix.

void Translate(const TGLVector3& vect)

 Shift matrix translation components by 'vect' in parent frame.

void MoveLF(Int_t ai, Double_t amount)

 Translate in local frame.
 i1, i2 are axes indices: 1 ~ x, 2 ~ y, 3 ~ z.

void Move3LF(Double_t x, Double_t y, Double_t z)

 Translate in local frame along all base vectors simultaneously.

void 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

void Rotate(const TGLVertex3& pivot, const TGLVector3& axis, Double_t angle)

 Update martix 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 RotateLF(Int_t i1, Int_t i2, Double_t amount)

 Rotate in local frame. Does optimised version of MultRight.
 i1, i2 are axes indices: 1 ~ x, 2 ~ y, 3 ~ z.

void RotatePF(Int_t i1, Int_t i2, Double_t amount)

 Rotate in parent frame. Does optimised version of MultLeft.

void TransformVertex(TGLVertex3& vertex) const

 Transform passed 'vertex' by this matrix - converts local frame to parent

void Transpose3x3()

 Transpose the top left 3x3 matrix component along major diagonal
 Supported as currently incompatability between TGeo and GL matrix
 layouts for this 3x3 only. To be resolved.

Double_t Invert()

 Invert the matrix, returns determinant.
 Copied from TMatrixFCramerInv.

TGLVector3 Multiply(const TGLVector3& v, Double_t w = 1) const

 Multiply vector.

TGLVector3 Rotate(const TGLVector3& v) const

 Rotate vector. Translation is not applied.

void MultiplyIP(TGLVector3& v, Double_t w = 1) const

 Multiply vector in-place.

void RotateIP(TGLVector3& v) const

 Rotate vector in-place. Translation is not applied.

TGLVector3 GetScale() const

 Get local axis scaling factors

Bool_t IsScalingForRender() const

 Return true if matrix is to be considered a scaling matrix
 for rendering.

void 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

void SetBaseVec(Int_t b, Double_t x, Double_t y, Double_t z)

void SetBaseVec(Int_t b, const TGLVector3& v)

void SetBaseVec(Int_t b, Double_t* x)

TGLVector3 GetBaseVec(Int_t b) const

void GetBaseVec(Int_t b, TGLVector3& v) const

void GetBaseVec(Int_t b, Double_t* x) const

Bool_t ValidIndex(UInt_t index) const

 Fields

{ return (index < 3); }

const Double_t * CArr() const

{ return fVals; }

Double_t * Arr()

{ return fVals; }

TGLMatrix & operator*=(const TGLMatrix& rhs)

{ MultRight(rhs); return *this; }

TGLColor& operator=(const TGLMatrix& rhs)