destroy_bitmap(3alleg4)

💖 destroy_bitmap — the manual page, but make it cute 💖

okay bestie, gather round, we're talking about destroy_bitmap from the Allegro game programming library (that's 3alleg4 to the cool kids, iykyk). this one's short and sweet but she is IMPORTANT, because she's the one who cleans up after you. ✨

✨ NAME ✨

destroy_bitmap — destroys any type of created bitmap. fr fr, any kind. Allegro game programming library energy only. 🎀

🌸 SYNOPSIS 🌸

#include <allegro.h>

void destroy_bitmap(BITMAP *bitmap);

🦋 DESCRIPTION 🦋

so the vibe is: you made a bitmap. you're done with it. now you gotta let her go. 💅

destroy_bitmap destroys a memory bitmap, a sub-bitmap, a video memory bitmap, or a system bitmap when you are finished with it. literally any of them. she does not discriminate, she just cleans up. iconic behaviour honestly.

and the bestie clause: if you pass a NULL pointer, this function won't do anything. no crash, no drama, no nothing. she just shrugs and moves on. lowkey the most emotionally stable function in the whole library. 🫶

⚠️ but okay listen — see above for the restrictions as to when you are allowed to destroy the various types of bitmaps. do NOT skip that part. the rules exist for a reason and ignoring them is not it. 💀

🚨 AND THE BIG ONE: the bitmap must not have a mouse cursor shown on it at the time it is destroyed. no cursor, no destroy. that's the rule. periodt. 🙈

🌈 SEE ALSO 🌈

• create_bitmap(3alleg4) — where the whole situationship begins 🍼
• load_bitmap(3alleg4) — the other way you end up with one of these on your hands 📂
• show_mouse(3alleg4) — go look at this before you destroy anything, bestie, i'm begging 😭

and that's the page!! written up for the <strong>Allegro</strong> manual, <strong>version 4.4.3</strong>, and yeah this was destroy_bitmap(3alleg4) — go forth, free your memory, slay responsibly. 💖✨🎀