Radix draws 3D Gaussian splats with three.js r186's WebGPURenderer, on WebGPU or its WebGL2 backend. Splats live in typed-array tables that are the same on the CPU and the GPU. The package has two entry points:
@sparkjsdev/radix: everything, including rendering, GPU arrays, WebGPU compute, workers and camera controls.threeis a peer dependency.@sparkjsdev/radix/core: the CPU layer alone: tables, codecs, file formats (PLY, compressed PLY, SPZ, RAD, RDX) and sort keys. It imports nothing, so it runs in workers and in Node without three or a DOM.
Built by World Labs.
Copy the following code into an index.html file and serve it over http(s). It draws a butterfly on WebGPU, or on the WebGL2 backend where WebGPU is missing.
<style> body {margin: 0;} </style>
<script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/three@0.186.0/build/three.webgpu.js",
"three/webgpu": "https://cdn.jsdelivr.net/npm/three@0.186.0/build/three.webgpu.js",
"three/tsl": "https://cdn.jsdelivr.net/npm/three@0.186.0/build/three.tsl.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.186.0/examples/jsm/",
"@sparkjsdev/radix": "https://cdn.jsdelivr.net/npm/@sparkjsdev/radix@0.0.1/dist/radix.module.js"
}
}
</script>
<script type="module">
import * as THREE from "three";
import { GpuArrays, SplatCollection, SplatRenderer, createRenderer, loadSplats } from "@sparkjsdev/radix";
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(60, window.innerWidth / window.innerHeight, 0.01, 1000);
const renderer = await createRenderer();
renderer.setSize(window.innerWidth, window.innerHeight);
document.body.appendChild(renderer.domElement);
const splatURL = "https://storage.googleapis.com/forge-dev-public/asundqui/radix/261009/rdx/butterfly-ai.rdx";
const data = await loadSplats(splatURL);
const butterfly = new THREE.Object3D();
butterfly.rotation.x = Math.PI;
butterfly.position.set(0, 0, -3);
scene.add(butterfly);
const collection = new SplatCollection([
SplatCollection.arrays(GpuArrays.fromData(renderer, data), { matrixWorld: butterfly.matrixWorld }),
]);
scene.add(new SplatRenderer({ renderer, collection }));
renderer.setAnimationLoop(function animate(time) {
renderer.render(scene, camera);
butterfly.rotation.y += 0.01;
});
</script><script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/three@0.186.0/build/three.webgpu.js",
"three/webgpu": "https://cdn.jsdelivr.net/npm/three@0.186.0/build/three.webgpu.js",
"three/tsl": "https://cdn.jsdelivr.net/npm/three@0.186.0/build/three.tsl.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.186.0/examples/jsm/",
"@sparkjsdev/radix": "https://cdn.jsdelivr.net/npm/@sparkjsdev/radix@0.0.1/dist/radix.module.js"
}
}
</script>Radix imports three, three/webgpu and three/tsl, so the map names all three. The workers' code is inlined into the bundle, so there is no separate worker file to serve.
npm install three@0.186 @sparkjsdev/radixFrom a local checkout instead (npm builds dist/ on install through the prepare script):
cd radix && npm install # also builds dist/
cd ../my-app && npm install three@0.186 ../radixTypeScript apps need TypeScript 5.7 or newer, and the WebGPU types: TypeScript 6's DOM types include them, older versions need @webgpu/types.
import * as THREE from "three";
import { CameraControls, GpuArrays, SplatCollection, SplatRenderer, createRenderer, loadSplats } from "@sparkjsdev/radix";
const renderer = await createRenderer(); // WebGPU, or the WebGL2 backend where WebGPU is missing
renderer.setSize(innerWidth, innerHeight);
document.body.append(renderer.domElement);
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(60, innerWidth / innerHeight, 0.01, 1000);
camera.position.set(0, 0.5, 3);
const controls = new CameraControls({ canvas: renderer.domElement, object: camera, settings: { mode: "orbit" } });
const data = await loadSplats("scene.spz"); // decoded on a worker
const model = new THREE.Object3D();
model.rotation.x = Math.PI; // most captures are stored y down
scene.add(model);
const collection = new SplatCollection([SplatCollection.arrays(GpuArrays.fromData(renderer, data), { matrixWorld: model.matrixWorld })]);
scene.add(new SplatRenderer({ renderer, collection }));
renderer.setAnimationLoop(() => {
controls.update();
renderer.render(scene, camera);
});The CPU layer, in Node or a worker:
import { readFileSync, writeFileSync } from "node:fs";
import { SplatFiles } from "@sparkjsdev/radix/core";
const { splats } = await SplatFiles.decode(new Uint8Array(readFileSync("scene.ply")), { name: "scene.ply" });
console.log(`${splats.count} splats`);
writeFileSync("scene.spz", await SplatFiles.encode(splats, "spz"));The bundles leave three, three/webgpu and three/tsl to your bundler, or to an import map on a page without one. The workers' code is inlined into the bundle, so there is no separate worker file to serve.
Development needs Node 22.15 or newer (the core checks compare against Node's zstd).
npm install
npm run build # dist/, the example pages (build/examples/), the test pages (build/test/) and docs/ref/
npm run build:site # optional: the static site in build/site/ (also runs npm run build)
npm run serve # http-server on the repo root, port 8000Then open:
http://localhost:8000/build/site/: the place to start, afternpm run build:site. It's a landing page that links to the examples, the docs and the highlighted sources, all copied into one folder that can be put on any static host.http://localhost:8000/build/examples/index.html: the example pages (a splat viewer, short scenes, WebXR, an SPZ reader and writer, MPM water, the fx node editor, fractals, LCC and SOG viewers, Doom and Quake) and the ports of the SparkJS 2.3.1 examples.http://localhost:8000/docs/index.html: the docs (guide, API reference, recipes, and the comparison with SparkJS).http://localhost:8000/build/test/gpu/index.html: the GPU checks (?gpu=webgpu-glfor the WebGL2 backend).
The pages load their splat files from Google Cloud Storage and sparkjs.dev, so they need a network connection. They run on WebGPU, or on the WebGL2 backend with ?gpu=webgpu-gl.
| Command | What it does |
|---|---|
npm run build:watch |
rebuild the library, the example pages and docs/ref/ as files change |
npm run typecheck / npm run lint |
types of the library, core, examples and tests; then ESLint |
npm run check:core |
the core checks in Node |
npm run check:docs |
write docs/ref/, and check every link and that every export is documented |
npm run docs |
regenerate docs/ref/ after editing a docs .md page |
npm run check:test |
the GPU test page on both backends in headless Chrome (needs npm run serve) |
npm run check:examples |
every example page on both backends in headless Chrome (needs npm run serve) |
npm run bench / npm run bench:core |
the GPU benchmark page over the hosted samples / core benchmarks in Node |
npm run build:site / npm run serve:site |
a static site of the examples, docs and highlighted sources in build/site/, served on port 8002 |
src/: the library. Its layers (core/,gpu/,wgpu/,worker/,render/,controls/) import downwards only, and ESLint enforces that.docs/: Markdown pages, the generatedref/HTML, and the HTML guide.examples/: the example pages as TypeScript; the build strips their types file by file.test/: the GPU test page and the benchmark page.scripts/: builds, checks and benchmarks.
AGENTS.md describes the design, the conventions and every example in depth.
MIT