OmniPhotos 项目教程

1. 项目目录结构及介绍

OmniPhotos 项目的目录结构如下：

OmniPhotos/
├── CMakeLists.txt
├── LICENSE
├── README.md
├── docs/
├── src/
│   ├── 3rdParty/
│   ├── Python/
│   ├── Viewer/
│   └── Preprocessing/
├── github/
│   └── workflows/
└── Python/
    └── preprocessing/

目录介绍

• CMakeLists.txt: 项目的 CMake 构建文件。
• LICENSE: 项目的许可证文件，采用 Apache-2.0 许可证。
• README.md: 项目的介绍文件，包含项目的概述、使用方法和依赖项等信息。
• docs/: 项目文档目录，可能包含项目的详细文档和使用说明。
• src/: 项目源代码目录，包含主要的 C++ 代码和第三方库。
  • 3rdParty/: 包含项目使用的第三方库。
  • Python/: 包含用于数据预处理的 Python 脚本。
  • Viewer/: 包含用于查看 OmniPhotos 的 Viewer 应用程序的源代码。
  • Preprocessing/: 包含用于数据预处理的源代码。
• github/workflows/: 包含 GitHub Actions 的工作流配置文件。
• Python/preprocessing/: 包含用于数据预处理的 Python 脚本。

2. 项目启动文件介绍

OmniPhotos 项目的主要启动文件是 Viewer/Viewer.exe 和 Preprocessing/Preprocessing.exe。

Viewer.exe

Viewer.exe 是用于查看预处理后的 OmniPhotos 数据集的可执行文件。可以通过以下命令启动：

Viewer.exe path-to-datasets/Preprocessed/

如果需要启用 VR 模式，可以使用以下命令：

Viewer.exe --vr path-to-datasets/Preprocessed/

Preprocessing.exe

Preprocessing.exe 是用于预处理数据集的可执行文件。可以通过以下命令启动：

Preprocessing.exe path-to-datasets/Unpreprocessed/Ship/Config/config-viewer.yaml

该命令将根据配置文件中的选项对数据集进行预处理。

3. 项目配置文件介绍

OmniPhotos 项目的配置文件主要位于 Config/ 目录下，常见的配置文件包括 config-viewer.yaml 和 config-preprocessing.yaml。

config-viewer.yaml

config-viewer.yaml 是用于配置 Viewer 应用程序的配置文件，包含以下主要配置项：

• dataset_path: 指定数据集的路径。
• vr_mode: 是否启用 VR 模式。
• resolution: 指定显示分辨率。

config-preprocessing.yaml

config-preprocessing.yaml 是用于配置数据预处理的配置文件，包含以下主要配置项：

• input_path: 指定输入数据的路径。
• output_path: 指定输出数据的路径。
• camera_poses: 指定相机姿态文件的路径。
• processing_options: 包含各种预处理选项，如图像处理、几何处理等。

通过这些配置文件，用户可以自定义 OmniPhotos 的预处理和查看行为，以满足不同的需求。