@woosh/meep-engine 3.67.0 → 3.69.0

package/src/shade/renderer/trails/shaders/shader_trail_update.js

@@ -0,0 +1,101 @@
+import { COLLECTION_U32_STRUCT_READ } from "../../gpu_primitive/COLLECTION_U32_STRUCT_READ.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 { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
+import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
+import { TRAIL_DESCRIPTOR, TRAIL_STATE_DESCRIPTOR } from "../data/TRAIL_DATABASE_SPEC.js";
+import { chunk_trail_update } from "./chunk_trail_update.js";
+
+/**
+ * Threads per workgroup; one trail row each. The page iterator wants a multiple of 32.
+ * @type {number}
+ */
+export const TRAIL_UPDATE_WORKGROUP_SIZE = 64;
+
+const PG = TRAIL_DESCRIPTOR.page_iterator_symbol_prefix(TRAIL_UPDATE_WORKGROUP_SIZE, true);
+const STATE = TRAIL_STATE_DESCRIPTOR;
+
+export const TRAIL_UPDATE_SETTINGS = WebGPUStruct.from({
+    /** the clock, in ticks */
+    now: u32,
+    /** element capacity of the trail table: the length of the counts list the scan reads */
+    capacity: u32,
+}, "Trail3DUpdateSettings");
+
+const resources = new ShaderResourceSetDescriptor();
+
+resources.setImmediate("settings", TRAIL_UPDATE_SETTINGS);
+
+resources.createGroup()
+    .addStorageBuffer("trail_database", WebGPUArray.u32, true)
+    .addStorageBuffer("scene_database", WebGPUArray.u32, false)
+    .addStorageBuffer("knots", WebGPUArray.u32, true)
+    .addStorageBuffer("live_segments", COLLECTION_U32_STRUCT_READ, true);
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+@compute @workgroup_size(${TRAIL_UPDATE_WORKGROUP_SIZE}, 1, 1)
+fn main(
+    @builtin(workgroup_id) wg_id : vec3<u32>,
+    @builtin(local_invocation_index) local_id : u32,
+) {
+    // the scan reads exactly this many counts; written before the page test so it lands even when the
+    // first page is unallocated
+    if (wg_id.x == 0u && local_id == 0u) {
+        live_segments.count = settings.capacity;
+    }
+
+    if (!${PG}_setup(&trail_database, wg_id.x, local_id)) {
+        return;
+    }
+
+    let slot = ${PG}_slot_in_page(local_id);
+
+    if (slot >= ${PG}_ELEMENTS_PER_PAGE || !${PG}_is_occupied(slot)) {
+        return;
+    }
+
+    let record = ${PG}_read(&trail_database, slot);
+    let row = ${PG}_slot_to_index(slot);
+
+    var state = ${STATE.marshalling_method_read_rw}(&trail_database, row);
+
+    if (state.seeded_epoch != record.seed_epoch) {
+        // a seed has been asked for and not run yet: nothing to draw until it has
+        live_segments.elements[row] = 0u;
+        return;
+    }
+
+    let head = trail_head_world(scene_read_node(&scene_database, record.node).global, record.offset);
+
+    live_segments.elements[row] = trail_update(record, &state, head, settings.now);
+
+    ${STATE.marshalling_method_write}(&trail_database, row, state);
+}
+`, [
+    TRAIL_DESCRIPTOR.chunk_iterate(TRAIL_UPDATE_WORKGROUP_SIZE, true),
+    STATE.chunk_read_rw,
+    STATE.chunk_write,
+    chunk_scene_database_access,
+    chunk_trail_update,
+]);
+
+/**
+ * One frame of every trail: a thread per row of the trail table, through the table's page iterator.
+ * Each reads its entity's world matrix from the scene database — the hierarchy has composed this
+ * frame's — runs `trail_update`, writes its state back, and writes how many of its segments can be
+ * visible into `live_segments`, the list the scan sums.
+ *
+ * A row whose state has not been seeded for its record's epoch writes zero and waits for its seed.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_trail_update = ComputeShader.from({
+    label: "Trail Update",
+    resources,
+    body,
+});

package/src/shade/renderer/volumetrics/GPUViewVolumetrics.d.ts

@@ -76,7 +76,7 @@ export class GPUViewVolumetrics {
      * @param {import("../global_illumination/lpv/GPULightProbeVolume.js").GPULightProbeVolume} [options.lpv]
      * @param {import("../global_illumination/probe_clipmap/GPUProbeClipmapGI.js").GPUProbeClipmapGI} options.probes
      *   the renderer's probe clipmap GI, whose probes the irradiance clipmap binds in every mode
-     * @returns {{resolved: number, metadata: number, irradiance: {Y: number, CoCg: number, uniform: number}}}
+     * @returns {{resolved: number, metadata: number, irradiance: {Y: number, CoCg: number, uniform: number}, lut_transmittance?: number, lut_multiple_scattering?: number}}
      */
     graph_update({ graph, view, light_cluster_data, light_cluster_lookup, light_cluster_parameters, shadowmap_atlas, shader_switches, brick4, lpv, probes, }: {
         graph: FrameGraph;
@@ -97,6 +97,8 @@ export class GPUViewVolumetrics {
             CoCg: number;
             uniform: number;
         };
+        lut_transmittance?: number;
+        lut_multiple_scattering?: number;
     };
     #private;
 }

package/src/shade/renderer/volumetrics/GPUViewVolumetrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUViewVolumetrics.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/GPUViewVolumetrics.js"],"names":[],"mappings":"AAuBA;;;GAGG;AAEH;IAkNI;;;OAGG;IACH,+BAuCC;IAvND;;OAEG;IACH,4BAOC;IAjBD;;OAEG;IACH,2BAEC;IA8CD;;OAEG;IACH,yBAIC;IApBD;;;;;;;;OAQG;IACH,wBAEC;IAqBD;;;OAGG;IACH,4BAMC;IApBD;;;;;OAKG;IACH,2BAEC;IAsCD;;OAEG;IACH,0BAEC;IAZD;;OAEG;IACH,yBAEC;IAwHD;;OAEG;IACH,+CAEC;IAED;;;;OAIG;IACH,sBAEC;IAED,gBAcC;IA+MD;;;;;;;;;;;;;;;;OAgBG;IACH;QAd+B,KAAK,EAAzB,UAAU;QACc,IAAI,EAA5B,cAAc;QAEE,kBAAkB,EAAlC,MAAM;QACU,oBAAoB,EAApC,MAAM;QACU,wBAAwB,EAAxC,MAAM;QACU,eAAe,EAA/B,MAAM;QACoB,eAAe,GAAzC,eAAe;QACoE,MAAM,GAAzF,OAAO,iDAAiD,EAAE,cAAc;QACkB,GAAG,GAA7F,OAAO,mDAAmD,EAAE,mBAAmB;QACgB,MAAM,EAArG,OAAO,2DAA2D,EAAE,iBAAiB;QAEnF;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,CA0HxG;;CAEJ;yBA3nBY,OAAO,2DAA2D,EAAE,UAAU;6BAC9E,OAAO,2BAA2B,EAAE,cAAc;qCAX1B,8CAA8C;gCAXnD,uCAAuC"}
+{"version":3,"file":"GPUViewVolumetrics.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/GPUViewVolumetrics.js"],"names":[],"mappings":"AAuBA;;;GAGG;AAEH;IAkNI;;;OAGG;IACH,+BAuCC;IAvND;;OAEG;IACH,4BAOC;IAjBD;;OAEG;IACH,2BAEC;IA8CD;;OAEG;IACH,yBAIC;IApBD;;;;;;;;OAQG;IACH,wBAEC;IAqBD;;;OAGG;IACH,4BAMC;IApBD;;;;;OAKG;IACH,2BAEC;IAsCD;;OAEG;IACH,0BAEC;IAZD;;OAEG;IACH,yBAEC;IAwHD;;OAEG;IACH,+CAEC;IAED;;;;OAIG;IACH,sBAEC;IAED,gBAcC;IA+MD;;;;;;;;;;;;;;;;OAgBG;IACH;QAd+B,KAAK,EAAzB,UAAU;QACc,IAAI,EAA5B,cAAc;QAEE,kBAAkB,EAAlC,MAAM;QACU,oBAAoB,EAApC,MAAM;QACU,wBAAwB,EAAxC,MAAM;QACU,eAAe,EAA/B,MAAM;QACoB,eAAe,GAAzC,eAAe;QACoE,MAAM,GAAzF,OAAO,iDAAiD,EAAE,cAAc;QACkB,GAAG,GAA7F,OAAO,mDAAmD,EAAE,mBAAmB;QACgB,MAAM,EAArG,OAAO,2DAA2D,EAAE,iBAAiB;QAEnF;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAC,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;KAAC,CA4HtK;;CAEJ;yBA7nBY,OAAO,2DAA2D,EAAE,UAAU;6BAC9E,OAAO,2BAA2B,EAAE,cAAc;qCAX1B,8CAA8C;gCAXnD,uCAAuC"}

package/src/shade/renderer/volumetrics/GPUViewVolumetrics.js

@@ -533,7 +533,7 @@ export class GPUViewVolumetrics {
      * @param {import("../global_illumination/lpv/GPULightProbeVolume.js").GPULightProbeVolume} [options.lpv]
      * @param {import("../global_illumination/probe_clipmap/GPUProbeClipmapGI.js").GPUProbeClipmapGI} options.probes
      *   the renderer's probe clipmap GI, whose probes the irradiance clipmap binds in every mode
-     * @returns {{resolved: number, metadata: number, irradiance: {Y: number, CoCg: number, uniform: number}}}
+     * @returns {{resolved: number, metadata: number, irradiance: {Y: number, CoCg: number, uniform: number}, lut_transmittance?: number, lut_multiple_scattering?: number}}
      */
     graph_update({
                      graph,
@@ -627,7 +627,7 @@ export class GPUViewVolumetrics {
 
         sky.update();
 
-        const { lut_aerial } = graph_build_volumetrics({
+        const { lut_aerial, lut_transmittance, lut_multiple_scattering } = graph_build_volumetrics({
             graph,
             camera,
             lights,
@@ -654,6 +654,8 @@ export class GPUViewVolumetrics {
             resolved: lut_aerial,
             metadata: gr_metadata,
             irradiance,
+            lut_transmittance,
+            lut_multiple_scattering,
         };
     }
 

package/src/shade/renderer/volumetrics/graph_build_volumetrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_build_volumetrics.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/graph_build_volumetrics.js"],"names":[],"mappings":"AAkhBA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IAtB+B,KAAK;IACC,MAAM;IACJ,MAAM;IACV,IAAI;IACZ,GAAG;IAIH,kBAAkB,EAAlC,MAAM;IACU,oBAAoB,EAApC,MAAM;IACU,wBAAwB,EAAxC,MAAM;IACU,eAAe,EAA/B,MAAM;IACY,qBAAqB,EAAvC,MAAM,EAAE;IACU,qBAAqB,EAAvC,MAAM,EAAE;IAGQ,oBAAoB,EAApC,MAAM;IACW,WAAW,GAA5B,MAAM;IACW,UAAU,GAA3B,MAAM;IACqB,eAAe;IAChB,eAAe,GAAzC,eAAe;;;;;;EAsLzB;gCA9tB+B,uCAAuC"}
+{"version":3,"file":"graph_build_volumetrics.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/graph_build_volumetrics.js"],"names":[],"mappings":"AAohBA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IAtB+B,KAAK;IACC,MAAM;IACJ,MAAM;IACV,IAAI;IACZ,GAAG;IAIH,kBAAkB,EAAlC,MAAM;IACU,oBAAoB,EAApC,MAAM;IACU,wBAAwB,EAAxC,MAAM;IACU,eAAe,EAA/B,MAAM;IACY,qBAAqB,EAAvC,MAAM,EAAE;IACU,qBAAqB,EAAvC,MAAM,EAAE;IAGQ,oBAAoB,EAApC,MAAM;IACW,WAAW,GAA5B,MAAM;IACW,UAAU,GAA3B,MAAM;IACqB,eAAe;IAChB,eAAe,GAAzC,eAAe;;;;;;EAwLzB;gCAluB+B,uCAAuC"}