Parallax & preview
The author’s job is to describe the height field. The parallax controls decide how strongly the table shows that depth. The Diorama tips the whole table up so anyone can see it in 3D.
How the depth is drawn
Section titled “How the depth is drawn”The table is drawn in true perspective, as if from an eye high above the middle of the view. The floor you’re standing on — the ground, or the level your token is on — is drawn exactly where it lies. Anything higher leans away from the middle of the view and is drawn a little larger; anything lower draws in towards it. As you pan, near things slide past faster than far ones, the way they would under a camera.
Because it’s a real perspective, tall things hide what’s behind them: the far side of a tower is out of sight, and you see its near wall rise from the ground. Levels above you (decks, upper storeys, roofs) and tokens up on them, or on high ground, lean with the map.
Scene-wide controls
Section titled “Scene-wide controls”Open the inspector → expand Parallax (scene) at the bottom. These settings are scene-level and shared across every player in the room.
| Control | Range | What it does |
|---|---|---|
| Enabled | toggle | Master switch for the parallax effect. Off = a flat top-down map, regardless of what’s drawn. The drawn shapes still exist; the visual effect is just paused. |
| Strength | 0 to 0.5 (default 0.04) | How close the eye is to the map, so how far tall things lean. The default puts the eye 600 ft up: noticeable at the edges of the view, never distracting. 0.1 brings it to 240 ft (dramatic); 0.16 and above is as close as it goes (150 ft). Crank it temporarily to see what the height field is doing while you’re authoring. |
| Height scale | 0.5 to 2 (default 1) | A gamma curve on the height values. Below 1 squashes the contrast (everything is closer to the midground); above 1 exaggerates highs and lows. Useful when your authored heights are all subtle and you want a stronger effect without re-drawing. |
Depth on this device
Section titled “Depth on this device”Everyone at the table — players and GM — sets their own Depth in Settings → Table feel (the gear at the top right): Full, Light (half the lean, and lighter work for the device) or Off. It does not affect other players — useful if a machine is struggling, or if the effect is making someone queasy. The GM’s inspector has a shortcut, Depth off on this device.
The effect runs only when the scene has it Enabled and the device’s Depth isn’t Off.
Until you choose, Depth is Auto: Light on a touch screen or a low-power device, Off when the device asks for reduced motion, and Full everywhere else. A device that had parallax turned off before keeps it off until you choose.
The Diorama
Section titled “The Diorama”In a scene with heights, levels or a Map Foundry battle map, the Diorama key (the cube at the end of the dock across the top of the table) turns the table into a model you can tip and turn — for players and the GM alike. Its bar sits at the bottom of the screen, above the quick bar. It opens looking straight down, exactly as the table was, then tips back so the hills, decks, towers and trees stand up at their real heights, with the tokens standing on them.
- Drag to move about, right-drag (or Shift-drag) to turn and tip, scroll to come in or out. On a touch screen: one finger moves, two fingers pinch, twist and (moved up or down together) tip.
- Top-down (or T) looks straight down again; Tipped tips it back.
- Height ×1 / ×2 / ×3 stands the heights taller, to see subtle ones. It doesn’t change the scene.
- Exploded (or E), in a scene with levels, pulls them apart: each level lifts clear of the one under it, with its name beside it (“Upper decks · 40 ft”) and its tokens on it. Press it again to put them back.
- Back to the table (or Esc) returns to the table exactly as you left it.
Playing in the Diorama
Section titled “Playing in the Diorama”You can move your tokens without leaving it. Press on a token and drag: it follows your pointer over the ground at its own level, and when you let go it moves exactly as a drag at the table would — round walls, up the ways between levels, seen by everyone. A click on a token selects it. Dragging from a token you can’t move moves the view instead. Moving works in the Exploded view too.
You see what your own table shows, nothing more: fog stays where it is (unexplored ground lies flat and dark), levels above you are faded as they are at the table, and a canopy or leaves over a token are cut away round it so it’s never lost underneath. Alt + scroll still peeks a level up or down.
In a scene made with Create scene from a Map Foundry battle map, each tree stands on its trunk with its crown over the ground, so you can see under the trees and nothing cuts into the houses beside them. A scene made before shows its trees as the map’s heights have them; make it again (or Update scene) to stand them up. A ramp up from the ground — a bridge’s slope up from its bank, steps up to a wall — stands on walls down to the ground, so it looks solid; one between two raised levels stays open under it.
Battle maps stand up
Section titled “Battle maps stand up”In a scene made with Create scene from a Map Foundry battle map (a still one, for now: not yet an animated one), its buildings stand up as solid models: each house’s walls painted as the map paints them (stone, brick, timber frame, planks, plaster), with their doors and shuttered windows, under their roofs; the town wall with its walk along the top; round towers with their walks and, where the map has them, their slate cones; quays and cliffs down to the water and the ground below. Because the sides are really there, you can tip the Diorama much further, to nearly side-on, and look along a street.
A roof the table lifts for you (your token is inside, on a map made with roofs “both”) stays off here too, so you can see in. Fog hides buildings as it hides the ground: nothing of a house in ground nobody has explored shows, not even its outline. A scene made before shows its buildings as the map’s heights have them; make it again (or Update scene) to stand them up.
Elsewhere a painted map has no pictures of the sides of things, so the Diorama tips only so far; tall sides are drawn darker so they read as sides. The first time a scene has anything for the Diorama, a note points it out.
A Map Foundry battle map keeps moving in the Diorama, as it does at the table: its water runs and glints, its trees and the canopy’s crowns sway, its fires burn and its lamps breathe. Smoke, birds and a theme’s sparks, which the map draws over itself, are left out there, since they’d lie flat on the ground when you tip the view; their shadows stay. With Ambient Motion off, the Diorama holds still too.
A raised deck, a platform in the treetops or a bridge’s span stands on a thin edge of its own planks rather than floating paper-thin when you tip the view. On a phone or a tablet the Diorama is drawn in less detail and the decks’ edges are left out, so it stays smooth there.
Visualising the height field
Section titled “Visualising the height field”Expand the Visualise (GM) collapsible.
Heightmap overlay
Section titled “Heightmap overlay”The Heightmap overlay toggle paints the raw height texture directly over the basemap so you can see exactly what the engine is sampling.
- Black = depression (h = −1)
- Mid-grey = ground level (h = 0, no parallax)
- White = elevation (h = +1)
The opacity slider controls how much of the basemap shows through. The little black-to-white legend below the slider is your reference.
This is GM-only — players never see the overlay, regardless of the toggle.
Checking your heights in 3D
Section titled “Checking your heights in 3D”The dock’s cube opens the Diorama — the same view your players have — to check an elevation profile: rotate round it, stand the heights taller with Height ×3, and look for a slope that’s wrong or a region sticking up where you didn’t expect. To look down into what’s under a level, stand at or cut away to a lower one first (the level chip), then open it.
Flat while you draw
Section titled “Flat while you draw”The depth lies flat while you measure, place overlay tiles, draw or edit walls, or work the fog: what those tools draw is where things stand on the ground, and a wall’s line sits on its painting only on the map as it lies. It comes back as soon as you change tools.
Heights from a Map Foundry battle map
Section titled “Heights from a Map Foundry battle map”A battle map made with Create scene, or imported from its zip, brings its own heights: roofs and their ridges, towers, walls, trunks and trees. The parallax and the Diorama show them with nothing drawn by hand. They come in as the brush’s picture, so you can paint over them like any brush work.
The sides of tall things
Section titled “The sides of tall things”A painted top-down map has no picture of a tower’s walls, so where the perspective shows a side — between a tower’s foot and the drawn edge of its top — the map’s pixels at the edge are stretched down it, as the Diorama draws a cliff face. A hole’s far rim is hidden by its near one, and a tower hides the ground behind it.
You don’t need to configure anything. If a region feels too “stamped” at its edges, add a few pixels of Falloff to that region; the slope reads as a bank instead of a wall.
Pause-during-measure
Section titled “Pause-during-measure”When any player switches to the measure tool (the ruler), the depth is paused on their screen for the duration, so distances read against the map as it lies. The same happens while the GM places overlay tiles: a raised tile’s handles are where it lies, not where it leans.
Switch back to any other tool and the depth resumes. There’s no setting for this — it’s always on.
Diagnostics
Section titled “Diagnostics”The Diagnostics collapsible at the bottom shows internal state — useful when you’re debugging or filing a bug report:
- Status:
attached(the depth is drawing the map) ordetaching(it isn’t: off on this device, paused, or something’s wrong). - RT: the height texture’s pixel dimensions.
- Last rebuild: how long the last rasterizer rebuild took (typically 1–5 ms).
- Hash: the cache key. If two clients with the same scene see different parallax, their hashes should match — if they don’t, something’s out of sync.
- Clear all regions / ramps — destructive escape hatch.
Troubleshooting
Section titled “Troubleshooting”“I don’t see any parallax”
Section titled ““I don’t see any parallax””Run through these in order:
- Expand Parallax (scene) → is Enabled on?
- Settings → Table feel → Depth — is it Off? (Auto is Off when your device asks for reduced motion.)
- Is the Strength slider above 0?
- Have you actually drawn anything? An empty scene has nothing to parallax. Open the Heightmap overlay — if it’s all mid-grey, there are no heights to react to.
- Are you currently in the measure tool, or placing overlay tiles? Switch to a different tool — the depth pauses during both.
- Remember the floor you’re standing on never moves: on flat ground with nothing raised, there’s nothing to lean.
If none of those, check the Diagnostics — Status should read “attached.” If it says “detaching,” reload the page.
“The parallax is on the wrong area”
Section titled ““The parallax is on the wrong area””Open the Heightmap overlay. The greyscale heights should sit exactly where you intended them — if they don’t, the regions are misplaced (move them in the Polygon tab) or the wrong add blend is summing into a place you didn’t mean.
If the heights look right but the parallax looks wrong, your map’s mapWidth / mapHeight values may be out of sync with the basemap’s pixel dimensions. Check the Diagnostics → RT size against your basemap’s resolution.
“It’s making me feel sick”
Section titled ““It’s making me feel sick””Set Settings → Table feel → Depth to Light or Off. Your setting is per-device; other players keep the effect.
“It’s too strong / too weak”
Section titled ““It’s too strong / too weak””GM-side: drop Strength to 0.02 for very subtle, raise to 0.06 for noticeable. GM-side: turn Height scale down (0.7) to soften everything globally without re-drawing every region.
“Mobile is laggy”
Section titled ““Mobile is laggy””The system caps the height texture at half resolution on devices with low memory or a coarse pointer, and touch screens start on Light. If you’re still seeing performance issues, set Depth to Off in Settings — every drawn shape is preserved.
Related
Section titled “Related”- 2.5D height & parallax — overview — what the system does and the four authoring tools.
- Drawing regions — polygon, rectangle, circle.
- Ramps — linear gradients.
- Brush — freehand paint.