AL_SET_CURRENT_OPENGL_CONTEXT(3)

💅 al_set_current_opengl_context(3) 💅

omg hi bestie, welcome to the Library Functions Manual page for al_set_current_opengl_context(3) — it's giving Allegro 5 API main character energy, and we're gonna get you comfy with it 💖

---

🎀 NAME 🎀

al_set_current_opengl_context — Allegro 5 API ✨

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_opengl.h>

void al_set_current_opengl_context(ALLEGRO_DISPLAY *display)

🦋 DESCRIPTION 🦋

Okay so this function makes the OpenGL context that's associated with the given display current for the thread that's calling it. Slay 💅.

If there's a current target bitmap and it belongs to a different OpenGL context, that target bitmap gets changed to NULL. Not me warning you — that's just what happens, periodt.

Normally you do not need to use this function, bestie. The context gets made current when you call al_set_target_bitmap(3) or al_set_target_backbuffer(3). So most of the time you can just let those do their thing ✨.

You might need it if you created an OpenGL “forward compatible” context. In that case, al_get_backbuffer(3) only returns NULL, so it would not work to pass that to al_set_target_bitmap(3). That's the little corner case where this function really comes through 🫶.

no cap: don't reach for this by default — the normal target-bitmap/backbuffer calls already handle the current-context vibe for you.

---

okay that's the whole page bestie — source/version: Allegro reference manual, date: not shown in this copy, page: al_set_cur...ngl_context(3) 🫶✨💖