create_bitmap_ex(3alleg)

create_bitmap_ex3alleg

Creates a memory bitmap specifying color depth. allegro game programming library.

Usage

#include <allegro.h>

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

Overview

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.

Releases

4 releases since Debian 3.1 (Sarge); the text changed 2 times.

  1. 3.1
  2. 4.0
  3. 5.0–6.0

From liballegro-doc 2:4.2.2-2.2 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.