---
name: "create_bitmap_ex"
section: "3alleg"
platform: "linux"
package: "liballegro-doc"
version: "2:4.2.2-2.2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/create_bitmap_ex"
---

# create\_bitmap\_ex(3alleg)

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**(3alleg)](/create_bitmap/3alleg.md), [**create\_sub\_bitmap**(3alleg)](/create_sub_bitmap/3alleg.md), [**create\_video\_bitmap**(3alleg)](/create_video_bitmap/3alleg.md), [**create\_system\_bitmap**(3alleg)](/create_system_bitmap/3alleg.md), [**destroy\_bitmap**(3alleg)](/destroy_bitmap/3alleg.md), [**is\_memory\_bitmap**(3alleg)](/is_memory_bitmap/3alleg.md), [**clear\_bitmap**(3alleg)](/clear_bitmap/3alleg.md), [**clear\_to\_color**(3alleg)](/clear_to_color/3alleg.md), [**ex12bit**(3alleg)](/ex12bit/3alleg.md), [**exlights**(3alleg)](/exlights/3alleg.md), [**exrgbhsv**(3alleg)](/exrgbhsv/3alleg.md), [**extrans**(3alleg)](/extrans/3alleg.md)