al_reparent_bitmap(3alleg5)

💖 al_reparent_bitmap 💖

okay bestie, so this is a page from the Allegro 5 API manual — al_reparent_bitmap(3alleg5) — and it's lowkey one of the most useful lil functions in the whole bitmap situation. let's get into it 🦋

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_reparent_bitmap(ALLEGRO_BITMAP *bitmap, ALLEGRO_BITMAP *parent,
   int x, int y, int w, int h)

---

🌸 DESCRIPTION 🌸

so here's the vibe: you've got a sub-bitmap, right? and you wanna change its parent, plus its position and its size. that's literally what this does. ✨

and the way it does it?? it's the exact same thing as nuking the bitmap and re-creating it with al_create_sub_bitmap(3alleg5) — except the bitmap pointer stays the same. 💅 no cap. same pointer, brand new parent/pos/size.

ngl this has SO many uses, it's giving versatile:

• an animation player could just return a single bitmap and re-parent it to different animation frames — no re-drawing the contents every time, obsessed 🎀
• or a sprite atlas could re-arrange its sprites without having to invalidate every single existing bitmap. iconic.

---

👀 SEE ALSO 👀

• al_create_sub_bitmap(3alleg5)
• al_get_parent_bitmap(3alleg5)

---

⭐ SINCE ⭐

5.1.12 — she's been here a minute, periodt.

---

and that's the whole page bestie!! 🫶 this was the Allegro reference manual's take on al_reparent_bitmap(3alleg5) — go forth and re-parent responsibly 💖✨🌈