跳转至

Display EXR Part 算子节点

将指定的 EXR 图层分块 (Part) 经过曝光增益与色调映射(或专业 OCIO 色彩管理)解算渲染为标准的 8 位 sRGB(或 RGBA)PNG 图像。

算子所属分类:EXR


核心速查 (TL;DR)

  • 接收来自 Load EXR 节点的 EXRPartArtifact 强类型资产凭据,自动嗅探并提取该 Part 中的红绿蓝基础通道,最终写入 ImageUrlArtifact 图像资产供画布与下游节点即刻预览;
  • 提供两种截然不同的色彩空间处理模式:basic(纯本地曝光调节点 + filmic/linear 色调映射曲线)与 ocio(接入 OCIOColorParamsArtifact 凭据,全面驱动工业级 Display-View 真实转换);
  • 若当前分块中包含 Alpha 通道(A),系统会自动将其保留在输出图像中,生成带透明通道的 RGBA PNG;
  • 节点执行完毕后,属性面板常驻 Open in external viewer 按钮,支持直接调起外部专业播放器进行原始 16/32 位浮点数据的实况像素审查。

典型工作流编排拓扑

[Load EXR 节点] → [Display EXR Part 节点] → (标准 ImageUrlArtifact 输出端 / 下游图像处理节点)

输入端口规范 (Inputs)

端口名称 数据类型 是否必填 详细功能与业务规范说明
part EXRPartArtifact 是 来自 Load EXR 的待渲染分层对象。底层数据默认按场景线性 (Scene-linear) 高动态范围浮点数处理,不预先做色域裁切。
exposure float 否 曝光增益补偿值(单位为摄影 EV 档位,范围为 [-10.0, +10.0],出厂默认值为 0.0),在执行色调映射或 OCIO 转换前施加于像素值之上。
color_params OCIOColorParamsArtifact 否 来自 OCIO Color Parameters。当 color_mode 被设定为 ocio 时,该端口为强制必填项。

输出端口矩阵 (Outputs)

端口名称 数据类型 详细功能与业务规范说明
image ImageUrlArtifact 8 位 sRGB 或 RGBA 格式的标准 PNG 图像,可直接在节点预览框中交互缩放并连入后续图像算子。
output_file str 生成的临时 PNG 预览图在操作系统磁盘上的绝对物理路径。

属性参数调优 (Parameters)

参数名称 数据类型 默认值 详细业务功能与调优说明
color_mode 下拉枚举 (basic \| ocio) 安装了 OCIO 库时默认为 ocio,否则为 basic basic 采用快速的纯数学局部色调映射;ocio 则完全受控于所连的 OpenColorIO 色彩配置文件。
tone_mapping 下拉枚举 (filmic \| linear) filmic 仅在 color_mode 为 basic 时显现。filmic 采用高动态影视级的 Narkowicz 2015 胶片响应曲线;linear 则直接将线性浮点数暴力钳位(Clamp)至 [0, 1]。在 ocio 模式下自动隐形。

避坑技巧与最佳实践 (Tips & pitfalls)

  • OCIO 模式下务必连入色彩参数凭证:若将 color_mode 设为 ocio 却未连接 color_params 端口,节点会立即抛出阻断异常。在缺乏 OCIO 配置的轻量工程中,请主动切换回 basic 模式。
  • 默认假设像素为场景线性 (Scene-linear):底层解算引擎默认输入数据为线性物理量。若你加载的 EXR 在早期制作环节中被错误编码为了对数 (Log) 或显示相关色彩,请务必启用 OCIO 模式并在上游正确指定 source_colorspace(如 compositing_log)。
  • OCIO 转换绝不发生隐性降级:若 OCIO 配置文件损坏或视图变换不匹配,系统会直接报错以暴露管线问题,绝不发生静默回退至 basic 曲线的非受控降级行为,确保影视资产色彩的一致性与严谨性。

推荐延伸阅读