rayzee 7.22.0 → 7.22.2

package/package.json

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

package/src/PathTracerApp.js

@@ -146,7 +146,8 @@ export class PathTracerApp extends EventDispatcher {
 		// ── State ──
 		this.isInitialized = false;
 		this.pauseRendering = false;
-		this.pathTracerEnabled = true;
+		this._pathTracerEnabled = true;
+		this._rasterPrecompile = null;
 		this.animationManagerId = null;
 		this.needsReset = false;
 		this._loadingInProgress = false;
@@ -841,21 +842,16 @@ export class PathTracerApp extends EventDispatcher {
 		this.stages.pathTracer.setupMaterial();
 		timer.end( 'Material setup (TSL compile)' );
 
-		// Front-load raster pipeline creation (compileAsync yields to main thread, r184+) so the first
-		// animate frame is snappy. Wavefront compute kernels compile lazily on their first dispatch.
-		timer.start( 'Pipeline precompile' );
-		try {
-
-			await this.renderer.compileAsync( this.meshScene, this.cameraManager.camera );
+		this._rasterPrecompile = null;
 
-		} catch ( err ) {
+		if ( ! this._pathTracerEnabled ) {
 
-			log.warn( 'raster fallback precompile failed', err );
+			timer.start( 'Pipeline precompile' );
+			await this.precompileRaster();
+			timer.end( 'Pipeline precompile' );
 
 		}
 
-		timer.end( 'Pipeline precompile' );
-
 		// Wait for CDF
 		if ( cdfPromise ) {
 
@@ -1864,6 +1860,42 @@ export class PathTracerApp extends EventDispatcher {
 
 	}
 
+	/**
+	 * When false, `animate()` rasters `meshScene` instead of path tracing. Those raster pipelines
+	 * are compiled on the switch rather than at load — `compileAsync` costs seconds on a
+	 * many-material model, and path tracing, the default, never uses them.
+	 * @returns {boolean}
+	 */
+	get pathTracerEnabled() {
+
+		return this._pathTracerEnabled;
+
+	}
+
+	set pathTracerEnabled( value ) {
+
+		this._pathTracerEnabled = value;
+		if ( ! value ) this.precompileRaster();
+
+	}
+
+	/**
+	 * Warms the raster fallback's pipelines. Once per loaded model; concurrent callers await the
+	 * same compile rather than racing past a flag set before it finishes.
+	 * @returns {Promise<void>}
+	 */
+	precompileRaster() {
+
+		if ( ! this.renderer || ! this.meshScene ) return Promise.resolve();
+
+		this._rasterPrecompile ??= this.renderer
+			.compileAsync( this.meshScene, this.cameraManager.camera )
+			.catch( err => log.warn( 'raster fallback precompile failed', err ) );
+
+		return this._rasterPrecompile;
+
+	}
+
 	/**
 	 * Whether a model/environment load is currently in progress.
 	 * @returns {boolean}

package/src/Processor/BVHBuilder.js

@@ -96,8 +96,9 @@ export class BVHBuilder {
 			reinsertionIterations: 0
 		};
 
-		// Treelet optimization configuration
-		this.enableTreeletOptimization = true;
+		// Off: repairs LBVH trees, so on this binned-SAH build it buys 0.005% tree SAH for 72%
+		// of build time.
+		this.enableTreeletOptimization = false;
 		this.treeletSize = 5;
 		this.treeletOptimizationPasses = 1;
 		this.treeletMinImprovement = 0.02;

package/src/Processor/SceneProcessor.js

@@ -48,6 +48,8 @@ export class SceneProcessor {
 			enableTextureCache: true,
 			maxConcurrentTextureTasks: Math.min( navigator.hardwareConcurrency || 4, 6 ),
 			// Treelet optimization configuration
+			// Keep: `_buildBVH` sends `enabled: value !== false`, so undefined re-enables treelets.
+			enableTreeletOptimization: false,
 			treeletSize: 7, // 7 nodes gives 315 topologies for optimal enumeration
 			treeletOptimizationPasses: 1,
 			treeletMinImprovement: 0.01, // Minimum SAH improvement threshold