create_sub_bitmap(3alleg4)					  Allegro manual					create_sub_bitmap(3alleg4)

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 set-
       tings. 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(3alleg4),	   create_bitmap_ex(3alleg4),	  destroy_bitmap(3alleg4),     is_sub_bitmap(3alleg4),	    clear_bitmap(3alleg4),
       clear_to_color(3alleg4), expat(3alleg4), exscroll(3alleg4), exswitch(3alleg4)

Allegro 							   version 4.4.2					create_sub_bitmap(3alleg4)