OCIO Color Parameters 算子节点

将源色彩空间 (Source Colorspace)、目标显示设备 (Display) 与视图变换 (View) 打包封装为统一的、可多次复用的 OCIOColorParamsArtifact 凭据对象，供下游受色彩管理的算子集中消费。

算子所属分类：Colorspace

核心速查 (TL;DR)

将来自 Load OCIO Config 节点的 config 输出端连接至本节点，面板上的三个核心下拉菜单会自动根据所载入的 OCIO 规范动态填充候选项；
Source Colorspace (源色彩空间) 列表会优先置顶呈现角色别名 (Role Aliases)（如 scene_linear、compositing_log 等），以便影视工业管线跨工程保持最安全稳固的色彩锚定；
输出成果为 OCIOColorParamsArtifact 对象——单个参数打包节点可同时扇出驱动下游十几个监视与合成节点，实现全流色彩设置的单点集中调控；
每次运行节点时，系统都会根据当前的实时配置重新校验已选参数；若发生不匹配（例如切换了工程底板），节点会弹出清晰的行内黄色警告，但绝不强行中断整体工作流计算。

[Load OCIO Config 节点] → [OCIO Color Parameters 节点] → (下游 EXR 图像转换 / 显示监视节点)

端口名称	数据类型	是否必填	详细功能与业务规范说明
`config`	`OCIOConfigArtifact`	否	来自 Load OCIO Config。负责激活前端下拉列表的动态填充与合法性静态校验。若未连入，下拉菜单将呈现占位符且输出空字符串。
`source_colorspace`	`str` (下拉选择)	否	来自所连 OCIO 配置的源色彩空间名称。系统预设角色别名置顶，随后陈列完整的具体色彩空间清单（如 ACEScg、Linear Rec.709 等）。
`display`	`str` (下拉选择)	否	所连配置中声明的目标物理显示设备名称（如 `sRGB`、`Rec.709`、`Apple P3` 等）。
`view`	`str` (下拉选择)	否	针对所选显示设备支持的具体视图变换风格（如 `ACES 1.0 - SDR Video`、`Film`、`Raw` 等）。当修改 `display` 时，本下拉候选项会自动级联刷新。

端口名称	数据类型	详细功能与业务规范说明
`color_params`	`OCIOColorParamsArtifact`	打包携带 `source_colorspace`、`display` 与 `view` 三大核心色彩参数的强类型上下文凭据。
`was_successful`	`bool`	标识参数打包是否顺利完成的布尔状态值。
`result_details`	`str`	参数校验与打包过程的详细日志输出（折叠在状态组中）。

优先选用角色名称 (Role names) 作为源色彩空间：诸如 scene_linear 或 color_picking 之类的角色别名在不同版本的 OCIO 配置文件之间具有极高的兼容抗突变能力；而生硬的原始色彩空间全称（如 ACES - ACEScg）可能会随配置文件的微调而丢失。
校验警告不会中断管线：若你此前选中的色彩空间在当前工程的配置中不再存在，节点依然会将该字符串打包传出，并在界面上打上醒目的警告标签——在渲染终版成片前请务必确认该提示。
单节点驱动全局下游：强烈建议在整个工作流中仅维护一个 OCIO Color Parameters 节点，并将 color_params 连线至各个下游视窗，从而杜绝多节点参数不一致造成的色彩管理灾难。
支持先期原型搭建 (Scaffolding)：即使尚未连接实际的 Load OCIO Config，你也可以在画布上预先完成节点的拓扑连线；在连入合法配置前节点仅会静默输出空字符串。