al_get_opengl_fbo(3)

💅 al_get_opengl_fbo — Allegro 5 API 🎀

ok so this page lives in the Library Functions Manual (yes bestie, the Library Functions one, not the commands one, we're fancy here) and it's all about a little function called al_get_opengl_fbo. Let's get into it ✨

---

🌸 NAME 🌸

al_get_opengl_fbo — Allegro 5 API, the one that tells you which OpenGL FBO your bitmap is secretly living in 🦋

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_opengl.h>

GLuint al_get_opengl_fbo(ALLEGRO_BITMAP *bitmap)

literally just include the header and hand it a bitmap, that's the whole vibe 🫶

---

💖 DESCRIPTION 💖

So here's the tea ☕: this function returns the OpenGL FBO id that the given bitmap is using internally, if it's using one at all. If it's not using one? You get zero. That's it, that's the answer, no cap. ✨

Important vibe check tho: it will make no attempt to create an FBO if the bitmap isn't owned by the current display. Like, it's not gonna go out of its way to set anything up for you — if the bitmap isn't the current display's baby, it's simply not doing that. 🚫

And the FBO it hands back? It only gets freed when the bitmap is destroyed, or if you call al_remove_opengl_fbo(3) on the bitmap. So it's gonna stick around until one of those two things happens — main character energy, it does not leave early. 👑

📝 Note: back in Allegro 5.0.0 this function only returned an FBO that had previously been created by calling al_set_target_bitmap(3). It would not attempt to create an FBO itself. That has since been changed, bestie — so if you're reading ancient lore, that's why it looks different. 💀

---

🔥 SEE ALSO 🔥

• al_remove_opengl_fbo(3) — the one that actually frees the FBO 🧹
• al_set_target_bitmap(3) — the one that made FBOs back in the 5.0.0 days 🎯

---

and that's the whole page!! 🌈 this little gem comes to you straight from the Allegro reference manual — al_get_opengl_fbo(3), slaying in the Library Functions Manual, no date field content to speak of so consider this your timestamp 🕐💜 go forth and query those FBOs, ily, bye 🎀💖