al_get_system_config(3alleg5)

✨ al_get_system_config ✨

okay bestie, welcome to the Allegro 5 API corner of the manual 💖 this one's short but it's giving main character config energy, so let's get into it 🎀

---

🌸 NAME 🌸

al_get_system_config — Allegro 5 API (yes that's the whole name, she's simple, she's iconic)

---

🦋 SYNOPSIS 🦋

#include <allegro5/allegro.h>

ALLEGRO_CONFIG *al_get_system_config(void)

---

💅 DESCRIPTION 💅

So basically, this function returns the system configuration structure. That's it, that's the whole vibe ✨

🚨 BIG ONE, bestie: the configuration you get back should NOT be destroyed with al_destroy_config(3alleg5). Not yours to destroy, hands off, no cap 🙈

What's it even for? Mainly for configuring Allegro and its addons. And here's the cute part — you can populate this config before Allegro is installed to control stuff like the logging levels and other features 👑

---

🧚 How Allegro fills this thing in 🧚

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

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

If it finds multiple copies, they get merged using al_merge_config_into(3alleg5) 🌈 — like a little config group hug, obsessed.

---

🍓 Where the contents are documented 🍓

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, iykyk 💜

__ALLEGRO_5_CFG

⚠️ Note, and this is important: Allegro will not look into that file unless you make a copy of it and place it next to your executable! So don't just sit there wondering why nothing's happening, bestie 😭

---

💖 cute sign-off 💖

and that's the tea 🫶 this page lives in the Allegro reference manual, filed under al_get_system_config(3alleg5). go forth and configure slayfully ✨💅🌸