NAME

       al_lock_bitmap_blocked - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              ALLEGRO_LOCKED_REGION *al_lock_bitmap_blocked(ALLEGRO_BITMAP *bitmap,
                 int flags)

DESCRIPTION

       Like al_lock_bitmap(3alleg5), but allows locking bitmaps with a blocked pixel format (i.e.
       a format for which al_get_pixel_block_width(3alleg5) or al_get_pixel_block_height(3alleg5)
       do  not  return  1) in that format.  To that end, this function also does not allow format
       conversion.  For bitmap formats with a block size of 1,  this  function  is  identical  to
       calling al_lock_bitmap(bmp, al_get_bitmap_format(bmp), flags).

              Note:  Currently there are no drawing functions that work when the bitmap is locked
              with a compressed format.  al_get_pixel(3alleg5) will also not work.

SINCE

       5.1.9

SEE ALSO

       al_lock_bitmap(3alleg5), al_lock_bitmap_region_blocked(3alleg5)