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

# create\_system\_bitmap(3alleg)

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**(3alleg)](/create_bitmap/3alleg.md), [**create\_bitmap\_ex**(3alleg)](/create_bitmap_ex/3alleg.md), [**create\_video\_bitmap**(3alleg)](/create_video_bitmap/3alleg.md), [**create\_sub\_bitmap**(3alleg)](/create_sub_bitmap/3alleg.md), [**destroy\_bitmap**(3alleg)](/destroy_bitmap/3alleg.md), [**is\_system\_bitmap**(3alleg)](/is_system_bitmap/3alleg.md), [**clear\_bitmap**(3alleg)](/clear_bitmap/3alleg.md), [**clear\_to\_color**(3alleg)](/clear_to_color/3alleg.md), [**exupdate**(3alleg)](/exupdate/3alleg.md)