set_alleg...ource_path(3alleg4)

💖 set_allegro_resource_path 💖

okay bestie, welcome to the Allegro manual, section 3alleg4 — yes we are IN the Allegro game programming library and we are thriving ✨

🌸 NAME 🌸

set_allegro_resource_path</p> — sets a specific resource search path. Allegro game programming library, no cap 🎀

✨ SYNOPSIS ✨

#include <allegro.h>

int set_allegro_resource_path(int priority, const char *path);

🦋 DESCRIPTION 🦋

so like. sometimes Allegro just does NOT look in enough places to find a resource 😭 and honestly? relatable. For those special cases, you can call this function before loading your resource and hand it extra paths to search. You set up the priorities yourself, and higher numbers get searched for first. periodt.

• wanna modify a path that's already set up? call this function again with the same priority and the new path 💅
• wanna remove a path that's already set up? call this function with that path's priority and NULL as the path parameter. bye bestie 👋

Example, because we love a demo:

set_allegro_resource_path(10, "my_game/configs");
set_allegro_resource_path(0, "users/configs/");
set_allegro_resource_path(-45, "temp");

These custom paths stay valid until you call allegro_exit(). iconic behavior honestly.

Also! You can call this function before install_allegro(), but after set_uformat() if you wanna use a text encoding format that isn't the default. iykyk 🧚

💜 RETURN VALUE 💜

Returns non-zero on success 🎉, and zero if the path could not be added — OR if you wanted to remove a path and the priority you used didn't have any associated path (rip 💀). But listen: modification of existing paths always succeeds. always. no notes. 👑

👑 SEE ALSO 👑

• find_allegro_resource(3alleg4)

that's the whole vibe, bestie 🫶 this lil page came straight from the Allegro manual, version 4.4.3 — go forth and set those resource paths, you absolute main character 🌈⭐💅