@gnsx/three 0.185.12 → 0.185.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gnsx/three",
-  "version": "0.185.12",
+  "version": "0.185.14",
   "description": "JavaScript 3D library",
   "type": "module",
   "main": "./build/three.cjs",

package/src/profiler/ProfilerService.js

@@ -10,6 +10,7 @@ import { warnOnce } from '../utils.js';
  *   // play for a few seconds
  *   __gnsx_profiler.report()         // sorted console.table (aggregated stats)
  *   __gnsx_profiler.downloadTrace()  // download gnsx-trace.json for Speedscope / Perfetto
+ *   __gnsx_profiler.downloadTrace('gnsx-trace.json', 0.05)  // omit spans < 0.05 ms
  *   __gnsx_profiler.reset()          // clear samples and trace
  *   __gnsx_profiler.disable()
  *
@@ -1216,11 +1217,16 @@ class ProfilerServiceClass {
 	}
 
 	/**
+	 * @param {number} [minDurationMs=0] Omit complete spans shorter than this duration (ms). Capture is unaffected.
 	 * @return {import('./ProfilerService.js').ChromeTrace}
 	 */
-	exportChromeTrace() {
+	exportChromeTrace( minDurationMs = 0 ) {
 
-		const slices = [ ...this.traceEvents ];
+		const thresholdMs = Number.isFinite( minDurationMs ) && minDurationMs > 0 ? minDurationMs : 0;
+		const minDurUs = thresholdMs * 1000;
+		const slices = minDurUs > 0
+			? this.traceEvents.filter( e => ( e.dur ?? 0 ) >= minDurUs )
+			: [ ...this.traceEvents ];
 		slices.sort( ( a, b ) => {
 
 			if ( a.ts !== b.ts ) return a.ts - b.ts;
@@ -1298,8 +1304,9 @@ class ProfilerServiceClass {
 
 	/**
 	 * @param {string} [filename='gnsx-trace.json']
+	 * @param {number} [minDurationMs=0] Omit complete spans shorter than this duration (ms).
 	 */
-	downloadTrace( filename = 'gnsx-trace.json' ) {
+	downloadTrace( filename = 'gnsx-trace.json', minDurationMs = 0 ) {
 
 		if ( typeof document === 'undefined' ) {
 
@@ -1322,7 +1329,10 @@ class ProfilerServiceClass {
 
 		}
 
-		const json = JSON.stringify( this.exportChromeTrace() );
+		const thresholdMs = Number.isFinite( minDurationMs ) && minDurationMs > 0 ? minDurationMs : 0;
+		const trace = this.exportChromeTrace( thresholdMs );
+		const eventCount = trace.traceEvents.filter( e => e.ph === 'X' ).length;
+		const json = JSON.stringify( trace );
 		const blob = new Blob( [ json ], { type: 'application/json' } );
 		const url = URL.createObjectURL( blob );
 		const a = document.createElement( 'a' );
@@ -1330,7 +1340,10 @@ class ProfilerServiceClass {
 		a.download = filename;
 		a.click();
 		URL.revokeObjectURL( url );
-		console.log( `[ProfilerService] Trace downloaded: ${filename} (${this.traceEvents.length} events)` );
+		const thresholdNote = thresholdMs > 0
+			? ` (filtered ${this.traceEvents.length - eventCount} spans < ${thresholdMs} ms)`
+			: '';
+		console.log( `[ProfilerService] Trace downloaded: ${filename} (${eventCount} events${thresholdNote})` );
 
 	}
 

package/src/renderers/common/Renderer.js

@@ -1378,20 +1378,24 @@ class Renderer {
 	 */
 	render( scene, camera ) {
 
-		// WITH_GENESYS
-		ProfilerService.begin( 'Renderer.render' );
-		// !WITH_GENESYS
-
 		if ( this._initialized === false ) {
 
 			throw new Error( 'THREE.Renderer: .render() called before the backend is initialized. Use "await renderer.init();" before rendering.' );
 
 		}
 
-		this._renderScene( scene, camera );
-
 		// WITH_GENESYS
-		ProfilerService.end( 'Renderer.render' );
+		const label = `Renderer.render (${scene.name || scene.type})`;
+		const handle = ProfilerService.beginGpu( label, this );
+		try {
+
+			this._renderScene( scene, camera );
+
+		} finally {
+
+			ProfilerService.endGpu( handle );
+
+		}
 		// !WITH_GENESYS
 
 	}
@@ -1545,10 +1549,6 @@ class Renderer {
 
 		if ( this._isDeviceLost === true ) return;
 
-		// WITH_GENESYS
-		ProfilerService.begin( 'Renderer._renderScene' );
-		// !WITH_GENESYS
-
 		//
 
 		const frameBufferTarget = useFrameBufferTarget ? this._getFrameBufferTarget() : null;
@@ -1785,6 +1785,12 @@ class Renderer {
 		renderContext.activeMipmapLevel = activeMipmapLevel;
 		renderContext.occlusionQueryCount = renderList.occlusionQueryCount;
 
+		// WITH_GENESYS
+		// Size is finalized above from the active RT or drawing buffer.
+		const profilerLabel = `Renderer._renderScene (${renderContext.width}x${renderContext.height})`;
+		ProfilerService.begin( profilerLabel );
+		// !WITH_GENESYS
+
 		//
 
 		renderContext.scissorValue.max( _vector4.set( 0, 0, 0, 0 ) );
@@ -1860,7 +1866,7 @@ class Renderer {
 		//
 
 		// WITH_GENESYS
-		ProfilerService.end( 'Renderer._renderScene' );
+		ProfilerService.end( profilerLabel );
 		// !WITH_GENESYS
 
 		return renderContext;
@@ -3436,7 +3442,7 @@ class Renderer {
 	_renderObjects( renderList, camera, scene, lightsNode, passId = null ) {
 
 		// WITH_GENESYS
-		const label = `${this._currentRenderObjectFunction?.name || 'renderObject'} (${renderList.length})`;
+		const label = `_renderObjects (${renderList.length})`;
 		ProfilerService.begin( label );
 		// !WITH_GENESYS
 
@@ -3671,6 +3677,11 @@ class Renderer {
 	 */
 	renderObject( object, scene, camera, geometry, material, group, lightsNode, clippingContext = null, passId = null ) {
 
+		// WITH_GENESYS
+		const label = `renderObject (${object.name || object.type} - ${material.name || material.type})`;
+		ProfilerService.begin( label );
+		// !WITH_GENESYS
+
 		let materialOverride = false;
 		let materialColorNode;
 		let materialDepthNode;
@@ -3782,6 +3793,10 @@ class Renderer {
 
 		object.onAfterRender( this, scene, camera, geometry, material, group );
 
+		// WITH_GENESYS
+		ProfilerService.end( label );
+		// !WITH_GENESYS
+
 	}
 
 	/**