.\" Generated by the Allegro makedoc utility
.TH create_video_bitmap 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
create_video_bitmap \- Creates a video memory bitmap. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B BITMAP *create_video_bitmap(int width, int height);
.SH 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.
.SH "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().

.SH SEE ALSO
.BR create_bitmap (3alleg4),
.BR create_bitmap_ex (3alleg4),
.BR create_system_bitmap (3alleg4),
.BR create_sub_bitmap (3alleg4),
.BR destroy_bitmap (3alleg4),
.BR screen (3alleg4),
.BR show_video_bitmap (3alleg4),
.BR gfx_capabilities (3alleg4),
.BR is_video_bitmap (3alleg4),
.BR clear_bitmap (3alleg4),
.BR clear_to_color (3alleg4),
.BR ex3buf (3alleg4),
.BR exaccel (3alleg4),
.BR exflip (3alleg4),
.BR exupdate (3alleg4)