rayzee 9.4.0 → 9.4.2

package/package.json

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

package/src/EngineDefaults.js

@@ -91,12 +91,7 @@ export const ENGINE_DEFAULTS = {
 	globalIlluminationIntensity: 1,
 
 	// Environment Mode System
-	environmentMode: 'hdri', // 'hdri' | 'procedural' | 'gradient' | 'color'
-
-	// Gradient Sky Colors
-	gradientZenithColor: '#0077BE',
-	gradientHorizonColor: '#87CEEB',
-	gradientGroundColor: '#654321',
+	environmentMode: 'hdri', // 'hdri' | 'procedural' | 'color'
 
 	// Solid Color Sky
 	solidSkyColor: '#87CEEB',

package/src/PathTracerApp.js

@@ -1408,7 +1408,7 @@ export class PathTracerApp extends EventDispatcher {
 		this._tagPrimarySceneObject();
 
 		const timer = new BuildTimer( '', { namespace: 'scene', level: 'info' } );
-		// meshScene.environment is the HDRI slot: a sky, gradient or colour in use outlives the model.
+		// meshScene.environment is the HDRI slot: a sky or colour in use outlives the model.
 		const hdri = () => this.stages.pathTracer.environment.envParams.mode === 'hdri' ? this.meshScene.environment : null;
 		const environmentTexture = hdri();
 

package/src/Processor/SimpleSky.js

@@ -6,12 +6,11 @@ import {
 /**
  * SimpleSky
  *
- * CPU-based gradient and solid colour environment texture generator.
+ * CPU-based solid colour environment texture generator.
  * Produces a DataTexture directly — no render targets, no GPU readback,
  * no resource lifecycle issues with the WebGPU backend.
  *
  * Public API matches SimpleSkyRenderer:
- *   renderGradient(params) → texture
  *   renderSolid(params)    → texture
  */
 
@@ -36,66 +35,6 @@ export class SimpleSky {
 
 	}
 
-	/**
-	 * Generate a three-colour vertical gradient sky.
-	 * @param {Object} params - { zenithColor, horizonColor, groundColor } (Three.js Color)
-	 * @returns {DataTexture} Equirectangular gradient texture
-	 */
-	renderGradient( params ) {
-
-		const startTime = performance.now();
-		const { width, height } = this;
-		const pixels = this._pixels;
-
-		const zr = params.zenithColor.r, zg = params.zenithColor.g, zb = params.zenithColor.b;
-		const hr = params.horizonColor.r, hg = params.horizonColor.g, hb = params.horizonColor.b;
-		const gr = params.groundColor.r, gg = params.groundColor.g, gb = params.groundColor.b;
-
-		for ( let y = 0; y < height; y ++ ) {
-
-			const t = ( y + 0.5 ) / height;
-			let r, g, b;
-
-			if ( t > 0.5 ) {
-
-				// Top half: horizon → zenith
-				const blend = ( t - 0.5 ) * 2.0;
-				r = hr + ( zr - hr ) * blend;
-				g = hg + ( zg - hg ) * blend;
-				b = hb + ( zb - hb ) * blend;
-
-			} else {
-
-				// Bottom half: ground → horizon
-				const blend = t * 2.0;
-				r = gr + ( hr - gr ) * blend;
-				g = gg + ( hg - gg ) * blend;
-				b = gb + ( hb - gb ) * blend;
-
-			}
-
-			for ( let x = 0; x < width; x ++ ) {
-
-				const idx = ( y * width + x ) * 4;
-				pixels[ idx ] = r;
-				pixels[ idx + 1 ] = g;
-				pixels[ idx + 2 ] = b;
-				pixels[ idx + 3 ] = 1.0;
-
-			}
-
-		}
-
-		this._texture.needsUpdate = true;
-		// Fresh linear Rec.709 pixels in a reused texture. Colour management records which space a
-		// texture's pixels hold so it never converts them twice; left in place, that record would
-		// claim these were already converted and they never would be.
-		delete this._texture.userData?.__rayzeeColorSpace;
-		this.lastRenderTime = performance.now() - startTime;
-		return this._texture;
-
-	}
-
 	/**
 	 * Generate a uniform solid-colour sky.
 	 * @param {Object} params - { color } (Three.js Color)

package/src/managers/CameraManager.js

@@ -312,40 +312,7 @@ export class CameraManager extends EventDispatcher {
 
 		} else {
 
-			const sourceCamera = this.cameras[ index ];
-
-			this.camera.position.copy( sourceCamera.position );
-			this.camera.quaternion.copy( sourceCamera.quaternion );
-			// An imported camera can carry a mirror (a negative axis scale) that no
-			// quaternion can express — a pbrt scene's `Scale -1 1 1`, for one. Copying
-			// pose alone would silently un-mirror the view.
-			this.camera.scale.copy( sourceCamera.scale );
-			if ( sourceCamera.isPerspectiveCamera ) this.camera.fov = sourceCamera.fov;
-			this.camera.near = sourceCamera.near;
-			this.camera.far = sourceCamera.far;
-			this.camera.updateProjectionMatrix();
-			this.camera.updateMatrixWorld( true );
-
-			// Restore the saved orbit target for user cameras; otherwise place it
-			// along the forward direction at the focus distance.
-			if ( this.controls ) {
-
-				const savedTarget = sourceCamera.userData?.__rayzeeOrbitTarget;
-				if ( savedTarget ) {
-
-					this.controls.target.copy( savedTarget );
-
-				} else {
-
-					const forward = new Vector3( 0, 0, - 1 ).applyQuaternion( sourceCamera.quaternion );
-					const focusDist = focusDistance || 5.0;
-					this.controls.target.copy( this.camera.position ).addScaledVector( forward, focusDist );
-
-				}
-
-				this.controls.update();
-
-			}
+			this._placeAt( this.cameras[ index ], focusDistance );
 
 		}
 
@@ -370,6 +337,60 @@ export class CameraManager extends EventDispatcher {
 
 	}
 
+	/**
+	 * Puts the active camera back at the view it starts from: the default camera at the framing the
+	 * model loaded with, any other at its own pose and lens. Its effects and projection stay.
+	 */
+	resetView() {
+
+		const source = this.currentCameraIndex > 0 ? this.cameras[ this.currentCameraIndex ] : null;
+		if ( ! source ) {
+
+			this.controls.reset();
+			return;
+
+		}
+
+		this._placeAt( source, this._getSettings?.( 'focusDistance' ) );
+		const height = orthoHeightOf( source );
+		if ( this.camera.orthographic ) this._setView( true, height ? height / 2 : this.camera.orthoHalfHeight );
+		this._onReset?.();
+
+	}
+
+	// The view takes a camera's pose and lens, orbiting its saved target or a point ahead at the focus distance.
+	_placeAt( source, focusDistance ) {
+
+		this.camera.position.copy( source.position );
+		this.camera.quaternion.copy( source.quaternion );
+		// An imported camera can carry a mirror (a negative axis scale) that no
+		// quaternion can express — a pbrt scene's `Scale -1 1 1`, for one. Copying
+		// pose alone would silently un-mirror the view.
+		this.camera.scale.copy( source.scale );
+		if ( source.isPerspectiveCamera ) this.camera.fov = source.fov;
+		this.camera.near = source.near;
+		this.camera.far = source.far;
+		this.camera.updateProjectionMatrix();
+		this.camera.updateMatrixWorld( true );
+
+		if ( ! this.controls ) return;
+
+		const savedTarget = source.userData?.__rayzeeOrbitTarget;
+		if ( savedTarget ) {
+
+			this.controls.target.copy( savedTarget );
+
+		} else {
+
+			const forward = new Vector3( 0, 0, - 1 ).applyQuaternion( source.quaternion );
+			this.controls.target.copy( this.camera.position ).addScaledVector( forward, focusDistance || 5.0 );
+
+		}
+
+		this.controls.update();
+
+	}
+
 	/**
 	 * Makes the camera orthographic at `height`, or perspective for null, then hands the `cameraProjection`
 	 * setting the outcome — after, so its handler finds the camera already there. A 360° panorama stays on

package/src/managers/EnvironmentManager.js

@@ -1,6 +1,6 @@
 /**
  * EnvironmentManager.js
- * Manages HDRI loading, CDF importance sampling, procedural/gradient/solid sky
+ * Manages HDRI loading, CDF importance sampling, procedural/solid sky
  * generation, and environment rotation for the path tracing pipeline.
  *
  * Storage buffer nodes are created once and never replaced — only .value
@@ -83,11 +83,6 @@ export class EnvironmentManager {
 		this.envParams = {
 			mode: 'hdri',
 
-			// Gradient Sky
-			gradientZenithColor: new Color( DEFAULT_STATE.gradientZenithColor ),
-			gradientHorizonColor: new Color( DEFAULT_STATE.gradientHorizonColor ),
-			gradientGroundColor: new Color( DEFAULT_STATE.gradientGroundColor ),
-
 			// Solid Color Sky
 			solidSkyColor: new Color( DEFAULT_STATE.solidSkyColor ),
 
@@ -116,9 +111,9 @@ export class EnvironmentManager {
 	// ===== MODE STATE MACHINE =====
 
 	/**
-	 * Switches the environment mode (hdri, gradient, color, procedural — the physical sky).
+	 * Switches the environment mode (hdri, color, procedural — the physical sky).
 	 * Preserves the HDRI texture when switching away, restores when switching back.
-	 * @param {'hdri'|'gradient'|'color'|'procedural'} mode
+	 * @param {'hdri'|'color'|'procedural'} mode
 	 */
 	async setMode( mode ) {
 
@@ -132,11 +127,7 @@ export class EnvironmentManager {
 
 		}
 
-		if ( mode === 'gradient' ) {
-
-			await this.generateGradientTexture();
-
-		} else if ( mode === 'color' ) {
+		if ( mode === 'color' ) {
 
 			await this.generateSolidColorTexture();
 
@@ -185,9 +176,6 @@ export class EnvironmentManager {
 		return {
 			mode: p.mode,
 			hdri: this.hdriSource,
-			gradientZenithColor: p.gradientZenithColor.toArray(),
-			gradientHorizonColor: p.gradientHorizonColor.toArray(),
-			gradientGroundColor: p.gradientGroundColor.toArray(),
 			solidSkyColor: p.solidSkyColor.toArray(),
 			skyModel: 'atmosphere',
 			skySunDirection: p.skySunDirection.toArray(),
@@ -212,7 +200,7 @@ export class EnvironmentManager {
 		const p = this.envParams;
 		// Sessions saved before the physical sky gave the same names other meanings.
 		const atmosphere = state.skyModel === 'atmosphere';
-		const colors = [ 'gradientZenithColor', 'gradientHorizonColor', 'gradientGroundColor', 'solidSkyColor', 'skySunDirection' ];
+		const colors = [ 'solidSkyColor', 'skySunDirection' ];
 		for ( const key of atmosphere ? [ ...colors, 'skyGroundAlbedo' ] : colors ) {
 
 			if ( Array.isArray( state[ key ] ) ) p[ key ].fromArray( state[ key ] );
@@ -229,7 +217,9 @@ export class EnvironmentManager {
 
 		}
 
-		if ( state.mode && ( state.mode !== 'hdri' || p.mode !== 'hdri' ) ) await this.setMode( state.mode );
+		// A session saved with the removed gradient sky keeps the sky it is already showing.
+		const known = [ 'hdri', 'color', 'procedural' ].includes( state.mode );
+		if ( known && ( state.mode !== 'hdri' || p.mode !== 'hdri' ) ) await this.setMode( state.mode );
 
 	}
 
@@ -249,13 +239,6 @@ export class EnvironmentManager {
 
 	}
 
-	/** @see generateGradientTexture */
-	generateGradient() {
-
-		return this.generateGradientTexture();
-
-	}
-
 	/** @see generateSolidColorTexture */
 	generateSolid() {
 
@@ -547,7 +530,7 @@ export class EnvironmentManager {
 
 	/**
 	 * Enter 'hdri' mode ahead of an async HDRI install, and drop the texture stashed by a
-	 * previous setMode( 'gradient' | 'color' | 'procedural' ): a new HDRI makes it
+	 * previous setMode( 'color' | 'procedural' ): a new HDRI makes it
 	 * unreachable, so leaving it in place both leaks it and lets a setMode( 'hdri' )
 	 * arriving mid-download restore it over the map we are about to install.
 	 * @param {import('three').Texture} [incoming] - Never disposed, even if it is the stash.
@@ -576,38 +559,6 @@ export class EnvironmentManager {
 
 	// ===== SKY GENERATORS =====
 
-	/**
-	 * Generate gradient sky texture and set as environment.
-	 */
-	async generateGradientTexture() {
-
-		if ( ! this.simpleSkyRenderer ) {
-
-			this.simpleSkyRenderer = new SimpleSky( 512, 256 );
-
-		}
-
-		const params = {
-			zenithColor: this.envParams.gradientZenithColor,
-			horizonColor: this.envParams.gradientHorizonColor,
-			groundColor: this.envParams.gradientGroundColor,
-		};
-
-		try {
-
-			const texture = this.simpleSkyRenderer.renderGradient( params );
-			texture._isGeneratedProcedural = true;
-			await this.setEnvironmentMap( texture );
-			this.uniforms.set( 'hasSun', 0 );
-
-		} catch ( error ) {
-
-			log.error( 'gradient sky generation failed:', error );
-
-		}
-
-	}
-
 	/**
 	 * Generate solid color sky texture and set as environment.
 	 */