@driftengine/core 4.13.4 → 4.13.5

package/dist/render/backend/webgpu/mediumFields.js

@@ -0,0 +1,74 @@
+/** A field's byte offset in the block, or -1 where the shader compiled it out. */
+function placed(fields, name) {
+    return fields[name]?.offset ?? -1;
+}
+/** Into a block staged as floats, indexed in four-byte words. */
+export function writeMediumFields(fields, f, m) {
+    let at = placed(fields, 'uFogColor');
+    if (at >= 0)
+        f.set(m.fogColor, at / 4);
+    at = placed(fields, 'uFogMedium');
+    if (at >= 0) {
+        f[at / 4] = m.fogDensity;
+        f[at / 4 + 1] = m.fogHeightFalloff;
+        f[at / 4 + 2] = m.fogEyeY;
+        f[at / 4 + 3] = m.underwaterFogDensity;
+    }
+    at = placed(fields, 'uFogRange');
+    if (at >= 0) {
+        f[at / 4] = m.fogNear;
+        f[at / 4 + 1] = m.fogFar;
+        f[at / 4 + 2] = m.fogMode;
+        f[at / 4 + 3] = 0;
+    }
+    at = placed(fields, 'uUnderwaterColor');
+    if (at >= 0)
+        f.set(m.underwaterColor, at / 4);
+    at = placed(fields, 'uUnderwaterFactor');
+    if (at >= 0)
+        f[at / 4] = m.underwaterFactor;
+    at = placed(fields, 'uFogLayer2');
+    if (at >= 0)
+        f.set(m.fogLayer2, at / 4);
+    at = placed(fields, 'uFogGlow');
+    if (at >= 0)
+        f.set(m.fogGlow, at / 4);
+    at = placed(fields, 'uFogGlowDir');
+    if (at >= 0)
+        f.set(m.fogGlowDir, at / 4);
+}
+/** Into one slot of a ring, at the fields' byte offsets. */
+export function writeMediumSlot(ring, slot, fields, m) {
+    let at = placed(fields, 'uFogColor');
+    if (at >= 0)
+        ring.writeFloats(slot, at, m.fogColor);
+    at = placed(fields, 'uFogMedium');
+    if (at >= 0) {
+        ring.writeFloat(slot, at, m.fogDensity);
+        ring.writeFloat(slot, at + 4, m.fogHeightFalloff);
+        ring.writeFloat(slot, at + 8, m.fogEyeY);
+        ring.writeFloat(slot, at + 12, m.underwaterFogDensity);
+    }
+    at = placed(fields, 'uFogRange');
+    if (at >= 0) {
+        ring.writeFloat(slot, at, m.fogNear);
+        ring.writeFloat(slot, at + 4, m.fogFar);
+        ring.writeFloat(slot, at + 8, m.fogMode);
+        ring.writeFloat(slot, at + 12, 0);
+    }
+    at = placed(fields, 'uUnderwaterColor');
+    if (at >= 0)
+        ring.writeFloats(slot, at, m.underwaterColor);
+    at = placed(fields, 'uUnderwaterFactor');
+    if (at >= 0)
+        ring.writeFloat(slot, at, m.underwaterFactor);
+    at = placed(fields, 'uFogLayer2');
+    if (at >= 0)
+        ring.writeFloats(slot, at, m.fogLayer2);
+    at = placed(fields, 'uFogGlow');
+    if (at >= 0)
+        ring.writeFloats(slot, at, m.fogGlow);
+    at = placed(fields, 'uFogGlowDir');
+    if (at >= 0)
+        ring.writeFloats(slot, at, m.fogGlowDir);
+}

package/dist/render/backend/webgpu/plumePass.d.ts

@@ -15,9 +15,9 @@ export declare const PLUME_VERT_SIZE: 112;
 export declare const PLUME_FRAG_FIELDS: UniformFields;
 export declare const PLUME_FRAG_SIZE: number;
 /** Each material's own block, so a change to one and not the others is caught rather than assumed. */
-export declare const FIRE_FRAG_SIZE: 128;
-export declare const SMOKE_FRAG_SIZE: 128;
-export declare const ARCANE_FRAG_SIZE: 144;
+export declare const FIRE_FRAG_SIZE: 176;
+export declare const SMOKE_FRAG_SIZE: 176;
+export declare const ARCANE_FRAG_SIZE: 192;
 export declare function plumeVertexLayouts(): GPUVertexBufferLayout[];
 /** Plume geometry on the device, behind the surface's opaque handle. */
 export interface GpuPlumes {

package/dist/render/backend/webgpu/postPass.d.ts

@@ -26,7 +26,7 @@ import type { PipelineCache } from './pipelineCache.ts';
  * float target the generated shaders can sample as an ordinary texture.
  */
 export declare const RUSH_FRAG_FIELDS: UniformFields;
-export declare const RUSH_FRAG_SIZE: 288;
+export declare const RUSH_FRAG_SIZE: 320;
 declare const RUSH_UNIFORMS: 1;
 declare const RUSH_TEXTURES: {
     readonly uScene: {
@@ -75,7 +75,7 @@ export declare const AO_FRAG_SIZE: 96;
 export declare const AO_BLUR_FIELDS: UniformFields;
 export declare const AO_BLUR_SIZE: 48;
 export declare const MEDIUM_FRAG_FIELDS: UniformFields;
-export declare const MEDIUM_FRAG_SIZE: 304;
+export declare const MEDIUM_FRAG_SIZE: 2400;
 export declare const MEDIUM_UPSAMPLE_FIELDS: UniformFields;
 export declare const MEDIUM_UPSAMPLE_SIZE: 48;
 export declare const BLOOM_PREFILTER_FIELDS: UniformFields;
@@ -369,6 +369,11 @@ export declare const MEDIUM_TEXTURES: {
         readonly sampler: 35;
         readonly type: "sampler2DArray";
     };
+    readonly uPointShadows: {
+        readonly texture: 36;
+        readonly sampler: 37;
+        readonly type: "sampler2DArray";
+    };
 };
 export declare const MEDIUM_UPSAMPLE_UNIFORMS: 1;
 export declare const MEDIUM_UPSAMPLE_TEXTURES: {

package/dist/render/backend/webgpu/renderer.d.ts

@@ -35,6 +35,7 @@ import type { SurfaceMaterial, SurfaceTextureOptions } from '../../surfaceTextur
 import type { RenderBackend } from '../api.ts';
 import { type DisplayRange } from '../../displayRange.ts';
 import { type FilmicCurve } from '../../filmicCurve.ts';
+import type { LocalExposureOptions } from '../../shaders/localExposure.ts';
 import { type ColourGradeLut } from '../../colourGrade.ts';
 import type { CausticSheet } from '../../causticsRenderer.ts';
 import { type GpuCaustics } from './causticsPass.ts';
@@ -45,6 +46,7 @@ import type { DeviceParticles, ParticleInstances } from '../../particlePool.ts';
 import type { PlumeOptions, PlumePlacement } from '../../plumeRenderer.ts';
 import type { InstanceData } from '../../instancedMesh.ts';
 import { type RenderQuality } from '../../renderQuality.ts';
+import type { GlobalMediumSettings } from '../../globalMedium.ts';
 import type { MeshData } from '../../mesh.ts';
 import type { ShadowCasters } from '../../shadowCasters.ts';
 import { type GpuMesh } from './buffers.ts';
@@ -724,6 +726,9 @@ export declare class WebGPURenderer implements RendererApi {
     private readonly mediumInvProjection;
     /** This frame's medium. Off until a caller says otherwise. See `setGlobalMedium`. */
     private mediumOptions;
+    /** The lamps the medium is lit by, and the lit stage's lamps they come from, refilled a frame. */
+    private readonly mediumLamps;
+    private readonly mediumLights;
     /**
      * The temporal resolve: its block, its ping-pong pair, and the jitter state.
      *
@@ -1412,6 +1417,10 @@ export declare class WebGPURenderer implements RendererApi {
     setSurfaceReflectivity(amount: number): void;
     /** How bright the environment the surfaces drawn next reflect is. See `renderer.ts`. */
     setEnvironmentGain(gain: number): void;
+    /** The environment brought to the light where a surface stands. See `renderer.ts`. */
+    setEnvironmentMixing(weight: number, roughnessLow?: number, roughnessHigh?: number): void;
+    /** `uEnvironmentMixing` as it stands; none until a draw asks. See `setEnvironmentMixing`. */
+    private readonly environmentMixing;
     /**
      * The reflectivity and environment gain the setters gave the pass, and the ones the material
      * set now states, or null where it states none (`SurfaceMaterial.reflectivity`). A draw wears the
@@ -3980,8 +3989,9 @@ export declare class WebGPURenderer implements RendererApi {
     /** Eye adaptation: how far, this frame's time step, and the pass once asked for. */
     private autoExposure;
     private autoExposureDt;
-    /** How far each region is brought toward the frame. See `setLocalExposure`. */
+    /** Whether regions move, and how, as `resolveLocalExposure` packs it. See `setLocalExposure`. */
     private localExposure;
+    private readonly localExposureShape;
     private exposurePass;
     /**
      * How strongly the lens darkens the frame's corners, held until changed: 0 is none, 0.5 is about
@@ -4039,7 +4049,7 @@ export declare class WebGPURenderer implements RendererApi {
      * version is that `density` is extinction per metre, 0 is a real off that allocates nothing and
      * draws nothing, and the three optional arguments are held until changed.
      */
-    setGlobalMedium(density: number, albedo?: number, anisotropy?: number, maxDistance?: number): void;
+    setGlobalMedium(density: number | GlobalMediumSettings, albedo?: number | Vec3, anisotropy?: number, maxDistance?: number): void;
     /** How much speed blur the frame should resolve with, 0 to 1. */
     setSpeedRush(strength: number): void;
     /**
@@ -4083,7 +4093,7 @@ export declare class WebGPURenderer implements RendererApi {
      * the same setter over the same state, sharing eye adaptation's pass, which is built the first
      * time either is asked for.
      */
-    setLocalExposure(strength: number): void;
+    setLocalExposure(setting: number | LocalExposureOptions): void;
     /** The exposure pass, built once; the composite's group holds placeholders until it exists. */
     private ensureExposurePass;
     /**

package/dist/render/backend/webgpu/renderer.js

@@ -24,7 +24,9 @@ import { Camera } from '../../camera.js';
 import { PickableSet } from '../../pickable.js';
 import { GpuTimestamps } from './gpuTimestamps.js';
 import { isWeakGpuFamily } from '../../gpuCapability.js';
-import { resolveAtmosphere } from '../../atmosphere.js';
+import { writeMediumFields, writeMediumSlot } from './mediumFields.js';
+import { noEnvironmentMixing, resolveEnvironmentMixing } from '../../environmentMixing.js';
+import { createResolvedAtmosphere, resolveAtmosphere, } from '../../atmosphere.js';
 import { AMBIENT_SH_FLOATS, packAmbientSH } from '../../ambientHarmonics.js';
 import { lightmapTexels, warnRegionsWithoutPage, warnUnpagedLightmap, withLightmapUvs, } from '../../lightmap.js';
 import { BLOOM_FILTER_RADIUS_UV, BLOOM_LEVELS, bloomLevelSizes, bloomThresholdOf, bloomProfileWarning, defaultBloomResponse, resolveBloomResponse, } from '../../bloomChain.js';
@@ -88,7 +90,7 @@ import { DEFAULT_FILMIC_CURVE, FILMIC_CLAMPED, FILMIC_CONSTANTS, FILMIC_WITHOUT_
 import { ExposurePass } from './exposurePass.js';
 import { AO_STORE } from '../../shaders/ambientOcclusion.js';
 import { clampAutoExposure } from '../../shaders/exposure.js';
-import { clampLocalExposure } from '../../shaders/localExposure.js';
+import { LOCAL_EXPOSURE_FLOATS, resolveLocalExposure } from '../../shaders/localExposure.js';
 import { createDepthResolveLayout, createPostStageLayout, depthResolvePipeline, postPipeline, postPipelineTargets, sceneColorFormat, AO_BLUR_FIELDS, AO_BLUR_FRAG_WGSL, AO_BLUR_SIZE, AO_BLUR_TEXTURES, AO_BLUR_UNIFORMS, AO_FRAG_FIELDS, AO_FRAG_SIZE, AO_FRAG_WGSL, AO_TEXTURES, AO_UNIFORMS, BLOOM_DOWNSAMPLE_FIELDS, BLOOM_DOWNSAMPLE_FRAG_WGSL, BLOOM_PREFILTER_FIELDS, BLOOM_PREFILTER_FRAG_WGSL, BLOOM_STAGE_SIZE, BLOOM_TEXTURES, BLOOM_UNIFORMS, BLOOM_UPSAMPLE_FIELDS, TINTED_ADD_BLEND, BLOOM_UPSAMPLE_FRAG_WGSL, RESOLVED_DEPTH_FORMAT, RUSH_FRAG_FIELDS, RUSH_FRAG_SIZE, RUSH_FRAG_WGSL, RUSH_TEXTURES, RUSH_UNIFORMS, TAA_FRAG_FIELDS, TAA_FRAG_SIZE, TAA_TEXTURES, TAA_UNIFORMS, TEMPORAL_RESOLVE_FRAG_WGSL, MEDIUM_FRAG_FIELDS, MEDIUM_FRAG_SIZE, MEDIUM_FRAG_WGSL, MEDIUM_TEXTURES, MEDIUM_TRANSMIT_BLEND, MEDIUM_UNIFORMS, MEDIUM_UPSAMPLE_FIELDS, MEDIUM_UPSAMPLE_FRAG_WGSL, MEDIUM_UPSAMPLE_SIZE, MEDIUM_UPSAMPLE_TEXTURES, MEDIUM_UPSAMPLE_UNIFORMS, OIT_COMPOSITE_BLEND, OIT_RESOLVE_FRAG_WGSL, OIT_TEXTURES, DECAL_FRAG_FIELDS, DECAL_FRAG_SIZE, DECAL_MULTIPLY_BLEND, DECAL_PROJECT_FRAG_WGSL, DECAL_TEXTURES, DECAL_UNIFORMS, PREMULTIPLIED_OVER_BLEND, FRAME_REFLECTION_BLEND, REFLECTION_OVER_BLEND, SSR_FRAG_FIELDS, SSR_FRAG_SIZE, SSR_MATERIAL_FIELDS, SSR_MATERIAL_RESOLVE_FRAG_WGSL, SSR_MATERIAL_SIZE, SSR_MATERIAL_TEXTURES, SSR_MATERIAL_UNIFORMS, SSR_RESOLVE_FRAG_WGSL, SSR_RESOLVE_TEXTURES, SSR_TEXTURES, SSR_TRACE_FRAG_WGSL, SSR_UNIFORMS, createOitResolveLayout, createSsrResolveLayout, } from './postPass.js';
 import { GRADE_PLACEHOLDER_SIZE, identityGradeLut, validateGradeLut, } from '../../colourGrade.js';
 import { FILM_LOOK_WITHOUT_COMPOSITE, clampGrain, clampVignette, grainSeed, } from '../../shaders/filmLook.js';
@@ -102,9 +104,9 @@ import { buildPlumeGeometry } from '../../plumeGeometry.js';
 import { facingCode } from '../../particleBatch.js';
 import { PARTICLE_INDICES } from '../../shaders/particle.js';
 import { createScatterDeform, resolveScatterDeform, } from '../../scatterDeform.js';
-import { resolvePointLights } from '../../lightBudget.js';
+import { createResolvedPointLights, resolvePointLights, } from '../../lightBudget.js';
 import { resolveRenderQuality } from '../../renderQuality.js';
-import { DEFAULT_GLOBAL_MEDIUM, mediumActive, mediumTargetSize, WEAK_GPU_MEDIUM_STEPS, resolveGlobalMedium, } from '../../globalMedium.js';
+import { DEFAULT_GLOBAL_MEDIUM, WEAK_GPU_MEDIUM_STEPS, createResolvedMediumLamps, mediumActive, mediumTargetSize, resolveGlobalMedium, resolveGlobalMediumSettings, resolveMediumLamps, } from '../../globalMedium.js';
 import { castsDepth, glassOf } from '../../shadowCasters.js';
 import { materialHasMaps, noteMapsWithoutUvs } from '../../mapsWithoutUvs.js';
 import { VIEW_MODEL_DEPTH_SHARE, viewModelDepthRange } from '../../viewModel.js';
@@ -1532,7 +1534,10 @@ export class WebGPURenderer {
     /** The inverse projection the composite linearises a depth with, built once per frame. */
     mediumInvProjection = mat4.create();
     /** This frame's medium. Off until a caller says otherwise. See `setGlobalMedium`. */
-    mediumOptions = DEFAULT_GLOBAL_MEDIUM;
+    mediumOptions = resolveGlobalMedium(DEFAULT_GLOBAL_MEDIUM);
+    /** The lamps the medium is lit by, and the lit stage's lamps they come from, refilled a frame. */
+    mediumLamps = createResolvedMediumLamps();
+    mediumLights = createResolvedPointLights();
     /**
      * The temporal resolve: its block, its ping-pong pair, and the jitter state.
      *
@@ -2194,16 +2199,7 @@ export class WebGPURenderer {
         f[atF('uFilmRoughness')] = Math.min(1, Math.max(0, options.roughness ?? 0));
         f[atF('uFilmRoughnessCycles')] = Math.max(0.01, options.roughnessCyclesPerMetre ?? 60);
         const medium = resolveAtmosphere(env, this.atmosphereHeight(camera), this.quality.underwaterAtmosphere, this.medium);
-        f.set(medium.fogColor, atF('uFogColor'));
-        f[atF('uFogDensity')] = medium.fogDensity;
-        f[atF('uFogHeightFalloff')] = medium.fogHeightFalloff;
-        f[atF('uFogEyeY')] = medium.fogEyeY;
-        f.set(medium.underwaterColor, atF('uUnderwaterColor'));
-        f[atF('uUnderwaterFogDensity')] = medium.underwaterFogDensity;
-        f[atF('uUnderwaterFactor')] = medium.underwaterFactor;
-        i[atF('uFogMode')] = medium.fogMode;
-        f[atF('uFogNear')] = medium.fogNear;
-        f[atF('uFogFar')] = medium.fogFar;
+        writeMediumFields(FILM_FRAG_FIELDS, f, medium);
         this.filmFrags.writeBlock(fragmentSlot, this.filmFragInts);
         const filmPipe = filmPipeline(this.blendedPipelines(), this.surface.device, this.filmLayout, `film|${geometry.key ?? ''}`, this.presentOf(geometry));
         /* The mirror is an attachment right now, so the group that does not hold it. */
@@ -2931,6 +2927,15 @@ export class WebGPURenderer {
         this.passEnvironmentGain = Math.max(0, gain);
         this.writeEnvironmentDials();
     }
+    /** The environment brought to the light where a surface stands. See `renderer.ts`. */
+    setEnvironmentMixing(weight, roughnessLow = 0.1, roughnessHigh = 0.3) {
+        resolveEnvironmentMixing(weight, roughnessLow, roughnessHigh, this.environmentMixing);
+        this.material((f) => {
+            f.set(this.environmentMixing, this.materialField('uEnvironmentMixing'));
+        });
+    }
+    /** `uEnvironmentMixing` as it stands; none until a draw asks. See `setEnvironmentMixing`. */
+    environmentMixing = noEnvironmentMixing(new Float32Array(4));
     /**
      * The reflectivity and environment gain the setters gave the pass, and the ones the material
      * set now states, or null where it states none (`SurfaceMaterial.reflectivity`). A draw wears the
@@ -3716,16 +3721,7 @@ export class WebGPURenderer {
             scatterInto(f, fields['uLightWeight'], lights.weights, 1);
         }
         const medium = resolveAtmosphere(env, camera.position[1] ?? 0, this.quality.underwaterAtmosphere, this.medium);
-        f.set(medium.fogColor, atF('uFogColor'));
-        f[atF('uFogDensity')] = medium.fogDensity;
-        f[atF('uFogHeightFalloff')] = medium.fogHeightFalloff;
-        f[atF('uFogEyeY')] = medium.fogEyeY;
-        f.set(medium.underwaterColor, atF('uUnderwaterColor'));
-        f[atF('uUnderwaterFogDensity')] = medium.underwaterFogDensity;
-        f[atF('uUnderwaterFactor')] = medium.underwaterFactor;
-        i[atF('uFogMode')] = medium.fogMode;
-        f[atF('uFogNear')] = medium.fogNear;
-        f[atF('uFogFar')] = medium.fogFar;
+        writeMediumFields(fields, f, medium);
         /* Only the mote fragment declares this — spark and smoke stay unconditionally fogged and
            have no such field. See ParticleBatchOptions.fog. */
         if (has('uFogEnabled'))
@@ -3929,16 +3925,7 @@ export class WebGPURenderer {
         frags.writeInt(fragmentSlot, atF('uClipEnabled'), this.reflectionPassActive ? 1 : 0);
         frags.writeFloats(fragmentSlot, atF('uClipPlane'), this.reflection?.clipPlane ?? NO_CLIP_PLANE);
         const medium = resolveAtmosphere(env, this.atmosphereHeight(camera), this.quality.underwaterAtmosphere, this.medium);
-        frags.writeFloats(fragmentSlot, atF('uFogColor'), medium.fogColor);
-        frags.writeFloat(fragmentSlot, atF('uFogDensity'), medium.fogDensity);
-        frags.writeFloat(fragmentSlot, atF('uFogHeightFalloff'), medium.fogHeightFalloff);
-        frags.writeFloat(fragmentSlot, atF('uFogEyeY'), medium.fogEyeY);
-        frags.writeFloats(fragmentSlot, atF('uUnderwaterColor'), medium.underwaterColor);
-        frags.writeFloat(fragmentSlot, atF('uUnderwaterFogDensity'), medium.underwaterFogDensity);
-        frags.writeFloat(fragmentSlot, atF('uUnderwaterFactor'), medium.underwaterFactor);
-        frags.writeInt(fragmentSlot, atF('uFogMode'), medium.fogMode);
-        frags.writeFloat(fragmentSlot, atF('uFogNear'), medium.fogNear);
-        frags.writeFloat(fragmentSlot, atF('uFogFar'), medium.fogFar);
+        writeMediumSlot(frags, fragmentSlot, PLUME_FRAG_FIELDS, medium);
         frags.writeInt(fragmentSlot, atF('uOutputTransform'), this.passGrade());
         frags.writeFloat(fragmentSlot, atF('uOutputExposure'), this.passGradeExposure());
         /*
@@ -4079,16 +4066,7 @@ export class WebGPURenderer {
         scatterInto(f, WATER_FRAG_FIELDS['uLightWeight'], lights.weights, 1);
         scatterInto(f, WATER_FRAG_FIELDS['uLightCone'], lights.conesAndFalloffs, 4);
         const medium = resolveAtmosphere(env, camera.position[1] ?? 0, this.quality.underwaterAtmosphere, this.medium);
-        f.set(medium.fogColor, atF('uFogColor'));
-        f[atF('uFogDensity')] = medium.fogDensity;
-        f[atF('uFogHeightFalloff')] = medium.fogHeightFalloff;
-        f[atF('uFogEyeY')] = medium.fogEyeY;
-        f.set(medium.underwaterColor, atF('uUnderwaterColor'));
-        f[atF('uUnderwaterFogDensity')] = medium.underwaterFogDensity;
-        f[atF('uUnderwaterFactor')] = medium.underwaterFactor;
-        i[atF('uFogMode')] = medium.fogMode;
-        f[atF('uFogNear')] = medium.fogNear;
-        f[atF('uFogFar')] = medium.fogFar;
+        writeMediumFields(WATER_FRAG_FIELDS, f, medium);
         /* No reflection pass yet: the shader's own "off" path, not an improvised one. */
         i[atF('uReflectionEnabled')] = mirror === null ? 0 : 1;
         i[atF('uReflectionFilterTaps')] = water.reflectionFilterTaps;
@@ -4587,16 +4565,7 @@ export class WebGPURenderer {
         f.set(camera.position, atF('uCameraPos'));
         /* The medium, through the same resolver every other pass here binds from. */
         const medium = resolveAtmosphere(env, camera.position[1] ?? 0, this.quality.underwaterAtmosphere, this.medium);
-        f.set(medium.fogColor, atF('uFogColor'));
-        f[atF('uFogDensity')] = medium.fogDensity;
-        f[atF('uFogHeightFalloff')] = medium.fogHeightFalloff;
-        f[atF('uFogEyeY')] = medium.fogEyeY;
-        f.set(medium.underwaterColor, atF('uUnderwaterColor'));
-        f[atF('uUnderwaterFogDensity')] = medium.underwaterFogDensity;
-        f[atF('uUnderwaterFactor')] = medium.underwaterFactor;
-        i[atF('uFogMode')] = medium.fogMode;
-        f[atF('uFogNear')] = medium.fogNear;
-        f[atF('uFogFar')] = medium.fogFar;
+        writeMediumFields(BOLT_FRAG_FIELDS, f, medium);
         this.boltVerts.writeBlock(vertexSlot, this.boltVertBlock);
         this.boltFrags.writeBlock(fragmentSlot, this.boltFragInts);
         const boltPipe = boltPipeline(this.blendedPipelines(), this.surface.device, this.boltLayout);
@@ -4699,16 +4668,7 @@ export class WebGPURenderer {
         this.lineFrags.writeFloat(fragmentSlot, atF('uOutputExposure'), this.passGradeExposure());
         /* The medium, through the same resolver every other pass here binds from. */
         const medium = resolveAtmosphere(env, camera.position[1] ?? 0, this.quality.underwaterAtmosphere, this.medium);
-        this.lineFrags.writeFloats(fragmentSlot, atF('uFogColor'), medium.fogColor);
-        this.lineFrags.writeFloat(fragmentSlot, atF('uFogDensity'), medium.fogDensity);
-        this.lineFrags.writeFloat(fragmentSlot, atF('uFogHeightFalloff'), medium.fogHeightFalloff);
-        this.lineFrags.writeFloat(fragmentSlot, atF('uFogEyeY'), medium.fogEyeY);
-        this.lineFrags.writeFloats(fragmentSlot, atF('uUnderwaterColor'), medium.underwaterColor);
-        this.lineFrags.writeFloat(fragmentSlot, atF('uUnderwaterFogDensity'), medium.underwaterFogDensity);
-        this.lineFrags.writeFloat(fragmentSlot, atF('uUnderwaterFactor'), medium.underwaterFactor);
-        this.lineFrags.writeInt(fragmentSlot, atF('uFogMode'), medium.fogMode);
-        this.lineFrags.writeFloat(fragmentSlot, atF('uFogNear'), medium.fogNear);
-        this.lineFrags.writeFloat(fragmentSlot, atF('uFogFar'), medium.fogFar);
+        writeMediumSlot(this.lineFrags, fragmentSlot, LINE_FRAG_FIELDS, medium);
         const linePipe = linePipeline(this.blendedPipelines(), this.surface.device, this.lineLayout, additive);
         /* Two uniform blocks and three vertex buffers, and no attachment among them. */
         const lineCommand = this.recordBlended(0);
@@ -4855,39 +4815,11 @@ export class WebGPURenderer {
         this.shadowDraws.writeFloats(slot, DEPTH_VERT_FIELDS.uWindSpatialPhase.offset, d.spatialPhase);
     }
     /** Refilled per frame rather than allocated; see `resolvePointLights`. */
-    lights = {
-        count: 0,
-        falloff: 0,
-        positions: new Float32Array(0),
-        colors: new Float32Array(0),
-        radii: new Float32Array(0),
-        sourceRadii: new Float32Array(0),
-        weights: new Float32Array(0),
-        directions: new Float32Array(0),
-        coneCos: new Float32Array(0),
-        iesProfiles: new Float32Array(0),
-        iesAxes: new Float32Array(0),
-        cookies: new Float32Array(0),
-        heldSourceRadii: new Float32Array(MAX_POINT_LIGHTS),
-        axesAndChannels: new Float32Array(MAX_POINT_LIGHTS * 4),
-        conesAndFalloffs: new Float32Array(MAX_POINT_LIGHTS * 4),
-        heldWeights: new Float32Array(MAX_POINT_LIGHTS),
-    };
+    lights = createResolvedPointLights();
     /** The fixed arm's rectangles as `uAreaLightSize` holds them. See `packAreaSizesAndDoors`. */
     areaSizesAndDoors = new Float32Array(MAX_AREA_LIGHTS * 4);
     /** Refilled per frame rather than allocated; see `resolveAtmosphere`. */
-    medium = {
-        fogColor: new Float32Array(3),
-        underwaterColor: new Float32Array(3),
-        fogDensity: 0,
-        fogHeightFalloff: 0,
-        fogEyeY: 0,
-        fogMode: 0,
-        fogNear: 0,
-        fogFar: 1,
-        underwaterFogDensity: 0,
-        underwaterFactor: 0,
-    };
+    medium = createResolvedAtmosphere();
     /* -- Overlays: panels and text ------------------------------------------------------ */
     panelLayout;
     panelCorners;
@@ -6313,6 +6245,7 @@ export class WebGPURenderer {
         this.mediumLayout = createPostStageLayout(device, MEDIUM_UNIFORMS, MEDIUM_FRAG_SIZE, [
             { binding: MEDIUM_TEXTURES.uDepth, filterable: false },
             { binding: MEDIUM_TEXTURES.uSunShadows, filterable: false, dimension: '2d-array' },
+            { binding: MEDIUM_TEXTURES.uPointShadows, filterable: false, dimension: '2d-array' },
         ]);
         this.mediumUniforms = device.createBuffer({
             label: 'post.mediumUniforms',
@@ -7365,16 +7298,7 @@ export class WebGPURenderer {
          * Found by a voxel scene that is the first in the tree to use `fogMode: 'linear'` on WebGPU.
          */
         const meshMedium = resolveAtmosphere(env, this.atmosphereHeight(camera), this.quality.underwaterAtmosphere, this.medium);
-        f.set(meshMedium.fogColor, at('uFogColor'));
-        f[at('uFogDensity')] = meshMedium.fogDensity;
-        f[at('uFogHeightFalloff')] = meshMedium.fogHeightFalloff;
-        f[at('uFogEyeY')] = meshMedium.fogEyeY;
-        i[at('uFogMode')] = meshMedium.fogMode;
-        f[at('uFogNear')] = meshMedium.fogNear;
-        f[at('uFogFar')] = meshMedium.fogFar;
-        f.set(meshMedium.underwaterColor, at('uUnderwaterColor'));
-        f[at('uUnderwaterFogDensity')] = meshMedium.underwaterFogDensity;
-        f[at('uUnderwaterFactor')] = meshMedium.underwaterFactor;
+        writeMediumFields(this.fragment.fields, f, meshMedium);
         /*
          * The mirror's half-space, and only while the mirror is being drawn.
          *
@@ -7419,6 +7343,8 @@ export class WebGPURenderer {
         f[at('uWriteMode') + 2] = 0;
         /* 1, not 0: a multiplier's identity is one. See `setEnvironmentGain`. */
         f[at('uEnvironmentDials') + 2] = 1;
+        /* And no mixing, which is stored less one. See `setEnvironmentMixing`. */
+        f.set(noEnvironmentMixing(this.environmentMixing), at('uEnvironmentMixing'));
         /* No overlay until a draw sets one. See `setSurfaceOverlay`. */
         this.overlayFloats.fill(0);
         f.fill(0, at('uOverlay'), at('uOverlay') + OVERLAY_FLOATS);
@@ -7662,16 +7588,7 @@ export class WebGPURenderer {
          * drift `bindAtmosphere` was written to prevent.
          */
         const medium = resolveAtmosphere(env, this.atmosphereHeight(camera), this.quality.underwaterAtmosphere, this.medium);
-        f.set(medium.fogColor, at('uFogColor'));
-        f[at('uFogDensity')] = medium.fogDensity;
-        f[at('uFogHeightFalloff')] = medium.fogHeightFalloff;
-        f[at('uFogEyeY')] = medium.fogEyeY;
-        i[at('uFogMode')] = medium.fogMode;
-        f[at('uFogNear')] = medium.fogNear;
-        f[at('uFogFar')] = medium.fogFar;
-        f.set(medium.underwaterColor, at('uUnderwaterColor'));
-        f[at('uUnderwaterFogDensity')] = medium.underwaterFogDensity;
-        f[at('uUnderwaterFactor')] = medium.underwaterFactor;
+        writeMediumFields(this.fragment.fields, f, medium);
         /*
          * The shadow terms, matching what `renderer.ts` binds at default quality.
          *
@@ -8976,16 +8893,7 @@ export class WebGPURenderer {
         f.set(env.ambient, atF('uAmbient'));
         f.set(camera.position, atF('uCameraPos'));
         const medium = resolveAtmosphere(env, camera.position[1] ?? 0, this.quality.underwaterAtmosphere, this.medium);
-        f.set(medium.fogColor, atF('uFogColor'));
-        f[atF('uFogDensity')] = medium.fogDensity;
-        f[atF('uFogHeightFalloff')] = medium.fogHeightFalloff;
-        f[atF('uFogEyeY')] = medium.fogEyeY;
-        f.set(medium.underwaterColor, atF('uUnderwaterColor'));
-        f[atF('uUnderwaterFogDensity')] = medium.underwaterFogDensity;
-        f[atF('uUnderwaterFactor')] = medium.underwaterFactor;
-        i[atF('uFogMode')] = medium.fogMode;
-        f[atF('uFogNear')] = medium.fogNear;
-        f[atF('uFogFar')] = medium.fogFar;
+        writeMediumFields(SCATTER_FRAG_FIELDS, f, medium);
         i[atF('uOutputTransform')] = this.passGrade();
         f[atF('uOutputExposure')] = this.passGradeExposure();
         const fragmentSlot = this.scatterFrags.allocate();
@@ -9799,6 +9707,8 @@ export class WebGPURenderer {
              * resolve, which is what sampling a stand-in does.
              */
             this.rebuildFlatBindGroup();
+            /* The medium reads the same array: see `buildMediumBindGroup`. */
+            this.mediumBindGroup = this.buildMediumBindGroup();
         }
         this.pointShadows.prepareStaticMaps(lights.length);
         this.preparedPointLightCount = lights.length;
@@ -10041,6 +9951,8 @@ export class WebGPURenderer {
             if (old !== null) {
                 this.retiredPointTexture = old;
                 this.rebuildFlatBindGroup();
+                /* The medium reads the same array: see `buildMediumBindGroup`. */
+                this.mediumBindGroup = this.buildMediumBindGroup();
             }
         }
     }
@@ -10523,7 +10435,7 @@ export class WebGPURenderer {
          * it. The held brightness is kept for either, since local exposure moves regions relative to it.
          * See `setAutoExposure` and `setLocalExposure`.
          */
-        const localising = this.localExposure > 0;
+        const localising = this.localExposure;
         const measuring = (this.autoExposure > 0 || localising) && this.exposurePass !== null;
         const adapting = measuring && this.autoExposure > 0;
         const shownScene = this.reconstructing ? this.reconShownView : this.sceneColorView;
@@ -10596,7 +10508,13 @@ export class WebGPURenderer {
         f[at('uVignette')] = this.vignette;
         f.set(this.fringe, at('uFringe'));
         f[at('uAutoExposure')] = adapting ? this.autoExposure : 0;
-        f[at('uLocalExposure')] = measuring && localising ? this.localExposure : 0;
+        f[at('uLocalExposure')] = measuring && localising ? 1 : 0;
+        const shapeAt = at('uLocalShape');
+        const pivotAt = at('uLocalPivot');
+        for (let k = 0; k < 4; k++) {
+            f[shapeAt + k] = this.localExposureShape[k];
+            f[pivotAt + k] = this.localExposureShape[4 + k];
+        }
         f[at('uGrain')] = this.grain;
         f[at('uGrain') + 1] = this.grainSeed;
         device.queue.writeBuffer(this.rushUniforms, 0, this.rushStaging);
@@ -11810,7 +11728,17 @@ export class WebGPURenderer {
         f.set(env?.directionalColor ?? [0, 0, 0], at('uSunColor'));
         f.set(env?.ambient ?? [0, 0, 0], at('uAmbient'));
         f[at('uDensity')] = options.density;
-        f[at('uAlbedo')] = options.albedo;
+        const height = at('uHeight');
+        f[height] = options.heightFalloff;
+        f[height + 1] = options.baseY;
+        const layer2 = at('uLayer2');
+        f[layer2] = options.density2;
+        f[layer2 + 1] = options.heightFalloff2;
+        f[layer2 + 2] = options.baseY2;
+        f.set(options.albedo, at('uAlbedo'));
+        const scatter = at('uScatter');
+        f[scatter] = options.sunScatter;
+        f[scatter + 1] = options.skyScatter;
         f[at('uAnisotropy')] = options.anisotropy;
         f[at('uMaxDistance')] = options.maxDistance;
         ints[at('uSteps')] = this.quality.globalMediumSteps;
@@ -11828,6 +11756,20 @@ export class WebGPURenderer {
         f.set(env?.lightViewProj ?? this.mediumIdentity, at('uLightViewProj'));
         f.set((env === null ? this.mediumIdentity : this.movingLightFor(env)), at('uMovingLightViewProj'));
         ints[at('uPeeledShadowEnabled')] = this.peelView === null || !this.peelFilled ? 0 : 1;
+        /* The lit stage's lamps and the shadows it resolved for them, this frame's. */
+        const lamps = resolveMediumLamps(options, resolvePointLights(env, this.quality.pointLightFalloff, this.mediumLights), this.pointShadows === null ? null : this.resolvedPointShadows, env?.lightMediumScatter, this.mediumLamps);
+        ints[at('uLampCount')] = lamps.count;
+        ints[at('uLampFalloff')] = lamps.falloff;
+        if (lamps.count > 0) {
+            f.set(lamps.position, at('uLampPosition'));
+            f.set(lamps.color, at('uLampColor'));
+            f.set(lamps.aim, at('uLampAim'));
+            f.set(lamps.cone, at('uLampCone'));
+            f.set(lamps.shadow, at('uLampShadow'));
+            f.set(lamps.shadowAt, at('uLampShadowAt'));
+            f.set(lamps.live, at('uLampLive'));
+            f.set(lamps.liveAt, at('uLampLiveAt'));
+        }
         device.queue.writeBuffer(this.mediumUniforms, 0, this.mediumStaging);
         const g = this.mediumUpsampleFloats;
         const upsampleAt = (name) => this.postField(MEDIUM_UPSAMPLE_FIELDS, name);
@@ -14236,8 +14178,9 @@ export class WebGPURenderer {
     /** Eye adaptation: how far, this frame's time step, and the pass once asked for. */
     autoExposure = 0;
     autoExposureDt = 0;
-    /** How far each region is brought toward the frame. See `setLocalExposure`. */
-    localExposure = 0;
+    /** Whether regions move, and how, as `resolveLocalExposure` packs it. See `setLocalExposure`. */
+    localExposure = false;
+    localExposureShape = new Float32Array(LOCAL_EXPOSURE_FLOATS);
     exposurePass = null;
     /**
      * How strongly the lens darkens the frame's corners, held until changed: 0 is none, 0.5 is about
@@ -14387,12 +14330,7 @@ export class WebGPURenderer {
      * draws nothing, and the three optional arguments are held until changed.
      */
     setGlobalMedium(density, albedo, anisotropy, maxDistance) {
-        this.mediumOptions = resolveGlobalMedium({
-            density: Number.isFinite(density) ? density : 0,
-            albedo,
-            anisotropy,
-            maxDistance,
-        });
+        this.mediumOptions = resolveGlobalMediumSettings(density, albedo, anisotropy, maxDistance);
     }
     /** How much speed blur the frame should resolve with, 0 to 1. */
     setSpeedRush(strength) {
@@ -14463,13 +14401,13 @@ export class WebGPURenderer {
      * the same setter over the same state, sharing eye adaptation's pass, which is built the first
      * time either is asked for.
      */
-    setLocalExposure(strength) {
+    setLocalExposure(setting) {
         if (!this.hasComposite || !this.quality.hdrScene) {
-            this.warnLookWithoutComposite(strength);
+            this.warnLookWithoutComposite(typeof setting === 'number' ? setting : 1);
             return;
         }
-        this.localExposure = clampLocalExposure(strength);
-        if (this.localExposure > 0)
+        this.localExposure = resolveLocalExposure(setting, this.localExposureShape);
+        if (this.localExposure)
             this.ensureExposurePass();
     }
     /** The exposure pass, built once; the composite's group holds placeholders until it exists. */
@@ -14606,16 +14544,7 @@ export class WebGPURenderer {
         f[atF('uWindDir') + 1] = inv === 0 ? 0 : windZ * inv;
         f[atF('uWaveGain')] = sea.steepness;
         const medium = resolveAtmosphere(env, this.atmosphereHeight(camera), this.quality.underwaterAtmosphere, this.medium);
-        f.set(medium.fogColor, atF('uFogColor'));
-        f[atF('uFogDensity')] = medium.fogDensity;
-        f[atF('uFogHeightFalloff')] = medium.fogHeightFalloff;
-        f[atF('uFogEyeY')] = medium.fogEyeY;
-        f.set(medium.underwaterColor, atF('uUnderwaterColor'));
-        f[atF('uUnderwaterFogDensity')] = medium.underwaterFogDensity;
-        f[atF('uUnderwaterFactor')] = medium.underwaterFactor;
-        i[atF('uFogMode')] = medium.fogMode;
-        f[atF('uFogNear')] = medium.fogNear;
-        f[atF('uFogFar')] = medium.fogFar;
+        writeMediumFields(CAUSTICS_FRAG_FIELDS, f, medium);
         this.causticsVerts.writeBlock(vertexSlot, this.causticsVertBlock);
         this.causticsFrags.writeBlock(fragmentSlot, this.causticsFragInts);
         const causticsPipe = causticsPipeline(this.blendedPipelines(), this.surface.device, this.causticsLayout);
@@ -15556,6 +15485,13 @@ export class WebGPURenderer {
                 { binding: MEDIUM_TEXTURES.uDepth.sampler, resource: this.postDepthSampler },
                 { binding: MEDIUM_TEXTURES.uSunShadows.texture, resource: this.sunArrayView },
                 { binding: MEDIUM_TEXTURES.uSunShadows.sampler, resource: this.volumeShadowSampler },
+                /* The lamps' maps, the lit stage's own array, rebuilt here whenever that array is
+                   replaced; the white stand-in reads as nothing in the way, and no lamp reads it. */
+                {
+                    binding: MEDIUM_TEXTURES.uPointShadows.texture,
+                    resource: this.pointShadowArray?.view ?? this.shadowBlankView,
+                },
+                { binding: MEDIUM_TEXTURES.uPointShadows.sampler, resource: this.volumeShadowSampler },
             ],
         });
     }

package/dist/render/backend/webgpu/scatterPass.d.ts

@@ -21,7 +21,7 @@ export declare const SCATTER_DEPTH_SIZE: 240;
 export declare const SCATTER_VERT_FIELDS: UniformFields;
 export declare const SCATTER_VERT_SIZE: 240;
 export declare const SCATTER_FRAG_FIELDS: UniformFields;
-export declare const SCATTER_FRAG_SIZE: 144;
+export declare const SCATTER_FRAG_SIZE: 192;
 export declare function scatterVertexLayouts(): GPUVertexBufferLayout[];
 /** Geometry and placement on the device, behind the opaque handle the surface hands out. */
 export interface GpuScatter {

package/dist/render/backend/webgpu/waterPass.d.ts

@@ -11,7 +11,7 @@ import type { UniformFields } from './scatterPass.ts';
 export declare const WATER_VERT_FIELDS: UniformFields;
 export declare const WATER_VERT_SIZE: 208;
 export declare const WATER_FRAG_FIELDS: UniformFields;
-export declare const WATER_FRAG_SIZE: 1520;
+export declare const WATER_FRAG_SIZE: 1568;
 /** The two meshes and the numbers the grid decided, behind the surface's opaque handle. */
 export interface GpuWater {
     /** The ocean: near sheet and far skirt in one buffer. */