gaussian-splat-lite 1.2.0 → 1.2.2

package/CHANGELOG.md

@@ -7,11 +7,51 @@ and this project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.2.2] - 2026-10-07
+
+### Added
+
+- Added a Blend buffer option to the viewer, set to Half float by default. It removes the overlapping rings that 8-bit blending leaves in faint gradients. Very bright Splats behind others can look slightly brighter than before; choose 8-bit to return to the previous image.
+- Added stencil masking to `TAAPass` and `TAANode`. Create the Three.js renderer with `stencil: true` and the scene's stencil masks apply as they do without TAA, including the stencil settings on your Splat renderer's `material`; before, they were ignored. `WebGPURenderer` on WebGPU needs Three.js r187 or later for this; on r186, leave `stencil` off there when using `TAANode`.
+
+### Changed
+
+- `TAANode` avoids redundant screen-texture transforms and repeated depth sampling while retaining its single-pass temporal filter.
+- The default `minAlpha` is now `0.5 / 255` instead of `1 / 255`, so faint Splats and the outer edge of others reach a little further. Set `minAlpha: 1 / 255` to keep the previous look.
+- A Splat that `maxStdDev` trims while it is still more opaque than `minAlpha` now fades to `minAlpha` at its edge instead of ending in a visible step. This includes the wide Splats of LOD data. Splats are not drawn any larger, so lower `maxStdDev` values keep their speed and look smoother. Edges are slightly more transparent than before, most visibly at low `maxStdDev`; Splats that are not trimmed look the same.
+- `minPixelRadius` now measures the wide Splats of LOD data by their visible size, as it already did for other Splats, so the smallest ones are skipped slightly earlier.
+
+### Fixed
+
+- Fixed `TAANode` with `logarithmicDepthBuffer`, where the image blurred and ghosted whenever the camera moved. `TAAPass` was not affected.
+
+## [1.2.1] - 2026-10-06
+
+### Added
+
+- Added `encodeLinear` to `GaussianSplatRenderer` to choose how model colors are converted before blending: `true` converts them to linear, `false` keeps their sRGB values. Left unset, the conversion is automatic as before.
+- Added `SplatCapture` for rendering Splat scenes offscreen: render targets with optional supersampling and double buffering, RGBA pixel readback, cube maps, and environment maps for reflections. It works on WebGLRenderer and on WebGPURenderer with WebGPU or its WebGL2 fallback. Your render loop can keep running while a capture is in progress, and captures use your Splat renderer's quality settings. This brings back the capture methods `GaussianSplatRenderer` had in 1.1.8, under the same names. See [SplatCapture](docs/SplatCapture.md).
+
+### Changed
+
+- The default `minAlpha` is now `1 / 255` instead of `0.5 / 255`. Set `minAlpha: 0.5 / 255` to keep the previous look.
+- `TAAPass` is now used through `EffectComposer` with a final Three.js `OutputPass`; calling `taa.render(renderer)` on its own is no longer supported. Bloom and other effects go between the two passes without extra settings. Splat colors still match direct canvas rendering. `OutputPass` applies the renderer's tone mapping to the whole image, Splats included. See [TAAPass and TAANode](docs/TAAPass.md).
+
+### Removed
+
+- Removed `maxPixelRadius`. A Splat's radius on screen is now limited automatically to the short side of the viewport.
+- Removed `TAAPass.accumulateInOutputSpace`. Delete it from your code; effects after `TAAPass` no longer need it.
+- Removed the `SplatAccumulator` class and the `SplatMapping` type from the package exports. `GaussianSplatRenderer` manages the combined scene data itself. To read a model's Splats, use [Splats](docs/Splats.md).
+
+### Fixed
+
+- Fixed incorrect Splat colors that could appear on WebGPURenderer as models loaded into a previously empty scene.
+
 ## [1.2.0] - 2026-10-03
 
 ### Added
 
-- Exported `TAAPass(scene, camera)`, temporal anti-aliasing for WebGLRenderer that renders the scene itself and needs no velocity texture. Its result matches direct canvas colors and needs no `OutputPass`; set `accumulateInOutputSpace = false` for linear effects such as Bloom. Scene depth is exposed for depth effects. Exported `TAANode(scene, camera)` provides the same camera/depth reprojection in TSL for native WebGPU and WebGL2 fallback, accumulating in linear space for `RenderPipeline`, without a velocity attachment.
+- Exported `TAAPass(scene, camera)`, temporal anti-aliasing for WebGLRenderer that renders the scene itself and needs no velocity texture. Its result matches direct canvas colors and needs no `OutputPass`. Scene depth is exposed for depth effects. Exported `TAANode(scene, camera)` provides the same camera/depth reprojection in TSL for native WebGPU and WebGL2 fallback, accumulating in the working color space for `RenderPipeline`, without a velocity attachment.
 - Added `stochasticSample` and `autoAdvanceStochasticSample` to control the stochastic noise pattern, for example in a custom temporal anti-aliasing integration.
 - Added `SplatLoader.abort()`, which cancels every load the loader has in progress.
 - PLY loading now accepts headers with Windows line endings, `int8`–`float64` type names, extra elements before the vertex data, and Gaussian files that store their base color as `red`/`green`/`blue`.
@@ -511,7 +551,9 @@ 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.2.0...HEAD
+[Unreleased]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v1.2.2...HEAD
+[1.2.2]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v1.2.1...v1.2.2
+[1.2.1]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v1.2.0...v1.2.1
 [1.2.0]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v1.1.8...v1.2.0
 [1.1.8]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v1.1.7...v1.1.8
 [1.1.7]: https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/compare/v1.1.6...v1.1.7

package/README.md

@@ -29,8 +29,9 @@ High performance 3D Gaussian Splatting (3DGS) renderer for **Three.js** with **W
 | Focus | What you get |
 | --- | --- |
 | **WebGPU / WebGL2** | Use the same Three.js scene API with either renderer |
-| **Stochastic rendering** | Optional transparency mode for use with temporal anti-aliasing |
 | **Large-scene streaming** | Load RAD and SOG detail as the camera moves, with smooth transitions |
+| **Stochastic rendering** | Optional transparency mode, with built-in temporal anti-aliasing to smooth it |
+| **Offscreen capture** | Render Splats to images, cube maps, and environment maps for reflections |
 | **SDF edits** | Recolor or hide parts of a model without moving Splats |
 | **Data and precision** | Load URLs, files, or bytes; place local models in large GIS/ECEF scenes |
 
@@ -107,7 +108,7 @@ Sorted alpha blending is the default. To enable stochastic rendering:
 splatRenderer.stochastic = true;
 ```
 
-This mode produces visible noise. Use the library's [TAAPass / TAANode](docs/TAAPass.md) to smooth it: `TAAPass` for `WebGLRenderer`, and `TAANode` for `WebGPURenderer` (including its WebGL2 fallback). See [Stochastic rendering](docs/StochasticRendering.md) for sorting options and TAA setup.
+This mode produces visible noise. Smooth it with the library's [temporal anti-aliasing](docs/TAAPass.md): `TAAPass` for `WebGLRenderer`, and `TAANode` for `WebGPURenderer` (including its WebGL2 fallback). See [Stochastic rendering](docs/StochasticRendering.md) for the setup.
 
 ## Streaming large scenes
 
@@ -155,18 +156,26 @@ const streaming = new SogStreamScheduler({
 
 ## Documentation
 
-- [GaussianSplatRenderer](docs/GaussianSplatRenderer.md) — Rendering options and sorting.
-- [Stochastic rendering](docs/StochasticRendering.md) — Optional rendering mode, noise control, and temporal anti-aliasing.
-- [TAAPass / TAANode](docs/TAAPass.md) — Temporal reprojection for WebGLRenderer and WebGPURenderer without a velocity texture.
-- [SplatMesh](docs/SplatMesh.md) — Loading, transforms, animation, and raycasting.
-- [SplatLoader](docs/SplatLoader.md) — File loading.
+**Rendering**
+
+- [GaussianSplatRenderer](docs/GaussianSplatRenderer.md) — Rendering options, sorting, and on-demand rendering.
+- [Stochastic rendering](docs/StochasticRendering.md) — The optional transparency mode and how to smooth its noise.
+- [TAAPass and TAANode](docs/TAAPass.md) — Temporal anti-aliasing for WebGLRenderer and WebGPURenderer.
+- [SplatCapture](docs/SplatCapture.md) — Offscreen images, pixel readback, cube maps, and environment maps.
+
+**Models**
+
+- [SplatMesh](docs/SplatMesh.md) — Loading, transforms, animation, and picking.
+- [SplatLoader](docs/SplatLoader.md) — Three.js-style loading, progress, cancellation, and split files.
+- [SplatFileType](docs/SplatFileType.md) — PLY, SPZ, SOG, and RAD formats.
+- [postDecode](docs/PostDecode.md) — Change Splats while a model loads.
+- [SplatEdit and SplatEditSdf](docs/SplatEdit.md) — Recolor, fade, or hide parts of a model.
+- [Splats](docs/Splats.md) — Read a loaded model's data.
+
+**Large scenes**
+
 - [RadStreamScheduler](docs/RadStreamScheduler.md) — Large RAD scenes with adaptive detail.
 - [SogStreamScheduler](docs/SogStreamScheduler.md) — Large SOG scenes with adaptive detail.
-- [Splats](docs/Splats.md) — Data access and updates.
-- [SplatFileType](docs/SplatFileType.md) — PLY/SPZ/SOG/RAD formats.
-- [SplatEdit / SplatEditSdf](docs/SplatEdit.md) — Color and opacity editing.
-- [postDecode](docs/PostDecode.md) — Transform models while loading.
-- [SplatAccumulator](docs/SplatAccumulator.md) — Combined model data for custom integrations.
 
 ## Development
 
@@ -180,7 +189,7 @@ npm run dev
 
 Open the URL printed by Vite (normally `http://localhost:8080/`) and drop a `.ply`, `.spz`, `.sog`, or `.rad` file into the viewer, choose a local file, or load one from an HTTP(S) URL. For split SOG, select or drop `meta.json` together with its `.webp` images; for split RAD, include the header and its `.radc` pages. Files are decoded locally. Choose **WebGPU / WebGL2 / WebGPU · WebGL2** in the viewer to compare backends.
 
-See [Contributing](CONTRIBUTING.md#validation) for validation commands. `npm run build` emits ESM, CommonJS, TypeScript declarations, and source maps in `dist/`.
+See [Contributing](CONTRIBUTING.md#validation) for validation commands, and [Architecture](docs/Architecture.md) for how the library is built internally. `npm run build` emits ESM, CommonJS, TypeScript declarations, and source maps in `dist/`.
 
 ## Acknowledgements