1create_video_bitmap(3) Allegro manual create_video_bitmap(3)
2
3
4
6 create_video_bitmap - Creates a video memory bitmap. Allegro game pro‐
7 gramming library.
8
10 #include <allegro.h>
11
12
13 BITMAP *create_video_bitmap(int width, int height);
14
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
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
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.2 create_video_bitmap(3)