コンテンツにスキップ

OpenColorIO ライブラリ (OpenColorIO Library)

映画、VFX、アニメーションパイプライン全体で使用されている業界標準のカラーマネジメントシステム OpenColorIO (OCIO) をベースに構築されたプロフェッショナル向けカラーマネジメントノード群です。

インストール (Installation)

エディタで 管理 (Manage) → ライブラリ管理 (Library Management) を開き、ライブラリの追加 (Add Library) をクリックして以下を貼り付けます：

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

または、CLI から実行します：

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

一般的なインストール、アップデート、トラブルシューティングの手順については、ライブラリガイド (Libraries guide) を参照してください。

前提条件: $OCIO 環境変数 (Prerequisites: the $OCIO environment variable)

本ライブラリは、カラー設定を特定するための主要な手段として $OCIO 環境変数を使用します。Griptape Nodes を起動する前に環境変数を設定してください：

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

スタジオのワークステーションやレンダーファーム環境では、通常すでに $OCIO が定義されています。Griptape の プロジェクト (project) を使用している場合は、project.yml 内でプロジェクトごとに設定することも可能です：

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

$OCIO の値は各ノードの実行時に動的に再読み込みされるため、ワークフローをリロードすることなくプロジェクトの切り替えに追従できます。

また、本ライブラリは OCIO を既知の環境変数として登録しているため、アプリケーションを離れることなく Griptape Nodes の設定 UI から確認・設定することも可能です。

提供ノード一覧 (Nodes)

ノード 説明
Load OCIO Config $OCIO または明示的なパスから OCIO 設定をロードし、下流ノード向けの OCIOConfigArtifact を出力
OCIO Color Parameters ソース色空間、ディスプレイ、ビューを再利用可能な OCIOColorParamsArtifact にパッケージ化。接続された OCIO 設定からドロップダウンが自動生成

クイックスタート (Quick start)

  1. キャンバスに Load OCIO Config ノードを追加します。
    • $OCIO が設定されている場合、ノードはそのパスを自動的に検出して表示します。
  2. config 出力を OCIO Color Parameters ノードに接続し、ソース色空間、ディスプレイ、ビューを選択します。
  3. color_params 出力を OCIOColorParamsArtifact を受け付けるノード（例: OpenEXR Library の Display EXR Part や Display EXR Channel）に接続します。
Load OCIO Config → OCIO Color Parameters → (下流の変換/表示ノード)

他のライブラリでの利用 (Used by other libraries)

設定選択ノード群に加えて、本ライブラリは他のライブラリから呼び出し可能な色空間変換サービスを提供します。OpenEXR Library はこれを自動検知します。OpenColorIO Library がインストールされている場合、EXR 表示ノードはローカルトーンマッピングの代わりに OCIO 管理下のカラー変換（color_mode: ocio）をデフォルトとして使用します。

サポート (Support)

バグの報告や機能リクエストについては、Issue を作成 してください。