three-blocks-benchmark 0.4.0 → 0.5.0-alpha.384.g6baf5c5aba0f

package/CHANGELOG.md

@@ -1,5 +1,68 @@
 # three-blocks-benchmark
 
+## 0.5.0-alpha.384.g6baf5c5aba0f
+
+- Website: Example previews and precompiled shaders now match the current release.
+
+- Library: Large PLY splat files now load through bundled workers.
+
+- Devtools: Shader checks bound browser startup and shutdown before the next verification.
+
+- Library: Baked Motion automatically prefers HEVC and falls back to AVC on every device.
+
+- Library: Baked Motion can author narrower depth tracks to reduce package downloads.
+
+- Library: Baked Motion bounds tilt warp reprojection so a starved blend goes stale, not stretched.
+
+- Packages: Gaussian benchmarks add the three.js GaussianSplat runtime on its matching dev build.
+
+- Library: Gaussian splats keep equal-depth ordering stable and avoid duplicate tile staging.
+
+- Library: HMR replaces outgoing shader registrations without reporting false conflicts.
+
+- Starter: New projects install the current Three Blocks and Devtools releases.
+
+- Tools: Exact-count splats no longer drop small mesh objects with dense triangulation.
+
+- Library: WaterVolume keeps hydrostatic density stable at high particle counts.
+
+- Library: Sphere rasterization ignores inconsistent overflow readbacks instead of rebuilding.
+
+- Website: The water surface demo starts at 500K particles, caps at 1M, and opens wider.
+
+- Website: Water demos add larger tiers and a tunable floorless monochrome PBR particle view.
+
+- Website: Example recording mode hides every interface except the rendered canvas.
+
+- Website: The body-tracking demo now shows the whole live SDF volume instead of one slice.
+
+- Library: SDFFieldNodes provides reusable distance, normal, shadow, and occlusion nodes.
+
+- Website: Login, setup, and tool stories now use polished, selectable terminals.
+
+- Library: Baked Motion preserves atlas alpha, resolves paused seeks, and fits mobile budgets.
+
+- Library: Baked Motion tilt packages can ship a coarse all-view atlas for undecoded corners.
+
+- Library: Baked Motion and Gaussian splat types now match their supported runtime contracts.
+
+- Library: Baked Motion fuses each atlas page into one RGBA texture, halving its GPU memory.
+
+- Tools: Baked Motion writes one package format; timelines and camera grids no longer differ.
+
+- Tools: Baked Motion can now publish verified HEVC renditions alongside H.264.
+
+- Tools: Blender reports consistent hub and Mesh to Splat versions in every install mode.
+
+- Website: The launch film now opens on its title and keeps every proof to one fast minute.
+
+- Library: Water accepts a shared interaction world, so moving bodies can push it.
+
+- Packages: Indirect batching and its dependent examples are no longer included.
+
+- Packages: Built from `6baf5c5aba0f`.
+
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -1,8 +1,8 @@
 # three-blocks-benchmark
 
-Reproducible browser benchmarks for Three Blocks, the unmerged three.js
-`GaussianSplatMesh` addon ([PR #33950][pr]), Spark, SuperSplat,
-GaussianSplats3D, and Babylon.js.
+Reproducible browser benchmarks for Three Blocks, the three.js `GaussianSplat`
+addon ([merged into `dev`][pr], vendored with the `dev` build it needs — see
+`vendor/README.md`), Spark, SuperSplat, GaussianSplats3D, and Babylon.js.
 
 [pr]: https://github.com/mrdoob/three.js/pull/33950
 The default `standard` suite uses fixed held-out cameras from Mip-NeRF 360

package/browser/harness.js

@@ -228,11 +228,10 @@ async function createThreeBlocks( bytes ) {
 
 async function createThreeGS( bytes ) {
 
-	const [ THREE, { PLYLoader }, { GaussianSplatMesh }, splatUtils ] = await Promise.all( [
+	const [ THREE, { GaussianSplatPLYLoader }, { GaussianSplat } ] = await Promise.all( [
 		import( 'three/webgpu' ),
-		import( 'three/addons/loaders/PLYLoader.js' ),
-		import( '../vendor/three-gs/objects/GaussianSplatMesh.js' ),
-		import( '../vendor/three-gs/utils/GaussianSplatUtils.js' ),
+		import( '../vendor/three-gs/loaders/GaussianSplatPLYLoader.js' ),
+		import( '../vendor/three-gs/objects/GaussianSplat.js' ),
 	] );
 	const renderer = new THREE.WebGPURenderer( {
 		canvas,
@@ -254,12 +253,10 @@ async function createThreeGS( bytes ) {
 	const camera = new THREE.PerspectiveCamera( benchmarkViewport.fov, benchmarkViewport.width / benchmarkViewport.height, 0.01, 100 );
 	setThreeCamera( camera, benchmarkPose );
 
-	// The PR reuses the stock PLYLoader plus a conversion helper rather than shipping its own
-	// splat PLY parser, so the benchmark loads it exactly that way.
-	const loader = new PLYLoader();
-	loader.setCustomPropertyNameMapping( splatUtils.GAUSSIAN_SPLAT_PLY_PROPERTY_MAPPING );
-	const splatGeometry = splatUtils.createGaussianSplatGeometryFromPLYGeometry( loader.parse( bytes ) );
-	const splats = new GaussianSplatMesh( splatGeometry );
+	// The merged addon ships its own splat PLY loader, which detects the file's spherical
+	// harmonics degree from the header, so the benchmark loads it exactly that way.
+	const splatGeometry = new GaussianSplatPLYLoader().parse( bytes );
+	const splats = new GaussianSplat( splatGeometry );
 	// The dataset PLY is in source (COLMAP-style Y-down) space; apply the suite's shared Rx180
 	// model transform, as the other runtimes do.
 	splats.quaternion.set( 1, 0, 0, 0 );

package/lib/run.mjs

@@ -36,6 +36,11 @@ const superSplatRuntime = path.resolve(
 	path.dirname( fileURLToPath( import.meta.resolve( '@playcanvas/supersplat-viewer' ) ) ),
 	'../public/index.js',
 );
+// The Gaussian splat addon merged into three.js `dev` after r185 and ships in no npm
+// release yet, so its lane runs against the vendored `dev` build it was merged into. Every
+// other runtime keeps the installed `three` release.
+const THREE_DEV_COMMIT = '00ea66ecb4b253c78e65b5f5a558af4696ba88a7';
+const threeDevBuild = path.join( packageRoot, 'vendor/three-dev/build' );
 const ownManifest = JSON.parse( await fs.readFile( path.join( packageRoot, 'package.json' ), 'utf8' ) );
 const threeBlocksManifest = JSON.parse( await fs.readFile( path.join( threeBlocksRoot, 'package.json' ), 'utf8' ) );
 
@@ -50,10 +55,10 @@ const RENDERERS = [
 	{
 		id: 'three-gs',
 		label: 'three.js splats',
-		version: 'PR #33950',
+		version: 'dev',
 		backend: 'WebGPU',
-		source: 'https://github.com/mrdoob/three.js/pull/33950',
-		commit: '5b8fcba16c8e0ab1e3745cd2c8185fe527998a36',
+		source: 'https://github.com/mrdoob/three.js/blob/dev/examples/jsm/objects/GaussianSplat.js',
+		commit: THREE_DEV_COMMIT,
 	},
 	{
 		id: 'spark',
@@ -262,9 +267,13 @@ async function serveDirectory( root, externalFiles = new Map() ) {
 
 async function runPage( browser, baseUrl, { renderer, suite, item, warmup, frames } ) {
 
+	const viewport = { width: item.width ?? VIEWPORT.width, height: item.height ?? VIEWPORT.height };
 	const context = await browser.newContext( {
-		viewport: { width: item.width ?? VIEWPORT.width, height: item.height ?? VIEWPORT.height },
+		viewport,
 		deviceScaleFactor: item.dpr ?? VIEWPORT.dpr,
+		// Presentation capture only: one .webm per page run at the exact viewport,
+		// off by default so published metrics never carry the recorder's overhead.
+		...( process.env.TB_RECORD_VIDEO ? { recordVideo: { dir: process.env.TB_RECORD_VIDEO, size: viewport } } : {} ),
 	} );
 	const page = await context.newPage();
 	const diagnostics = [];
@@ -315,12 +324,24 @@ async function runPage( browser, baseUrl, { renderer, suite, item, warmup, frame
 
 	} finally {
 
+		const video = process.env.TB_RECORD_VIDEO ? page.video() : null;
 		await context.close();
+		if ( video ) {
+
+			// The recorder finalizes on close; rename from playwright's random hash
+			// to the run order so a capture maps back to its stdout line.
+			const sequence = String( recordedRuns ++ ).padStart( 3, '0' );
+			await video.saveAs( path.join( process.env.TB_RECORD_VIDEO, `${sequence}-${item.id}-${renderer}.webm` ) );
+			await video.delete();
+
+		}
 
 	}
 
 }
 
+let recordedRuns = 0;
+
 function gpuSummary( systemInfo ) {
 
 	const gpu = systemInfo.gpu ?? {};
@@ -430,6 +451,13 @@ export async function runBenchmark( options ) {
 				resolve: {
 					alias: [
 						{ find: 'supersplat-viewer-runtime', replacement: superSplatRuntime },
+						// The three.js addon lane resolves every `three` specifier to the vendored
+						// `dev` build, exactly as the addon's own example importmap does.
+						...( renderer === 'three-gs' ? [
+							{ find: 'three/tsl', replacement: path.join( threeDevBuild, 'three.tsl.js' ) },
+							{ find: 'three/webgpu', replacement: path.join( threeDevBuild, 'three.webgpu.js' ) },
+							{ find: 'three', replacement: path.join( threeDevBuild, 'three.webgpu.js' ) },
+						] : [] ),
 						// Both loaders spell their worker as `new URL( './<name>.js', import.meta.url )` so
 						// bundlers emit the entry. The published chunks sit at the dist root, where those
 						// paths do not exist; point them at the real worker modules.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "three-blocks-benchmark",
-  "version": "0.4.0",
-  "description": "Reproducible Gaussian splat browser benchmarks for Three Blocks, the three.js GaussianSplatMesh addon, Spark, SuperSplat, GaussianSplats3D, and Babylon.js",
+  "version": "0.5.0-alpha.384.g6baf5c5aba0f",
+  "description": "Reproducible Gaussian splat browser benchmarks for Three Blocks, the three.js GaussianSplat addon, Spark, SuperSplat, GaussianSplats3D, and Babylon.js",
   "keywords": [
     "three",
     "threejs",
@@ -52,7 +52,11 @@
     "playwright": "1.61.1",
     "pngjs": "7.0.0",
     "three": "0.185.1",
-    "three-blocks": "0.10.0",
+    "three-blocks": "0.11.0-alpha.384.g6baf5c5aba0f",
     "vite": "8.1.3"
+  },
+  "threeBlocks": {
+    "channel": "alpha",
+    "site": "https://preprod.threejs-blocks.com"
   }
 }

package/vendor/README.md

@@ -0,0 +1,45 @@
+# three.js Gaussian splat addon (`dev`)
+
+Verbatim copies of the merged Gaussian splat addon from mrdoob/three.js
+([PR #33950][pr], merged 2026-08-08) and of the `three` build it runs against,
+both pinned to commit `00ea66ecb4b253c78e65b5f5a558af4696ba88a7`.
+
+The addon uses TSL nodes that landed after r185 (`unpackUnorm4x8`), so it runs
+on no published `three` release. Until r186 ships, the benchmark vendors the
+`dev` build alongside the addon and resolves every `three` specifier in the
+`three-gs` bundle to it — the same mapping the addon's own example importmap
+uses. Every other runtime keeps the installed `three` release.
+
+| File | SHA-256 |
+| --- | --- |
+| `three-gs/objects/GaussianSplat.js` | `c239cde1abe239307c7dcc919d2a94c10e79a9393ffc3ba3e57dd8da53c367e6` |
+| `three-gs/gpgpu/CountingSort.js` | `e9e90b6940a4da923534c3f249e8e7bd2c7603f8b432c54c62ecdc6db4be47e3` |
+| `three-gs/utils/GaussianSplatUtils.js` | `4b9b010149b3e1a7673de37638365e937e005a03ba706e4cd81301b717d30f54` |
+| `three-gs/loaders/GaussianSplatPLYLoader.js` | `072def58e1c9d081bb5b3ce2641a652d1075f3a45d778874a38a765cfcd1dd60` |
+| `three-gs/loaders/PLYLoader.js` | `67b8c1015209b89081a92fdd69dc9df4a61284c3e9f8bb5380e441e4c64e5111` |
+| `three-dev/build/three.core.js` | `262ac37bc647e6e0393bb3ff1be9a610971ac6c9e49643a4a5ee914947cd5d88` |
+| `three-dev/build/three.webgpu.js` | `e906db5b44edcdf547eb3d7705e3a527ac851a7fad04db04c930066cb760fced` |
+| `three-dev/build/three.tsl.js` | `24728c07fcdb9a57afb5a41c9bc05db2052ebd528c945e7e5fe0963e48eb7937` |
+
+Refresh with:
+
+```sh
+sha=00ea66ecb4b253c78e65b5f5a558af4696ba88a7
+for f in objects/GaussianSplat.js gpgpu/CountingSort.js utils/GaussianSplatUtils.js \
+  loaders/GaussianSplatPLYLoader.js loaders/PLYLoader.js; do
+  curl -sSfL "https://raw.githubusercontent.com/mrdoob/three.js/$sha/examples/jsm/$f" -o "three-gs/$f"
+done
+for f in three.core.js three.webgpu.js three.tsl.js; do
+  curl -sSfL "https://raw.githubusercontent.com/mrdoob/three.js/$sha/build/$f" -o "three-dev/build/$f"
+done
+```
+
+The `three-gs` layout mirrors `examples/jsm/` so the files stay byte-identical
+to upstream (`GaussianSplat.js` imports `../gpgpu/CountingSort.js`, the splat
+PLY loader imports `./PLYLoader.js`). Drop `three-dev/` and alias the `three`
+specifiers back to the installed release once r186 publishes the addon.
+
+[pr]: https://github.com/mrdoob/three.js/pull/33950
+
+Licensed under the MIT License, Copyright © 2010-2026 three.js authors:
+<https://github.com/mrdoob/three.js/blob/dev/LICENSE>