al_get_system_config(3)

okay so bestie, this is al_get_system_config(3) from the Library Functions Manual — the Allegro 5 API page, and it’s giving “small function, big config energy” ✨

💖 NAME 💖

• al_get_system_config — Allegro 5 API. She hands you the system configuration structure, periodt.

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

ALLEGRO_CONFIG *al_get_system_config(void)

🦋 DESCRIPTION 🦋

So this function returns the system configuration structure. The returned configuration should not be destroyed with al_destroy_config(3) — no cap, do not yeet it with that. It’s mainly used for configuring Allegro and its addons. You may populate this configuration before Allegro is installed to control things like the logging levels and other features 🫶.

Allegro will try to populate this configuration by loading a configuration file from a few different locations, in this order:

• Unix only: /etc/allegro5rc
• Unix only: $HOME/allegro5rc
• Unix only: $HOME/.allegro5rc
• allegro5.cfg next to the executable

If multiple copies are found, then they are merged using al_merge_config_into(3). Slay, merge behavior 💅.

The contents of this file are documented inside a prototypical allegro5.cfg that you can find in the root directory of the source distributions of Allegro. They are also reproduced below 👇.

⚠️ Note that Allegro will not look into that file unless you make a copy of it and place it next to your executable! Like, actually copy it, bestie — vibe alone will not make Allegro read it 💀.

              __ALLEGRO_5_CFG

xoxo, bestie — source/version: Allegro reference manual; date: not listed in the footer (so no made-up timestamp, no cap). Page: al_get_system_config(3) 🎀💜