Legacy:Functions/Map

Map and map engine control

• MapEngine(map_filename, fps): Start the map engine at map_filename at speed fps.
• GetCurrentMap(): Get the filename of the loaded map.
• ChangeMap(map_filename): Change the current map of the map engine.
• IsMapEngineRunning(): Check if the map engine is running or not.
• UpdateMapEngine(): Update state of map entities, animations and events in map engine.
• ExitMapEngine(): Flag the map engine to exit on the next update.

• RenderMap(): Draw all map layers and persons to the back buffer.
• GetMapEngineFrameRate(): Get the frames per second the map engine is running at.
• SetMapEngineFrameRate(fps): Change map engine frame rate.
• SetColorMask(color, frames): Draws color over the map engine for frames duration.

Map object

• Sphere Map object: Holds map data.

• GetMapEngine(): Obtain the current Map object.
• Map.save(filename): Save a Map object to filename.
• Map.layerAppend(layer_width, layer_height, tile_index): Adds a new layer to the Map object.

Map scripts

• SetRenderScript(script): Set script to run after each time the map is drawn.
• SetUpdateScript(script): Set script to run after each map engine update.

• CallMapScript(map_event): Call map script associated with the current map.
• CallDefaultMapScript(map_event): Call map script set by SetDefaultMapScript().
• SetDefaultMapScript(map_event, script): Set map engine to run script when map_event occurs for any map.
  • Map event constants:

    SCRIPT_ON_ENTER_MAP

    SCRIPT_ON_LEAVE_MAP

    SCRIPT_ON_LEAVE_MAP_NORTH

    SCRIPT_ON_LEAVE_MAP_EAST

    SCRIPT_ON_LEAVE_MAP_SOUTH

    SCRIPT_ON_LEAVE_MAP_WEST

• SetDelayScript(frames, script): Run script after frames delay.