跳转至

OpenEXR 工业级高动态范围图像算子库 (OpenEXR Library)

OpenEXR 算子库基于电影工业级无损 HDR 标准 OpenEXR 构建，为影视视效 (VFX)、3D 渲染合成与高动态范围管线提供了全方位的工业级支撑。支持极速内省与加载多通道/多层级 (Multi-part) EXR 文件结构、将独立分层或任意拼装的通道解算为带色调映射的监视图像，并将各类图像或原生通道数据重新打包刷盘回 EXR 文件。

安装与集成途径 (Installation)

在编辑器顶部菜单栏依次打开 Manage → Library Management，点击 Add Library 并粘贴 Git 仓库地址：

https://github.com/griptape-ai/griptape-nodes-library-openexr

亦可通过命令行工具 CLI 极速下载：

gtn libraries download https://github.com/griptape-ai/griptape-nodes-library-openexr

常规的安装更新与故障排查请参阅 算子库管理手册。

核心算子功能矩阵 (Nodes)

算子名称 功能与业务语义说明
Load EXR 加载 EXR 实体文件，将其底层结构（多层 Parts、通道 Channels、文件头元数据属性）解析为强类型端口——出厂默认仅极速读取文件头 (Header-only)，即使面对数 GB 的庞大多层渲染图也能实现毫秒级即刻解析。
Display EXR Part 将指定的 EXR Part 渲染为 8 位 sRGB/RGBA PNG 预览图，提供动态曝光调节、色调映射（或无缝接入 OCIO 色彩流水线）。
Display EXR Channel 自由组合 1 至 4 个独立的 EXR 通道数据（例如拼装深度图、法线图或遮罩），融合成 8 位监视图像，支持背景 Alpha 复合预览。
Save EXR 将普通 8 位图像或底层 EXR 原生通道凭据打包保存为单层 EXR 文件，支持精细化选择压缩算法（ZIP、PIZ、DWAA 等）、像素精度（HALF 16位 / FLOAT 32位）以及自定义元数据注入。

极速上手编排范式 (Quick start)

[Load EXR 节点] → [Display EXR Part 节点] → (标准图像输出端口)
                ↘ [Display EXR Channel 节点] (从任意分层或文件中自由拼装 R/G/B/A 通道)
  1. 在画布中添加 Load EXR 节点，并将 file_path 指向本地的 .exr 文件。节点会自动扫描文件头，并在前端动态生成 Parts 与 Channels 属性组；
  2. 将 Part 输出端口连入 Display EXR Part 节点（或将单个通道接入 Display EXR Channel），即可得到经过色调映射后的高质量 PNG 图像，可直接在画布中预览或传给下游常规图像处理节点；
  3. 使用 Save EXR 节点将下游计算成果再次高质量保存为 EXR 资产。

与 OpenColorIO 的深度联动机制

预览与监视节点原生支持两种色彩空间解算模式：

  • basic (基础模式)：纯本地曝光调节 + 经典色调映射算法（filmic 胶片感或 linear 线性解算）；
  • ocio (色彩管理模式)：连入来自 OpenColorIO 算子库 的 OCIOColorParamsArtifact 凭据，直接驱动符合电影工业标准的 Display-View 转换流。

当系统中检测到已安装 OpenColorIO 算子库时，EXR 监视节点会自动将默认色彩模式切换为 ocio；若未安装，则自动平滑降级为 basic 模式——无需担心硬性依赖报错。

算子库专属全局配置 (Library settings)

在宿主引擎的配置体系中（openexr 配置分类下），提供以下全局优化项：

配置键名 默认值 详细业务语义与调优规范
openexr.header_only true 为 true 时，Load EXR 仅读取元数据文件头（极速、零显存占用）；设置为 false 时会强行将所有通道像素载入内存以精准反推实际像素格式。
openexr.viewer_executable "" 外部专业 HDR 监视器程序的绝对路径（例如 /usr/bin/djv、RV、mrViewer 或 Nuke 可执行程序）。留空则调用系统默认文件关联打开。
openexr.viewer_args "" 调用外部播放器时传递的启动命令行参数，例如 --hdr --linear。遵循标准 Shell 引号转义规则。

每一个 EXR 算子节点的属性面板顶部均常驻 Open in external viewer (在外部播放器中打开) 按钮。点击后会以非阻塞模式在后台拉起专业监视器，完全不打断前端画布的交互心流。

技术支持与反馈 (Support)

若在 EXR 多层读取或压缩解算中遇到异常，欢迎访问 GitHub Issues 页面 提交工单。