gaussian-splat-lite 1.2.1 → 1.2.2

package/dist/types/addons/TAANode.d.cts

@@ -1,7 +1,7 @@
 import { DepthTexture, Matrix4, OrthographicCamera, PerspectiveCamera, Scene } from 'three';
-import { NodeBuilder, NodeFrame, TempNode, TextureNode } from 'three/webgpu';
+import { Node, NodeBuilder, NodeFrame, TextureNode } from 'three/webgpu';
 /** Camera/depth TAA for WebGPURenderer, including its WebGL2 fallback. */
-export declare class TAANode extends TempNode<"vec4"> {
+export declare class TAANode extends Node<"vec4"> {
     scene: Scene;
     camera: PerspectiveCamera | OrthographicCamera;
     static get type(): string;
@@ -11,6 +11,8 @@ export declare class TAANode extends TempNode<"vec4"> {
     useSubpixelCorrection: boolean;
     private readonly source;
     private readonly history;
+    private readonly historyColor;
+    private readonly historyDepth;
     private readonly textureNode;
     private readonly material;
     private readonly quad;

package/dist/types/addons/TAANode.d.ts

@@ -1,7 +1,7 @@
 import { DepthTexture, Matrix4, OrthographicCamera, PerspectiveCamera, Scene } from 'three';
-import { NodeBuilder, NodeFrame, TempNode, TextureNode } from 'three/webgpu';
+import { Node, NodeBuilder, NodeFrame, TextureNode } from 'three/webgpu';
 /** Camera/depth TAA for WebGPURenderer, including its WebGL2 fallback. */
-export declare class TAANode extends TempNode<"vec4"> {
+export declare class TAANode extends Node<"vec4"> {
     scene: Scene;
     camera: PerspectiveCamera | OrthographicCamera;
     static get type(): string;
@@ -11,6 +11,8 @@ export declare class TAANode extends TempNode<"vec4"> {
     useSubpixelCorrection: boolean;
     private readonly source;
     private readonly history;
+    private readonly historyColor;
+    private readonly historyDepth;
     private readonly textureNode;
     private readonly material;
     private readonly quad;

package/dist/types/addons/taaShared.d.cts

@@ -1,4 +1,4 @@
-import { Camera, Matrix4, OrthographicCamera, PerspectiveCamera, RenderTarget, Vector2, Vector3 } from 'three';
+import { Camera, Matrix4, OrthographicCamera, PerspectiveCamera, RenderTarget, TextureDataType, Vector2, Vector3 } from 'three';
 type TAACamera = PerspectiveCamera | OrthographicCamera;
 type TAAParameters = {
     depthThreshold: number;
@@ -22,7 +22,7 @@ export declare function createTAAState<FloatUniform extends {
     (value: Vector2): Vec2Uniform;
     (value: Vector3): Vec3Uniform;
     (value: Matrix4): Mat4Uniform;
-}, targets: RenderTarget[]): {
+}, targets: RenderTarget[], nodeLogDepth?: boolean): {
     uniforms: {
         renderSize: Vec2Uniform;
         projection: Mat4Uniform;
@@ -34,6 +34,7 @@ export declare function createTAAState<FloatUniform extends {
         reversed: BoolUniform;
         logarithmic: BoolUniform;
         logFar: Vec2Uniform;
+        logNear: Vec2Uniform;
         depthThreshold: FloatUniform;
         edgeDepthDiff: FloatUniform;
         maxMotionLength: FloatUniform;
@@ -44,6 +45,7 @@ export declare function createTAAState<FloatUniform extends {
     jitterIndex: number;
     reset(): void;
     setSize(width: number, height: number): void;
+    setStencil(stencil: boolean, depthType: TextureDataType): void;
     beginCapture(camera: TAACamera): void;
     endCapture(camera: TAACamera): void;
     prepareResolve(camera: TAACamera, parameters: TAAParameters): 0 | 1;

package/dist/types/addons/taaShared.d.ts

@@ -1,4 +1,4 @@
-import { Camera, Matrix4, OrthographicCamera, PerspectiveCamera, RenderTarget, Vector2, Vector3 } from 'three';
+import { Camera, Matrix4, OrthographicCamera, PerspectiveCamera, RenderTarget, TextureDataType, Vector2, Vector3 } from 'three';
 type TAACamera = PerspectiveCamera | OrthographicCamera;
 type TAAParameters = {
     depthThreshold: number;
@@ -22,7 +22,7 @@ export declare function createTAAState<FloatUniform extends {
     (value: Vector2): Vec2Uniform;
     (value: Vector3): Vec3Uniform;
     (value: Matrix4): Mat4Uniform;
-}, targets: RenderTarget[]): {
+}, targets: RenderTarget[], nodeLogDepth?: boolean): {
     uniforms: {
         renderSize: Vec2Uniform;
         projection: Mat4Uniform;
@@ -34,6 +34,7 @@ export declare function createTAAState<FloatUniform extends {
         reversed: BoolUniform;
         logarithmic: BoolUniform;
         logFar: Vec2Uniform;
+        logNear: Vec2Uniform;
         depthThreshold: FloatUniform;
         edgeDepthDiff: FloatUniform;
         maxMotionLength: FloatUniform;
@@ -44,6 +45,7 @@ export declare function createTAAState<FloatUniform extends {
     jitterIndex: number;
     reset(): void;
     setSize(width: number, height: number): void;
+    setStencil(stencil: boolean, depthType: TextureDataType): void;
     beginCapture(camera: TAACamera): void;
     endCapture(camera: TAACamera): void;
     prepareResolve(camera: TAACamera, parameters: TAAParameters): 0 | 1;

package/dist/types/rendering/GaussianSplatRenderer.d.cts

@@ -50,7 +50,8 @@ export interface GaussianSplatRendererOptions {
     /**
      * Maximum standard deviations from the center to render Gaussians. Values
      * Math.sqrt(4)..Math.sqrt(9) produce acceptable results and can be tweaked for
-     * performance.
+     * performance. A Gaussian still above minAlpha at this distance fades to
+     * minAlpha there instead of ending in a step.
      * @default Math.sqrt(8)
      */
     maxStdDev?: number;
@@ -62,7 +63,7 @@ export interface GaussianSplatRendererOptions {
     minPixelRadius?: number;
     /**
      * Minimum alpha value for splat rendering.
-     * @default 1 / 255
+     * @default 0.5 / 255
      */
     minAlpha?: number;
     /**
@@ -258,6 +259,9 @@ export declare class GaussianSplatRenderer extends THREE.Mesh<SplatGeometry, Spl
         minAlpha: {
             value: number;
         };
+        edgeFade: {
+            value: THREE.Vector2;
+        };
         preBlurAmount: {
             value: number;
         };

package/dist/types/rendering/GaussianSplatRenderer.d.ts

@@ -50,7 +50,8 @@ export interface GaussianSplatRendererOptions {
     /**
      * Maximum standard deviations from the center to render Gaussians. Values
      * Math.sqrt(4)..Math.sqrt(9) produce acceptable results and can be tweaked for
-     * performance.
+     * performance. A Gaussian still above minAlpha at this distance fades to
+     * minAlpha there instead of ending in a step.
      * @default Math.sqrt(8)
      */
     maxStdDev?: number;
@@ -62,7 +63,7 @@ export interface GaussianSplatRendererOptions {
     minPixelRadius?: number;
     /**
      * Minimum alpha value for splat rendering.
-     * @default 1 / 255
+     * @default 0.5 / 255
      */
     minAlpha?: number;
     /**
@@ -258,6 +259,9 @@ export declare class GaussianSplatRenderer extends THREE.Mesh<SplatGeometry, Spl
         minAlpha: {
             value: number;
         };
+        edgeFade: {
+            value: THREE.Vector2;
+        };
         preBlurAmount: {
             value: number;
         };

package/dist/types/rendering/tsl/ProjectionProgram.d.cts

@@ -30,6 +30,8 @@ export type SplatProjection = {
     /** Source color space; the draw stage applies encodeLinear. */
     rgba: Node<"vec4">;
     supportRadius: Node<"float">;
+    /** A wide kernel's low 16 bits hold its edge fade as a half. */
+    supportRadiusSquared: Node<"float">;
     kernelPower: Node<"float">;
 };
 /** Shared projection for vertex and compute paths. Call inside a TSL Fn. */

package/dist/types/rendering/tsl/ProjectionProgram.d.ts

@@ -30,6 +30,8 @@ export type SplatProjection = {
     /** Source color space; the draw stage applies encodeLinear. */
     rgba: Node<"vec4">;
     supportRadius: Node<"float">;
+    /** A wide kernel's low 16 bits hold its edge fade as a half. */
+    supportRadiusSquared: Node<"float">;
     kernelPower: Node<"float">;
 };
 /** Shared projection for vertex and compute paths. Call inside a TSL Fn. */

package/dist/types/rendering/tsl/SplatMaterial.d.cts

@@ -8,6 +8,7 @@ export type ProjectedVertexData = {
     splatUv: Node<"vec2">;
     /** Stochastic variant only. */
     stochasticSeed?: Node<"uint">;
+    /** A wide kernel's low 16 bits hold its edge fade as a half. */
     supportRadiusSquared: Node<"float">;
     kernelPower: Node<"float">;
     viewportOrigin: Node<"vec2">;

package/dist/types/rendering/tsl/SplatMaterial.d.ts

@@ -8,6 +8,7 @@ export type ProjectedVertexData = {
     splatUv: Node<"vec2">;
     /** Stochastic variant only. */
     stochasticSeed?: Node<"uint">;
+    /** A wide kernel's low 16 bits hold its edge fade as a half. */
     supportRadiusSquared: Node<"float">;
     kernelPower: Node<"float">;
     viewportOrigin: Node<"vec2">;

package/dist/types/rendering/uniforms.d.cts

@@ -38,6 +38,9 @@ export declare function makeSplatUniforms(): {
     minAlpha: {
         value: number;
     };
+    edgeFade: {
+        value: THREE.Vector2;
+    };
     preBlurAmount: {
         value: number;
     };

package/dist/types/rendering/uniforms.d.ts

@@ -38,6 +38,9 @@ export declare function makeSplatUniforms(): {
     minAlpha: {
         value: number;
     };
+    edgeFade: {
+        value: THREE.Vector2;
+    };
     preBlurAmount: {
         value: number;
     };

package/docs/Architecture.md

@@ -53,6 +53,11 @@ In `webgpu/`, `ProjectedSplats.ts` coordinates projection and sorting, `Projecti
 
 Projected Splat support is capped at the viewport's short side, in projection space scaled by `focalAdjustment`, in both the TSL projection program and the GLSL vertex shader. The quad and its UV extent shrink by the same ratio, preserving the Gaussian profile.
 
+A kernel still above `minAlpha` where its support ends is faded there instead of cut off. The fragment stage rescales it about its peak, `(alpha + fade) * kernel - fade`, so it reaches `minAlpha` at the support edge. The quad is never enlarged.
+
+- **Gaussians.** Only `maxStdDev` can end a Gaussian early, so its fade follows from its alpha and the per-draw `edgeFade` uniform, a scale and offset derived from `maxStdDev` and `minAlpha`. It needs no per-Splat data, and a Gaussian that `minAlpha` already ends is drawn exactly as before.
+- **Wide kernels.** The edge value depends on the kernel power, so the projection computes the fade and stores it as a half in the low 16 bits of the squared support radius. That radius is first rounded down to its high 16 bits, at most 0.6% of the radius, which keeps the fragment stage's radius test exact. The squared radius therefore passes to the fragment stage bit for bit, and native WebGPU caches it in place of the radius.
+
 Errors from automatic updates are caught and logged once per message; a draw whose preparation fails is skipped. Explicit `update()` calls rethrow to the caller. `frameCallbacks` is an internal flag for a second renderer on the same scene, so each `SplatMesh.onFrame` runs once per frame.
 
 Resource rules:
@@ -88,6 +93,7 @@ Seeds exist only for stochastic draws: WebGL accumulators omit the seed layer in
 
 - `taaShared.ts` owns the state both share: a 32-entry Halton(2, 3) jitter sequence, jittered and unjittered projections, previous-frame matrices, the history index, sizing, and reset. It supports custom projections, scaled rigs, reversed depth, and logarithmic depth.
 - Each implementation captures the scene itself into a half-float target with a depth texture and resolves between two history targets, with no history copies. The resolve applies depth rejection away from edges, neighborhood clipping, and luminance-aware blending.
+- The capture target takes a stencil buffer when the Three.js renderer has one; the history targets never do, since the resolve writes only color and depth. Depth stays 32-bit float, except in `TAANode` on the WebGL2 fallback or on a device without `depth32float-stencil8`, where it is 24-bit.
 - The camera's projection is jittered only during capture. Native Splat projection reads the unjittered matrix through `getTAAProjection()`, so projection and sorting results are reused while only the jitter changes.
 - `TAAPass` flags its capture target as an XR-style target, so Three.js converts materials to `renderer.outputColorSpace` before blending, matching canvas blending. Tone mapping is disabled during capture. The final copy decodes the sRGB transfer into the composer's working-space buffer, the inverse of `OutputPass`, so the two round-trip at any alpha; as the last pass it presents the output-space image unchanged. An output color space change resets history.
 - `TAANode` is a TSL node updated once per render. It captures and accumulates in `ColorManagement.workingColorSpace`, leaving tone mapping and output conversion to `RenderPipeline`. A working color space change resets history.

package/docs/GaussianSplatRenderer.md

@@ -30,9 +30,9 @@ Every option except `renderer` and `timer` is also a property, so you can change
 
 | Option | Type | Default | Description |
 | --- | --- | --- | --- |
-| `maxStdDev` | `number` | `Math.sqrt(8)` | How far each Splat extends from its center. Lower values trim its soft outer edge and render faster; `Math.sqrt(4)` to `Math.sqrt(9)` looks acceptable |
+| `maxStdDev` | `number` | `Math.sqrt(8)` | How far each Splat extends from its center. Lower values trim its soft outer edge and render faster; a trimmed Splat fades to `minAlpha` at its edge instead of ending in a step. `Math.sqrt(4)` to `Math.sqrt(9)` looks acceptable |
 | `minPixelRadius` | `number` | `1` | Skip Splats smaller than this radius in screen pixels |
-| `minAlpha` | `number` | `1 / 255` | Hide the parts of a Splat more transparent than this |
+| `minAlpha` | `number` | `0.5 / 255` | Hide the parts of a Splat more transparent than this |
 | `preBlurAmount` | `number` | `0.3` | Enlarge and soften Splats. Use `0` for models trained with anti-aliasing |
 | `blurAmount` | `number` | `0` | Soften Splats while adjusting their opacity to compensate. For models trained with anti-aliasing, use `0.3` together with `preBlurAmount: 0` |
 | `clipXY` | `number` | `1.25` | How far outside the view a Splat's center may be before the Splat is skipped; `1` cuts exactly at the edge |

package/docs/TAAPass.md

@@ -15,6 +15,7 @@ Both render the scene themselves and need no velocity buffer or other scene setu
 
 - **One camera.** A `PerspectiveCamera` or `OrthographicCamera`, including custom projections, scaled camera rigs, reversed depth, and logarithmic depth. WebXR is not supported.
 - **Camera movement only.** Moving objects and changes to individual Splats are not tracked, and may leave a faint trail.
+- **Stencil follows your renderer.** Create the Three.js renderer with `stencil: true` and stencil masks work as they do without TAA, including the stencil settings on your Splat renderer's `material`.
 - **Reset after a jump.** Call `taa.reset()` after a camera cut or after replacing the scene. Resizing resets automatically.
 - **Keep rendering while the image settles.** With on-demand rendering, render several more frames after each change. The viewer renders 32.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gaussian-splat-lite",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Three.js Gaussian Splatting renderer with WebGPU/WebGL2, GPU sorting, streaming LOD, and high-precision GIS/ECEF support. Supports PLY, SPZ, SOG and RAD.",
   "author": "William Liu <lyz15972107087@gmail.com>",
   "type": "module",