al_reparent_bitmap(3)

🎀 NAME 🎀

okay so this is the manual page for al_reparent_bitmap(3) — Allegro 5 API, straight out of the Library Functions Manual. Bestie, it’s a sub-bitmap glow-up situation, and I’m obsessed. 💖

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

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

💖 DESCRIPTION 💖

For a sub-bitmap, this changes the parent, position and size. No cap, it’s literally the same as destroying the bitmap and re-creating it with al_create_sub_bitmap(3) — except the bitmap pointer stays the same. 🫶

This has so many uses, fr fr:

• An animation player could return a single bitmap which can just be re-parented to different animation frames without having to re-draw the contents. 🎞️
• Or a sprite atlas could re-arrange its sprites without having to invalidate all existing bitmaps. 🧚

🦋 SEE ALSO 🦋

• al_create_sub_bitmap(3)
• al_get_parent_bitmap(3)

🌸 SINCE 🌸

This icon has been in the game since 5.1.12 — periodt. 👑

source/version + date vibe check: Allegro reference manual, page al_reparent_bitmap(3), SINCE 5.1.12, and no separate date in the footer — that’s the cute lil sign-off, bestie 🫶✨