.\" Generated by the Allegro makedoc utility
.TH create_bitmap_ex 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
create_bitmap_ex \- Creates a memory bitmap specifying color depth. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B BITMAP *create_bitmap_ex(int color_depth, int width, int height);
.SH DESCRIPTION
Creates a bitmap in a specific color depth (8, 15, 16, 24 or 32 bits per 
pixel). Example:

.nf
   /* 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);
.fi
.SH "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.


.SH SEE ALSO
.BR create_bitmap (3alleg4),
.BR create_sub_bitmap (3alleg4),
.BR create_video_bitmap (3alleg4),
.BR create_system_bitmap (3alleg4),
.BR destroy_bitmap (3alleg4),
.BR is_memory_bitmap (3alleg4),
.BR clear_bitmap (3alleg4),
.BR clear_to_color (3alleg4),
.BR ex12bit (3alleg4),
.BR exlights (3alleg4),
.BR exrgbhsv (3alleg4),
.BR extrans (3alleg4)