RadeonProRender-Baikal 项目教程

RadeonProRender-Baikal 项目教程

RadeonProRender-Baikal 项目地址: https://gitcode.com/gh_mirrors/ra/RadeonProRender-Baikal

1. 项目目录结构及介绍

RadeonProRender-Baikal 项目的目录结构如下：

RadeonProRender-Baikal/
├── 3rdparty/
├── Baikal/
├── BaikalDataGenerator/
├── BaikalIO/
├── BaikalStandalone/
├── BaikalTest/
├── Doc/Images/
├── Gtest/
├── RadeonRays/
├── Resources/
├── Rpr/
├── RprSupport/
├── RprTest/
├── Tools/
├── cmake/
├── .gitignore
├── .gitmodules
├── CMakeLists.txt
├── LICENSE.txt
├── README.md

目录介绍

• 3rdparty/：包含第三方库和依赖项。
• Baikal/：核心渲染引擎代码。
• BaikalDataGenerator/：用于生成渲染数据的工具。
• BaikalIO/：输入输出模块，处理文件和数据流。
• BaikalStandalone/：独立的渲染应用程序。
• BaikalTest/：单元测试代码。
• Doc/Images/：文档中的图片资源。
• Gtest/：Google Test 框架，用于单元测试。
• RadeonRays/：AMD RadeonRays 引擎，用于光线相交计算。
• Resources/：项目资源文件。
• Rpr/：RadeonProRender API 实现。
• RprSupport/：RadeonProRender 支持模块。
• RprTest/：RadeonProRender 测试代码。
• Tools/：项目工具。
• cmake/：CMake 配置文件。
• .gitignore：Git 忽略文件配置。
• .gitmodules：Git 子模块配置。
• CMakeLists.txt：CMake 构建配置文件。
• LICENSE.txt：项目许可证。
• README.md：项目介绍和使用说明。

2. 项目启动文件介绍

BaikalStandalone

BaikalStandalone 是 RadeonProRender-Baikal 项目的独立渲染应用程序。它位于 BaikalStandalone/ 目录下。

启动命令

export LD_LIBRARY_PATH=<RadeonProRender-Baikal path>/build/bin/:$[LD_LIBRARY_PATH]
cd BaikalStandalone
./build/bin/BaikalStandalone

命令行参数

• -platform index：选择特定的 OpenCL 平台。
• -device index：选择特定的 OpenCL 设备。
• -p path：指定网格/材质文件的路径。
• -f file：指定要渲染的网格文件。
• -w：设置窗口宽度。
• -h：设置窗口高度。
• -ns num：限制每个像素的采样数。
• -cs speed：设置相机移动速度。
• -cpx x -cpy y -cpz z：设置相机位置。
• -tpx x -tpy y -tpz z：设置相机目标。
• -interop [0|1]：禁用或启用 OpenGL 互操作（默认启用）。
• -config [gpu|cpu|mgpu|mcpu|all]：设置设备配置。

3. 项目配置文件介绍

CMakeLists.txt

CMakeLists.txt 是 CMake 构建系统的配置文件，位于项目根目录下。它定义了项目的构建规则和依赖项。

主要配置项

• 编译器支持：Visual Studio 2015 及更高版本、Xcode 4 及更高版本、GCC 4.8 及更高版本。
• 依赖项：Python 2.7、OpenImageIO、glew、GLFW3。
• 子模块：使用 git submodules 管理依赖项。

.gitignore

.gitignore 文件定义了 Git 忽略的文件和目录，避免将不必要的文件提交到版本库。

.gitmodules

.gitmodules 文件定义了 Git 子模块的配置，用于管理项目的外部依赖项。

LICENSE.txt

LICENSE.txt 文件包含了项目的许可证信息，通常是 MIT 许可证。

README.md

README.md 文件是项目的介绍和使用说明，包含了项目的概述、构建和运行说明。

RadeonProRender-Baikal 项目地址: https://gitcode.com/gh_mirrors/ra/RadeonProRender-Baikal