@woosh/meep-engine 3.57.0 → 3.59.0

package/src/shade/renderer/shadow/vsm/VSM_MOVER_LAYOUT.js

@@ -1,75 +0,0 @@
-import { FLOAT32_MAX } from "../../../../core/binary/FLOAT32_MAX.js";
-import { atomic_u32, u32, vec4f } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
-
-/**
- * Movers a frame lists at most: casters whose bounds or transform changed since the last frame, each
- * with the world box it covers now and covered then. Past this many, every occupied page of every
- * virtual shadow map is taken to be stale for the frame, and the overflow is counted.
- *
- * @type {number}
- */
-export const VSM_MOVER_CAPACITY = 4096;
-
-/**
- * The scene's mover list, written by the mover passes and read by every map's stale pass.
- *
- * `count` is the atomic the movers appended with, so a count past {@link VSM_MOVER_CAPACITY} says the
- * list overflowed. `boxes` holds two vec4s per mover: the world box's min and max corners in `xyz`.
- *
- * @type {WebGPUStruct}
- */
-export const VSM_MOVERS_STRUCT = WebGPUStruct.from({
-    count: atomic_u32,
-    pad_0: u32,
-    pad_1: u32,
-    pad_2: u32,
-    boxes: WebGPUArray.from(vec4f),
-}, "VSMMovers");
-
-/**
- * The same buffer as the stale pass reads it: the count as a plain word.
- *
- * @type {WebGPUStruct}
- */
-export const VSM_MOVERS_READ_STRUCT = WebGPUStruct.from({
-    count: u32,
-    pad_0: u32,
-    pad_1: u32,
-    pad_2: u32,
-    boxes: WebGPUArray.from(vec4f),
-}, "VSMMoversRead");
-
-/**
- * Bytes of the mover list at {@link VSM_MOVER_CAPACITY}.
- *
- * @type {number}
- */
-export const VSM_MOVERS_BYTE_SIZE = 16 + VSM_MOVER_CAPACITY * 2 * 16;
-
-/**
- * What a world box holds when it holds nothing: min past max on every axis, so that `min` and `max`
- * against it return the other box unchanged. The largest finite f32, since WGSL will not fold an
- * infinity.
- *
- * @type {number}
- */
-export const VSM_EMPTY_BOUND = FLOAT32_MAX;
-
-/**
- * Words the mover pass remembers a `meshes` row by, from one frame to the next: the world box it saw
- * the row with — six f32s, by their bits, empty for a row that held nothing — then the row's
- * geometry and material, {@link GPU_DATABASE_NULL} for a row that held nothing.
- *
- * @type {number}
- */
-export const VSM_LAST_SEEN_WORDS = 8;
-
-/**
- * Where a row's geometry and material sit among its {@link VSM_LAST_SEEN_WORDS}.
- *
- * @type {number}
- */
-export const VSM_LAST_SEEN_GEOMETRY = 6;
-export const VSM_LAST_SEEN_MATERIAL = 7;

package/src/shade/renderer/shadow/vsm/shader/chunk_vsm_append_mover.d.ts

@@ -1,14 +0,0 @@
-/**
- * Append a lane's mover to the scene's mover list — `movers`, a `VSMMovers` the including shader
- * binds read-write — through {@link chunk_subgroup_append_slot}: one atomic per subgroup, and the
- * mover's box written into the slot it was given.
- *
- * Every lane of the subgroup must call it, mover or not, from uniform control flow. Past `capacity`
- * the count still rises — that is how the stale pass knows the list overflowed — but nothing is
- * written.
- *
- * @type {CodeChunk}
- */
-export const chunk_vsm_append_mover: CodeChunk;
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-//# sourceMappingURL=chunk_vsm_append_mover.d.ts.map

package/src/shade/renderer/shadow/vsm/shader/chunk_vsm_append_mover.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk_vsm_append_mover.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/vsm/shader/chunk_vsm_append_mover.js"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,qCAFU,SAAS,CAgBjB;0BA3BwB,uCAAuC"}

package/src/shade/renderer/shadow/vsm/shader/chunk_vsm_append_mover.js

@@ -1,32 +0,0 @@
-import {
-    chunk_subgroup_append_slot,
-    SUBGROUP_APPEND_NONE
-} from "../../../shader/chunk/subgroup/chunk_subgroup_append_slot.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-
-/**
- * Append a lane's mover to the scene's mover list — `movers`, a `VSMMovers` the including shader
- * binds read-write — through {@link chunk_subgroup_append_slot}: one atomic per subgroup, and the
- * mover's box written into the slot it was given.
- *
- * Every lane of the subgroup must call it, mover or not, from uniform control flow. Past `capacity`
- * the count still rises — that is how the stale pass knows the list overflowed — but nothing is
- * written.
- *
- * @type {CodeChunk}
- */
-export const chunk_vsm_append_mover = CodeChunk.from(
-    //language=WGSL
-    `
-fn vsm_append_mover(is_mover: bool, box_min: vec3f, box_max: vec3f, capacity: u32) {
-    let slot = subgroup_append_slot(&movers.count, is_mover, capacity);
-
-    if (slot != ${SUBGROUP_APPEND_NONE}u) {
-        movers.boxes[slot * 2u] = vec4f(box_min, 0.0);
-        movers.boxes[slot * 2u + 1u] = vec4f(box_max, 0.0);
-    }
-}
-`, [
-        chunk_subgroup_append_slot,
-    ]
-);

package/src/shade/renderer/shadow/vsm/shader/shader_vsm_movers.d.ts

@@ -1,30 +0,0 @@
-export const VSM_MOVERS_WORKGROUP_SIZE: number;
-/**
- * What the mover pass runs with: how many rows the "last seen" buffer covers, how many movers the
- * list holds, and the dispatch's shape — `group_count` workgroups folded into rows of `groups_x`,
- * since a table's pages can take more than one dimension of a dispatch holds.
- *
- * @type {WebGPUStruct}
- */
-export const VSM_MOVERS_SETTINGS_STRUCT: WebGPUStruct;
-/**
- * List the casters that moved since the last frame, for every virtual shadow map's stale pass.
- *
- * One thread per slot of the `meshes` table, freed pages included, against a buffer of what each
- * row was when the pass last saw it ({@link VSM_LAST_SEEN_WORDS}). A row moved when its world matrix
- * differs from the one the hierarchy pass kept from last frame, or when its world box, geometry or
- * material differs from the one the pass saw — which is also how a row that appeared or left shows.
- * A change to a material's parameters, the same material, is not seen. Nothing about a row is
- * declared; what changed is observed. A mover is listed with the union of its box now and then:
- * every page either one covers may hold its old shadow, or lack its new one.
- *
- * Dispatch with as many workgroups as the "last seen" buffer's rows need at
- * {@link VSM_MOVERS_WORKGROUP_SIZE} — the table's pages, times its groups per page — folded into rows
- * of at most a dispatch dimension's limit, and once per frame, before the stale passes.
- *
- * @type {ComputeShader}
- */
-export const shader_vsm_movers: ComputeShader;
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_vsm_movers.d.ts.map

package/src/shade/renderer/shadow/vsm/shader/shader_vsm_movers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shader_vsm_movers.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/vsm/shader/shader_vsm_movers.js"],"names":[],"mappings":"AAmBA,+CAA2E;AAE3E;;;;;;GAMG;AACH,yCAFU,YAAY,CAOE;AAiIxB;;;;;;;;;;;;;;;;GAgBG;AACH,gCAFU,aAAa,CAMpB;6BA9K0B,sCAAsC;8BALrC,kCAAkC"}

package/src/shade/renderer/shadow/vsm/shader/shader_vsm_movers.js

@@ -1,184 +0,0 @@
-import { WebGPUExtensionType } from "../../../../descriptor/WebGPUExtensionType.js";
-import { chunk_scene_database_access, MESHES_TABLE } from "../../../scene/chunk_scene_database_access.js";
-import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
-import { GPU_DATABASE_NULL } from "../../../buffer/table/GPU_DATABASE_NULL.js";
-import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import {
-    VSM_EMPTY_BOUND,
-    VSM_LAST_SEEN_GEOMETRY,
-    VSM_LAST_SEEN_MATERIAL,
-    VSM_LAST_SEEN_WORDS,
-    VSM_MOVERS_STRUCT
-} from "../VSM_MOVER_LAYOUT.js";
-import { chunk_vsm_append_mover } from "./chunk_vsm_append_mover.js";
-
-export const VSM_MOVERS_WORKGROUP_SIZE = COMPUTE_SHADER_DEFAULT_GROUP_SIZE;
-
-/**
- * What the mover pass runs with: how many rows the "last seen" buffer covers, how many movers the
- * list holds, and the dispatch's shape — `group_count` workgroups folded into rows of `groups_x`,
- * since a table's pages can take more than one dimension of a dispatch holds.
- *
- * @type {WebGPUStruct}
- */
-export const VSM_MOVERS_SETTINGS_STRUCT = WebGPUStruct.from({
-    row_count: u32,
-    capacity: u32,
-    groups_x: u32,
-    group_count: u32,
-}, "VSMMoversSettings");
-
-const WG = VSM_MOVERS_WORKGROUP_SIZE;
-const PG = MESHES_TABLE.page_iterator_symbol_prefix(WG);
-
-const resources = new ShaderResourceSetDescriptor();
-
-resources.setImmediate('settings', VSM_MOVERS_SETTINGS_STRUCT);
-
-resources.createGroup()
-    .addStorageBuffer('scene_database', WebGPUArray.from(u32), false)
-    // per mesh row, what the pass saw it as last frame: its world box by the bits of its floats,
-    // then its geometry and material — empty and NULL for a row that held nothing
-    .addStorageBuffer('last_seen', WebGPUArray.from(u32), true)
-    .addStorageBuffer('movers', VSM_MOVERS_STRUCT, true);
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-const EMPTY = ${VSM_EMPTY_BOUND};
-const NO_MESH = ${GPU_DATABASE_NULL}u;
-const WORDS = ${VSM_LAST_SEEN_WORDS}u;
-
-@compute @workgroup_size(${WG},1,1)
-fn main(
-    @builtin(workgroup_id) wg_id: vec3<u32>,
-    @builtin(local_invocation_index) local_id: u32,
-) {
-    // the dispatch's workgroups, folded into rows; the last row's tail past the count has nothing to
-    // walk, and leaves whole
-    let group_index = wg_id.x + wg_id.y * settings.groups_x;
-
-    if (group_index >= settings.group_count) {
-        return;
-    }
-
-    // the page iterator's own arithmetic, done here too: a page that has been freed is still walked,
-    // since the rows it held may have been casters a moment ago
-    let page_index = group_index / ${PG}_GROUPS_PER_PAGE;
-    let page_group = group_index % ${PG}_GROUPS_PER_PAGE;
-    let slot = page_group * ${WG}u + local_id;
-    let row = page_index * ${PG}_ELEMENTS_PER_PAGE + slot;
-
-    let tracked = slot < ${PG}_ELEMENTS_PER_PAGE && row < settings.row_count;
-
-    // the page address is uniform across the workgroup, so this is too
-    let allocated = ${PG}_setup(&scene_database, group_index, local_id);
-
-    var occupied = false;
-
-    if (allocated && slot < ${PG}_ELEMENTS_PER_PAGE) {
-        occupied = ${PG}_is_occupied(slot);
-    }
-
-    var now_min = vec3f(EMPTY);
-    var now_max = vec3f(-EMPTY);
-    var now_geometry = NO_MESH;
-    var now_material = NO_MESH;
-    var turned = false;
-
-    if (occupied) {
-        let mesh = ${PG}_read(&scene_database, slot);
-
-        now_geometry = mesh.geometry;
-        now_material = mesh.material;
-
-        now_min = vec3f(mesh.bounding_box[0], mesh.bounding_box[1], mesh.bounding_box[2]);
-        now_max = vec3f(mesh.bounding_box[3], mesh.bounding_box[4], mesh.bounding_box[5]);
-
-        // the hierarchy pass keeps last frame's world matrix beside this frame's: any change of the
-        // transform, including a turn that leaves the box where it was
-        let node = scene_read_node(&scene_database, mesh.node);
-
-        turned = any(node.global[0] != node.prev_global[0])
-            || any(node.global[1] != node.prev_global[1])
-            || any(node.global[2] != node.prev_global[2])
-            || any(node.global[3] != node.prev_global[3]);
-    }
-
-    var is_mover = false;
-    var box_min = now_min;
-    var box_max = now_max;
-
-    if (tracked) {
-        let base = row * WORDS;
-
-        let then_min = vec3f(
-            bitcast<f32>(last_seen[base]),
-            bitcast<f32>(last_seen[base + 1u]),
-            bitcast<f32>(last_seen[base + 2u]),
-        );
-        let then_max = vec3f(
-            bitcast<f32>(last_seen[base + 3u]),
-            bitcast<f32>(last_seen[base + 4u]),
-            bitcast<f32>(last_seen[base + 5u]),
-        );
-
-        // a row that appeared, left or changed shape has a box it did not have before; one given
-        // another mesh may keep its box, but not its geometry or material
-        let changed = any(now_min != then_min) || any(now_max != then_max)
-            || now_geometry != last_seen[base + ${VSM_LAST_SEEN_GEOMETRY}u]
-            || now_material != last_seen[base + ${VSM_LAST_SEEN_MATERIAL}u];
-
-        // where it is and where it was; an empty box is the identity of both
-        box_min = min(now_min, then_min);
-        box_max = max(now_max, then_max);
-
-        is_mover = (changed || turned) && all(box_min <= box_max);
-
-        last_seen[base] = bitcast<u32>(now_min.x);
-        last_seen[base + 1u] = bitcast<u32>(now_min.y);
-        last_seen[base + 2u] = bitcast<u32>(now_min.z);
-        last_seen[base + 3u] = bitcast<u32>(now_max.x);
-        last_seen[base + 4u] = bitcast<u32>(now_max.y);
-        last_seen[base + 5u] = bitcast<u32>(now_max.z);
-        last_seen[base + ${VSM_LAST_SEEN_GEOMETRY}u] = now_geometry;
-        last_seen[base + ${VSM_LAST_SEEN_MATERIAL}u] = now_material;
-    }
-
-    vsm_append_mover(is_mover, box_min, box_max, settings.capacity);
-}
-`, [
-    MESHES_TABLE.chunk_iterate(WG),
-    chunk_scene_database_access,
-    chunk_vsm_append_mover,
-]);
-
-body.addExtension(WebGPUExtensionType.Subgroups);
-
-/**
- * List the casters that moved since the last frame, for every virtual shadow map's stale pass.
- *
- * One thread per slot of the `meshes` table, freed pages included, against a buffer of what each
- * row was when the pass last saw it ({@link VSM_LAST_SEEN_WORDS}). A row moved when its world matrix
- * differs from the one the hierarchy pass kept from last frame, or when its world box, geometry or
- * material differs from the one the pass saw — which is also how a row that appeared or left shows.
- * A change to a material's parameters, the same material, is not seen. Nothing about a row is
- * declared; what changed is observed. A mover is listed with the union of its box now and then:
- * every page either one covers may hold its old shadow, or lack its new one.
- *
- * Dispatch with as many workgroups as the "last seen" buffer's rows need at
- * {@link VSM_MOVERS_WORKGROUP_SIZE} — the table's pages, times its groups per page — folded into rows
- * of at most a dispatch dimension's limit, and once per frame, before the stale passes.
- *
- * @type {ComputeShader}
- */
-export const shader_vsm_movers = ComputeShader.from({
-    label: "VSM/Movers",
-    body,
-    resources,
-});

package/src/shade/renderer/shadow/vsm/shader/shader_vsm_skinned_movers.d.ts

@@ -1,23 +0,0 @@
-export const VSM_SKINNED_MOVERS_WORKGROUP_SIZE: 64;
-/**
- * @type {WebGPUStruct}
- */
-export const VSM_SKINNED_MOVERS_SETTINGS_STRUCT: WebGPUStruct;
-/**
- * List every skinned mesh whose pose changed since last frame: a joint's skin matrix differs from
- * the one the animation manager kept from the frame before. A pose can change inside bounds that
- * stay put — an arm swinging inside the box its feet and head set — which neither the row's
- * transform nor its box would show; a skin held still is no mover.
- *
- * The mesh's box is this frame's, after the bounds refresh: a pose that changed it is also caught by
- * {@link shader_vsm_movers}, with where the mesh was.
- *
- * One workgroup per skinning binding, its lanes over the skin's joints, after
- * {@link shader_vsm_movers} into the same list.
- *
- * @type {ComputeShader}
- */
-export const shader_vsm_skinned_movers: ComputeShader;
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_vsm_skinned_movers.d.ts.map

package/src/shade/renderer/shadow/vsm/shader/shader_vsm_skinned_movers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shader_vsm_skinned_movers.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/vsm/shader/shader_vsm_skinned_movers.js"],"names":[],"mappings":"AAYA,mDAAoD;AAEpD;;GAEG;AACH,iDAFU,YAAY,CAKS;AAsE/B;;;;;;;;;;;;;GAaG;AACH,wCAFU,aAAa,CAMpB;6BApG0B,sCAAsC;8BAJrC,kCAAkC"}

package/src/shade/renderer/shadow/vsm/shader/shader_vsm_skinned_movers.js

@@ -1,109 +0,0 @@
-import { WebGPUExtensionType } from "../../../../descriptor/WebGPUExtensionType.js";
-import { SKINNING_BINDING_STRUCT } from "../../../animation/skinning/SKINNING_BINDING_STRUCT.js";
-import { chunk_scene_database_access } from "../../../scene/chunk_scene_database_access.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
-import { mat4x4f, u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { VSM_MOVERS_STRUCT } from "../VSM_MOVER_LAYOUT.js";
-import { chunk_vsm_append_mover } from "./chunk_vsm_append_mover.js";
-
-export const VSM_SKINNED_MOVERS_WORKGROUP_SIZE = 64;
-
-/**
- * @type {WebGPUStruct}
- */
-export const VSM_SKINNED_MOVERS_SETTINGS_STRUCT = WebGPUStruct.from({
-    binding_count: u32,
-    capacity: u32,
-}, "VSMSkinnedMoversSettings");
-
-const resources = new ShaderResourceSetDescriptor();
-
-resources.setImmediate('settings', VSM_SKINNED_MOVERS_SETTINGS_STRUCT);
-
-resources.createGroup()
-    .addStorageBuffer('scene_database', WebGPUArray.from(u32), false)
-    .addStorageBuffer('bindings', WebGPUArray.from(SKINNING_BINDING_STRUCT), false)
-    .addStorageBuffer('skin_matrices', WebGPUArray.from(mat4x4f), false)
-    .addStorageBuffer('prev_skin_matrices', WebGPUArray.from(mat4x4f), false)
-    .addStorageBuffer('movers', VSM_MOVERS_STRUCT, true);
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-const LANES = ${VSM_SKINNED_MOVERS_WORKGROUP_SIZE}u;
-
-// set by the first lane to find a joint that moved: that lane alone lists the mesh
-var<workgroup> claimed: atomic<u32>;
-
-fn vsm_matrix_differs(a: mat4x4f, b: mat4x4f) -> bool {
-    return any(a[0] != b[0]) || any(a[1] != b[1]) || any(a[2] != b[2]) || any(a[3] != b[3]);
-}
-
-@compute @workgroup_size(${VSM_SKINNED_MOVERS_WORKGROUP_SIZE},1,1)
-fn main(
-    @builtin(workgroup_id) workgroup_id: vec3<u32>,
-    @builtin(local_invocation_index) lane: u32,
-) {
-    let index = workgroup_id.x;
-
-    // the whole workgroup's binding, so the whole workgroup leaves
-    if (index >= settings.binding_count) {
-        return;
-    }
-
-    let binding = bindings[index];
-
-    // a lane's joints, a workgroup's width apart: as many as the skin has, over the lanes
-    var moved = false;
-
-    for (var j = lane; j < binding.skin_matrix_count; j += LANES) {
-        let row = binding.skin_matrix_offset + j;
-
-        moved = moved || vsm_matrix_differs(skin_matrices[row], prev_skin_matrices[row]);
-    }
-
-    let first = moved && atomicExchange(&claimed, 1u) == 0u;
-
-    var box_min = vec3f(0.0);
-    var box_max = vec3f(0.0);
-
-    if (first) {
-        let mesh = scene_read_mesh(&scene_database, binding.mesh_instance_index);
-
-        box_min = vec3f(mesh.bounding_box[0], mesh.bounding_box[1], mesh.bounding_box[2]);
-        box_max = vec3f(mesh.bounding_box[3], mesh.bounding_box[4], mesh.bounding_box[5]);
-    }
-
-    vsm_append_mover(first && all(box_min <= box_max), box_min, box_max, settings.capacity);
-}
-`, [
-    SKINNING_BINDING_STRUCT.declaration_chunk,
-    chunk_scene_database_access,
-    chunk_vsm_append_mover,
-]);
-
-body.addExtension(WebGPUExtensionType.Subgroups);
-
-/**
- * List every skinned mesh whose pose changed since last frame: a joint's skin matrix differs from
- * the one the animation manager kept from the frame before. A pose can change inside bounds that
- * stay put — an arm swinging inside the box its feet and head set — which neither the row's
- * transform nor its box would show; a skin held still is no mover.
- *
- * The mesh's box is this frame's, after the bounds refresh: a pose that changed it is also caught by
- * {@link shader_vsm_movers}, with where the mesh was.
- *
- * One workgroup per skinning binding, its lanes over the skin's joints, after
- * {@link shader_vsm_movers} into the same list.
- *
- * @type {ComputeShader}
- */
-export const shader_vsm_skinned_movers = ComputeShader.from({
-    label: "VSM/SkinnedMovers",
-    body,
-    resources,
-});