rayzee 7.10.2 → 7.11.0

package/package.json

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

package/src/EngineDefaults.js

@@ -109,9 +109,15 @@ export const ENGINE_DEFAULTS = {
 	directionalLightPosition: [ 1, 1, 1 ],
 	directionalLightAngle: 0.0,
 
-	filterStrength: 0.75,
-	strengthDecaySpeed: 0.05,
-	edgeThreshold: 1.0,
+	// EdgeAware denoiser (spatial-only SVGF à-trous). filterStrength: final blend
+	// (0 = raw, 1 = filtered). edgeAtrousIterations: à-trous passes (step 1,2,4,8,16).
+	// edgePhiLuminance: variance-scaled luminance edge-stop. edgePhiNormal: normal cone
+	// exponent. edgePhiDepth: RELATIVE depth tolerance (fraction of ray distance).
+	filterStrength: 1.0,
+	edgeAtrousIterations: 5,
+	edgePhiLuminance: 4.0,
+	edgePhiNormal: 64.0,
+	edgePhiDepth: 0.1,
 
 	enableOIDN: false,
 	oidnQuality: 'fast',
@@ -384,8 +390,8 @@ export const TRIANGLE_DATA_LAYOUT = {
 // Shared between CPU writers (TextureCreator, MaterialDataManager) and GPU readers (Common.js getMaterial).
 export const MATERIAL_DATA_LAYOUT = {
 
-	SLOTS_PER_MATERIAL: 30, // vec4 slots per material
-	FLOATS_PER_MATERIAL: 120, // total floats per material (30 × 4)
+	SLOTS_PER_MATERIAL: 33, // vec4 slots per material
+	FLOATS_PER_MATERIAL: 132, // total floats per material (33 × 4)
 
 	// ── Flat float offsets (CPU side) ────────────────────────────────
 	// Used as: data[ materialIndex * FLOATS_PER_MATERIAL + offset ]
@@ -432,8 +438,14 @@ export const MATERIAL_DATA_LAYOUT = {
 	SUBSURFACE_COLOR: 108, SUBSURFACE: 111,
 	// Slot 28: subsurfaceRadius.rgb (mean free path) + radius scale
 	SUBSURFACE_RADIUS: 112, SUBSURFACE_RADIUS_SCALE: 115,
-	// Slot 29: anisotropy g (floats 117-119 reserved for future SSS)
-	SUBSURFACE_ANISOTROPY: 116,
+	// Slot 29: subsurfaceAnisotropy g (116) + surface anisotropy (strength 117, rotation 118, map index 119)
+	SUBSURFACE_ANISOTROPY: 116, ANISOTROPY: 117, ANISOTROPY_ROTATION: 118, ANISOTROPY_MAP_INDEX: 119,
+	// Slot 30: extension-texture map indices A (transmission, clearcoat, clearcoatRoughness, sheenColor)
+	TRANSMISSION_MAP_INDEX: 120, CLEARCOAT_MAP_INDEX: 121, CLEARCOAT_ROUGHNESS_MAP_INDEX: 122, SHEEN_COLOR_MAP_INDEX: 123,
+	// Slot 31: extension-texture map indices B (sheenRoughness, iridescence, iridescenceThickness, specularIntensity)
+	SHEEN_ROUGHNESS_MAP_INDEX: 124, IRIDESCENCE_MAP_INDEX: 125, IRIDESCENCE_THICKNESS_MAP_INDEX: 126, SPECULAR_INTENSITY_MAP_INDEX: 127,
+	// Slot 32: extension-texture map indices C (specularColor + 3 reserved)
+	SPECULAR_COLOR_MAP_INDEX: 128,
 
 	// ── Vec4 slot indices (GPU/TSL side) ─────────────────────────────
 	// Used with getDatafromStorageBuffer( buf, matIdx, int(slot), int(SLOTS_PER_MATERIAL) )
@@ -460,7 +472,10 @@ export const MATERIAL_DATA_LAYOUT = {
 		DISPLACEMENT_TRANSFORM_A: 25, DISPLACEMENT_TRANSFORM_B: 26,
 		SUBSURFACE_A: 27, // subsurfaceColor.rgb, subsurface weight
 		SUBSURFACE_B: 28, // subsurfaceRadius.rgb, subsurfaceRadiusScale
-		SUBSURFACE_C: 29, // subsurfaceAnisotropy, reserved
+		SUBSURFACE_C: 29, // subsurfaceAnisotropy g, anisotropy, anisotropyRotation, anisotropyMapIndex
+		EXT_MAP_INDICES_A: 30, // transmission, clearcoat, clearcoatRoughness, sheenColor map indices
+		EXT_MAP_INDICES_B: 31, // sheenRoughness, iridescence, iridescenceThickness, specularIntensity map indices
+		EXT_MAP_INDICES_C: 32, // specularColor map index + 3 reserved
 	},
 
 };

package/src/Processor/AssetLoader.js

@@ -1590,6 +1590,17 @@ export class AssetLoader extends EventDispatcher {
 
 			}
 
+			// glTF punctual point/spot intensity is candela (W/sr); the engine's light
+			// model is Blender-style Power (W) that LightSerializer divides by 4π. Convert
+			// glTF candela → Power once at import (×4π) so it nets to the correct I/d².
+			// Directional (lux ≈ irradiance) is used directly and needs no conversion.
+			if ( ( object.isPointLight || object.isSpotLight ) && ! userData.__candelaConverted ) {
+
+				object.intensity *= 4 * Math.PI;
+				userData.__candelaConverted = true;
+
+			}
+
 			// Process ceiling lights
 			if ( object.name.startsWith( 'RectAreaLightPlaceholder' ) &&
 				userData.name

package/src/Processor/GeometryExtractor.js

@@ -292,7 +292,10 @@ export class GeometryExtractor {
 			subsurfaceColor: new Color( 0xffffff ),
 			subsurfaceRadius: [ 1.0, 0.2, 0.1 ], // skin-like: red travels furthest
 			subsurfaceRadiusScale: 1.0,
-			subsurfaceAnisotropy: 0.0
+			subsurfaceAnisotropy: 0.0,
+			// Surface specular anisotropy (native MeshPhysicalMaterial / KHR_materials_anisotropy)
+			anisotropy: 0.0,
+			anisotropyRotation: 0.0
 		};
 
 	}
@@ -399,7 +402,9 @@ export class GeometryExtractor {
 			emissiveIntensity: legacyMapping.emissiveIntensity ?? material.emissiveIntensity ?? defaults.emissiveIntensity,
 
 			// Surface properties
-			roughness: Math.max( 0.05, legacyMapping.roughness ?? material.roughness ?? defaults.roughness ),
+			// Floor at 0.02 (the sampler's own VNDF-PDF clamp, MaterialProperties.js) rather than
+			// 0.05, so near-mirror metals stay sharp without entering a new firefly regime.
+			roughness: Math.max( 0.02, legacyMapping.roughness ?? material.roughness ?? defaults.roughness ),
 			metalness: legacyMapping.metalness ?? material.metalness ?? defaults.metalness,
 
 			// Optical properties
@@ -430,6 +435,10 @@ export class GeometryExtractor {
 			subsurfaceRadiusScale: material.subsurfaceRadiusScale ?? defaults.subsurfaceRadiusScale,
 			subsurfaceAnisotropy: material.subsurfaceAnisotropy ?? defaults.subsurfaceAnisotropy,
 
+			// Surface specular anisotropy (native MeshPhysicalMaterial / KHR_materials_anisotropy)
+			anisotropy: material.anisotropy ?? defaults.anisotropy,
+			anisotropyRotation: material.anisotropyRotation ?? defaults.anisotropyRotation,
+
 			// Specular properties (for compatibility)
 			specularIntensity: legacyMapping.specularIntensity ?? material.specularIntensity ?? defaults.specularIntensity,
 			specularColor: legacyMapping.specularColor ?? material.specularColor ?? defaults.specularColor,
@@ -456,18 +465,21 @@ export class GeometryExtractor {
 			metalnessMap: this.processTexture( material.metalnessMap, this.metalnessMaps ),
 			emissiveMap: this.processTexture( material.emissiveMap, this.emissiveMaps ),
 			displacementMap: this.processTexture( material.displacementMap, this.displacementMaps ),
-
-			// Advanced texture maps (MeshPhysicalMaterial only)
-			clearcoatMap: this.processTexture( material.clearcoatMap, [] ),
-			clearcoatRoughnessMap: this.processTexture( material.clearcoatRoughnessMap, [] ),
-			transmissionMap: this.processTexture( material.transmissionMap, [] ),
+			anisotropyMap: this.processTexture( material.anisotropyMap, this.anisotropyMaps ),
+
+			// Advanced texture maps (MeshPhysicalMaterial only). Folded into their scalar factors
+			// in ShadeKernel (applyExtensionMaps). thicknessMap stays dropped — thickness has no
+			// render effect yet (see gap-plan Phase 4.4).
+			clearcoatMap: this.processTexture( material.clearcoatMap, this.clearcoatMaps ),
+			clearcoatRoughnessMap: this.processTexture( material.clearcoatRoughnessMap, this.clearcoatRoughnessMaps ),
+			transmissionMap: this.processTexture( material.transmissionMap, this.transmissionMaps ),
 			thicknessMap: this.processTexture( material.thicknessMap, [] ),
-			sheenColorMap: this.processTexture( material.sheenColorMap, [] ),
-			sheenRoughnessMap: this.processTexture( material.sheenRoughnessMap, [] ),
-			specularIntensityMap: this.processTexture( material.specularIntensityMap, [] ),
-			specularColorMap: this.processTexture( material.specularColorMap, [] ),
-			iridescenceMap: this.processTexture( material.iridescenceMap, [] ),
-			iridescenceThicknessMap: this.processTexture( material.iridescenceThicknessMap, [] ),
+			sheenColorMap: this.processTexture( material.sheenColorMap, this.sheenColorMaps ),
+			sheenRoughnessMap: this.processTexture( material.sheenRoughnessMap, this.sheenRoughnessMaps ),
+			specularIntensityMap: this.processTexture( material.specularIntensityMap, this.specularIntensityMaps ),
+			specularColorMap: this.processTexture( material.specularColorMap, this.specularColorMaps ),
+			iridescenceMap: this.processTexture( material.iridescenceMap, this.iridescenceMaps ),
+			iridescenceThicknessMap: this.processTexture( material.iridescenceThicknessMap, this.iridescenceThicknessMaps ),
 
 			// Texture transformation matrices
 			mapMatrix: this.getTextureMatrix( material.map ),
@@ -819,6 +831,16 @@ export class GeometryExtractor {
 		this.emissiveMaps = [];
 		this.roughnessMaps = [];
 		this.displacementMaps = [];
+		this.anisotropyMaps = [];
+		this.transmissionMaps = [];
+		this.clearcoatMaps = [];
+		this.clearcoatRoughnessMaps = [];
+		this.sheenColorMaps = [];
+		this.sheenRoughnessMaps = [];
+		this.iridescenceMaps = [];
+		this.iridescenceThicknessMaps = [];
+		this.specularIntensityMaps = [];
+		this.specularColorMaps = [];
 		this.directionalLights = [];
 		this.cameras = [];
 
@@ -857,6 +879,16 @@ export class GeometryExtractor {
 			emissiveMaps: this.emissiveMaps,
 			roughnessMaps: this.roughnessMaps,
 			displacementMaps: this.displacementMaps,
+			anisotropyMaps: this.anisotropyMaps,
+			transmissionMaps: this.transmissionMaps,
+			clearcoatMaps: this.clearcoatMaps,
+			clearcoatRoughnessMaps: this.clearcoatRoughnessMaps,
+			sheenColorMaps: this.sheenColorMaps,
+			sheenRoughnessMaps: this.sheenRoughnessMaps,
+			iridescenceMaps: this.iridescenceMaps,
+			iridescenceThicknessMaps: this.iridescenceThicknessMaps,
+			specularIntensityMaps: this.specularIntensityMaps,
+			specularColorMaps: this.specularColorMaps,
 			directionalLights: this.directionalLights,
 			cameras: this.cameras,
 			sceneFeatures: this.sceneFeatures // Scene-wide material feature flags

package/src/Processor/SceneProcessor.js

@@ -63,6 +63,16 @@ export class SceneProcessor {
 		this.metalnessMaps = [];
 		this.emissiveMaps = [];
 		this.displacementMaps = [];
+		this.anisotropyMaps = [];
+		this.transmissionMaps = [];
+		this.clearcoatMaps = [];
+		this.clearcoatRoughnessMaps = [];
+		this.sheenColorMaps = [];
+		this.sheenRoughnessMaps = [];
+		this.iridescenceMaps = [];
+		this.iridescenceThicknessMaps = [];
+		this.specularIntensityMaps = [];
+		this.specularColorMaps = [];
 		this.directionalLights = [];
 		this.cameras = [];
 		this.spheres = [];
@@ -320,6 +330,16 @@ export class SceneProcessor {
 			this.metalnessMaps = extractedData.metalnessMaps;
 			this.emissiveMaps = extractedData.emissiveMaps;
 			this.displacementMaps = extractedData.displacementMaps;
+			this.anisotropyMaps = extractedData.anisotropyMaps;
+			this.transmissionMaps = extractedData.transmissionMaps;
+			this.clearcoatMaps = extractedData.clearcoatMaps;
+			this.clearcoatRoughnessMaps = extractedData.clearcoatRoughnessMaps;
+			this.sheenColorMaps = extractedData.sheenColorMaps;
+			this.sheenRoughnessMaps = extractedData.sheenRoughnessMaps;
+			this.iridescenceMaps = extractedData.iridescenceMaps;
+			this.iridescenceThicknessMaps = extractedData.iridescenceThicknessMaps;
+			this.specularIntensityMaps = extractedData.specularIntensityMaps;
+			this.specularColorMaps = extractedData.specularColorMaps;
 			this.directionalLights = extractedData.directionalLights;
 			this.cameras = extractedData.cameras;
 			this.sceneFeatures = extractedData.sceneFeatures; // Store material feature flags for shader optimization
@@ -883,6 +903,17 @@ export class SceneProcessor {
 			roughness: remapType( this.roughnessMaps, linearLists, linearDedup, this._linearTexPacked ),
 			metalness: remapType( this.metalnessMaps, linearLists, linearDedup, this._linearTexPacked ),
 			displacement: remapType( this.displacementMaps, linearLists, linearDedup, this._linearTexPacked ),
+			anisotropy: remapType( this.anisotropyMaps, linearLists, linearDedup, this._linearTexPacked ),
+			// Extension maps — data maps → linear pool; color maps (sheenColor, specularColor) → sRGB pool.
+			transmission: remapType( this.transmissionMaps, linearLists, linearDedup, this._linearTexPacked ),
+			clearcoat: remapType( this.clearcoatMaps, linearLists, linearDedup, this._linearTexPacked ),
+			clearcoatRoughness: remapType( this.clearcoatRoughnessMaps, linearLists, linearDedup, this._linearTexPacked ),
+			sheenColor: remapType( this.sheenColorMaps, srgbLists, srgbDedup, this._srgbTexPacked ),
+			sheenRoughness: remapType( this.sheenRoughnessMaps, linearLists, linearDedup, this._linearTexPacked ),
+			iridescence: remapType( this.iridescenceMaps, linearLists, linearDedup, this._linearTexPacked ),
+			iridescenceThickness: remapType( this.iridescenceThicknessMaps, linearLists, linearDedup, this._linearTexPacked ),
+			specularIntensity: remapType( this.specularIntensityMaps, linearLists, linearDedup, this._linearTexPacked ),
+			specularColor: remapType( this.specularColorMaps, srgbLists, srgbDedup, this._srgbTexPacked ),
 		};
 
 		return { srgbLists, linearLists, remap };
@@ -907,6 +938,16 @@ export class SceneProcessor {
 			mat.roughnessMap = fix( mat.roughnessMap, remap.roughness );
 			mat.metalnessMap = fix( mat.metalnessMap, remap.metalness );
 			mat.displacementMap = fix( mat.displacementMap, remap.displacement );
+			mat.anisotropyMap = fix( mat.anisotropyMap, remap.anisotropy );
+			mat.transmissionMap = fix( mat.transmissionMap, remap.transmission );
+			mat.clearcoatMap = fix( mat.clearcoatMap, remap.clearcoat );
+			mat.clearcoatRoughnessMap = fix( mat.clearcoatRoughnessMap, remap.clearcoatRoughness );
+			mat.sheenColorMap = fix( mat.sheenColorMap, remap.sheenColor );
+			mat.sheenRoughnessMap = fix( mat.sheenRoughnessMap, remap.sheenRoughness );
+			mat.iridescenceMap = fix( mat.iridescenceMap, remap.iridescence );
+			mat.iridescenceThicknessMap = fix( mat.iridescenceThicknessMap, remap.iridescenceThickness );
+			mat.specularIntensityMap = fix( mat.specularIntensityMap, remap.specularIntensity );
+			mat.specularColorMap = fix( mat.specularColorMap, remap.specularColor );
 
 		}
 
@@ -984,6 +1025,16 @@ export class SceneProcessor {
 		this.metalnessMaps = [];
 		this.emissiveMaps = [];
 		this.displacementMaps = [];
+		this.anisotropyMaps = [];
+		this.transmissionMaps = [];
+		this.clearcoatMaps = [];
+		this.clearcoatRoughnessMaps = [];
+		this.sheenColorMaps = [];
+		this.sheenRoughnessMaps = [];
+		this.iridescenceMaps = [];
+		this.iridescenceThicknessMaps = [];
+		this.specularIntensityMaps = [];
+		this.specularColorMaps = [];
 		this.directionalLights = [];
 		this.cameras = [];
 		this.spheres = [];

package/src/Processor/TextureCreator.js

@@ -1,4 +1,4 @@
-import { DataArrayTexture, RGBAFormat, LinearFilter, UnsignedByteType, SRGBColorSpace } from "three";
+import { DataArrayTexture, RGBAFormat, LinearFilter, UnsignedByteType, SRGBColorSpace, RepeatWrapping } from "three";
 import { TEXTURE_CONSTANTS, MEMORY_CONSTANTS, DEFAULT_TEXTURE_MATRIX, MATERIAL_DATA_LAYOUT } from '../EngineDefaults.js';
 import { fetchAsWorker } from './Workers/fetchAsWorker.js';
 import TEXTURES_WORKER_URL from './Workers/TexturesWorker.js?worker&url';
@@ -983,25 +983,31 @@ export class TextureCreator {
 				// Slot 12: displacement
 				mat.bumpScale,				mat.displacementScale,		mat.displacementMap,		0,
 				mapMatrix[ 0 ], 			mapMatrix[ 1 ], 			mapMatrix[ 2 ], 			mapMatrix[ 3 ],
-				mapMatrix[ 4 ], 			mapMatrix[ 5 ], 			mapMatrix[ 6 ], 			1,
+				mapMatrix[ 4 ], 			mapMatrix[ 5 ], 			mapMatrix[ 6 ], 			mapMatrix[ 7 ],
 				normalMapMatrices[ 0 ], 	normalMapMatrices[ 1 ], 	normalMapMatrices[ 2 ], 	normalMapMatrices[ 3 ],
-				normalMapMatrices[ 4 ], 	normalMapMatrices[ 5 ], 	normalMapMatrices[ 6 ], 	1,
+				normalMapMatrices[ 4 ], 	normalMapMatrices[ 5 ], 	normalMapMatrices[ 6 ], 	normalMapMatrices[ 7 ],
 				roughnessMapMatrices[ 0 ], 	roughnessMapMatrices[ 1 ], 	roughnessMapMatrices[ 2 ], 	roughnessMapMatrices[ 3 ],
-				roughnessMapMatrices[ 4 ], 	roughnessMapMatrices[ 5 ], 	roughnessMapMatrices[ 6 ], 	1,
+				roughnessMapMatrices[ 4 ], 	roughnessMapMatrices[ 5 ], 	roughnessMapMatrices[ 6 ], 	roughnessMapMatrices[ 7 ],
 				metalnessMapMatrices[ 0 ], 	metalnessMapMatrices[ 1 ], 	metalnessMapMatrices[ 2 ], 	metalnessMapMatrices[ 3 ],
-				metalnessMapMatrices[ 4 ], 	metalnessMapMatrices[ 5 ], 	metalnessMapMatrices[ 6 ], 	1,
+				metalnessMapMatrices[ 4 ], 	metalnessMapMatrices[ 5 ], 	metalnessMapMatrices[ 6 ], 	metalnessMapMatrices[ 7 ],
 				emissiveMapMatrices[ 0 ], 	emissiveMapMatrices[ 1 ], 	emissiveMapMatrices[ 2 ], 	emissiveMapMatrices[ 3 ],
-				emissiveMapMatrices[ 4 ], 	emissiveMapMatrices[ 5 ], 	emissiveMapMatrices[ 6 ], 	1,
+				emissiveMapMatrices[ 4 ], 	emissiveMapMatrices[ 5 ], 	emissiveMapMatrices[ 6 ], 	emissiveMapMatrices[ 7 ],
 				bumpMapMatrices[ 0 ], 		bumpMapMatrices[ 1 ], 		bumpMapMatrices[ 2 ], 		bumpMapMatrices[ 3 ],
-				bumpMapMatrices[ 4 ], 		bumpMapMatrices[ 5 ],	 	bumpMapMatrices[ 6 ], 		1,
+				bumpMapMatrices[ 4 ], 		bumpMapMatrices[ 5 ],	 	bumpMapMatrices[ 6 ], 		bumpMapMatrices[ 7 ],
 				displacementMapMatrices[ 0 ], displacementMapMatrices[ 1 ], displacementMapMatrices[ 2 ], displacementMapMatrices[ 3 ],
-				displacementMapMatrices[ 4 ], displacementMapMatrices[ 5 ], displacementMapMatrices[ 6 ], 1,
+				displacementMapMatrices[ 4 ], displacementMapMatrices[ 5 ], displacementMapMatrices[ 6 ], displacementMapMatrices[ 7 ],
 				// Slot 27: subsurface (subsurfaceColor.rgb, subsurface weight)
 				mat.subsurfaceColor?.r ?? 1,	mat.subsurfaceColor?.g ?? 1,	mat.subsurfaceColor?.b ?? 1,	mat.subsurface ?? 0,
 				// Slot 28: subsurface (subsurfaceRadius.rgb, subsurfaceRadiusScale)
 				mat.subsurfaceRadius?.[ 0 ] ?? 1, mat.subsurfaceRadius?.[ 1 ] ?? 0.2, mat.subsurfaceRadius?.[ 2 ] ?? 0.1, mat.subsurfaceRadiusScale ?? 1,
-				// Slot 29: subsurface (anisotropy g, reserved)
-				mat.subsurfaceAnisotropy ?? 0,	0,	0,	0,
+				// Slot 29: subsurfaceAnisotropy g + surface anisotropy (strength, rotation, map index)
+				mat.subsurfaceAnisotropy ?? 0,	mat.anisotropy ?? 0,	mat.anisotropyRotation ?? 0,	mat.anisotropyMap ?? - 1,
+				// Slot 30: extension map indices A (transmission, clearcoat, clearcoatRoughness, sheenColor)
+				mat.transmissionMap ?? - 1,	mat.clearcoatMap ?? - 1,	mat.clearcoatRoughnessMap ?? - 1,	mat.sheenColorMap ?? - 1,
+				// Slot 31: extension map indices B (sheenRoughness, iridescence, iridescenceThickness, specularIntensity)
+				mat.sheenRoughnessMap ?? - 1,	mat.iridescenceMap ?? - 1,	mat.iridescenceThicknessMap ?? - 1,	mat.specularIntensityMap ?? - 1,
+				// Slot 32: extension map indices C (specularColor + 3 reserved)
+				mat.specularColorMap ?? - 1,	0,	0,	0,
 			];
 
 			data.set( materialData, stride );
@@ -1314,6 +1320,11 @@ export class TextureCreator {
 
 		texture.minFilter = LinearFilter;
 		texture.magFilter = LinearFilter;
+		// glTF's default sampler wrap is REPEAT; array layers are independent (not an atlas),
+		// so per-layer repeat is safe and lets tiling UVs (outside [0,1]) tile instead of
+		// clamping. MIRRORED_REPEAT / per-texture wrap is a follow-up (not stored per-slot yet).
+		texture.wrapS = RepeatWrapping;
+		texture.wrapT = RepeatWrapping;
 		texture.format = RGBAFormat;
 		texture.type = UnsignedByteType;
 		texture.needsUpdate = true;