Bitmap types and constants

Summary
Pixel formats.
Users who wish to manually edit or read from a bitmap are required to lock it first.

Enumerations

ALLEGRO_PIXEL_FORMAT

Pixel formats.  Each pixel format specifies the exact size and bit layout of a pixel in memory.  Components are specified from high bits to low, so for example a fully opaque red pixel in ARGB_8888 format is 0xFFFF0000.

ALLEGRO_PIXEL_FORMAT_ANY_NO_ALPHALet the driver choose a format without alpha
ALLEGRO_PIXEL_FORMAT_ANY_WITH_ALPHALet the driver choose a format with alpha.  This is the default format at program start.
ALLEGRO_PIXEL_FORMAT_ANY_15_NO_ALPHALet the driver choose a 15 bit format without alpha
ALLEGRO_PIXEL_FORMAT_ANY_15_WITH_ALPHALet the driver choose a 15 bit format with alpha
ALLEGRO_PIXEL_FORMAT_ANY_16_NO_ALPHALet the driver choose a 16 bit format without alpha
ALLEGRO_PIXEL_FORMAT_ANY_16_WITH_ALPHALet the driver choose a 16 bit format with alpha
ALLEGRO_PIXEL_FORMAT_ANY_24_NO_ALPHALet the driver choose a 24 bit format without alpha
ALLEGRO_PIXEL_FORMAT_ANY_24_WITH_ALPHALet the driver choose a 24 bit format with alpha
ALLEGRO_PIXEL_FORMAT_ANY_32_NO_ALPHALet the driver choose a 32 bit format without alpha
ALLEGRO_PIXEL_FORMAT_ANY_32_WITH_ALPHALet the driver choose a 32 bit format with alpha
ALLEGRO_PIXEL_FORMAT_ARGB_888832 bit
ALLEGRO_PIXEL_FORMAT_RGBA_888832 bit
ALLEGRO_PIXEL_FORMAT_ARGB_444416 bit
ALLEGRO_PIXEL_FORMAT_RGB_88824 bit
ALLEGRO_PIXEL_FORMAT_RGB_56516 bit
ALLEGRO_PIXEL_FORMAT_RGB_55515 bit
ALLEGRO_PIXEL_FORMAT_PALETTE_88 bit
ALLEGRO_PIXEL_FORMAT_RGBA_555116 bit
ALLEGRO_PIXEL_FORMAT_ARGB_155516 bit
ALLEGRO_PIXEL_FORMAT_ABGR_888832 bit
ALLEGRO_PIXEL_FORMAT_XBGR_888832 bit
ALLEGRO_PIXEL_FORMAT_BGR_88824 bit
ALLEGRO_PIXEL_FORMAT_BGR_56516 bit
ALLEGRO_PIXEL_FORMAT_BGR_55515 bit
ALLEGRO_PIXEL_FORMAT_RGBX_888832 bit
ALLEGRO_PIXEL_FORMAT_XRGB_888832 bit

Types

ALLEGRO_LOCKED_REGION

Users who wish to manually edit or read from a bitmap are required to lock it first.  The ALLEGRO_LOCKED_REGION structure represents the locked region of the bitmap.  This call will work with any bitmap, including memory bitmaps.

typedef struct ALLEGRO_LOCKED_REGION {
void *data; // the bitmap data
int format; // the pixel format of the data
int pitch; // the size in bytes of a single line
// pitch may be greater than pixel_size*bitmap->w
// i.e. padded with extra bytes
}