HDR 潜在変数のデコード (Decode HDR Latents)

HDR 潜在変数をデコードし、トーンマッピングを適用します。また、必要に応じて raw リニア EXR フレームシーケンスを書き出します。

カテゴリ: ModularDiffusion/Encode\Decode

概要 (TL;DR)

Decode Media Latent を拡張したノードです。同一の入力および動的な画像/動画出力に加え、HDR 動画パイプライン（例: LTX 2.3 HDR）向けのトーンマッピングと EXR エクスポート機能を提供します。
出力は常にトーンマッピング済みの SDR 画像または MP4 動画となります。トーンマッピング適用前の raw リニア HDR フレームを OpenEXR シーケンスとして保存したい場合は exr_output_folder を設定します。
標準（非 HDR）パイプラインの場合、Decode Media Latent とまったく同様に動作し、トーンマッピングは適用されません。
HDR 出力は、リニアな np.ndarray フレームを返すパイプラインドライバ（LTX 2.3 HDR）にのみ適用されます。それ以外のパイプラインはすべて標準のデコードパスを使用します。

Generate Media Latents → [Decode HDR Latents] → Save Image / Save Video

Decode HDR Latents

名前	型	必須	備考
`pipeline`	`Pipeline Config`	はい	潜在変数を生成したパイプラインと一致している必要があります。リニアフレーム出力を得るには HDR 対応モデル（LTX 2.3 HDR など）を使用します。
`latent_tensor`	`LatentArtifact`	はい	デコード対象の潜在変数テンソル。

名前	型	備考
`output_image`	`ImageArtifact`	トーンマッピング済みの画像。静止画パイプライン時に表示。
`output_video`	`VideoUrlArtifact`	トーンマッピング済みの MP4 動画。動画パイプライン時に表示。
`logs`	str	フレームごとの EXR 書き込みログ。`exr_output_folder` が設定されている場合のみ出力。

名前	型	デフォルト	備考
`tone_mapping`	`clip \\| reinhard \\| aces_filmic \\| cv2_reinhard \\| cv2_mantiuk`	`aces_filmic`	SDR 出力へのエンコード前にリニア HDR フレームに適用されるトーンマッピング演算子。非 HDR パイプラインでは無視されます。
`fps`	int (1〜120)	`25`	出力フレームレート。動画パイプラインでのみ表示。
`exr_output_folder`	パス	—	raw リニア HDR EXR シーケンスを保存するフォルダまたは `.exr` ファイルパス。空のままにすると EXR エクスポートをスキップします。
`save_exr_as_half_float`	bool	`True`	EXR フレームを float16（半精度）で保存します。画質の劣化はほとんどなく、ファイルサイズを約 2.5 分の 1 に削減できます。

aces_filmic は clip よりも明るいハイライトを美しく保持します: ハイライトのロールオフよりも彩度の正確性を重視する場合や、SDR 出力と HDR 出力を数値的に厳密に比較する場合を除き、aces_filmic の使用を推奨します。
EXR ファイル名は指定したパス形式に基づいて生成されます（3 つのパターンをサポート）:
- output/frames/（末尾スラッシュ、フォルダ指定）→ output/frames/frame_0000.exr, frame_0001.exr… として保存
- output/frames（末尾スラッシュなし、拡張子なし、既存または新規フォルダ）→ 上記と同様（プレフィックス frame）
- output/frames/shot.exr（.exr 拡張子付き）→ output/frames/shot_0000.exr, shot_0001.exr… として保存
潜在変数を生成した同一パイプラインを使用してください: 各パイプラインには学習済みの専用 VAE が付属しています。不一致の VAE でデコードすると破損した画像/動画が出力されます。
サイズの大きな潜在変数のデコードには大量の VRAM が必要です: 高解像度や長尺フレームの潜在変数はデコード時に多くのメモリを消費します。Pipeline Builder で vae_slicing を有効にしてバッチ分割デコードを行うことで、ピーク時の VRAM 使用量を抑えられます。