game_load

game_load(STRING* name,var num)

Loads a saved game in the savedir folder.

Parameters:

name	STRING* or char*, name of the file to be loaded (without number and extension).
num	number of up to three digits to be attached to the file name. The extension ".sav " will be added automatically.

Returns:

> 0 - successfully loaded, <= 0 - file couldn't be loaded.

Speed:

Slow

Remarks:

When the level is changed, loading can take longer than a few seconds. The on_level event is executed during level loading and can be used to display a progress bar or animation on a panel.
Dynamic physics entities must be unregistered before loading, and registered again afterwards. If required, their angular and linear velocities can be read before saving, stored in entity skills, and restored after loading.
See game_save for further remarks on loading or saving games.

Example:

// Load the game"test7.sav" that was saved before
if (game_load("test",7) <= 0) { print("Load Error!"); }

See also:

game_save, savedir, level_load, on_level, on_load ► latest version online