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.3     create_video_bitmap(3alleg4)