OpenEXR 项目教程

OpenEXR 项目教程

1. 项目的目录结构及介绍

OpenEXR 项目的目录结构如下：

openexr/
├── AUTHORS.md
├── CMakeLists.txt
├── LICENSE.md
├── README.md
├── RELEASENOTES.md
├── SECURITY.md
├── Azure-Windows.md
├── Contributing.md
├── Doxyfile
├── INSTALL.md
├── OpenEXRConfig.h.in
├── OpenEXR.pc.in
├── OpenEXRSetup.cmake
├── PyIlmBase.pc.in
├── PyIlmBaseConfig.cmake
├── PyIlmBaseConfigVersion.cmake
├── PyIlmBaseSetup.cmake
├── README.md
├── README.win32.md
├── README.cmake.md
├── README.git.md
├── README.linux.md
├── README.macos.md
├── README.mingw.md
├── README.msvc.md
├── README.python.md
├── README.vcpkg.md
├── README.wasm.md
├── README.win32.md
├── README.winrt.md
├── ThirdPartyVersions.txt
├── WORKFLOWS.md
├── cmake/
├── config/
├── doc/
├── ilmbase/
├── openexr/
├── openexr_viewers/
├── pyilmbase/
├── scripts/
├── test/
└── win32/

主要目录介绍：

• openexr/: 包含 OpenEXR 核心库的源代码。
• ilmbase/: 包含 Imath 库的源代码，Imath 是 OpenEXR 的基础数学库。
• openexr_viewers/: 包含 OpenEXR 图像查看器的源代码。
• pyilmbase/: 包含 Python 绑定库的源代码。
• doc/: 包含项目文档。
• test/: 包含测试代码。

2. 项目的启动文件介绍

OpenEXR 项目的启动文件主要是 CMakeLists.txt，它位于项目根目录下。这个文件是 CMake 构建系统的配置文件，用于配置项目的构建过程。

CMakeLists.txt 主要内容：

cmake_minimum_required(VERSION 3.12)
project(OpenEXR VERSION 3.1.5 LANGUAGES CXX)

# 设置编译器选项
set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 包含子目录
add_subdirectory(IlmBase)
add_subdirectory(OpenEXR)
add_subdirectory(OpenEXR_Viewers)
add_subdirectory(PyIlmBase)

3. 项目的配置文件介绍

OpenEXR 项目的配置文件主要是 OpenEXRConfig.h.in，它位于项目根目录下。这个文件是用于生成 OpenEXRConfig.h 的模板文件，包含了项目的配置选项。

OpenEXRConfig.h.in 主要内容：

#ifndef OPENEXR_CONFIG_H
#define OPENEXR_CONFIG_H

#cmakedefine OPENEXR_VERSION_STRING "@OPENEXR_VERSION_STRING@"
#cmakedefine OPENEXR_PACKAGE_NAME "@OPENEXR_PACKAGE_NAME@"
#cmakedefine OPENEXR_PACKAGE_STRING "@OPENEXR_PACKAGE_STRING@"
#cmakedefine OPENEXR_PACKAGE_TARNAME "@OPENEXR_PACKAGE_TARNAME@"
#cmakedefine OPENEXR_PACKAGE_VERSION "@OPENEXR_PACKAGE_VERSION@"
#cmakedefine OPENEXR_VERSION_MAJOR "@OPENEXR_VERSION_MAJOR@"
#cmakedefine OPENEXR_VERSION_MINOR "@OPENEXR_VERSION_MINOR@"
#cmakedefine OPENEXR_VERSION_PATCH "@OPENEXR_VERSION_PATCH@"

#endif // OPENEXR_CONFIG_H

这些配置选项在构建过程中会被 CMake 替换为实际的值，生成的 OpenEXRConfig.h 文件会被包含在项目的源代码中，以便在编译时使用这些配置选项。