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)