three-blocks-benchmark 0.6.1 → 0.6.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # three-blocks-benchmark
 
+## 0.6.2
+
+### Patch Changes
+
+- ec85229: Website: Gaussian benchmarks compare raster and compute tiles with fresh Node.js measurements.
+- Updated dependencies [ec85229]
+- Updated dependencies [ec85229]
+- Updated dependencies [ec85229]
+- Updated dependencies [ec85229]
+- Updated dependencies [ec85229]
+  - three-blocks@0.14.0
+  - @three-blocks/devtools@13.0.0
+
 ## 0.6.1
 
 ### Patch Changes

package/README.md

@@ -13,6 +13,11 @@ It uses full-precision depth keys and wider Gaussian support cropped at the
 fragment alpha threshold. Load, frame time, memory, and image quality all use
 that same configuration.
 
+The default raster path and the opt-in compute-tile path have separate results.
+Compute tiles use premultiplied alpha and cached SH refreshed on every camera
+change, with the same quality preset and native resolution. Cold load includes
+tile capacity validation; measured frames must use compute tiles without raster fallback.
+
 Published results and methodology:
 <https://threejs-blocks.com/benchmark/gaussian>
 
@@ -81,7 +86,7 @@ shared SH3 PLY; its effective degree is recorded and labeled on the website.
 The Editor 3.0 column runs its verbatim projector, radix sorter and draw shaders
 with sorted transparency and fp16 accumulation; it excludes editor UI and the
 motion-adaptive stochastic mode. It consumes resident PLY bytes using the
-loader's `MemoryReadFileSystem`, so page memory includes the retained source
+loader's `MemoryReadFileSystem`, so process memory includes the retained source
 PLY. This does not reproduce the editor's file-backed memory figures. See
 `vendor/README.md` for provenance. The viewer is a separate product and column.
 

package/browser/harness.js

@@ -91,9 +91,18 @@ async function createThreeBlocks( bytes ) {
 	// compositing (the 3DGS training convention), classic uncompensated 0.3 screen-space
 	// dilation, and reference view-Z ordering.
 	const standard = suiteId === 'standard';
+	const computeTiles = rendererId === 'three-blocks-compute';
 	const compositing = query.get( 'compositing' ) ?? ( standard ? 'display' : 'linear' );
 	const sortPrecision = query.get( 'sortprec' );
 	const parseOptions = {
+		...( computeTiles ? {
+			rendererMode: 'compute-tiles',
+			alphaMode: 'premultiplied',
+			shColorMode: 'cached',
+			shColorUpdateAngle: 0,
+			shColorUpdateDistance: 0,
+			computeTiles: { allowRasterFallback: false },
+		} : {} ),
 		enableSH: standard,
 		shDegree: query.has( 'shdegree' ) ? Number( query.get( 'shdegree' ) ) : ( standard ? 3 : 0 ),
 		coordinateSystem: 'threejs',
@@ -204,9 +213,23 @@ async function createThreeBlocks( bytes ) {
 
 		setThreeCamera( camera, pose );
 		await renderScene( scene3d );
+		if ( computeTiles && benchmarkPhase === 'measure' && splats.stats.rendererMode !== 'compute-tiles' ) {
+
+			throw new Error( `Compute tiles unavailable during measurement: ${splats.stats.computeTiles?.fallbackReason}` );
+
+		}
 
 	};
 	await render( benchmarkPose );
+	// Include capacity validation and compilation in cold load, before timing any frames.
+	const readyDeadline = performance.now() + 30_000;
+	while ( computeTiles && splats.stats.rendererMode !== 'compute-tiles' ) {
+
+		if ( performance.now() > readyDeadline ) throw new Error( `Compute tiles failed to initialize: ${splats.stats.computeTiles?.fallbackReason}` );
+		await new Promise( resolve => setTimeout( resolve, 0 ) );
+		await render( benchmarkPose );
+
+	}
 	loadMarks.firstFrame = performance.now();
 	return {
 		backend: 'WebGPU',
@@ -218,6 +241,7 @@ async function createThreeBlocks( bytes ) {
 				reportedGpuBytes: stats.gpuBytes,
 				reportedGpuBytesScope: 'Three Blocks Gaussian resources',
 				rendererMode: stats.rendererMode,
+				...( computeTiles ? { computeTiles: stats.computeTiles } : {} ),
 				loadTimings: stats.loadTimings,
 				loadMarks: { ...loadMarks },
 			};
@@ -714,7 +738,7 @@ async function measureBrowserMemory() {
 async function run() {
 
 	if ( ! [ 'standard', 'micro' ].includes( suiteId ) ) throw new Error( `Unknown suite: ${suiteId}` );
-	if ( ! [ 'three-blocks', 'three-gs', 'spark', 'supersplat', 'supersplat-editor', 'gs3d', 'babylon' ].includes( rendererId ) ) {
+	if ( ! [ 'three-blocks', 'three-blocks-compute', 'three-gs', 'spark', 'supersplat', 'supersplat-editor', 'gs3d', 'babylon' ].includes( rendererId ) ) {
 
 		throw new Error( `Unknown renderer: ${rendererId}` );
 

package/lib/run.mjs

@@ -51,6 +51,14 @@ const RENDERERS = [
 		backend: 'WebGPU',
 		source: 'https://www.npmjs.com/package/three-blocks',
 	},
+	{
+		id: 'three-blocks-compute',
+		label: 'Three Blocks compute tiles',
+		profile: 'quality · compute tiles',
+		version: threeBlocksManifest.version,
+		backend: 'WebGPU',
+		source: 'https://www.npmjs.com/package/three-blocks',
+	},
 	{
 		id: 'three-gs',
 		label: 'three.js splats',
@@ -715,11 +723,12 @@ export async function runBenchmark( options ) {
 			},
 			limitations: suiteId === 'standard'
 				? [
-					'The three-view browser subset is not the canonical 37-view aggregate.',
+					'The three-view Node renderer subset is not the canonical 37-view aggregate.',
+					'Three Blocks is measured in separate raster and compute-tile configurations. Compute tiles use premultiplied alpha and cached SH refreshed for every camera change; both retain the quality preset and native resolution.',
 					'Frame timing serializes a complete current-camera sort and draw, including worker round trips in GaussianSplats3D and Babylon.js. It measures frame latency, not pipelined interactive FPS. Both SuperSplat columns use GPU sorting.',
 					'GaussianSplats3D 0.4.7 supports SH2 maximum; it receives the same SH3 PLY but omits the third band. Its lower feature ceiling remains reflected in the quality scores.',
-					'SuperSplat Editor 3.0 is its renderer and loader in a neutral scene, without editor UI or motion-adaptive stochastic transparency. Its resident PLY source counts towards page memory; this is not the editor file-backed memory workload.',
-					'The official addon uses three.js 0.186.0. Three Blocks and the other Three.js-based viewers retain three.js 0.185.1; this is a product comparison, not an isolated engine-version experiment.',
+					'SuperSplat Editor 3.0 is its renderer and loader in a neutral scene, without editor UI or motion-adaptive stochastic transparency. Its resident PLY source counts towards process memory; this is not the editor file-backed memory workload.',
+					'The Three.js-based columns use three.js 0.186.0; this is a product comparison, not an isolated rendering-algorithm experiment.',
 					'Quick mode is one-view validation evidence, not publication evidence.',
 					'Standard captures and downloaded reference images are local-only unless redistribution rights are cleared.',
 				]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "three-blocks-benchmark",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Reproducible Gaussian splat benchmarks for Three Blocks, three.js r186, Spark, SuperSplat Viewer and Editor 3, GaussianSplats3D, and Babylon.js",
   "keywords": [
     "three",
@@ -51,11 +51,11 @@
     "@playcanvas/splat-transform": "3.3.3",
     "@playcanvas/supersplat-viewer": "1.31.2",
     "@sparkjsdev/spark": "2.1.0",
-    "@three-blocks/devtools": "12.0.0",
+    "@three-blocks/devtools": "13.0.0",
     "playcanvas": "2.22.0",
     "pngjs": "7.0.0",
     "three": "0.186.0",
-    "three-blocks": "0.13.0",
+    "three-blocks": "0.14.0",
     "three-r186": "npm:three@0.186.0",
     "vite": "8.1.3"
   }