opendarwin man page for create_bitmap_ex

create_bitmap_ex(3alleg4)					  Allegro manual					 create_bitmap_ex(3alleg4)

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)

Allegro 							   version 4.4.2					 create_bitmap_ex(3alleg4)