SoGLRenderCache(3)

💖 SoGLRenderCache 💖 — the Coin manual, section 3, bestie edition

okay so gather round 🫶 this is the manpage for SoGLRenderCache, and honestly? it's giving quiet overachiever. it caches your OpenGL calls so nobody has to redo them, and it's lowkey iconic for that. it lives in the Coin manual, and the manual name is SoGLRenderCache(3) if you need to cite it in a group chat. 💅

---

✨ NAME ✨

SoGLRenderCache — the class that caches OpenGL calls. that's it, that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

#include <Inventor/caches/SoGLRenderCache.h>

it inherits SoCache, so all the inherited goodness comes along for the ride. ✨

💜 Public Member Functions

SoGLRenderCache (SoState *state)
virtual ~SoGLRenderCache ()
void open (SoState *state)
void close (void)
void call (SoState *state)
int getCacheContext (void) const
virtual SbBool isValid (const SoState *state) const
virtual void addNestedCache (SoGLDisplayList *child)
SoGLLazyElement::GLState * getPreLazyState (void)
SoGLLazyElement::GLState * getPostLazyState (void)

💜 Public Member Functions inherited from SoCache

SoCache (SoState *const state)
void ref (void)
void unref (SoState *state=NULL)
void addElement (const SoElement *const elem)
virtual void addCacheDependency (const SoState *state, SoCache *cache)
const SoElement * getInvalidElement (const SoState *const state) const
void invalidate (void)

🎀 Protected Member Functions

virtual void destroy (SoState *state)

🎀 Protected Member Functions inherited from SoCache

virtual ~SoCache ()

🌈 Detailed Description 🌈

The SoGLRenderCache class is used to cache OpenGL calls. periodt. it's the class whose entire personality is "i remembered what you drew so you don't have to draw it again." ✨👑

---

🧚 Constructor & Destructor Documentation 🧚

SoGLRenderCache::SoGLRenderCache (SoState * state)

Constructor, and state is the current state. that's the whole tea, no more notes. 💖

SoGLRenderCache::~SoGLRenderCache () [virtual]

Destructor. bye babes 👋🦋

---

👑 Member Function Documentation 👑

void SoGLRenderCache::open (SoState * state)

Opens the cache. every single GL call from that point on gets cached until close() is called. it is literally recording. 🎥✨

See also: close(), call()

void SoGLRenderCache::close (void )

Closes the cache. should be called after all the GL calls are done, fr fr. 🌸

See also: open()

void SoGLRenderCache::call (SoState * state)

Executes the cached display list. the moment we've all been waiting for. 💅🔥

See also: open()

int SoGLRenderCache::getCacheContext (void ) const

Returns the cache context of this cache. this is used to quickly determine if the cache can be used for a state — a tiny fast vibe check so you don't waste time, iykyk. ⭐

heads up bestie: this method is an extension versus the Open Inventor API. so it's Coin-exclusive, main character energy only. 👑💜

SbBool SoGLRenderCache::isValid (const SoState * state) const [virtual]

Return TRUE if this cache is valid, FALSE otherwise. no in-between, no "it's complicated". ✅❌

Reimplemented from SoCache.

void SoGLRenderCache::addNestedCache (SoGLDisplayList * child) [virtual]

Adds a display list which is called from this cache. this is to make sure the child display list isn't destroyed too early — protective bestie behaviour, we love to see it. 🫶💖

void SoGLRenderCache::destroy (SoState * state) [protected], [virtual]

Can be overridden by subclasses to clean up before they are deleted. the default method does nothing — it's the "no thoughts, head empty" default. 🙈

Reimplemented from SoCache.

---

💀 Author 💀

Generated automatically by Doxygen for Coin from the source code. so a robot wrote this whole thing. slay, i guess 🤖✨

---

and that's the page!! one last lil sign-off from me to you: this is Version 4.0.10, dated Thu Jun 25 2026 00:00:00, and the manual tag is SoGLRenderCache(3) in case anyone asks. mwah 💋 ✨🌸💖🦋