SoGLMultiTextureMatrixElement(3)

🌸 NAME 🌸

SoGLMultiTextureMatrixElement — okay so the SoGLMultiTextureMatrixElement class is used to update the OpenGL texture matrix. That's the whole vibe. It lives in the Coin manual, section 3, bestie. 💖

---

✨ SYNOPSIS ✨

#include <Inventor/elements/SoGLMultiTextureMatrixElement.h>

Inherits SoMultiTextureMatrixElement. Yes she's got a whole family tree, we'll get to it. 🌳

🎀 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.

Okay now the tea ☕ — and this part is important, bestie. Since (for some <em>weird</em> 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. Nope. Not doing it. 🙈 That's just how it is, no cap.

---

🧚 Constructor & Destructor Documentation 🧚

SoGLMultiTextureMatrixElement::~SoGLMultiTextureMatrixElement (void )

[protected], [virtual]

Destructor. She's leaving, say bye 💅

---

🎀 Member Function Documentation 🎀

SoType SoGLMultiTextureMatrixElement::getClassTypeId (void ) [static]

This static method returns the SoType object associated with objects of this class. It's giving "who am I, really" energy. ⭐

int SoGLMultiTextureMatrixElement::getClassStackIndex (void ) [static]

This static method returns the state stack index for the class. Your lil' seat number in the stack, fr fr. 🪑

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. So like… don't stress about it bestie, it's not for you. 🙈

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. Gotta set up the whole group chat before anyone can talk. 💬✨

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. First one to show up turns the lights on. 🌟

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. Math but make it cute. 🧮💖

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. No multiplying, just vibes — it's a full replacement, periodt. 💅

Reimplemented from SoMultiTextureMatrixElement.

---

🌈 Author 🌈

Generated automatically by Doxygen for Coin from the source code. 🤖 (the robots did the typing, we did the slaying)

---

And that's the whole page bestie!! 💖✨ This was Coin version 4.0.10, dated Thu Jun 25 2026 — so like, bookmark it, screenshot it, tell your friends, iykyk. 🦋💜 Byeeee 🫶