Map

This function loads a map. If you are using maps in your game, which is not strictly neccesary, this function is essential.

VERGE 3 format .MAP files are currently only created by MapEd 3.

Upon execution of this function, all code execution halts completely, never to be returned, and starts anew in the map's own vc's starting function. For a more in-depth discussion of the correlation between system-vc and map-vc, please view [this section].

//Example 1
/////////////////////////////////////////////

// this loads the map named "test.map" 
// located in the base verge directory.

map( "test.map" ); 



//Example 2
/////////////////////////////////////////////

// This demonstrate's map()'s ability to 
// stop all  functionality under it.

void grue_is_awesome() {
	map( "test.map" );
	exit( "GRUE SUXS!!!!" );
}

void autoexec() {
	grue_is_awesome();  
}

// When this program is executed, 
// as long as ./test.map exists, you will 
// load that map fine, and the program will 
// never exit with the "GRUE SUXS!!!!" 
// message.  This is because map() halts the
// function it was called in, and starts off anew in
// the map-vc.