OCIO 設定の読み込み (Load OCIO Config)

$OCIO 環境変数または明示的なオーバーライドパスから OpenColorIO 設定をロードし、下流ノード向けの OCIOConfigArtifact として出力します。

カテゴリ: Colorspace

概要 (TL;DR)

システム環境変数に $OCIO が設定されている場合、ノードは自動的にそれを検出します — ノードをキャンバスに追加して実行するだけで利用可能です。
$OCIO は各実行時に動的に再読み込みされるため、Griptape プロジェクトレベルの環境変数オーバーライド（project.yml の environment:）も常に尊重されます。
出力は OCIOConfigArtifact です。OCIO Color Parameters や OCIO Config 入力を持つ各ノードに接続します。
折りたたまれている 詳細設定 (Advanced) グループを使用すると、テスト用に明示的な .ocio ファイルパスを指定して $OCIO を上書きできます。

[Load OCIO Config] → OCIO Color Parameters → (下流の変換/表示ノード)

名前	型	必須	備考
`context_vars`	`dict`	いいえ	OCIO コンテキスト変数（例: `{"SHOT": "sh010", "SEQ": "sq020"}`）。出力アーティファクトに引き継がれます。
`file_path`	`str`	いいえ	`.ocio` 設定ファイルへのパス。Override OCIO Config が有効な場合のみ使用。ファイルピッカー付属。

名前	型	デフォルト	備考
`override_ocio_config`	bool	`False`	有効にすると、`$OCIO` の代わりに下記の明示的な `file_path` を使用します。環境変数を変更せずに特定の設定をテストする際に有用。
`file_path`	ファイルパス	`""`	オーバーライドトグルが ON の場合に表示。

インラインメッセージの確認: ノード上には、検出された $OCIO パスを示す情報メッセージ、$OCIO が未設定の場合の警告、前回の実行から $OCIO が変更された場合の警告（下流ノードの出力を更新するために再実行が必要）が表示されます。
オーバーライドモードの挙動: Override OCIO Config が有効になっている間は、環境変数は完全に無視されます。環境変数モードに戻すにはトグルを無効化してください。
設定が一切ない場合のエラー: $OCIO もオーバーライドも設定されていない場合、ノードの実行は失敗します。プロジェクトごとの設定は project.yml の environment: で定義するのが最もクリーンです。