Display EXR Channel 算子节点

自由组合 1 至 4 个独立的 EXR 通道数据，将其融合成标准的 8 位 sRGB 或 RGBA PNG 预览图像；支持通过透明度遮罩在自定义背景底图上执行 Alpha 复合打样。

算子所属分类：EXR

核心速查 (TL;DR)

提供 R、G、B、A 四个独立的通道输入插槽，每个插槽均接受一个 EXRChannelArtifact 通道凭据——通道可以跨越不同的 EXR 物理文件或不同的 Part 图层自由跨界拼装；
未连入的 RGB 通道会自动填充为零（纯黑）；一旦连入 channel_a 插槽，输出图像将自动升级为 RGBA 格式并激活下游的 Alpha 复合逻辑；
至少需要连入一个 RGB 插槽；且所有连入该节点的通道必须具备完全相同的像素分辨率（长宽一致）；
拥有与 Display EXR Part 完全一致的色彩管理体系：支持基础色调映射 (basic) 或工业级 OCIO 色彩流水线 (ocio)。

[Load EXR 节点 (提取散装通道)] → [Display EXR Channel 节点] → (标准 ImageUrlArtifact 图像输出端)

端口名称	数据类型	是否必填	详细功能与业务规范说明
`channel_r`	`EXRChannelArtifact`	否	映射到红色像素平面的 EXR 原生物理通道。
`channel_g`	`EXRChannelArtifact`	否	映射到绿色像素平面的 EXR 原生物理通道。
`channel_b`	`EXRChannelArtifact`	否	映射到蓝色像素平面的 EXR 原生物理通道。
`channel_a`	`EXRChannelArtifact`	否	充当透明度 Alpha 遮罩的通道。连入后输出升级为 RGBA。
`exposure`	`float`	否	在色彩转换前施加的 EV 摄影档位曝光补偿（范围 `[-10.0, +10.0]`，默认 `0.0`）。
`color_params`	`OCIOColorParamsArtifact`	否	来自 OCIO Color Parameters。在 `color_mode: ocio` 模式下为强制必填项。
`background`	`ImageArtifact \\| ImageUrlArtifact \\| str`	否	用于承载 A-over-B 传统影视合成的背景底图。若未接入 `channel_a`，该输入将被安全忽略。

端口名称	数据类型	详细功能与业务规范说明
`image`	`ImageUrlArtifact`	8 位 sRGB 或 RGBA PNG 监视图像，可直接在画布中呈现。
`output_file`	`str`	生成的临时 PNG 磁盘文件的绝对物理路径。

参数名称	数据类型	默认值	详细业务功能与调优说明
`color_mode`	下拉枚举 (`basic \\| ocio`)	安装了 OCIO 库时默认为 `ocio`，否则为 `basic`	色彩解算模式：`basic` 采用本地色调曲线；`ocio` 采用全流程工业级色彩管理。
`tone_mapping`	下拉枚举 (`filmic \\| linear`)	`filmic`	在 `basic` 模式下生效。`filmic` 施加 Narkowicz 2015 电影级胶片感曲线；`linear` 则直接暴力截断溢出高光。

RGB 插槽不能全空：严禁仅连接单个 Alpha 通道而将 RGB 全部留空，这种情况下节点会拒绝执行。
跨通道几何分辨率必须严格等同：若试图将一个 4K 的基础色彩通道与一个 1080p 的粗糙深度图直接混编，节点会抛出几何维度冲突异常——请预先在上游完成重采样或画幅适配。
排查 AOV 与通道分离调试的神器：非常适合用于在视口中单独审查特定的辅助渲染通道（如单独将 depth 深度图连入 channel_r 进行灰阶审查；或将三维空间法线 normal.x、normal.y、normal.z 重新打包为完整的彩色法线贴图）。
背景打样依赖 Alpha 激活：当且仅当 channel_a 成功接入了有效的遮罩数据时，background 输入的底图才会参与 Over 运算合成。