Intel® Open Path Guiding Library (OpenPGL) 使用教程-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00007/article/details/139515970

Intel® Open Path Guiding Library (OpenPGL) 使用教程

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

1. 项目介绍

Intel® Open Path Guiding Library (OpenPGL) 是一个开源的路径引导库，旨在通过实现一系列的表示和训练算法，将路径引导集成到渲染器中。OpenPGL 提供了当前最先进的路径引导方法的实现，这些方法可以提高采样质量，从而提高渲染器的效率。

OpenPGL 的目标是提供经过充分测试且足够健壮的实现，以便在生产环境中使用。路径引导场的表示在渲染过程中学习，并基于每帧生成的辐射/重要性样本进行更新。在随机路径/行走的每个顶点，引导场被查询以获取局部分布（例如，入射辐射），从而指导局部采样决策（例如，方向）。

目前支持的路径引导方法包括：基于学习到的入射辐射分布或其与BSDF组件（例如，余弦瓣）或相函数（例如，单瓣HG）的乘积，在表面和体积内引导方向采样决策。

OpenPGL 提供了 C API 和 C++ 包装 API，以便于更高层次的抽象。当前的实现针对最新的 Intel® 处理器进行了优化，支持 SSE、AVX、AVX2 和 AVX-512 指令。OpenPGL 是 Intel® oneAPI 渲染工具包的一部分，并已根据宽松的 Apache 2.0 许可证发布。

2. 项目快速启动

2.1 环境准备

在开始之前，请确保您的系统满足以下要求：

支持 SSE、AVX、AVX2 或 AVX-512 的 Intel® 处理器
CMake 3.10 或更高版本
现代 C++ 编译器（如 GCC、Clang 或 MSVC）

2.2 下载与编译

克隆 OpenPGL 仓库：

git clone https://github.com/OpenPathGuidingLibrary/openpgl.git
cd openpgl

创建并进入构建目录：
```
mkdir build
cd build
```
使用 CMake 配置项目：
```
cmake ..
```
编译项目：
```
make
```

2.3 示例代码

以下是一个简单的示例代码，展示了如何使用 OpenPGL 进行路径引导：

#include <openpgl/openpgl.h>
#include <iostream>

int main() {
    // 初始化 OpenPGL
    pgl_init();

    // 创建路径引导场
    pgl_field_t field = pgl_field_create();

    // 设置路径引导场的参数
    pgl_field_set_parameter(field, "resolution", 128);

    // 训练路径引导场
    pgl_field_train(field);

    // 使用路径引导场进行采样
    pgl_vec3f direction = pgl_field_sample_direction(field);

    // 输出采样结果
    std::cout << "Sampled direction: (" 
              << direction.x << ", " 
              << direction.y << ", " 
              << direction.z << ")" << std::endl;

    // 释放资源
    pgl_field_destroy(field);
    pgl_shutdown();

    return 0;
}