---
name: "create_system_bitmap"
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_system_bitmap/3alleg4"
---

# create\_system\_bitmap(3alleg4)

Creates a system memory bitmap. Allegro game programming library.

## NAME

create\_system\_bitmap - Creates a system memory bitmap. Allegro game programming library.

## SYNOPSIS

**#include \<allegro.h\>**

**BITMAP \*create\_system\_bitmap(int width, int height);**

## DESCRIPTION

Allocates a system memory bitmap of the specified size. Read the introduction of this chapter for a comparison with other types of bitmaps and other specific details.

## RETURN VALUE

Returns a pointer to the bitmap on success, NULL otherwise. Remember to destroy this bitmap before any subsequent call to set\_gfx\_mode().

## SEE ALSO

**create\_bitmap**(3alleg4), **create\_bitmap\_ex**(3alleg4), **create\_video\_bitmap**(3alleg4), **create\_sub\_bitmap**(3alleg4), **destroy\_bitmap**(3alleg4), **is\_system\_bitmap**(3alleg4), **clear\_bitmap**(3alleg4), **clear\_to\_color**(3alleg4), **exupdate**(3alleg4)