必须用OpenEXR SDK（IlmImf）配合Imath库解析EXR文件，不可直接用std::ifstream；需正确链接二者，用Imf::InputFile读取单层多通道时注意dataWindow、FrameBuffer绑定及通道名匹配。
OpenEXR C++ 读取依赖 Imath 和 IlmImf 库
直接用 std::ifstream 读 OpenEXR 文件会得到乱码或解析失败——它不是普通二进制图像，而是带多通道、任意分辨率、半浮点/浮点像素的结构化容器。必须通过官方 OpenEXR SDK（即 IlmImf）解析，且该库强依赖 Imath 提供向量/矩阵/半精度类型支持。
常见错误是只链接 IlmImf 却漏掉 Imath，导致链接时报 undefined reference to `Imf_3_1::Header::Header(int, int)` 这类符号缺失错误。CMake 中需同时 find_package 并 link：
find_package(OpenEXR REQUIRED)
target_link_libraries(your_target PRIVATE
${OPENEXR_LIBRARIES}
Imath::Imath # 不可省略
)用 InputFile 读取单层多通道 EXR（最常用场景）
多数 HDR 环境贴图或渲染输出是单层（no layers）、多通道（如 R, G, B, A）的 flat EXR。此时用 Imf::InputFile 最直接，无需处理 deep data 或多层命名逻辑。
关键步骤和易错点：
立即学习“C++免费学习笔记（深入）”；
-
Imf::InputFile构造后立即调用header().dataWindow()获取有效像素区域，别直接用displayWindow()—— 它常包含黑边或 padding - 通道数据默认以
float或half存储，需用Imf::FrameBuffer显式绑定内存缓冲区；若目标是 float32 RGBA，建议统一用Imf::FLOAT类型读取，避免手动转换half - 逐行读取比一次性读整个窗口更省内存，尤其对 8K+ EXR；用
setFrameBuffer()+readPixels()指定起始行范围即可
示例片段（读 RGB 到 std::vector<float></float>）：
Imf::InputFile file("scene.exr");
const Imf::Header& header = file.header();
Imf::Box2i dw = header.dataWindow();
int width = dw.max.x - dw.min.x + 1;
int height = dw.max.y - dw.min.y + 1;
<p>std::vector<float> pixels(width <em> height </em> 3);
Imf::FrameBuffer fb;
fb.insert("R", Imf::Slice(Imf::FLOAT, (char<em>)&pixels[0] + 0, sizeof(float) </em> 3, sizeof(float) <em> width </em> 3));
fb.insert("G", Imf::Slice(Imf::FLOAT, (char<em>)&pixels[0] + 4, sizeof(float) </em> 3, sizeof(float) <em> width </em> 3));
fb.insert("B", Imf::Slice(Imf::FLOAT, (char<em>)&pixels[0] + 8, sizeof(float) </em> 3, sizeof(float) <em> width </em> 3));
file.setFrameBuffer(fb);
file.readPixels(dw.min.y, dw.max.y);读取含命名层（layer）或非标准通道名的 EXR
某些渲染器输出会把通道组织在 layer 下，比如 beauty.R, beauty.G, diffuse.B。此时 fb.insert("R", ...) 会失败，因为通道名实际是 "beauty.R"。
必须先遍历 header 的 channel list：
const Imf::ChannelList& channels = header.channels();
for (const auto& ch : channels) {
std::cout << ch.name << " (" << ch.type << ")\n"; // 输出 beauty.R, diffuse.A 等
}然后按完整名称绑定 slice：
- 用
ch.name.c_str()作为fb.insert()第一个参数 - 注意：layer 名中的点号（
.）在 OpenEXR 中是合法通道名一部分，不是分隔符，不要自行 split - 若需合并多个 layer（如把
beauty和diffuse相加），得分别读取再 CPU 合成——OpenEXR SDK 不提供通道运算接口
Windows 上链接 OpenEXR 静态库的路径与运行时陷阱
Windows 用户常卡在 DLL 找不到或 ABI 不匹配。即使编译通过，运行时报 0xc000007b 或 missing VCRUNTIME140.dll 很可能是因为混用了不同 MSVC 版本编译的 OpenEXR 库。
实操建议：
- 用 vcpkg 安装时指定 triplet：
vcpkg install openexr:x64-windows-static-md（-md匹配 /MD 编译选项） - 静态链接时，确保
IMF_EXPORTS和ILMIMF_EXPORTS宏未被定义（否则会导出符号，引发 LNK2005） - 若用预编译二进制，检查其依赖的 CRT：用
dumpbin /dependents ilmimf.lib看是否含VCRUNTIME140.dll，再对比你的项目设置
最稳妥的方式是用 CMake + vcpkg toolchain，让构建系统自动处理所有依赖传递和宏定义——手写 link.txt 极易漏掉 IlmThread 或 Iex 这些隐式依赖库。
