datafile(3alleg4) [netbsd man page]

DATAFILE(3alleg4)						  Allegro manual						 DATAFILE(3alleg4)

NAME

       DATAFILE - Stores an Allegro datafile in memory.

SYNOPSIS

       #include <allegro.h>

       typedef struct DATAFILE

DESCRIPTION

	  void *dat;	 - pointer to the actual data
	  int type;	 - type of the data
	  long size;	 - size of the data in bytes
	  void *prop;	 - list of object properties

       Read chapter "Datafile routines", section "Using datafiles" for a description on how to obtain/use this structure.

SEE ALSO

       load_datafile(3alleg4), excustom(3alleg4), exdata(3alleg4), exexedat(3alleg4), exgui(3alleg4), exsprite(3alleg4), exunicod(3alleg4)

Allegro 							   version 4.4.2						 DATAFILE(3alleg4)

load_datafile(3alleg4)						  Allegro manual					    load_datafile(3alleg4)

NAME

       load_datafile - Loads a datafile into memory. Allegro game programming library.

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(3alleg4),       unload_datafile(3alleg4),       load_datafile_object(3alleg4),	    set_color_conversion(3alleg4),
       fixup_datafile(3alleg4),  packfile_password(3alleg4),  find_datafile_object(3alleg4), register_datafile_object(3alleg4), excustom(3alleg4),
       exdata(3alleg4), exexedat(3alleg4), exgui(3alleg4), exsprite(3alleg4), exunicod(3alleg4)

Allegro 							   version 4.4.2					    load_datafile(3alleg4)