@woosh/meep-engine 3.14.1 → 3.14.3

package/src/shade/renderer/hiz/HierarchicalZBuffer.js

@@ -1,274 +1,275 @@
-import { assert } from "../../../core/assert.js";
-import { max2 } from "../../../core/math/max2.js";
-import { TextureDescriptor } from "../../descriptor/texture/TextureDescriptor.js";
-import { TextureViewDescriptor } from "../../descriptor/texture/TextureViewDescriptor.js";
-import { compute_max_mip_count } from "../../util/compute_max_mip_count.js";
-import { HZB_TEXTURE_FORMAT } from "./HZB_TEXTURE_FORMAT.js";
-import { shader_hzb_reduce_any, shader_hzb_reduce_mip0 } from "./shader_hzb_reduce_any.js";
-import { shader_hzb_reduce_mip0_clip } from "./shader_hzb_reduce_mip0_clip.js";
-
-export class HierarchicalZBuffer {
-
-    /**
-     * @type {GPUTextureContext}
-     */
-    #texture;
-
-    /**
-     * @type {string|GPUTextureFormat}
-     */
-    #format = HZB_TEXTURE_FORMAT
-
-    /**
-     *
-     * @returns {GPUTextureContext}
-     */
-    get texture() {
-        return this.#texture;
-    }
-
-
-    /**
-     * @type {GraphicsContext}
-     */
-    #graphics;
-
-    /**
-     *
-     * @type {number[]}
-     */
-    #viewport_size = [1, 1];
-
-    /**
-     *
-     * @param {GraphicsContext} graphics
-     */
-    constructor(graphics) {
-        this.#graphics = graphics;
-
-        this.#texture = graphics.textures.contextFromDescriptor(TextureDescriptor.from({
-            label: "Hierarchical Z Buffer",
-            format: this.#format,
-            usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT,
-            mipLevelCount: 1,
-            size: [1, 1]
-        }));
-
-
-    }
-
-    /**
-     *
-     * @param {ShadeGPUCommandContext} encoder
-     * @param {GPUTextureContext} source
-     * @param {number[]} [source_offset] [x0,y0]
-     */
-    build(
-        encoder,
-        source,
-        source_offset
-    ) {
-
-        assert.defined(encoder, 'encoder');
-        assert.notNull(encoder, 'encoder');
-        assert.equal(encoder.isGPUCommandContext, true, 'encoder is not a GPUCommandContext')
-
-        assert.defined(source, 'source');
-        assert.notNull(source, 'source');
-        assert.equal(source.isGPUTextureContext, true, 'source is not a GPUTextureContext')
-
-        // the first pass is special, we need to read from source texture and write to first mip level of hzb
-
-        const texture = this.#texture;
-
-        assert.equal(texture.isDestroyed, false, 'texture is destroyed');
-
-        const mipLevelCount = texture.descriptor.mipLevelCount;
-
-        let source_view = source.obtainView(TextureViewDescriptor.from({
-            baseMipLevel: 0,
-            mipLevelCount: 1,
-            dimension: "2d",
-            baseArrayLayer: 0,
-            arrayLayerCount: 1
-        }));
-
-        const destination_view = texture.obtainView(TextureViewDescriptor.from({
-            baseMipLevel: 0,
-            mipLevelCount: 1,
-            dimension: "2d",
-            baseArrayLayer: 0,
-            arrayLayerCount: 1
-        }));
-
-        const viewport_size = this.#viewport_size;
-
-        const is_clipped_variant = source_offset !== undefined
-            && (
-                (
-                    source_offset[0] !== 0
-                    || source_offset[1] !== 0
-                )
-                || (
-                    viewport_size[0] !== source.width
-                    || viewport_size[1] !== source.height
-                )
-            );
-
-        if (is_clipped_variant) {
-            // special case for clip region
-
-            shader_hzb_reduce_mip0_clip.draw({
-                encoder,
-                bindings: {
-                    tInput: source_view,
-                    settings: {
-                        clip_region: [
-                            source_offset[0], source_offset[1],
-                            viewport_size[0], viewport_size[1],
-                        ],
-                        output_resolution: this.#mip_resolution(0),
-                    },
-                },
-                colorAttachments: [{
-                    view: destination_view,
-                    loadOp: 'clear',
-                    storeOp: 'store'
-                }]
-            })
-        } else {
-
-            this.#do_reduction_pass(encoder, shader_hzb_reduce_mip0, source_view, destination_view, 0);
-        }
-
-        source_view = destination_view;
-
-        for (let i = 1; i < mipLevelCount; i++) {
-
-            const destination_view = texture.obtainView(TextureViewDescriptor.from({
-                baseMipLevel: i,
-                mipLevelCount: 1,
-                dimension: "2d",
-                baseArrayLayer: 0,
-                arrayLayerCount: 1
-            }));
-
-            this.#do_reduction_pass(encoder, shader_hzb_reduce_any, source_view, destination_view, i);
-
-            // swap
-            source_view = destination_view;
-        }
-    }
-
-    /**
-     *
-     * @param {ShadeGPUCommandContext} encoder
-     * @param {ImageShader} shader
-     * @param {GPUTextureView} source_view
-     * @param {GPUTextureView} destination_view
-     * @param {number} index
-     * @param {number[]} [viewport]
-     */
-    #do_reduction_pass(
-        encoder,
-        shader,
-        source_view,
-        destination_view,
-        index,
-        viewport
-    ) {
-
-        shader.draw({
-            encoder,
-            bindings: {
-                tInput: source_view,
-                output_resolution: this.#mip_resolution(index),
-            },
-            colorAttachments: [
-                {
-                    view: destination_view,
-                    loadOp: 'clear',
-                    storeOp: 'store'
-                }
-            ],
-            viewport
-        })
-
-    }
-
-    /**
-     * Scratch for {@link #mip_resolution}. The value is serialised into the pass's immediate bytes
-     * before the next call, so one array can serve every mip.
-     *
-     * @type {number[]}
-     */
-    #mip_resolution_scratch = [1, 1];
-
-    /**
-     * Size of mip `index` of the HZB, which is what the reduction pass writing into it needs to know.
-     *
-     * Each mip halves the one above it, floored at one texel — the same walk that used to be
-     * precomputed into a uniform buffer of every mip's resolution and bound at a per-mip dynamic
-     * offset. As immediate data there is nothing to precompute into.
-     *
-     * @param {number} index
-     * @returns {number[]}
-     */
-    #mip_resolution(index) {
-        const size = this.#texture.size;
-
-        const out = this.#mip_resolution_scratch;
-
-        out[0] = max2(1, size[0] >>> index);
-        out[1] = max2(1, size[1] >>> index);
-
-        return out;
-    }
-
-    /**
-     *
-     * @param {number} x
-     * @param {number} y
-     */
-    setViewportSize(x, y) {
-        assert.isNonNegativeInteger(x, 'x');
-        assert.isNonNegativeInteger(y, 'y');
-
-        this.#viewport_size[0] = x;
-        this.#viewport_size[1] = y;
-
-        const hzb_w = Math.max(x >>> 1, 1);
-        const hzb_h = Math.max(y >>> 1, 1);
-
-        this.#resize(hzb_w, hzb_h);
-    }
-
-    /**
-     *
-     * @param {number} x
-     * @param {number} y
-     */
-    #resize(
-        x,
-        y
-    ) {
-
-        const texture = this.#texture;
-        const size = texture.size;
-
-        if (size[0] === x && size[1] === y) {
-            // no size change
-            return;
-        }
-
-        const mip_count = compute_max_mip_count(x, y);
-
-        texture.descriptor.mipLevelCount = mip_count;
-
-        texture.resize(x, y);
-    }
-
-    destroy() {
-        this.#texture.destroy();
-    }
-}
+import { assert } from "../../../core/assert.js";
+import { max2 } from "../../../core/math/max2.js";
+import { TextureDescriptor } from "../../descriptor/texture/TextureDescriptor.js";
+import { TextureViewDescriptor } from "../../descriptor/texture/TextureViewDescriptor.js";
+import { texture_mip_level_count } from "../../util/texture_mip_extent.js";
+import { HZB_TEXTURE_FORMAT } from "./HZB_TEXTURE_FORMAT.js";
+import { shader_hzb_reduce_any, shader_hzb_reduce_mip0 } from "./shader_hzb_reduce_any.js";
+import { shader_hzb_reduce_mip0_clip } from "./shader_hzb_reduce_mip0_clip.js";
+
+export class HierarchicalZBuffer {
+
+    /**
+     * @type {GPUTextureContext}
+     */
+    #texture;
+
+    /**
+     * @type {string|GPUTextureFormat}
+     */
+    #format = HZB_TEXTURE_FORMAT
+
+    /**
+     *
+     * @returns {GPUTextureContext}
+     */
+    get texture() {
+        return this.#texture;
+    }
+
+
+    /**
+     * @type {GraphicsContext}
+     */
+    #graphics;
+
+    /**
+     *
+     * @type {number[]}
+     */
+    #viewport_size = [1, 1];
+
+    /**
+     *
+     * @param {GraphicsContext} graphics
+     */
+    constructor(graphics) {
+        this.#graphics = graphics;
+
+        this.#texture = graphics.textures.contextFromDescriptor(TextureDescriptor.from({
+            label: "Hierarchical Z Buffer",
+            format: this.#format,
+            usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT,
+            mipLevelCount: 1,
+            size: [1, 1]
+        }));
+
+
+    }
+
+    /**
+     *
+     * @param {ShadeGPUCommandContext} encoder
+     * @param {GPUTextureContext} source
+     * @param {number[]} [source_offset] [x0,y0]
+     */
+    build(
+        encoder,
+        source,
+        source_offset
+    ) {
+
+        assert.defined(encoder, 'encoder');
+        assert.notNull(encoder, 'encoder');
+        assert.equal(encoder.isGPUCommandContext, true, 'encoder is not a GPUCommandContext')
+
+        assert.defined(source, 'source');
+        assert.notNull(source, 'source');
+        assert.equal(source.isGPUTextureContext, true, 'source is not a GPUTextureContext')
+
+        // the first pass is special, we need to read from source texture and write to first mip level of hzb
+
+        const texture = this.#texture;
+
+        assert.equal(texture.isDestroyed, false, 'texture is destroyed');
+
+        const mipLevelCount = texture.descriptor.mipLevelCount;
+
+        let source_view = source.obtainView(TextureViewDescriptor.from({
+            baseMipLevel: 0,
+            mipLevelCount: 1,
+            dimension: "2d",
+            baseArrayLayer: 0,
+            arrayLayerCount: 1
+        }));
+
+        const destination_view = texture.obtainView(TextureViewDescriptor.from({
+            baseMipLevel: 0,
+            mipLevelCount: 1,
+            dimension: "2d",
+            baseArrayLayer: 0,
+            arrayLayerCount: 1
+        }));
+
+        const viewport_size = this.#viewport_size;
+
+        const is_clipped_variant = source_offset !== undefined
+            && (
+                (
+                    source_offset[0] !== 0
+                    || source_offset[1] !== 0
+                )
+                || (
+                    viewport_size[0] !== source.width
+                    || viewport_size[1] !== source.height
+                )
+            );
+
+        if (is_clipped_variant) {
+            // special case for clip region
+
+            shader_hzb_reduce_mip0_clip.draw({
+                encoder,
+                bindings: {
+                    tInput: source_view,
+                    settings: {
+                        clip_region: [
+                            source_offset[0], source_offset[1],
+                            viewport_size[0], viewport_size[1],
+                        ],
+                        output_resolution: this.#mip_resolution(0),
+                    },
+                },
+                colorAttachments: [{
+                    view: destination_view,
+                    loadOp: 'clear',
+                    storeOp: 'store'
+                }]
+            })
+        } else {
+
+            this.#do_reduction_pass(encoder, shader_hzb_reduce_mip0, source_view, destination_view, 0);
+        }
+
+        source_view = destination_view;
+
+        for (let i = 1; i < mipLevelCount; i++) {
+
+            const destination_view = texture.obtainView(TextureViewDescriptor.from({
+                baseMipLevel: i,
+                mipLevelCount: 1,
+                dimension: "2d",
+                baseArrayLayer: 0,
+                arrayLayerCount: 1
+            }));
+
+            this.#do_reduction_pass(encoder, shader_hzb_reduce_any, source_view, destination_view, i);
+
+            // swap
+            source_view = destination_view;
+        }
+    }
+
+    /**
+     *
+     * @param {ShadeGPUCommandContext} encoder
+     * @param {ImageShader} shader
+     * @param {GPUTextureView} source_view
+     * @param {GPUTextureView} destination_view
+     * @param {number} index
+     * @param {number[]} [viewport]
+     */
+    #do_reduction_pass(
+        encoder,
+        shader,
+        source_view,
+        destination_view,
+        index,
+        viewport
+    ) {
+
+        shader.draw({
+            encoder,
+            bindings: {
+                tInput: source_view,
+                output_resolution: this.#mip_resolution(index),
+            },
+            colorAttachments: [
+                {
+                    view: destination_view,
+                    loadOp: 'clear',
+                    storeOp: 'store'
+                }
+            ],
+            viewport
+        })
+
+    }
+
+    /**
+     * Scratch for {@link #mip_resolution}. The value is serialised into the pass's immediate bytes
+     * before the next call, so one array can serve every mip.
+     *
+     * @type {number[]}
+     */
+    #mip_resolution_scratch = [1, 1];
+
+    /**
+     * Size of mip `index` of the HZB, which is what the reduction pass writing into it needs to know.
+     *
+     * Each mip halves the one above it, floored at one texel — the same walk that used to be
+     * precomputed into a uniform buffer of every mip's resolution and bound at a per-mip dynamic
+     * offset. As immediate data there is nothing to precompute into.
+     *
+     * @param {number} index
+     * @returns {number[]}
+     */
+    #mip_resolution(index) {
+        const size = this.#texture.size;
+
+        const out = this.#mip_resolution_scratch;
+
+        out[0] = max2(1, size[0] >>> index);
+        out[1] = max2(1, size[1] >>> index);
+
+        return out;
+    }
+
+    /**
+     *
+     * @param {number} x
+     * @param {number} y
+     */
+    setViewportSize(x, y) {
+        assert.isNonNegativeInteger(x, 'x');
+        assert.isNonNegativeInteger(y, 'y');
+
+        this.#viewport_size[0] = x;
+        this.#viewport_size[1] = y;
+
+        const hzb_w = Math.max(x >>> 1, 1);
+        const hzb_h = Math.max(y >>> 1, 1);
+
+        this.#resize(hzb_w, hzb_h);
+    }
+
+    /**
+     *
+     * @param {number} x
+     * @param {number} y
+     */
+    #resize(
+        x,
+        y
+    ) {
+
+        const texture = this.#texture;
+        const size = texture.size;
+
+        if (size[0] === x && size[1] === y) {
+            // no size change
+            return;
+        }
+
+        // a screen-space depth pyramid, 2D always
+        const mip_count = texture_mip_level_count(x, y, 1, "2d");
+
+        texture.descriptor.mipLevelCount = mip_count;
+
+        texture.resize(x, y);
+    }
+
+    destroy() {
+        this.#texture.destroy();
+    }
+}

package/src/shade/renderer/light/GPULightCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPULightCollection.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/light/GPULightCollection.js"],"names":[],"mappings":"AA6BA;IAwGI;;;;;;OAMG;IACH,mEA0BC;IAlID;;;OAGG;IACH,8BAEC;IAeD;;OAEG;IACH,4BAEC;IAED;;;;;;OAMG;IACH,6BAEC;IAWD;;OAEG;IACH,+CAEC;IA6BD;;;OAGG;IACH,qCAEC;IAGD,+BAIC;IA+ED;;;OAGG;IACH,mCAwBC;IAsED,gBAIC;;CACJ;4BAvT2B,gCAAgC;yCACnB,2CAA2C;kCAClD,iCAAiC"}
+{"version":3,"file":"GPULightCollection.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/light/GPULightCollection.js"],"names":[],"mappings":"AA6BA;IAwGI;;;;;;OAMG;IACH,mEA0BC;IAlID;;;OAGG;IACH,8BAEC;IAeD;;OAEG;IACH,4BAEC;IAED;;;;;;OAMG;IACH,6BAEC;IAWD;;OAEG;IACH,+CAEC;IA6BD;;;OAGG;IACH,qCAEC;IAGD,+BAIC;IAwFD;;;OAGG;IACH,mCAwBC;IAsED,gBAIC;;CACJ;4BAhU2B,gCAAgC;yCACnB,2CAA2C;kCAClD,iCAAiC"}