opendarwin man page for create_video_bitmap

create_video_bitmap(3alleg4)					  Allegro manual				      create_video_bitmap(3alleg4)

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)

Allegro 							   version 4.4.2				      create_video_bitmap(3alleg4)