Man Linux: Main Page and Category List

NAME

       create_sub_bitmap   -   Creates  a  memory  sub  bitmap.  Allegro  game
       programming library.

SYNOPSIS

       #include <allegro.h>

       BITMAP *create_sub_bitmap(BITMAP *parent, int x, y, width, height);

DESCRIPTION

       Creates a sub-bitmap, ie. a bitmap sharing drawing memory with  a  pre-
       existing  bitmap,  but  possibly  with  a  different  size and clipping
       settings. When creating a  sub-bitmap  of  the  mode-X  screen,  the  x
       position  must  be  a multiple of four. The sub-bitmap width and height
       can extend beyond the right and bottom edges of the parent  (they  will
       be clipped), but the origin point must lie within the parent region.

RETURN VALUE

       Returns  a pointer to the created sub bitmap, or NULL if the sub bitmap
       could not be created. Remember to free the sub  bitmap  before  freeing
       the parent bitmap to avoid memory leaks and potential crashes accessing
       memory which has been freed.

SEE ALSO

       create_bitmap(3alleg),                        create_bitmap_ex(3alleg),
       destroy_bitmap(3alleg),   is_sub_bitmap(3alleg),  clear_bitmap(3alleg),
       clear_to_color(3alleg),        expat(3alleg),         exscroll(3alleg),
       exswitch(3alleg)