/** * Per-chunk fluid (water / lava) atlas: render procedural shaders at true * SPRITE_SIZE_PX, then nearest-upscale the atlas to chunk world size. * * Tile placement uses the same Y-down screen space as Framework drawSprite * (no extra FBO Y-flip — that put N/S coasts on the wrong sides). */ import { CHUNK_SIZE, SPRITE_SIZE_PX } from "/shared/protocol/constants.js"; import { frameworkImageFromCanvas } from "./canvasSprite.js"; export const FLUID_ATLAS_PX = CHUNK_SIZE * SPRITE_SIZE_PX; /** * @param {import("../../frameworkv3/framework/engine/gl/glContext.js").default | object} glCtx * @returns {{ canvas: HTMLCanvasElement, tex: WebGLTexture, fb: WebGLFramebuffer, image: object, size: number } | null} */ export function createFluidAtlasTarget (glCtx) { const gl = glCtx?.gl; if (!gl) { return null; } const size = FLUID_ATLAS_PX; const canvas = document.createElement("canvas"); canvas.width = size; canvas.height = size; const tex = gl.createTexture(); gl.bindTexture(gl.TEXTURE_2D, tex); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST); gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, size, size, 0, gl.RGBA, gl.UNSIGNED_BYTE, null); // Seed WeakMap so Framework getTexture(canvas) returns this FBO color attachment. glCtx.textures.set(canvas, tex); const fb = gl.createFramebuffer(); gl.bindFramebuffer(gl.FRAMEBUFFER, fb); gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, tex, 0); const status = gl.checkFramebufferStatus(gl.FRAMEBUFFER); gl.bindFramebuffer(gl.FRAMEBUFFER, null); if (status !== gl.FRAMEBUFFER_COMPLETE) { gl.deleteFramebuffer(fb); gl.deleteTexture(tex); glCtx.textures.delete(canvas); return null; } return { canvas, tex, fb, image: frameworkImageFromCanvas(canvas), size }; } export function destroyFluidAtlasTarget (glCtx, target) { if (!target) { return; } const gl = glCtx?.gl; if (gl) { if (target.fb) { gl.deleteFramebuffer(target.fb); } if (target.tex) { gl.deleteTexture(target.tex); } } if (glCtx?.textures && target.canvas) { glCtx.textures.delete(target.canvas); } target.fb = null; target.tex = null; } /** * Bind atlas FBO, clear transparent, run drawFn with drawSprite matrix sized to atlas. * Restores framebuffer, viewport, and _lastWidth/_lastHeight. */ export function withFluidAtlasPass (glCtx, target, drawFn) { const gl = glCtx?.gl; if (!gl || !target?.fb) { return; } const prevFb = gl.getParameter(gl.FRAMEBUFFER_BINDING); const prevViewport = gl.getParameter(gl.VIEWPORT); const prevW = glCtx._lastWidth; const prevH = glCtx._lastHeight; const prevBlend = gl.isEnabled(gl.BLEND); try { glCtx._lastWidth = target.size; glCtx._lastHeight = target.size; gl.bindFramebuffer(gl.FRAMEBUFFER, target.fb); gl.viewport(0, 0, target.size, target.size); // Opaque replace — blending onto clear left 1px fringes / grid seams. gl.disable(gl.BLEND); gl.clearColor(0, 0, 0, 0); gl.clear(gl.COLOR_BUFFER_BIT); drawFn(); } finally { glCtx._lastWidth = prevW; glCtx._lastHeight = prevH; gl.bindFramebuffer(gl.FRAMEBUFFER, prevFb); gl.viewport(prevViewport[0], prevViewport[1], prevViewport[2], prevViewport[3]); if (!prevBlend) { gl.disable(gl.BLEND); } gl.blendFunc(gl.SRC_ALPHA, gl.ONE_MINUS_SRC_ALPHA); } } /** Pixel-space center of a chunk-local tile inside the FBO (Y-down, same as world). */ export function fluidAtlasTileCenter (localX, localY) { return { x: localX * SPRITE_SIZE_PX + SPRITE_SIZE_PX / 2, y: localY * SPRITE_SIZE_PX + SPRITE_SIZE_PX / 2 }; } /** * Draw one fluid tile into the currently bound atlas pass. * @param {object} glCtx * @param {{ * textureHtml: TexImageSource, * secondaryHtml?: TexImageSource | null, * localX: number, * localY: number, * shader: object, * uniforms: object, * uvRect?: { u0: number, v0: number, u1: number, v1: number } | null * }} opts */ export function drawFluidAtlasTile (glCtx, { textureHtml, secondaryHtml = null, localX, localY, shader, uniforms, uvRect = null }) { if (!textureHtml || !shader) { return; } const center = fluidAtlasTileCenter(localX, localY); const textures = secondaryHtml ? { u_secondary: glCtx.getTexture(secondaryHtml) } : null; glCtx.drawSprite({ texture: glCtx.getTexture(textureHtml), x: center.x, y: center.y, w: SPRITE_SIZE_PX, h: SPRITE_SIZE_PX, rotationDeg: 0, mirrorX: false, mirrorY: false, alpha: 1, uvRect: uvRect ?? { u0: 0, v0: 0, u1: 1, v1: 1 }, shader, uniforms, textures, lights: null }); }