@gnsx/three 0.186.3 → 0.186.4

package/src/renderers/common/RenderObject.js

@@ -950,6 +950,11 @@ class RenderObject {
 
 		cacheKey = hash( cacheKey, this.renderer.contextNode.id, this.renderer.contextNode.version );
 
+		// WITH_GENESYS
+		// hash() xors each argument as a number, so a view name has to be hashed first.
+		cacheKey = hash( cacheKey, hashString( this.renderer.debug.view ), this.renderer.debug.shaderComplexityBudget );
+		// !WITH_GENESYS
+
 		return cacheKey;
 
 	}

package/src/renderers/common/Renderer.js

@@ -37,6 +37,7 @@ import { float, vec3, vec4, Fn } from '../../nodes/tsl/TSLCore.js';
 import { detachRendererReference } from '../../nodes/accessors/RendererReferenceNode.js';
 import { toneMappingExposure } from '../../nodes/display/ToneMappingNode.js';
 import { ProfilerService } from '../../profiler/ProfilerService.js';
+import { DEBUG_VIEW_LIGHTING_COMPLEXITY, DEBUG_VIEW_NONE, DEBUG_VIEW_SHADER_COMPLEXITY, DEFAULT_SHADER_COMPLEXITY_BUDGET } from '../../nodes/display/ComplexityDebug.js';
 // !WITH_GENESYS
 import { reference } from '../../nodes/accessors/ReferenceNode.js';
 import { highpModelNormalViewMatrix, highpModelViewMatrix } from '../../nodes/accessors/ModelNode.js';
@@ -743,6 +744,8 @@ class Renderer {
 		 * @property {?Function} onNodeBuilderCreated - A callback function that is executed after a node builder has been created and before it is built.
 		 * @property {?Function} onShaderError - A callback function that is executed when a shader error happens. Only supported with WebGL 2 right now.
 		 * @property {Function} getShaderAsync - Allows the get the raw shader code for the given scene, camera and 3D object.
+		 * @property {string} view - Debug view. `shaderComplexity` and `lightingComplexity` replace the shaded color with a heatmap.
+		 * @property {number} shaderComplexityBudget - Proxy budget that fills the shader-complexity ramp.
 		 */
 
 		/**
@@ -757,6 +760,10 @@ class Renderer {
 			},
 			onNodeBuilderCreated: null,
 			onShaderError: null,
+			// WITH_GENESYS
+			view: DEBUG_VIEW_NONE,
+			shaderComplexityBudget: DEFAULT_SHADER_COMPLEXITY_BUDGET,
+			// !WITH_GENESYS
 			getShaderAsync: async ( scene, camera, object ) => {
 
 				await this.compileAsync( object, camera, scene );
@@ -2691,7 +2698,13 @@ class Renderer {
 		const useToneMapping = this.currentToneMapping !== NoToneMapping;
 		const useColorSpace = this.currentColorSpace !== ColorManagement.workingColorSpace;
 
-		return useToneMapping || useColorSpace;
+		// WITH_GENESYS
+		// Shader complexity writes a scalar into an intermediate target, then the output pass colorizes it.
+		const shaderComplexity = this.debug.view === DEBUG_VIEW_SHADER_COMPLEXITY;
+
+		return useToneMapping || useColorSpace || shaderComplexity;
+		// !WITH_GENESYS
+		// return useToneMapping || useColorSpace;
 
 	}
 
@@ -2742,6 +2755,16 @@ class Renderer {
 	 */
 	get currentToneMapping() {
 
+		// WITH_GENESYS
+		const view = this.debug.view;
+
+		if ( view === DEBUG_VIEW_SHADER_COMPLEXITY || view === DEBUG_VIEW_LIGHTING_COMPLEXITY ) {
+
+			return NoToneMapping;
+
+		}
+		// !WITH_GENESYS
+
 		return this.isOutputTarget ? this.toneMapping : NoToneMapping;
 
 	}

package/src/renderers/common/nodes/NodeManager.js

@@ -7,7 +7,11 @@ import { NodeFrame, NodeUpdateType, StackTrace } from '../../../nodes/Nodes.js';
 import { renderGroup, cubeTexture, texture, fog, rangeFogFactor, densityFogFactor, reference, pmremTexture, screenUV, uniform } from '../../../nodes/TSL.js';
 import { builtin } from '../../../nodes/accessors/BuiltinNode.js';
 
-import { CubeUVReflectionMapping, EquirectangularReflectionMapping, EquirectangularRefractionMapping } from '../../../constants.js';
+import { CubeUVReflectionMapping, EquirectangularReflectionMapping, EquirectangularRefractionMapping, NoToneMapping } from '../../../constants.js';
+// WITH_GENESYS
+import { vec4 } from '../../../nodes/tsl/TSLCore.js';
+import { colorizeShaderComplexity, DEBUG_VIEW_SHADER_COMPLEXITY } from '../../../nodes/display/ComplexityDebug.js';
+// !WITH_GENESYS
 import { hashArray } from '../../../nodes/core/NodeUtils.js';
 import { error } from '../../../utils.js';
 
@@ -992,7 +996,10 @@ class NodeManager extends DataMap {
 
 		const renderer = this.renderer;
 
-		return renderer.toneMapping + ',' + renderer.currentColorSpace + ',' + renderer.xr.isPresenting;
+		// WITH_GENESYS
+		return renderer.toneMapping + ',' + renderer.currentColorSpace + ',' + renderer.xr.isPresenting + ',' + renderer.debug.view;
+		// !WITH_GENESYS
+		// return renderer.toneMapping + ',' + renderer.currentColorSpace + ',' + renderer.xr.isPresenting;
 
 	}
 
@@ -1007,27 +1014,35 @@ class NodeManager extends DataMap {
 
 		const renderer = this.renderer;
 
-		let output;
+		let sampled;
 
 		if ( outputTarget.isArrayTexture ) {
 
 			if ( this.backend.isWebGLBackend ) {
 
-				output = texture( outputTarget, screenUV ).depth( builtin( 'gl_ViewID_OVR' ) ).renderOutput( renderer.toneMapping, renderer.currentColorSpace );
+				sampled = texture( outputTarget, screenUV ).depth( builtin( 'gl_ViewID_OVR' ) );
 
 			} else {
 
-				output = texture( outputTarget, screenUV ).depth( _outputLayerIndex ).renderOutput( renderer.toneMapping, renderer.currentColorSpace );
+				sampled = texture( outputTarget, screenUV ).depth( _outputLayerIndex );
 
 			}
 
 		} else {
 
-			output = texture( outputTarget, screenUV ).renderOutput( renderer.toneMapping, renderer.currentColorSpace );
+			sampled = texture( outputTarget, screenUV );
 
 		}
 
-		return output;
+		// WITH_GENESYS
+		if ( renderer.debug.view === DEBUG_VIEW_SHADER_COMPLEXITY ) {
+
+			return vec4( colorizeShaderComplexity( sampled.r ), 1 ).renderOutput( NoToneMapping, renderer.currentColorSpace );
+
+		}
+		// !WITH_GENESYS
+
+		return sampled.renderOutput( renderer.toneMapping, renderer.currentColorSpace );
 
 	}
 

package/src/renderers/webgl-fallback/nodes/GLSLNodeBuilder.js

@@ -635,6 +635,10 @@ ${ flowData.code }
 	 */
 	generateTexture( texture, textureProperty, uvSnippet, depthSnippet, offsetSnippet ) {
 
+		// WITH_GENESYS
+		this.recordFragmentTextureSample( texture, this.shaderStage, textureProperty + '|' + uvSnippet );
+		// !WITH_GENESYS
+
 		if ( depthSnippet ) uvSnippet = `vec3( ${ uvSnippet }, ${ depthSnippet } )`;
 
 		if ( texture.isDepthTexture ) {
@@ -678,6 +682,10 @@ ${ flowData.code }
 	 */
 	generateTextureLevel( texture, textureProperty, uvSnippet, levelSnippet, depthSnippet, offsetSnippet ) {
 
+		// WITH_GENESYS
+		this.recordFragmentTextureSample( texture, this.shaderStage, textureProperty + '|' + uvSnippet + '|' + levelSnippet );
+		// !WITH_GENESYS
+
 		if ( depthSnippet ) uvSnippet = `vec3( ${ uvSnippet }, ${ depthSnippet } )`;
 
 		if ( offsetSnippet ) {

package/src/renderers/webgl-fallback/utils/WebGLState.js

@@ -934,9 +934,25 @@ class WebGLState {
 
 		this.setFlipSided( flipSided );
 
-		( material.blending === NormalBlending && material.transparent === false )
-			? this.setBlending( NoBlending )
-			: this.setBlending( material.blending, material.blendEquation, material.blendSrc, material.blendDst, material.blendEquationAlpha, material.blendSrcAlpha, material.blendDstAlpha, material.blendColor, material.blendAlpha, material.premultipliedAlpha );
+		// WITH_GENESYS
+		// WebGL has no cached render pipeline. One+One is applied on each draw instead.
+		if ( this.backend.renderer.debug.view === 'shaderComplexity' && material.isShadowPassMaterial !== true && this.backend.renderer.isOutputTarget !== true ) {
+
+			this.setBlending( AdditiveBlending, AddEquation, OneFactor, OneFactor, AddEquation, OneFactor, OneFactor, material.blendColor, material.blendAlpha, true );
+
+		} else if ( material.blending === NormalBlending && material.transparent === false ) {
+
+			this.setBlending( NoBlending );
+
+		} else {
+
+			this.setBlending( material.blending, material.blendEquation, material.blendSrc, material.blendDst, material.blendEquationAlpha, material.blendSrcAlpha, material.blendDstAlpha, material.blendColor, material.blendAlpha, material.premultipliedAlpha );
+
+		}
+		// !WITH_GENESYS
+		// ( material.blending === NormalBlending && material.transparent === false )
+		// 	? this.setBlending( NoBlending )
+		// 	: this.setBlending( material.blending, material.blendEquation, material.blendSrc, material.blendDst, material.blendEquationAlpha, material.blendSrcAlpha, material.blendDstAlpha, material.blendColor, material.blendAlpha, material.premultipliedAlpha );
 
 		this.setDepthFunc( material.depthFunc );
 		this.setDepthTest( material.depthTest );

package/src/renderers/webgpu/WebGPUBackend.js

@@ -2389,6 +2389,9 @@ class WebGPUBackend extends Backend {
 		const depthStencilFormat = utils.getCurrentDepthStencilFormat( renderObject.context );
 		const primitiveTopology = utils.getPrimitiveTopology( object, material );
 		const frontFaceCW = ( object.isMesh && object.matrixWorld.determinantAffine() < 0 );
+		// WITH_GENESYS
+		const debugView = renderObject.renderer.debug.view;
+		// !WITH_GENESYS
 
 		let needsUpdate = false;
 
@@ -2406,7 +2409,10 @@ class WebGPUBackend extends Backend {
 			data.colorFormat !== colorFormat || data.depthStencilFormat !== depthStencilFormat ||
 			data.primitiveTopology !== primitiveTopology ||
 			data.frontFaceCW !== frontFaceCW ||
-			data.clippingContextCacheKey !== renderObject.clippingContextCacheKey
+			data.clippingContextCacheKey !== renderObject.clippingContextCacheKey ||
+			// WITH_GENESYS
+			data.debugView !== debugView
+			// !WITH_GENESYS
 		) {
 
 			data.material = material; data.materialVersion = material.version;
@@ -2427,6 +2433,9 @@ class WebGPUBackend extends Backend {
 			data.primitiveTopology = primitiveTopology;
 			data.frontFaceCW = frontFaceCW;
 			data.clippingContextCacheKey = renderObject.clippingContextCacheKey;
+			// WITH_GENESYS
+			data.debugView = debugView;
+			// !WITH_GENESYS
 
 			needsUpdate = true;
 
@@ -2470,7 +2479,10 @@ class WebGPUBackend extends Backend {
 			utils.getCurrentColorSpace( renderContext ), utils.getCurrentColorFormat( renderContext ), utils.getCurrentDepthStencilFormat( renderContext ),
 			utils.getPrimitiveTopology( object, material ),
 			renderObject.getGeometryCacheKey(),
-			renderObject.clippingContextCacheKey
+			renderObject.clippingContextCacheKey,
+			// WITH_GENESYS
+			renderObject.renderer.debug.view
+			// !WITH_GENESYS
 		].join();
 
 	}

package/src/renderers/webgpu/nodes/WGSLNodeBuilder.js

@@ -376,6 +376,10 @@ class WGSLNodeBuilder extends NodeBuilder {
 	 */
 	_generateTextureSample( texture, textureProperty, uvSnippet, depthSnippet, offsetSnippet, shaderStage = this.shaderStage ) {
 
+		// WITH_GENESYS
+		if ( shaderStage === 'fragment' ) this.recordFragmentTextureSample( texture, shaderStage, textureProperty + '|' + uvSnippet );
+		// !WITH_GENESYS
+
 		if ( shaderStage === 'fragment' ) {
 
 			if ( depthSnippet ) {
@@ -656,6 +660,10 @@ class WGSLNodeBuilder extends NodeBuilder {
 	 */
 	generateFilteredTexture( texture, textureProperty, uvSnippet, offsetSnippet, levelSnippet = '0u', depthSnippet ) {
 
+		// WITH_GENESYS
+		this.recordFragmentTextureSample( texture, this.shaderStage, textureProperty + '|' + uvSnippet + '|' + levelSnippet );
+		// !WITH_GENESYS
+
 		const wrapFunction = this.generateWrapFunction( texture );
 		const textureDimension = this.generateTextureDimension( texture, textureProperty, levelSnippet );
 
@@ -693,6 +701,10 @@ class WGSLNodeBuilder extends NodeBuilder {
 	 */
 	generateTextureLod( texture, textureProperty, uvSnippet, depthSnippet, offsetSnippet, levelSnippet = '0u' ) {
 
+		// WITH_GENESYS
+		this.recordFragmentTextureSample( texture, this.shaderStage, textureProperty + '|' + uvSnippet + '|' + levelSnippet );
+		// !WITH_GENESYS
+
 		// Cube textures cannot use textureLoad in WGSL, must use textureSampleLevel
 		if ( texture.isCubeTexture === true ) {
 
@@ -1071,6 +1083,10 @@ class WGSLNodeBuilder extends NodeBuilder {
 
 		if ( this.isUnfilterable( texture ) === false ) {
 
+			// WITH_GENESYS
+			this.recordFragmentTextureSample( texture, this.shaderStage, textureProperty + '|' + uvSnippet + '|' + levelSnippet );
+			// !WITH_GENESYS
+
 			if ( depthSnippet ) {
 
 				if ( offsetSnippet ) {

package/src/renderers/webgpu/utils/WebGPUPipelineUtils.js

@@ -106,6 +106,26 @@ class WebGPUPipelineUtils {
 
 		}
 
+		// WITH_GENESYS
+		// Accumulate shader cost with One+One. Opaque materials normally disable blending.
+		if ( backend.renderer.debug.view === 'shaderComplexity' && material.isShadowPassMaterial !== true && backend.renderer.isOutputTarget !== true ) {
+
+			materialBlending = {
+				color: {
+					srcFactor: GPUBlendFactor.One,
+					dstFactor: GPUBlendFactor.One,
+					operation: GPUBlendOperation.Add
+				},
+				alpha: {
+					srcFactor: GPUBlendFactor.One,
+					dstFactor: GPUBlendFactor.One,
+					operation: GPUBlendOperation.Add
+				}
+			};
+
+		}
+		// !WITH_GENESYS
+
 		// stencil
 
 		let stencilFront = {};

package/build/three.cjs

@@ -1,17 +0,0 @@
-/**
- * @license
- * Copyright 2010-2026 Three.js Authors
- * SPDX-License-Identifier: MIT
- *
- * The CommonJS build of three is deprecated. three is ESM-only going forward;
- * this entry now re-exports the ES module via require(esm) and will be removed
- * in a future release.
- * 
- * Replace `require('three')` with `import * as THREE from 'three'`.
- */
-process.emitWarning(
-	'`require("three")` is deprecated and will be removed.\n' +
-	'Replace `const THREE = require("three")` with `import * as THREE from "three"`.',
-	{ type: 'DeprecationWarning', code: 'THREE_CJS_DEPRECATED' }
-);
-module.exports = require( './three.module.js' );