al_clone_bitmap(3alleg5)

💖 al_clone_bitmap 💖

okay bestie, so this is a page from the Allegro 5 API reference manual, and we're gonna talk about the girlboss move that is cloning a bitmap. no cap, it's giving "copy my whole fit but in a new body." ✨

---

✨ NAME ✨

al_clone_bitmap — she's part of the Allegro 5 API, and she makes a whole new bitmap that's a copy of an old one. iconic behavior honestly 🎀

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

ALLEGRO_BITMAP *al_clone_bitmap(ALLEGRO_BITMAP *bitmap)

like, you hand her a bitmap pointer and she hands you back a fresh ALLEGRO_BITMAP *. simple. clean. slay. 💅

---

🦋 DESCRIPTION 🦋

So what's actually happening here? al_clone_bitmap creates a brand new bitmap using al_create_bitmap(3alleg5), and then copies all the pixel data from the old bitmap across. boom, twin. 👯

Here's the tea though, and this part matters, no cap: the newly created bitmap gets made with the current new bitmap flags — not the ones that were used to create the original bitmap. so if you changed your new bitmap flags since you made the original, your clone is gonna reflect those, not the originals. vibe check passed but stay aware bestie. 👀

And one more lil detail: if the new bitmap is a memory bitmap, its projection bitmap gets reset to be orthographic. lowkey important, highkey useful. 🌈

---

💜 SEE ALSO 💜

• al_create_bitmap(3alleg5) — the one who actually builds the new bitmap, the main character of this whole operation 💫
• al_set_new_bitmap_format(3alleg5) — set the format for new bitmaps, iykyk
• al_set_new_bitmap_flags(3alleg5) — the flags that your clone is gonna inherit, so choose wisely bestie 🎀
• al_convert_bitmap(3alleg5) — when you need to change a bitmap's whole vibe 🦋

---

and that's the whole page fr fr. this was the Allegro reference manual talking about al_clone_bitmap(3alleg5) — go forth and clone responsibly, you absolute legend. periodt. 💖✨🫶