@woosh/meep-engine 3.37.0 → 3.39.0

package/src/shade/renderer/water/surface/shader_water_surface_write.js

@@ -0,0 +1,51 @@
+import { ComputeShader } from "../../shader/ComputeShader.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
+import { f32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
+import { chunk_water_wave } from "./chunk_water_wave.js";
+import { chunk_water_wave_grid } from "./chunk_water_wave_grid.js";
+import { WATER_SURFACE_VERTEX_STRUCT } from "./WATER_SURFACE_VERTEX_STRUCT.js";
+import { WATER_WAVE_PARAMETERS_STRUCT } from "./WATER_WAVE_PARAMETERS_STRUCT.js";
+
+const resources = new ShaderResourceSetDescriptor();
+resources.createGroup()
+    .addUniform("params", WATER_WAVE_PARAMETERS_STRUCT)
+    .addTexture("terrain_height", "float")
+    .addSampler("height_sampler")
+    .addStorageBuffer("state", WebGPUArray.from(f32), false)
+    .addStorageBuffer("vertices", WebGPUArray.from(WATER_SURFACE_VERTEX_STRUCT), true);
+
+/**
+ * Writes the surface interface from the primitive producer's heights: the vertex record every
+ * water draw reads. A dry vertex sits at the rest level, under the terrain, where the opaque depth
+ * hides it.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_water_surface_write = ComputeShader.from({
+    label: "Water / surface write",
+    resources,
+    body: CodeChunk.from(/* language=WGSL */ `
+fn water_surface_height_at(cell: vec2<i32>) -> f32 {
+    return params.level + state[water_wave_index(cell)];
+}
+
+@compute @workgroup_size(8, 8)
+fn main(@builtin(global_invocation_id) id: vec3<u32>) {
+    let n = params.resolution;
+    if (any(id.xy >= vec2<u32>(n))) { return; }
+    let cell = vec2<i32>(id.xy);
+    let index = water_wave_index(cell);
+    let world = water_wave_world(id.xy);
+    let position = vec3<f32>(world.x, water_surface_height_at(cell), world.y);
+    let normal = water_wave_normal(
+        water_surface_height_at(cell - vec2<i32>(1, 0)), water_surface_height_at(cell + vec2<i32>(1, 0)),
+        water_surface_height_at(cell - vec2<i32>(0, 1)), water_surface_height_at(cell + vec2<i32>(0, 1)),
+        params.spacing);
+    let previous = select(vertices[index].position.xyz, position, params.first_write != 0u);
+    vertices[index] = WaterSurfaceVertex(vec4<f32>(position, params.unresolved_variance),
+        vec4<f32>(previous, 0.0), vec4<f32>(normal, 0.0));
+}
+`, [chunk_water_wave, chunk_water_wave_grid]),
+});

package/src/shade/renderer/water/surface/shader_water_wave_step.d.ts

@@ -0,0 +1,12 @@
+/**
+ * One step of the primitive wave producer. Reads the current heights and overwrites the previous
+ * ones with the next: each thread reads only its own previous height, so the two buffers alternate
+ * roles step to step without a third.
+ *
+ * Dry vertices hold zero displacement, which makes the shore a reflecting boundary.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_water_wave_step: ComputeShader;
+import { ComputeShader } from "../../shader/ComputeShader.js";
+//# sourceMappingURL=shader_water_wave_step.d.ts.map

package/src/shade/renderer/water/surface/shader_water_wave_step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader_water_wave_step.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/water/surface/shader_water_wave_step.js"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH,qCAFU,aAAa,CA6BpB;8BArD2B,+BAA+B"}

package/src/shade/renderer/water/surface/shader_water_wave_step.js

@@ -0,0 +1,54 @@
+import { ComputeShader } from "../../shader/ComputeShader.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
+import { f32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
+import { chunk_water_wave } from "./chunk_water_wave.js";
+import { chunk_water_wave_grid } from "./chunk_water_wave_grid.js";
+import { WATER_WAVE_PARAMETERS_STRUCT } from "./WATER_WAVE_PARAMETERS_STRUCT.js";
+
+const resources = new ShaderResourceSetDescriptor();
+resources.createGroup()
+    .addUniform("params", WATER_WAVE_PARAMETERS_STRUCT)
+    .addTexture("terrain_height", "float")
+    .addSampler("height_sampler")
+    .addStorageBuffer("state_current", WebGPUArray.from(f32), false)
+    .addStorageBuffer("state_previous", WebGPUArray.from(f32), true);
+
+/**
+ * One step of the primitive wave producer. Reads the current heights and overwrites the previous
+ * ones with the next: each thread reads only its own previous height, so the two buffers alternate
+ * roles step to step without a third.
+ *
+ * Dry vertices hold zero displacement, which makes the shore a reflecting boundary.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_water_wave_step = ComputeShader.from({
+    label: "Water / wave step",
+    resources,
+    body: CodeChunk.from(/* language=WGSL */ `
+@compute @workgroup_size(8, 8)
+fn main(@builtin(global_invocation_id) id: vec3<u32>) {
+    let n = params.resolution;
+    if (any(id.xy >= vec2<u32>(n))) { return; }
+    let cell = vec2<i32>(id.xy);
+    let index = water_wave_index(cell);
+    let depth = params.level - water_wave_terrain(id.xy);
+    if (depth <= 0.0) {
+        state_previous[index] = 0.0;
+        return;
+    }
+    let h = state_current[index];
+    let neighbours = state_current[water_wave_index(cell + vec2<i32>(1, 0))]
+        + state_current[water_wave_index(cell - vec2<i32>(1, 0))]
+        + state_current[water_wave_index(cell + vec2<i32>(0, 1))]
+        + state_current[water_wave_index(cell - vec2<i32>(0, 1))];
+    let laplacian = (neighbours - 4.0 * h) / (params.spacing * params.spacing);
+    let damping = params.damping + water_wave_sponge(id.xy, n, params.sponge_width, params.sponge_strength);
+    state_previous[index] = water_wave_step(h, state_previous[index], laplacian,
+        water_wave_celerity2(depth, params.celerity_limit), damping,
+        water_wave_force(water_wave_world(id.xy)), params.dt);
+}
+`, [chunk_water_wave, chunk_water_wave_grid]),
+});

package/src/shade/renderer/water/surface/water_surface_grid_indices.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Triangle indices of a regular `resolution × resolution` vertex grid, vertices numbered row by
+ * row (`index = y * resolution + x`). Two triangles a cell, split along the same diagonal
+ * everywhere, so neighbouring cells share their edges exactly.
+ *
+ * @param {Object} options
+ * @param {number} options.resolution vertices along each side, at least 2
+ * @returns {Uint32Array} `(resolution - 1)² · 6` indices
+ */
+export function water_surface_grid_indices({ resolution }: {
+    resolution: number;
+}): Uint32Array;
+//# sourceMappingURL=water_surface_grid_indices.d.ts.map

package/src/shade/renderer/water/surface/water_surface_grid_indices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"water_surface_grid_indices.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/water/surface/water_surface_grid_indices.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH;IAH2B,UAAU,EAA1B,MAAM;IACJ,WAAW,CA6BvB"}

package/src/shade/renderer/water/surface/water_surface_grid_indices.js

@@ -0,0 +1,39 @@
+import { assert } from "../../../../core/assert.js";
+
+/**
+ * Triangle indices of a regular `resolution × resolution` vertex grid, vertices numbered row by
+ * row (`index = y * resolution + x`). Two triangles a cell, split along the same diagonal
+ * everywhere, so neighbouring cells share their edges exactly.
+ *
+ * @param {Object} options
+ * @param {number} options.resolution vertices along each side, at least 2
+ * @returns {Uint32Array} `(resolution - 1)² · 6` indices
+ */
+export function water_surface_grid_indices({ resolution }) {
+    assert.isInteger(resolution, 'resolution');
+    assert.greaterThanOrEqual(resolution, 2, 'resolution');
+
+    const cells = resolution - 1;
+    const indices = new Uint32Array(cells * cells * 6);
+
+    let cursor = 0;
+
+    for (let y = 0; y < cells; y++) {
+        for (let x = 0; x < cells; x++) {
+            const a = y * resolution + x;
+            const b = a + 1;
+            const c = a + resolution;
+            const d = c + 1;
+
+            indices[cursor++] = a;
+            indices[cursor++] = c;
+            indices[cursor++] = b;
+
+            indices[cursor++] = b;
+            indices[cursor++] = c;
+            indices[cursor++] = d;
+        }
+    }
+
+    return indices;
+}

package/src/shade/renderer/water/water_missing_receiver_path.d.ts

@@ -0,0 +1,17 @@
+/**
+ * How far the water passes integrate a body where nothing is seen through it on screen — the sky, the
+ * screen edge, a trace that failed: to where its clearest channel's beam transmittance has fallen to a
+ * thousandth, so the water's own light has stopped changing, bounded by the trace distance. A missing
+ * receiver is missing visibility; assuming nothing about the geometry that is not there, the water
+ * reads as deep.
+ *
+ * @param {Object} options
+ * @param {import("../medium/ParticipatingMedium.js").ParticipatingMedium} options.medium
+ * @param {number} options.max_distance the trace distance, m
+ * @returns {number} m
+ */
+export function water_missing_receiver_path({ medium, max_distance }: {
+    medium: import("../medium/ParticipatingMedium.js").ParticipatingMedium;
+    max_distance: number;
+}): number;
+//# sourceMappingURL=water_missing_receiver_path.d.ts.map

package/src/shade/renderer/water/water_missing_receiver_path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"water_missing_receiver_path.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/water/water_missing_receiver_path.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH;IAJmF,MAAM,EAA9E,OAAO,kCAAkC,EAAE,mBAAmB;IAC9C,YAAY,EAA5B,MAAM;IACJ,MAAM,CA2BlB"}

package/src/shade/renderer/water/water_missing_receiver_path.js

@@ -0,0 +1,40 @@
+import { assert } from "../../../core/assert.js";
+
+/**
+ * How far the water passes integrate a body where nothing is seen through it on screen — the sky, the
+ * screen edge, a trace that failed: to where its clearest channel's beam transmittance has fallen to a
+ * thousandth, so the water's own light has stopped changing, bounded by the trace distance. A missing
+ * receiver is missing visibility; assuming nothing about the geometry that is not there, the water
+ * reads as deep.
+ *
+ * @param {Object} options
+ * @param {import("../medium/ParticipatingMedium.js").ParticipatingMedium} options.medium
+ * @param {number} options.max_distance the trace distance, m
+ * @returns {number} m
+ */
+export function water_missing_receiver_path({ medium, max_distance }) {
+    assert.defined(medium, 'medium');
+    assert.isFinite(max_distance, 'max_distance');
+    assert.greaterThan(max_distance, 0, 'max_distance');
+
+    const lobes = medium.lobes;
+
+    let clearest = Infinity;
+
+    for (let c = 0; c < 3; c++) {
+        let extinction = medium.absorption[c];
+
+        for (let i = 0; i < lobes.length; i++) {
+            extinction += lobes[i].scattering[c];
+        }
+
+        clearest = Math.min(clearest, extinction);
+    }
+
+    if (!(clearest > 0)) {
+        // a channel the water never attenuates: as far as the trace goes
+        return max_distance;
+    }
+
+    return Math.min(Math.log(1000) / clearest, max_distance);
+}

package/src/shade/wgsl/emulator/WGSLJavaScriptCompiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WGSLJavaScriptCompiler.d.ts","sourceRoot":"","sources":["../../../../../src/shade/wgsl/emulator/WGSLJavaScriptCompiler.js"],"names":[],"mappings":"AAuiBA;IAEI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,oBAFa,MAAM,CAMlB;CACJ;;UAnkBa,WAAW,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS;WAC/G,MAAM;WACN,MAAM;WACN,MAAM;WACN,MAAM;aACN,MAAM;cACN,QAAQ;YACR,MAAM"}
+{"version":3,"file":"WGSLJavaScriptCompiler.d.ts","sourceRoot":"","sources":["../../../../../src/shade/wgsl/emulator/WGSLJavaScriptCompiler.js"],"names":[],"mappings":"AAkmBA;IAEI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,oBAFa,MAAM,CAMlB;CACJ;;UA9nBa,WAAW,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS;WAC/G,MAAM;WACN,MAAM;WACN,MAAM;WACN,MAAM;aACN,MAAM;cACN,QAAQ;YACR,MAAM"}