Save EXR 算子节点

将普通的 8 位图像或底层 EXR 原生物理通道凭据打包保存为单层 (Single-part) EXR 资产；在通道模式下能够完全保留原生浮点数值的高精度。

算子所属分类：EXR

核心速查 (TL;DR)

支持两种并行的工作模式：
模式 A (Mode A)：接收来自普通图像节点的 ImageArtifact / ImageUrlArtifact（8 位整型），将 [0, 255] 归一化映射为 [0.0, 1.0] 线性浮点并写入 EXR；
模式 B (Mode B)：接收最多 4 个独立的 EXRChannelArtifact 通道凭据，完全无损地维系底层 16 位 / 32 位原始浮点精度；
模式 B 具备最高裁决优先级：只要有任何一个物理通道插槽被连入，image_in 图像输入端口将被系统主动忽略；
输出端口贴心包含了针对新生成分层的 EXRPartArtifact 描述凭据，允许你无需重新通过磁盘读取即可直接串联进 Display EXR Part 实现生成即监视；
默认折叠的 Metadata (元数据) 属性组允许你注入作者签名、影视时间码、注释备忘以及高度结构化的专有自定义文件头属性。

(常规图像生成算子) ────→ [Save EXR 节点] ──→ Display EXR Part (即刻监视产出)
Load EXR (原生通道) ──↗

端口名称	数据类型	是否必填	详细功能与业务规范说明
`image_in`	`ImageArtifact \\| ImageUrlArtifact`	否	8 位常规图像源（模式 A）。只要任何一个通道插槽处于连线状态，该输入即被无条件忽略。
`channel_r`	`EXRChannelArtifact`	否	写入为 Red 红色平面的高精度浮点通道（模式 B）。
`channel_g`	`EXRChannelArtifact`	否	写入为 Green 绿色平面的高精度浮点通道（模式 B）。
`channel_b`	`EXRChannelArtifact`	否	写入为 Blue 蓝色平面的高精度浮点通道（模式 B）。
`channel_a`	`EXRChannelArtifact`	否	写入为 Alpha 透明度平面的高精度浮点通道（模式 B）。

端口名称	数据类型	详细功能与业务规范说明
`output_file`	`str`	成功落盘写入的 `.exr` 实体文件在磁盘上的绝对物理路径。
`output_part`	`EXRPartArtifact`	针对新落盘 EXR 图层结构的强类型描述凭证——可直接无缝串入下游 Display EXR Part 进行回显。

参数名称	数据类型	默认值	详细业务功能与调优说明
`compression`	下拉枚举 (`ZIP \\| ZIPS \\| PIZ \\| DWAA \\| NONE`)	`ZIP`	作用于输出文件的压缩编解码器。`ZIP`/`PIZ` 为无损压缩；`DWAA` 为影视级有损感知压缩；`NONE` 为非压缩 RAW。
`pixel_type`	下拉枚举 (`HALF \\| FLOAT`)	`HALF`	物理像素位深度存储格式：`HALF` 为工业级标准 16 位半精度浮点（推荐绝大多数场景）；`FLOAT` 为 32 位全精度单精度浮点。

参数名称	数据类型	默认值	详细功能说明
`part_name`	`str`	`""`	该 EXR 分块在内部登记的图层名称（如 `rgba`、`beauty` 等）。
`pixel_aspect_ratio`	`float`	`1.0`	写入文件头的像素物理宽高比（方形像素默认为 `1.0`）。
`owner`	`str`	`""`	资产版权所有者或责任艺术家签名。
`comments`	`str`	`""`	自由附注的制作备忘或版本变更记录。
`capture_date`	`str`	`""`	拍摄或生成时间戳（例如 `2026-09-28T12:00:00`）。
`software`	`str`	`""`	写入生成工具链标签（默认为 Griptape Nodes 签名）。
`time_code`	`str`	`""`	剪辑制作时间码（格式如 `01:00:00:00`）。
`custom_attributes`	`str`	`""`	允许写入任意非标专有元数据的结构化 JSON 字典文本。

牢记模式 B 绝对优先：若你原本打算将 image_in 上的图像导出为 EXR，但此前测试残留的 channel_r 连线尚未拔除，系统会自动静默走模式 B 并忽略你的图像。若发现导出的 EXR 画面异常，请先检查通道插槽是否处于孤立误接状态。
8 位图像无法无中生有恢复 HDR 动态范围：模式 A 仅仅是将标准 sRGB 图像线性归一化到 [0.0, 1.0] 浮点区间内，它绝不可能凭空找回过曝裁切掉的高光动态细节。若要保存真实的 HDR 物理资产，请始终通过上游浮点算子以模式 B 传递数据。
合理选用压缩编解码算法：
对于大画幅主色彩渲染成片 (Beauty pass)，强烈推荐选用 DWAA 压缩——在几乎无法察觉画质损失的前提下，文件体积能缩减 70%~90%；
对于深度图 (depth)、法线图 (normals)、三维世界位置图 (Pworld) 等对数值极其敏感的数据通道，必须严格采用 ZIP 或 PIZ 无损压缩，防止 DCT 有损压缩带来数值阶梯断层。
谨慎选用 32 位 FLOAT：32 位全精度浮点的物理体积是 16 位 HALF 的整整两倍！除三维坐标通道或高精度科学模拟外，常规影视合成与色彩流水线 16 位 HALF 已拥有极度充裕的动态宽容度。