---
name: "create_video_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_video_bitmap/3alleg4"
---

# create\_video\_bitmap(3alleg4)

Creates a video memory bitmap. Allegro game programming library.

## NAME

create\_video\_bitmap - Creates a video memory bitmap. Allegro game programming library.

## SYNOPSIS

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

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

## DESCRIPTION

Allocates a video memory bitmap of the specified size. This can be used to allocate offscreen video memory for storing source graphics ready for a hardware accelerated blitting operation, or to create multiple video memory pages which can then be displayed by calling show\_video\_bitmap(). Read the introduction of this chapter for a comparison with other types of bitmaps and other specific details.

Warning: video memory bitmaps are usually allocated from the same space as the screen bitmap, so they may overlap with it; it is therefore not a good idea to use the global screen at the same time as any surfaces returned by this function.

## RETURN VALUE

Returns a pointer to the bitmap on success, or NULL if you have run out of video ram. Remember to destroy this bitmap before any subsequent call to set\_gfx\_mode().

## SEE ALSO

**create\_bitmap**(3alleg4), **create\_bitmap\_ex**(3alleg4), **create\_system\_bitmap**(3alleg4), **create\_sub\_bitmap**(3alleg4), **destroy\_bitmap**(3alleg4), **screen**(3alleg4), **show\_video\_bitmap**(3alleg4), **gfx\_capabilities**(3alleg4), **is\_video\_bitmap**(3alleg4), **clear\_bitmap**(3alleg4), **clear\_to\_color**(3alleg4), **ex3buf**(3alleg4), **exaccel**(3alleg4), **exflip**(3alleg4), **exupdate**(3alleg4)