OpenColorIO 工业级色彩管理算子库 (OpenColorIO Library)

OpenColorIO (OCIO) 算子库基于奥斯卡科学技术奖级开源色彩标准 OpenColorIO 构建，为影视特效 (VFX)、高端三维动画与调色全流程提供了绝对严谨的工业级色彩空间转换与软打样管理能力。

官方开源代码仓库：griptape-ai/griptape-nodes-library-opencolorio
前置运行要求：需要提供合法的 OCIO 规范配置文件（通过环境变量 $OCIO 声明或在节点中显式指定绝对路径）；
算子选择器分类：在算子面板中统一归类于 Colorspace 分组。

安装与集成途径 (Installation)

在编辑器顶部菜单栏依次打开 Manage → Library Management，点击 Add Library 并粘贴 Git 仓库地址：

https://github.com/griptape-ai/griptape-nodes-library-opencolorio

亦可通过命令行工具 CLI 极速下载：

gtn libraries download https://github.com/griptape-ai/griptape-nodes-library-opencolorio

常规的更新与故障排查请参阅算子库管理手册。

核心前置依赖：`$OCIO` 环境变量配置

本算子库将操作系统的 $OCIO 环境变量作为识别与加载默认色彩配置文件的首要信源。在启动 Griptape Nodes 之前，可在终端中导出该变量：

export OCIO=/path/to/your/config.ocio

绝大多数影视制作工作室的工作站与渲染集群均已预先配置了全局 $OCIO。如果你正在使用 Griptape Nodes 的工程项目配置系统，强烈建议直接在工程的 griptape-nodes-project.yml 中按工程独立绑定：

environment:
  OCIO: "{project_dir}/config/aces.ocio"

系统在每个节点执行计算的瞬间都会实时动态重新读取 $OCIO，因此在不同工程之间切换时，引擎会自动无缝接入全新的色彩空间配置，完全无需重载工作流。此外，该算子库已将 OCIO 登记为系统已知环境变量，你随时可以直接在图形化界面的全局设置中查看或就地修改。

核心算子功能矩阵 (Nodes)

算子名称	功能与业务语义说明
Load OCIO Config	从 `$OCIO` 环境变量或指定的物理绝对路径加载 OCIO 色彩配置；向下游节点输出 `OCIOConfigArtifact` 凭据对象。
OCIO Color Parameters	将源色彩空间 (Source Colorspace)、目标显示设备 (Display) 以及视图变换 (View) 打包封装为可复用的 `OCIOColorParamsArtifact`；下拉菜单项由相连的 OCIO 配置动态驱动。

极速上手编排范式 (Quick start)

在画布中添加 Load OCIO Config 节点：若当前环境已设置 $OCIO，节点会自动识别并回显该配置文件的物理绝对路径；
将其 config 输出端连接至 OCIO Color Parameters 节点，从下拉列表中选择源色彩空间、显示设备和视图风格（如 ACEScg $\rightarrow$ sRGB / Rec.709）；
将解出的 color_params 输出端连入任何接受该对象的下游算子——例如 OpenEXR 算子库中的 Display EXR Part 或 Display EXR Channel 节点。

[Load OCIO Config 节点] → [OCIO Color Parameters 节点] → [下游色彩变换与渲染监视节点]

跨算子库底层协同机制 (Used by other libraries)

除提供前端可选的节点外，该库还在底层向宿主引擎广播了一套色彩转换底层微服务供其它算子库协同调用。OpenEXR 算子库具备自动感知能力：当检测到系统中安装了 OpenColorIO 库时，EXR 监视器节点会自动将默认的显示色彩模式切换为受控的 OCIO 色彩流水线（color_mode: ocio），从而取代局限的简单色调映射算法。

技术支持与反馈 (Support)

若在色彩空间转换中发现异常或有新的标准支持需求，欢迎访问 GitHub Issues 页面提交工单。