Select Latents 🎥🅥🅗🅢 (SelectLatents) - ComfyUI-VideoHelperSuite

Select Latents 🎥🅥🅗🅢 ノードは、複数の潜在表現サンプルを含む辞書を入力として受け取ります。

Select Latents ノードは、一連の潜在表現（Latent）から特定のフレームを選択するためのツールです。その中核機能は、ユーザーが指定したインデックスに基づいて、入力された潜在表現のバッチから対応する部分を抽出し、新しい潜在表現バッチを出力することです。この操作は、映像編集における「ショットの選択」に似ており、ユーザーが後続の処理対象となるフレームシーケンスを正確に制御することを可能にします。

ノード機能

このノードは、複数の潜在表現サンプルを含む辞書を入力として受け取ります。その内部メカニズムは、ユーザーが提供したインデックス文字列を解析し、具体的なインデックスリストに変換した後、これらのインデックスに基づいて入力辞書の各テンソル（Tensor）から対応するデータスライスを抽出します。単一の数字、カンマ区切りのリスト、範囲表現（例：0-5,10）など、柔軟なインデックス形式をサポートし、潜在的なインデックス範囲外の問題も処理できます。

ノードパラメータ説明 - Select Latents 🎥🅥🅗🅢

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`latent`	LATENT	はい	-	-	latent（入力パラメータ）：フィルタリング対象の潜在表現バッチを入力します。通常、VAEエンコーダーや他の生成ノードからの出力です。

コントロールパラメータ (Parameters)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`indexes`	STRING	はい	0	-	`1,3,5` や `0-4` などの形式。インデックスは0から始まります。
`err_if_missing`	BOOLEAN	はい	True	-	err_if_missing（入力パラメータ）：Trueに設定すると、指定されたインデックスが入力範囲を超えている場合、ノードはエラーを発生させます。Falseに設定すると、範囲外のインデックスは無視されます。
`err_if_empty`	BOOLEAN	はい	True	-	err_if_empty（入力パラメータ）：Trueに設定すると、インデックスに基づくフィルタリング結果が空の場合、ノードはエラーを発生させます。Falseに設定すると、空の結果の出力が許可されます。

Output 出力

パラメータ名	データ型	説明
LATENT	LATENT	LATENT（出力パラメータ）：指定されたインデックスに対応するフレームのみを含む、フィルタリング後の潜在表現バッチを出力します。

使用シナリオ

動画生成や編集のワークフローにおいて、このノードは非常に有用です。例えば、「VAE Encode (for Batches)」のようなノードを使用して動画の潜在シーケンスを一括生成した後、このノードを使用してその中から品質が最高または最も重要な数フレームのみを選択し、フィルタリングされた結果を次のサンプリングノードやデコードノードに送ることができます。これにより、選択された部分に焦点を当てた処理が可能になり、作業効率が向上したり、特定の効果を実現したりできます。

注意事項

インデックスは0から始まることに注意してください。エラーチェックオプションが有効になっている場合、指定されたインデックスが入力潜在表現の実際の範囲を超えている場合、または最終的なフィルタリング結果が空の場合、ノードは例外をスローし、ワークフローの実行を停止します。これは、複雑なプロセスで問題を迅速に特定するのに役立ちます。

Select Latents 🎥🅥🅗🅢 ノードソースコードリンク

Select Latents 🎥🅥🅗🅢 ノードは ComfyUI-VideoHelperSuite ノードパッケージに含まれています。

Select Latents 🎥🅥🅗🅢(SelectLatents)

Select Latents