コンテンツにスキップ

OpenEXR ライブラリ (OpenEXR Library)

VFX および HDR パイプライン向けの本格的な OpenEXR サポートを提供します。EXR ファイルの読み込みと構造検査、個別のパートや手動で組み立てたチャンネルのトーンマッピング画像としての表示、画像やチャンネルデータの EXR 形式での保存に対応しています。

インストール (Installation)

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

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

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

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

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

提供ノード一覧 (Nodes)

ノード 説明
Load EXR EXR ファイルを読み込み、完全な構造（パート、チャンネル、ヘッダー属性）を型付き出力として公開。デフォルトはヘッダーのみ読み込むため、巨大なマルチパートレンダーでも高速
Display EXR Part 露出およびトーンマッピング（または OCIO カラーマネジメント）を適用し、EXR パートを 8-bit sRGB/RGBA PNG としてレンダリング
Display EXR Channel 1〜4 個の個別 EXR チャンネルを結合して 8-bit 表示画像を生成。背景に対する任意のアルファ合成に対応
Save EXR 8-bit 画像または EXR チャンネルアーティファクトからシングルパート EXR を保存。圧縮形式、ピクセル型、ヘッダーメタデータを制御可能

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

Load EXR → Display EXR Part → (画像出力)
         ↘ Display EXR Channel (任意のパートやファイルから R/G/B/A を結合)
  1. Load EXR ノードを追加し、file_path に .exr ファイルを指定します。ノードがヘッダーをスキャンし、動的な Parts および Channels グループを自動生成します。
  2. パート出力を Display EXR Part に接続する（または個別チャンネルを Display EXR Channel に接続する）ことで、キャンバス上でプレビューしたり他の画像ノードに渡せるトーンマッピング済み PNG を取得できます。
  3. Save EXR を使用して、画像やチャンネルデータを EXR ファイルとしてディスクに書き出します。

OpenColorIO との統合 (OpenColorIO integration)

表示ノードは 2 つのカラーモードをサポートしています：

  • basic: ローカルの露出調整 + トーンマッピング（filmic または linear）。
  • ocio: OpenColorIO Library から接続された OCIOColorParamsArtifact を使用して、OCIO のディスプレイ・ビュー変換を実行。

OpenColorIO Library がインストールされている場合、表示ノードは自動的に ocio モードをデフォルトとして使用します。インストールされていない場合は basic モードがデフォルトとなります。OCIO はオプションであり、単体でもすべての基本機能が動作します。

ライブラリ設定 (Library settings)

設定はエンジン設定の openexr カテゴリで管理されます。

設定項目 デフォルト 説明
openexr.header_only true true の場合、Load EXR はファイルヘッダーのみを高速に読み込みます。false にするとピクセルデータをメモリに読み込んで正確なチャンネルごとのピクセル型を取得します。
openexr.viewer_executable "" 外部 HDR ビューアの実行ファイルへのフルパス（例: /usr/bin/djv や Nuke バイナリ）。空の場合は OS のデフォルトの関連付けが使用されます。
openexr.viewer_args "" ファイルパスの前にビューアへ渡される追加のコマンドライン引数（例: --hdr --linear）。

すべてのノードに 外部ビューアで開く (Open in external viewer) ボタンが用意されており、ソース EXR を設定済みビューア（または OS デフォルト）で即座に開くことができます。ビューアの起動は非同期で行われるため、キャンバスの操作がブロックされることはありません。

サポート (Support)

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