handle2 methods
A tilemap created by canvas:tilemap(atlas, opts). Cells index into the atlas; set(x, y, index) places a tile (0-based, bottom-left origin) and get(x, y) returns its index or nil for an empty/out-of-bounds cell. Rows count upward from the bottom — the vertical mirror of Grid's top-left Y-down frame — so copying Grid cells into a tilemap flips the row: ty = rows - 1 - gy.
DrawCanvas:tilemapThe examples on this page start from:
local canvas = datumhue.draw.new({
width = 160,
height = 120,
background = datumhue.color("#2d353b"),
})
canvas:mount({ width = 160, height = 120 })
local font = datumhue.image.font()
local map = canvas:tilemap(font, { columns = 16, rows = 4 })TileMap:set(x: number, y: number, index: number)Set cell (x, y) to atlas index. Raises if the cell is out of bounds (unlike Grid:set, which is a no-op there).
-- Columns count from 0 at the left, rows from 0 at the bottom.
-- A cell of the built-in font is its character code minus 32.
for x, code in ipairs({ string.byte("HELLO", 1, -1) }) do
map:set(x - 1, 3, code - 32)
endIn the guide: Pixel art and sprites
TileMap:get(x: number, y: number) -> integer?Read the atlas index at cell (x, y), or nil for an empty or out-of-bounds cell.
map:set(0, 0, 33)
print(map:get(0, 0)) --> 33
-- An empty cell, and one outside the map.
print(map:get(1, 0), map:get(16, 0)) --> nil nil