rayzee 5.1.0 → 5.1.1

package/package.json

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

package/src/Pipeline/RenderStage.js

@@ -142,7 +142,6 @@ export class RenderStage {
 
 		const renderMode = context.getState( 'renderMode' ) || 0;
 		const tileRenderingComplete = context.getState( 'tileRenderingComplete' );
-		const frame = context.getState( 'frame' ) || 0;
 
 		switch ( this.executionMode ) {
 

package/src/Processor/AssetLoader.js

@@ -1,4 +1,4 @@
-import { Box3, Vector3, RectAreaLight, Color, FloatType, LinearFilter, EquirectangularReflectionMapping, LinearMipmapLinearFilter,
+import { Box3, Vector3, RectAreaLight, Color, FloatType, LinearFilter, EquirectangularReflectionMapping,
 	TextureLoader, Mesh, MeshStandardMaterial, MeshPhysicalMaterial, CircleGeometry, Points, PointsMaterial, LoadingManager, EventDispatcher
 } from 'three';
 import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
@@ -171,8 +171,6 @@ export class AssetLoader extends EventDispatcher {
 			}
 
 			texture.generateMipmaps = true;
-			// texture.minFilter = LinearMipmapLinearFilter;
-			// texture.magFilter = LinearFilter;
 
 			this.applyEnvironmentToScene( texture );
 			this.dispatchEvent( { type: 'load', texture } );
@@ -353,7 +351,7 @@ export class AssetLoader extends EventDispatcher {
 
 	}
 
-	async findAndLoadModelFromZip( zip, filename ) {
+	async findAndLoadModelFromZip( zip ) {
 
 		const mainModelFiles = [
 			'scene.gltf', 'scene.glb', 'model.gltf', 'model.glb',
@@ -459,7 +457,6 @@ export class AssetLoader extends EventDispatcher {
 		if ( extension === 'gltf' ) {
 
 			const gltfContent = strFromU8( fileContent );
-			const gltfJson = JSON.parse( gltfContent );
 			const manager = new LoadingManager();
 			const gltfDir = filePath.split( '/' ).slice( 0, - 1 ).join( '/' );
 

package/src/Processor/EquirectHDRInfo.js

@@ -1,4 +1,4 @@
-import { DataUtils, HalfFloatType, FloatType } from 'three';
+import { DataUtils, HalfFloatType, FloatType, SRGBColorSpace } from 'three';
 
 /**
  * Binary search to find the closest index
@@ -38,18 +38,35 @@ function colorToLuminance( r, g, b ) {
 
 }
 
+/**
+ * sRGB to linear conversion (IEC 61966-2-1 transfer function)
+ */
+function sRGBToLinear( c ) {
+
+	return c <= 0.04045 ? c / 12.92 : ( ( c + 0.055 ) / 1.055 ) ** 2.4;
+
+}
+
 /**
  * Extract Float32 RGBA pixel data from an environment map.
- * Handles HalfFloat/integer type conversion and Y-flip.
+ * Handles HalfFloat/integer type conversion, canvas extraction for
+ * non-DataTexture images (JPG/PNG), sRGB-to-linear conversion, and Y-flip.
  * @returns {{ floatData: Float32Array, width: number, height: number }}
  */
 export function extractFloatData( envMap ) {
 
-	const { width, height, data } = envMap.image;
+	const { width, height } = envMap.image;
+	let data = envMap.image.data;
+	let needsSRGBToLinear = false;
 
+	// No CPU-accessible data — extract from HTMLImageElement / ImageBitmap via canvas
 	if ( ! data ) {
 
-		throw new Error( 'EquirectHDRInfo: Environment map must have CPU-accessible image data. Render target textures are not supported.' );
+		const canvas = new OffscreenCanvas( width, height );
+		const ctx = canvas.getContext( '2d' );
+		ctx.drawImage( envMap.image, 0, 0, width, height );
+		data = ctx.getImageData( 0, 0, width, height ).data;
+		needsSRGBToLinear = true;
 
 	}
 
@@ -72,7 +89,7 @@ export function extractFloatData( envMap ) {
 
 	} else {
 
-		// Integer types (Uint8, Int16, etc.)
+		// Integer types (Uint8, Uint8Clamped, Int16, etc.)
 		let maxIntValue;
 		if ( data instanceof Int8Array || data instanceof Int16Array || data instanceof Int32Array ) {
 
@@ -93,6 +110,26 @@ export function extractFloatData( envMap ) {
 
 	}
 
+	// Also flag sRGB conversion for DataTextures explicitly marked as sRGB
+	if ( ! needsSRGBToLinear && envMap.colorSpace === SRGBColorSpace ) {
+
+		needsSRGBToLinear = true;
+
+	}
+
+	// Convert sRGB to linear so CDF luminance matches GPU-sampled linear values
+	if ( needsSRGBToLinear ) {
+
+		for ( let i = 0, l = floatData.length; i < l; i += 4 ) {
+
+			floatData[ i ] = sRGBToLinear( floatData[ i ] );
+			floatData[ i + 1 ] = sRGBToLinear( floatData[ i + 1 ] );
+			floatData[ i + 2 ] = sRGBToLinear( floatData[ i + 2 ] );
+
+		}
+
+	}
+
 	// Remove Y-flip for CDF computation
 	if ( envMap.flipY ) {
 

package/src/Processor/SceneProcessor.js

@@ -820,8 +820,8 @@ export class SceneProcessor {
 
 		// Factory method for creating any additional scene elements
 		// Currently returns an empty array by default
-		const white = new Color( 0xffffff );
-		const black = new Color( 0x000000 );
+		// const white = new Color( 0xffffff );
+		// const black = new Color( 0x000000 );
 		return [
 			// { position: new Vector3( - 4, 2, 0 ), radius: 0.8, material: { color: white, emissive: black, emissiveIntensity: 0, roughness: 1.0 } },
 			// { position: new Vector3( - 1.5, 2, 0 ), radius: 0.8, material: { color: white, emissive: black, emissiveIntensity: 0, roughness: 1.0 } },

package/src/TSL/BVHTraversal.js

@@ -268,7 +268,7 @@ export const traverseBVH = Fn( ( [
 				} );
 
 				// If we found a very close hit, we can terminate early
-				If( closestHit.didHit.and( closestHit.dst.lessThan( 0.001 ) ), () => {
+				If( closestHit.didHit.and( closestHit.dst.lessThan( 1e-6 ) ), () => {
 
 					Break();
 

package/src/TSL/Debugger.js

@@ -356,7 +356,8 @@ export const TraceDebugMode = Fn( ( [
 			const bounceDir = cosineWeightedSample( { N: normalA, xi } ).toVar();
 
 			// Trace secondary ray from the hit point (offset along normal to avoid self-intersection)
-			const bounceOrigin = hitInfo.hitPoint.add( normalA.mul( 0.001 ) ).toVar();
+			const debugEps = max( float( 1e-4 ), length( hitInfo.hitPoint ).mul( 1e-6 ) );
+			const bounceOrigin = hitInfo.hitPoint.add( normalA.mul( debugEps ) ).toVar();
 			const bounceRay = Ray( { origin: bounceOrigin, direction: bounceDir } );
 
 			const bounceHit = HitInfo.wrap( traverseBVH(

package/src/TSL/LightsCore.js

@@ -257,7 +257,7 @@ export const intersectAreaLight = Fn( ( [ light, rayOrigin, rayDirection ] ) =>
 		const t = dot( light.position.sub( rayOrigin ), normal ).mul( invDenom ).toVar();
 
 		// Skip intersections behind the ray
-		If( t.greaterThan( 0.001 ), () => {
+		If( t.greaterThan( 1e-5 ), () => {
 
 			// Optimized rectangle test using vector rejection
 			const hitPoint = rayOrigin.add( rayDirection.mul( t ) );

package/src/TSL/LightsDirect.js

@@ -142,8 +142,9 @@ export const traceShadowRay = Fn( ( [
 			} );
 
 			// Continue ray past transmissive surface
-			rayOrigin.assign( shadowHit.hitPoint.add( dir.mul( 0.001 ) ) );
-			remainingDist.subAssign( shadowHit.dst.add( 0.001 ) );
+			const transEps = max( float( 1e-5 ), length( shadowHit.hitPoint ).mul( 1e-6 ) );
+			rayOrigin.assign( shadowHit.hitPoint.add( dir.mul( transEps ) ) );
+			remainingDist.subAssign( shadowHit.dst.add( transEps ) );
 
 		} ).ElseIf( shadowMaterial.transparent, () => {
 
@@ -158,8 +159,9 @@ export const traceShadowRay = Fn( ( [
 			} );
 
 			// Continue ray past transparent surface
-			rayOrigin.assign( shadowHit.hitPoint.add( dir.mul( 0.001 ) ) );
-			remainingDist.subAssign( shadowHit.dst.add( 0.001 ) );
+			const alphaEps = max( float( 1e-5 ), length( shadowHit.hitPoint ).mul( 1e-6 ) );
+			rayOrigin.assign( shadowHit.hitPoint.add( dir.mul( alphaEps ) ) );
+			remainingDist.subAssign( shadowHit.dst.add( alphaEps ) );
 
 		} ).Else( () => {
 
@@ -257,7 +259,7 @@ export const estimateLightImportance = Fn( ( [ light, hitPoint, normal, material
 
 		If( lightFacing.greaterThan( 0.0 ), () => {
 
-			const solidAngle = light.area.div( max( distSq, 0.1 ) );
+			const solidAngle = light.area.div( max( distSq, 1e-4 ) );
 			const power = light.intensity.mul( dot( light.color, REC709_LUMINANCE_COEFFICIENTS ) ).mul( light.area );
 
 			// Material-aware weighting
@@ -659,7 +661,7 @@ export const calculatePointLightContribution = Fn( ( [
 			const rayOffset = calculateRayOffset( hitPoint, normal, material );
 			const rayOrigin = hitPoint.add( rayOffset );
 
-			const visibility = traceShadowRayFn( rayOrigin, lightDir, distance.sub( 0.001 ), rngState );
+			const visibility = traceShadowRayFn( rayOrigin, lightDir, distance.mul( 0.999 ), rngState );
 
 			If( visibility.greaterThan( 0.0 ), () => {
 
@@ -711,7 +713,7 @@ export const calculateSpotLightContribution = Fn( ( [
 				const rayOffset = calculateRayOffset( hitPoint, normal, material );
 				const rayOrigin = hitPoint.add( rayOffset );
 
-				const visibility = traceShadowRayFn( rayOrigin, lightDir, distance.sub( 0.001 ), rngState );
+				const visibility = traceShadowRayFn( rayOrigin, lightDir, distance.mul( 0.999 ), rngState );
 
 				If( visibility.greaterThan( 0.0 ), () => {
 

package/src/TSL/LightsSampling.js

@@ -71,6 +71,7 @@ import {
 	calculatePointLightImportance,
 	calculateSpotLightImportance,
 	traceShadowRay,
+	calculateRayOffset,
 } from './LightsDirect.js';
 
 import { traverseBVHShadow } from './BVHTraversal.js';
@@ -940,7 +941,7 @@ export const calculateDirectLightingUnified = Fn( ( [
 ] ) => {
 
 	const totalContribution = vec3( 0.0 ).toVar();
-	const rayOrigin = hitPoint.add( hitNormal.mul( 0.001 ) ).toVar();
+	const rayOrigin = hitPoint.add( calculateRayOffset( hitPoint, hitNormal, material ) ).toVar();
 
 	// Early exit for highly emissive surfaces
 	If( material.emissiveIntensity.lessThanEqual( 10.0 ), () => {
@@ -1041,7 +1042,7 @@ export const calculateDirectLightingUnified = Fn( ( [
 
 				If( NoL.greaterThan( 0.0 ).and( lightImportance.mul( NoL ).greaterThan( importanceThreshold ) ).and( isDirectionValid( { direction: lightSample.direction, surfaceNormal: hitNormal } ) ), () => {
 
-					const shadowDistance = min( lightSample.distance.sub( 0.001 ), float( 1000.0 ) ).toVar();
+					const shadowDistance = min( lightSample.distance.mul( 0.999 ), float( 1000.0 ) ).toVar();
 					const visibility = traceShadowRay(
 						rayOrigin, lightSample.direction, shadowDistance, rngState,
 						traverseBVHShadow,

package/src/TSL/PathTracerCore.js

@@ -880,7 +880,8 @@ export const Trace = Fn( ( [
 			// For transmission: offset along the old ray direction to push through the surface
 			const reflectOffsetDir = select( interaction.entering, N, N.negate() );
 			const offsetDir = select( interaction.didReflect, reflectOffsetDir, rayDirection );
-			rayOrigin.assign( hitInfo.hitPoint.add( offsetDir.mul( 0.001 ) ) );
+			const bounceEps = max( float( 1e-4 ), length( hitInfo.hitPoint ).mul( 1e-6 ) );
+			rayOrigin.assign( hitInfo.hitPoint.add( offsetDir.mul( bounceEps ) ) );
 			rayDirection.assign( interaction.direction );
 
 			stateIsPrimaryRay.assign( tslBool( false ) );
@@ -1054,7 +1055,7 @@ export const Trace = Fn( ( [
 
 						const rayOffset = calculateRayOffset( hitInfo.hitPoint, N, material );
 						const rayOrigin = hitInfo.hitPoint.add( rayOffset );
-						const shadowDist = emissiveSample.distance.sub( 0.001 );
+						const shadowDist = emissiveSample.distance.mul( 0.999 );
 						const visibility = traceShadowRayWrapped( rayOrigin, emissiveSample.direction, shadowDist, rngState );
 
 						If( visibility.greaterThan( 0.0 ), () => {
@@ -1137,7 +1138,7 @@ export const Trace = Fn( ( [
 		throughput.mulAssign( indirectResult.throughput );
 
 		// Prepare for next bounce
-		rayOrigin.assign( hitInfo.hitPoint.add( N.mul( 0.001 ) ) );
+		rayOrigin.assign( hitInfo.hitPoint.add( calculateRayOffset( hitInfo.hitPoint, N, material ) ) );
 		rayDirection.assign( indirectResult.direction );
 		prevBouncePdf.assign( indirectResult.combinedPdf );
 

package/src/managers/EnvironmentManager.js

@@ -312,7 +312,7 @@ export class EnvironmentManager {
 			const startTime = performance.now();
 			const textureForCDF = this.scene.environment;
 
-			if ( ! textureForCDF.image || ! textureForCDF.image.data ) {
+			if ( ! textureForCDF.image ) {
 
 				this._updateCDFStorageBuffers();
 				this.uniforms.set( 'envTotalSum', 0.0 );