BlenderProc-3DFront 项目安装与配置指南

1. 项目基础介绍

BlenderProc-3DFront 是一个开源项目，它基于 BlenderProc（Blender Procedural Rendering）框架，并为 3D-Front 数据集提供了多 GPU 批量渲染和 3D 可视化的支持。该项目主要用于辅助 3D 场景的渲染和可视化任务，允许用户在 3D 场景中生成逼真的渲染图像。

主要编程语言：Python

2. 项目使用的关键技术和框架

• BlenderProc：这是一个用于自动生成逼真渲染图像的 Blender 插件，它允许用户进行批量渲染和场景设置。
• 3D-Front 数据集：用于项目测试和展示的数据集，包含了室内场景的 3D 模型。
• VTK（Visualization Toolkit）：用于 3D 可视化。
• Conda：用于创建隔离的环境，并管理项目依赖。

3. 项目安装和配置的准备工作与详细步骤

准备工作

• 确保您的计算机上已安装有 Blender。如果没有，请从 Blender 官方网站下载并安装。
• 安装 Conda。Conda 是一个开源的包管理器和环境管理器，可以用于安装 Python 环境和依赖包。
• 准备 3D-Front 数据集。您需要从相应的渠道获得数据集，并将其放置在项目的指定目录下。

安装步骤

1. 克隆项目仓库到本地环境：

   git clone https://github.com/yinyunie/BlenderProc-3DFront.git
   cd BlenderProc-3DFront
   

2. 使用 Conda 创建一个新环境并安装依赖：

   conda env create -f environment.yml
   conda activate blenderproc
   

3. 在激活的环境中，安装项目：

   pip install -e .
   

4. 准备 3D-Front 数据集。将数据集文件放置在项目的 examples/datasets/front_3d_with_improved_mat/ 目录下，并按照项目要求进行链接。

5. 如果需要下载纹理数据，运行以下脚本：

   blenderproc run blenderproc/scripts/download_cc_textures.py ./resources/cctextures
   

6. 渲染单个场景的示例：

   blenderproc run examples/datasets/front_3d_with_improved_mat/render_dataset_improved_mat.py \
   examples/datasets/front_3d_with_improved_mat/3D-FRONT \
   examples/datasets/front_3d_with_improved_mat/3D-FUTURE-model \
   examples/datasets/front_3d_with_improved_mat/3D-FRONT-texture \
   [场景ID] \
   resources/cctextures/ \
   examples/datasets/front_3d_with_improved_mat/renderings
   

   将 [场景ID] 替换为实际场景的标识符。

7. 如果需要进行批量渲染，运行以下脚本：

   python examples/datasets/front_3d_with_improved_mat/multi_render.py \
   examples/datasets/front_3d_with_improved_mat/render_dataset_improved_mat.py \
   ...（其他参数同上）... \
   --n_processes [GPU数量]
   

   将 [GPU数量] 替换为您的系统上可用的 GPU 数量。

8. 对于 2D 和 3D 可视化，运行以下代码：

   python visualization/front3d/vis_front3d.py --json_file [场景ID].json
   

   同样将 [场景ID] 替换为实际场景的标识符。

按照上述步骤，您应该能够成功安装和配置 BlenderProc-3DFront 项目，并开始使用它进行 3D 场景的渲染和可视化。