rayzee 7.19.0 → 7.19.1

package/package.json

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

package/src/PathTracerApp.js

@@ -1215,10 +1215,12 @@ export class PathTracerApp extends EventDispatcher {
 	 *
 	 * MUST be called before the pipeline/stages are constructed (they pre-allocate at this value and cannot
 	 * resize). Calling it after init only takes effect on the next full pipeline (re)build.
-	 * @param {number} requestedPx desired reserved size (longest edge)
+	 * @param {number}  requestedPx desired reserved size (longest edge)
+	 * @param {Object}  [opts]
+	 * @param {boolean} [opts.allowLower=false] permit lowering, paying a rebuild, to reclaim VRAM
 	 * @returns {number} the applied reserved size
 	 */
-	setReservedRenderResolution( requestedPx ) {
+	setReservedRenderResolution( requestedPx, { allowLower = false } = {} ) {
 
 		const limits = this.renderer?.backend?.device?.limits;
 		const maxBinding = limits?.maxStorageBufferBindingSize || ( 128 * 1024 * 1024 );
@@ -1227,7 +1229,11 @@ export class PathTracerApp extends EventDispatcher {
 		const deviceSafeMax = ( deviceMemGB >= 8 && maxBinding >= 1024 * 1024 * 1024 )
 			? MAX_RESERVABLE_RENDER_SIZE : 2048;
 		const prev = MAX_STORAGE_TEXTURE_SIZE;
-		const applied = setReservedRenderSize( Math.min( requestedPx, deviceSafeMax ) );
+
+		// Monotonic up: UI-driven callers request whatever the current view needs, so honouring decreases made
+		// the reserve oscillate on every preview↔render switch and paid a full kernel rebuild each time.
+		const target = allowLower ? requestedPx : Math.max( requestedPx, prev );
+		const applied = setReservedRenderSize( Math.min( target, deviceSafeMax ) );
 
 		// If the pipeline is already built and the reserved size changed, re-init the reserved GPU storage in
 		// place: each stage recreates its pre-allocated StorageTextures at the new size + rebuilds its compute
@@ -1240,6 +1246,17 @@ export class PathTracerApp extends EventDispatcher {
 			this.pauseRendering = true;
 			try {
 
+				// Lowering below the live backing store makes copyToReadTargets read past the end of the
+				// (now smaller) write textures — a GPUValidationError. Shrink the backing store first.
+				// renderer.setSize, not setCanvasSize/onResize: those also rewrite camera.aspect.
+				const backing = this.renderer.domElement;
+				if ( backing.width > applied || backing.height > applied ) {
+
+					this.renderer.setSize(
+						Math.min( backing.width, applied ), Math.min( backing.height, applied ), false );
+
+				}
+
 				for ( const stage of Object.values( this.stages ) ) stage?.reallocateReservedStorage?.();
 
 			} finally {
@@ -1257,6 +1274,16 @@ export class PathTracerApp extends EventDispatcher {
 
 	}
 
+	/**
+	 * The current reserved (pre-allocated) square render size in px.
+	 * @returns {number}
+	 */
+	getReservedRenderResolution() {
+
+		return MAX_STORAGE_TEXTURE_SIZE;
+
+	}
+
 	/**
 	 * Guard against render resolutions the compute pipeline can't support.
 	 * Per-resolution StorageTextures are pre-allocated at MAX_STORAGE_TEXTURE_SIZE
@@ -1344,28 +1371,27 @@ export class PathTracerApp extends EventDispatcher {
 
 		this.cameraManager.controls.enabled = ! isProduction;
 
-		// Batch uniform updates via settings
+		// Anything with a SETTING_ROUTES entry must go through settings, not setUniform: set() early-returns on
+		// `prev === value`, so a uniform written behind the map leaves it stale and the next set() silently no-ops.
 		this.settings.setMany( {
 			maxSamples: config.maxSamples,
 			maxBounces: config.bounces,
 			transmissiveBounces: config.transmissiveBounces,
 			maxSubsurfaceSteps: config.maxSubsurfaceSteps,
+			enableAlphaShadows: config.enableAlphaShadows ?? false,
+			// Tier-1 convergence early-stop
+			useAdaptiveSampling: config.useAdaptiveSampling ?? false,
+			noiseThreshold: config.noiseThreshold ?? DEFAULT_STATE.noiseThreshold,
+			adaptiveStopFraction: config.adaptiveStopFraction ?? DEFAULT_STATE.adaptiveStopFraction,
+			adaptiveMinSamples: config.adaptiveMinSamples ?? DEFAULT_STATE.adaptiveMinSamples,
+			// Tier-2 per-pixel freeze
+			usePixelFreeze: config.usePixelFreeze ?? false,
+			pixelFreezeThreshold: config.pixelFreezeThreshold ?? DEFAULT_STATE.pixelFreezeThreshold,
+			pixelFreezeStability: config.pixelFreezeStability ?? DEFAULT_STATE.pixelFreezeStability,
 		}, { silent: true } );
 
+		// renderMode has no SETTING_ROUTES entry
 		this.stages.pathTracer?.setUniform( 'renderMode', parseInt( config.renderMode ) );
-		this.stages.pathTracer?.setUniform( 'enableAlphaShadows', config.enableAlphaShadows ?? false );
-
-		// Tier-1 convergence early-stop (live uniforms, no kernel rebuild). Threshold/min-samples fall back to
-		// engine defaults when a config doesn't override them.
-		this.stages.pathTracer?.setUniform( 'useAdaptiveSampling', config.useAdaptiveSampling ?? false );
-		this.stages.pathTracer?.setUniform( 'noiseThreshold', config.noiseThreshold ?? DEFAULT_STATE.noiseThreshold );
-		this.stages.pathTracer?.setUniform( 'adaptiveStopFraction', config.adaptiveStopFraction ?? DEFAULT_STATE.adaptiveStopFraction );
-		this.stages.pathTracer?.setUniform( 'adaptiveMinSamples', config.adaptiveMinSamples ?? DEFAULT_STATE.adaptiveMinSamples );
-
-		// Tier-2 per-pixel freeze (per-mode; falls back off when a config doesn't set it).
-		this.stages.pathTracer?.setUniform( 'usePixelFreeze', config.usePixelFreeze ?? false );
-		this.stages.pathTracer?.setUniform( 'pixelFreezeThreshold', config.pixelFreezeThreshold ?? DEFAULT_STATE.pixelFreezeThreshold );
-		this.stages.pathTracer?.setUniform( 'pixelFreezeStability', config.pixelFreezeStability ?? DEFAULT_STATE.pixelFreezeStability );
 
 		this.stages.pathTracer?.updateCompletionThreshold?.();
 

package/src/Stages/PathTracer.js

@@ -769,8 +769,11 @@ export class PathTracer extends PathTracerStage {
 
 		if ( ! this._packedBuffers || ! ( this.materialData?.materialCount > 0 ) ) return;
 
-		const w = this.storageTextures.renderWidth || 1;
-		const h = this.storageTextures.renderHeight || 1;
+		// Clamp into the (possibly just-lowered) reserve: create() sizes the write StorageTextures at
+		// MAX_STORAGE_TEXTURE_SIZE but the readTarget at what's passed here, and the tracked render size still
+		// holds the pre-change value — unclamped, copyToReadTargets reads past the write textures.
+		const w = Math.min( this.storageTextures.renderWidth || 1, MAX_STORAGE_TEXTURE_SIZE );
+		const h = Math.min( this.storageTextures.renderHeight || 1, MAX_STORAGE_TEXTURE_SIZE );
 
 		// Recreate the MRT pool at the new reserved size (create() reallocates the write StorageTextures at the
 		// live MAX_STORAGE_TEXTURE_SIZE; the read RenderTarget follows the current render size).

package/src/managers/OverlayManager.js

@@ -382,6 +382,10 @@ export class OverlayManager {
 
 		}
 
+		// Un-park BEFORE measuring: a display:none canvas reports clientWidth 0, which returns early below and
+		// skips the un-park at the end — so once parked the HUD could never come back.
+		if ( canvas.style.display !== '' ) canvas.style.display = '';
+
 		// Helpers draw in CSS-pixel coordinates of the unscaled layout box; the
 		// backing store is sized off the on-screen box, so nothing is drawn below
 		// view resolution.