UnityGaussianSplatting 项目完整配置与使用指南
UnityGaussianSplatting 是一个基于 SIGGRAPH 2023 论文《3D Gaussian Splatting for Real-Time Radiance Field Rendering》的开源项目,专门用于在 Unity 引擎中实时可视化 Gaussian Splatting 模型。该项目实现了对已生成高斯点云模型的实时渲染功能,为开发者和研究者提供了一个便捷的3D高斯渲染工具。
项目环境要求与准备
系统要求
- Windows、Mac 或 Linux 操作系统
- 支持 DirectX 12、Metal 或 Vulkan 图形 API 的显卡
- 至少 8GB 可用内存
- Unity 2022.3 或更高版本
必备软件安装
- 下载并安装 Unity Hub
- 在 Unity Hub 中安装 Unity 2022.3 LTS 版本
- 安装 Git 版本控制工具
项目获取
使用以下命令克隆项目到本地:
git clone https://gitcode.com/gh_mirrors/un/UnityGaussianSplatting.git
项目配置详细步骤
Unity 项目设置
- 启动 Unity Hub,点击"添加"按钮
- 选择克隆项目中的
projects/GaussianExample文件夹 - 等待 Unity 自动加载所有依赖包
- 打开
GSTestScene场景文件
图形 API 配置
在 Player Settings 的 Graphics APIs 部分,确保 Windows 平台使用 DX12 或 Vulkan,DX11 将无法正常工作。
核心功能使用教程
Gaussian Splat 资产创建
- 在 Unity 编辑器中打开菜单:
Tools -> Gaussian Splats -> Create GaussianSplatAsset - 在弹出的对话框中,将
Input PLY File指向你的 Gaussian Splat PLY 文件 - 选择压缩选项和输出文件夹
- 点击"Create Asset"按钮
渲染器配置
- 在场景中找到带有
GaussianSplatRenderer脚本的游戏对象 - 将创建的 Gaussian Splat 资产拖放到
Asset字段中 - 使用脚本中的控件调试和可视化数据
- 调整摄像机位置获得最佳观察效果
渲染管线集成
支持的渲染管线
该项目支持所有 Unity 渲染管线:
- 内置渲染管线(BiRP):无需额外设置,只需添加
GaussianSplatRenderer组件 - URP:在 URP 渲染器设置中添加
GaussianSplatURPFeature - HDRP:添加 CustomPass 体积对象和
GaussianSplatHDRPPass条目
渲染特性说明
- Gaussian Splat 对象在所有不透明对象和天空盒渲染之后进行渲染
- 高斯点云会与 Z 缓冲区进行测试,确保被不透明物体正确遮挡
- 高斯点云不会写入 Z 缓冲区,在渲染顺序上位于所有半透明对象之前
高级编辑功能
手动编辑高斯点云
在 GaussianSplatRenderer 对象的检查器中,点击"Edit"按钮或场景视图工具栏中的编辑工具图标,可以进入手动选择模式:
- 点击并拖动在场景视图中选择矩形区域内的点云
- Shift+拖动添加选择,Ctrl+拖动移除选择
- 按 Backspace 或 Delete 键删除选中的点云
- Ctrl/Cmd+I 反转选择,Ctrl/Cmd+A 选择所有点云
- F 键将视图聚焦到选中的点云
- 移动工具(W)允许在空间中移动选中的点云
点云切割功能
带有 GaussianCutout 组件的对象可以"虚拟删除"其区域内的点云。每个切割可以是椭圆体或盒状形状,通过常规变换控制其体积。
点云合并
当选择多个 GaussianSplatRenderer 对象时,检查器中会出现合并按钮,可以将它们合并为一个,并禁用其余的游戏对象。
性能优化建议
质量设置
- 对于编辑操作,建议在导入原始高斯点云文件时使用"Very High"质量预设
- 否则将编辑已经量化/近似的有损表示
导出功能
编辑完成后,可以使用检查器中的"Export modified PLY"按钮将结果导出回常规的 Gaussian Splat .ply 文件。该文件可以在任何其他高斯点云应用程序中使用,或重新导入到同一个 Unity 项目中。
平台兼容性说明
已测试平台
- Windows(D3D12 或 Vulkan)
- Mac(Metal)
- Linux(Vulkan)
实验性支持
- 部分虚拟现实设备(HTC Vive、Varjo Aero、Quest 3 和 Quest Pro)
- 移动设备可能部分支持
不支持的平台
- 使用 OpenGL 或 OpenGL ES 的设备
- WebGPU 目前尚未完全支持所有必需的图形功能
性能基准数据
以论文中的"bicycle"场景为例,包含 610 万个点云,在 1200x797 分辨率下渲染:
-
Windows(NVIDIA RTX 3080 Ti)
- 官方 SBIR 查看器:7.4ms(135FPS),4.8GB VRAM 使用
- Unity(DX12 或 Vulkan):6.8ms(147FPS),1.3GB VRAM 使用
-
Mac(Apple M1 Max)
- Unity(Metal):21.5ms(46FPS)
通过以上完整的配置和使用指南,您可以快速上手 UnityGaussianSplatting 项目,并在 Unity 中体验高质量的 3D 高斯点云实时渲染效果。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考







