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

FreeBSD Manual Pages

  
 
  

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

NAME
       load_datafile_object - Loads a specific object from a datafile. Allegro
       game programming	library.

SYNOPSIS
       #include	<allegro.h>

       DATAFILE	*load_datafile_object(const char *filename,  const  char  *ob-
       jectname);

DESCRIPTION
       Loads  a	 specific object from a	datafile. This won't work if you strip
       the object names	from the file, and it will be very slow	 if  you  save
       the file	with global compression. Example:

	  /* Load only the music from the datafile. */
	  music_object = load_datafile_object("datafile.dat",
					      "MUSIC");
	  /* Play it and wait a	moment for it. */
	  play_midi(music_object->dat);
	  ...
	  /* Destroy unneeded music. */
	  unload_datafile_object(music_object);

RETURN VALUE
       Returns	a  pointer  to	a  single  DATAFILE element whose `dat'	member
       points to the object, or	NULL if	there was an error or there was	no ob-
       ject  with  the requested name. Remember	to free	this DATAFILE later to
       avoid memory leaks, but use the correct unloading function!

SEE ALSO
       unload_datafile_object(3),  load_datafile(3),  set_color_conversion(3),
       find_datafile_object(3),	register_datafile_object(3)

Allegro				 version 4.4.3	       load_datafile_object(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=load_datafile_object&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help