OCIO カラーパラメータ (OCIO Color Parameters)

ソース色空間、ディスプレイ、ビューを単一の再利用可能な OCIOColorParamsArtifact にまとめ、下流のカラーマネジメント対象ノードに提供します。

カテゴリ: Colorspace

概要 (TL;DR)

Load OCIO Config から config を配線すると、その設定内容に基づいて 3 つのドロップダウンの選択肢が自動入力されます。
Source Colorspace では、パイプラインの安定性を保つためロールエイリアス（例: scene_linear、compositing_log）が先頭に表示されます。
出力は OCIOColorParamsArtifact です。1 つのノードから複数の下流コンシューマへ接続することで、設定の一元管理が可能です。
選択内容は実行ごとにライブ設定と照合検証されます。不一致がある場合はインライン警告が表示されますが、実行自体はブロックされません。

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

名前	型	必須	備考
`config`	`OCIOConfigArtifact`	いいえ	Load OCIO Config から供給。ドロップダウンの生成と検証を有効化。未接続の場合、ドロップダウンにはプレースホルダーが表示され、空文字が出力されます。
`source_colorspace`	`str` (選択肢)	いいえ	接続設定から取得されたソース色空間名。ロールが先頭に表示され、その後に全色空間名が並びます。
`display`	`str` (選択肢)	いいえ	接続設定から取得されたディスプレイデバイス名。
`view`	`str` (選択肢)	いいえ	選択されたディスプレイに対するビュー名。`display` の変更に応じて自動更新されます。

名前	型	備考
`color_params`	`OCIOColorParamsArtifact`	`source_colorspace`、`display`、`view` を保持。
`was_successful`	`bool`	バンドルが正常に出力されたかどうか。
`result_details`	`str`	検証および出力結果の詳細情報（折りたたみステータスグループ）。

ソース色空間にはロール名を優先: scene_linear などのロール名は設定ファイルの改訂後も保持されやすく、パイプラインの堅牢性が向上します。生の色空間名は設定バージョンによって消滅する可能性があります。
警告は実行を停止させません: 選択された値が現在の設定ファイル内に存在しない場合（設定ファイルの変更時や動的入力時）、インライン警告を表示した上でそのままアーティファクトを出力します。下流のレンダリング結果を信頼する前に警告を確認してください。
単一ノードの共有利用: ノードごとにドロップダウンを再設定するのではなく、1 つのノードの color_params を下流のすべての表示/変換ノードに接続して共有してください。
スキャフォールディング（骨組み作成）: 設定ファイルが手元にない段階でもワークフローの骨組みを作成できます。設定が接続されるまでは空文字が出力されます。