al_init_image_addon(3)

💅 al_init_image_addon(3) 💅

Okay bestie, welcome to the Library Functions Manual page for al_init_image_addon(3) — it's literally the Allegro 5 API, and the vibe is very “let’s get these image format handlers registered.” 🎀

🌸 NAME 🌸

al_init_image_addon — Allegro 5 API

✨ SYNOPSIS ✨

#include <allegro5/allegro_image.h>

bool al_init_image_addon(void)

🦋 DESCRIPTION 🦋

So al_init_image_addon initializes the image addon. The way that works is it registers bitmap format handlers for al_load_bitmap(3), al_load_bitmap_f(3), al_save_bitmap(3), and al_save_bitmap_f(3). Iconic behavior, no cap. 💖

The following types are built into the Allegro image addon and guaranteed to be available: BMP, DDS, PCX, TGA. Every platform also supports JPEG and PNG via external dependencies. Slay. ✨

Other formats may be available depending on the operating system and installed libraries, but they are not guaranteed and should not be assumed to be universally available. So like, lowkey important: don’t just assume every random format is gonna show up, bestie — vibe check your deps. 🫶

DDS tea ☕: the DDS format is only supported to load from, and only if the DDS file contains textures compressed in the DXT1, DXT3 and DXT5 formats. Also note that when loading a DDS file, the created bitmap will always be a video bitmap and will have the pixel format matching the format in the file. That’s the whole DDS situation, fr fr. 💅

✨ Sign-off sparkle: source/version is the Allegro reference manual, page al_init_image_addon(3), and the date is not listed in this footer — so that’s the whole footer tea. 🫶💜