rayzee 7.12.1 → 7.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rayzee",
-  "version": "7.12.1",
+  "version": "7.14.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/Processor/LightSerializer.js

@@ -90,6 +90,7 @@ export class LightSerializer {
 
 	addDirectionalLight( light ) {
 
+		if ( ! light.visible ) return; // Skip hidden lights
 		if ( light.intensity <= 0.0 ) return; // Skip zero intensity lights
 
 		light.updateMatrixWorld();
@@ -146,6 +147,7 @@ export class LightSerializer {
 
 	addRectAreaLight( light ) {
 
+		if ( ! light.visible ) return; // Skip hidden lights
 		if ( light.intensity <= 0.0 ) return; // Skip zero intensity lights
 
 		light.updateMatrixWorld();
@@ -190,6 +192,7 @@ export class LightSerializer {
 
 	addPointLight( light ) {
 
+		if ( ! light.visible ) return; // Skip hidden lights
 		if ( light.intensity <= 0.0 ) return; // Skip zero intensity lights
 
 		light.updateMatrixWorld();
@@ -218,6 +221,7 @@ export class LightSerializer {
 
 	addSpotLight( light ) {
 
+		if ( ! light.visible ) return; // Skip hidden lights
 		if ( light.intensity <= 0.0 ) return; // Skip zero intensity lights
 
 		light.updateMatrixWorld();

package/src/managers/LightManager.js

@@ -330,6 +330,7 @@ export class LightManager extends EventDispatcher {
 			uuid: light.uuid,
 			name: light.name,
 			type: light.type,
+			visible: light.visible,
 			intensity: light.intensity,
 			color: `#${light.color.getHexString()}`,
 			position: [ light.position.x, light.position.y, light.position.z ],