SoContextHandler(3)

💖 SoContextHandler(3) 💖

okay bestie, welcome to the Coin manual, section 3 — and today's main character is SoContextHandler. ✨

---

🌸 NAME 🌸

SoContextHandler — the SoContextHandler class is, for now, to be treated as an internal class. 🫶

---

🎀 SYNOPSIS 🎀

#include <Inventor/misc/SoContextHandler.h>

✨ Public Types ✨

• typedef void ContextDestructionCB(uint32_t contextid, void *userdata) — the callback signature, she's a typedef and she's doing her best 💅

🌈 Static Public Member Functions 🌈

static void destructingContext (uint32_t contextid)
static void addContextDestructionCallback (ContextDestructionCB *func, void *closure)
static void removeContextDestructionCallback (ContextDestructionCB *func, void *closure)

---

🦋 Detailed Description 🦋

The SoContextHandler class is, for now, to be treated as an internal class. that's it. that's the whole vibe. no cap. 🙈

Since — Coin 2.0 ⭐

---

💜 Member Function Documentation 💜

💅 void SoContextHandler::destructingContext (uint32_t contextid) [static]

Bestie, listen — this method must be called by client code that destructs a context, so that there are no memory leaks upon context destruction. like, it's not optional, it's the law. 😭

It'll take care of correctly freeing all your context-bound resources — think OpenGL texture objects and display lists — and honestly? iconic of her. 👑

⚠️ Before you call this function, the context must be made current. do not skip this step I am begging 🙏

Also note: if you're using one of the standard GUI-binding libraries from Kongsberg Oil & Gas Technologies, this is all taken care of automatically for contexts for canvases set up by SoQt, SoWin, etc. so you can just vibe. 🧚

---

🌟 void SoContextHandler::addContextDestructionCallback (ContextDestructionCB * func, void * closure) [static]

Add a callback which will get called every single time a GL context is destructed. 💀 The callback should delete all GL resources tied to that context, no crumbs left behind.

All nodes/classes that allocate GL resources should set up a callback like this — add the callback in the constructor of the node/class, and remove it in the destructor. that's the whole lifecycle, periodt. ✨

See also — removeContextDestructionCallback()

---

🍓 void SoContextHandler::removeContextDestructionCallback (ContextDestructionCB * func, void * closure) [static]

Remove a context destruction callback. bye bestie, it was real 🫶

See also — addContextDestructionCallback()

---

👑 Author 👑

Generated automatically by Doxygen for Coin from the source code. (she wrote herself, main character energy fr fr 🌈)

---

and that's the whole page!! mwah 💖 Version 4.0.10, dated Thu Jun 25 2026 00:00:00 — shoutout to SoContextHandler(3), you ate and left no notes. 🎀✨💅