@reall3d/reall3dviewer 2.5.5 → 2.5.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,24 +1,63 @@
1
- # @reall3d/reall3dviewer
1
+ <p align="center">
2
+ <img style="width:128px;height:128px" src="https://gotoeasy.github.io/reall3d/logo.png"/>
3
+ </p>
4
+
5
+ # Reall3dViewer
6
+
7
+ **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.
8
+
9
+ <br>
10
+
11
+ <p align="center">
12
+ <a href="https://zread.ai/reall3d-com/Reall3dViewer"><img src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" alt="Ask Zread" /></a>
13
+ <a href="https://github.com/reall3d-com/Reall3dViewer/blob/master/README_ZH.md"><img src="https://img.shields.io/badge/readme-Chinese-brightgreen.svg"></a>
14
+ <a href="https://github.com/mrdoob/three.js"><img src="https://img.shields.io/badge/base-Threejs-brightgreen.svg"></a>
15
+ <a href="https://github.com/reall3d-com/Reall3dViewer/releases/latest"><img src="https://img.shields.io/github/release/reall3d-com/Reall3dViewer.svg"></a>
16
+ <a href="https://github.com/reall3d-com/Reall3dViewer/blob/master/LICENSE"><img src="https://img.shields.io/github/license/reall3d-com/Reall3dViewer"></a>
17
+ <p>
18
+ <br>
19
+
20
+ ## ✨ Features
21
+
22
+ - ✅ **Multi‑format support**: `.ply`, `.splat`, `.spx`, `.spz`, `.sog`, `.glb` (with `KHR_gaussian_splatting` extension)
23
+ - ✅ **Built‑in measurement & annotation**: distance, area, flexible labeling
24
+ - ✅ **Spherical harmonics**: supports SH degree 1–3
25
+ - ✅ **Map scene rendering**: GIS basemap integration
26
+ - ✅ **Per‑model independent configuration**: via `.meta.json` files
27
+ - ✅ **Adaptive rendering quality**: multiple quality levels, auto‑optimized per device
28
+ - ✅ **Multiple sorting algorithms**: choose optimal strategy for different scenes
29
+ - ✅ **Large‑scene streaming**: preset‑based LOD, smooth loading for 100M+ points
30
+
31
+ ## 🚀 Benchmarked Performance
32
+
33
+ > 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.
34
+
35
+ ## 🌐 Live Demos
36
+
37
+ - [LOD large scene with debug panel](https://reall3d.com/reall3dviewer/examples/index.html?url=hgd-lod-meta.scene.json&debug=true)
38
+ - [Complete indoor exhibition LOD large scene](https://reall3d.com/reall3dviewer/examples/index.html?url=kcczt.scene.json)
39
+
40
+ > You can also load your own model via URL parameter:
41
+ > `https://reall3d.com/reall3dviewer/examples/index.html?url=your-model.sog&debug=true`
42
+
43
+ ## 🛠️ Quick Start
2
44
 
3
45
  Install
46
+
4
47
  ```shell
5
48
  npm i @reall3d/reall3dviewer
6
49
  ```
7
50
 
8
51
  Use Reall3dViewer
52
+
9
53
  ```js
10
54
  const viewer = new Reall3dViewer({ root: '#viewer2' });
11
55
  viewer.addModel(`https://reall3d.com/demo-models/yz.spx`);
12
56
  ```
13
57
 
14
58
  Use Reall3dMapViewer
59
+
15
60
  ```js
16
61
  const mapViewer = new Reall3dMapViewer({ root: '#viewer4' });
17
62
  mapViewer.addScenes('https://reall3d.com/demo-models/map/00.scenes.json');
18
63
  ```
19
-
20
- # Links
21
-
22
- - https://github.com/reall3d-com/Reall3dViewer
23
- - https://github.com/reall3d-com/reall3dviewer-samples-use-npm-package
24
- - https://github.com/gotoeasy/gsbox