GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LOAD_DATAFILE_CALLBACK (3)

NAME

load_datafile_callback - Loads a datafile into memory, calling a hook per object. Allegro game programming library.

CONTENTS

Synopsis
Description
See Also

SYNOPSIS

#include <allegro.h>

DATAFILE *load_datafile_callback(const char *filename, void (*callback)(DATAFILE *d));

DESCRIPTION

Loads a datafile into memory, calling the specified hook function once for each object in the file, passing it a pointer to the object just read. You can use this to implement very simple loading screens where every time the hook is called, the screen is updated to let the user know your program is still loading from disk:

   void load_callback(DATAFILE *dat_obj)
   {
      static const char indicator[] = "-\\|/-.oOXOo.";
      static int current = 0;
      
      /* Show a different character every time. */
      textprintf_ex(screen, font, 0, 0, makecol(0, 0, 0),
                    makecol(255, 255, 255), "%c Loading %c",
                    indicator[current], indicator[current]);
      /* Increase index and check if we need to reset it. */
      current++;
      if (!indicator[current])
         current = 0;
   }
      ...
      dat = load_datafile_callback("data.dat", load_callback);

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(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)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro LOAD_DATAFILE_CALLBACK (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.