Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
load_datafile(3)		 Allegro manual 		load_datafile(3)

NAME
     load_datafile  - Loads a datafile into memory. Allegro game programming li-
     brary.

SYNOPSIS
     #include <allegro.h>

     DATAFILE *load_datafile(const char *filename);

DESCRIPTION
     Loads a datafile into memory in one go. If the datafile has been encrypted,
     you must first call packfile_password() to set the appropriate key. If  the
     datafile  contains  truecolor graphics, you must set the video mode or call
     set_color_conversion() before loading it. Example:

	/* Load the resources for our game. */
	DATAFILE *dat = load_datafile("game.dat");
	if (!dat)
	   abort_on_error("Couldn't load sound resources!");
	/* Use resources. */
	...
	/* Destroy them when we don't need them any more. */
	unload_datafile(dat);

RETURN VALUE
     Returns a pointer to the DATAFILE, or NULL on error. Remember to free  this
     DATAFILE later to avoid memory leaks.

SEE ALSO
     load_datafile_callback(3),   unload_datafile(3),	load_datafile_object(3),
     set_color_conversion(3),	   fixup_datafile(3),	   packfile_password(3),
     find_datafile_object(3),	register_datafile_object(3),   excustom(3),  ex-
     data(3), exexedat(3), exgui(3), exsprite(3), exunicod(3)

Allegro 			  version 4.4.3 		load_datafile(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=load_datafile&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help