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 输出端 / 下游图像处理节点)
| 端口名称 |
数据类型 |
是否必填 |
详细功能与业务规范说明 |
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 曲线的非受控降级行为,确保影视资产色彩的一致性与严谨性。
推荐延伸阅读