NAME¶
create_bitmap - Creates a memory bitmap. Allegro game programming library.
SYNOPSIS¶
#include <allegro.h>
BITMAP *create_bitmap(int width, int height);
DESCRIPTION¶
Creates a memory bitmap sized width by height. The bitmap will have clipping
turned on, and the clipping rectangle set to the full size of the bitmap. The
image memory will not be cleared, so it will probably contain garbage: you
should clear the bitmap before using it. This routine always uses the global
pixel format, as specified by calling set_color_depth(). The minimum height of
the BITMAP must be 1 and width can't be negative. Example:
/* Create a 10 pixel tall bitmap, as wide as the screen. */
BITMAP *bmp = create_bitmap(SCREEN_W, 10);
if (!bmp)
abort_on_error("Couldn't create bitmap!");
/* Use the bitmap. */
...
/* Destroy it when we don't need it any more. */
destroy_bitmap(bmp);
RETURN VALUE¶
Returns a pointer to the created bitmap, or NULL if the bitmap could not be
created. Remember to free this bitmap later to avoid memory leaks.
SEE ALSO¶
create_bitmap_ex(3alleg4), create_sub_bitmap(3alleg4),
create_video_bitmap(3alleg4), create_system_bitmap(3alleg4),
destroy_bitmap(3alleg4), set_color_depth(3alleg4),
is_memory_bitmap(3alleg4), clear_bitmap(3alleg4),
clear_to_color(3alleg4)
