LTXV バッチからガイド追加 (LTXVAddGuidesFromBatch) - ComfyUI-KJNodes

説明

バッチ内の複数のガイド画像を、対応するフレームインデックスの潜在表現に追加します。バッチ内の非黒色（つまり非ゼロ）の画像がガイドとして使用されます。このノードはLTXV条件付けパイプラインの一部であり、参照画像を潜在空間に直接注入することで、フレームごとの外観を細かく制御できます。

名前	型	必須	説明
`positive`	CONDITIONING	はい	ポジティブ条件付けテンソル（例：CLIPテキストエンコーダーや他の条件付け設定からの出力）。
`negative`	CONDITIONING	はい	ネガティブ条件付けテンソル。
`vae`	VAE	はい	ガイド画像を潜在空間にエンコードするために使用されるVAEモデル。
`latent`	LATENT	はい	初期潜在テンソル（例：空の潜在表現や前のLTXVステージからの出力）。
`images`	IMAGE	はい	画像のバッチ。このバッチ内の非黒色画像はガイドとして扱われ、対応するフレームインデックスに適用されます。黒色（全チャンネルがゼロ）の画像は無視されます。
`strength`	FLOAT (0‑10)	はい	すべてのガイド画像に適用される強度係数。デフォルト: `1.0`。値を大きくするとガイドの影響が強まります。

名前	型	説明
`positive`	CONDITIONING	ガイド情報が注入された更新済みポジティブ条件付け。
`negative`	CONDITIONING	ガイド情報が注入された更新済みネガティブ条件付け。
`latent`	LATENT	ガイド注入によるフレームごとの調整を含む修正済み潜在テンソル。

このノードは、imagesバッチがlatentテンソルと同じフレーム数（または少なくとも潜在表現のフレーム数まで）であることを期待します。バッチ内の各非黒色画像は、対応するフレームインデックスのガイドとして使用されます。
「黒色」画像とは、すべてのピクセルチャンネルがゼロである画像を指します。これにより、ガイド信号に寄与させたくない「プレースホルダー」画像をバッチに含めることができます。
strengthパラメータは、すべてのガイドのエンコードされた寄与を一様にスケーリングします。ガイドごとに強度を変えるには、画像をこのノードに渡す前に前処理（例：黒色とのブレンド）を行うことができます。
このノードは、フレーム一貫性のあるビデオ生成やスタイル化されたアニメーションなど、参照画像による正確なフレームごとの制御が必要なLTXVベースのワークフローを対象としています。
条件付けパイプラインを続けるには（通常はサンプラーやさらに先のLTXVノードへ）、3つの出力すべてを接続する必要があります。更新済み条件付けテンソルはガイド情報を保持し、潜在表現は空間的に変更された表現を含みます。