@woosh/meep-engine 3.56.0 → 3.57.0

package/src/shade/renderer/particles/shaders/shader_particle_avboit_draw.js

@@ -1,193 +1,199 @@
-import { DepthStencilState } from "../../../descriptor/pipeline/render/DepthStencilState.js";
-import { RenderPipelineDescriptor } from "../../../descriptor/pipeline/render/RenderPipelineDescriptor.js";
-import { CAMERA_UNIFORM_STRUCT } from "../../camera/CAMERA_UNIFORM_STRUCT.js";
-import { chunk_sample_volumetrics } from "../../deferred/chunk_sample_volumetrics.js";
-import { AVBOIT_EXTINCT_TRANSMITTANCE } from "../../rasterize/native/avboit/AVBOIT_CONSTANTS.js";
-import { AVBOIT_DRAW_TARGETS } from "../../rasterize/native/avboit/avboit_draw_fragment_body.js";
-import { AVBOIT_WARP_STRUCT } from "../../rasterize/native/avboit/AVBOIT_WARP_STRUCT.js";
-import { chunk_avboit_footprint_bias } from "../../rasterize/native/avboit/chunk_avboit_footprint_bias.js";
-import { chunk_avboit_sample_transmittance } from "../../rasterize/native/avboit/chunk_avboit_sample_transmittance.js";
-import { chunk_avboit_view_depth_to_virtual } from "../../rasterize/native/avboit/chunk_avboit_view_depth_to_virtual.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
-import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { SAMPLER_LINEAR_UPSCALE } from "../../texture/SAMPLER_LINEAR_UPSCALE.js";
-import { chunk_view_mip_bias } from "../../view/chunk_view_mip_bias.js";
-import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
-import {
-    irradiance_clipmap_add_resources
-} from "../../volumetrics/irradiance_clipmap/chunk_irradiance_clipmap_sample.js";
-import { VOLUMETRICS_METADATA_STRUCT } from "../../volumetrics/VOLUMETRICS_METADATA_STRUCT.js";
-import { EMITTER_FLAG } from "../data/PARTICLE_EMITTER_STRUCT.js";
-import { PARTICLE_SOFT_FADE_RANGE } from "../ParticleConstants.js";
-import { chunk_particle_avboit_contribution } from "./chunk_particle_avboit_contribution.js";
-import { chunk_particle_billboard_vertex } from "./chunk_particle_billboard_vertex.js";
-import { chunk_particle_lighting } from "./chunk_particle_lighting.js";
-import { chunk_particle_scene_view_depth } from "./chunk_particle_scene_view_depth.js";
-
-/**
- * The particles' AVBOIT draw: the billboard quads at internal resolution, depth-tested against the
- * opaque scene, into the four accumulators the transparent meshes draw into
- * (`avboit_draw_fragment_body`). The particle counterpart of `shader_avboit_draw`.
- *
- * Per fragment: the atlas sample times the particle colour, the soft-depth fade against the scene
- * depth, lighting for an emitter flagged `EMITTER_FLAG.LIGHTING` (`chunk_particle_lighting`: the
- * world-space irradiance clipmap and cached far-field SH), the volumetric fog composite, then the
- * transmittance of everything in front from the integral texture.
- */
-
-const resources = new ShaderResourceSetDescriptor();
-
-const group = resources.createGroup()
-    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-    .addUniform("view", VIEW_UNIFORM_STRUCT)
-    .addStorageBuffer("warp", AVBOIT_WARP_STRUCT)
-    .addStorageBuffer("pool", WebGPUArray.u32, false)
-    .addStorageBuffer("draw_list", WebGPUArray.u32, false)
-    .addStorageBuffer("emitter_database", WebGPUArray.u32, false)
-    .addTexture("atlas", "float")
-    .addSampler("atlas_sampler", "filtering")
-    .addTexture("scene_depth", "unfilterable-float")
-    // sampled through sLinear: linear, clamped on every axis, which is what the integral needs
-    .addTexture("tIntegral", "float", "3d")
-    .addSampler("sLinear", "filtering", SAMPLER_LINEAR_UPSCALE)
-    // volumetrics (composited inline)
-    .addUniform("volumetrics_metadata", VOLUMETRICS_METADATA_STRUCT)
-    .addTexture("tVolumetrics", "float", "3d")
-    .addTexture("tSTBN_vec3", "float", "3d");
-
-// lighting (chunk_particle_lighting): world-space irradiance clipmap + cached far-field SH fallback
-irradiance_clipmap_add_resources(group, { include_far_field: true });
-
-const body = CodeChunk.from(
-    /* language=wgsl */ `
-const PARTICLE_FLAG_SOFT_DEPTH : u32 = ${EMITTER_FLAG.SOFT_DEPTH}u;
-const PARTICLE_FLAG_LIGHTING : u32 = ${EMITTER_FLAG.LIGHTING}u;
-const PARTICLE_SOFT_FADE_RANGE : f32 = ${PARTICLE_SOFT_FADE_RANGE};
-
-struct ParticleAVBOITDrawOutput {
-    @location(0) color : vec4<f32>,
-    @location(1) norm : vec4<f32>,
-    @location(2) extinction : vec4<f32>,
-    @location(3) emission : vec4<f32>,
-}
-
-// Each draw uses the same GPU-owned alive list. Clip the other modes before rasterization.
-fn particle_avboit_vertex(vi : u32, ii : u32, blend : u32) -> ParticleVertexOut {
-    var out = particle_billboard_vertex(vi, ii);
-    if (particle_avboit_draw_blend(out.color, out.blend) != blend) {
-        out.clip = vec4<f32>(2.0, 2.0, 2.0, 1.0);
-    }
-    return out;
-}
-
-@vertex
-fn vs_alpha(@builtin(vertex_index) vi : u32, @builtin(instance_index) ii : u32) -> ParticleVertexOut {
-    return particle_avboit_vertex(vi, ii, PARTICLE_BLEND_ALPHA);
-}
-
-@vertex
-fn vs_additive(@builtin(vertex_index) vi : u32, @builtin(instance_index) ii : u32) -> ParticleVertexOut {
-    return particle_avboit_vertex(vi, ii, PARTICLE_BLEND_ADDITIVE);
-}
-
-@vertex
-fn vs_general(@builtin(vertex_index) vi : u32, @builtin(instance_index) ii : u32) -> ParticleVertexOut {
-    return particle_avboit_vertex(vi, ii, PARTICLE_BLEND_PREMULTIPLIED);
-}
-
-@fragment
-fn fs_main(in : ParticleVertexOut) -> ParticleAVBOITDrawOutput {
-    let screen_uv = in.clip.xy / vec2<f32>(f32(view.width), f32(view.height));
-    let uv_bias = view_uv_derivative_bias(view.upscale_ratio);
-    let uv_ddx = dpdx(in.uv) * uv_bias.x;
-    let uv_ddy = dpdy(in.uv) * uv_bias.y;
-
-    let footprint = select(
-        avboit_footprint_bias(&warp, fwidth(avboit_view_depth_to_virtual(&warp, in.view_depth))),
-        0.0,
-        in.blend == PARTICLE_BLEND_ADDITIVE,
-    );
-
-    let transmittance = avboit_sample_transmittance(&warp, tIntegral, sLinear, screen_uv, in.view_depth, footprint);
-
-    if (all(transmittance <= vec3<f32>(${AVBOIT_EXTINCT_TRANSMITTANCE}))) {
-        // nothing this fragment contributes survives what is in front of it; skip the shading
-        discard;
-    }
-
-    var color = textureSampleGrad(atlas, atlas_sampler, in.uv, uv_ddx, uv_ddy) * in.color;
-
-    if ((in.flags & PARTICLE_FLAG_SOFT_DEPTH) != 0u) {
-        let scene_vd = particle_scene_view_depth(textureLoad(scene_depth, vec2<i32>(in.clip.xy), 0).r, camera);
-        color = particle_fade_color(color, in.blend, particle_soft_fade(scene_vd, in.view_depth, PARTICLE_SOFT_FADE_RANGE));
-    }
-
-    if ((in.flags & PARTICLE_FLAG_LIGHTING) != 0u) {
-        color = particle_apply_lighting(color, in.world_position, normalize(in.normal));
-    }
-
-    if (particle_avboit_is_empty(color, in.blend)) {
-        discard;
-    }
-
-    let volumetrics = sample_volumetrics(in.view_depth, screen_uv, in.clip.xy);
-
-    let contribution = particle_avboit_contribution(color, in.blend, transmittance, volumetrics);
-
-    var out : ParticleAVBOITDrawOutput;
-
-    out.color = contribution.color;
-    out.norm = contribution.norm;
-    out.extinction = contribution.extinction;
-    out.emission = contribution.emission;
-
-    return out;
-}
-`, [
-    chunk_particle_avboit_contribution,
-    chunk_particle_scene_view_depth,
-    chunk_particle_billboard_vertex,
-    chunk_particle_lighting,
-    chunk_sample_volumetrics,
-    chunk_avboit_view_depth_to_virtual,
-    chunk_avboit_footprint_bias,
-    chunk_avboit_sample_transmittance,
-    chunk_view_mip_bias,
-]);
-
-const descriptor = ShaderDescriptor.from({ label: "Particle AVBOIT Draw", body, resources });
-
-/**
- * The variants share WGSL, bindings and attachments; only the vertex entry point and target writes
- * differ. Disabling unused targets avoids blending zeros over every billboard pixel.
- * @param {string} label
- * @param {string} entryPoint
- * @param {number[]} writeMasks
- * @returns {RenderPipelineDescriptor}
- */
-function create_draw_pipeline(label, entryPoint, writeMasks) {
-    return RenderPipelineDescriptor.from({
-        label,
-        layout: resources.generatePipelineLayout(GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT),
-        vertex: { module: { code: descriptor.source }, entryPoint },
-        fragment: {
-            module: { code: descriptor.source },
-            entryPoint: "fs_main",
-            targets: AVBOIT_DRAW_TARGETS.map((target, i) => ({ ...target, writeMask: writeMasks[i] })),
-        },
-        depthStencil: DepthStencilState.from({ format: "depth32float", depthWriteEnabled: false, depthCompare: "greater" }),
-        primitive: { topology: "triangle-list", cullMode: "none" },
-    });
-}
-
-export const PARTICLE_AVBOIT_DRAW_ALPHA_PIPELINE = create_draw_pipeline("Particle AVBOIT Draw Alpha", "vs_alpha", [0xF, 0xF, 0xF, 0]);
-export const PARTICLE_AVBOIT_DRAW_ADDITIVE_PIPELINE = create_draw_pipeline("Particle AVBOIT Draw Additive", "vs_additive", [0, 0, 0, 0xF]);
-export const PARTICLE_AVBOIT_DRAW_GENERAL_PIPELINE = create_draw_pipeline("Particle AVBOIT Draw General", "vs_general", [0xF, 0xF, 0xF, 0xF]);
-
-/** The draw shader's resource set, for building its bind group. */
-export const PARTICLE_AVBOIT_DRAW_RESOURCES = resources;
-
-/** The assembled shader, for the validity tier. */
-export const shader_particle_avboit_draw = descriptor;
+import { DepthStencilState } from "../../../descriptor/pipeline/render/DepthStencilState.js";
+import { RenderPipelineDescriptor } from "../../../descriptor/pipeline/render/RenderPipelineDescriptor.js";
+import { CAMERA_UNIFORM_STRUCT } from "../../camera/CAMERA_UNIFORM_STRUCT.js";
+import { chunk_sample_volumetrics } from "../../deferred/chunk_sample_volumetrics.js";
+import { AVBOIT_EXTINCT_TRANSMITTANCE } from "../../rasterize/native/avboit/AVBOIT_CONSTANTS.js";
+import { AVBOIT_DRAW_TARGETS } from "../../rasterize/native/avboit/avboit_draw_fragment_body.js";
+import { AVBOIT_WARP_STRUCT } from "../../rasterize/native/avboit/AVBOIT_WARP_STRUCT.js";
+import { chunk_avboit_footprint_bias } from "../../rasterize/native/avboit/chunk_avboit_footprint_bias.js";
+import { chunk_avboit_sample_transmittance } from "../../rasterize/native/avboit/chunk_avboit_sample_transmittance.js";
+import { chunk_avboit_view_depth_to_virtual } from "../../rasterize/native/avboit/chunk_avboit_view_depth_to_virtual.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
+import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
+import { SAMPLER_LINEAR_UPSCALE } from "../../texture/SAMPLER_LINEAR_UPSCALE.js";
+import { chunk_view_mip_bias } from "../../view/chunk_view_mip_bias.js";
+import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
+import {
+    irradiance_clipmap_add_resources
+} from "../../volumetrics/irradiance_clipmap/chunk_irradiance_clipmap_sample.js";
+import { VOLUMETRICS_METADATA_STRUCT } from "../../volumetrics/VOLUMETRICS_METADATA_STRUCT.js";
+import { EMITTER_FLAG } from "../data/PARTICLE_EMITTER_STRUCT.js";
+import { PARTICLE_SOFT_FADE_RANGE } from "../ParticleConstants.js";
+import { chunk_particle_avboit_contribution } from "./chunk_particle_avboit_contribution.js";
+import { chunk_particle_billboard_vertex } from "./chunk_particle_billboard_vertex.js";
+import { chunk_particle_lighting } from "./chunk_particle_lighting.js";
+import { chunk_particle_scene_view_depth } from "./chunk_particle_scene_view_depth.js";
+
+/**
+ * The particles' AVBOIT draw: the billboard quads at internal resolution, depth-tested against the
+ * opaque scene, into the four accumulators the transparent meshes draw into
+ * (`avboit_draw_fragment_body`). The particle counterpart of `shader_avboit_draw`.
+ *
+ * Per fragment: the atlas sample times the particle colour, the soft-depth fade against the scene
+ * depth, lighting for an emitter flagged `EMITTER_FLAG.LIGHTING` (`chunk_particle_lighting`: the
+ * world-space irradiance clipmap and cached far-field SH), the volumetric fog composite, then the
+ * transmittance of everything in front from the integral texture.
+ */
+
+const resources = new ShaderResourceSetDescriptor();
+
+const group = resources.createGroup()
+    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
+    .addUniform("view", VIEW_UNIFORM_STRUCT)
+    .addStorageBuffer("warp", AVBOIT_WARP_STRUCT)
+    .addStorageBuffer("pool", WebGPUArray.u32, false)
+    .addStorageBuffer("draw_list", WebGPUArray.u32, false)
+    .addStorageBuffer("emitter_database", WebGPUArray.u32, false)
+    .addTexture("atlas", "float")
+    .addSampler("atlas_sampler", "filtering")
+    .addTexture("scene_depth", "unfilterable-float")
+    // sampled through sLinear: linear, clamped on every axis, which is what the integral needs
+    .addTexture("tIntegral", "float", "3d")
+    .addSampler("sLinear", "filtering", SAMPLER_LINEAR_UPSCALE)
+    // volumetrics (composited inline)
+    .addUniform("volumetrics_metadata", VOLUMETRICS_METADATA_STRUCT)
+    .addTexture("tVolumetrics", "float", "3d")
+    .addTexture("tSTBN_vec3", "float", "3d");
+
+// lighting (chunk_particle_lighting): world-space irradiance clipmap + cached far-field SH fallback
+irradiance_clipmap_add_resources(group, { include_far_field: true });
+
+const body = CodeChunk.from(
+    /* language=wgsl */ `
+const PARTICLE_FLAG_SOFT_DEPTH : u32 = ${EMITTER_FLAG.SOFT_DEPTH}u;
+const PARTICLE_FLAG_LIGHTING : u32 = ${EMITTER_FLAG.LIGHTING}u;
+const PARTICLE_SOFT_FADE_RANGE : f32 = ${PARTICLE_SOFT_FADE_RANGE};
+
+struct ParticleAVBOITDrawOutput {
+    @location(0) color : vec4<f32>,
+    @location(1) norm : vec4<f32>,
+    @location(2) extinction : vec4<f32>,
+    @location(3) emission : vec4<f32>,
+}
+
+// Each draw uses the same GPU-owned alive list. Clip the other modes before rasterization.
+fn particle_avboit_vertex(vi : u32, ii : u32, blend : u32) -> ParticleVertexOut {
+    var out = particle_billboard_vertex(vi, ii);
+    if (particle_avboit_draw_blend(out.color, out.blend) != blend || particle_avboit_is_empty(out.color, out.blend)) {
+        out.clip = vec4<f32>(2.0, 2.0, 2.0, 1.0);
+    }
+    return out;
+}
+
+@vertex
+fn vs_alpha(@builtin(vertex_index) vi : u32, @builtin(instance_index) ii : u32) -> ParticleVertexOut {
+    return particle_avboit_vertex(vi, ii, PARTICLE_BLEND_ALPHA);
+}
+
+@vertex
+fn vs_additive(@builtin(vertex_index) vi : u32, @builtin(instance_index) ii : u32) -> ParticleVertexOut {
+    return particle_avboit_vertex(vi, ii, PARTICLE_BLEND_ADDITIVE);
+}
+
+@vertex
+fn vs_general(@builtin(vertex_index) vi : u32, @builtin(instance_index) ii : u32) -> ParticleVertexOut {
+    return particle_avboit_vertex(vi, ii, PARTICLE_BLEND_PREMULTIPLIED);
+}
+
+@fragment
+fn fs_main(in : ParticleVertexOut) -> ParticleAVBOITDrawOutput {
+    let screen_uv = in.clip.xy / vec2<f32>(f32(view.width), f32(view.height));
+    let uv_bias = view_uv_derivative_bias(view.upscale_ratio);
+    let uv_ddx = dpdx(in.uv) * uv_bias.x;
+    let uv_ddy = dpdy(in.uv) * uv_bias.y;
+
+    let footprint = select(
+        avboit_footprint_bias(&warp, fwidth(avboit_view_depth_to_virtual(&warp, in.view_depth))),
+        0.0,
+        in.blend == PARTICLE_BLEND_ADDITIVE,
+    );
+
+    var color = textureSampleGrad(atlas, atlas_sampler, in.uv, uv_ddx, uv_ddy) * in.color;
+
+    if (particle_avboit_is_empty(color, in.blend)) {
+        discard;
+    }
+
+    if ((in.flags & PARTICLE_FLAG_SOFT_DEPTH) != 0u) {
+        let scene_vd = particle_scene_view_depth(textureLoad(scene_depth, vec2<i32>(in.clip.xy), 0).r, camera);
+        color = particle_fade_color(color, in.blend, particle_soft_fade(scene_vd, in.view_depth, PARTICLE_SOFT_FADE_RANGE));
+        if (particle_avboit_is_empty(color, in.blend)) {
+            discard;
+        }
+    }
+
+    let transmittance = avboit_sample_transmittance(&warp, tIntegral, sLinear, screen_uv, in.view_depth, footprint);
+
+    if (all(transmittance <= vec3<f32>(${AVBOIT_EXTINCT_TRANSMITTANCE}))) {
+        // nothing this fragment contributes survives what is in front of it; skip the shading
+        discard;
+    }
+
+    if ((in.flags & PARTICLE_FLAG_LIGHTING) != 0u) {
+        color = particle_apply_lighting(color, in.world_position, normalize(in.normal));
+        if (particle_avboit_is_empty(color, in.blend)) {
+            discard;
+        }
+    }
+
+    let volumetrics = sample_volumetrics(in.view_depth, screen_uv, in.clip.xy);
+
+    let contribution = particle_avboit_contribution(color, in.blend, transmittance, volumetrics);
+
+    var out : ParticleAVBOITDrawOutput;
+
+    out.color = contribution.color;
+    out.norm = contribution.norm;
+    out.extinction = contribution.extinction;
+    out.emission = contribution.emission;
+
+    return out;
+}
+`, [
+    chunk_particle_avboit_contribution,
+    chunk_particle_scene_view_depth,
+    chunk_particle_billboard_vertex,
+    chunk_particle_lighting,
+    chunk_sample_volumetrics,
+    chunk_avboit_view_depth_to_virtual,
+    chunk_avboit_footprint_bias,
+    chunk_avboit_sample_transmittance,
+    chunk_view_mip_bias,
+]);
+
+const descriptor = ShaderDescriptor.from({ label: "Particle AVBOIT Draw", body, resources });
+
+/**
+ * The variants share WGSL, bindings and attachments; only the vertex entry point and target writes
+ * differ. Disabling unused targets avoids blending zeros over every billboard pixel.
+ * @param {string} label
+ * @param {string} entryPoint
+ * @param {number[]} writeMasks
+ * @returns {RenderPipelineDescriptor}
+ */
+function create_draw_pipeline(label, entryPoint, writeMasks) {
+    return RenderPipelineDescriptor.from({
+        label,
+        layout: resources.generatePipelineLayout(GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT),
+        vertex: { module: { code: descriptor.source }, entryPoint },
+        fragment: {
+            module: { code: descriptor.source },
+            entryPoint: "fs_main",
+            targets: AVBOIT_DRAW_TARGETS.map((target, i) => ({ ...target, writeMask: writeMasks[i] })),
+        },
+        depthStencil: DepthStencilState.from({ format: "depth32float", depthWriteEnabled: false, depthCompare: "greater" }),
+        primitive: { topology: "triangle-list", cullMode: "none" },
+    });
+}
+
+export const PARTICLE_AVBOIT_DRAW_ALPHA_PIPELINE = create_draw_pipeline("Particle AVBOIT Draw Alpha", "vs_alpha", [0xF, 0xF, 0xF, 0]);
+export const PARTICLE_AVBOIT_DRAW_ADDITIVE_PIPELINE = create_draw_pipeline("Particle AVBOIT Draw Additive", "vs_additive", [0, 0, 0, 0xF]);
+export const PARTICLE_AVBOIT_DRAW_GENERAL_PIPELINE = create_draw_pipeline("Particle AVBOIT Draw General", "vs_general", [0xF, 0xF, 0xF, 0xF]);
+
+/** The draw shader's resource set, for building its bind group. */
+export const PARTICLE_AVBOIT_DRAW_RESOURCES = resources;
+
+/** The assembled shader, for the validity tier. */
+export const shader_particle_avboit_draw = descriptor;

package/src/shade/renderer/particles/shaders/shader_particle_avboit_splat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_particle_avboit_splat.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/particles/shaders/shader_particle_avboit_splat.js"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,sDAFU,MAAM,CAEyC;AAmGzD;;;GAGG;AACH,6CAFU,wBAAwB,CAY/B;AAEH,8FAA8F;AAC9F,0EAAyD;AAEzD,mDAAmD;AACnD,4DAAuD;yCA7Id,iEAAiE;4CAY9D,sDAAsD;iCAFjE,kCAAkC"}
+{"version":3,"file":"shader_particle_avboit_splat.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/particles/shaders/shader_particle_avboit_splat.js"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,sDAFU,MAAM,CAEyC;AA2GzD;;;GAGG;AACH,6CAFU,wBAAwB,CAY/B;AAEH,8FAA8F;AAC9F,0EAAyD;AAEzD,mDAAmD;AACnD,4DAAuD;yCArJd,iEAAiE;4CAY9D,sDAAsD;iCAFjE,kCAAkC"}