Intel(R) Open Path Guiding Library 安装与使用指南

Intel(R) Open Path Guiding Library 安装与使用指南

openpgl Intel(R) Open Path Guiding Library 项目地址: https://gitcode.com/gh_mirrors/op/openpgl

1. 项目目录结构及介绍

Intel® Open Path Guiding Library（Open PGL）是一个高级渲染技术库，它简化了光线引导在渲染器中的集成过程。以下是克隆自https://github.com/OpenPathGuidingLibrary/openpgl.git后的典型项目目录结构概述：

├── CMakeLists.txt             # 主CMake配置文件
├── docs                       # 文档资料
├── examples                   # 示例程序，展示如何使用Open PGL
│   ├── ...
├── include                    # 头文件，分为C API与C++ API
│   ├── openpgl                # 包含C API头文件
│   └── cpp                    # 包含C++ API头文件
├── src                        # 源代码目录
│   ├── core                   # 核心库源代码
│   ├── ...                    # 其他相关子目录
├── tests                      # 测试套件
├── docsrc                     # 文档源码
└── third_party                # 第三方依赖库，可能包括Embree等

• CMakeLists.txt 是构建系统的核心配置文件。
• docs 存放项目的文档资源。
• examples 提供了多个示例，帮助开发者理解和应用Open PGL。
• include 目录下有头文件，是开发过程中直接引入进行编程的部分。
• src 存储所有源代码，包括核心实现。
• tests 包含用于单元测试和验证功能的代码。
• docsrc 和 third_party 分别存放文档源码和第三方依赖。

2. 项目的启动文件介绍

Open PGL不是一个独立的应用程序，而是一个库，因此没有直接的“启动文件”。开发者通过将其整合到自己的渲染器或者相关的C/C++项目中来“启动”使用。在你的项目中，首先需要通过CMake找到并链接Open PGL库。例如，通过以下CMake命令来实现整合：

find_package(openpgl REQUIRED)
add_executable(myApp source1.cpp source2.cpp)
target_include_directories(myApp PRIVATE ${openpgl_INCLUDE_DIRS})
target_link_libraries(myApp ${openpgl_LIBRARIES})

在这里，source1.cpp和source2.cpp代表你的应用程序源文件，它们将使用Open PGL的功能。

3. 项目的配置文件介绍

Open PGL的配置主要是通过CMakeLists.txt文件来完成的。当从源代码构建时，你可以通过修改CMake选项来控制编译参数，如是否建立静态库(OPENPGL_BUILD_STATIC)、是否启用AVX-512支持(OPENPGL_ISA_AVX512)等。这些选项可以在调用cmake命令时指定，例如：

cmake -DOPENPGL_BUILD_STATIC=ON -DOPENPGL_ISA_AVX512=ON ..

此外，对于依赖项的位置，比如TBB库的位置(OPENPGL_TBB_ROOT), 也需在CMake配置阶段指定。这使得开发者能够根据项目需求定制化配置Open PGL的编译环境。

请注意，实际的配置细节可能会随着项目版本更新而变化，务必参考最新的官方文档或CMakeLists.txt文件注释进行正确配置。

openpgl Intel(R) Open Path Guiding Library 项目地址: https://gitcode.com/gh_mirrors/op/openpgl