rayzee 7.12.0 → 7.13.0

package/package.json

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

package/src/PathTracerApp.js

@@ -146,6 +146,9 @@ export class PathTracerApp extends EventDispatcher {
 		this._loadingInProgress = false;
 		this._needsDisplayRefresh = false;
 		this._paused = false;
+		// Emissive-triangle NEE auto-follows the scene (on when it has emissive geometry)
+		// until the user toggles it explicitly; reset on each fresh model load.
+		this._emissiveSamplingUserSet = false;
 
 		// Render completion tracking
 		this.completion = new CompletionTracker();
@@ -759,6 +762,9 @@ export class PathTracerApp extends EventDispatcher {
 		try {
 
 			await loadFn();
+			// A fresh model re-establishes the emissive-sampling auto-default (incremental
+			// rebuilds — add/remove object, texture reprocess — preserve the user's choice).
+			this._emissiveSamplingUserSet = false;
 			// Replace-load clears any dynamically-appended models — but only AFTER
 			// loadFn() succeeds, so a failed load leaves the current scene intact.
 			// (The old primary was already released by releaseTargetModel() in loadFn.)
@@ -871,6 +877,16 @@ export class PathTracerApp extends EventDispatcher {
 		this.settings.set( 'groundProjectionLevel', sceneMinY, { reset: false } );
 		this.settings.set( 'groundCatcherHeight', sceneMinY, { reset: false } );
 
+		// Auto-follow the scene: enable emissive-triangle NEE when the scene has emissive
+		// geometry, disable it when it doesn't — unless the user set the toggle explicitly.
+		// Runs before applyAll()/SceneRebuild so the uniform and UI both pick up the new value.
+		if ( ! this._emissiveSamplingUserSet ) {
+
+			const hasEmissive = ( this._sdf?.emissiveTriangleCount ?? 0 ) > 0;
+			this.settings.set( 'enableEmissiveTriangleSampling', hasEmissive, { reset: false } );
+
+		}
+
 		// Apply all settings to stages in one shot
 		timer.start( 'Apply settings' );
 		this.settings.applyAll();
@@ -1512,6 +1528,28 @@ export class PathTracerApp extends EventDispatcher {
 
 	}
 
+	/**
+	 * Explicitly enable/disable emissive-triangle next-event estimation. Marks the
+	 * setting as user-controlled so scene rebuilds stop auto-following the scene's
+	 * emissive content; the next fresh model load re-arms the auto-default.
+	 * @param {boolean} enabled
+	 */
+	setEmissiveTriangleSampling( enabled ) {
+
+		this._emissiveSamplingUserSet = true;
+		this.settings.set( 'enableEmissiveTriangleSampling', enabled );
+
+	}
+
+	/**
+	 * @returns {boolean} True if the current scene contains emissive geometry.
+	 */
+	hasEmissiveGeometry() {
+
+		return ( this._sdf?.emissiveTriangleCount ?? 0 ) > 0;
+
+	}
+
 	/**
 	 * Update per-mesh visibility without rebuilding the scene.
 	 * Walks the parent chain to resolve world-space visibility.

package/src/TSL/PathTracerCore.js

@@ -228,6 +228,12 @@ export const generateSampledDirection = Fn( ( [
 
 export const regularizePathContribution = /*@__PURE__*/ wgslFn( `
 	fn regularizePathContribution( contribution: vec3f, pathLength: f32, fireflyThreshold: f32, frame: i32 ) -> vec3f {
+		// Indirect-only clamp: pathLength 0 is a direct/primary contribution (bounce-0 hit, direct NEE,
+		// or a directly-viewed backdrop/sun) — that is signal, not a firefly, and clamping it darkens
+		// legitimately bright pixels. Fireflies arise on indirect bounces, so only suppress pathLength>=1.
+		if ( pathLength < 0.5 ) {
+			return contribution;
+		}
 		let threshold = calculateFireflyThreshold( fireflyThreshold, i32( pathLength ), frame );
 		return applySoftSuppressionRGB( contribution, threshold, 0.5f );
 	}