@forgeax/engine-shader 0.1.19 → 0.1.21

package/src/default-standard-pbr.wgsl

@@ -1,24 +1,33 @@
 #define_import_path forgeax_material::standard
-#import forgeax_view::common::{View, FogViewParams, FogRay, Mesh, InstanceData, view, meshes, instances, PointLight, SpotLight, pointLightsBuffer, spotLightsBuffer, shadowMap, shadowSampler, sampleMaterialTexture}
+#import forgeax_view::common::{View, Mesh, InstanceData, view, meshes, instances, sampleMaterialTexture}
+#import forgeax_scene_temporal::{sceneViewZ}
 #import forgeax_pbr::temporal::{projectPbrSceneTemporal}
 #import forgeax_pbr::brdf::{f_schlick, v_smith, d_ggx}
-#import forgeax_pbr::ibl_sampling::{sampleIblDiffuse, sampleIblSpecular}
+#import forgeax_pbr::ibl_sampling::{box_project, sampleIblDiffuse, sampleIblSpecular, sampleReflectionProbeSpecular}
 #import forgeax_pbr::tbn::{decodeTangentSpaceNormalRg, scaleTangentSpaceNormal, applyTBN}
 #import forgeax_pbr::lighting_directional::{evalDirectionalNoShadow, evalDirectionalShadowFactor}
-#import forgeax_pbr::lighting_punctual::{evalPoint, evalSpot, evalSpotShadowed}
-#import forgeax_view::fog::{apply_fog}
-#ifdef POINT_SHADOW_AVAILABLE
-#import forgeax_pbr::lighting_punctual::{evalPointShadowed}
-#import forgeax_view::common::{shadowParams}
-#endif
 #ifdef CLUSTER_FORWARD_AVAILABLE
-#import forgeax_hdrp::cluster_forward::{evaluate_cluster_lights, get_ssao_intensity}
+#import forgeax_standard::cluster::{evaluateStandardClusterLights, get_ssao_intensity}
 #endif
 
 #pragma variant_axis STORAGE_BUFFER_AVAILABLE
 #pragma variant_axis CLUSTER_FORWARD_AVAILABLE
 #pragma variant_axis VERTEX_COLOR_AVAILABLE
 #pragma variant_axis TRANSMISSION_AVAILABLE
+#pragma variant_axis DIRECTIONAL_PCSS_AVAILABLE
+#pragma variant_axis PROJECTOR_AVAILABLE
+
+// Reflection probes remain a bounded scene-projected sampling lane. Their
+// optional texture resources are the same Skylight inputs; when no probe is
+// admitted, the explicit Skylight path below remains authoritative.
+fn reflection_probe_sampling_contract(
+  worldPosition: vec3<f32>,
+  direction: vec3<f32>,
+  boxCenter: vec3<f32>,
+  boxExtents: vec3<f32>,
+) -> vec3<f32> {
+  return box_project(worldPosition, direction, boxCenter, boxExtents);
+}
 
 // @forgeax/engine-shader - default-standard-pbr.wgsl
 // (feat-20260523-shader-template-instance-split M5 / T04).
@@ -253,7 +262,11 @@ struct VsOut {
   @location(1) worldNormal : vec3<f32>,
   @location(2) uv : vec2<f32>,
   @location(3) worldTangent : vec4<f32>,
-  @location(4) @interpolate(flat) instanceIdx : u32,
+#ifdef TRANSMISSION_AVAILABLE
+  // Keep mesh and instance storage vertex-only; transmission receives the
+  // transform basis from the vertex stage below.
+  @location(4) @interpolate(flat) transmissionBasis0 : vec4<f32>,
+#endif
   // feat-city-glb multi-UV tiling: second UV set inter-stage varying. Uses the
   // previously-vacant @location(5) so @location(6)/(7) stay byte-stable with
   // the prior layout (CSM M5/w19).
@@ -267,7 +280,7 @@ struct VsOut {
 #ifdef VERTEX_COLOR_AVAILABLE
   @location(14) color : vec4<f32>,
 #endif
-  @location(6) ndc : vec3<f32>,  // NDC for HDRP cluster lookup (w10)
+  @location(6) ndc : vec4<f32>,  // NDC for HDRP cluster lookup; .w = transmission basis tail
   // feat-20260609-hdrp-cluster-fragment-ggx M4.5-followup: view-space z is
   // needed by ndc_position_to_cluster (slice index uses log-z mapping that
   // takes negative view_z, NOT NDC z which is [0,1]). Earlier `in.ndc.z`
@@ -276,6 +289,9 @@ struct VsOut {
   // hot zone -- received zero light. Forward view_z explicitly. M5 / w19:
   // also feeds CSM cascade selection in evalDirectional.
   @location(7) viewZ : f32,
+#ifdef TRANSMISSION_AVAILABLE
+  @location(15) @interpolate(flat) transmissionBasis1 : vec4<f32>,
+#endif
 };
 
 fn pick_channel(rgba : vec4<f32>, channelIndex : u32) -> f32 {
@@ -289,25 +305,6 @@ fn pick_channel(rgba : vec4<f32>, channelIndex : u32) -> f32 {
   }
 }
 
-fn applySceneFog(viewParams : View, color : vec3<f32>, alpha : f32, worldPos : vec3<f32>) -> vec4<f32> {
-  var origin = viewParams.cameraPos;
-  var direction = normalize(worldPos - origin);
-  var rayDistance = length(worldPos - origin);
-  if (viewParams.temporalProjection.z >= 0.5) {
-    let nearH = viewParams.inverseViewProj * vec4<f32>(0.0, 0.0, 0.0, 1.0);
-  let farH = viewParams.inverseViewProj * vec4<f32>(0.0, 0.0, 1.0, 1.0);
-  let nearPoint = nearH.xyz / nearH.w;
-  let farPoint = farH.xyz / farH.w;
-  direction = normalize(farPoint - nearPoint);
-    // Orthographic rays are parallel, but their origins differ per fragment.
-    // Project the current fragment onto the camera plane instead of reusing
-    // the center NDC ray origin for every pixel.
-    origin = worldPos - direction * dot(worldPos - viewParams.cameraPos, direction);
-    rayDistance = max(dot(worldPos - origin, direction), 0.0);
-  }
-  return apply_fog(viewParams.fog, FogRay(origin, direction, rayDistance), vec4<f32>(color, alpha));
-}
-
 // Light evaluators live in forgeax_pbr::lighting_directional +
 // forgeax_pbr::lighting_punctual (M5 / T02). evalDirectional consumes the
 // host's view UBO + shadowMap (LO 3.1.3 slope-scaled-bias 3x3 PCF;
@@ -356,6 +353,20 @@ fn vs_main(in : VsIn, @builtin(instance_index) idx : u32) -> VsOut {
   // (w=0); .w handedness preserved for bitangent reconstruction in fragment.
   let worldTangentXyz = normalize((entityWorld * instanceLocal * vec4<f32>(in.tangent.xyz, 0.0)).xyz);
   out.worldTangent = vec4<f32>(worldTangentXyz, in.tangent.w);
+#ifdef TRANSMISSION_AVAILABLE
+  out.transmissionBasis0 = vec4<f32>(
+    localToWorld[0].x,
+    localToWorld[0].y,
+    localToWorld[0].z,
+    localToWorld[1].x,
+  );
+  out.transmissionBasis1 = vec4<f32>(
+    localToWorld[1].y,
+    localToWorld[1].z,
+    localToWorld[2].x,
+    localToWorld[2].y,
+  );
+#endif
   out.uv = in.uv;
   out.uv1 = in.uv1;
   out.uv2 = in.uv2;
@@ -367,7 +378,6 @@ fn vs_main(in : VsIn, @builtin(instance_index) idx : u32) -> VsOut {
 #ifdef VERTEX_COLOR_AVAILABLE
   out.color = in.color;
 #endif
-  out.instanceIdx = idx;
   // feat-20260613-csm-cascaded-shadow-maps M5 / w19: the per-fragment
   // light-space position varying is gone; evalDirectional computes
   // per-cascade lightViewProj * worldPos in the fragment stage from
@@ -375,12 +385,14 @@ fn vs_main(in : VsIn, @builtin(instance_index) idx : u32) -> VsOut {
   // NDC for HDRP cluster lookup (feat-20260609-hdrp-cluster-fragment-ggx M2 / w10).
   // Perspective divide on clip-space position; ndc.z retains depth-buffer value.
   let clipPos = out.clip;
-  out.ndc = vec3(clipPos.xy / clipPos.w, clipPos.z / clipPos.w);
+  out.ndc = vec4(clipPos.xy / clipPos.w, clipPos.z / clipPos.w, localToWorld[2].z);
   // Standard WebGPU/GL perspective projection has clip.w = -view.z, so
   // view_z = -clip.w (negative in front of the camera). M4.5-followup:
   // ndc_position_to_cluster needs this for log-z slice mapping; passing
   // ndc.z (in [0,1]) instead made every fragment land in slice 0.
-  out.viewZ = -clipPos.w;
+  // Keep the cluster depth exactly aligned with the CPU binner for both
+  // perspective and off-axis orthographic projections.
+  out.viewZ = sceneViewZ(clipPos, view.temporalProjection);
   return out;
 }
 
@@ -585,12 +597,26 @@ fn fs_main(in : VsOut) -> @location(0) vec4<f32> {
   // shadow-map PCF lookup (CSM, feat-20260613).
   let kD = (vec3<f32>(1.0) - f_schlick(max(dot(n, v), 0.0), f0)) * (1.0 - metallic);
   let iblRoughness = clamp(max(finiteScalar(material.roughness, 0.5), 0.04) * roughnessTex, 0.04, 1.0);
-  let irradiance = sampleIblDiffuse(n, skylight.rotation, irradianceMap, irradianceSampler);
-  let specularIbl = sampleIblSpecular(
-    n, v, iblRoughness, f0,
-    skylight.rotation,
-    prefilterMap, prefilterSampler, brdfLut, brdfLutSampler,
-  );
+  var irradiance = vec3<f32>(0.0);
+  var specularIbl = vec3<f32>(0.0);
+  if (skylight.intensity < 0.0) {
+    // A negative intensity is the renderer-owned probe sentinel. The four
+    // color/rotation lanes carry probe center and half extents in this mode;
+    // Skylight resources remain unchanged and therefore preserve the ABI.
+    specularIbl = sampleReflectionProbeSpecular(
+      n, v, iblRoughness, f0, in.worldPos,
+      vec3<f32>(skylight.colorR, skylight.colorG, skylight.colorB),
+      skylight.rotation.xyz, vec4<f32>(0.0, 0.0, 0.0, 1.0),
+      prefilterMap, prefilterSampler, brdfLut, brdfLutSampler,
+    );
+  } else {
+    irradiance = sampleIblDiffuse(n, skylight.rotation, irradianceMap, irradianceSampler);
+    specularIbl = sampleIblSpecular(
+      n, v, iblRoughness, f0,
+      skylight.rotation,
+      prefilterMap, prefilterSampler, brdfLut, brdfLutSampler,
+    );
+  }
   let occlusionUv = transformedMaterialUv(material.occlusionTextureCoordinatesTransform, material.occlusionTextureCoordinatesMetadata, in);
   let aoSample = sampleMaterialTexture(occlusionTexture, occlusionSampler, occlusionUv, material.occlusionTextureCoordinatesMetadata.zw);
   let ao = mix(1.0, aoSample.r, material.occlusionStrength);
@@ -607,7 +633,11 @@ fn fs_main(in : VsOut) -> @location(0) vec4<f32> {
     );
     ambient = ambient + clearcoatIbl * material.clearcoat;
   }
-  ambient = ambient * skyColor * skylight.intensity * ao;
+  if (skylight.intensity < 0.0) {
+    ambient = ambient * (-skylight.intensity) * ao;
+  } else {
+    ambient = ambient * skyColor * skylight.intensity * ao;
+  }
 #ifdef CLUSTER_FORWARD_AVAILABLE
   // feat-20260612-hdrp-ssao M2 round-1 + M7 round-2 (plan-strategy D-7 + D-B + D-C):
   // SSAO ambient synthesis. Reads the half-res R8 `ssaoBlurredTexture` from
@@ -634,10 +664,17 @@ fn fs_main(in : VsOut) -> @location(0) vec4<f32> {
   // the fragment stage preserves that contract and keeps thickness in the
   // glTF unit-scale mesh space before measuring the refracted segment in world
   // metres.
-  let localToWorld = meshes[0].worldFromLocal * instances[in.instanceIdx].localFromInstance;
-  let localToWorld0 = localToWorld[0].xyz;
-  let localToWorld1 = localToWorld[1].xyz;
-  let localToWorld2 = localToWorld[2].xyz;
+  let localToWorld0 = in.transmissionBasis0.xyz;
+  let localToWorld1 = vec3<f32>(
+    in.transmissionBasis0.w,
+    in.transmissionBasis1.x,
+    in.transmissionBasis1.y,
+  );
+  let localToWorld2 = vec3<f32>(
+    in.transmissionBasis1.z,
+    in.transmissionBasis1.w,
+    in.ndc.w,
+  );
   let inverseCofactor0 = cross(localToWorld1, localToWorld2);
   let inverseCofactor1 = cross(localToWorld2, localToWorld0);
   let inverseCofactor2 = cross(localToWorld0, localToWorld1);
@@ -721,110 +758,19 @@ fn fs_main(in : VsOut) -> @location(0) vec4<f32> {
 #ifdef CLUSTER_FORWARD_AVAILABLE
   // NDC from vertex shader (perspective-divided clip-space, interpolated).
   // view_z: NDC depth for cluster Z-slice lookup.
-  color = color + evaluate_cluster_lights(in.ndc, in.viewZ, in.worldPos, n, v, diffuseAlbedo, metallic, a, f0);
+  color = color + evaluateStandardClusterLights(
+    in.ndc.xyz, in.viewZ, in.worldPos, n, v, diffuseAlbedo, metallic, a, f0, false,
+  );
   if (material.clearcoat != 0.0) {
-    color = color + material.clearcoat * evaluate_cluster_lights(
-      in.ndc, in.viewZ, in.worldPos, n, v, vec3<f32>(0.0), 1.0, coatAlpha, vec3<f32>(0.04),
-    );
-  }
-#else
-  let pointCount = pointLightsBuffer.count;
-  for (var i: u32 = 0u; i < pointCount; i = i + 1u) {
-    let p = pointLightsBuffer.slots[i];
-#ifdef POINT_SHADOW_AVAILABLE
-    // feat-20260612-point-light-shadows-urp-hdrp Round-2 F-1: gate between
-    // shadowed and unshadowed evaluation on the host-assigned
-    // shadowAtlasLayer (>= 0 means PointLightShadow companion exists; -1
-    // sentinel means no shadow). shadowParams[layer] = (near, far,
-    // 1/(far-near), 0) is bound at @group(0) @binding(6) (shadowParams
-    // declared in common.wgsl).
-    if (p.shadowAtlasLayer >= 0) {
-      let lane = shadowParams[p.shadowAtlasLayer];
-      color = color + evalPointShadowed(
-        p.position, p.colorTimesIntensity, p.invRangeSquared,
-        in.worldPos, n, v, diffuseAlbedo, metallic, a, f0,
-        p.shadowAtlasLayer, lane.x, lane.y, 0.005, 0.05,
-      );
-      if (material.clearcoat != 0.0) {
-        color = color + material.clearcoat * evalPointShadowed(
-          p.position, p.colorTimesIntensity, p.invRangeSquared,
-          in.worldPos, n, v, vec3<f32>(0.0), 1.0, coatAlpha, vec3<f32>(0.04),
-          p.shadowAtlasLayer, lane.x, lane.y, 0.005, 0.05,
-        );
-      }
-    } else {
-      color = color + evalPoint(
-        p.position, p.colorTimesIntensity, p.invRangeSquared,
-        in.worldPos, n, v, diffuseAlbedo, metallic, a, f0,
-      );
-      if (material.clearcoat != 0.0) {
-        color = color + material.clearcoat * evalPoint(
-          p.position, p.colorTimesIntensity, p.invRangeSquared,
-          in.worldPos, n, v, vec3<f32>(0.0), 1.0, coatAlpha, vec3<f32>(0.04),
-        );
-      }
-    }
-#else
-    color = color + evalPoint(
-      p.position, p.colorTimesIntensity, p.invRangeSquared,
-      in.worldPos, n, v, diffuseAlbedo, metallic, a, f0,
+    color = color + material.clearcoat * evaluateStandardClusterLights(
+      in.ndc.xyz, in.viewZ, in.worldPos, n, v, vec3<f32>(0.0), 1.0, coatAlpha, vec3<f32>(0.04), false,
     );
-    if (material.clearcoat != 0.0) {
-      color = color + material.clearcoat * evalPoint(
-        p.position, p.colorTimesIntensity, p.invRangeSquared,
-        in.worldPos, n, v, vec3<f32>(0.0), 1.0, coatAlpha, vec3<f32>(0.04),
-      );
-    }
-#endif
-  }
-  let spotCount = spotLightsBuffer.count;
-  for (var i: u32 = 0u; i < spotCount; i = i + 1u) {
-    let s = spotLightsBuffer.slots[i];
-    // feat-20260625-spot-light-shadow-mapping M3 / w15 (plan-strategy D-1
-    // fragment side + D-3 + D-4): gate on the host-assigned shadowAtlasTile
-    // (>= 0 means a spot atlas tile was allocated; -1 sentinel means no
-    // shadow / clipped / direction-degenerate). The shadowed path reads the
-    // per-spot perspective matrix from the View UBO `view.spotLightViewProj`
-    // array (lane N = shadowAtlasTile N; folded from the standalone binding 9
-    // into the View UBO in feat-20260625 w25 for WebGL2 uniform-buffer budget);
-    // the unshadowed path stays on evalSpot. bias hardcoded 0.005 / 0.05 aligns
-    // with the DirectionalLight defaults (D-6); the OOB/NaN gate lives inside
-    // evalSpotShadowed, not here.
-    if (s.shadowAtlasTile >= 0) {
-      color = color + evalSpotShadowed(
-        s.position, s.direction, s.colorTimesIntensity,
-        s.cosInner, s.cosOuter, s.invRangeSquared,
-        in.worldPos, n, v, diffuseAlbedo, metallic, a, f0,
-        view.spotLightViewProj[s.shadowAtlasTile], s.shadowAtlasTile, 0.005, 0.05,
-      );
-      if (material.clearcoat != 0.0) {
-        color = color + material.clearcoat * evalSpotShadowed(
-          s.position, s.direction, s.colorTimesIntensity,
-          s.cosInner, s.cosOuter, s.invRangeSquared,
-          in.worldPos, n, v, vec3<f32>(0.0), 1.0, coatAlpha, vec3<f32>(0.04),
-          view.spotLightViewProj[s.shadowAtlasTile], s.shadowAtlasTile, 0.005, 0.05,
-        );
-      }
-    } else {
-    color = color + evalSpot(
-        s.position, s.direction, s.colorTimesIntensity,
-        s.cosInner, s.cosOuter, s.invRangeSquared,
-        in.worldPos, n, v, diffuseAlbedo, metallic, a, f0,
-    );
-    if (material.clearcoat != 0.0) {
-      color = color + material.clearcoat * evalSpot(
-        s.position, s.direction, s.colorTimesIntensity,
-        s.cosInner, s.cosOuter, s.invRangeSquared,
-        in.worldPos, n, v, vec3<f32>(0.0), 1.0, coatAlpha, vec3<f32>(0.04),
-      );
-    }
-    }
   }
 #endif // CLUSTER_FORWARD_AVAILABLE
   let emissiveUv = transformedMaterialUv(material.emissiveTextureCoordinatesTransform, material.emissiveTextureCoordinatesMetadata, in);
   let emissiveSample = sampleMaterialTexture(emissiveTexture, emissiveSampler, emissiveUv, material.emissiveTextureCoordinatesMetadata.zw).rgb;
   color = color + material.emissive * material.emissiveIntensity * emissiveSample;
-  return applySceneFog(view, color, alpha, in.worldPos);
+  return vec4<f32>(color, alpha);
 }
 
 // ── G-buffer output struct (feat-20260612-hdrp-deferred-shading M2 / w12) ──
@@ -912,6 +858,7 @@ struct TemporalVsOut {
   @location(7) uv7 : vec2<f32>,
   @location(8) @interpolate(perspective) currentClip : vec4<f32>,
   @location(9) @interpolate(perspective) previousClip : vec4<f32>,
+  @location(10) @interpolate(flat) reactive : f32,
 #ifdef VERTEX_COLOR_AVAILABLE
   @location(14) color : vec4<f32>,
 #endif
@@ -930,6 +877,11 @@ fn vs_temporal(in : VsIn, @builtin(instance_index) idx : u32) -> TemporalVsOut {
   out.currentClip = view.temporalCurrentViewProj * currentWorld;
   out.clip = out.currentClip;
   out.previousClip = view.temporalPreviousViewProj * previousWorld;
+#if STORAGE_BUFFER_AVAILABLE == true
+  out.reactive = meshes[0].temporal.x;
+#else
+  out.reactive = 1.0;
+#endif
   out.uv = in.uv;
   out.uv1 = in.uv1;
   out.uv2 = in.uv2;
@@ -954,10 +906,6 @@ fn temporalVertexAlpha(in : TemporalVsOut) -> f32 {
 
 @fragment
 fn fs_temporal(in : TemporalVsOut) -> @location(0) vec4<f32> {
-  var reactive = 0.0;
-#if STORAGE_BUFFER_AVAILABLE == true
-  reactive = meshes[0].temporal.x;
-#endif
   return projectPbrSceneTemporal(
     material.baseColor.a * temporalVertexAlpha(in),
     material.alphaCutoff,
@@ -968,7 +916,7 @@ fn fs_temporal(in : TemporalVsOut) -> @location(0) vec4<f32> {
     in.currentClip,
     in.previousClip,
     view.temporalProjection,
-    reactive,
+    in.reactive,
     in.uv, in.uv1, in.uv2, in.uv3,
     in.uv4, in.uv5, in.uv6, in.uv7,
   );

package/src/fxaa.wgsl

@@ -7,8 +7,8 @@
 // FXAA 3.11 fragment shader -- faithful port of the canonical Simon
 // Rodriguez reference (same lineage as Bevy's WGSL port), adapted to
 // forgeax naga_oil conventions. Hardcoded "High" quality preset: 12-step
-// edge search with compile-time step multipliers (no UBO, no #ifdef quality
-// branches).
+// edge search with compile-time step multipliers (the only UBO field is the
+// final-output dither switch; there are no quality #ifdef branches).
 //
 // Vertex stage: imports the SSOT fullscreen_triangle() from
 // forgeax_view::common (single large triangle, research Finding 1).
@@ -35,10 +35,13 @@
 // Bindings (group 0):
 //   @binding(0) screenTexture : texture_2d<f32>  -- sampled display-encoded input
 //   @binding(1) samp          : sampler           -- linear filterable sampler
+//   @binding(2) params        : FxaaParams        -- final-output policy
 // display-encoded: FXAA samples and writes display-encoded values; the Output
-// Transform owns the sole linear-to-sRGB conversion before this pass.
+// Transform owns the sole linear-to-sRGB conversion before this pass. FXAA is
+// the final Standard surface writer, so the shared bounded dither is applied
+// here, immediately before the surface's UNORM8 conversion.
 
-#import forgeax_view::common::FullscreenOutput
+#import forgeax_view::common::{FullscreenOutput, ditherUnorm8}
 #import forgeax_view::common::fullscreen_triangle
 
 const EDGE_THRESHOLD_MIN: f32 = 0.0312;
@@ -49,6 +52,18 @@ const ITERATIONS: i32 = 12;
 @group(0) @binding(0) var screenTexture: texture_2d<f32>;
 @group(0) @binding(1) var samp: sampler;
 
+struct FxaaParams {
+  ditherEnabled: f32,
+  // Keep the uniform block at one 16-byte slot. WebGL2/GLES uniform-buffer
+  // validation uses the std140-aligned block size, while the host uploads a
+  // four-f32 (16-byte) payload.
+  _pad0: f32,
+  _pad1: f32,
+  _pad2: f32,
+};
+
+@group(0) @binding(2) var<uniform> params: FxaaParams;
+
 fn rgb2luma(rgb: vec3<f32>) -> f32 {
   return sqrt(dot(rgb, vec3<f32>(0.299, 0.587, 0.114)));
 }
@@ -105,7 +120,10 @@ fn fs_main(in: FullscreenOutput) -> @location(0) vec4<f32> {
 
   // Not on an edge (or in a near-uniform region): pass the centre through.
   if lumaRange < max(EDGE_THRESHOLD_MIN, lumaMax * EDGE_THRESHOLD_MAX) {
-    return vec4<f32>(centerColor, 1.0);
+    return vec4<f32>(
+      select(centerColor, ditherUnorm8(centerColor, in.position.xy), params.ditherEnabled > 0.5),
+      1.0,
+    );
   }
 
   // Lumas of the 4 corners.
@@ -254,5 +272,8 @@ fn fs_main(in: FullscreenOutput) -> @location(0) vec4<f32> {
   }
 
   let finalColor = sampleColor(finalUv);
-  return vec4<f32>(finalColor, 1.0);
+  return vec4<f32>(
+    select(finalColor, ditherUnorm8(finalColor, in.position.xy), params.ditherEnabled > 0.5),
+    1.0,
+  );
 }

package/src/hdrp-deferred-lighting.wgsl

@@ -1,13 +1,12 @@
 #define_import_path forgeax_view::hdrp_deferred_lighting
 
 #import forgeax_view::common::FullscreenOutput
-#import forgeax_view::common::{View, FogViewParams, FogRay}
+#import forgeax_view::common::View
 #import forgeax_view::common::fullscreen_triangle
-#import forgeax_view::fog::{apply_fog}
 
 // HDRP deferred lighting producer. The lighting pass consumes the material
 // G-buffer and current-frame depth, reconstructs the fragment world position,
-// then applies the shared analytic Fog exactly once to linear radiance.
+// then writes linear radiance for the shared volume composite pass.
 
 @group(0) @binding(0) var<uniform> view : View;
 
@@ -24,28 +23,6 @@ fn vs_main(@builtin(vertex_index) vertex_index : u32) -> FullscreenOutput {
   return fullscreen_triangle(vertex_index);
 }
 
-fn reconstructWorldPosition(uv : vec2<f32>, depth : f32) -> vec3<f32> {
-  let clip = vec4<f32>(uv * 2.0 - vec2<f32>(1.0), depth, 1.0);
-  let worldH = view.inverseViewProj * clip;
-  return worldH.xyz / worldH.w;
-}
-
-fn fogDeferredRadiance(color : vec4<f32>, worldPos : vec3<f32>) -> vec4<f32> {
-  var origin = view.cameraPos;
-  var direction = normalize(worldPos - origin);
-  var rayDistance = length(worldPos - origin);
-  if (view.temporalProjection.z >= 0.5) {
-    let nearH = view.inverseViewProj * vec4<f32>(0.0, 0.0, 0.0, 1.0);
-    let farH = view.inverseViewProj * vec4<f32>(0.0, 0.0, 1.0, 1.0);
-    let nearPoint = nearH.xyz / nearH.w;
-    let farPoint = farH.xyz / farH.w;
-    direction = normalize(farPoint - nearPoint);
-    origin = worldPos - direction * dot(worldPos - view.cameraPos, direction);
-    rayDistance = max(dot(worldPos - origin, direction), 0.0);
-  }
-  return apply_fog(view.fog, FogRay(origin, direction, rayDistance), color);
-}
-
 @fragment
 fn fs_lighting(in : FullscreenOutput) -> @location(0) vec4<f32> {
   // The lighting pass runs before the forward lane and shares its cleared
@@ -64,6 +41,5 @@ fn fs_lighting(in : FullscreenOutput) -> @location(0) vec4<f32> {
   let light = max(dot(normal, normalize(-view.lightDir)), 0.0);
   let direct = material.rgb * view.lightColor * light * clamp(emissiveSample.a, 0.0, 1.0);
   let radiance = vec4<f32>(direct + emissiveSample.rgb, material.a);
-  let worldPos = reconstructWorldPosition(in.uv, depth);
-  return fogDeferredRadiance(radiance, worldPos);
+  return radiance;
 }

package/src/ibl-sampling.wgsl

@@ -16,6 +16,8 @@
 //   - sampleIblDiffuse(N, irradianceMap, irradianceSampler)
 //   - sampleIblSpecular(N, V, roughness, F0, prefilterMap, prefilterSampler,
 //                       brdfLut, brdfLutSampler)
+//   - box_project(worldPosition, direction, boxCenter, boxExtents)
+//   - sampleReflectionProbeSpecular(..., probeMap, probeSampler, ...)
 
 #import forgeax_pbr::ibl_shared::{PI, fresnelSchlickRoughness, inverseRotateEnvironment}
 
@@ -56,3 +58,55 @@ fn sampleIblSpecular(
   let F = fresnelSchlickRoughness(NdotV, F0, roughness);
   return prefilteredColor * (F * envBRDF.r + envBRDF.g);
 }
+
+// Project a reflection ray from a point inside a probe box onto the box
+// boundary. The helper is binding-free so the scene table and the material
+// resource projection remain owned by the host record stage.
+fn box_project(
+  worldPosition: vec3<f32>,
+  direction: vec3<f32>,
+  boxCenter: vec3<f32>,
+  boxExtents: vec3<f32>,
+) -> vec3<f32> {
+  let safeExtents = max(boxExtents, vec3<f32>(0.0001));
+  let safeDirection = select(
+    vec3<f32>(0.0001),
+    direction,
+    abs(direction) >= vec3<f32>(0.0001),
+  );
+  let localPosition = worldPosition - boxCenter;
+  let edgeSign = select(vec3<f32>(-1.0), vec3<f32>(1.0), direction >= vec3<f32>(0.0));
+  let edge = edgeSign * safeExtents;
+  let distances = (edge - localPosition) / safeDirection;
+  let travel = min(distances.x, min(distances.y, distances.z));
+  return normalize(localPosition + direction * max(travel, 0.0));
+}
+
+// Split-sum probe sample. The probe texture is supplied by the caller so a
+// missing scene candidate can keep using sampleIblSpecular with the Skylight
+// resources already present in the Standard material layout.
+fn sampleReflectionProbeSpecular(
+  normal: vec3<f32>,
+  view: vec3<f32>,
+  roughness: f32,
+  F0: vec3<f32>,
+  worldPosition: vec3<f32>,
+  boxCenter: vec3<f32>,
+  boxExtents: vec3<f32>,
+  rotation: vec4<f32>,
+  probeMap: texture_cube<f32>,
+  probeSampler: sampler,
+  brdfLut: texture_2d<f32>,
+  brdfLutSampler: sampler,
+) -> vec3<f32> {
+  let NdotV = max(dot(normal, view), 0.001);
+  let reflection = reflect(-view, normal);
+  let projected = box_project(worldPosition, reflection, boxCenter, boxExtents);
+  let rotated = inverseRotateEnvironment(projected, rotation);
+  let probeDirection = vec3<f32>(rotated.x, -rotated.y, rotated.z);
+  let mip = roughness * 4.0;
+  let prefilteredColor = textureSampleLevel(probeMap, probeSampler, probeDirection, mip).rgb;
+  let envBRDF = textureSample(brdfLut, brdfLutSampler, vec2<f32>(NdotV, roughness)).rg;
+  let F = fresnelSchlickRoughness(NdotV, F0, roughness);
+  return prefilteredColor * (F * envBRDF.r + envBRDF.g);
+}

package/src/index.ts

@@ -108,6 +108,12 @@ export const ENGINE_MATERIAL_MODULES = [
   'forgeax_material::sprite-lit',
 ] as const;
 
+/** Names of the zero-binding Standard reflection-probe shader helpers. */
+export const REFLECTION_PROBE_SHADER_HELPERS = Object.freeze([
+  'box_project',
+  'sampleReflectionProbeSpecular',
+] as const);
+
 export function isEngineMaterialModule(module: string): boolean {
   return (ENGINE_MATERIAL_MODULES as readonly string[]).includes(module);
 }

package/src/lighting-attenuation.wgsl

@@ -0,0 +1,58 @@
+#define_import_path forgeax_pbr::lighting_attenuation
+
+// Shared punctual light optics. Range is represented by the host-derived
+// inverse squared range; the shader never reconstructs authoring units.
+fn evalDistanceAttenuation(dSquared : f32, invRangeSquared : f32) -> f32 {
+  let safeDistance = max(dSquared, 1e-4);
+  let window = clamp(1.0 - (safeDistance * invRangeSquared) * (safeDistance * invRangeSquared), 0.0, 1.0);
+  return window * window / safeDistance;
+}
+
+fn evalSpotAttenuation(
+  lightPos : vec3<f32>,
+  lightDir : vec3<f32>,
+  worldPos : vec3<f32>,
+  cosInner : f32,
+  cosOuter : f32,
+  invRangeSquared : f32,
+) -> f32 {
+  let toLight = lightPos - worldPos;
+  let dSquared = dot(toLight, toLight);
+  let distance = evalDistanceAttenuation(dSquared, invRangeSquared);
+  let direction = normalize(select(vec3<f32>(0.0, 0.0, -1.0), toLight, dSquared > 1e-4));
+  let cone = smoothstep(cosOuter, cosInner, dot(direction, -normalize(lightDir)));
+  return distance * cone;
+}
+
+// Isolated volume radiance helpers: this module has no resource bindings, so
+// compute stages can reuse the exact surface attenuation and cone facts.
+fn evalVolumePointRadiance(
+  lightPos : vec3<f32>,
+  colorTimesIntensity : vec3<f32>,
+  invRangeSquared : f32,
+  worldPos : vec3<f32>,
+) -> vec3<f32> {
+  let toLight = lightPos - worldPos;
+  let dSquared = max(dot(toLight, toLight), 1e-4);
+  return colorTimesIntensity * evalDistanceAttenuation(dSquared, invRangeSquared);
+}
+
+fn evalVolumeSpotRadiance(
+  lightPos : vec3<f32>,
+  lightDir : vec3<f32>,
+  colorTimesIntensity : vec3<f32>,
+  cosInner : f32,
+  cosOuter : f32,
+  invRangeSquared : f32,
+  worldPos : vec3<f32>,
+) -> vec3<f32> {
+  return colorTimesIntensity * evalSpotAttenuation(
+    lightPos, lightDir, worldPos, cosInner, cosOuter, invRangeSquared,
+  );
+}
+
+fn projectSpotUv(lightViewProj : mat4x4<f32>, worldPos : vec3<f32>) -> vec2<f32> {
+  let clip = lightViewProj * vec4<f32>(worldPos, 1.0);
+  let invW = select(1.0 / clip.w, 0.0, abs(clip.w) < 1e-6);
+  return vec2<f32>(clip.x * invW * 0.5 + 0.5, clip.y * invW * -0.5 + 0.5);
+}