Coin Logo Coin3D is Free Software,
published under the BSD 3-clause license.
https://coin3d.github.io
https://www.kongsberg.com/en/kogt/
SoGLMultiTextureMatrixElement Class Reference

The SoGLMultiTextureMatrixElement class is used to update the OpenGL texture matrix. More...

#include <Inventor/elements/SoGLMultiTextureMatrixElement.h>

Inheritance diagram for SoGLMultiTextureMatrixElement:
SoMultiTextureMatrixElement SoAccumulatedElement SoElement

Public Member Functions

virtual void init (SoState *state)
 
virtual void push (SoState *state)
 
virtual void pop (SoState *state, const SoElement *prevTopElement)
 
virtual void multElt (const int unit, const SbMatrix &matrix)
 
virtual void setElt (const int unit, const SbMatrix &matrix)
 
- Public Member Functions inherited from SoAccumulatedElement
virtual SbBool matches (const SoElement *element) const
 
- Public Member Functions inherited from SoElement
const SoType getTypeId (void) const
 
int getStackIndex (void) const
 
void setDepth (const int depth)
 
int getDepth (void) const
 
virtual void print (FILE *file=stdout) const
 
virtual ~SoElement ()
 

Static Public Member Functions

static SoType getClassTypeId (void)
 
static int getClassStackIndex (void)
 
static void * createInstance (void)
 
static void initClass (void)
 
- Static Public Member Functions inherited from SoMultiTextureMatrixElement
static SoType getClassTypeId (void)
 
static int getClassStackIndex (void)
 
static void * createInstance (void)
 
static void initClass (void)
 
static void set (SoState *const state, SoNode *const node, const int unit, const SbMatrix &matrix)
 
static void mult (SoState *const state, SoNode *const node, const int unit, const SbMatrix &matrix)
 
static const SbMatrixget (SoState *const state, const int unit=0)
 
static void makeIdentity (SoState *const state, SoNode *const node, const int unit=0)
 
static void set (SoState *const state, SoNode *const node, const SbMatrix &matrix)
 
static void mult (SoState *const state, SoNode *const node, const SbMatrix &matrix)
 
static void translateBy (SoState *const state, SoNode *const node, const SbVec3f &translation)
 
static void rotateBy (SoState *const state, SoNode *const node, const SbRotation &rotation)
 
static void scaleBy (SoState *const state, SoNode *const node, const SbVec3f &scaleFactor)
 
- Static Public Member Functions inherited from SoAccumulatedElement
static SoType getClassTypeId (void)
 
static int getClassStackIndex (void)
 
static void initClass (void)
 
- Static Public Member Functions inherited from SoElement
static void initClass (void)
 
static SoType getClassTypeId (void)
 
static int getClassStackIndex (void)
 
static void initElements (void)
 
static int getNumStackIndices (void)
 
static SoType getIdFromStackIndex (const int stackIndex)
 

Protected Member Functions

virtual ~SoGLMultiTextureMatrixElement ()
 
- Protected Member Functions inherited from SoMultiTextureMatrixElement
 SoMultiTextureMatrixElement (void)
 
virtual ~SoMultiTextureMatrixElement ()
 
int getNumUnits () const
 
UnitDatagetUnitData (const int unit)
 
const UnitDatagetUnitData (const int unit) const
 
virtual const SbMatrixgetElt (const int unit) const
 
- Protected Member Functions inherited from SoAccumulatedElement
void clearNodeIds (void)
 
void addNodeId (const SoNode *const node)
 
void setNodeId (const SoNode *const node)
 
void copyNodeIds (const SoAccumulatedElement *copyfrom)
 
virtual SoElementcopyMatchInfo (void) const
 
virtual void captureThis (SoState *state) const
 
- Protected Member Functions inherited from SoElement
 SoElement (void)
 
void capture (SoState *const state) const
 
void setTypeId (const SoType typeId)
 
void setStackIndex (const int index)
 
SoElementgetNextInStack (void) const
 
SoElementgetNextFree (void) const
 

Additional Inherited Members

- Static Protected Member Functions inherited from SoElement
static SoElementgetElement (SoState *const state, const int stackIndex)
 
static const SoElementgetConstElement (SoState *const state, const int stackIndex)
 
static int createStackIndex (const SoType id)
 
- Protected Attributes inherited from SoAccumulatedElement
SbList< SbUniqueId > nodeIds
 
- Protected Attributes inherited from SoElement
SoType typeId
 
int stackIndex
 
int depth
 
- Static Protected Attributes inherited from SoElement
static int classStackIndex
 
static SoTypeListstackToType
 

Detailed Description

The SoGLMultiTextureMatrixElement class is used to update the OpenGL texture matrix.

Since (for some weird reason) most OpenGL implementations have a very small texture matrix stack, and since the matrix stack also is broken on many OpenGL implementations, the texture matrix is always loaded into OpenGL. We do not push() and pop() matrices.

Constructor & Destructor Documentation

◆ ~SoGLMultiTextureMatrixElement()

SoGLMultiTextureMatrixElement::~SoGLMultiTextureMatrixElement ( void  )
protectedvirtual

The destructor.

Member Function Documentation

◆ createInstance()

void * SoGLMultiTextureMatrixElement::createInstance ( void  )
static

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

◆ init()

void SoGLMultiTextureMatrixElement::init ( SoState state)
virtual

This function initializes the element type in the given SoState. It is called for the first element of each enabled element type in SoState objects.

Reimplemented from SoMultiTextureMatrixElement.

◆ push()

void SoGLMultiTextureMatrixElement::push ( SoState state)
virtual

This method is called every time a new element is required in one of the stacks. This happens when a writable element is requested, using SoState::getElement() or indirectly SoElement::getElement(), and the depth of the current element is less than the state depth.

Override this method if your element needs to copy data from the previous top of stack. The push() method is called on the new element, and the previous element can be found using SoElement::getNextInStack().

Reimplemented from SoMultiTextureMatrixElement.

◆ pop()

void SoGLMultiTextureMatrixElement::pop ( SoState state,
const SoElement prevTopElement 
)
virtual

This method is called when the state is popped, and the depth of the element is bigger than the current state depth. pop() is called on the new top of stack, and a pointer to the previous top of stack is passed in prevTopElement.

Override this method if you need to copy some state information from the previous top of stack.

Reimplemented from SoElement.

◆ multElt()

void SoGLMultiTextureMatrixElement::multElt ( const int  unit,
const SbMatrix matrix 
)
virtual

virtual method which is called from mult(). Multiplies matrix into element matrix.

Reimplemented from SoMultiTextureMatrixElement.

◆ setElt()

void SoGLMultiTextureMatrixElement::setElt ( const int  unit,
const SbMatrix matrix 
)
virtual

virtual method which is called from set(). Sets matrix into element matrix.

Reimplemented from SoMultiTextureMatrixElement.


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