---
name: "load_bmp"
section: "3alleg4"
platform: "linux"
package: "allegro4-doc"
version: "2:4.4.3.1-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/load_bmp/3alleg4"
---

# load\_bmp(3alleg4)

Loads a BMP bitmap from a file. Allegro game programming library.

## NAME

load\_bmp - Loads a BMP bitmap from a file. Allegro game programming library.

## SYNOPSIS

**#include \<allegro.h\>**

**BITMAP \*load\_bmp(const char \*filename, RGB \*pal);**

## DESCRIPTION

Loads an 8-bit, 16-bit, 24-bit or 32-bit Windows or OS/2 BMP file.

## RETURN VALUE

Returns a pointer to the bitmap or NULL on error. Remember that you are responsible for destroying the bitmap when you are finished with it to avoid memory leaks.

## SEE ALSO

**load\_bitmap**(3alleg4), **load\_bmp\_pf**(3alleg4)