@reall3d/reall3dviewer 2.5.4 → 2.5.6
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 +46 -7
- package/dist/pkg.js +9216 -7829
- package/dist/pkg.umd.cjs +53 -39
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,24 +1,63 @@
|
|
|
1
|
-
|
|
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
|