---
name: "create_bitmap_ex"
section: "3alleg4"
platform: "linux"
package: "allegro4-doc"
version: "2:4.4.3.1-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/create_bitmap_ex/3alleg4"
---

# create\_bitmap\_ex(3alleg4)

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

## 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)