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)