rayzee 9.5.0 → 11.0.0

package/src/managers/DenoisingManager.js

@@ -9,7 +9,10 @@ import { createLogger } from '../utils/Logger.js';
 // The neural passes live in `../neural/` but report through the manager that drives them, so they
 // share one namespace: `rayzee.log.only( 'neural' )` shows the whole chain.
 const neuralLog = createLogger( 'neural' );
-import { ENGINE_DEFAULTS as DEFAULT_STATE, ASVGF_QUALITY_PRESETS, NRD_DEFAULTS, NRD_QUALITY_PRESETS, NRD_PRESET_KEYS, CAMERA_PROJECTION_IDS } from '../EngineDefaults.js';
+import { CAMERA_PROJECTION_IDS } from '../EngineDefaults.js';
+import {
+	DENOISER_DEFAULTS, ASVGF_QUALITY_PRESETS, NRD_DEFAULTS, NRD_QUALITY_PRESETS, NRD_PRESET_KEYS,
+} from '../Stages/DenoiserSettings.js';
 
 // A refresh slower than this is a slideshow, not a live view, so the cadence swaps to a cheaper
 // model and puts the chosen one back for the finished image. Resolution-aware by construction:
@@ -135,13 +138,13 @@ export class DenoisingManager extends EventDispatcher {
 
 		// The tier the finished image uses. The loaded tier is not always this one: while the
 		// image is still accumulating we run a cheaper model (see previewQuality).
-		this._finalQuality = DEFAULT_STATE.oidnQuality;
+		this._finalQuality = DENOISER_DEFAULTS.oidnQuality;
 		// Two independent decisions. `finalDenoise` is the OIDN pass on the finished image;
 		// `continuousDenoise` is OIDN as the live-view denoiser. `denoiser.enabled` means only
 		// "OIDN is in use at all", which is what the aux G-buffer wiring needs.
-		this.finalDenoise = DEFAULT_STATE.enableOIDN;
-		this.continuousDenoise = DEFAULT_STATE.continuousDenoise;
-		this.continuousDenoiseInterval = DEFAULT_STATE.continuousDenoiseInterval;
+		this.finalDenoise = DENOISER_DEFAULTS.enableOIDN;
+		this.continuousDenoise = DENOISER_DEFAULTS.continuousDenoise;
+		this.continuousDenoiseInterval = DENOISER_DEFAULTS.continuousDenoiseInterval;
 		// -Infinity, not 0: 0 reads as "denoised at time zero", which blocks the first cadence
 		// denoise while performance.now() is still below the interval.
 		this._lastCadenceAt = - Infinity;
@@ -160,7 +163,7 @@ export class DenoisingManager extends EventDispatcher {
 		this._onPostProcessRefresh = null;
 		this._onDisplayRefresh = null;
 
-		this.temporalHistory = DEFAULT_STATE.oidnTemporalHistory;
+		this.temporalHistory = DENOISER_DEFAULTS.oidnTemporalHistory;
 		this._history = null;
 		// Stale after a scene-changing reset, or one the app did not announce (material/env edits).
 		this._historyDirty = true;
@@ -307,7 +310,8 @@ export class DenoisingManager extends EventDispatcher {
 		// Compositor decides what the single canvas shows. The exposure, grade and tone curve
 		// come from the renderer's own output pass, so it is not told about them either.
 		this.denoiser = new OIDNDenoiser( this.renderer, {
-			...DEFAULT_STATE,
+			enableOIDN: DENOISER_DEFAULTS.enableOIDN,
+			oidnQuality: DENOISER_DEFAULTS.oidnQuality,
 
 			backendParams: () => ( {
 				device: this.renderer.backend.device,
@@ -378,8 +382,8 @@ export class DenoisingManager extends EventDispatcher {
 		const pt = this._stages.pathTracer;
 
 		this.upscaler = new AIUpscaler( this.upscalerCanvas, this.renderer, {
-			scaleFactor: DEFAULT_STATE.upscalerScale || 2,
-			quality: DEFAULT_STATE.upscalerQuality || 'fast',
+			scaleFactor: DENOISER_DEFAULTS.upscalerScale || 2,
+			quality: DENOISER_DEFAULTS.upscalerQuality || 'fast',
 
 			// One source: the render canvas shows whatever the Compositor picked — the denoised
 			// picture when OIDN is on, the raw render otherwise — so the upscaler always enlarges
@@ -407,7 +411,7 @@ export class DenoisingManager extends EventDispatcher {
 			getSaturation: () => this._getSaturation(),
 		} );
 
-		this.upscaler.enabled = DEFAULT_STATE.enableUpscaler || false;
+		this.upscaler.enabled = DENOISER_DEFAULTS.enableUpscaler || false;
 
 		// Forward lifecycle events (store refs for removal on re-setup / dispose)
 		this._upscalerResChangedHandler = ( e ) =>

package/src/managers/EnvironmentManager.js

@@ -15,13 +15,32 @@ import { packExactTable } from '../Processor/EnvironmentExactTable.js';
 import { SimpleSky } from '../Processor/SimpleSky.js';
 import { convertLinearTriple } from '../Color/WorkingMatrix.js';
 import { createLogger, fmt } from '../utils/Logger.js';
-
-const log = createLogger( 'env' );
-import { ENGINE_DEFAULTS as DEFAULT_STATE } from '../EngineDefaults.js';
+import { sunPosition, dayOfYearForMonth } from '../Processor/SunPosition.js';
 import { getActiveColorManagement } from '../Color/ActiveColor.js';
 import { loadCDF, saveCDF } from '../Storage/CDFCache.js';
 import { ISSUE_CODES } from '../EngineIssues.js';
 
+const log = createLogger( 'env' );
+
+/** The default sun as a time of day (solar hours), month and latitude; north lies along −Z. */
+export const DEFAULT_SUN_PATH = Object.freeze( { time: 10, month: 3, latitude: 40 } );
+
+const DEFAULT_SUN = sunPosition( { hours: DEFAULT_SUN_PATH.time, dayOfYear: dayOfYearForMonth( DEFAULT_SUN_PATH.month ), latitude: DEFAULT_SUN_PATH.latitude } );
+
+/** The skies an environment starts with: a solid colour, and the physical sky's Clear Day. */
+export const SKY_DEFAULTS = Object.freeze( {
+	solidSkyColor: '#87CEEB',
+	skySunAzimuth: 180 - DEFAULT_SUN.azimuth,
+	skySunElevation: DEFAULT_SUN.elevation,
+	skySunStrength: 1, // artistic multiplier on the disc and its light; 1 is physical
+	skySunSize: 0.53, // angular diameter, degrees
+	skyTurbidity: 2, // 1 is aerosol-free air, ~2 a clear day, 6+ hazy
+	skyOzone: 300, // Dobson units
+	skyAirDensity: 1,
+	skyGroundAlbedo: '#959595', // 0.3 linear
+	skyAltitude: 50, // metres
+} );
+
 const SKY_WIDTH = 1024;
 const SKY_HEIGHT = 512;
 const DEG2RAD = Math.PI / 180;
@@ -90,17 +109,17 @@ export class EnvironmentManager {
 			mode: 'hdri',
 
 			// Solid Color Sky
-			solidSkyColor: new Color( DEFAULT_STATE.solidSkyColor ),
+			solidSkyColor: new Color( SKY_DEFAULTS.solidSkyColor ),
 
 			// Physical sky. The sun direction is in the sky's own frame; environment rotation turns both.
 			skySunDirection: this._calculateInitialSunDirection(),
-			skySunStrength: DEFAULT_STATE.skySunStrength,
-			skySunSize: DEFAULT_STATE.skySunSize,
-			skyTurbidity: DEFAULT_STATE.skyTurbidity,
-			skyOzone: DEFAULT_STATE.skyOzone,
-			skyAirDensity: DEFAULT_STATE.skyAirDensity,
-			skyGroundAlbedo: new Color( DEFAULT_STATE.skyGroundAlbedo ),
-			skyAltitude: DEFAULT_STATE.skyAltitude,
+			skySunStrength: SKY_DEFAULTS.skySunStrength,
+			skySunSize: SKY_DEFAULTS.skySunSize,
+			skyTurbidity: SKY_DEFAULTS.skyTurbidity,
+			skyOzone: SKY_DEFAULTS.skyOzone,
+			skyAirDensity: SKY_DEFAULTS.skyAirDensity,
+			skyGroundAlbedo: new Color( SKY_DEFAULTS.skyGroundAlbedo ),
+			skyAltitude: SKY_DEFAULTS.skyAltitude,
 		};
 
 		/**
@@ -801,8 +820,8 @@ export class EnvironmentManager {
 	/** @private */
 	_calculateInitialSunDirection() {
 
-		const azimuth = DEFAULT_STATE.skySunAzimuth * ( Math.PI / 180 );
-		const elevation = DEFAULT_STATE.skySunElevation * ( Math.PI / 180 );
+		const azimuth = SKY_DEFAULTS.skySunAzimuth * ( Math.PI / 180 );
+		const elevation = SKY_DEFAULTS.skySunElevation * ( Math.PI / 180 );
 		return new Vector3(
 			Math.cos( elevation ) * Math.sin( azimuth ),
 			Math.sin( elevation ),

package/src/managers/MaterialDataManager.js

@@ -10,9 +10,9 @@
 import { StorageInstancedBufferAttribute } from 'three/webgpu';
 import { storage } from 'three/tsl';
 import {
-	MATERIAL_DATA_LAYOUT as M, TRIANGLE_DATA_LAYOUT as T, normalizeAttenuationDistance,
-	TRI_MATERIAL_MASK, TRI_SIDE_SHIFT, TRI_BLOCKER_SHIFT, shadowBlockerBits
-} from '../EngineDefaults.js';
+	TRIANGLE_DATA_LAYOUT as T, TRI_MATERIAL_MASK, TRI_SIDE_SHIFT, TRI_BLOCKER_SHIFT, shadowBlockerBits,
+	MATERIAL_DATA_LAYOUT as M, normalizeAttenuationDistance,
+} from '../Processor/BufferLayout.js';
 import { packMaterial, UNIT_RANGE_PROPERTIES, clampUnit } from '../Processor/MaterialPacking.js';
 import { resolveMaterialTextures, MATERIAL_VALUE_SOURCE } from '../Processor/GeometryExtractor.js';
 import { convertLinearTriple, convertLinearTriples, getWorkingMatrixSpace } from '../Color/WorkingMatrix.js';

package/src/managers/UniformManager.js

@@ -218,12 +218,12 @@ export class UniformManager {
 		// reset, and a camera move resets each frame of a drag, so the RNG redrew the identical
 		// sequence and temporal denoising had nothing to average.
 		u( 'seedFrame', 0, 'uint' );
-		u( 'maxBounces', DEFAULT_STATE.bounces, 'int' );
+		u( 'maxBounces', DEFAULT_STATE.maxBounces, 'int' );
 		u( 'maxSamples', DEFAULT_STATE.maxSamples, 'int' );
 		u( 'transmissiveBounces', DEFAULT_STATE.transmissiveBounces, 'int' );
 		u( 'maxSubsurfaceSteps', DEFAULT_STATE.maxSubsurfaceSteps, 'int' );
 		u( 'maxTransparentBounces', DEFAULT_STATE.maxTransparentBounces, 'int' );
-		u( 'visMode', DEFAULT_STATE.debugMode, 'int' );
+		u( 'visMode', DEFAULT_STATE.visMode, 'int' );
 		u( 'debugVisScale', DEFAULT_STATE.debugVisScale, 'float' );
 
 		// Tier-1 convergence early-stop (FinalWrite reads these; live-toggled, no shader rebuild)