al_identify_bitmap_f(3alleg5)

✨ NAME ✨

al_identify_bitmap_f — okay bestie, this is from the Allegro 5 API manual and it's literally the girl who looks at a file and goes "oh I know her 💅"

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

char const *al_identify_bitmap_f(ALLEGRO_FILE *fp)

---

🦋 DESCRIPTION 🦋

So here's the tea: this function tries to guess the bitmap file type of an open ALLEGRO_FILE by reading the first few bytes. She's not reading the whole thing, bestie, she's just peeking at the opening lines like it's a group chat preview. 👀

By default, Allegro cannot recognize any file types. Like, zero. Nada. Nothing. 🙈 But calling al_init_image_addon(3alleg5) will add detection of (some of) the types it can read. So basically the image addon is the friend who introduces her to everyone at the party. 🎀

You can also use al_register_bitmap_identifier(3alleg5) to add identification for custom file types — yes queen, make your own lore. 👑

She returns a pointer to a static string with a file extension for the type, including the leading dot. For example .png or .jpg. And if the bitmap type cannot be determined? She returns NULL. Not every mystery gets solved, and that's okay. 💀

Heads up: that returned pointer is to a static string, so don't go freeing it or thinking it's yours. It's giving "borrowed, not owned." 🫶

---

⭐ SINCE ⭐

5.1.12 — she's been iconic since day one, fr fr.

---

🌈 SEE ALSO 🌈

• al_init_image_addon(3alleg5)
• al_identify_bitmap(3alleg5)
• al_register_bitmap_identifier(3alleg5)

---

And that's the whole vibe, bestie — this page came straight out of the Allegro reference manual, no cap. Go forth and identify those bitmaps, you main character. 💖✨