set_allegro_resource_path(3alleg4) [debian man page]

set_allegro_resource_path(3alleg4)				  Allegro manual				set_allegro_resource_path(3alleg4)

NAME

       set_allegro_resource_path - Sets a specific resource search path. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

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

DESCRIPTION

       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:

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

       These custom paths will be valid until you call allegro_exit(). You can call this function before install_allegro(),  but  after  set_ufor-
       mat() if you want to use a text encoding format other than the default.

RETURN VALUE

       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 asso-
       ciated path. Modification of existing paths always succeeds.

SEE ALSO

       find_allegro_resource(3alleg4)

Allegro 							   version 4.4.2				set_allegro_resource_path(3alleg4)

find_allegro_resource(3alleg4)					  Allegro manual				    find_allegro_resource(3alleg4)

NAME

       find_allegro_resource - Searches for a support file in many places. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int  find_allegro_resource(char	*dest,	const  char  *resource,  const char *ext, const char *datafile, const char *objectname, const char
       *envvar, const char *subdir, int size);

DESCRIPTION

       Searches for a support file, eg. `allegro.cfg' or `language.dat'. Passed a resource string describing what you are looking for, along  with
       extra  optional information such as the default extension, what datafile to look inside, what the datafile object name is likely to be, any
       special environment variable to check, and any subdirectory that you would like to check as well as the	default  location,  this  function
       looks in a hell of a lot of different places :-). Pass NULL for the parameters you are not using.

       Check  the  documentation chapter specific to your platform for information on additional paths this function might search for. Also, don't
       forget about set_allegro_resource_path() to extend the searches. Example:

	  char path[256];
	  int ret;
	  ret = find_allegro_resource(path, "scores.cfg", NULL, NULL,
				      NULL, NULL, NULL, sizeof(path));
	  if (ret == 0) {
	     /* Found system wide scores file. */
	  } else {
	     /* No previous scores, create our own file. */
	  }

RETURN VALUE

       Returns zero on success, and stores a full path to the file (at most size bytes) into the dest buffer.

SEE ALSO

       set_allegro_resource_path(3alleg4)

Allegro 							   version 4.4.2				    find_allegro_resource(3alleg4)