create_video_bitmap(3) - Linux man page
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(3),
create_bitmap_ex(3),
create_system_bitmap(3),
create_sub_bitmap(3),
destroy_bitmap(3),
screen(3),
show_video_bitmap(3),
gfx_capabilities(3),
is_video_bitmap(3),
clear_bitmap(3),
clear_to_color(3),
ex3buf(3),
exaccel(3),
exflip(3),
exupdate(3)
Referenced By
request_video_bitmap(3),
set_gfx_mode(3)