--- name: "SoGLMultiTextureMatrixElement" section: "3" platform: "linux" package: "coin" version: "1:4.0.10-1" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/SoGLMultiTextureMatrixElement" --- # SoGLMultiTextureMatrixElement(3) The SoGLMultiTextureMatrixElement class is used to update the OpenGL texture matrix. ## NAME SoGLMultiTextureMatrixElement - The **SoGLMultiTextureMatrixElement** class is used to update the OpenGL texture matrix. ## SYNOPSIS \#include \ Inherits **SoMultiTextureMatrixElement**. ### 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 **SbMatrix** & **get** (**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\ **UnitData** & **getUnitData** (const int unit)\ const **UnitData** & **getUnitData** (const int unit) const\ virtual const **SbMatrix** & **getElt** (const int unit) const\ Protected Member Functions inherited from **SoAccumulatedElement** virtual **~SoAccumulatedElement** ()\ void **clearNodeIds** (void)\ void **addNodeId** (const **SoNode** \*const node)\ void **setNodeId** (const **SoNode** \*const node)\ void **copyNodeIds** (const **SoAccumulatedElement** \*copyfrom)\ virtual **SoElement** \* **copyMatchInfo** (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)\ **SoElement** \* **getNextInStack** (void) const\ **SoElement** \* **getNextFree** (void) const\ ### Additional Inherited Members Static Protected Member Functions inherited from **SoElement** static **SoElement** \* **getElement** (**SoState** \*const state, const int **stackIndex**)\ static const **SoElement** \* **getConstElement** (**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 **SoTypeList** \* **stackToType**\ ## 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 (void ) \[protected\], \[virtual\] Destructor. ## Member Function Documentation ### SoType SoGLMultiTextureMatrixElement::getClassTypeId (void ) \[static\] This static method returns the **SoType** object associated with objects of this class. ### int SoGLMultiTextureMatrixElement::getClassStackIndex (void ) \[static\] This static method returns the state stack index for the class. ### 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.*\ Creates a new instance of the class type corresponding to the **SoType** object. ### void SoGLMultiTextureMatrixElement::initClass (void ) \[static\] Initialize relevant common data for all instances, like the type system. ### 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**. ### 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**. ### 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**. ### 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**. ### 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**. ## Author Generated automatically by Doxygen for Coin from the source code.