1create_video_bitmap(3)          Allegro manual          create_video_bitmap(3)
2
3
4

NAME

6       create_video_bitmap  - Creates a video memory bitmap. Allegro game pro‐
7       gramming library.
8

SYNOPSIS

10       #include <allegro.h>
11
12
13       BITMAP *create_video_bitmap(int width, int height);
14

DESCRIPTION

16       Allocates a video memory bitmap of the specified size. This can be used
17       to  allocate  offscreen  video memory for storing source graphics ready
18       for a hardware accelerated blitting operation, or  to  create  multiple
19       video   memory   pages   which   can   then  be  displayed  by  calling
20       show_video_bitmap().  Read the introduction of this chapter for a  com‐
21       parison with other types of bitmaps and other specific details.
22
23       Warning: video memory bitmaps are usually allocated from the same space
24       as the screen bitmap, so they may overlap with it; it is therefore  not
25       a  good  idea to use the global screen at the same time as any surfaces
26       returned by this function.
27

RETURN VALUE

29       Returns a pointer to the bitmap on success, or NULL if you have run out
30       of  video  ram.  Remember  to destroy this bitmap before any subsequent
31       call to set_gfx_mode().
32
33

SEE ALSO

35       create_bitmap(3),  create_bitmap_ex(3),  create_system_bitmap(3),  cre‐
36       ate_sub_bitmap(3),  destroy_bitmap(3), screen(3), show_video_bitmap(3),
37       gfx_capabilities(3),        is_video_bitmap(3),        clear_bitmap(3),
38       clear_to_color(3), ex3buf(3), exaccel(3), exflip(3), exupdate(3)
39
40
41
42Allegro                          version 4.4.3          create_video_bitmap(3)
Impressum