BlueGit

timfa questward

Files

questward / shared / lighting / tilePassable.js

tilePassable.js

tilePassable.js 1.6 KiB Download Raw
1import { CHUNK_SIZE } from "../protocol/constants.js";
2import {
3 blockLightOcclusionForBlock,
4 isGroundPassable,
5 LightOcclusion,
6 normalizeGround
7} from "../definitions/tiles.js";
8
9/**
10 * Light occlusion lookup from a chunk snapshot map keyed by "chunkX,chunkY".
11 * Returns {@link LightOcclusion} levels (not movement passability).
12 * Uses pre-baked {@link snapshot.occlusion} when present (see editor save / decodeChunkBlob).
13 */
14export function makeSnapshotLightOcclusion (chunks)
15{
16 return (tileX, tileY) =>
17 {
18 const chunkX = Math.floor(tileX / CHUNK_SIZE);
19 const chunkY = Math.floor(tileY / CHUNK_SIZE);
20 const snapshot = chunks.get(`${chunkX},${chunkY}`);
21 if (!snapshot)
22 { return LightOcclusion.clear; }
23 const localX = tileX - chunkX * CHUNK_SIZE;
24 const localY = tileY - chunkY * CHUNK_SIZE;
25 if (localX < 0 || localY < 0 || localX >= CHUNK_SIZE || localY >= CHUNK_SIZE)
26 { return LightOcclusion.clear; }
27 const index = localY * CHUNK_SIZE + localX;
28 if (Array.isArray(snapshot.occlusion) && snapshot.occlusion.length > index)
29 { return snapshot.occlusion[index] | 0; }
30 const ground = normalizeGround(snapshot.grounds?.[index]);
31 if (!isGroundPassable(ground.typeId))
32 { return LightOcclusion.solid; }
33 return blockLightOcclusionForBlock(snapshot.blocks?.[index]);
34 };
35}
36
37/**
38 * Legacy boolean clearance (`true` = not solid-occluding).
39 * Prefer {@link makeSnapshotLightOcclusion} for baked/dynamic falloff with partials.
40 */
41export function makeSnapshotPassable (chunks)
42{
43 const occlusionAt = makeSnapshotLightOcclusion(chunks);
44 return (tileX, tileY) => occlusionAt(tileX, tileY) !== LightOcclusion.solid;
45}