map

map [x=0 y=0] [w=30 h=17] [sx=0 sy=0] [colorkey=-1] [scale=1] [remap=nil] [cellx celly cellw cellh [sx sy [colorkey] ] ]

Parameters:

x : The left-most cell to start drawing the map.
y : The top-most cell to start drawing the map.
w : The amount of cells to draw horizontally from cellx.
h : The amount of cells to draw vertically from celly.
sx : The x coordinate to draw the map to the screen.
sy : The y coordinate to draw the map to the screen.
colorkey : The indexed color (0-15) to use as the alpha channel. Not setting this parameter will apply no blending.
remap: function callback called before every tile drawing, you can show/hide tiles on map rendering stage (also, you can remap tile index to make map animation or even flip/rotate): callback [tile [x y] ] -> [tile [flip [rotate] ] ]

Description:

The map is measured in cells, 8x8 blocks where you can place sprites in the map editor. This function will draw the entire map, or parts of it. The map's cell limit is 240x136.

Example:

--divide the map into rooms
rooms = {}
 for x = 0,240-30,30 do
  for y = 0,136-17,17 do
   table.insert(rooms, {x,y})
  end
 end

--returns the room by index (1-64)
function rget(i)
 return rooms[i][1],rooms[i][2],30,17
end

function TIC()
 cls()
 map(rget(64))
end