al_load_bitmap(3)

✨ al_load_bitmap(3) ✨

🎀 NAME 🎀

al_load_bitmap — Allegro 5 API. okay so this page lives in the Library Functions Manual, and it's your girl's guide to loading a bitmap image without the chaos 💅

🦋 SYNOPSIS 🦋

the formal fit check:

#include <allegro5/allegro.h>

ALLEGRO_BITMAP *al_load_bitmap(const char *filename)

💖 DESCRIPTION 💖

okay bestie, here's the whole vibe: al_load_bitmap loads an image file into a new ALLEGRO_BITMAP(3). ✨ The file type is determined by al_identify_bitmap(3), using the extension as a fallback in case identification is not possible. iykyk.

Returns NULL on error. no cap, that's the important bit 😭

This is literally the same as calling al_load_bitmap_flags(3) with a flags parameter of 0. same energy, zero extra flags.

⚠️ Note, bestie: the core Allegro library does not support any image file formats by default. You must use the allegro_image addon, or register your own format handler. that's not optional, that's the whole plot 🔥

🌈 SEE ALSO 🌈

go peek at these icons too 👀

• al_load_bitmap_flags(3)
• al_load_bitmap_f(3)
• al_register_bitmap_loader(3)
• al_set_new_bitmap_format(3)
• al_set_new_bitmap_flags(3)
• al_init_image_addon(3)

---

xoxo 💌 from the Allegro reference manual, al_load_bitmap(3) — that's the whole page, periodt. 💖✨🎀🦋🌸💅🫶