---
name: "al_lock_bitmap_blocked"
section: "3"
platform: "linux"
package: "allegro"
version: "5.2.11.3-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/al_lock_bitmap_blocked"
---

# al\_lock\_bitmap\_blocked(3)

Allegro 5 API

## 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(3)](/al_lock_bitmap/3.md), but allows locking bitmaps with a blocked pixel format (i.e. a format for which [al\_get\_pixel\_block\_width(3)](/al_get_pixel_block_width/3.md) or [al\_get\_pixel\_block\_height(3)](/al_get_pixel_block_height/3.md) 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(3)](/al_get_pixel/3.md) will also not work.

## SINCE

5\.1.9

## SEE ALSO

[al\_lock\_bitmap(3)](/al_lock_bitmap/3.md), [al\_lock\_bitmap\_region\_blocked(3)](/al_lock_bitmap_region_blocked/3.md)