SoMaterialBundle(3)

✨ SoMaterialBundle ✨

okay bestie, welcome to SoMaterialBundle(3) 💖 this one lives in the Library Functions Manual and it's genuinely such a helpful little class, i'm obsessed.

---

🎀 NAME 🎀

SoMaterialBundle — the class that makes material handling so much simpler. no cap.

---

🦋 SYNOPSIS 🦋

Inherits SoBundle.

💅 Public Member Functions

SoMaterialBundle (SoAction *action)
~SoMaterialBundle ()
void setUpMultiple (void)
void sendFirst (void)
void forceSend (const int index)
SbBool isColorOnly (void) const
void send (const int index, const SbBool betweenbeginend)

🌸 Additional Inherited Members

Protected Member Functions inherited from SoBundle:

SoBundle (SoAction *action)
~SoBundle ()

Protected Attributes inherited from SoBundle:

• SoState * state — literally just the state of the current action, that's it, that's the whole vibe 🫶

---

👑 Detailed Description 👑

SoMaterialBundle simplifies material handling. periodt.

So here's the tea ☕ — every shape node is supposed to create one of these on the stack, and then call sendFirst() before it sends anything at all to GL. that's the rule, bestie, no skipping it. Then while rendering is happening, you use send() to actually push material values over to GL. main character behavior fr fr ✨

---

🧚 Constructor & Destructor Documentation 🧚

SoMaterialBundle::SoMaterialBundle (SoAction * action)

Constructor, where action is the action being applied to the geometry node. iconic. 💖

SoMaterialBundle::~SoMaterialBundle ()

Destructor. bye bestie, thanks for the materials 🌈

---

💜 Member Function Documentation 💜

void SoMaterialBundle::setUpMultiple (void )

Currently not in use. It's only there for OIV compliance. that's it. it's giving "invited but not participating" 😭

void SoMaterialBundle::sendFirst (void )

Sends the initial material values to GL. This must be done once in all geometry nodes before the rendering begins — like, all of them, not just the ones you feel like. 👑

void SoMaterialBundle::forceSend (const int index)

Will send the material to GL even though index equals the current index. yes, even then. stubborn on purpose 💅

Provided for compatibility with the SGI Open Inventor v2.1 API.

SbBool SoMaterialBundle::isColorOnly (void ) const

Returns TRUE if the current light model is BASE_COLOR. that's the whole function, slay. 🔥

void SoMaterialBundle::send (const int index, const SbBool betweenbeginend)

Sends the material values with index index to GL. It will test whether the current index equals index before actually sending. vibe check first, always. ✨

betweenBeginEnd should be TRUE if your program is between a glBegin() and a glEnd().

⚠️ heads up bestie — it is illegal to change the polygon stipple between a glBegin() and a glEnd(). like, do not do it. i'm serious. 💀

---

🌟 Author 🌟

Generated automatically by Doxygen for Coin from the source code. the robots did this one, not me 🫶

---

that's the whole page, bestie!! this gorgeousness is Coin, Version 3.1.3, and it's filed under SoMaterialBundle(3) 💖✨🎀🦋🌸💅