create_sub_bitmap

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
       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(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.3       create_sub_bitmap(3alleg4)