create_system_bitmap(3)

✨ create_system_bitmap(3) ✨

okay bestie, so this is a page from the Allegro manual — yes, the Allegro game programming library — and it's about a lil function called create_system_bitmap. sit down, hydrate, let's go 🫶

---

💖 NAME 💖

create_system_bitmap — creates a system memory bitmap. Allegro game programming library. that's it, that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

#include <allegro.h>

BITMAP *create_system_bitmap(int width, int height);

like, you include the header, you call the thing, the thing gives you a bitmap. iconic behaviour honestly 🎀

---

🦋 DESCRIPTION 🦋

So. create_system_bitmap allocates a system memory bitmap of the size you asked for — that's width by height, no cap, exactly what you passed in.

and ngl, if you wanna know how a system bitmap stacks up against all the other flavours of bitmap out there, plus all the other specific little details 👀 — the manual says to go read the introduction of this chapter. that's where the comparison lives, bestie. it's giving required reading. 📚✨

---

💜 RETURN VALUE 💜

• ✅ on success you get a pointer to the bitmap
• 💀 otherwise you get NULL — so pls check it, don't just rawdog the pointer

⚠️ ok this is the important one: remember to destroy this bitmap before any subsequent call to set_gfx_mode(). like, actually remember. do it before. this is not a drill, this is the manual yelling at you gently 🚨😭

---

🔥 SEE ALSO 🔥

the whole squad, fr fr — go read these too:

• create_bitmap(3)
• create_bitmap_ex(3)
• create_video_bitmap(3)
• create_sub_bitmap(3)
• destroy_bitmap(3)
• is_system_bitmap(3)
• clear_bitmap(3)
• clear_to_color(3)
• exupdate(3)

---

and that's the whole page, no cap ✨ this lil masterpiece comes to you from Allegro, version 4.4.3 — yeah, the manpage footer date situation is a mystery even to me, but the version is right there and it's 4.4.3, periodt 💖 go forth and allocate responsibly, bestie 🧚‍♀️🌸