rayzee 11.5.0 → 11.7.0

package/src/RayzeeRenderer.js

@@ -15,7 +15,7 @@ import { usesTextureCoordinates } from './Processor/GeometryExtractor.js';
 import { MAX_STORAGE_TEXTURE_SIZE, MAX_RESERVABLE_RENDER_SIZE, setReservedRenderSize } from './Processor/StorageTexturePool.js';
 import { updateStats, updateLoading, resetLoading, setStatusCallback, getDisplaySamples, disposeObjectFromMemory, disposeRenderer } from './Processor/utils.js';
 import { BuildTimer } from './Processor/BuildTimer.js';
-import { TextureReadback } from './Processor/TextureReadback.js';
+import { TextureReadback, readPixels } from './Processor/TextureReadback.js';
 import { createLogger, fmt } from './utils/Logger.js';
 import { EngineEvents, LEGACY_EVENT_NAMES } from './EngineEvents.js';
 import { IssueLog, ISSUE_CODES, EngineIssueError } from './EngineIssues.js';
@@ -2730,7 +2730,7 @@ export class RayzeeRenderer extends EventDispatcher {
 	 *   accumulation
 	 * @returns {Promise<{data: Float32Array|Uint8ClampedArray, width: number, height: number, colorSpace: string,
 	 *   source: string, toneMappedOn?: 'gpu'|'cpu'}>} `source` is what was read: `'accumulation'`, or the
-	 *   denoiser that published it (`'oidn'`, `'asvgf'`, `'nrd'`, `'edgeFiltering'`, `'bilateralFiltering'`).
+	 *   denoiser that published it (`'oidn'`, `'nrd'`).
 	 *   `toneMappedOn` is set for `'srgb'` only.
 	 */
 	async renderToBuffer( { colorSpace = 'srgb', preserveAlpha = false, source = 'accumulation' } = {} ) {
@@ -2766,14 +2766,14 @@ export class RayzeeRenderer extends EventDispatcher {
 			const fn = ! gpu && tone.gain ? await tone.gain.cpu() : null;
 			const data = gpu ?? toneMapToRGBA8( shown
 				? await this._readTexture( shown.texture, width, height )
-				: await this.renderer.readRenderTargetPixelsAsync( target, 0, 0, width, height, 0 ), { ...tone, pixelGain: fn && { fn, width, height } } );
+				: await readPixels( this.renderer, target, width, height ), { ...tone, pixelGain: fn && { fn, width, height } } );
 			return { data, width, height, colorSpace, source: shown?.source ?? 'accumulation', toneMappedOn: gpu ? 'gpu' : 'cpu' };
 
 		}
 
 		const { data: linear, source: read } = source === 'display'
 			? await this._readDisplaySource( target, width, height )
-			: { data: await this.renderer.readRenderTargetPixelsAsync( target, 0, 0, width, height, 0 ), source: 'accumulation' };
+			: { data: await readPixels( this.renderer, target, width, height ), source: 'accumulation' };
 
 		// `colorSpace` stays 'linear' — callers branch on it. `workingSpace` is the new, additive
 		// answer to "linear in what primaries", which only means something once a config is loaded.
@@ -3450,7 +3450,7 @@ export class RayzeeRenderer extends EventDispatcher {
 	async _readDisplaySource( accumulation, width, height ) {
 
 		const shown = this._displaySource( accumulation );
-		if ( ! shown ) return { data: await this.renderer.readRenderTargetPixelsAsync( accumulation, 0, 0, width, height, 0 ), source: 'accumulation' };
+		if ( ! shown ) return { data: await readPixels( this.renderer, accumulation, width, height ), source: 'accumulation' };
 		return { data: await this._readTexture( shown.texture, width, height ), source: shown.source };
 
 	}

package/src/Stages/DenoiserSettings.js

@@ -4,57 +4,12 @@
 export const GBUFFER_MISS_DEPTH = 65504.0;
 export const GBUFFER_MISS_THRESHOLD = 6e4;
 
-// Albedo demodulation safety floor. ASVGF and BilateralFilter MUST use the
-// same value — demod (`color / safeAlbedo`) and remod (`lighting * safeAlbedo`)
-// only round-trip exactly when both sides agree.
+// Albedo demodulation safety floor. Demod (`color / safeAlbedo`) and remod (`lighting * safeAlbedo`)
+// only round-trip exactly when both sides use the same value.
 export const ALBEDO_EPS = 0.01;
 
-export const ASVGF_QUALITY_PRESETS = {
-	// phiColor / phiDepth are RELATIVE tolerances (fractions). Bigger = more
-	// permissive. The adaptive temporal gradient (gradientStrength > 0) is always
-	// on: it measures real change in units of noise σ (gradientSigmaScale), so a
-	// static scene reads ~0 (no convergence penalty) and only moving lights / anim
-	// / disocclusion drop history. See ASVGF._buildGradientCompute.
-	low: {
-		temporalAlpha: 0.1,
-		gradientStrength: 0.8,
-		gradientSigmaScale: 2.5,
-		gradientNoiseFloor: 0.05,
-		atrousIterations: 3,
-		phiColor: 1.0,
-		phiNormal: 64.0,
-		phiDepth: 0.1,
-		phiLuminance: 6.0,
-		maxAccumFrames: 16,
-		varianceBoost: 0.5
-	},
-	medium: {
-		temporalAlpha: 0.03,
-		gradientStrength: 1.0,
-		gradientSigmaScale: 2.5,
-		gradientNoiseFloor: 0.05,
-		atrousIterations: 4,
-		phiColor: 0.5,
-		phiNormal: 128.0,
-		phiDepth: 0.05,
-		phiLuminance: 4.0,
-		maxAccumFrames: 64,
-		varianceBoost: 1.0
-	},
-	high: {
-		temporalAlpha: 0.0,
-		gradientStrength: 1.0,
-		gradientSigmaScale: 2.5,
-		gradientNoiseFloor: 0.05,
-		atrousIterations: 6,
-		phiColor: 0.3,
-		phiNormal: 256.0,
-		phiDepth: 0.02,
-		phiLuminance: 2.0,
-		maxAccumFrames: 128,
-		varianceBoost: 1.5
-	}
-};
+// The live view's denoisers, for setDenoiserStrategy.
+export const DENOISER_STRATEGIES = Object.freeze( [ 'none', 'nrd', 'oidn' ] );
 
 // normHitDist = hitDist / (A + B·viewZ). A constant, not a uniform: the Shade write and the NRD
 // decode must agree, and the normalization is a pure round trip.
@@ -122,21 +77,9 @@ export const NRD_QUALITY_PRESETS = {
 	},
 };
 
-const ASVGF_MEDIUM = ASVGF_QUALITY_PRESETS.medium;
-
 // What the live denoisers, the final OIDN pass and the AI upscaler start with; a host's own state seeds from these.
 export const DENOISER_DEFAULTS = {
-	denoiserStrategy: 'none', // the live view's denoiser: 'none' | 'edgeaware' | 'asvgf' | 'nrd' | 'oidn'
-
-	// EdgeAware denoiser (spatial-only SVGF à-trous). filterStrength: final blend
-	// (0 = raw, 1 = filtered). edgeAtrousIterations: à-trous passes (step 1,2,4,8,16).
-	// edgePhiLuminance: variance-scaled luminance edge-stop. edgePhiNormal: normal cone
-	// exponent. edgePhiDepth: RELATIVE depth tolerance (fraction of ray distance).
-	filterStrength: 1.0,
-	edgeAtrousIterations: 5,
-	edgePhiLuminance: 4.0,
-	edgePhiNormal: 64.0,
-	edgePhiDepth: 0.1,
+	denoiserStrategy: 'none', // the live view's denoiser, one of DENOISER_STRATEGIES
 
 	enableOIDN: false,
 	oidnQuality: 'fast',
@@ -157,25 +100,6 @@ export const DENOISER_DEFAULTS = {
 	upscalerQuality: 'fast',
 	upscalerHdr: true,
 
-	// ASVGF runs its quality preset whenever it is switched on, so its values are that preset's.
-	enableASVGF: false,
-	asvgfQualityPreset: 'medium',
-	asvgfTemporalAlpha: ASVGF_MEDIUM.temporalAlpha,
-	asvgfAtrousIterations: ASVGF_MEDIUM.atrousIterations,
-	asvgfPhiColor: ASVGF_MEDIUM.phiColor,
-	asvgfPhiNormal: ASVGF_MEDIUM.phiNormal,
-	asvgfPhiDepth: ASVGF_MEDIUM.phiDepth,
-	asvgfPhiLuminance: ASVGF_MEDIUM.phiLuminance,
-	asvgfVarianceBoost: ASVGF_MEDIUM.varianceBoost,
-	asvgfMaxAccumFrames: ASVGF_MEDIUM.maxAccumFrames,
-	// Must be > 0: the gradient also rejects fireflies before the EMA smears them across
-	// ~1/alpha frames. At 0 the denoiser measures ~3x worse than no denoiser at 1 spp.
-	asvgfGradientStrength: ASVGF_MEDIUM.gradientStrength,
-	asvgfGradientSigmaScale: ASVGF_MEDIUM.gradientSigmaScale,
-	asvgfGradientNoiseFloor: ASVGF_MEDIUM.gradientNoiseFloor,
-	asvgfDebugMode: 0,
-	showAsvgfHeatmap: false,
-
 	// NRD (ReBLUR port) real-time denoiser — see NRD_DEFAULTS / NRD_QUALITY_PRESETS.
 	nrdQualityPreset: 'medium',
 	nrdDebugMode: 0,

package/src/Stages/MotionVector.js

@@ -1,4 +1,4 @@
-import { Fn, vec2, vec3, vec4, float, int, uint, ivec2, uvec2, uniform, If,
+import { Fn, vec2, vec4, float, int, uint, ivec2, uvec2, uniform, If,
 	textureLoad, textureStore, workgroupId, localId } from 'three/tsl';
 import { RenderTarget, TextureNode, StorageTexture } from 'three/webgpu';
 import { HalfFloatType, RGBAFormat, NearestFilter, Matrix4, Box2, Vector2 } from 'three';
@@ -9,14 +9,13 @@ import { cameraRayPoint, cameraRayUniforms } from '../TSL/CameraRay.js';
 /**
  * WebGPU Motion Vector Stage (Compute Shader)
  *
- * Computes per-pixel screen-space and world-space motion vectors by
- * reconstructing world positions from linear ray depth and reprojecting
- * to the previous frame.
+ * Computes per-pixel screen-space motion vectors by reconstructing world
+ * positions from linear ray depth and reprojecting to the previous frame.
  *
  * Architecture (copy approach — proven working in PathTracer):
- *   1. Two compute shaders write to StorageTextures via textureStore
+ *   1. A compute shader writes to a StorageTexture via textureStore
  *   2. After dispatch, copyTextureToTexture transfers StorageTexture → RenderTarget
- *   3. RenderTarget textures are published to context (NOT StorageTextures —
+ *   3. The RenderTarget texture is published to context (NOT the StorageTexture —
  *      cross-dispatch reads from StorageTexture return zeros in Three.js WebGPU)
  *
  * Algorithm:
@@ -26,9 +25,8 @@ import { cameraRayPoint, cameraRayUniforms } from '../TSL/CameraRay.js';
  *   4. Project to previous frame:  prevVP * worldPos
  *   5. Motion = currentUV - prevUV
  *
- * Output formats (RGBA Float → copied to RGBA HalfFloat RenderTarget):
+ * Output format (RGBA Float → copied to RGBA HalfFloat RenderTarget):
  *   screenSpace — xy=motion (UV-space), z=depth, w=validity
- *   worldSpace  — xyz=world velocity, w=validity
  *
  * Critical design decisions:
  *   - matricesInitialized is NOT reset on pipeline:reset.
@@ -40,13 +38,8 @@ import { cameraRayPoint, cameraRayUniforms } from '../TSL/CameraRay.js';
  *
  * Execution: ALWAYS — motion vectors are needed every frame.
  *
- * Events listened:
- *   pipeline:reset  — reset frame counter (but NOT matrices)
- *
  * Textures published:
  *   motionVector:screenSpace (from RenderTarget, not StorageTexture)
- *   motionVector:worldSpace  (from RenderTarget, not StorageTexture)
- *   motionVector:motion      (alias for screenSpace)
  *
  * Textures read:
  *   pathtracer:normalDepth — linear depth for world position reconstruction
@@ -72,8 +65,6 @@ export class MotionVector extends RenderStage {
 		this.currentViewProjectionMatrix = new Matrix4();
 
 		this.matricesInitialized = false;
-		this.isFirstFrame = true;
-		this.frameCount = 0;
 
 		// Camera uniforms for world position reconstruction
 		// Synced from PathTracer each frame (same source as NormalDepth)
@@ -81,9 +72,6 @@ export class MotionVector extends RenderStage {
 		this.cameraProjectionMatrixInverse = uniform( new Matrix4(), 'mat4' );
 		this.cameraRay = cameraRayUniforms();
 		this.prevVP = uniform( new Matrix4(), 'mat4' );
-		this.isFirstFrameU = uniform( 1.0 ); // 1.0 = true, 0.0 = false
-		this.deltaTime = uniform( 1.0 / 60.0 );
-		this.velocityScale = uniform( 1.0 );
 
 		// Resolution uniforms (for compute pixel coords)
 		this.resolutionWidth = uniform( width );
@@ -92,7 +80,7 @@ export class MotionVector extends RenderStage {
 		// Input texture node (swappable — no shader recompile)
 		this._normalDepthTexNode = new TextureNode();
 
-		// Write-only StorageTextures (compute output).
+		// Write-only StorageTexture (compute output).
 		// Pre-allocate at max — StorageTexture.setSize() destroys the GPU texture
 		// while the compute bind group keeps the stale view (three.js #33061).
 		this._screenSpaceStorageTex = new StorageTexture( MAX_STORAGE_TEXTURE_SIZE, MAX_STORAGE_TEXTURE_SIZE );
@@ -101,35 +89,24 @@ export class MotionVector extends RenderStage {
 		this._screenSpaceStorageTex.minFilter = NearestFilter;
 		this._screenSpaceStorageTex.magFilter = NearestFilter;
 
-		this._worldSpaceStorageTex = new StorageTexture( MAX_STORAGE_TEXTURE_SIZE, MAX_STORAGE_TEXTURE_SIZE );
-		this._worldSpaceStorageTex.type = HalfFloatType;
-		this._worldSpaceStorageTex.format = RGBAFormat;
-		this._worldSpaceStorageTex.minFilter = NearestFilter;
-		this._worldSpaceStorageTex.magFilter = NearestFilter;
-
-		// Reused per-copy: copy only the active region out of the over-alloc texs.
+		// Reused per-copy: copy only the active region out of the over-alloc tex.
 		this._srcRegion = new Box2( new Vector2( 0, 0 ), new Vector2( 0, 0 ) );
 
-		// Readable RenderTargets (copy destinations — published to context)
-		const rtOpts = {
+		// Readable RenderTarget (copy destination — published to context)
+		this.screenSpaceTarget = new RenderTarget( width, height, {
 			type: HalfFloatType,
 			format: RGBAFormat,
 			minFilter: NearestFilter,
 			magFilter: NearestFilter,
 			depthBuffer: false,
 			stencilBuffer: false
-		};
-
-		this.screenSpaceTarget = new RenderTarget( width, height, rtOpts );
-		this.worldSpaceTarget = new RenderTarget( width, height, rtOpts );
+		} );
 
-		// Dispatch dimensions (8x8 workgroups)
+		// Dispatch dimensions (16x16 workgroups)
 		this._dispatchX = Math.ceil( width / 16 );
 		this._dispatchY = Math.ceil( height / 16 );
 
-		// Build compute nodes
 		this._buildScreenSpaceCompute();
-		this._buildWorldSpaceCompute();
 
 	}
 
@@ -222,95 +199,6 @@ export class MotionVector extends RenderStage {
 
 	}
 
-	/**
-	 * World-space velocity compute shader.
-	 *
-	 * Approximates world-space velocity from UV displacement,
-	 * scaled by deltaTime and velocityScale.
-	 */
-	_buildWorldSpaceCompute() {
-
-		const normalDepthTex = this._normalDepthTexNode;
-		const camWorldMat = this.cameraWorldMatrix;
-		const camProjInvMat = this.cameraProjectionMatrixInverse;
-		const prevVP = this.prevVP;
-		const isFirstFrameU = this.isFirstFrameU;
-		const deltaTime = this.deltaTime;
-		const velocityScale = this.velocityScale;
-		const resW = this.resolutionWidth;
-		const resH = this.resolutionHeight;
-		const outputTex = this._worldSpaceStorageTex;
-
-		const WG_SIZE = 16;
-
-		const computeFn = Fn( ( [ cwm, cpi ] ) => {
-
-			const gx = int( workgroupId.x ).mul( WG_SIZE ).add( int( localId.x ) );
-			const gy = int( workgroupId.y ).mul( WG_SIZE ).add( int( localId.y ) );
-
-			If( gx.lessThan( int( resW ) ).and( gy.lessThan( int( resH ) ) ), () => {
-
-				const nd = textureLoad( normalDepthTex, ivec2( gx, gy ) );
-				const linearDepth = nd.w;
-
-				const result = vec4( 0.0, 0.0, 0.0, 0.0 ).toVar();
-
-				// Skip first frame and sky (depth >= 65504 sentinel)
-				If( isFirstFrameU.lessThan( 0.5 ).and( linearDepth.lessThan( float( 6e4 ) ) ), () => {
-
-					// Current pixel UV
-					const currentUV = vec2(
-						float( gx ).add( 0.5 ).div( resW ),
-						float( gy ).add( 0.5 ).div( resH )
-					);
-					const worldPos = cameraRayPoint( currentUV, linearDepth, cwm, cpi, this.cameraRay );
-
-					// Project to previous frame
-					const prevClip = prevVP.mul( vec4( worldPos, 1.0 ) );
-					// Flip prevUV.y to match WebGPU convention
-					const prevNDC = prevClip.xy.div( prevClip.w );
-					const prevUV = vec2(
-						prevNDC.x.mul( 0.5 ).add( 0.5 ),
-						prevNDC.y.mul( - 0.5 ).add( 0.5 )
-					);
-
-					const valid = prevUV.x.greaterThanEqual( 0.0 )
-						.and( prevUV.x.lessThanEqual( 1.0 ) )
-						.and( prevUV.y.greaterThanEqual( 0.0 ) )
-						.and( prevUV.y.lessThanEqual( 1.0 ) );
-
-					// World-space velocity approximation from UV displacement
-					const motionUV = currentUV.sub( prevUV );
-					const worldVelocity = vec3(
-						motionUV.x.div( deltaTime ).mul( velocityScale ),
-						motionUV.y.div( deltaTime ).mul( velocityScale ),
-						0.0
-					);
-
-					result.assign( valid.select(
-						vec4( worldVelocity, 1.0 ),
-						vec4( 0.0, 0.0, 0.0, 0.5 )
-					) );
-
-				} );
-
-				textureStore(
-					outputTex,
-					uvec2( uint( gx ), uint( gy ) ),
-					result
-				).toWriteOnly();
-
-			} );
-
-		} );
-
-		this._worldSpaceComputeNode = computeFn( camWorldMat, camProjInvMat ).compute(
-			[ this._dispatchX, this._dispatchY, 1 ],
-			[ WG_SIZE, WG_SIZE, 1 ]
-		);
-
-	}
-
 	// ──────────────────────────────────────────────────
 	// Camera matrix management
 	// ──────────────────────────────────────────────────
@@ -387,16 +275,6 @@ export class MotionVector extends RenderStage {
 	// Pipeline lifecycle
 	// ──────────────────────────────────────────────────
 
-	setupEventListeners() {
-
-		this.on( 'pipeline:reset', () => {
-
-			this.reset();
-
-		} );
-
-	}
-
 	render( context ) {
 
 		if ( ! this.enabled ) return;
@@ -408,11 +286,6 @@ export class MotionVector extends RenderStage {
 		// Update camera matrices (CPU-side) — synced from PathTracer
 		this._updateCameraMatrices();
 
-		// Update isFirstFrame uniform
-		this.isFirstFrameU.value = this.isFirstFrame ? 1.0 : 0.0;
-
-		this.frameCount ++;
-
 		// Auto-size to match normalDepth
 		const img = normalDepthTex.image;
 		if ( img && img.width > 0 && img.height > 0 ) {
@@ -429,67 +302,31 @@ export class MotionVector extends RenderStage {
 		// Swap input texture (no shader recompile, just swap value)
 		this._normalDepthTexNode.value = normalDepthTex;
 
-		// Dispatch screen-space motion vector compute
 		this.renderer.compute( this._screenSpaceComputeNode );
 
-		// Dispatch world-space velocity compute
-		this.renderer.compute( this._worldSpaceComputeNode );
-
-		// Copy StorageTextures → RenderTargets (cross-dispatch reads from
+		// Copy StorageTexture → RenderTarget (cross-dispatch reads from
 		// StorageTexture return zeros — must use RenderTarget for downstream stages).
-		// srcRegion = active size; StorageTextures are over-allocated at 2048.
+		// srcRegion = active size; the StorageTexture is over-allocated at 2048.
 		this._srcRegion.max.set( this.screenSpaceTarget.width, this.screenSpaceTarget.height );
 		this.renderer.copyTextureToTexture( this._screenSpaceStorageTex, this.screenSpaceTarget.texture, this._srcRegion );
-		this.renderer.copyTextureToTexture( this._worldSpaceStorageTex, this.worldSpaceTarget.texture, this._srcRegion );
 
-		// Publish RenderTarget textures to context
 		context.setTexture( 'motionVector:screenSpace', this.screenSpaceTarget.texture );
-		context.setTexture( 'motionVector:worldSpace', this.worldSpaceTarget.texture );
-		context.setTexture( 'motionVector:motion', this.screenSpaceTarget.texture );
-
-		// Emit
-		this.emit( 'motionvector:computed', {
-			frame: this.frameCount,
-			isFirstFrame: this.isFirstFrame
-		} );
-
-		this.isFirstFrame = false;
 
 	}
 
-	/**
-	 * Reset — intentionally does NOT reset matricesInitialized.
-	 * Motion vectors must track camera motion across pipeline resets.
-	 */
-	// Free the 2048² StorageTextures when disabled (no consumer); three.js re-creates them on the next
+	// Free the 2048² StorageTexture when disabled (no consumer); three.js re-creates it on the next
 	// dispatch after re-enable. _syncGBufferStages additionally reseeds camera history on re-enable.
 	releaseGPUMemory() {
 
 		this._screenSpaceStorageTex?.dispose();
-		this._worldSpaceStorageTex?.dispose();
-		this.reset();
-
-	}
-
-	reset() {
-
-		if ( ! this.matricesInitialized ) {
-
-			this.isFirstFrame = true;
-
-		}
-
-		this.frameCount = 0;
 
 	}
 
 	setSize( width, height ) {
 
-		// StorageTextures stay at their max allocation (see constructor).
+		// The StorageTexture stays at its max allocation (see constructor).
 		this.screenSpaceTarget.setSize( width, height );
 		this.screenSpaceTarget.texture.needsUpdate = true;
-		this.worldSpaceTarget.setSize( width, height );
-		this.worldSpaceTarget.texture.needsUpdate = true;
 		this.resolutionWidth.value = width;
 		this.resolutionHeight.value = height;
 
@@ -502,57 +339,26 @@ export class MotionVector extends RenderStage {
 
 		}
 
-		if ( this._worldSpaceComputeNode ) {
-
-			this._worldSpaceComputeNode.dispatchSize = [ this._dispatchX, this._dispatchY, 1 ];
-
-		}
-
 	}
 
-	setVelocityScale( scale ) {
-
-		this.velocityScale.value = scale;
-
-	}
-
-	setDeltaTime( dt ) {
-
-		this.deltaTime.value = dt;
-
-	}
-
-	// Reserved-storage change (e.g. 4K toggle): recreate the MAX-preallocated StorageTextures at the new live
-	// reserved size + rebuild the compute nodes in place. Same stage object, so refs/wiring stay valid.
+	// Reserved-storage change (e.g. 4K toggle): recreate the MAX-preallocated StorageTexture at the new live
+	// reserved size + rebuild the compute node in place. Same stage object, so refs/wiring stay valid.
 	reallocateReservedStorage() {
 
 		this._screenSpaceComputeNode?.dispose();
-		this._worldSpaceComputeNode?.dispose();
 		this._screenSpaceStorageTex?.dispose();
-		this._worldSpaceStorageTex?.dispose();
-		const mk = () => {
-
-			const t = new StorageTexture( MAX_STORAGE_TEXTURE_SIZE, MAX_STORAGE_TEXTURE_SIZE );
-			t.type = HalfFloatType; t.format = RGBAFormat; t.minFilter = NearestFilter; t.magFilter = NearestFilter;
-			return t;
-
-		};
-
-		this._screenSpaceStorageTex = mk();
-		this._worldSpaceStorageTex = mk();
+		const t = new StorageTexture( MAX_STORAGE_TEXTURE_SIZE, MAX_STORAGE_TEXTURE_SIZE );
+		t.type = HalfFloatType; t.format = RGBAFormat; t.minFilter = NearestFilter; t.magFilter = NearestFilter;
+		this._screenSpaceStorageTex = t;
 		this._buildScreenSpaceCompute();
-		this._buildWorldSpaceCompute();
 
 	}
 
 	dispose() {
 
 		this._screenSpaceComputeNode?.dispose();
-		this._worldSpaceComputeNode?.dispose();
 		this._screenSpaceStorageTex?.dispose();
-		this._worldSpaceStorageTex?.dispose();
 		this.screenSpaceTarget?.dispose();
-		this.worldSpaceTarget?.dispose();
 		this._normalDepthTexNode?.dispose();
 
 	}

package/src/Stages/NormalDepth.js

@@ -13,7 +13,7 @@ import { computeUVCache, processNormal, processBump, processMetalnessRoughness,
 import { withSceneResources } from '../TSL/SceneResources.js';
 
 /**
- * NormalDepth — primary-ray G-buffer for SVGF gates.
+ * NormalDepth — primary-ray G-buffer for the denoisers' edge tests (NRD, the OIDN motion history).
  *
  * RGB = geometric world normal · 0.5 + 0.5, A = linear ray distance (sky=65504, the
  * max HalfFloat value — a finite sentinel so miss−miss depth diffs stay 0, not Inf−Inf=NaN).
@@ -70,7 +70,7 @@ export class NormalDepth extends RenderStage {
 		this._outputStorageTex.magFilter = NearestFilter;
 
 		// Shading-normal output (geometric normal perturbed by normal/bump map).
-		// Single buffer — only the spatial filter (current frame) consumes it.
+		// Single buffer — its readers (NRD, the OIDN history) use only the current frame.
 		this._shadingStorageTex = new StorageTexture( MAX_STORAGE_TEXTURE_SIZE, MAX_STORAGE_TEXTURE_SIZE );
 		this._shadingStorageTex.type = HalfFloatType;
 		this._shadingStorageTex.format = RGBAFormat;
@@ -137,7 +137,7 @@ export class NormalDepth extends RenderStage {
 			// _hasHistory is deliberately NOT cleared, mirroring MotionVector.reset(): the
 			// prev-frame G-buffer tracks camera motion, not accumulation, and a camera move
 			// resets accumulation every frame of a drag. Clearing it made render() overwrite
-			// prevRT with the current frame, so ASVGF's temporal gate could never reject.
+			// prevRT with the current frame, so the OIDN history could never see a disocclusion.
 			this._dirty = true;
 
 		} );
@@ -374,7 +374,7 @@ export class NormalDepth extends RenderStage {
 		this.renderer.copyTextureToTexture( this._shadingStorageTex, this._shadingRT.texture, this._srcRegion );
 		if ( this._leafRT ) this.renderer.copyTextureToTexture( this._leafStorageTex, this._leafRT.texture, this._srcRegion );
 
-		// First dispatch: seed prev from current so ASVGF doesn't see false
+		// First dispatch: seed prev from current so the history doesn't see false
 		// disocclusion on frame 1.
 		if ( ! this._hasHistory ) {
 
@@ -393,7 +393,7 @@ export class NormalDepth extends RenderStage {
 	}
 
 	// Free the 2048² StorageTextures when disabled (no consumer); three.js re-creates them on the next
-	// dispatch after re-enable, and reset() re-arms the dirty/history fast-path. See ASVGF.releaseGPUMemory.
+	// dispatch after re-enable, and reset() re-arms the dirty/history fast-path. See NRD.releaseGPUMemory.
 	releaseGPUMemory() {
 
 		this._outputStorageTex?.dispose();

package/src/Stages/PathTracer.js

@@ -28,6 +28,7 @@ import {
 } from '../TSL/SortGlobalKernels.js';
 import { ENGINE_DEFAULTS } from '../EngineDefaults.js';
 import { MAX_STORAGE_TEXTURE_SIZE } from '../Processor/StorageTexturePool.js';
+import { readPixels } from '../Processor/TextureReadback.js';
 import { ISSUE_CODES } from '../EngineIssues.js';
 import { createLogger, fmt } from '../utils/Logger.js';
 import { deviceMemoryGB } from '../Processor/HostMemory.js';
@@ -76,7 +77,7 @@ export class PathTracer extends PathTracerStage {
 		this._auxGBufferUniform = uniform( 0, 'uint' );
 		// Clean-aux mode: temporally accumulate + renormalize the aux NORMAL (like albedo) so a clean-aux
 		// OIDN model (calb_cnrm/high, alb_nrm/balanced) gets the prefiltered-ish normal it expects instead
-		// of the point-sampled per-frame value that leaks noise. Off for fast/ASVGF (they want the bump normal).
+		// of the point-sampled per-frame value that leaks noise. Off otherwise: the fast model wants the bump normal.
 		this._cleanAuxNormalEnabled = false;
 		this._cleanAuxNormalUniform = uniform( 0, 'uint' );
 		// Aux MRT accumulates on an epoch of its own: enabling the denoiser at colour frame N must not leave
@@ -758,16 +759,7 @@ export class PathTracer extends PathTracerStage {
 		const height = pool.renderHeight;
 		const pixels = width * height;
 
-		const readAttachment = async index => {
-
-			const padded = await this.renderer.readRenderTargetPixelsAsync( pool.readTarget, 0, 0, width, height, index );
-			const stride = Math.ceil( width * 16 / 256 ) * 64;
-			if ( stride === width * 4 ) return new Float32Array( padded.buffer, padded.byteOffset, pixels * 4 ).slice();
-			const tight = new Float32Array( pixels * 4 );
-			for ( let y = 0; y < height; y ++ ) tight.set( padded.subarray( y * stride, y * stride + width * 4 ), y * width * 4 );
-			return tight;
-
-		};
+		const readAttachment = index => readPixels( this.renderer, pool.readTarget, width, height, index );
 
 		const readBuffer = async ( attr, Type ) => attr ? new Type( await this.renderer.getArrayBufferAsync( attr, null, 0, pixels * 4 ) ) : null;
 		const aux = this._auxGBufferEnabled && this._auxSamples > 0;

package/src/Stages/PathTracerStage.js

@@ -185,9 +185,6 @@ export class PathTracerStage extends RenderStage {
 		this.renderModeChangeDelay = 50;
 		this.pendingRenderMode = null;
 
-		// Track interaction mode state for accumulation
-		this.lastInteractionModeState = false;
-
 		// Track changes for event emission
 		this.cameraChanged = false;
 		// When the view was last moved, for viewIsChanging.
@@ -372,12 +369,7 @@ export class PathTracerStage extends RenderStage {
 			},
 			onEnter: () => this.emit( 'pathtracer:interactionStart' ),
 			onExit: () => this.emit( 'pathtracer:interactionEnd' ),
-			onReset: () => {
-
-				this.reset();
-				this.emit( 'pathtracer:viewpointChanged' );
-
-			}
+			onReset: () => this.reset(),
 		} );
 
 	}
@@ -561,8 +553,7 @@ export class PathTracerStage extends RenderStage {
 
 		// lastRenderMode is deliberately NOT invalidated here — clearing it made
 		// resetHistoryOnRenderModeChange see a phantom mode change 50 ms after every reset, wiping
-		// ASVGF's history. A real mode change is still caught by the renderMode comparison.
-		this.lastInteractionModeState = false;
+		// the denoisers' history. A real mode change is still caught by the renderMode comparison.
 
 		// Only deterministic mode and lockstep readbacks rewind the seed axis; see _pinSeedToFrame.
 		if ( this._pinSeedToFrame || this._lockstep ) this._seedTick = 0;
@@ -1472,7 +1463,6 @@ export class PathTracerStage extends RenderStage {
 	_updateAccumulationUniforms( frameValue ) {
 
 		const currentInteractionMode = this.cameraOptimizer?.isInInteractionMode() ?? false;
-		this.lastInteractionModeState = currentInteractionMode;
 
 		if ( this.accumulationEnabled ) {
 
@@ -1512,7 +1502,6 @@ export class PathTracerStage extends RenderStage {
 		// Not the same as the context's own `accumulatedFrames`, which counts pipeline renders — this
 		// freezes when the frame retires or the camera moves, which is what a denoiser needs.
 		context.setState( 'pathtracer:samples', this.frameCount );
-		context.setState( 'interactionMode', this.cameraOptimizer?.isInInteractionMode() ?? false );
 		context.setState( 'renderMode', this.renderMode.value );
 
 	}
@@ -1557,7 +1546,7 @@ export class PathTracerStage extends RenderStage {
 
 	}
 
-	// ===== ASVGF DENOISING MANAGEMENT =====
+	// ===== DENOISER HISTORY =====
 
 	resetHistoryOnRenderModeChange( renderMode ) {
 
@@ -1576,9 +1565,7 @@ export class PathTracerStage extends RenderStage {
 				if ( this.pendingRenderMode !== null && this.pendingRenderMode !== this.lastRenderMode ) {
 
 					this.lastRenderMode = this.pendingRenderMode;
-					// History from the previous mode is not comparable. temporalAlpha is NOT
-					// touched here — it is owned by ASVGF_QUALITY_PRESETS, and overwriting it
-					// with a hardcoded value meant `medium` and `high` never took effect.
+					// History from the previous mode is not comparable.
 					this.emit( 'pipeline:historyReset' );
 
 				}