SoMaterialBundle(3)

💖 SoMaterialBundle 💖

okay bestie, so this is a page from the Coin manual, section 3 (that's library functions, iykyk), and it's all about a class called SoMaterialBundle. Its whole entire job? Making material handling not a whole nightmare. ✨

---

🌸 NAME 🌸

SoMaterialBundle — the class that simplifies material handling. that's it. that's the vibe. 🎀

---

🦋 SYNOPSIS 🦋

#include <Inventor/bundles/SoMaterialBundle.h>

Inherits SoBundle. yes she's a nepo baby, but a useful one. 💅

✨ 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 — the state of the current action. that's the whole description, she's mysterious like that. 💜

---

👑 Detailed Description 👑

SoMaterialBundle simplifies material handling. (say it with me now, bestie, the class simplifies material handling. we love a consistent queen.)

so here's the actual tea: every shape node should create (on the stack) an instance of this class and call sendFirst() before sending literally anything to GL. stack-allocated, no new, we're not doing memory leaks in this house. 🙈

then, during rendering, send() should be used to send material values to GL.

periodt. that's the workflow. ✨

---

💅 Constructor & Destructor Documentation 💅

🎀 SoMaterialBundle::SoMaterialBundle (SoAction * action)

Constructor, with action being the action applied to the geometry node. so like, hand her the action and she knows what to do. main character energy. 👑

🎀 SoMaterialBundle::~SoMaterialBundle ()

Destructor. she cleans up after herself. iconic behaviour. 🧹✨

---

🔥 Member Function Documentation 🔥

💖 void SoMaterialBundle::setUpMultiple (void )

Currently not in use. It is only provided for OIV compliance.

ngl she's just here for the paperwork bestie. sitting pretty, doing nothing, still invited to the function. 😭

💖 void SoMaterialBundle::sendFirst (void )

Sends the initial material values to GL. Must be done once in all geometry nodes before the rendering begins.

Must. Not "should", not "maybe if you feel like it". Once, in all geometry nodes, before rendering starts. do not skip this step, she WILL notice. ⭐

💖 void SoMaterialBundle::forceSend (const int index)

Will send the material to GL even though index equals the current index.

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

lowkey she's an override button — normally if the index already matches she'd stay quiet, but forceSend says "no babe, we're sending it anyway." provided for SGI Open Inventor v2.1 compat, so it's giving legacy-support realness. 🦋

💖 SbBool SoMaterialBundle::isColorOnly (void ) const

Returns TRUE if the current light model is BASE_COLOR.

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

Sends material values with index index to GL. Will test whether the current index equals index before sending.

betweenbeginend should be TRUE if your program is between a glBegin() and glEnd() (it is illegal to change the polygon stipple between a glBegin() and glEnd()).

⚠️ bestie, read that again: it is illegal to change the polygon stipple between a glBegin() and a glEnd(). that's not a vibe check you want to fail. set betweenbeginend to TRUE when you're in there. 🙈

---

🌈 Author 🌈

Generated automatically by Doxygen for Coin from the source code.

(yes girl, a robot wrote the author line. we don't gatekeep, we appreciate. 🫶)

---

aaaand that's the whole page, no cap. this was Coin version 4.0.10, dated Thu Jun 25 2026 00:00:00, and it lives in section 3 as SoMaterialBundle(3). go forth and bundle your materials responsibly. mwah. 💖✨🎀🦋