ReadonlyheightReadonlyheightpixels of lift per elevation level
ReadonlyshapeReadonlytileReadonlytileReadonlywidthhow many cells currently draw side faces, for a debug overlay
how many chunks are currently drawn, for a debug overlay
world size, for setting camera bounds
Adds an autotile layer on top of the existing ones: each non-blank cell holds a raw MV tile id or XP tile value, and the map assembles that cell's quadrant halves straight from the source sheet - no prebuilt atlas canvas in between. Cells route to the set claiming their id, so one layer can span every A-sheet (or every autotile image) the same way one plain layer can span several sheets.
one raw id per cell, row-major; EMPTY (or at/below zero) for a blank cell. Every other value must fall in one of the sets' ranges, or the call throws naming it.
one source, or one per family slot (MV) or image index (XP).
import { TileMap, SpriteSheet, type AutotileSet } from '@datamoc/mwg/two-d/render';
declare const sheet: SpriteSheet; // a raw MV A1 sheet: 48px cells, slot 0
const map = new TileMap({ width: 4, height: 4, sheet });
const sea: AutotileSet = { sheet, slot: 0, animation: [[0, 1, 2]] };
map.addAutotileLayer('sea', new Array(16).fill(2048), sea);
map.setAutotileFrame('sea', 1);
console.log(map.getAutotileFrame('sea')); // 1
console.log(map.getTile('sea', 0, 0)); // 2048 - raw MV ids, EMPTY where blank
Adds a layer on top of the existing ones.
Optionaldata: ArrayLike<number>
one frame index per cell, row-major, EMPTY for a blank cell. A missing
array makes an empty layer to fill in later. On a multi-sheet map the values are
tileFrame packs rather than plain indices.
Adds a shadow layer: RPG Maker's per-cell shadow bits, drawn as translucent quarter-tile
quads. Bit 0 is the top-left quadrant, 1 top-right, 2 bottom-left, 3 bottom-right (the
engine's map layer 4). A cell holding 0 (or EMPTY) is clear. Shadow quads keep their own
colour whatever setCellColor does to the cell under them.
one bit set (0-15) per cell, row-major.
color (default black) and alpha (default 0.5, the engine's shadow).
resets every cell to undimmed
Switches off chunks the camera cannot see.
Call it once per frame. Culling by chunk rather than by tile is the point: a 200x200 map is 40 000 tiles but only 169 chunks, so the test runs a couple of hundred times instead of forty thousand.
the animation frame an autotile layer currently shows
the elevation of a cell in whole levels; off the map reads as ground
Advances an autotile layer's animation frame: every animated cell re-points its quadrant textures (MV kind cycles, XP frame stripes) while cells outside any cycle stay on frame zero's art. A repeated frame is a no-op.
Colours one cell across every layer.
This is the fog-of-war and lighting hook. tint multiplies, so it darkens; add is
the additive term, which is what lets an unseen-but-remembered tile wash out towards
grey rather than merely going dark. Side faces take the tint but not the add -
plain geometry has no batcher of its own to carry it.
Raises or lowers one cell, in whole levels.
Every layer's top tile moves up by one heightStep per level, and on the
diamond projections a raised cell grows two shaded side faces per level -
the left and right walls of the block, drawn into the bottom layer's chunk
behind the cell's own top, so rows in front still overlap correctly. Square
and hex cells lift without faces. A cell with no bottom-layer tile grows no
faces: nothing to be the side of. Negative heights sink the top with no
faces - pits are a hole, not an inverted block.
The usual source is an Elevation: map.setCellHeight(x, y, elevation.heightAt(x, y)) over every cell, after the layers are added.
fills a whole layer at once, which is what loading a map does
Replaces one cell. On an autotile layer the value is a raw autotile id rather than a frame index; EMPTY (or any value at or below zero) clears the cell there too.
Copies a width by height block of frames (row-major, EMPTY for a blank cell)
into a layer with its top-left corner at tile (x, y), leaving every other cell
alone. The block must fit inside the map: one that overflows would otherwise wrap
into the next row, so it throws instead.
The centre of a tile, in world units: where a character standing on it belongs.
Rides the cell's elevation: a raised cell reports its lifted top, so whoever is placed there stands on the block rather than inside it.
world point to tile coordinates
A grid of tiles, drawn as sprites.
Layers stack in the order they are added: a floor, then whatever stands on it, then a roof. Every layer shares one grid, so a cell's lighting applies to all of them at once, which is what fog of war needs, since an unseen floor and the wall on it have to dim together.
The map is chunked and culled against the camera, so its cost tracks what is on screen rather than how large the map is.
Cells can also carry an elevation (
setCellHeight): the top tile moves up by oneheightStepper level, and on the diamond projections (isometric, staggered) each level grows two shaded side faces, the classic raised-block look.tileCenterrides along, so whoever stands on the cell stands on top of it.Example
TileMapis aContainerof layerContainers ofTintedSpritetiles, not a sprite itself: settingmap.alphastill fades the whole map, since Pixi composes a container's alpha into every descendant's when rendering. There is no per-cell alpha alongsidesetCellColor's tint/add - a see-through tile (as opposed to a translucent creature standing on one, which isTintedSprite's own case) is not something any reference game has asked for yet.