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

# create\_video\_bitmap(3alleg)

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**(3alleg)](/create_bitmap/3alleg.md), [**create\_bitmap\_ex**(3alleg)](/create_bitmap_ex/3alleg.md), [**create\_system\_bitmap**(3alleg)](/create_system_bitmap/3alleg.md), [**create\_sub\_bitmap**(3alleg)](/create_sub_bitmap/3alleg.md), [**destroy\_bitmap**(3alleg)](/destroy_bitmap/3alleg.md), [**screen**(3alleg)](/screen/3alleg.md), [**show\_video\_bitmap**(3alleg)](/show_video_bitmap/3alleg.md), [**gfx\_capabilities**(3alleg)](/gfx_capabilities/3alleg.md), [**is\_video\_bitmap**(3alleg)](/is_video_bitmap/3alleg.md), [**clear\_bitmap**(3alleg)](/clear_bitmap/3alleg.md), [**clear\_to\_color**(3alleg)](/clear_to_color/3alleg.md), [**ex3buf**(3alleg)](/ex3buf/3alleg.md), [**exaccel**(3alleg)](/exaccel/3alleg.md), [**exflip**(3alleg)](/exflip/3alleg.md), [**exupdate**(3alleg)](/exupdate/3alleg.md)