SoGLDisplayList(3)

💖 SoGLDisplayList — the SoGLDisplayList(3) glow-up 💖

okay bestie, welcome to the Coin corner of your terminal. this is the manual page for SoGLDisplayList, section 3 of the manual, and yes we're about to make OpenGL display lists feel like a whole personality. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

SoGLDisplayList — the class that stores and manages OpenGL display lists. that's literally the whole job. it's giving storage unit for your GPU's fave little bundles. no cap.

---

🌸 SYNOPSIS 🌸

#include <Inventor/elements/SoGLDisplayList.h>

🎀 Public Types 🎀

enum Type { DISPLAY_LIST, TEXTURE_OBJECT }

just two vibes to choose from: DISPLAY_LIST or TEXTURE_OBJECT. pick your fighter 💅

🦋 Public Member Functions 🦋

SoGLDisplayList (SoState *state, Type type, int allocnum=1, SbBool
    mipmaptexobj=FALSE)
void ref (void)
void unref (SoState *state=NULL)
void open (SoState *state, int index=0)
void close (SoState *state)
void call (SoState *state, int index=0)
void addDependency (SoState *state)
SbBool isMipMapTextureObject (void) const
Type getType (void) const
int getNumAllocated (void) const
unsigned int getFirstIndex (void) const
int getContext (void) const
void setTextureTarget (int target)
int getTextureTarget (void) const

look at that roster. that's a full cast, main character energy from top to bottom 👑

---

💜 Detailed Description 💜

okay so SoGLDisplayList stores and manages OpenGL display lists. say it with me. that's the bit.

now here's the tea you actually need: the TEXTURE_OBJECT type is not directly supported in Coin. 😭 and it's not a bug, it's a choice — Coin handles textures differently, in a more flexible class called SoGLImage, which also stores some info about the texture used when rendering. so it's not that textures were abandoned, they just moved into a nicer apartment. 🏡

but listen — old code that uses this element should not stop working. periodt. the texture object extension just won't get used, and the texture gets stored in a display list instead. it's fine. everything's fine. 💅

---

⭐ Constructor & Destructor Documentation ⭐

🍓 SoGLDisplayList::SoGLDisplayList (SoState * state, Type type, int allocnum = 1, SbBool mipmaptexobj = FALSE)

Constructor. that's it, that's the description — it constructs. iconic brevity, honestly ✨

---

🌈 Member Function Documentation 🌈

💖 void SoGLDisplayList::ref (void )

Increase reference count for this display list / texture object. keep it alive, bestie 🫶

💖 void SoGLDisplayList::unref (SoState * state = NULL)

Decrease reference count for this instance. and here's the dramatic part: when reference count reaches 0, the instance is deleted. 💀 poof. gone. so don't unref what you still need, iykyk.

💖 void SoGLDisplayList::open (SoState * state, int index = 0)

Open this display list / texture object. like unzipping it for business 🎀

💖 void SoGLDisplayList::close (SoState * state)

Close this display list / texture object. zip it back up, we're done here ✨

💖 void SoGLDisplayList::call (SoState * state, int index = 0)

Execute this display list / texture object. go off, run it, slay 🔥

💖 void SoGLDisplayList::addDependency (SoState * state)

Create a dependency on the display list. attachments. commitment. it's giving loyalty 💜

💖 SbBool SoGLDisplayList::isMipMapTextureObject (void ) const

Returns whether the texture object stored in this instance was created with mipmap data. heads up: this method is an extension versus the Open Inventor API, so it's a Coin extra, not a classic. 🦋

💖 SoGLDisplayList::Type SoGLDisplayList::getType (void ) const

Return type. Display list or texture object. simple. elegant. no notes. 💅

💖 int SoGLDisplayList::getNumAllocated (void ) const

Return number of display lists / texture objects allocated. the headcount 📋

💖 unsigned int SoGLDisplayList::getFirstIndex (void ) const

Return first GL index for this display list. where it all begins, literally the origin story ⭐

💖 int SoGLDisplayList::getContext (void ) const

Return an id for the current context. your context's little name tag 🏷️

💖 void SoGLDisplayList::setTextureTarget (int target)

Sets the texture object target.

Since: Coin 2.5 ✨

💖 int SoGLDisplayList::getTextureTarget (void ) const

Returns the texture target.

Since: Coin 2.5 ✨

---

🧚 Author 🧚

Generated automatically by Doxygen for Coin from the source code. not a human, not a poet, just Doxygen doing its little robot thing 🤖💖

---

and that's the whole page bestie!! no cap, you now know SoGLDisplayList better than most people know their own wifi password 🎀

okay and for the cute sign-off: this was Version 4.0.10, dated Thu Jun 25 2026 00:00:00, and it's the SoGLDisplayList(3) page from the Coin manual. bye pookie, go compile something beautiful 💜🌸