3dtiles-inspector 0.2.14 → 0.2.16

package/CHANGELOG.md

@@ -6,6 +6,42 @@ The format is based on Keep a Changelog and this project follows Semantic Versio
 
 ## [Unreleased]
 
+## [0.2.16] - 2026-06-23
+
+### Added
+
+- Added an editable crop-sphere size input for setting the sphere radius
+  directly.
+
+### Changed
+
+- Changed active crop-sphere editing so short clicks on tiles move the sphere
+  center while drag gestures continue to rotate the camera.
+- Changed active crop-sphere previews to highlight splats outside the sphere
+  while leaving inside splats unchanged.
+- Changed the viewer background from pure white to a slightly darker neutral
+  tone.
+
+### Fixed
+
+- Fixed pending crop-sphere deactivation leaving the sphere wireframe visible.
+- Fixed save operations allowing crop-sphere size, crop-sphere transform, or
+  root scale track changes while saving was in progress.
+
+## [0.2.15] - 2026-06-23
+
+### Added
+
+- Added a single crop-sphere selection for Gaussian splats, with radius
+  adjustment, transform controls, preview highlighting, confirmed outside
+  hiding, center-point local-coordinate sphere/transform axes, and save-time
+  removal of splats outside the sphere.
+
+### Changed
+
+- Changed camera picking on Gaussian splats to ignore areas hidden by confirmed
+  crop regions and crop sphere.
+
 ## [0.2.14] - 2026-06-19
 
 ### Changed

package/README.md

@@ -92,14 +92,14 @@ const {
 - `Terrain`, off by default, to toggle Cesium World Terrain after entering a Cesium ion token, while keeping satellite imagery
 - `Geometric Error` scaling from `1/16x` to `16x`
 - `Layer Multiplier` scaling from `1/8x` to `8x` for each tile's geometric-error difference from the tileset's global leaf baseline
-- `Crop Regions` for drawing screen-space exclude regions on 3D Gaussian Splat tilesets
-- `Save` to persist root transform edits, geometric-error scaling, and confirmed crop regions back to disk
+- `Crop Regions` for drawing screen-space exclude regions or a crop sphere on 3D Gaussian Splat tilesets
+- `Save` to persist root transform edits, geometric-error scaling, and confirmed crop selections back to disk
 
 ### Crop Regions
 
-`Crop Regions` appears when the loaded tileset contains 3D Gaussian Splat content. It lets you draw one or more screen-space exclude rectangles, preview them in the viewer, then apply the crop when you click `Save`.
+`Crop Regions` appears when the loaded tileset contains 3D Gaussian Splat content. It lets you draw one or more screen-space exclude rectangles or define a single crop sphere, preview them in the viewer, then apply the crop when you click `Save`.
 
-The basic workflow is:
+For screen regions:
 
 1. Click `Draw Region` and drag a rectangle over the splats to remove.
 2. Before moving the camera, drag pending corner points or side handles if the screen region needs adjustment; the pending shape must stay a convex four-sided screen quadrilateral.
@@ -108,6 +108,13 @@ The basic workflow is:
 5. Select a confirmed region row if you need to adjust its 3D far plane with the transform handle.
 6. Click `Save` to persist the root transform and delete splats inside the confirmed crop regions.
 
+For the crop sphere:
+
+1. Click `Create Sphere` to place one sphere at the current tileset center.
+2. Adjust its radius with the radius track, or select its row and move it with the sphere-center local-coordinate transform handle.
+3. Click `Confirm` to hide splats outside the sphere, or `Cancel` to discard it.
+4. Click `Save` to remove splats outside the confirmed sphere.
+
 <img src="https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/region.png" alt="Crop Regions" />
 
 Crop saving rewrites supported local `.gltf` / `.glb` Gaussian Splat resources that use `KHR_gaussian_splatting_compression_spz_2`. Fully deleted splat primitives are removed from their glTF, and empty tile content can be pruned from the tileset JSON. Remote content and unsupported Gaussian Splat encodings are rejected instead of being modified.