3dtiles-inspector 0.1.7 → 0.2.0

package/CHANGELOG.md

@@ -6,6 +6,36 @@ The format is based on Keep a Changelog and this project follows Semantic Versio
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-05-03
+
+### Added
+
+- Added `Crop Regions` for 3D Gaussian Splat tilesets, with screen-space rectangle selection, pending/confirmed region controls, preview overlays, and adjustable far-plane depth handles.
+- Added save-time Gaussian Splat cropping for supported local `.gltf` and `.glb` resources using `KHR_gaussian_splatting_compression_spz_2`, including multi-resource writes, multi-bufferView rewrites, empty tile pruning, and progress updates.
+- Added README documentation, a crop-region screenshot, and smoke-test fixtures for the 3DGS crop workflow.
+
+### Changed
+
+- Moved inspector session, HTTP server, save handling, viewer asset generation, and splat-crop logic into focused `src/server/` modules.
+- Refactored the browser viewer into focused DOM, IO, scene, navigation, screen-selection, and transform modules.
+- Updated the public `./session` export to `src/server/session.js` and routed the CLI through the package entrypoint.
+- Updated `3d-tiles-rendererjs-3dgs-plugin` from `0.1.4` to `0.1.5`.
+
+### Fixed
+
+- Fixed repeated saves on Windows failing with `EPERM` when replacing recently streamed `.glb`, `.gltf`, `.bin`, or `.json` files, including races with active tile requests.
+
+## [0.1.8] - 2026-05-03
+
+### Added
+
+- Added a camera pivot indicator for rotate, pan, and zoom interactions.
+- Added bottom-right tile runtime stats for downloading, parsing, loaded, and visible tile counts.
+
+### Changed
+
+- Moved the `Canvas` toolbar section above `Transform`.
+
 ## [0.1.7] - 2026-04-27
 
 ### Changed

package/README.md

@@ -14,6 +14,13 @@
 
 Requires Node.js 18 or newer.
 
+## Built On
+
+This project is based on and integrates work from:
+
+- [WilliamLiu-1997/3D-Tiles-RendererJS-3DGS-Plugin](https://github.com/WilliamLiu-1997/3D-Tiles-RendererJS-3DGS-Plugin)
+- [NASA-AMMOS/3DTilesRendererJS](https://github.com/NASA-AMMOS/3DTilesRendererJS)
+
 ## Install
 
 ```bash
@@ -76,7 +83,7 @@ const {
 
 ## Inspector Features
 
-<img src="https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/screenshot.png" alt="screenshot" width="960" />
+<img src="https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/screenshot.png" alt="screenshot" />
 
 - `Translate`, `Rotate`, and `Reset` for root transform edits
 - `Move Camera` to a WGS84 latitude / longitude / height
@@ -85,8 +92,25 @@ const {
 - `Terrain` to toggle Cesium World Terrain 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 the updated root transform and geometric-error scale 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`.
+
+The basic workflow is:
+
+1. Click `Screen Select` and drag a rectangle over the splats to remove.
+2. Drag the far-plane handle to set how deep the crop region extends into the scene.
+3. Click `Confirm` to add the region to the save list, or `Cancel` to discard the pending rectangle.
+4. Select a confirmed region row if you need to adjust its 3D far plane with the transform handle.
+5. Click `Save` to persist the root transform and delete splats inside the confirmed crop regions.
+
+<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.
+
 If `build_summary.json` exists next to the root tileset, `Save` also updates:
 
 - `root_transform`
@@ -95,15 +119,6 @@ If `build_summary.json` exists next to the root tileset, `Save` also updates:
 - `viewer_geometric_error_scale`
 - `viewer_geometric_error_layer_scale`
 
-## Package Surface
-
-- `src/index.js` exports the public Node API
-- `src/cli.js` implements the standalone CLI
-- `src/viewer/session.js` manages the local server, temporary assets, browser launch, and save handling
-- `src/viewer/app.js` contains the browser runtime source
-- `dist/inspector-assets/viewer/` contains the generated browser bundle and local decoder assets built by `npm run build:viewer`
-- `src/viewer/cameraController.js` contains the vendored camera controller used by the runtime
-
 ## Development
 
 ```bash