@woosh/meep-engine 3.11.1 → 3.11.3

package/src/shade/renderer/GraphicsContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GraphicsContext.d.ts","sourceRoot":"","sources":["../../../../src/shade/renderer/GraphicsContext.js"],"names":[],"mappings":"AAwBA;IAoJI,yBA8BC;IAjLD;;OAEG;IACH,YAFU,kBAAkB,CAEjB;IAEX;;OAEG;IACH,WAFU,kBAAkB,CAElB;IAOV;;OAEG;IACH,UAFU,iBAAiB,CAElB;IAET;;;OAGG;IACH,qDAOC;IAOD;;;OAGG;IACH,6CAEC;IAED;;OAEG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,mBAFU,sBAAsB,CAEd;IAGlB;;OAEG;IACH,gBAFU,oBAAoB,CAEf;IAEf;;OAEG;IACH,UAFU,cAAc,CAEf;IAET;;;;OAIG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,aAFU,gBAAgB,CAEd;IAQZ;;;OAGG;IACH,uBAFU,kBAAkB,CAEN;IAEtB;;;;OAIG;IACH,yBAFU,wBAAwB,CAEV;IAExB;;;OAGG;IACH,0BAFU,yBAAyB,CAEV;IAEzB;;;OAGG;IACH,oBAFU,mBAAmB,CAEV;IAUnB;;;OAGG;IACH,8BAEC;IAED,uBAMC;IAED;;;OAGG;IACH,wBAEC;IAkCD;;;;;OAKG;IACH,gGAFW,oBAAoB,EAAE,QAwDhC;IAED;;;;OAIG;IACH,mDAFa,gBAAgB,CAI5B;IAED;;OAEG;IACH,+BAcC;IAED,4BAEC;IAED,eAmBC;IAED,gBAcC;IAGL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;;CAN1C;mCAlUkC,kCAAkC;mCAGlC,kCAAkC;kCADnC,wBAAwB;2CAEf,mDAAmD;oCAH1D,2CAA2C;sCAXzC,6CAA6C;sCAC7C,6CAA6C;uCAF5C,8CAA8C;qCAIhD,0CAA0C;+BAchD,6BAA6B;sCACtB,4CAA4C;iCAbjD,+BAA+B;mCAC7B,gCAAgC;yCAC1B,sCAAsC;0CAErC,uCAAuC;oCAO7C,kCAAkC;iCARtB,8BAA8B"}
+{"version":3,"file":"GraphicsContext.d.ts","sourceRoot":"","sources":["../../../../src/shade/renderer/GraphicsContext.js"],"names":[],"mappings":"AAwBA;IAoJI,yBA8BC;IAjLD;;OAEG;IACH,YAFU,kBAAkB,CAEjB;IAEX;;OAEG;IACH,WAFU,kBAAkB,CAElB;IAOV;;OAEG;IACH,UAFU,iBAAiB,CAElB;IAET;;;OAGG;IACH,qDAOC;IAOD;;;OAGG;IACH,6CAEC;IAED;;OAEG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,mBAFU,sBAAsB,CAEd;IAGlB;;OAEG;IACH,gBAFU,oBAAoB,CAEf;IAEf;;OAEG;IACH,UAFU,cAAc,CAEf;IAET;;;;OAIG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,aAFU,gBAAgB,CAEd;IAQZ;;;OAGG;IACH,uBAFU,kBAAkB,CAEN;IAEtB;;;;OAIG;IACH,yBAFU,wBAAwB,CAEV;IAExB;;;OAGG;IACH,0BAFU,yBAAyB,CAEV;IAEzB;;;OAGG;IACH,oBAFU,mBAAmB,CAEV;IAUnB;;;OAGG;IACH,8BAEC;IAED,uBAMC;IAED;;;OAGG;IACH,wBAEC;IAkCD;;;;;;;;OAQG;IACH,gGALW,oBAAoB,EAAE,cACtB;QAAC,MAAM,eAAe;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,QAmE9D;IAED;;;;OAIG;IACH,mDAFa,gBAAgB,CAI5B;IAED;;OAEG;IACH,+BAcC;IAED,4BAEC;IAED,eAmBC;IAED,gBAcC;IAGL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;;CAN1C;mCA9UkC,kCAAkC;mCAGlC,kCAAkC;kCADnC,wBAAwB;2CAEf,mDAAmD;oCAH1D,2CAA2C;sCAXzC,6CAA6C;sCAC7C,6CAA6C;uCAF5C,8CAA8C;qCAIhD,0CAA0C;+BAchD,6BAA6B;sCACtB,4CAA4C;iCAbjD,+BAA+B;mCAC7B,gCAAgC;yCAC1B,sCAAsC;0CAErC,uCAAuC;oCAO7C,kCAAkC;iCARtB,8BAA8B"}

package/src/shade/renderer/GraphicsContext.js

@@ -207,14 +207,26 @@ export class GraphicsContext {
      * @param {GPUBindingCommandsMixin} pass
      * @param {PipelineDescriptorBase} pipeline
      * @param {GPUBindingResource[][]} [bindings]
+     * @param {{buffer: BinaryBuffer, offset: number, size: number}} [immediate] bytes to hand the
+     *        pass through `setImmediates`, when the pipeline declares immediate data. Optional so
+     *        that every caller predating immediates keeps working unchanged.
      */
     setPipelineBindings(
         pass,
         pipeline,
-        bindings
+        bindings,
+        immediate
     ) {
         assert.isArray(bindings, 'bindings');
 
+        if (immediate !== undefined) {
+            // `raw_bytes` is read here rather than cached by the caller: BinaryBuffer rebinds it
+            // when the backing store grows, so a reference taken earlier can be stale. It is also a
+            // Uint8Array, for which `setImmediates` counts offset and size in elements — and its
+            // elements are bytes, so the range passes through unchanged.
+            pass.setImmediates(0, immediate.buffer.raw_bytes, immediate.offset, immediate.size);
+        }
+
         const bind_group_descriptors = pipeline.layout.bindGroupLayouts;
 
         const bind_group_count = bindings.length;

package/src/shade/renderer/Renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Renderer.d.ts","sourceRoot":"","sources":["../../../../src/shade/renderer/Renderer.js"],"names":[],"mappings":"AA4FA;IAOI,0BAEC;IAED;;OAEG;IACH,0BAAQ;IAER;;;;;;OAMG;IACH,kDAEC;IAED;;OAEG;IACH,kBAAO;IAYP;;;OAGG;IACH,2BAEC;IAaD,0CAGC;IAED,uCAEC;IAED;;;;OAIG;IACH,wBAFU,yBAAyB,CAEoB;IAEvD,6BAA4B;IAC5B,8BAA4B;IAC5B;;;;OAIG;IACH,mCAAkC;IAClC;;;;;;;OAOG;IACH,mCAFU,OAAO,CAEyB;IAC1C,+BAA6B;IAC7B,4CAA0C;IAkB1C,uCAKC;IArBD;;;;;;;;;;OAUG;IACH,oCAGC;IASD;;;;;;;OAOG;IACH,0BAFU,OAAO,CAEe;IAQhC;;;;;OAKG;IACH,sCAOC;IAjBD,mCAEC;IAiBD;;;;;;;;;OASG;IACH,6BAFU,OAAO,CAEmB;IAWpC;;;;;OAKG;IACH,8BAA+C;IAE/C;;;;;;;;OAQG;IACH,6BAFU,OAAO,CAEmB;IAEpC;;;;;;;;;;;;;;OAcG;IACH,8BAFU,OAAO,CAEoB;IAErC;;;;;;;;;;OAUG;IACH,qBAFU,OAAO,CAEW;IAU5B;;;;;OAKG;IACH,wBAA0C;IAE1C;;;;;;;;OAQG;IACH,eAFU,UAAU,GAAC,QAAQ,CAEF;IAU3B;;;;OAIG;IACH,gCAAwD;IAExD;;;;;;;;;;;;OAYG;IACH,gBAFU,OAAO,CAEK;IAEtB;;;OAGG;IACH,4BAFU,OAAO,CAEiB;IAKlC;;;OAGG;IACH,yBAEC;IAOD;;;OAGG;IACH,gCAEC;IAcD;;;;;;;;;OASG;IACH,qBAA+B;IAE/B,wBAA+B;IAE/B;;;OAGG;IACH,kBAA4B;IAiB5B;;;OAGG;IACH,2CAeC;IAED;;;OAGG;IACH,wCAEC;IA0BD;;;OAGG;IACH,iCAEC;IAED;;;;OAIG;IACH,2BAEC;IAQD;;;OAGG;IACH,+CAIC;IAED;;;OAGG;IACH,gDAIC;IAwCD;;;OAGG;IACH,6BAcC;IA1BD;;;OAGG;IACH,0BAEC;IA4BD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAFU,oBAAkB,IAAI,CAET;IAEvB;;OAEG;IACH;;;;;;;;;;;;;;OAcG;IACH,2DAEC;IAED;;;;;OAKG;IACH,8CAFa,OAAO,CAInB;IAED;;;OAGG;IACH,uBAHW,UAAU,GACR,MAAM,CAIlB;IAGD,sCAIC;IAeD;;;;OAIG;IACH,iCAFY,gBAAgB,CAW3B;IAED;;;OAGG;IACH,6BAYC;IAED;;;;OAIG;IACH,wCAFa,2BAA2B,CAcvC;IAGD;;;OAGG;IACH,+BAuBC;IAmMD;;;;OAIG;IACH,0BAEC;IAgBD;;;;;;OAMG;IACH,cAFU,iBAAiB,CAEU;IAErC;;;;;;OAMG;IACH,eAgBC;IAiFD;;;;;OAKG;IACH,+EA0NC;IAED;;OAEG;IACH,gBAGC;IAQD,4BAwBC;IAqID;;;;;OAKG;IACH,UAHW,MAAM,KACN,MAAM,QAgBhB;IAoFD,0CAMC;IAED;;;;;;;;;;OAUG;IACH,qEAHW,MAAM,GACJ,OAAO,CAsBnB;IAED;;;;;;;;;;;;;;;OAeG;IACH,8EAJW,MAAM,UACN,iBAAiB,GACf,OAAO,CA62BnB;;CACJ;6BAv6E4B,yBAAyB;0CACZ,gCAAgC;2BAL/C,yCAAyC;6BACvC,4CAA4C;8BAC3C,2CAA2C;4BAc7C,uBAAuB;gCA1BnB,sBAAsB;mBAjDnC,oCAAoC;oBACnC,4BAA4B;kCAuEd,gCAAgC;2BAvCvC,2BAA2B;iCAoCrB,0CAA0C;4CAvB/B,+DAA+D;yBA7BlF,yBAAyB;kCAgDhB,wBAAwB;oBAVtC,0BAA0B;uCAJP,sDAAsD"}
+{"version":3,"file":"Renderer.d.ts","sourceRoot":"","sources":["../../../../src/shade/renderer/Renderer.js"],"names":[],"mappings":"AA4FA;IAOI,0BAEC;IAED;;OAEG;IACH,0BAAQ;IAER;;;;;;OAMG;IACH,kDAEC;IAED;;OAEG;IACH,kBAAO;IAYP;;;OAGG;IACH,2BAEC;IAaD,0CAGC;IAED,uCAEC;IAED;;;;OAIG;IACH,wBAFU,yBAAyB,CAEoB;IAEvD,6BAA4B;IAC5B,8BAA4B;IAC5B;;;;OAIG;IACH,mCAAkC;IAClC;;;;;;;OAOG;IACH,mCAFU,OAAO,CAEyB;IAC1C,+BAA6B;IAC7B,4CAA0C;IAkB1C,uCAKC;IArBD;;;;;;;;;;OAUG;IACH,oCAGC;IASD;;;;;;;OAOG;IACH,0BAFU,OAAO,CAEe;IAQhC;;;;;OAKG;IACH,sCAOC;IAjBD,mCAEC;IAiBD;;;;;;;;;OASG;IACH,6BAFU,OAAO,CAEmB;IAWpC;;;;;OAKG;IACH,8BAA+C;IAE/C;;;;;;;;OAQG;IACH,6BAFU,OAAO,CAEmB;IAEpC;;;;;;;;;;;;;;OAcG;IACH,8BAFU,OAAO,CAEoB;IAErC;;;;;;;;;;OAUG;IACH,qBAFU,OAAO,CAEW;IAU5B;;;;;OAKG;IACH,wBAA0C;IAE1C;;;;;;;;OAQG;IACH,eAFU,UAAU,GAAC,QAAQ,CAEF;IAU3B;;;;OAIG;IACH,gCAAwD;IAExD;;;;;;;;;;;;OAYG;IACH,gBAFU,OAAO,CAEK;IAEtB;;;OAGG;IACH,4BAFU,OAAO,CAEiB;IAKlC;;;OAGG;IACH,yBAEC;IAOD;;;OAGG;IACH,gCAEC;IAcD;;;;;;;;;OASG;IACH,qBAA+B;IAE/B,wBAA+B;IAE/B;;;OAGG;IACH,kBAA4B;IAiB5B;;;OAGG;IACH,2CAeC;IAED;;;OAGG;IACH,wCAEC;IA0BD;;;OAGG;IACH,iCAEC;IAED;;;;OAIG;IACH,2BAEC;IAQD;;;OAGG;IACH,+CAIC;IAED;;;OAGG;IACH,gDAIC;IAwCD;;;OAGG;IACH,6BAcC;IA1BD;;;OAGG;IACH,0BAEC;IA4BD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAFU,oBAAkB,IAAI,CAET;IAEvB;;OAEG;IACH;;;;;;;;;;;;;;OAcG;IACH,2DAEC;IAED;;;;;OAKG;IACH,8CAFa,OAAO,CAInB;IAED;;;OAGG;IACH,uBAHW,UAAU,GACR,MAAM,CAIlB;IAGD,sCAIC;IAeD;;;;OAIG;IACH,iCAFY,gBAAgB,CAW3B;IAED;;;OAGG;IACH,6BAYC;IAED;;;;OAIG;IACH,wCAFa,2BAA2B,CAcvC;IAGD;;;OAGG;IACH,+BAuBC;IAmMD;;;;OAIG;IACH,0BAEC;IAgBD;;;;;;OAMG;IACH,cAFU,iBAAiB,CAEU;IAErC;;;;;;OAMG;IACH,eAgBC;IAiFD;;;;;OAKG;IACH,+EA0NC;IAED;;OAEG;IACH,gBAGC;IAQD,4BAwBC;IAqID;;;;;OAKG;IACH,UAHW,MAAM,KACN,MAAM,QAgBhB;IAoFD,0CAMC;IAED;;;;;;;;;;OAUG;IACH,qEAHW,MAAM,GACJ,OAAO,CAsBnB;IAED;;;;;;;;;;;;;;;OAeG;IACH,8EAJW,MAAM,UACN,iBAAiB,GACf,OAAO,CAi3BnB;;CACJ;6BA16E4B,yBAAyB;0CACZ,gCAAgC;2BApB/C,yCAAyC;6BAFvC,4CAA4C;8BAD3C,2CAA2C;4BAiC7C,uBAAuB;gCAtCnB,sBAAsB;mBArCnC,oCAAoC;oBACnC,4BAA4B;kCAuEd,gCAAgC;2BApDvC,2BAA2B;iCAkDrB,0CAA0C;4CApC/B,+DAA+D;yBA6BlF,yBAAyB;kCAMhB,wBAAwB;oBAvBtC,0BAA0B;uCAPP,sDAAsD"}

package/src/shade/renderer/Renderer.js

@@ -16,21 +16,8 @@ import { CameraManager } from "./camera/CameraManager.js";
 import { shader_background } from "./deferred/shader_background.js";
 import { shader_composite_volumetrics } from "./deferred/shader_composite_volumetrics.js";
 import { shader_deferred_main, shader_deferred_main_restir } from "./deferred/shader_deferred_main.js";
-import { ReSTIRDI } from "./restir/di/ReSTIRDI.js";
 import { shader_tonemap_HDR } from "./deferred/shader_tonemap_HDR.js";
 import { shader_tonemap_LDR } from "./deferred/shader_tonemap_LDR.js";
-import { G_BUFFER_MIP_LEVELS } from "./gbuffer/G_BUFFER_MIP_LEVELS.js";
-import {
-    graph_rasterize_meshes_transparent_oit
-} from "./rasterize/native/oit/graph_rasterize_meshes_transparent_oit.js";
-import {
-    viz_rasterization_alpha_tested_pass_descriptor
-} from "./rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.js";
-import {
-    viz_rasterization_opaque_pass_descriptor
-} from "./rasterize/native/viz/viz_rasterization_opaque_pass_descriptor.js";
-import { RasterizationJob } from "./rasterize/RasterizationJob.js";
-import { graph_rasterize_scene } from "./rasterize/standard/graph_rasterize_scene.js";
 import { FrameContext } from "./extension/FrameContext.js";
 import { FramePhase } from "./extension/FramePhase.js";
 import { GBufferTextures } from "./extension/GBufferTextures.js";
@@ -38,6 +25,7 @@ import { PresentTarget } from "./extension/PresentTarget.js";
 import { RenderExtensionRegistry } from "./extension/RenderExtensionRegistry.js";
 import { SceneColor } from "./extension/SceneColor.js";
 import { ViewTextures } from "./extension/ViewTextures.js";
+import { G_BUFFER_MIP_LEVELS } from "./gbuffer/G_BUFFER_MIP_LEVELS.js";
 import { shader_brick4_diffuse } from "./global_illumination/brick4/gpu/draw/shader_brick4_diffuse.js";
 import {
     shader_brick4_indirect_lighting
@@ -53,24 +41,36 @@ import { graph_build_light_clusters } from "./light/cluster/graph_build_light_cl
 import { AccumulatingPathTracer } from "./path_tracer/accumulating/AccumulatingPathTracer.js";
 import { graph_postprocess_bloom } from "./postprocess/bloom/graph_postprocess_bloom.js";
 import { shader_ffx_rcas } from "./postprocess/cas/shader_ffx_rcas.js";
+import { DepthOfFieldU } from "./postprocess/dof/gather/DepthOfFieldU.js";
+import { DepthOfField } from "./postprocess/dof/raymarch/DepthOfField.js";
 import { GPUCameraExposureManager } from "./postprocess/eye/GPUCameraExposureManager.js";
+import { MotionBlur } from "./postprocess/motion_blur/MotionBlur.js";
 import { NSS } from "./postprocess/nss/NSS.js";
 import { PostProcess } from "./postprocess/PostProcess.js";
 import { shader_depth_occlusion_clip } from "./postprocess/taa/shader_depth_occlusion_clip.js";
 import { TAA } from "./postprocess/taa/TAA.js";
-import { MotionBlur } from "./postprocess/motion_blur/MotionBlur.js";
-import { DepthOfField } from "./postprocess/dof/raymarch/DepthOfField.js";
-import { DepthOfFieldU } from "./postprocess/dof/gather/DepthOfFieldU.js";
 import { graph_add_per_object_velocity } from "./postprocess/velocity/graph_add_per_object_velocity.js";
+import { shader_debug_velocity } from "./postprocess/velocity/shader_debug_velocity.js";
+import {
+    graph_rasterize_meshes_transparent_oit
+} from "./rasterize/native/oit/graph_rasterize_meshes_transparent_oit.js";
+import {
+    viz_rasterization_alpha_tested_pass_descriptor
+} from "./rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.js";
+import {
+    viz_rasterization_opaque_pass_descriptor
+} from "./rasterize/native/viz/viz_rasterization_opaque_pass_descriptor.js";
+import { RasterizationJob } from "./rasterize/RasterizationJob.js";
+import { graph_rasterize_scene } from "./rasterize/standard/graph_rasterize_scene.js";
+import { ReSTIRDI } from "./restir/di/ReSTIRDI.js";
 import { SceneManager } from "./scene/SceneManager.js";
 import { ShadeIndirectLightingMode } from "./ShadeIndirectLightingMode.js";
-import { ShadeUpscalerType } from "./ShadeUpscalerType.js";
 import { graph_image_pass } from "./shader/graph/graph_image_pass.js";
 import { graph_import_buffer } from "./shader/graph/graph_import_buffer.js";
 import { graph_import_texture } from "./shader/graph/graph_import_texture.js";
+import { ShadeUpscalerType } from "./ShadeUpscalerType.js";
 import { CascadedSceneSDF } from "./shadow/sdf/cascade/CascadedSceneSDF.js";
 import { STATIC_GRAPHICS_ENGINE_ASSETS } from "./STATIC_GRAPHICS_ENGINE_ASSETS.js";
-import { shader_debug_velocity } from "./postprocess/velocity/shader_debug_velocity.js";
 import { GPUTextureContext } from "./texture/GPUTextureContext.js";
 import { RenderTarget } from "./texture/RenderTarget.js";
 import { View } from "./view/View.js";
@@ -2267,6 +2267,8 @@ export class Renderer {
 
         if (this.#feature_enabled_transparencies) {
             // do transparent alpha pass
+            graph.push_scope("transparencies");
+
             current_color_out = graph_rasterize_meshes_transparent_oit({
                 graph,
                 buckets: gr_render_buckets,
@@ -2288,6 +2290,8 @@ export class Renderer {
 
                 indirect_lighting_mode: this.indirect_lighting_mode,
             });
+
+            graph.pop_scope();
         }
 
         frame.phase = FramePhase.AfterTransparency;

package/src/shade/renderer/atmosphere/GPUSky.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUSky.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/atmosphere/GPUSky.js"],"names":[],"mappings":"AASA;IAuCI;;;OAGG;IACH,uCAkBC;IAjDD;;;OAGG;IACH,2CAEC;IAOD;;;OAGG;IACH,iDAEC;IAgCD,gBAGC;IAED,cAYC;IAED;;OAEG;IACH,eA8CC;;CAEJ;kCAzIiC,iCAAiC"}
+{"version":3,"file":"GPUSky.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/atmosphere/GPUSky.js"],"names":[],"mappings":"AAUA;IAuCI;;;OAGG;IACH,uCAmBC;IAlDD;;;OAGG;IACH,2CAEC;IAOD;;;OAGG;IACH,iDAEC;IAiCD,gBAGC;IAED,cAYC;IAED;;OAEG;IACH,eA+CC;;CAEJ;kCA3IiC,iCAAiC"}

package/src/shade/renderer/atmosphere/GPUSky.js

@@ -1,143 +1,146 @@
-import { FrameGraph } from "../../../engine/graphics/render/frame_graph/FrameGraph.js";
-import { TextureResourceDescriptor } from "../../device/graph/TextureResourceDescriptor.js";
-import { ShadeGPUCommandContext } from "../../device/ShadeGPUCommandContext.js";
-import { graph_image_pass } from "../shader/graph/graph_image_pass.js";
-import { debug_draw_texture } from "../texture/debug_draw_texture.js";
-import { GPUTextureContext } from "../texture/GPUTextureContext.js";
-import { shader_multiscatter_lut } from "./shader_multiscatter_lut.js";
-import { shader_transmittance_lut } from "./shader_transmittance_lut.js";
-
-export class GPUSky {
-
-    /**
-     * @type {GraphicsContext}
-     */
-    #graphics;
-
-    /**
-     * @type {GPUTextureContext}
-     */
-    #lut_transmittance;
-
-    /**
-     *
-     * @returns {GPUTextureContext}
-     */
-    get lut_transmittance() {
-        return this.#lut_transmittance;
-    }
-
-    /**
-     * @type {GPUTextureContext}
-     */
-    #lut_multiple_scattering;
-
-    /**
-     *
-     * @returns {GPUTextureContext}
-     */
-    get lut_multiple_scattering() {
-        return this.#lut_multiple_scattering;
-    }
-
-    /**
-     *
-     * @type {boolean}
-     */
-    #needs_update = true;
-
-    /**
-     *
-     * @param {GraphicsContext} graphics
-     */
-    constructor(graphics) {
-        this.#graphics = graphics;
-
-        const device = graphics.device;
-
-        this.#lut_transmittance = new GPUTextureContext(device);
-        this.#lut_transmittance.descriptor.label = "Sky / Transmittance LUT";
-        this.#lut_transmittance.descriptor.format = "rgba16float";
-        this.#lut_transmittance.descriptor.usage = GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
-        this.#lut_transmittance.resize(256, 64);
-
-        this.#lut_multiple_scattering = new GPUTextureContext(device);
-        this.#lut_multiple_scattering.descriptor.label = "Sky / Multiple Scattering LUT";
-        this.#lut_multiple_scattering.descriptor.format = "rgba16float";
-        this.#lut_multiple_scattering.descriptor.usage = GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
-        this.#lut_multiple_scattering.resize(32, 32);
-
-
-    }
-
-    destroy() {
-        this.#lut_transmittance.destroy();
-        this.#lut_multiple_scattering.destroy();
-    }
-
-    debug() {
-
-
-        let y = 50;
-        debug_draw_texture({ texture: this.#lut_transmittance, x: 50, y: y });
-
-        y += this.#lut_transmittance.size[1] + 50;
-
-        debug_draw_texture({ texture: this.#lut_multiple_scattering, x: 50, y: y });
-
-        y += this.#lut_multiple_scattering.size[1] + 50;
-
-    }
-
-    /**
-     *
-     */
-    update() {
-        if (!this.#needs_update) {
-            return;
-        }
-
-        const graph = new FrameGraph("sky update");
-
-        const command_ctx = ShadeGPUCommandContext.create(
-            this.#graphics,
-            "Renderer/main"
-        );
-
-        const gr_transmittance = graph.import_resource("transmittance", TextureResourceDescriptor.fromTexture(this.#lut_transmittance.gpu_texture), this.#lut_transmittance);
-        const gr_multiscatter = graph.import_resource("multiscatter", TextureResourceDescriptor.fromTexture(this.#lut_multiple_scattering.gpu_texture), this.#lut_multiple_scattering);
-
-        graph_image_pass({
-            graph,
-            shader: shader_transmittance_lut,
-            inputs: {
-                settings: {
-                    steps: 40,
-                }
-            },
-            output: [gr_transmittance]
-        });
-
-
-        graph_image_pass({
-            graph,
-            shader: shader_multiscatter_lut,
-            inputs: {
-                settings: {
-                    steps: 20,
-                    sqrt_samples: 8,
-                },
-                tSkyLutTransmittance: gr_transmittance
-            },
-            output: [gr_multiscatter]
-        });
-
-        command_ctx.encodeGraph(graph);
-
-        command_ctx.finish();
-
-
-        this.#needs_update = false;
-    }
-
+import { FrameGraph } from "../../../engine/graphics/render/frame_graph/FrameGraph.js";
+import { TextureResourceDescriptor } from "../../device/graph/TextureResourceDescriptor.js";
+import { ShadeGPUCommandContext } from "../../device/ShadeGPUCommandContext.js";
+import { graph_compute_pass } from "../shader/graph/compute/graph_compute_pass.js";
+import { graph_image_pass } from "../shader/graph/graph_image_pass.js";
+import { debug_draw_texture } from "../texture/debug_draw_texture.js";
+import { GPUTextureContext } from "../texture/GPUTextureContext.js";
+import { shader_multiscatter_lut } from "./shader_multiscatter_lut.js";
+import { shader_transmittance_lut } from "./shader_transmittance_lut.js";
+
+export class GPUSky {
+
+    /**
+     * @type {GraphicsContext}
+     */
+    #graphics;
+
+    /**
+     * @type {GPUTextureContext}
+     */
+    #lut_transmittance;
+
+    /**
+     *
+     * @returns {GPUTextureContext}
+     */
+    get lut_transmittance() {
+        return this.#lut_transmittance;
+    }
+
+    /**
+     * @type {GPUTextureContext}
+     */
+    #lut_multiple_scattering;
+
+    /**
+     *
+     * @returns {GPUTextureContext}
+     */
+    get lut_multiple_scattering() {
+        return this.#lut_multiple_scattering;
+    }
+
+    /**
+     *
+     * @type {boolean}
+     */
+    #needs_update = true;
+
+    /**
+     *
+     * @param {GraphicsContext} graphics
+     */
+    constructor(graphics) {
+        this.#graphics = graphics;
+
+        const device = graphics.device;
+
+        this.#lut_transmittance = new GPUTextureContext(device);
+        this.#lut_transmittance.descriptor.label = "Sky / Transmittance LUT";
+        this.#lut_transmittance.descriptor.format = "rgba16float";
+        this.#lut_transmittance.descriptor.usage = GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
+        this.#lut_transmittance.resize(256, 64);
+
+        this.#lut_multiple_scattering = new GPUTextureContext(device);
+        this.#lut_multiple_scattering.descriptor.label = "Sky / Multiple Scattering LUT";
+        this.#lut_multiple_scattering.descriptor.format = "rgba16float";
+        // written by a compute shader, so STORAGE_BINDING rather than RENDER_ATTACHMENT
+        this.#lut_multiple_scattering.descriptor.usage = GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
+        this.#lut_multiple_scattering.resize(32, 32);
+
+
+    }
+
+    destroy() {
+        this.#lut_transmittance.destroy();
+        this.#lut_multiple_scattering.destroy();
+    }
+
+    debug() {
+
+
+        let y = 50;
+        debug_draw_texture({ texture: this.#lut_transmittance, x: 50, y: y });
+
+        y += this.#lut_transmittance.size[1] + 50;
+
+        debug_draw_texture({ texture: this.#lut_multiple_scattering, x: 50, y: y });
+
+        y += this.#lut_multiple_scattering.size[1] + 50;
+
+    }
+
+    /**
+     *
+     */
+    update() {
+        if (!this.#needs_update) {
+            return;
+        }
+
+        const graph = new FrameGraph("sky update");
+
+        const command_ctx = ShadeGPUCommandContext.create(
+            this.#graphics,
+            "Renderer/main"
+        );
+
+        const gr_transmittance = graph.import_resource("transmittance", TextureResourceDescriptor.fromTexture(this.#lut_transmittance.gpu_texture), this.#lut_transmittance);
+        const gr_multiscatter = graph.import_resource("multiscatter", TextureResourceDescriptor.fromTexture(this.#lut_multiple_scattering.gpu_texture), this.#lut_multiple_scattering);
+
+        graph_image_pass({
+            graph,
+            shader: shader_transmittance_lut,
+            inputs: {
+                settings: {
+                    steps: 40,
+                    // read off the texture rather than restated, so the two cannot disagree
+                    resolution: [this.#lut_transmittance.width, this.#lut_transmittance.height],
+                }
+            },
+            output: [gr_transmittance]
+        });
+
+
+        graph_compute_pass({
+            graph,
+            shader: shader_multiscatter_lut,
+            // one workgroup per LUT texel, counted off the texture being written so the
+            // dispatch cannot cover a different area than the shader stores into
+            group_count: [this.#lut_multiple_scattering.width, this.#lut_multiple_scattering.height, 1],
+            bindings: {
+                tSkyLutTransmittance: gr_transmittance,
+                tSkyLutMultiscatterOut: gr_multiscatter
+            }
+        });
+
+        command_ctx.encodeGraph(graph);
+
+        command_ctx.finish();
+
+
+        this.#needs_update = false;
+    }
+
 }

package/src/shade/renderer/atmosphere/MULTISCATTER_LUT_CONFIG.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Directions are drawn on an 8x8 grid, stratified in azimuth and in the cosine of the polar
+ * angle. Matches Hillaire's `SQRTSAMPLECOUNT`.
+ * @type {number}
+ */
+export const MULTISCATTER_LUT_SQRT_SAMPLES: number;
+/**
+ * One thread integrates one direction, so this is also the workgroup size.
+ *
+ * 64 is Hillaire's `[numthreads(1,1,64)]` count. It is a multiple of every legal subgroup
+ * size up to 64, and the reduction handles a subgroup wider than the workgroup, so no
+ * hardware needs a different number here.
+ * @type {number}
+ */
+export const MULTISCATTER_LUT_DIRECTION_COUNT: number;
+/**
+ * Ray-march steps per direction. Hillaire's `SampleCountIni` for this LUT; the comment there
+ * reads "a minimum set of step is required for accuracy unfortunately".
+ *
+ * Compile-time on purpose: as a uniform the inner loop cannot be unrolled and the trip count
+ * has to be re-tested against an f32 every iteration.
+ * @type {number}
+ */
+export const MULTISCATTER_LUT_STEPS: number;
+/**
+ * Upper bound on the number of subgroups in one workgroup, which is how many partial sums
+ * the cross-subgroup reduction has to combine.
+ *
+ * WGSL pins the subgroup size to a power of two in [4, 128], so the worst case is
+ * {@link MULTISCATTER_LUT_DIRECTION_COUNT} / 4.
+ * @type {number}
+ */
+export const MULTISCATTER_LUT_MAX_SUBGROUP_PARTIALS: number;
+//# sourceMappingURL=MULTISCATTER_LUT_CONFIG.d.ts.map

package/src/shade/renderer/atmosphere/MULTISCATTER_LUT_CONFIG.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MULTISCATTER_LUT_CONFIG.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/atmosphere/MULTISCATTER_LUT_CONFIG.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,4CAFU,MAAM,CAE+B;AAE/C;;;;;;;GAOG;AACH,+CAFU,MAAM,CAE8F;AAE9G;;;;;;;GAOG;AACH,qCAFU,MAAM,CAEyB;AAEzC;;;;;;;GAOG;AACH,qDAFU,MAAM,CAE2E"}

package/src/shade/renderer/atmosphere/MULTISCATTER_LUT_CONFIG.js

@@ -0,0 +1,36 @@
+/**
+ * Directions are drawn on an 8x8 grid, stratified in azimuth and in the cosine of the polar
+ * angle. Matches Hillaire's `SQRTSAMPLECOUNT`.
+ * @type {number}
+ */
+export const MULTISCATTER_LUT_SQRT_SAMPLES = 8;
+
+/**
+ * One thread integrates one direction, so this is also the workgroup size.
+ *
+ * 64 is Hillaire's `[numthreads(1,1,64)]` count. It is a multiple of every legal subgroup
+ * size up to 64, and the reduction handles a subgroup wider than the workgroup, so no
+ * hardware needs a different number here.
+ * @type {number}
+ */
+export const MULTISCATTER_LUT_DIRECTION_COUNT = MULTISCATTER_LUT_SQRT_SAMPLES * MULTISCATTER_LUT_SQRT_SAMPLES;
+
+/**
+ * Ray-march steps per direction. Hillaire's `SampleCountIni` for this LUT; the comment there
+ * reads "a minimum set of step is required for accuracy unfortunately".
+ *
+ * Compile-time on purpose: as a uniform the inner loop cannot be unrolled and the trip count
+ * has to be re-tested against an f32 every iteration.
+ * @type {number}
+ */
+export const MULTISCATTER_LUT_STEPS = 20;
+
+/**
+ * Upper bound on the number of subgroups in one workgroup, which is how many partial sums
+ * the cross-subgroup reduction has to combine.
+ *
+ * WGSL pins the subgroup size to a power of two in [4, 128], so the worst case is
+ * {@link MULTISCATTER_LUT_DIRECTION_COUNT} / 4.
+ * @type {number}
+ */
+export const MULTISCATTER_LUT_MAX_SUBGROUP_PARTIALS = MULTISCATTER_LUT_DIRECTION_COUNT / 4;

package/src/shade/renderer/atmosphere/SAMPLER_SKY_LUT.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Filtering sampler for the sky LUTs (transmittance, multiple-scattering).
+ *
+ * Both LUTs are `rgba16float`, which is filterable in core WebGPU — only the 32-bit float
+ * formats need the `float32-filterable` feature — so these can go through the texture unit
+ * instead of the 4-tap manual bilinear in `texture_sample_bilinear_uv`.
+ *
+ * `min` and `mag` are both set: the LUTs are single-mip and sampled with an explicit LOD of
+ * 0, which selects the magnification filter, but relying on that alone would silently fall
+ * back to point sampling if either LUT ever grew mips.
+ *
+ * Clamp-to-edge reproduces the manual filter's per-corner clamping exactly: `uv` is
+ * saturated by `sky_lut_uv`, and at the edges both bilinear taps collapse onto the edge
+ * texel.
+ *
+ * @type {Readonly<SamplerDescriptor>}
+ */
+export const SAMPLER_SKY_LUT: Readonly<SamplerDescriptor>;
+import { SamplerDescriptor } from "../../descriptor/texture/SamplerDescriptor.js";
+//# sourceMappingURL=SAMPLER_SKY_LUT.d.ts.map

package/src/shade/renderer/atmosphere/SAMPLER_SKY_LUT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SAMPLER_SKY_LUT.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/atmosphere/SAMPLER_SKY_LUT.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,8BAFU,SAAS,iBAAiB,CAAC,CAOjC;kCAxB8B,+CAA+C"}

package/src/shade/renderer/atmosphere/SAMPLER_SKY_LUT.js

@@ -0,0 +1,25 @@
+import { SamplerDescriptor } from "../../descriptor/texture/SamplerDescriptor.js";
+
+/**
+ * Filtering sampler for the sky LUTs (transmittance, multiple-scattering).
+ *
+ * Both LUTs are `rgba16float`, which is filterable in core WebGPU — only the 32-bit float
+ * formats need the `float32-filterable` feature — so these can go through the texture unit
+ * instead of the 4-tap manual bilinear in `texture_sample_bilinear_uv`.
+ *
+ * `min` and `mag` are both set: the LUTs are single-mip and sampled with an explicit LOD of
+ * 0, which selects the magnification filter, but relying on that alone would silently fall
+ * back to point sampling if either LUT ever grew mips.
+ *
+ * Clamp-to-edge reproduces the manual filter's per-corner clamping exactly: `uv` is
+ * saturated by `sky_lut_uv`, and at the edges both bilinear taps collapse onto the edge
+ * texel.
+ *
+ * @type {Readonly<SamplerDescriptor>}
+ */
+export const SAMPLER_SKY_LUT = Object.freeze(SamplerDescriptor.from({
+    magFilter: "linear",
+    minFilter: "linear",
+    addressModeU: "clamp-to-edge",
+    addressModeV: "clamp-to-edge",
+}));

package/src/shade/renderer/atmosphere/chunk_get_multiscatter_values.d.ts

@@ -1,6 +1,19 @@
 /**
- * Calculates Equation (5) and (7) from the paper.
+ * One direction's contribution to Equations (5) and (7) from the paper: `out_lum` is the
+ * second-order in-scattered luminance along `rayDir`, `out_fms` the luminance that would
+ * come back if the medium scattered one unit of light isotropically. The caller integrates
+ * over the direction set -- see {@link chunk_multiscatter_sample_direction} -- by taking the
+ * mean, which is what the paper's uniform phase p_u = 1/(4*PI) reduces to.
+ *
+ * Splitting one direction out of the loop is what lets `shader_multiscatter_lut` put a
+ * thread on each of the 64 directions, the way Hillaire's `NewMultiScattCS` does.
+ *
+ * `pos` is assumed to be inside the atmosphere and at or above the surface, which is what
+ * makes the far root of the outer sphere the atmosphere exit.
+ *
  * @see "A Scalable and Production Ready Sky and Atmosphere Rendering Technique", Hillaire (2020)
+ * @see https://www.shadertoy.com/view/slSXRW
+ * @type {CodeChunk}
  */
 export const chunk_get_multiscatter_values: CodeChunk;
 import { CodeChunk } from "../shader/compiler/CodeChunk.js";

package/src/shade/renderer/atmosphere/chunk_get_multiscatter_values.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_get_multiscatter_values.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/atmosphere/chunk_get_multiscatter_values.js"],"names":[],"mappings":"AA6BA;;;GAGG;AACH,sDA+IC;0BAxJyB,iCAAiC"}
+{"version":3,"file":"chunk_get_multiscatter_values.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/atmosphere/chunk_get_multiscatter_values.js"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;;;;GAgBG;AACH,4CAFU,SAAS,CA4HlB;0BAjJyB,iCAAiC"}