Reall3dViewer

Reall3dViewer is a 3D Gaussian Splatting viewer built on Three.js. Crafting an exceptional 3DGS viewer is no small feat, which is why we've chosen to open-source our project. We hope to harness the collective wisdom and efforts of the community to drive the advancement of 3DGS applications together!

Features

• Support formats: .ply, .splat, .spx, .spz(v2,v3), .sog(v1,v2)
• Support mark and measurement
• Support text watermark
• Support 1st to 3rd degree spherical harmonics
• Support rendering models within maps

.spx

• Format Specification: https://github.com/reall3d-com/Reall3dViewer/blob/main/SPX_EN.md
• Conversion Tool: https://github.com/gotoeasy/gsbox

Basic Usage

use source code

# develop
npm run dev

# build
npm run build

# open a web browser to render your 3dgs model
# http://hostname:port/index.html?url=your-model-link-address

# .spx file can be obtained through conversion using the gsbox
gsbox p2x -i /path/to/input.ply -o /path/to/output.spx -sh 0

use npm package sample project here

# install
npm install @reall3d/reall3dviewer

# use built-in viewer
const viewer = new Reall3dViewer({ root: '#gsviewer' });
viewer.addModel(`https://reall3d.com/demo-models/yz.spx`);

# use splat mesh
const splatMesh = new SplatMesh({ renderer, scene, controls});
splatMesh.addModel({ url: 'https://reall3d.com/demo-models/yz.spx' });
scene.add(splatMesh);

Docs(By Zread)

• https://zread.ai/reall3d-com/Reall3dViewer

TODO

• Continuously optimize and enhance rendering performance
• Large scene

Acknowledgments

We would like to express our gratitude to the following projects for their valuable reference implementations

• https://github.com/antimatter15/splat
• https://github.com/mkkellogg/GaussianSplats3D
• https://github.com/huggingface/gsplat.js
• https://github.com/playcanvas/supersplat
• https://github.com/sxguojf/three-tile