Get Latent Range From Batch (GetLatentRangeFromBatch) - ComfyUI-KJNodes

Get Latent Range From Batch ノードは、2つの一般的な次元の潜在テンソルを処理できます：4次元（B, C, H, W）と5次元（B, C, T, H, W）形式で、それぞれ画像バッチとビデオフレームシーケンスに対応します。

Get Latent Range From Batch ノードは、潜在空間（Latent）バッチから指定された範囲のデータを抽出するためのツールです。その中核機能は、ユーザーが設定した開始位置と数量に基づいて、入力されたバッチ潜在テンソルから連続したサブセットを切り取ることです。この操作は、ビデオシーケンスやバッチ画像内の特定部分を処理する必要があるワークフローで非常に有用です。

ノード機能

このノードは、2つの一般的な次元の潜在テンソルを処理できます：4次元（B, C, H, W）と5次元（B, C, T, H, W）形式で、それぞれ画像バッチとビデオフレームシーケンスに対応します。その内部メカニズムは、入力テンソルの形状を解析してバッチまたは時間次元のサイズを決定し、提供された開始インデックスとフレーム数パラメータに基づいて、スライス操作を使用してターゲット範囲内のデータを正確に抽出します。パラメータが-1に設定されている場合、ノードは自動的に対応する境界値を計算します。

ノードパラメータ説明 - Get Latent Range From Batch

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`latents`	LATENT	はい	-	-	latents（入力パラメータ）：潜在テンソルを含むバッチを入力します。ノードはここから指定範囲のデータを抽出します。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`start_index`	INT	はい	0	-1 - 4096 (ステップ: 1)	start_index（入力パラメータ）：抽出操作の開始位置インデックスを指定します。範囲は-1から4096で、ステップは1です。-1に設定すると末尾から計算を開始します。
`num_frames`	INT	はい	1	-1 - 4096 (ステップ: 1)	num_frames（入力パラメータ）：抽出する必要がある連続データ（フレーム）の数を指定します。範囲は-1から4096で、ステップは1です。-1に設定すると、開始インデックスから末尾までのすべてのデータを抽出します。

出力 (Output)

パラメータ名	データ型	説明
LATENT	LATENT	LATENT（出力パラメータ）：抽出されたサブ範囲の潜在テンソルを含む新しいバッチを出力します。

使用シナリオ

アニメーション制作やビデオ処理ワークフローにおいて、このノードは長いシーケンスからキーとなるクリップを抽出して詳細な処理を行うために使用できます。例えば、ユーザーはまず1つのノードを使用して複数フレームを含む潜在ビデオシーケンスを生成し、その後このノードを通じて重点的に調整する必要がある数フレームを切り取り、他のノードに送ってスタイライズや修復を行い、最後に処理されたクリップを元のシーケンスと再結合することができます。

注意事項

開始インデックスは、入力潜在テンソルの有効範囲内でなければならないことに注意してください。そうでない場合、ノードはエラーを報告します。5次元テンソルの場合、操作は時間次元（T）でスライスされます。4次元テンソルの場合、操作はバッチ次元（B）で行われます。

Get Latent Range From Batch ノードソースコードリンク

Get Latent Range From Batch ノードは ComfyUI-KJNodes ノードパッケージから提供されています。

Get Latent Range From Batch(GetLatentRangeFromBatch)