Provided by: allegro4-doc_4.4.2-13_all bug

NAME

       create_bitmap_ex   -  Creates  a  memory  bitmap  specifying  color  depth.  Allegro  game
       programming library.

SYNOPSIS

       #include <allegro.h>

       BITMAP *create_bitmap_ex(int color_depth, int width, int height);

DESCRIPTION

       Creates a bitmap in a specific color depth (8, 15, 16, 24 or 32 bits per pixel). Example:

          /* Create screen sized bitmap in 32 bits per pixel. */
          BITMAP *bmp = create_bitmap_ex(32, SCREEN_W, SCREEN_H);
          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(3alleg4),      create_sub_bitmap(3alleg4),     create_video_bitmap(3alleg4),
       create_system_bitmap(3alleg4),     destroy_bitmap(3alleg4),     is_memory_bitmap(3alleg4),
       clear_bitmap(3alleg4),   clear_to_color(3alleg4),   ex12bit(3alleg4),   exlights(3alleg4),
       exrgbhsv(3alleg4), extrans(3alleg4)