![\"3DTiles-Inspector\"](\"https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/3DTiles-Inspector.png\")
\n\n\n\n![\"screenshot\"](\"https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/screenshot.png\")
\n\n- `Translate`, `Rotate`, infinite `Scale` track/value input, and `Reset` for root transform edits\n- `Move Camera` to a WGS84 latitude / longitude / height\n- `Move Tiles` to relocate the tileset root with an ENU-aligned transform\n- `Set Position` to click the globe, terrain, or loaded tiles and place the tileset there\n- `Terrain`, off by default, to toggle Cesium World Terrain after entering a Cesium ion token, while keeping satellite imagery\n- `Render on demand`, enabled by default, to pause canvas rendering while the scene is idle\n- `Geometric Error` scaling from `1/16x` to `16x`\n- `Layer Multiplier` scaling from `1/8x` to `8x` for each tile's geometric-error difference from the tileset's global leaf baseline\n- `Crop Regions` for drawing screen-space exclude regions or a crop sphere on 3D Gaussian Splat tilesets\n- `Save` to persist root transform edits, geometric-error scaling, and confirmed crop selections back to disk\n\n### Crop Regions\n\n`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`.\n\nFor screen regions:\n\n1. Click `Draw Region` and drag a rectangle over the splats to remove.\n2. 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.\n3. Rotate, pan, or zoom the camera to fix the pending screen shape in 3D, then drag the far-plane handle to set how deep the crop region extends into the scene.\n4. Click `Confirm` to add the region to the save list, or `Cancel` to discard the pending rectangle.\n5. Select a confirmed region row if you need to adjust its 3D far plane with the transform handle.\n6. Click `Save` to persist the root transform and delete splats inside the confirmed crop regions.\n\nFor the crop sphere:\n\n1. Click `Create Sphere` to place one sphere at the current tileset center.\n2. Adjust its radius with the radius track, or select its row and move it with the sphere-center local-coordinate transform handle.\n3. Click `Confirm` to hide splats outside the sphere, or `Cancel` to discard it.\n4. Click `Save` to remove splats outside the confirmed sphere.\n\n![\"Crop](\"https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/region.png\")
\n\nCrop 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.\n\nIf `build_summary.json` exists next to the root tileset, `Save` also updates:\n\n- `root_transform`\n- `root_transform_source`\n- `root_coordinate`\n- `viewer_geometric_error_scale`\n- `viewer_geometric_error_layer_scale`\n\n## Development\n\n```bash\nnpm install\nnpm test\nnpm run pack:check\n```\n\n## Error Handling\n\nRuntime and validation failures throw `InspectorError` from the Node API and print a concise error message in the CLI.\n","readmeFilename":"README.md"}