d5-gaussian-splat-demo
v1.0.1
Published
D5 Gaussian Splat Library 本地文件渲染演示
Readme
D5 Gaussian Splat Demo
本地 3D Gaussian Splatting 文件渲染演示项目。
功能特性
- 支持本地
.ply和.splat文件加载 - 支持文件拖拽上传
- 现代化的 UI 界面
- 实时进度显示
- 内置相机控制
快速开始
1. 安装依赖
cd demo
yarn install2. 启动开发服务器
yarn dev浏览器会自动打开 http://localhost:3000
3. 加载 3DGS 文件
- 点击 "选择文件" 按钮选择本地的
.ply或.splat文件 - 或者直接将文件拖拽到页面上
操作说明
鼠标操作
- 左键拖拽 - 旋转视角
- 右键拖拽 - 平移视角
- 滚轮 - 缩放
键盘快捷键
| 按键 | 功能 |
|------|------|
| F / G | 调整焦距 |
| ← / → | 旋转相机 |
| P | 切换点云模式 |
| + / - | 调整 Splat 大小 |
项目结构
demo/
├── index.html # HTML 入口文件
├── package.json # 项目配置
├── vite.config.ts # Vite 配置
├── tsconfig.json # TypeScript 配置
├── README.md # 说明文档
└── src/
└── main.ts # 主要逻辑代码技术栈
- Vite - 构建工具
- Three.js - 3D 渲染库
- TypeScript - 类型安全
注意事项
SharedArrayBuffer 支持: 为了获得最佳性能,需要启用
Cross-Origin-Opener-Policy和Cross-Origin-Embedder-Policyheaders。Vite 开发服务器已配置这些 headers。文件大小: 大型 3DGS 文件可能需要较长的加载时间,请耐心等待。
浏览器兼容性: 建议使用最新版本的 Chrome、Firefox 或 Edge 浏览器。
构建生产版本
yarn build构建产物将输出到 dist 目录。
预览生产版本
yarn preview