@zephyr3d/scene 0.9.22 → 0.9.23

package/dist/posteffect/ssr.js

@@ -1,8 +1,8 @@
 import { AbstractPostEffect, PostEffectLayer } from './posteffect.js';
 import { linearToGamma } from '../shaders/misc.js';
-import { SSR_calcJitter, screenSpaceRayTracing_HiZ, screenSpaceRayTracing_Linear2D } from '../shaders/ssr.js';
+import { SSR_calcJitter, SSR_interleavedGradientNoise, screenSpaceRayTracing_HiZ, screenSpaceRayTracing_Linear2D } from '../shaders/ssr.js';
 import { temporalResolve } from '../shaders/temporal.js';
-import { Vector2, Matrix4x4, Vector4 } from '@zephyr3d/base';
+import { DEPTH_COMPARE_FARTHER, Vector2, Matrix4x4, Vector4, DEPTH_FARTHEST } from '@zephyr3d/base';
 import { copyTexture, fetchSampler } from '../utility/misc.js';
 import { getGGXLUT } from '../utility/textures/ggxlut.js';
 import { BilateralBlurBlitter } from '../blitter/bilateralblur.js';
@@ -28,6 +28,7 @@ import '../utility/blueprint/material/texture.js';
 import { RGHistoryResources } from '../render/rendergraph/history_resources.js';
 import { FrameResources } from '../render/rendergraph/blackboard.js';
 
+const DEBUG_HIZ_INTERSECT = false;
 /**
  * SSR post effect
  *
@@ -65,6 +66,15 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
     /** {@inheritDoc AbstractPostEffect.requireMotionVectorTexture} */ requireMotionVectorTexture(ctx) {
         return !!ctx.camera.ssrTemporal;
     }
+    /** {@inheritDoc AbstractPostEffect.requireHiZTexture} */ requireHiZTexture(ctx) {
+        return !!ctx.camera.HiZ;
+    }
+    /** {@inheritDoc AbstractPostEffect.requireSceneNormalTexture} */ requireSceneNormalTexture() {
+        return true;
+    }
+    /** {@inheritDoc AbstractPostEffect.requireSceneRoughnessTexture} */ requireSceneRoughnessTexture() {
+        return true;
+    }
     /**
    * Declares SSR's internal steps (intersect, resolve, optional bilateral
    * blur, optional temporal resolve, combine) as individual render graph
@@ -72,6 +82,11 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
    */ setup(s) {
         const { graph, ctx, history } = s;
         const linearDepthHandle = s.blackboard.get(FrameResources.LinearDepth);
+        // Reflected geometry must contribute its own radiance, not the fog the camera
+        // ray picked up on the way to it, which would otherwise be applied twice:
+        // once inside the reflection and again over the final image. Only published
+        // when the scene has fog; without it SceneColor is already fog free.
+        const noFogHandle = s.blackboard.get(FrameResources.SceneColorNoFog);
         const texDesc = {
             format: 'rgba16f',
             sizeMode: 'absolute',
@@ -120,6 +135,9 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
         // 2. Resolve reflection color from the intersect result.
         const resolveHandle = graph.addPass('SSR:Resolve', (builder)=>{
             builder.read(s.input);
+            if (noFogHandle) {
+                builder.read(noFogHandle);
+            }
             builder.read(intersectHandle);
             readCommon(builder);
             const out = builder.createTexture({
@@ -140,7 +158,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                 try {
                     device.setFramebuffer(rg.getFramebuffer(fb));
                     const inputTex = rg.getTexture(s.input);
-                    this.resolve(ctx, ctx.sceneColorTexture ?? inputTex, getLinearDepth(rg), rg.getTexture(intersectHandle));
+                    this.resolve(ctx, noFogHandle ? rg.getTexture(noFogHandle) : ctx.sceneColorTexture ?? inputTex, getLinearDepth(rg), rg.getTexture(intersectHandle));
                 } finally{
                     device.popDeviceStates();
                 }
@@ -189,10 +207,10 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                         const stdDev = ctx.camera.ssrBlurStdDev;
                         const depthCutoff = ctx.camera.ssrBlurDepthCutoff;
                         const blitterH = SSR._blurBlitterH = SSR._blurBlitterH ?? new BilateralBlurBlitter(false);
-                        blitterH.renderStates = AbstractPostEffect.getDefaultRenderState(ctx, 'gt');
+                        blitterH.renderStates = AbstractPostEffect.getDefaultRenderState(ctx, DEPTH_COMPARE_FARTHER);
                         this.blurPass(ctx, blitterH, intersectTex, 2, blurSizeScale, kernelRadius, stdDev, depthCutoff, rg.getTexture(resolveHandle), rg.getFramebuffer(middleFB));
                         const blitterV = SSR._blurBlitterV = SSR._blurBlitterV ?? new BilateralBlurBlitter(true);
-                        blitterV.renderStates = AbstractPostEffect.getDefaultRenderState(ctx, 'gt');
+                        blitterV.renderStates = AbstractPostEffect.getDefaultRenderState(ctx, DEPTH_COMPARE_FARTHER);
                         this.blurPass(ctx, blitterV, intersectTex, 2, blurSizeScale, kernelRadius, stdDev, depthCutoff, rg.getTexture(middle), rg.getFramebuffer(outFB));
                     } finally{
                         device.popDeviceStates();
@@ -314,7 +332,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
             program = this._createCombineProgrm(ctx);
             SSR._combineProgram = program;
         }
-        const roughnessTexture = ctx.SSRRoughnessTexture;
+        const roughnessTexture = ctx.SceneRoughnessTexture;
         if (!this._combineBindGroup) {
             this._combineBindGroup = device.createBindGroup(program.bindGroupLayouts[0]);
         }
@@ -325,7 +343,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
         this._combineBindGroup.setTexture('roughnessTex', roughnessTexture, linearSampler);
         this._combineBindGroup.setTexture('albedoTex', inputColorTexture, linearSampler);
         this._combineBindGroup.setTexture('extraTex', inputColorTexture, nearestSampler);
-        this._combineBindGroup.setTexture('normalTex', ctx.SSRNormalTexture, nearestSampler);
+        this._combineBindGroup.setTexture('normalTex', ctx.SceneNormalTexture, nearestSampler);
         this._combineBindGroup.setTexture('depthTex', ctx.linearDepthTexture, nearestSampler);
         this._combineBindGroup.setTexture('zGGXLut', getGGXLUT(1024), fetchSampler('clamp_nearest_nomip'));
         this._combineBindGroup.setValue('ssrMaxRoughness', ctx.camera.ssrMaxRoughness);
@@ -338,7 +356,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
         this._combineBindGroup.setValue('srgbOut', srgbOut ? 1 : 0);
         device.setProgram(program);
         device.setBindGroup(0, this._combineBindGroup);
-        this.drawFullscreenQuad(AbstractPostEffect.getDefaultRenderState(ctx, 'gt'));
+        this.drawFullscreenQuad(AbstractPostEffect.getDefaultRenderState(ctx, DEPTH_COMPARE_FARTHER));
     }
     /** @internal */ resolve(ctx, inputColorTexture, sceneDepthTexture, intersectTexture) {
         const device = ctx.device;
@@ -356,8 +374,8 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
         }
         const nearestSampler = fetchSampler('clamp_nearest');
         const linearSampler = fetchSampler('clamp_linear');
-        const roughnessTexture = ctx.SSRRoughnessTexture;
-        const normalTexture = ctx.SSRNormalTexture;
+        const roughnessTexture = ctx.SceneRoughnessTexture;
+        const normalTexture = ctx.SceneNormalTexture;
         bindGroup.setTexture('colorTex', inputColorTexture, linearSampler);
         bindGroup.setTexture('intersectTex', intersectTexture, nearestSampler);
         bindGroup.setTexture('roughnessTex', roughnessTexture, nearestSampler);
@@ -374,14 +392,14 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
         bindGroup.setValue('viewMatrix', ctx.camera.viewMatrix);
         bindGroup.setValue('invViewMatrix', ctx.camera.worldMatrix);
         if (hasEnvRadiance) {
-            bindGroup.setValue('envLightStrength', ctx.env.light.strength);
+            bindGroup.setValue('envLightStrength', ShaderHelper.getEnvLightLuminance(ctx));
             bindGroup.setValue('envLightSpecularStrength', ctx.env.light.specularStrength ?? 1);
             ctx.env.light.envLight.updateBindGroup(bindGroup);
         }
         bindGroup.setValue('flip', this.needFlip(device) ? 1 : 0);
         device.setProgram(program);
         device.setBindGroup(0, bindGroup);
-        this.drawFullscreenQuad(AbstractPostEffect.getDefaultRenderState(ctx, 'gt'));
+        this.drawFullscreenQuad(AbstractPostEffect.getDefaultRenderState(ctx, DEPTH_COMPARE_FARTHER));
     }
     /** @internal */ intersect(ctx, inputColorTexture, sceneDepthTexture, blur, srgbOut) {
         const device = ctx.device;
@@ -403,12 +421,12 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
         }
         const nearestSampler = fetchSampler('clamp_nearest');
         const linearSampler = fetchSampler('clamp_linear');
-        const roughnessTexture = ctx.SSRRoughnessTexture;
-        const normalTexture = ctx.SSRNormalTexture;
+        const roughnessTexture = ctx.SceneRoughnessTexture;
+        const normalTexture = ctx.SceneNormalTexture;
         if (!blur) {
             bindGroup.setTexture('colorTex', inputColorTexture, linearSampler);
             if (hasEnvRadiance) {
-                bindGroup.setValue('envLightStrength', ctx.env.light.strength);
+                bindGroup.setValue('envLightStrength', ShaderHelper.getEnvLightLuminance(ctx));
                 bindGroup.setValue('envLightSpecularStrength', ctx.env.light.specularStrength ?? 1);
                 ctx.env.light.envLight.updateBindGroup(bindGroup);
             }
@@ -431,6 +449,9 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
         if (ctx.HiZTexture) {
             bindGroup.setTexture('hizTex', ctx.HiZTexture, nearestSampler);
             bindGroup.setValue('depthMipLevels', ctx.HiZTexture.mipLevelCount);
+            // Temporal jitter phase for the UE5-style fixed-step HZB march
+            // (UE View.StateFrameIndexMod8).
+            bindGroup.setValue('ssrFrameIndex', device.frameInfo.frameCounter % 8);
             bindGroup.setValue('targetSize', new Vector4(sceneDepthTexture.width, sceneDepthTexture.height, ctx.HiZTexture.width, ctx.HiZTexture.height));
         } else {
             bindGroup.setValue('ssrStride', ctx.camera.ssrStride);
@@ -440,7 +461,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
         bindGroup.setValue('srgbOut', srgbOut ? 1 : 0);
         device.setProgram(program);
         device.setBindGroup(0, bindGroup);
-        this.drawFullscreenQuad(AbstractPostEffect.getDefaultRenderState(ctx, 'gt'));
+        this.drawFullscreenQuad(AbstractPostEffect.getDefaultRenderState(ctx, DEPTH_COMPARE_FARTHER));
     }
     /** @internal */ temporal(ctx, currentReflectTex, sceneDepthTexture, prevReflectTex, prevMotionVectorTex, outFramebuffer) {
         const device = ctx.device;
@@ -463,7 +484,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
         device.setFramebuffer(outFramebuffer);
         device.setProgram(program);
         device.setBindGroup(0, this._temporalBindGroup);
-        this.drawFullscreenQuad(AbstractPostEffect.getDefaultRenderState(ctx, 'gt'));
+        this.drawFullscreenQuad(AbstractPostEffect.getDefaultRenderState(ctx, DEPTH_COMPARE_FARTHER));
     }
     /** {@inheritDoc AbstractPostEffect.apply} */ apply(ctx, inputColorTexture, sceneDepthTexture, srgbOutput) {
         const device = ctx.device;
@@ -486,10 +507,10 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
             const stdDev = ctx.camera.ssrBlurStdDev;
             const depthCutoff = ctx.camera.ssrBlurDepthCutoff;
             const blitterH = SSR._blurBlitterH = SSR._blurBlitterH ?? new BilateralBlurBlitter(false);
-            blitterH.renderStates = AbstractPostEffect.getDefaultRenderState(ctx, 'gt');
+            blitterH.renderStates = AbstractPostEffect.getDefaultRenderState(ctx, DEPTH_COMPARE_FARTHER);
             this.blurPass(ctx, blitterH, intersectTex, 2, blurSizeScale, kernelRadius, stdDev, depthCutoff, pingpongFramebuffer[0].getColorAttachments()[0], pingpongFramebuffer[1]);
             const blitterV = SSR._blurBlitterV = SSR._blurBlitterV ?? new BilateralBlurBlitter(true);
-            blitterV.renderStates = AbstractPostEffect.getDefaultRenderState(ctx, 'gt');
+            blitterV.renderStates = AbstractPostEffect.getDefaultRenderState(ctx, DEPTH_COMPARE_FARTHER);
             this.blurPass(ctx, blitterV, intersectTex, 2, blurSizeScale, kernelRadius, stdDev, depthCutoff, pingpongFramebuffer[1].getColorAttachments()[0], pingpongFramebuffer[0]);
         }
         const historyManager = ctx.camera.getHistoryResourceManager();
@@ -538,7 +559,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                 this.$inputs.pos = pb.vec2().attrib('position');
                 this.$outputs.uv = pb.vec2();
                 pb.main(function() {
-                    this.$builtins.position = pb.vec4(this.$inputs.pos, 1, 1);
+                    this.$builtins.position = pb.vec4(this.$inputs.pos, DEPTH_FARTHEST, 1);
                     this.$outputs.uv = pb.add(pb.mul(this.$inputs.pos.xy, 0.5), pb.vec2(0.5));
                     this.$if(pb.notEqual(this.flip, 0), function() {
                         this.$builtins.position.y = pb.neg(this.$builtins.position.y);
@@ -552,7 +573,10 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                 this.albedoTex = pb.tex2D().uniform(0);
                 this.extraTex = pb.tex2D().uniform(0);
                 this.normalTex = pb.tex2D().uniform(0);
-                this.depthTex = pb.tex2D().uniform(0);
+                // Linear depth is r32f/rg32f and is only sampled with nearest
+                // filtering, so it must use the non-filtering float sample type on
+                // adapters without float32-filterable.
+                this.depthTex = pb.tex2D().sampleType('unfilterable-float').uniform(0);
                 this.zGGXLut = pb.tex2D().uniform(0);
                 this.targetSize = pb.vec4().uniform(0);
                 this.cameraNearFar = pb.vec2().uniform(0);
@@ -566,8 +590,8 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                     pb.vec2('uv')
                 ], function() {
                     this.$l.linearDepth = ShaderHelper.sampleLinearDepth(this, this.depthTex, this.uv, 0);
-                    this.$l.nonLinearDepth = pb.div(pb.sub(pb.div(this.cameraNearFar.x, this.linearDepth), this.cameraNearFar.y), pb.sub(this.cameraNearFar.x, this.cameraNearFar.y));
-                    this.$l.clipSpacePos = pb.vec4(pb.sub(pb.mul(this.uv, 2), pb.vec2(1)), pb.sub(pb.mul(pb.clamp(this.nonLinearDepth, 0, 1), 2), 1), 1);
+                    this.$l.nonLinearDepth = ShaderHelper.linearNormalizedToNonLinearDepth(this, this.linearDepth, this.cameraNearFar);
+                    this.$l.clipSpacePos = pb.vec4(pb.sub(pb.mul(this.uv, 2), pb.vec2(1)), ShaderHelper.deviceDepthToClipZ(this, pb.clamp(this.nonLinearDepth, 0, 1)), 1);
                     this.$l.viewPos4 = pb.mul(this.invProjMatrix, this.clipSpacePos);
                     this.$return(pb.vec4(pb.div(this.viewPos4.xyz, this.viewPos4.w), this.linearDepth));
                 });
@@ -660,7 +684,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                     ctx.env.light.envLight.initShaderBindings(pb);
                 }
                 pb.main(function() {
-                    this.$builtins.position = pb.vec4(this.$inputs.pos, 1, 1);
+                    this.$builtins.position = pb.vec4(this.$inputs.pos, DEPTH_FARTHEST, 1);
                     this.$outputs.uv = pb.add(pb.mul(this.$inputs.pos.xy, 0.5), pb.vec2(0.5));
                     this.$if(pb.notEqual(this.flip, 0), function() {
                         this.$builtins.position.y = pb.neg(this.$builtins.position.y);
@@ -674,7 +698,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                 this.normalTex = pb.tex2D().uniform(0);
                 this.albedoTex = pb.tex2D().uniform(0);
                 this.extraTex = pb.tex2D().uniform(0);
-                this.depthTex = pb.tex2D().uniform(0);
+                this.depthTex = pb.tex2D().sampleType('unfilterable-float').uniform(0);
                 this.zGGXLut = pb.tex2D().uniform(0);
                 this.cameraNearFar = pb.vec2().uniform(0);
                 this.targetSize = pb.vec4().uniform(0);
@@ -694,8 +718,8 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                     pb.mat4('mat')
                 ], function() {
                     this.$l.linearDepth = ShaderHelper.sampleLinearDepth(this, this.depthTex, this.uv, 0);
-                    this.$l.nonLinearDepth = pb.div(pb.sub(pb.div(this.cameraNearFar.x, this.linearDepth), this.cameraNearFar.y), pb.sub(this.cameraNearFar.x, this.cameraNearFar.y));
-                    this.$l.clipSpacePos = pb.vec4(pb.sub(pb.mul(this.uv, 2), pb.vec2(1)), pb.sub(pb.mul(pb.clamp(this.nonLinearDepth, 0, 1), 2), 1), 1);
+                    this.$l.nonLinearDepth = ShaderHelper.linearNormalizedToNonLinearDepth(this, this.linearDepth, this.cameraNearFar);
+                    this.$l.clipSpacePos = pb.vec4(pb.sub(pb.mul(this.uv, 2), pb.vec2(1)), ShaderHelper.deviceDepthToClipZ(this, pb.clamp(this.nonLinearDepth, 0, 1)), 1);
                     this.$l.wPos = pb.mul(this.mat, this.clipSpacePos);
                     this.$return(pb.vec4(pb.div(this.wPos.xyz, this.wPos.w), this.linearDepth));
                 });
@@ -828,7 +852,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                 this.$inputs.pos = pb.vec2().attrib('position');
                 this.$outputs.uv = pb.vec2();
                 pb.main(function() {
-                    this.$builtins.position = pb.vec4(this.$inputs.pos, 1, 1);
+                    this.$builtins.position = pb.vec4(this.$inputs.pos, DEPTH_FARTHEST, 1);
                     this.$outputs.uv = pb.add(pb.mul(this.$inputs.pos.xy, 0.5), pb.vec2(0.5));
                     this.$if(pb.notEqual(this.flip, 0), function() {
                         this.$builtins.position.y = pb.neg(this.$builtins.position.y);
@@ -866,7 +890,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                     ctx.env.light.envLight.initShaderBindings(pb);
                 }
                 pb.main(function() {
-                    this.$builtins.position = pb.vec4(this.$inputs.pos, 1, 1);
+                    this.$builtins.position = pb.vec4(this.$inputs.pos, DEPTH_FARTHEST, 1);
                     this.$outputs.uv = pb.add(pb.mul(this.$inputs.pos.xy, 0.5), pb.vec2(0.5));
                     this.$if(pb.notEqual(this.flip, 0), function() {
                         this.$builtins.position.y = pb.neg(this.$builtins.position.y);
@@ -886,7 +910,7 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                 this.roughnessTex = pb.tex2D().uniform(0);
                 this.normalTex = pb.tex2D().uniform(0);
                 this.extraTex = pb.tex2D().uniform(0);
-                this.depthTex = pb.tex2D().uniform(0);
+                this.depthTex = pb.tex2D().sampleType('unfilterable-float').uniform(0);
                 this.zGGXLut = pb.tex2D().uniform(0);
                 this.cameraNearFar = pb.vec2().uniform(0);
                 this.cameraPos = pb.vec3().uniform(0);
@@ -899,8 +923,11 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                 this.ssrStrengthMode = pb.int().uniform(0);
                 this.targetSize = pb.vec4().uniform(0);
                 if (ctx.HiZTexture) {
-                    this.hizTex = pb.tex2D().uniform(0);
+                    // Hi-Z is r32f and is sampled with a nearest sampler. Do not
+                    // require the optional float32-filterable feature just to bind it.
+                    this.hizTex = pb.tex2D().sampleType('unfilterable-float').uniform(0);
                     this.depthMipLevels = pb.int().uniform(0);
+                    this.ssrFrameIndex = pb.float().uniform(0);
                 } else {
                     this.ssrStride = pb.float().uniform(0);
                 }
@@ -911,8 +938,8 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                     pb.mat4('mat')
                 ], function() {
                     this.$l.linearDepth = ShaderHelper.sampleLinearDepth(this, this.depthTex, this.uv, 0);
-                    this.$l.nonLinearDepth = pb.div(pb.sub(pb.div(this.cameraNearFar.x, this.linearDepth), this.cameraNearFar.y), pb.sub(this.cameraNearFar.x, this.cameraNearFar.y));
-                    this.$l.clipSpacePos = pb.vec4(pb.sub(pb.mul(this.uv, 2), pb.vec2(1)), pb.sub(pb.mul(pb.clamp(this.nonLinearDepth, 0, 1), 2), 1), 1);
+                    this.$l.nonLinearDepth = ShaderHelper.linearNormalizedToNonLinearDepth(this, this.linearDepth, this.cameraNearFar);
+                    this.$l.clipSpacePos = pb.vec4(pb.sub(pb.mul(this.uv, 2), pb.vec2(1)), ShaderHelper.deviceDepthToClipZ(this, pb.clamp(this.nonLinearDepth, 0, 1)), 1);
                     this.$l.wPos = pb.mul(this.mat, this.clipSpacePos);
                     this.$return(pb.vec4(pb.div(this.wPos.xyz, this.wPos.w), this.linearDepth));
                 });
@@ -969,24 +996,35 @@ import { FrameResources } from '../render/rendergraph/blackboard.js';
                             this.$l.reflectVec = pb.add(pb.reflect(this.viewVec, this.viewNormal), SSR_calcJitter(this, this.viewPos, this.roughness));
                             this.$l.hitInfo = pb.vec4(0);
                             if (ctx.HiZTexture) {
-                                this.hitInfo = screenSpaceRayTracing_HiZ(this, this.viewPos, this.reflectVec, this.viewMatrix, this.projMatrix, this.invProjMatrix, this.cameraNearFar, this.depthMipLevels, this.ssrParams.y, this.ssrParams.x, this.ssrParams.z, this.targetSize, this.hizTex, this.normalTex);
+                                // UE5-style temporal jitter of the fixed-step march; the
+                                // temporal resolve pass converges the resulting noise.
+                                this.$l.ssrStepOffset = pb.sub(SSR_interleavedGradientNoise(this, this.$builtins.fragCoord.xy, this.ssrFrameIndex), 0.5);
+                                // Nudge the ray origin off the surface along the normal so the
+                                // grazing-angle march does not self-intersect the reflector's
+                                // quantized depth staircase (regular stripe artifacts). Scales
+                                // with view distance to track depth precision; same idea as the
+                                // SSGI ray-origin bias.
+                                this.$l.ssrRayOrigin = pb.add(this.viewPos, pb.mul(pb.normalize(this.viewNormal), pb.max(0.01, pb.mul(pb.neg(this.viewPos.z), 0.002))));
+                                this.hitInfo = screenSpaceRayTracing_HiZ(this, this.ssrRayOrigin, this.reflectVec, this.viewMatrix, this.projMatrix, this.invProjMatrix, this.cameraNearFar, this.depthMipLevels, this.ssrParams.y, this.ssrParams.x, this.ssrParams.z, this.targetSize, this.hizTex, this.normalTex, undefined, this.roughness, this.ssrStepOffset);
                             } else {
                                 this.hitInfo = screenSpaceRayTracing_Linear2D(this, this.viewPos, this.reflectVec, this.viewMatrix, this.projMatrix, this.invProjMatrix, this.cameraNearFar, this.ssrParams.x, this.ssrParams.y, this.ssrParams.z, this.ssrStride, this.targetSize, this.depthTex, this.normalTex, !!ctx.camera.ssrCalcThickness);
                             }
                             this.$l.hitAlpha = pb.clamp(this.hitInfo.w, 0, 1);
                             this.$l.hitUV = pb.clamp(this.hitInfo.xy, pb.vec2(0), pb.vec2(1));
                             if (blur) {
-                                this.blurRadius = pb.float(0);
-                                this.$if(pb.greaterThan(this.roughness, 0.001), function() {
-                                    this.$l.coneAngle = pb.mul(pb.min(this.roughness, 0.999), Math.PI * 0.5);
-                                    this.$l.coneLen = this.$choice(pb.greaterThan(this.hitAlpha, 0), this.hitInfo.z, pb.min(this.targetSize.z, this.targetSize.w));
-                                    this.$l.opLen = pb.mul(pb.tan(this.coneAngle), this.coneLen, 2);
-                                    this.$l.a2 = pb.mul(this.opLen, this.opLen);
-                                    this.$l.fh2 = pb.mul(this.coneLen, this.coneLen, 4);
-                                    this.blurRadius = pb.div(pb.mul(this.opLen, pb.sub(pb.sqrt(pb.add(this.a2, this.fh2)), this.opLen)), pb.mul(this.coneLen, 4));
-                                });
-                                this.a = this.hitAlpha;
-                                this.color = pb.vec3(this.hitUV, pb.clamp(pb.div(this.blurRadius, 255), 0, 1));
+                                if (ctx.HiZTexture && DEBUG_HIZ_INTERSECT) ; else {
+                                    this.blurRadius = pb.float(0);
+                                    this.$if(pb.greaterThan(this.roughness, 0.001), function() {
+                                        this.$l.coneAngle = pb.mul(pb.min(this.roughness, 0.999), Math.PI * 0.5);
+                                        this.$l.coneLen = this.$choice(pb.greaterThan(this.hitAlpha, 0), this.hitInfo.z, pb.min(this.targetSize.x, this.targetSize.y));
+                                        this.$l.opLen = pb.mul(pb.tan(this.coneAngle), this.coneLen, 2);
+                                        this.$l.a2 = pb.mul(this.opLen, this.opLen);
+                                        this.$l.fh2 = pb.mul(this.coneLen, this.coneLen, 4);
+                                        this.blurRadius = pb.div(pb.mul(this.opLen, pb.sub(pb.sqrt(pb.add(this.a2, this.fh2)), this.opLen)), pb.mul(this.coneLen, 4));
+                                    });
+                                    this.a = this.hitAlpha;
+                                    this.color = pb.vec3(this.hitUV, pb.clamp(pb.div(this.blurRadius, 255), 0, 1));
+                                }
                             } else {
                                 if (ctx.env.light.envLight?.hasRadiance()) {
                                     this.$l.reflectVecW = pb.mul(this.invViewMatrix, pb.vec4(this.reflectVec, 0)).xyz;