OpenEXR 是一套专为视觉效果（VFX）和 CGI 渲染流程设计的 Python 工具集，用于高效处理 OpenEXR 格式的高动态范围图像文件。作为行业标准的多通道浮点图像格式，OpenEXR 广泛用于存储合成、渲染通道（AOVs）以及材质与对象分割数据。该工具通过命令行接口提供开箱即用的功能，支持快速检查 EXR 文件的通道结构、提取主视图（beauty）图像、解码 cryptomatte 元数据并转换为标准色彩空间输出。其核心优势在于简化了传统上复杂的 EXR 数据处理流程，使艺术家和技术人员能够专注于创意而非底层技术细节。 工具默认使用 OpenEXR==3.2.4 版本以确保跨平台稳定性，依赖 numpy<2 和 Pillow 库进行数值计算与图像编码。用户可通过 `scripts/exr_extract.py` 脚本执行多种常见任务：如查看文件信息、批量提取 beauty 图像、生成基于 cryptomatte 的材质/对象/资产分割掩模，或单独导出特定通道（如深度 Z、世界空间法线等）。所有操作均支持目录级批处理，并可选择强制覆盖已有输出。对于简单场景下的 ACEScg 到 sRGB 转换，该工具采用标准的 3×3 矩阵变换加 sRGB OETF 曲线实现色调映射，满足大多数离线合成需求。 尽管 OpenEXR 技能覆盖了大部分基础 EXR 处理场景，但对于需要高级色调映射（如 RRT+ODT）、HDR 曝光合成、序列转视频或跨格式转换的任务，建议结合使用 oiiotool 技能以获得更专业的图像处理能力。两者互补，分别针对轻量级脚本化操作与生产级媒体流水线优化。
核心功能特点
- 一键检查 EXR 文件结构，显示分辨率、数据窗口及所有通道类型与采样方式
- 自动识别并提取 beauty/RGB 通道，支持 ACEScg、linear 和 srgb 色彩空间转换
- 智能解析 cryptomatte 数据，生成按像素面积排序的彩色材质/对象/资产分割图
- 灵活提取任意命名通道，如深度 Z、法线 N.X/N.Y/N.Z 等，支持单通道或多通道组合输出
- 支持目录批量处理，可跳过已存在文件或使用 –force 强制重写
- 提供原生 Python API 接口，便于开发自定义逻辑处理边缘案例
适用场景
该工具特别适合影视后期制作中常见的 EXR 文件管理需求。例如，在合成阶段，美术师可以快速从多通道渲染文件中提取主视图图像，并将其从线性 ACEScg 色彩空间正确转换为可用于合成的 sRGB PNG，避免因色彩偏差导致匹配困难。同时，通过 cryptomatte 功能，团队能自动生成清晰的材质 ID 分割图，极大提升遮罩绘制效率，尤其适用于角色换装或大规模场景资产管理。 对于技术美术（TA）而言，此工具是调试渲染输出的利器——只需运行 info 命令即可迅速确认某帧是否包含所需通道（如运动向量、反射遮蔽等），而无需手动打开复杂软件界面。此外，在自动化管线搭建中，该脚本可作为预处理步骤集成至 Maya、Houdini 或 Nuke 的工作流中，实现无人值守的 EXR 资源标准化输出。 虽然本工具擅长处理常规 VFX 渲染产物，但在涉及 HDR 监看、动态范围展示或多曝光分析的场景下，仍需借助 oiiotool 完成专业级色调映射与视频编码。因此，在实际项目中应根据具体任务复杂度合理选择工具组合，既发挥 Python 脚本的灵活性，又利用 oiiotool 的强大媒体处理能力，构建高效稳定的图像处理流水线。