create_video_bitmap - Creates a video memory bitmap. Allegro game programming library.
Contents
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.
Name
create_video_bitmap - Creates a video memory bitmap. Allegro game programming library.
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.3 create_video_bitmap(3alleg4)
Synopsis
#include<allegro.h>BITMAP*create_video_bitmap(intwidth,intheight);
