NAME

       create_bitmap - Creates a memory bitmap. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       BITMAP *create_bitmap(int width, int height);

DESCRIPTION

       Creates  a memory bitmap sized width by height. The bitmap will have clipping turned on, and the clipping
       rectangle set to the full size of the bitmap. The image memory will not be cleared, so it  will  probably
       contain  garbage:  you should clear the bitmap before using it. This routine always uses the global pixel
       format, as specified by calling set_color_depth().  The minimum height of the BITMAP must be 1 and  width
       can't be negative.  Example:

          /* Create a 10 pixel tall bitmap, as wide as the screen. */
          BITMAP *bmp = create_bitmap(SCREEN_W, 10);
          if (!bmp)
             abort_on_error("Couldn't create bitmap!");
          /* Use the bitmap. */
          ...
          /* Destroy it when we don't need it any more. */
          destroy_bitmap(bmp);

RETURN VALUE

       Returns  a  pointer  to  the created bitmap, or NULL if the bitmap could not be created. Remember to free
       this bitmap later to avoid memory leaks.

SEE ALSO

       create_bitmap_ex(3alleg4),           create_sub_bitmap(3alleg4),            create_video_bitmap(3alleg4),
       create_system_bitmap(3alleg4),             destroy_bitmap(3alleg4),             set_color_depth(3alleg4),
       is_memory_bitmap(3alleg4), clear_bitmap(3alleg4), clear_to_color(3alleg4)