# Changelog All notable changes to BelowJS will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [1.7.6] - 2026-04-28 ### Fixed - Hotfix: GLB loading no longer bakes detected photogrammetry mesh transforms into geometry, fixing distorted or cube-like models in the basic viewer. ## [1.7.5] - 2026-04-28 > Deprecated: this release introduced a regression in some GLB model loading paths. Use 1.7.6 or later. ### Changed - Improved GLB loading for Sketchfab photogrammetry exports, with more consistent material handling and cleaner shading. - In the guides, clarified how to load directly from [Sketchfab GLB exports](docs/guides/sketchfab-models.html). ### Fixed - Reduced texture banding and glossy-material bleed-through on photogrammetry and comparison heatmap views. - Model comparison camera locking now waits for a valid alignment solve. - Pressing `0` in model comparison reframes the loaded model view. - Improved model comparison stability when switching views, dragging markers, and running C2C or height comparisons. ## [1.7.4] - 2026-04-28 ### Added - Added the model comparison viewer for aligning two survey models with matched markers, viewing overlay/difference modes, and generating C2C and height comparison maps. ### Fixed - Survey lighting casts cleaner shadows on close-range photogrammetry surfaces. - Long-pressing the viewer on mobile no longer triggers stray text selection, while form controls and editable fields inside the viewer still allow normal text interaction. ## [1.7.3] - 2026-03-06 ### Fixed - Animation example dive toggle now uses the stateful dive-mode API, making fog activation reliable when switching into dive mode. - Pressing `Z` now keeps the animation example's custom dive-mode toggle UI in sync with the active dive mode state. - Comfort-mode teleport now uses Y-only aiming, suspends snap turn while active, supports either controller, and keeps floor-height adjustment on the other controller. - Comfort-mode teleport visuals now keep the arc stable and the landing marker clean, with a flat floor ring plus a subtle camera-facing half-arch. - Measurement ghost spheres no longer appear oversized after returning from the Quest browser (scale reset was resetting to 1.0 instead of 0.5). ## [1.7.2] - 2026-02-15 ### Fixed - Model selector dropdown and dive mode toggle remain interactive after opening the Quest system menu, so model/mode changes can be made before returning to immersive view. --- ## [1.7.1] - 2026-02-15 ### Fixed - Keyboard screenshot shortcut (`H`) no longer triggers while typing in form fields (`input`, `select`, `textarea`, or `contenteditable` elements). --- ## [1.7.0] - 2026-02-15 ### Added - BelowJS support for Cesium 3D Tiles loading via the NASA-AMMOS 3DTilesRendererJS library, including tiled models exported from Agisoft Metashape. - `tileset` example configured with the Denton Holme and Macedon 2023 dataset. - `examples/tileset/convert-3tz.sh` conversion script for Agisoft Metashape `.3tz` exports, producing a web-hostable tileset folder with root `tileset.json`. ### Changed - Examples docs describe six production-ready viewers. ### Fixed - Removed ARCore lint warnings from unused catch variables. --- ## [1.6.0] - 2026-02-15 ### Added - Programmatic comfort-mode APIs (work in and out of active VR sessions): - `ModelViewer`: `setComfortMode(enabled)`, `toggleComfortMode()`, `getComfortMode()` - `BelowViewer`: `setVRComfortMode(enabled)`, `toggleVRComfortMode()`, `isVRComfortModeEnabled()` - Per-model measurement availability via optional `models[modelKey].measurable` (defaults to `true` for backward compatibility) - Non-measurable model UX for measurement panel: stays visible but disabled/unusable, blocks desktop/VR measurement input, and shows native tooltip text (`This model is marked as not measurable`) ### Changed - Comfort toggle styling tightened; active state keeps a clear green ring - Comfort teleport visuals tuned: thinner arc, lower marker/floor intensity, and range adjusted to 1.5m-20m ### Fixed - Prevent unintended switches to dive mode during immersive AR sessions (keyboard/controller toggles are ignored in AR, and AR session start enforces survey mode) - Graceful viewer recovery after tab focus/context interruptions: auto-retry model loading on refocus and recover from `webglcontextlost`/`webglcontextrestored` blank-screen states - Programmatic comfort-mode changes now sync immediately to the comfort glyph during active VR sessions - Double-click focus now behaves correctly with desktop measurement enabled: measurement mode owns double-click interaction and focus animation can be interrupted by user input --- ## [1.5.0] - 2026-02-06 ### Added - Fly mode controls with F key or Shift+~ to activate - port from animation example into core library - **Stereoscopic viewing mode (Experimental)**: side-by-side stereo rendering with configurable eye separation - Stereo example with adjustable eye separation controls - `stereo()` console command for enabling/disabling stereo mode and adjusting eye separation - Z key to toggle between dive mode and studio mode - H key to take screenshot - Experimental 3D Tiles streaming loader for massive datasets - New `tileset` example (`npm run dev:tileset`) with a NASA-AMMOS sample dataset default and URL override support ### Changed - Material conversion upgraded from MeshLambertMaterial to MeshStandardMaterial with shipwreck-appropriate PBR defaults (roughness 0.8, metalness 0.3) - Studio lighting increased by 10% to compensate for improved material reflections - Measurement display: distances ≤ 20 cm now shown in cm with 2 decimal places, smaller sphere markers for precision ### Fixed - Raycasting accuracy in stereo viewing mode - VR button visibility management with fly mode controls - Support for deprecated KHR_materials_pbrSpecularGlossiness GLTF extension by converting to standard PBR materials - Support for logarithmicDepthBuffer renderer option (suppresses ConfigValidator warning) --- ## [1.4.1] - 2025-12-26 ### Added - `setDensity(multiplier)` method on DiveParticles to dynamically adjust particle density (0-2x range) - Animation example improvements: demo model link, mobile UI polish --- ## [1.4.0] - 2025-12-24 ### Added #### Animation Example New [animation example](https://patrick-morrison.github.io/belowjs/examples/animation/) for producing shipwreck visualisations in seconds. Designed to mirror our Blender workflow, this demonstrates advanced features built on top of the core viewer: - Timeline-based keyframe animation with easing - Orbit mode for quick feature visualisations - Flight mode navigation, as well as orbit - Controls on the custom dive lighting system - Local save and load of keyframes and settings - Video export as MP4s #### AR Support (Experimental) Implements passthrough for AR viewing of 3D models with sensible defaults, natural-feeling hand tracking control and the same studio lighting system used in desktop mode: - **Hand tracking gestures**: Single-hand movement, two-hand rotate and scale with logarithmic scaling and inertia - **Quest 2/3 optimisation**: Automatic device detection and far-plane adjustments - **Designed with shared spaces in mind**: `setInteractionEnabled()` method to lock/unlock hand interactions for remote collaboration scenarios > **Note**: AR support is experimental and may change in future releases, it is being co-developed with a networked viewer. ### Fixed - VR audio assets now copied losslessly in docs examples --- ## [1.3.0] - 2025-11-09 - Desktop Quest Link streaming support, best tried with the drag-and-drop viewer (). ## [1.2.0] - 2025-09-10 ### Changed - Limit Draco and KTX2 loader workers to a single thread on iOS to reduce Safari/iOS 26 startup memory pressure. - Scope shared KTX2 loader instances per platform so renderer detection is repeated only where needed. ### Fixed - Release cached GLTF scenes, textures, and parser registries as soon as models are cleared to stop Safari desktop/iOS 26 from crashing during model swaps. - Clean up abort listeners and converted materials immediately after GLTF loads so cancelled requests don’t hold onto GPU resources, matching Apple’s iOS 26 WebKit guidance. ## [1.1.0] - 2025-09-03 ### Added - Screenshot capture button in the viewer UI - `enableScreenshot` config option on `ModelViewer` - `takeScreenshot()` method to programmatically save a PNG - Styles for `.screenshot-button` and light/no-measurement variants ### Changed - Enable `preserveDrawingBuffer` on the renderer to support screenshots - Examples updated to include `enableScreenshot: true` ## [1.0.0] - 2025-08-27 - Stable Release ## [1.0.1] - 2025-09-03 ### Changed - Cleaned the basic example (`examples/basic/index.html`): - Remove legacy `#vrComfortButton` style rule - Remove redundant manual dropdown listener (internal handler used) - Disable `autoLoadFirst` and explicitly load initial model (`kxi`) ### Release Notes - **Stable 1.0.0**: First stable release of the BelowJS library - **Production ready**: Complete 3D model viewer with VR support - **Comprehensive documentation**: Full documentation site with examples and guides - **Quality assurance**: Thorough testing and quality checks completed ### Summary BelowJS 1.0.0 is now production-ready for underwater/dive model visualization with WebXR support, measurement tools, and comprehensive documentation. The API is stable and fully documented. **Now Live in Production:** BelowJS 1.0.0 is powering WreckSploration VR - the first production implementation featuring shipwreck exploration in virtual reality. ## [1.0.0-rc.4] - 2025-08-19 - Release Candidate ### Added - WreckSploration VR implementation showcase - Comprehensive guides for development workflows - CDN reference management for all documentation examples ### Improved - Documentation structure and navigation - Static documentation system with better maintainability ### Fixed - Info panel not showing properly by adding below-panel class ## [1.0.0-rc.3] - 2025-08-14 - Release Candidate ### Fixed - Loading spinner percentage now clamped to maximum 100% - Loading spinner display issues in light mode - Fixed wrecksploration.com reference to correct wrecksploration.au domain ### Improved - Example documentation clarity and structure ## [1.0.0-rc.2] - 2025-08-12 - Release Candidate ### Fixed - VR locomotion reset bug when switching models ### Added - VR loading indicator for model changes - Complete static documentation site ### Improved - Audio system robustness ## [1.0.0-rc.1] - 2025-08-10 - Release Candidate ### Added - **Release Candidate**: First public release candidate of the BelowJS library - **Complete 3D viewer**: GLB model loading with VR support and measurement tools - **WebXR Integration**: Full VR support optimized for Meta Quest 3 - **Measurement System**: Desktop and VR measurement tools with proper cleanup - **Dive Mode**: Underwater lighting simulation and particle effects - **Multiple Examples**: Basic viewer, drag-drop loader, and embeddable viewer ### Technical Details - Built on Three.js 0.179.1 with modern ES modules - Modular architecture with clean separation of concerns - Event-driven system for extensibility - Production-ready with comprehensive error handling