@reall3d/reall3dviewer
v2.5.7
Published
reall3dviewer
Readme
Reall3dViewer
Reall3dViewer is a Three.js-based Web renderer for 3D Gaussian Splatting (3DGS). It focuses on large‑scene streaming rendering, adaptive LOD, and cross‑platform high‑performance optimization, providing high‑performance Web rendering support for enterprise‑grade 3DGS applications.
✨ Features
- ✅ Multi‑format support:
.ply,.splat,.spx,.spz,.sog,.glb(withKHR_gaussian_splattingextension) - ✅ Built‑in measurement & annotation: distance, area, flexible labeling
- ✅ Spherical harmonics: supports SH degree 1–3
- ✅ Map scene rendering: GIS basemap integration
- ✅ Per‑model independent configuration: via
.meta.jsonfiles - ✅ Adaptive rendering quality: multiple quality levels, auto‑optimized per device
- ✅ Multiple sorting algorithms: choose optimal strategy for different scenes
- ✅ Large‑scene streaming: preset‑based LOD, smooth loading for 100M+ points
🚀 Benchmarked Performance
Tested on a 150‑million‑point scene: Desktop (discrete GPU) 60 FPS, iGPU laptop 30 FPS, modern smartphone 25‑40+ FPS, older smartphone 7‑15+ FPS – stable, no overheating, no crashes.
🌐 Live Demos
You can also load your own model via URL parameter:
https://reall3d.com/reall3dviewer/examples/index.html?url=your-model.sog&debug=true
🛠️ Quick Start
Install
npm i @reall3d/reall3dviewerUse Reall3dViewer
const viewer = new Reall3dViewer({ root: '#viewer2' });
viewer.addModel(`https://reall3d.com/demo-models/yz.spx`);Use Reall3dMapViewer
const mapViewer = new Reall3dMapViewer({ root: '#viewer4' });
mapViewer.addScenes('https://reall3d.com/demo-models/map/00.scenes.json');