Embree 技术文档

本文档旨在帮助用户安装、使用和理解 Embree 项目，详细介绍了以下内容：

1. 安装指南
2. 项目使用说明
3. 项目 API 使用文档
4. 项目安装方式

1. 安装指南

Windows 安装

Embree 为 Windows 提供了一个预编译的 ZIP 压缩包。下载后，解压该文件，并手动将 lib 文件夹的路径添加到系统的 PATH 环境变量中，以便应用程序能够找到 Embree。

Linux 安装

Embree 为 Linux 提供了一个预编译的 tar.gz 压缩包。使用 tar 命令解压该文件，并使用提供的 embree-vars.sh（如果您使用的是 bash shell）或 embree-vars.csh（如果您使用的是 C shell）来正确设置环境：

tar xzf embree-4.3.3.x86_64.linux.tar.gz
source embree-4.3.3.x86_64.linux/embree-vars.sh

建议为您的应用程序添加一个相对的 RPATH，指向 Embree（和 TBB）所在的路径。

macOS 安装

macOS 版本的 Embree 也提供了一个 ZIP 文件。使用 tar 命令解压该文件，并使用提供的 embree-vars.sh（如果您使用的是 bash shell）或 embree-vars.csh（如果您使用的是 C shell）来正确设置环境：

unzip embree-4.3.3.x64.macosx.zip
source embree-4.3.3.x64.macosx/embree-vars.sh

如果要与应用程序一起打包 Embree，请使用提供的 ZIP 文件中的 Embree 库。

2. 项目的使用说明

使用 Embree 的最便捷方式是通过 CMake。在您的 CMakeLists.txt 文件中，使用 FIND_PACKAGE 函数让 CMake 查找解压后的 Embree 包：

FIND_PACKAGE(embree 4 REQUIRED)

您可能需要设置 embree_DIR 变量指向包含 embree_config.cmake 文件的文件夹。如果您没有在系统上全局安装 TBB，还需要设置 TBB_DIR 变量：

cmake -D embree_DIR=path_to_embree_package/lib/cmake/embree-4.3.3/ \
      -D TBB_DIR=path_to_tbb_package/lib/cmake/tbb/ \
      ..

FIND_PACKAGE 函数将创建一个 embree 目标，您可以将其添加到您的目标链接库中：

TARGET_LINK_LIBRARIES(application embree)

有关如何构建 Embree 应用程序的完整示例，请查看 Embree 包的 src 文件夹中的 minimal 教程及其 README.txt 文件。

3. 项目 API 使用文档

Embree 的 API 文档详细介绍了如何使用其各种功能。以下是一些关键点：

• 使用不同的几何原语，如三角形、Catmull-Clark 分割曲面、曲线原语、点状原语等。
• 利用运动模糊，包括多段运动模糊、形变模糊和四元数运动模糊。
• 使用射线遮罩和过滤器回调。

有关更详细的 API 使用说明，请参考 Embree 的官方文档。

4. 项目安装方式

Embree 支持多种编译器和平台，包括 Windows、Linux 和 macOS。以下是一些基本的安装步骤：

• 下载 Embree 的源代码或预编译版本。
• 解压并设置环境变量。
• 使用 CMake 构建项目。

有关详细的构建说明，请参考 Embree 的官方文档和教程。