gaussian-splat-lite 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.0.2] - 2026-09-11
+
+### Changed
+
+- Allowed native WebGPU rendering after shared kernels, the full sorter, and the first projection slot compile, warming the remaining slots asynchronously.
+- Used stable storage binding names to allow native WebGPU projection slots to share shader programs.
+- Removed the separate native WebGPU indirect-draw reset dispatch by initializing fixed arguments once and updating instance counts in the projection finish pass, preserving the maximum count across views.
+
 ## [1.0.1] - 2026-09-11
 
 ### Added
@@ -270,7 +278,8 @@ and this project follows [Semantic Versioning](https://semver.org/).
 
 - Initial public release of the Three.js Gaussian Splatting renderer.
 
-[Unreleased]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v1.0.1...HEAD
+[Unreleased]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v1.0.2...HEAD
+[1.0.2]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v0.1.16...v1.0.0
 [0.1.16]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v0.1.15...v0.1.16

package/dist/gaussian-splat-lite.cjs

@@ -26423,11 +26423,8 @@ const ELEMENTS_PER_THREAD = 8;
 const ELEMENTS_PER_WORKGROUP = WORKGROUP_SIZE$1 * ELEMENTS_PER_THREAD;
 const PREFIX_ITEMS_PER_WORKGROUP = WORKGROUP_SIZE$1 * 2;
 const PREFIX_LEVELS = 3;
-function storage(buffer2, type, name, readOnly = false) {
-  const getBuffer = () => buffer2.value;
-  const node = N$2.storage(getBuffer(), type).onObjectUpdate(getBuffer);
-  node.name = name;
-  return readOnly ? node.toReadOnly() : node;
+function storage(buffer2, name) {
+  return N$2.storage(buffer2.value, "uint").setName(name).onObjectUpdate(() => buffer2.value);
 }
 function mutableUniform(value, type) {
   const holder = { value };
@@ -26452,8 +26449,8 @@ function makeHistogramTask({
   bitOffset,
   workgroupCount
 }) {
-  const inputKeys = storage(input, "uint", "gslRadixInputKeys", true);
-  const sums = storage(blockSums, "uint", "gslRadixBlockSums");
+  const inputKeys = storage(input, "gslRadixInputKeys").toReadOnly();
+  const sums = storage(blockSums, "gslRadixBlockSums");
   const bit = N$2.uint(bitOffset);
   const histogram = N$2.workgroupArray("uint", RADIX_BUCKETS).toAtomic().setName("gslRadixHistogram");
   return N$2.Fn(() => {
@@ -26486,8 +26483,8 @@ function makeHistogramTask({
   })().compute([1, 1, 1], [WORKGROUP_SIZE$1]).setName("Splat radix histogram");
 }
 function makePrefixScanTask(itemsBuffer, blockSumsBuffer, elementCount) {
-  const items = storage(itemsBuffer, "uint", "gslPrefixItems");
-  const blockSums = storage(blockSumsBuffer, "uint", "gslPrefixBlockSums");
+  const items = storage(itemsBuffer, "gslPrefixItems");
+  const blockSums = storage(blockSumsBuffer, "gslPrefixBlockSums");
   const temp = N$2.workgroupArray("uint", PREFIX_ITEMS_PER_WORKGROUP).setName(
     "gslPrefixTemp"
   );
@@ -26559,13 +26556,8 @@ function makePrefixScanTask(itemsBuffer, blockSumsBuffer, elementCount) {
   return compute2;
 }
 function makePrefixAddTask(itemsBuffer, blockSumsBuffer, elementCount) {
-  const items = storage(itemsBuffer, "uint", "gslPrefixItems");
-  const blockSums = storage(
-    blockSumsBuffer,
-    "uint",
-    "gslPrefixBlockSums",
-    true
-  );
+  const items = storage(itemsBuffer, "gslPrefixItems");
+  const blockSums = storage(blockSumsBuffer, "gslPrefixBlockSums").toReadOnly();
   const compute2 = N$2.Fn(() => {
     const workgroup = workgroupIndex();
     const first = workgroup.mul(PREFIX_ITEMS_PER_WORKGROUP).add(N$2.invocationLocalIndex.mul(2));
@@ -26595,23 +26587,15 @@ function makeReorderTask({
 }) {
   const inputKeys = storage(
     inputKeysAttribute,
-    "uint",
-    "gslRadixInputKeys",
-    true
-  );
-  const outputKeys = lastPass ? null : storage(outputKeysAttribute, "uint", "gslRadixOutputKeys");
+    "gslRadixInputKeys"
+  ).toReadOnly();
+  const outputKeys = lastPass ? null : storage(outputKeysAttribute, "gslRadixOutputKeys");
   const inputValues = storage(
     inputValuesAttribute,
-    "uint",
-    "gslRadixInputValues",
-    true
-  );
-  const outputValues = storage(
-    outputValuesAttribute,
-    "uint",
-    "gslRadixOutputValues"
-  );
-  const prefix = storage(prefixAttribute, "uint", "gslRadixPrefix", true);
+    "gslRadixInputValues"
+  ).toReadOnly();
+  const outputValues = storage(outputValuesAttribute, "gslRadixOutputValues");
+  const prefix = storage(prefixAttribute, "gslRadixPrefix").toReadOnly();
   const bitOffsetNode = N$2.uint(bitOffset);
   const digitMasks = N$2.workgroupArray("uint", RADIX_BUCKETS * 8).toAtomic().setName("gslRadixDigitMasks");
   const digitOffsets = N$2.workgroupArray("uint", RADIX_BUCKETS).setName(
@@ -26734,7 +26718,7 @@ class WebGPURadixSort {
     this.values = [makeBufferRef(safeCapacity), makeBufferRef(safeCapacity)];
     const histogramCount = RADIX_BUCKETS * this.paddedWorkgroups(safeCapacity, ELEMENTS_PER_WORKGROUP);
     this.blockSums = makeBufferRef(histogramCount);
-    const counts = storage(this.counts, "uint", "gslRadixCounts", true);
+    const counts = storage(this.counts, "gslRadixCounts").toReadOnly();
     this.createPrefixLevels(histogramCount, counts);
     const setup = this.makeSetupTask(options.count);
     const prefixNodes = this.prefixLevels.map((_, lastLevel) => {
@@ -26801,13 +26785,11 @@ class WebGPURadixSort {
     return Math.max(1, width * Math.ceil(groups / this.maxWorkgroups));
   }
   makeSetupTask(gpuCount) {
-    const counts = storage(this.counts, "uint", "gslRadixCounts");
+    const counts = storage(this.counts, "gslRadixCounts");
     const dispatchBuffers = [
       this.sortDispatch,
       ...this.prefixLevels.map((level) => level.dispatch)
-    ].map(
-      (value, index2) => storage({ value }, "uint", `gslRadixDispatch${index2}`)
-    );
+    ].map((value, index2) => storage({ value }, `gslRadixDispatch${index2}`));
     const maxWorkgroups = N$2.uint(this.maxWorkgroups);
     return N$2.Fn(() => {
       const count = N$2.min(
@@ -26919,29 +26901,31 @@ class WebGPURadixSort {
 const N$1 = TSL;
 const WORKGROUP_SIZE = 256;
 const PROJECT_SLOTS = 8;
-function buffer(count = 1) {
-  return { value: new StorageBufferAttribute(new Uint32Array(count), 1) };
+function buffer(name) {
+  return { value: new StorageBufferAttribute(new Uint32Array(1), 1), name };
 }
-function bindBuffer(ref, readOnly = false) {
-  const node = N$1.storage(ref.value, "uint").onObjectUpdate(() => ref.value);
-  return readOnly ? node.toReadOnly() : node;
+function bindBuffer(ref) {
+  return N$1.storage(ref.value, "uint").setName(ref.name).onObjectUpdate(() => ref.value);
 }
 class ProjectedSplats {
   constructor(renderer, uniforms) {
     this.renderer = renderer;
     this.uniforms = uniforms;
-    this.indirect = new IndirectStorageBufferAttribute(new Uint32Array(5), 1);
-    this.pending = true;
+    this.indirect = new IndirectStorageBufferAttribute(
+      new Uint32Array([WEBGPU_SPLATS_PER_INSTANCE * 6, 0, 0, 0, 0]),
+      1
+    );
     this.error = null;
     this.cache = new ProjectionCache();
     this.visibleCount = new StorageBufferAttribute(
       new Uint32Array(1),
       1
     );
-    this.keys = buffer();
-    this.seeds = buffer();
-    this.counts = buffer();
+    this.keys = buffer("gslProjectionKeys");
+    this.seeds = buffer("gslProjectionSeeds");
+    this.counts = buffer("gslProjectionCounts");
     this.slots = [];
+    this.compiledSlots = 0;
     this.matrix = new THREE__namespace.Matrix4();
     this.translation = new THREE__namespace.Matrix4();
     this.scale = new THREE__namespace.Vector3();
@@ -26971,8 +26955,8 @@ class ProjectedSplats {
     const viewBase = uniformBinding(this.state, "viewBase", "uint");
     const multiView = uniformBinding(this.state, "multiView", "bool");
     const stochastic = uniformBinding(uniforms, "stochastic", "bool");
-    const count = N$1.storage(this.visibleCount, "uint").toReadOnly().element(0);
-    const seeds = bindBuffer(this.seeds, true);
+    const count = N$1.storage(this.visibleCount, "uint").setName("gslVisibleCount").toReadOnly().element(0);
+    const seeds = bindBuffer(this.seeds).toReadOnly();
     this.sorter = new WebGPURadixSort(1, this.keys, {
       count,
       storeOrder: (index2, value) => {
@@ -26989,15 +26973,8 @@ class ProjectedSplats {
         this.limits.maxBufferSize
       )
     });
-    const draw = N$1.storage(this.indirect, "uint");
-    this.resetDraw = N$1.Fn(() => {
-      draw.element(0).assign(WEBGPU_SPLATS_PER_INSTANCE * 6);
-      draw.element(1).assign(0);
-      draw.element(2).assign(0);
-      draw.element(3).assign(0);
-      draw.element(4).assign(0);
-    })().compute(1).setName("Splat reset draw");
-    const counter = N$1.storage(this.visibleCount, "uint").toAtomic();
+    const drawCount = N$1.storage(this.indirect, "uint").setName("gslDrawIndirect").element(1);
+    const counter = N$1.storage(this.visibleCount, "uint").setName("gslVisibleCount").toAtomic();
     this.resetCount = N$1.Fn(() => {
       N$1.atomicStore(counter.element(0), N$1.uint(0));
     })().compute(1, [1]).setName("Splat reset visible count");
@@ -27008,7 +26985,9 @@ class ProjectedSplats {
       N$1.If(index2.equal(0), () => {
         counts.element(viewIndex).assign(count);
         const instances = count.add(WEBGPU_SPLATS_PER_INSTANCE - 1).div(N$1.uint(WEBGPU_SPLATS_PER_INSTANCE));
-        draw.element(1).assign(draw.element(1).max(instances));
+        drawCount.assign(
+          N$1.select(viewIndex.equal(0), instances, drawCount.max(instances))
+        );
       });
       N$1.If(multiView.and(stochastic).and(index2.lessThan(count)), () => {
         this.cache.storeOrder(
@@ -27019,17 +26998,30 @@ class ProjectedSplats {
     })().compute(1, [WORKGROUP_SIZE]).setName("Splat visible draw arguments");
     for (let i = 0; i < PROJECT_SLOTS; i++) this.slots.push(this.createSlot());
     this.ready = computeRenderer.compileComputeAsync([
-      this.resetDraw,
       this.resetCount,
       this.finish,
-      ...this.slots.map((slot) => slot.node),
-      ...this.sorter.nodes
-    ]).catch((error) => {
+      ...this.sorter.nodes,
+      this.slots[0].node
+    ]).then(() => {
+      this.compiledSlots = 1;
+    }).catch((error) => {
       this.error = error;
-    }).finally(() => {
-      this.pending = false;
-      if (this.disposed) this.disposeResources();
     });
+    this.compilation = this.ready.then(() => this.compileRemainingSlots());
+  }
+  async compileRemainingSlots() {
+    if (this.disposed || this.compiledSlots === 0) return;
+    try {
+      await new Promise((resolve) => setTimeout(resolve, 0));
+      while (!this.disposed && this.compiledSlots < this.slots.length) {
+        await this.renderer.compileComputeAsync([
+          this.slots[this.compiledSlots].node
+        ]);
+        this.compiledSlots++;
+      }
+    } catch (error) {
+      this.error = error;
+    }
   }
   createSlot() {
     const uniforms = { ...this.state, ...makeGenerateUniforms() };
@@ -27053,7 +27045,7 @@ class ProjectedSplats {
     const pixelScale = u("renderSize", "vec2").mul(u("focalAdjustment", "float")).mul(0.5);
     const keys = bindBuffer(this.keys);
     const seeds = bindBuffer(this.seeds);
-    const counter = N$1.storage(this.visibleCount, "uint").toAtomic();
+    const counter = N$1.storage(this.visibleCount, "uint").setName("gslVisibleCount").toAtomic();
     const node = N$1.Fn(() => {
       const index2 = N$1.uint(N$1.instanceIndex);
       const generated = generate.prepare(index2);
@@ -27106,7 +27098,7 @@ class ProjectedSplats {
     const stride = uniformBinding(this.state, "viewStride", "uint");
     const base = eye.mul(stride).toVar();
     const i = N$1.uint(N$1.instanceIndex).mul(WEBGPU_SPLATS_PER_INSTANCE).add(N$1.uint(N$1.positionGeometry.z));
-    const counts = bindBuffer(this.counts, true);
+    const counts = bindBuffer(this.counts).toReadOnly();
     const clipPosition = N$1.vec4(0, 0, 2, 1).toVar();
     const rgba = N$1.vec4(0).toVar();
     const splatUv = N$1.vec2(0).toVar();
@@ -27122,7 +27114,7 @@ class ProjectedSplats {
       const cacheIndex = i.toVar();
       const assignSeed = () => {
         stochasticSeed.assign(
-          multiView ? this.cache.readOrder(base.add(i)).y : bindBuffer(this.seeds, true).element(i)
+          multiView ? this.cache.readOrder(base.add(i)).y : bindBuffer(this.seeds).toReadOnly().element(i)
         );
       };
       if (depthOnly) {
@@ -27201,7 +27193,7 @@ class ProjectedSplats {
   }
   render(accumulator, camera, geometry, radial, shrink = false) {
     if (this.error) throw this.error;
-    if (this.pending || this.disposed) {
+    if (this.compiledSlots === 0 || this.disposed) {
       geometry.instanceCount = 0;
       return;
     }
@@ -27235,12 +27227,11 @@ class ProjectedSplats {
         this.scale
       );
       this.state.renderToViewScale.value = (this.scale.x + this.scale.y + this.scale.z) / 3;
-      const pending = eye === 0 ? [this.resetDraw] : [];
-      pending.push(this.resetCount);
+      const pending = [this.resetCount];
       let slotCount = 0;
       for (const { node, count } of accumulator.mapping) {
         if (!view.layers.test(node.layers)) continue;
-        if (slotCount === PROJECT_SLOTS) {
+        if (slotCount === this.compiledSlots) {
           this.renderer.compute(pending);
           pending.length = 0;
           slotCount = 0;
@@ -27261,12 +27252,11 @@ class ProjectedSplats {
   dispose() {
     if (this.disposed) return;
     this.disposed = true;
-    if (!this.pending) this.disposeResources();
+    void this.compilation.then(() => this.disposeResources());
   }
   disposeResources() {
     for (const slot of this.slots) slot.node.dispose();
-    for (const node of [this.resetDraw, this.resetCount, this.finish])
-      node.dispose();
+    for (const node of [this.resetCount, this.finish]) node.dispose();
     this.sorter.dispose();
     this.cache.dispose();
     this.visibleCount.dispose();