76 lines
2.4 KiB
Lua
76 lines
2.4 KiB
Lua
-- Manages game maps.
|
|
--- @section Map
|
|
|
|
|
|
local _maps = {}
|
|
|
|
--- Gets all registered maps as an array.
|
|
--- @within Map
|
|
--- @return result table An array of registered map data. </br>
|
|
--- Fields: </br>
|
|
--- * id (string) Unique map identifier.<br/>
|
|
--- * from_x (number) Source tile X coordinate in the map sheet.<br/>
|
|
--- * from_y (number) Source tile Y coordinate in the map sheet.<br/>
|
|
--- * width (number) Width in tiles.<br/>
|
|
--- * height (number) Height in tiles.<br/>
|
|
--- * to_x (number) Destination X coordinate on screen.<br/>
|
|
--- * to_y (number) Destination Y coordinate on screen.<br/>
|
|
function Map.get_maps_array()
|
|
local maps_array = {}
|
|
for _, map_data in pairs(_maps) do
|
|
table.insert(maps_array, map_data)
|
|
end
|
|
return maps_array
|
|
end
|
|
|
|
--- Registers a map definition.
|
|
--- @within Map
|
|
--- @param map_data table The map data table.
|
|
--- @param map_data.id string Unique map identifier.<br/>
|
|
--- @param map_data.from_x number Source tile X coordinate in the map sheet.<br/>
|
|
--- @param map_data.from_y number Source tile Y coordinate in the map sheet.<br/>
|
|
--- @param map_data.width number Width in tiles.<br/>
|
|
--- @param map_data.height number Height in tiles.<br/>
|
|
--- @param map_data.to_x number Destination X coordinate on screen.<br/>
|
|
--- @param map_data.to_y number Destination Y coordinate on screen.<br/>
|
|
function Map.register(map_data)
|
|
if _maps[map_data.id] then
|
|
trace("Warning: Overwriting map with id: " .. map_data.id)
|
|
end
|
|
_maps[map_data.id] = map_data
|
|
end
|
|
|
|
--- Gets a map by ID.
|
|
--- @within Map
|
|
--- @param map_id string The ID of the map.
|
|
--- @return result table The map data table or nil. </br>
|
|
--- Fields: </br>
|
|
--- * id (string) Unique map identifier.<br/>
|
|
--- * from_x (number) Source tile X coordinate in the map sheet.<br/>
|
|
--- * from_y (number) Source tile Y coordinate in the map sheet.<br/>
|
|
--- * width (number) Width in tiles.<br/>
|
|
--- * height (number) Height in tiles.<br/>
|
|
--- * to_x (number) Destination X coordinate on screen.<br/>
|
|
--- * to_y (number) Destination Y coordinate on screen.<br/>
|
|
function Map.get_by_id(map_id)
|
|
return _maps[map_id]
|
|
end
|
|
|
|
--- Draws a map.
|
|
--- @within Map
|
|
--- @param map_id string The ID of the map to draw.
|
|
function Map.draw(map_id)
|
|
local map_data = Map.get_by_id(map_id)
|
|
if not map_data then
|
|
return
|
|
end
|
|
map(
|
|
map_data.from_x,
|
|
map_data.from_y,
|
|
map_data.width,
|
|
map_data.height,
|
|
map_data.to_x,
|
|
map_data.to_y
|
|
)
|
|
end
|