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)