Provided by: allegro4-doc_4.4.3.1-3_all bug

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)