rayzee 11.6.0 → 11.7.0

package/dist/{sceneCachePolicy-W5PLbzuR.js → sceneCachePolicy-B9w3BnaP.js}

@@ -1594,7 +1594,7 @@ var vt = class {
 			samples: this.samples.slice()
 		};
 	}
-}, yt = "11.6.0", $ = 1e4, bt = 15e5;
+}, yt = "11.7.0", $ = 1e4, bt = 15e5;
 function xt(e, t, n = $) {
 	return e >= n && t / bt < e / 3;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rayzee",
-  "version": "11.6.0",
+  "version": "11.7.0",
   "type": "module",
   "description": "Real-time WebGPU path tracing engine built on Three.js",
   "main": "dist/rayzee.umd.js",

package/src/Passes/OIDNDenoiser.js

@@ -55,8 +55,8 @@ const MODEL_CONFIG = {
 	DEFAULT_OPTIONS: {
 		enableOIDN: true,
 		oidnQuality: 'fast',
-		// A cap on the frame, not a tile size: a frame that fits is one tile, with no overlap.
-		// It bounds the network's activation memory (~430 MB at 1024²).
+		// A cap on the frame, not a tile size: a frame no larger in area than this square is one
+		// tile, with no overlap. The area bounds the network's activation memory.
 		tileSize: 1024
 	}
 };
@@ -382,16 +382,14 @@ export class OIDNDenoiser extends EventDispatcher {
 	 */
 	_resolveTileSize() {
 
-		const longest = Math.max( this._renderWidth, this._renderHeight );
-		if ( ! longest ) return this.maxTileSize;
+		if ( ! this._renderWidth || ! this._renderHeight ) return this.maxTileSize;
 
-		// The cap is on the frame, so the border never splits a frame that fits one tile.
-		if ( longest <= this.maxTileSize ) {
-
-			const input = oidnInputSize( this._renderWidth, this._renderHeight );
-			return Math.max( input.width, input.height );
-
-		}
+		// One tile for any frame no larger in area than the square the cap allows: oidn-web's memory
+		// follows the tile's area, not its longest side, so a wide frame needs no split. The cap is on
+		// the frame, so the border never splits a frame that fits.
+		const input = oidnInputSize( this._renderWidth, this._renderHeight );
+		const largest = oidnInputSize( this.maxTileSize, this.maxTileSize );
+		if ( input.width * input.height <= largest.width * largest.height ) return Math.max( input.width, input.height );
 
 		return Math.max( OIDN_TILE_ALIGNMENT, Math.floor( this.maxTileSize / OIDN_TILE_ALIGNMENT ) * OIDN_TILE_ALIGNMENT );
 

package/src/PathTracerApp.js

@@ -2,11 +2,7 @@ import { Box3, Vector3 } from 'three';
 import { RayzeeRenderer, describeAdapter, RENDER_CHECKPOINT_VERSION } from './RayzeeRenderer.js';
 import { NormalDepth } from './Stages/NormalDepth.js';
 import { MotionVector } from './Stages/MotionVector.js';
-import { ASVGF } from './Stages/ASVGF.js';
 import { NRD } from './Stages/NRD.js';
-import { Variance } from './Stages/Variance.js';
-import { BilateralFilter } from './Stages/BilateralFilter.js';
-import { EdgeFilter } from './Stages/EdgeFilter.js';
 import { AutoExposure, AUTO_EXPOSURE_DEFAULTS } from './Stages/AutoExposure.js';
 import { LocalExposure, LOCAL_EXPOSURE_DEFAULTS } from './Stages/LocalExposure.js';
 import { PRODUCTION_RENDER_CONFIG, INTERACTIVE_RENDER_CONFIG, modePresetSettings } from './EngineDefaults.js';
@@ -151,17 +147,12 @@ export class PathTracerApp extends RayzeeRenderer {
 		const { renderer, stages } = this;
 		stages.normalDepth = new NormalDepth( renderer, { pathTracer: stages.pathTracer } );
 		stages.motionVector = new MotionVector( renderer, this.camera, { pathTracer: stages.pathTracer } );
-		stages.asvgf = new ASVGF( renderer, { enabled: false } );
 		stages.nrd = new NRD( renderer, { enabled: false, pathTracer: stages.pathTracer } );
-		stages.variance = new Variance( renderer, { enabled: false } );
-		stages.bilateralFilter = new BilateralFilter( renderer, { enabled: false } );
-		stages.edgeFilter = new EdgeFilter( renderer, { enabled: false } );
 		stages.autoExposure = new AutoExposure( renderer, { enabled: AUTO_EXPOSURE_DEFAULTS.autoExposure } );
 		stages.localExposure = new LocalExposure( renderer, { enabled: LOCAL_EXPOSURE_DEFAULTS.localExposure } );
 
 		return [
-			stages.normalDepth, stages.motionVector, stages.nrd, stages.asvgf,
-			stages.variance, stages.bilateralFilter, stages.edgeFilter, stages.autoExposure, stages.localExposure,
+			stages.normalDepth, stages.motionVector, stages.nrd, stages.autoExposure, stages.localExposure,
 		];
 
 	}
@@ -318,7 +309,7 @@ export class PathTracerApp extends RayzeeRenderer {
 
 	_displaySources() {
 
-		return [ 'oidn:output', 'edgeFiltering:output', 'bilateralFiltering:output', 'asvgf:output', 'nrd:output' ];
+		return [ 'oidn:output', 'nrd:output' ];
 
 	}
 
@@ -338,8 +329,10 @@ export class PathTracerApp extends RayzeeRenderer {
 
 				this.cameraManager.applyProjection( value );
 				// MotionVector unprojects through projectionMatrixInverse, which is meaningless once every pixel is its
-				// own direction: fall back to the spatial-only denoiser rather than leaving no strategy.
-				if ( value === 'equirectangular' && this.denoisingManager?.requiresMotionVectors ) this.denoisingManager.setDenoiserStrategy( 'edgeaware' );
+				// own direction: hand the view to OIDN, which needs none, rather than leaving no denoiser.
+				if ( value === 'equirectangular' && this.denoisingManager?.requiresMotionVectors ) this.denoisingManager.setDenoiserStrategy( 'oidn' );
+				// OIDN's motion history is off in a panorama and back on outside one.
+				else this.denoisingManager?._syncGBufferStages?.();
 
 			},
 		};
@@ -1106,11 +1099,7 @@ export class PathTracerApp extends RayzeeRenderer {
 				pathTracer: this.stages.pathTracer,
 				normalDepth: this.stages.normalDepth,
 				motionVector: this.stages.motionVector,
-				asvgf: this.stages.asvgf,
 				nrd: this.stages.nrd,
-				variance: this.stages.variance,
-				bilateralFilter: this.stages.bilateralFilter,
-				edgeFilter: this.stages.edgeFilter,
 				autoExposure: this.stages.autoExposure,
 				compositor: this.stages.compositor,
 			},

package/src/Pipeline/BindingAudit.js

@@ -3,13 +3,12 @@
  *
  * Two TextureNodes still holding the default EmptyTexture when a stage's kernel is first
  * compiled can share one GPU binding, which then resolves to whichever is assigned last.
- * Nothing throws — the aliased node reads a real texture, just not its own. BilateralFilter
- * shipped this way, reading ASVGF's history counter as its variance.
+ * Nothing throws — the aliased node reads a real texture, just not its own.
  *
  * Rule enforced: every TextureNode a kernel reads must hold its real texture before that
  * kernel is first dispatched. StorageTexture-typed nodes are exempt — `textureLoad` codegen
  * only emits the required `level` parameter while the node still holds EmptyTexture, so those
- * are deliberately bound after compile (see ASVGF.render).
+ * are deliberately bound after compile.
  *
  * Off by default; the bench harness turns it on.
  */

package/src/Pipeline/PipelineContext.js

@@ -43,7 +43,6 @@ export class PipelineContext {
 
 			// Render modes
 			renderMode: 0, // 0 = interactive, 1 = production (full-frame in both)
-			interactionMode: false,
 			isComplete: false,
 
 			// Tile rendering

package/src/Pipeline/RenderPipeline.js

@@ -23,8 +23,7 @@ import { ISSUE_CODES } from '../EngineIssues.js';
  *
  * // Add stages in execution order
  * pipeline.addStage(new PathTracer(...));
- * pipeline.addStage(new ASVGF(...));
- * pipeline.addStage(new EdgeFilter(...));
+ * pipeline.addStage(new NRD(...));
  *
  * // Render all stages
  * pipeline.render(writeBuffer);

package/src/Pipeline/RenderStage.js

@@ -12,7 +12,7 @@ export const StageExecutionMode = {
 
 	/**
 	 * PER_CYCLE - Execute only when tile rendering cycle completes
-	 * Use for: Post-processing, denoisers, filters (ASVGF, EdgeAwareFiltering, OIDN)
+	 * Use for: Post-processing, denoisers, filters (NRD, OIDN)
 	 *
 	 * Complete cycle means:
 	 * - Progressive mode (renderMode=0): Every frame

package/src/Processor/PackedRayBuffer.js

@@ -424,7 +424,7 @@ export const writeMediumStack = ( buf, id, stackDepth, transTraversals, ior1, io
 		), ior1, ior2, ior3 ) );
 
 // Region 7: Beer-Lambert sigmaA (.xyz) of the active medium + DDFA feature-throughput (.w).
-// .xyz absorption is gated on stackDepth>0; .w carries the OIDN/ASVGF see-through aux tint (see below).
+// .xyz absorption is gated on stackDepth>0; .w carries the OIDN/NRD see-through aux tint (see below).
 // Both writers RMW-preserve the other half so sigmaA (live in glass) and featTP never clobber each other.
 export const readMediumSigmaA = ( buf, id ) => buf.element( soa( id, RAY.MEDIUM_SIGMA_A ) ).xyz;
 
@@ -436,7 +436,7 @@ export const writeMediumSigmaA = ( buf, id, sigmaA ) => {
 };
 
 // DDFA (Deferred Denoising-Feature Aux) feature-throughput: a clean per-ray tint carried through smooth
-// glass/mirror, committed into the OIDN/ASVGF albedo guide at the first diffuse-enough surface. Rides the
+// glass/mirror, committed into the OIDN/NRD albedo guide at the first diffuse-enough surface. Rides the
 // otherwise-dead MEDIUM_SIGMA_A.w, packed 10/10/10 into 30 bits (top 2 bits zero ⇒ the float bit-pattern is
 // always finite — never NaN/Inf). LDR [0,1] per channel; final albedo re-quantizes to unorm16 anyway.
 const pack30 = ( tp ) => {

package/src/Processor/StorageTexturePool.js

@@ -7,7 +7,7 @@
  *  - 1 MRT RenderTarget (3 attachments) used as the readable copy
  *  - After each compute dispatch, copyTextureToTexture() transfers data
  *    from StorageTextures → RenderTarget textures
- *  - Downstream stages (ASVGF, display, OIDN) read from the RenderTarget
+ *  - Downstream stages (NRD, display, OIDN) read from the RenderTarget
  *  - Previous-frame reads in the path tracer sample from RenderTarget textures
  *    via texture() (not storageTexture().toReadOnly())
  */

package/src/RayzeeRenderer.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' } = {} ) {

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,