al_reparent_bitmap man page

al_reparent_bitmap — Allegro 5 API


#include <allegro5/allegro.h>

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


For a sub-bitmap, changes the parent, position and size. This is 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 many uses, for example 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)




Allegro reference manual