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)