al_destroy_bitmap(3)

okay so you're on the al_destroy_bitmap(3) page from the Library Functions Manual, and it's giving "cleanup era" for your Allegro 5 bitmaps. let's go bestie 💅✨

💖 NAME 💖

al_destroy_bitmap — Allegro 5 API

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_destroy_bitmap(ALLEGRO_BITMAP *bitmap)

🎀 DESCRIPTION 🎀

al_destroy_bitmap destroys the given bitmap and frees literally all the resources used by it. like, full bye-bye, resources released, iconic behavior 👑🔥

If the bitmap argument is NULL, this function does nothing. not a single thing. it simply does not engage 🫶

Here's the convenience part: if the calling thread is currently targeting the bitmap, then the bitmap will be untargeted first. The new target bitmap is unspecified. (since: 5.0.10, 5.1.6) — yes, that's the exact little caveat, bestie 🦋

⚠️ Otherwise, it is an error to destroy a bitmap while it (or a sub-bitmap) is the target bitmap of any thread. this is not a drill — that's an error, so don't do it 😭💀

🦋 SEE ALSO 🦋

• al_create_bitmap(3)

---

💖 xoxo, the Allegro reference manual — al_destroy_bitmap(3) signing off, bestie! 🎀