import { CHUNK_SIZE, SPRITE_SIZE_PX } from "/shared/protocol/constants.js"; import { EMPTY_BLOCK_ROW_KEY, EMPTY_BLOOM_KEY } from "/shared/render/chunkAtlasKeys.js"; import { frameworkImageFromCanvas } from "./canvasSprite.js"; export { EMPTY_BLOCK_ROW_KEY, EMPTY_BLOOM_KEY } from "/shared/render/chunkAtlasKeys.js"; /** * LRU cache of baked chunk atlas canvases (ground, block rows, bloom). * Shared across chunks with identical tile visuals — skips CPU bake and GPU re-upload. */ export function createChunkAtlasCache ({ maxGround = 48, maxBlockRows = 96, maxBloom = 24 } = {}) { return new ChunkAtlasCache({ maxGround, maxBlockRows, maxBloom }); } class ChunkAtlasCache { #limits; #ground = new Map(); #blockRows = new Map(); #bloom = new Map(); #canvasEntry = new WeakMap(); constructor (limits) { this.#limits = limits; } acquireGround (key, factory) { return this.#acquire(this.#ground, key, factory, this.#limits.maxGround); } acquireBlockRow (key, factory) { if (key === EMPTY_BLOCK_ROW_KEY) { return this.#acquireEmptyBlockRow(); } return this.#acquire(this.#blockRows, key, factory, this.#limits.maxBlockRows); } acquireBloom (key, factory) { if (key === EMPTY_BLOOM_KEY) { return this.#acquireEmptyBloom(); } return this.#acquire(this.#bloom, key, factory, this.#limits.maxBloom); } getImage (entry) { if (!entry) { return null; } if (!entry.image) { entry.image = frameworkImageFromCanvas(entry.canvas); } return entry.image; } release (entry) { if (!entry) { return; } entry.refCount = Math.max(0, entry.refCount - 1); } markWarmed (canvas) { const entry = this.#canvasEntry.get(canvas); if (entry) { entry.warmed = true; } } isWarmed (canvas) { return this.#canvasEntry.get(canvas)?.warmed ?? false; } #acquireEmptyBlockRow () { let entry = this.#blockRows.get(EMPTY_BLOCK_ROW_KEY); if (!entry) { const canvas = makeCanvas(CHUNK_SIZE * SPRITE_SIZE_PX, SPRITE_SIZE_PX); entry = this.#makeEntry(EMPTY_BLOCK_ROW_KEY, canvas); this.#blockRows.set(EMPTY_BLOCK_ROW_KEY, entry); } entry.refCount += 1; entry.lastUsed = performance.now(); return entry; } #acquireEmptyBloom () { let entry = this.#bloom.get(EMPTY_BLOOM_KEY); if (!entry) { const size = CHUNK_SIZE * SPRITE_SIZE_PX; const canvas = makeCanvas(size, size); entry = this.#makeEntry(EMPTY_BLOOM_KEY, canvas); this.#bloom.set(EMPTY_BLOOM_KEY, entry); } entry.refCount += 1; entry.lastUsed = performance.now(); return entry; } #acquire (map, key, factory, limit) { let entry = map.get(key); if (entry) { entry.refCount += 1; entry.lastUsed = performance.now(); return entry; } const canvas = factory(); entry = this.#makeEntry(key, canvas); map.set(key, entry); this.#evict(map, limit); return entry; } #makeEntry (key, canvas) { const entry = { key, canvas, image: null, refCount: 1, warmed: false, lastUsed: performance.now() }; this.#canvasEntry.set(canvas, entry); return entry; } #evict (map, limit) { if (map.size <= limit) { return; } const candidates = [...map.values()] .filter((entry) => entry.refCount <= 0) .sort((a, b) => a.lastUsed - b.lastUsed); for (const entry of candidates) { if (map.size <= limit) { break; } map.delete(entry.key); this.#canvasEntry.delete(entry.canvas); } } } function makeCanvas (width, height) { const canvas = document.createElement("canvas"); canvas.width = width; canvas.height = height; return canvas; }