【亲测免费】 splatviz 使用教程

1. 项目的目录结构及介绍

splatviz 是一个开源项目，用于实时编辑和分析 3D Gaussian Splatting 场景。以下是项目的目录结构及各部分功能的简要介绍：

splatviz/
├── compression/               # 压缩相关代码
├── gaussian-splatting/        # Gaussian Splatting 相关代码
├── renderer/                  # 渲染器相关代码
├── resources/                 # 资源文件
├── splatviz_utils/            # splatviz 工具类
├── widgets/                   # 小部件代码
├── .gitignore                 # Git 忽略文件
├── .gitmodules                # Git 子模块配置文件
├── LICENSE                    # 项目许可证文件
├── README.md                  # 项目说明文件
├── environment.yml            # Conda 环境配置文件
├── presets.json               # 预设代码片段文件
├── pyproject.toml             # 项目配置文件
├── run_main.py                # 项目启动文件
└── splatviz.py                # splatviz 主程序文件

• compression/: 包含与 Gaussian Splatting 场景压缩相关的代码。
• gaussian-splatting/: 包含与 Gaussian Splatting 相关的核心代码。
• renderer/: 包含渲染器相关的代码，用于渲染 3D 场景。
• resources/: 存储项目所需的各种资源文件。
• splatviz_utils/: 包含项目所需的工具类。
• widgets/: 包含项目中的各种小部件代码。
• .gitignore: 指定 Git 忽略的文件和目录。
• .gitmodules: 配置项目中的 Git 子模块。
• LICENSE: 项目所使用的许可证信息。
• README.md: 项目说明文件，介绍项目的基本信息和如何使用。
• environment.yml: Conda 环境配置文件，用于创建项目所需的环境。
• presets.json: 存储预设代码片段的文件，用于快速加载常用的代码配置。
• pyproject.toml: 项目配置文件，定义了项目的元数据和依赖。
• run_main.py: 项目启动文件，用于启动 splatviz 应用程序。
• splatviz.py: splatviz 主程序文件，实现了项目的主要功能。

2. 项目的启动文件介绍

项目的启动文件是 run_main.py。该文件负责初始化和启动 splatviz 应用程序。以下是一个简化的启动流程：

# 导入必要的模块
from splatviz import splatviz

# 初始化 splatviz 应用程序
app = splatviz()

# 启动应用程序
app.run()

在 run_main.py 文件中，通常会有一些命令行参数的解析，用于指定启动时的一些配置，例如数据路径、模式等。

3. 项目的配置文件介绍

项目的主要配置文件是 pyproject.toml。该文件定义了项目的元数据和依赖，如下所示：

[build-system]
requires = ["setuptools", "wheel"]

[tool.setuptools]
packages = ["splatviz"]

此外，项目还包含 environment.yml 文件，用于创建 Conda 环境，其中列出了项目所需的所有依赖：

name: splatviz
dependencies:
  - python=3.8
  - numpy
  - torch
  - pyimgui
  - glfw
  - ...

这些配置文件确保了项目可以在正确的环境中运行，并且所有的依赖都可以被正确地安装。