AL_CONVERT_MEMORY_BITMAPS(3)

✨ NAME ✨

Okay so this is the al_convert_memory_bitmaps(3) page, straight out of the Library Functions Manual — the Allegro 5 API corner of it, specifically. She’s the little cleanup bestie for your bitmaps 💖

🎀 SYNOPSIS 🎀

#include <allegro5/allegro.h>

void al_convert_memory_bitmaps(void)

💅 DESCRIPTION 💅

Picture this, bestie: you create a bitmap while there is no current display — maybe because you haven’t called al_create_display(3) in the current thread yet 😭 — and you’re using the ALLEGRO_CONVERT_BITMAP bitmap flag, which is set by default. The bitmap gets created successfully, no cap, but it’s a memory bitmap at that point.

That’s literally where al_convert_memory_bitmaps() comes in: it converts all such bitmaps into proper video bitmaps belonging to the current display. slay 💅

Little note straight from the page: video bitmaps get automatically converted back to memory bitmaps when the last display is destroyed. So don’t act surprised 💀

And this operation will preserve all bitmap flags except ALLEGRO_VIDEO_BITMAP and ALLEGRO_MEMORY_BITMAP. Those two? Not preserved, periodt.

🌸 SINCE 🌸

5.2.0 — she’s been here since then, iconic 🫶

🦋 SEE ALSO 🦋

• al_convert_bitmap(3)
• al_create_bitmap(3)

---

Source: Allegro reference manual 💖 Version: 5.2.0, aka the SINCE era. Date: the page didn’t give one, so we’re calling this sign-off timeless, bestie 🌈🎀