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_ex(3alleg),
create_system_bitmap(3alleg), create_sub_bitmap(3alleg),
destroy_bitmap(3alleg), screen(3alleg), show_video_bitmap(3alleg),
gfx_capabilities(3alleg), is_video_bitmap(3alleg),
clear_bitmap(3alleg), clear_to_color(3alleg), ex3buf(3alleg),
exaccel(3alleg), exflip(3alleg), exupdate(3alleg)