create_bitmap(3) Allegro manual create_bitmap(3)NAMEcreate_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 rou‐
tine 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 ALSOcreate_bitmap_ex(3), create_sub_bitmap(3), create_video_bitmap(3), cre‐
ate_system_bitmap(3), destroy_bitmap(3), set_color_depth(3), is_mem‐
ory_bitmap(3), clear_bitmap(3), clear_to_color(3)Allegro version 4.4.2 create_bitmap(3)
