AL_REGISTER_TRACE_HANDLER(3)

💖 NAME 💖

Hey bestie, welcome to al_register_trace_handler(3) from the Library Functions Manual — you're in the Allegro reference manual now, and this is the Allegro 5 API page for registering a trace handler 💅✨

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_register_trace_handler(void (*handler)(char const *))

---

🎀 DESCRIPTION 🎀

Okay so here's the whole vibe: you're registering a callback, and Allegro calls that callback whenever it writes something to its log files. Very “your logging setup has main character energy” 💖.

The default logging to allegro.log is disabled while this callback is active. So while your callback is doing its thing, the usual default file logging is off — periodt.

Pass NULL to revert to the default logging. Yep, just NULL, and Allegro goes back to its default-logging era 🫶.

This function may be called prior to al_install_system — yes, you can set it up before system install, no cap.

See the example allegro5.cfg for documentation on how to configure the used debug channels, logging levels and trace format. That's your cheat sheet for the debug-channel / logging-level / trace-format situation, iykyk 🦋.

---

⭐ SINCE ⭐

5.1.5 — iconic since this version, bestie 💜.

---

And that's the sparkly sign-off: Allegro reference manual out here representing al_register_trace_handler(3), with no date printed on this page — the vibes are timeless, fr fr 🎀✨