LichtFeld Studio实时交互查看器使用教程：轻松玩转3D Gaussian Splatting模型
项目地址: https://gitcode.com/gh_mirrors/ga/gaussian-splatting-cuda LichtFeld Studio是一款基于C++和CUDA构建的3D Gaussian Splatting模型实时交互查看器，它能够为用户提供无与伦比的速度和流畅的3D模型交互体验。通过本教程，您将快速掌握如何安装、启动并使用LichtFeld Studio查看器来探索和操作3D Gaussian Splatting模型。
准备工作：安装LichtFeld Studio的系统要求
在开始使用LichtFeld Studio之前，请确保您的系统满足以下要求：
- CUDA Toolkit 12.8或更高版本
- CMake 3.30或更高版本
- vcpkg（需设置
VCPKG_ROOT环境变量） - GCC 14+（Linux系统）或Visual Studio 2022 v17.10+（Windows系统）
快速上手：两种构建LichtFeld Studio的方法
1. 本地开发构建（适合开发者）
这种构建方式仅针对您的GPU进行优化，编译速度最快，适合开发和测试。
cmake -B build
cmake --build build -j 16
./build/LichtFeld-Studio -d data/test
2. 可移植构建（适合普通用户）
创建一个自包含的软件包，可以在任何装有NVIDIA驱动的机器上运行，无需安装CUDA和vcpkg。
cmake -B build -DBUILD_PORTABLE=ON
cmake --build build -j 16
cmake --install build --prefix ./dist
./dist/bin/run_lichtfeld.sh -d data/test
两种构建方式的主要区别如下：
| 本地开发构建 | 可移植构建 | |
|---|---|---|
| 输出 | build/LichtFeld-Studio (66 MB) | dist/ folder (518 MB) |
| 目标机器需要CUDA | 是 | 否 |
| 目标机器需要vcpkg | 是 | 否 |
| 自包含 | 否 | 是 |
| 使用场景 | 开发 | 终端用户分发 |
启动LichtFeld Studio实时交互查看器
成功构建后，您可以通过以下命令启动LichtFeld Studio查看器：
-
对于本地开发构建：
./build/LichtFeld-Studio -d data/test -
对于可移植构建：
./dist/bin/run_lichtfeld.sh -d data/test
其中，-d data/test参数指定了要加载的3D模型数据目录。您可以将data/test替换为您自己的3D Gaussian Splatting模型数据目录。
探索LichtFeld Studio查看器界面
启动LichtFeld Studio后，您将看到一个功能丰富的界面，主要包括以下几个部分：
LichtFeld Studio实时交互查看器展示3D Gaussian Splatting模型的界面
-
主视图区域：中央的大窗口是3D模型的主视图，您可以在这里查看和交互3D Gaussian Splatting模型。
-
控制面板：右侧的面板提供了各种控制选项，您可以调整模型的渲染参数、视角、光照等。
-
工具栏：顶部或侧边的工具栏包含常用的操作按钮，如旋转、缩放、平移模型等。
基本操作：与3D模型交互
LichtFeld Studio提供了直观的鼠标和键盘操作方式，让您可以轻松与3D模型进行交互：
- 旋转模型：按住鼠标左键并拖动
- 平移模型：按住鼠标中键并拖动
- 缩放模型：使用鼠标滚轮或按住鼠标右键并拖动
- 重置视图：按下空格键
高级功能：自定义模型渲染效果
通过右侧的控制面板，您可以调整各种渲染参数，以获得不同的视觉效果：
- 调整点大小：通过"Point Size"滑块改变模型中点的大小
- 切换渲染模式：在不同的渲染模式（如点云、网格等）之间切换
- 调整光照效果：修改光源的位置、强度和颜色
- 启用/禁用特效：如阴影、反射等高级渲染效果
故障排除：常见问题解决方法
在使用LichtFeld Studio过程中，您可能会遇到以下问题：
-
"CUDA driver version is insufficient"：更新您的NVIDIA驱动程序。
-
"no kernel image is available"：您的GPU可能比
BUILD_CUDA_MIN_SM指定的版本旧。可以通过重新构建并设置较低的BUILD_CUDA_MIN_SM值来解决，例如：cmake -B build -DBUILD_CUDA_MIN_SM=70 -
目标机器上缺少库：对于可移植构建，使用
run_lichtfeld.sh（Linux）或确保DLL文件与可执行文件在同一目录（Windows）。
总结
通过本教程，您已经了解了如何构建、启动和使用LichtFeld Studio实时交互查看器来探索3D Gaussian Splatting模型。无论您是开发者还是普通用户，LichtFeld Studio都能为您提供快速、流畅的3D模型查看体验。现在，您可以开始使用这个强大的工具来探索和展示您的3D Gaussian Splatting模型了！
如果您想深入了解LichtFeld Studio的更多功能，可以查阅官方文档：docs/
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
