EXR の読み込み (Load EXR)

EXR ファイルを読み込み、デフォルトではピクセルデータを読み込むことなく、その完全な構造（パート、チャンネル、ヘッダー属性）を型付き出力として公開します。

カテゴリ: EXR

概要 (TL;DR)

デフォルトではヘッダーのみ読み込む設定（openexr.header_only）となっているため、巨大なマルチパートレンダーでも高速にスキャンできます。
動的な Parts および Channels グループを自動生成: パートごとに 1 つの EXRPartArtifact、raw チャンネルごとに 1 つの EXRChannelArtifact を展開します。
パートを Display EXR Part に、チャンネルを Display EXR Channel または Save EXR に接続して使用します。
外部ビューアで開く (Open in external viewer) ボタンにより、設定済み HDR ビューアでファイルを直接開くことができます（ライブラリ設定を参照）。

[Load EXR] → Display EXR Part → (画像出力)
           ↘ Display EXR Channel / Save EXR

名前	型	必須	備考
`file_path`	`str`	はい	`.exr` ファイルへのパス。

名前	型	備考
`image_width` / `image_height`	`int`	データウィンドウから取得した解像度。
`part_count` / `channel_count`	`int`	パート数およびチャンネル数。
`compression`	`str`	圧縮形式（例: `ZIP_COMPRESSION`、`DWAB_COMPRESSION`）。
`storage_type`	`str`	`scanlineimage`、`tiledimage`、`deepscanline`、`deeptiled`。
`pixel_aspect_ratio`	`float`	ピクセルアスペクト比。
`data_window` / `display_window`	`str`	`"xmin,ymin - xmax,ymax"` 形式のウィンドウ情報。
`time_code`	`str`	`HH:MM:SS:FF` 形式のタイムコード（存在しない場合は空）。
`software`	`str`	作成ソフトウェア名（存在しない場合は空）。
`owner`	`str`	アセット所有者（存在しない場合は空）。
`chromaticities`	`str`	`red_x/y`, `green_x/y`, `blue_x/y`, `white_x/y` を含む JSON。
`custom_attributes`	`str`	すべての非標準ヘッダー属性の JSON。
`parts`	`list[EXRPartArtifact]`	ファイル内の全パートの構造化記述子。

スキャン後、以下の動的グループも生成されます：

Parts: パートごとに 1 つの EXRPartArtifact 出力（シングルパートファイルでは非表示となり、チャンネルが直接 Channels グループに展開されます）。
Channels: チャンネル名、ピクセル型、サンプリング情報を持つ raw チャンネルごとの EXRChannelArtifact（シングルパートファイルのみ）。

ヘッダーのみ読み込みモードでのピクセル型: 厳密なチャンネルごとのピクセル型情報が必要な場合は、openexr.header_only 設定を false に変更してください（スキャン時にピクセルデータをメモリに読み込むコストが発生します）。
マルチパートファイル: マルチパートレンダーの場合、フラットな Channels グループは非表示となり、チャンネルは各パートのグループ内に展開されます。
下流ノードでの遅延読み込み (Lazy Loading): 表示ノードや保存ノードは記述子アーティファクトから必要に応じて自らピクセルデータを読み込むため、ヘッダーのみのスキャンであっても下流の処理に制約はありません。