Sets a specific resource search path.
Sometimes Allegro doesn't look in enough places to find a resource. For
those special cases, you can call this function before loading your
resource with additional paths to search for. You set up the priorities,
higher numbers are searched for first. To modify an already setup path,
call this function with the same priority and the new path. To remove an
already setup path, call this function with the priority of the path and
NULL as the path parameter. Example:
These custom paths will be valid until you call allegro_exit(). You can
call this function before install_allegro(), but after set_uformat() if
you want to use a text encoding format other than the default.
Returns non-zero on success, zero if the path could not be added or you
wanted to remove a path and the priority used didn't have any associated
path. Modification of existing paths always succeeds.
The following projects include source code containing this keyword: