World Manipulation =)



void update(BITMAP *buffer)

buffer - Either a virtual screen (double buffer) or the actual screen to draw the map to.  To draw to the actual screen, pass in "screen" without quotes as the buffer name.

This function takes as it's only parameter a pointer to an Allegro
buffer to draw the entire map onto.  I recommend passing in a
double buffer here rather than a pointer to the screen, as the latter
will cause flickering.  For information on creating buffers in Allegro,
please see the create_bitmap() function in the Allegro.txt file that
comes with the Allegro distribution.
Call this function before doing your final blit to the screen.  I'd also
call it before drawing any players, as the players will need to be
standing on some kind of background.



int scroll(int xAmt, int yAmt)

xAmt - xAmt can be positive or negative, and is an amount in number of TILES to scroll the screen horizontally by.
yAmt - yAmt can be positive or negative, and is an amount in number of TILES to scroll teh screen vertically by.

returns - 0 on error (i.e. couldn't scroll requested amount) or else non-zero.

Scrolls the map world by whole tiles at a time.  Smooth scroling to eventually come.



int loadMap(char *name)

*name - A string containing the name of the map file to load

returns - 0 on error, NOT_CURRENT_VERSION if loading an older map file, or else 1 on success.

Loads a map from disk.  The path name must be absolute. 
VERY VERY SUPER HUGE IMPORTANT NOTE: When using this function,
due to the Allegro functions it uses, you must NOT, I REPEAT, must NOT
call this it until you've initialized Allegro.
This is useful for changing levels, or initializing a blank TL_Class
object.
NEW RETURN VALUE IN V0.3: Now returns the constant: NOT_CURRENT_VERSION
if the map is from a version less than this.  There's no problem loading
an old map, but it obviously won't have the features available in newer
ones.