register_bitmap_file_type(3)

💖 register_bitmap_file_type(3) 💖

okay bestie, welcome to the Allegro manual — this one lives in the Allegro game programming library and it's literally about teaching your program a brand-new image format 🎀

✨ NAME ✨

register_bitmap_file_type — registers custom bitmap loading/saving functions. Allegro game programming library.

🌸 SYNOPSIS 🌸

#include <allegro.h>

void register_bitmap_file_type(const char *ext, BITMAP *(*load)(const
char *filename, RGB *pal), int (*save)(const char *filename, BITMAP
*bmp, const RGB *pal));

🦋 DESCRIPTION 🦋

So basically, this function informs the load_bitmap() and save_bitmap() functions that a new file type exists, and hands them the routines to read and write images in that format. ✨ Either one of those functions may be NULL — no cap, that's allowed. 💅

The functions you supply must follow the same prototype as load_bitmap() and save_bitmap(). Here's the vibe:

BITMAP *load_dump(const char *filename, RGB *pal)
{
   ...
}

int save_dump(const char *filename, BITMAP *bmp, const RGB *pal)
{
   ...
}

   register_bitmap_file_type("dump", load_dump, save_dump);

it's giving pluggable image codecs and honestly? iconic. 👑

🌈 SEE ALSO 🌈

• load_bitmap(3)
• save_bitmap(3)

mwah 💋 that's the whole page, written for Allegro version 4.4.3 — yeah she's a little vintage but she ate, periodt. 🫶💖 go register a file type bestie, you got this 🧚✨