Load Videos From Folder (LoadVideosFromFolder) - ComfyUI-KJNodes

Load Videos From Folder ノードは、VideoHelperSuite 拡張機能に依存してビデオデコード機能を実現し、一般的なビデオフォーマットをサポートします。

Load Videos From Folder ノードは、指定されたフォルダからビデオファイルを一括読み込みするためのツールノードです。その中核機能は、ビデオを読み取り、そのフレームシーケンスを ComfyUI が処理可能な画像テンソルに変換し、後続の画像またはビデオ処理ワークフローへの入力ソースを提供することです。

ノード機能

このノードは、VideoHelperSuite 拡張機能に依存してビデオデコード機能を実現し、一般的なビデオフォーマットをサポートします。その内部メカニズムは、ビデオファイルをフレームごとにデコードし、ユーザーが設定したパラメータ（フレームスキップ、サイズ調整など）に基づいてフレームシーケンスを前処理し、最終的には複数フレーム画像を含むバッチまたはグリッド化された画像を出力します。

ノードパラメータ説明 - Load Videos From Folder

パラメータ

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`output_type`	COMBO	はい	batch	"batch", "grid"	output_type（入力パラメータ）：出力画像の配置方法を選択します。"batch"はフレームをバッチにパッケージ化し、"grid"は複数フレームをグリッド画像に配置します。有効なオプション："batch", "grid"。
`video`	STRING	はい	X://insert/path/	-	video（入力パラメータ）：読み込むビデオファイルを含むフォルダのパスを指定します。ノードはこのパス下のすべてのビデオファイルを読み込みます。
`force_rate`	FLOAT	はい	0	0 - 60 (ステップ: 1)	force_rate（入力パラメータ）：出力フレームシーケンスのフレームレート（FPS）を強制的に設定します。0に設定するとビデオのオリジナルフレームレートを使用します。範囲は0-60、ステップは1。
`custom_width`	INT	はい	0	0 - 4096	custom_width（入力パラメータ）：出力画像の幅をカスタマイズします。0に設定するとビデオのオリジナル幅を維持します。範囲は0-4096。
`custom_height`	INT	はい	0	0 - 4096	custom_height（入力パラメータ）：出力画像の高さをカスタマイズします。0に設定するとビデオのオリジナル高さを維持します。範囲は0-4096。
`frame_load_cap`	INT	はい	0	0 - 10000 (ステップ: 1)	frame_load_cap（入力パラメータ）：読み込む最大フレーム数を制限します。0は制限なしを意味し、処理量を制御するために使用します。範囲は0-10000、ステップは1。
`skip_first_frames`	INT	はい	0	0 - 10000 (ステップ: 1)	skip_first_frames（入力パラメータ）：ビデオの先頭から指定された数のフレームをスキップしてから読み込みを開始します。範囲は0-10000、ステップは1。
`select_every_nth`	INT	はい	1	1 - 1000 (ステップ: 1)	select_every_nth（入力パラメータ）：間隔サンプリングを行い、Nフレームごとのみを読み込みます。フレームレートを下げたり処理を高速化するために使用します。範囲は1-1000、ステップは1。
`grid_max_columns`	INT	はい	4	1 - 16 (ステップ: 1)	grid_max_columns（入力パラメータ）：出力タイプが"grid"の場合、グリッドレイアウトの最大列数を設定します。範囲は1-16、ステップは1。
`add_label`	BOOLEAN	はい	False	-	add_label（入力パラメータ）：出力画像にファイル名ラベルを追加するかどうかを決定するブール値。異なるビデオソースを識別するために使用します。

出力

パラメータ名	データ型	説明
IMAGE	IMAGE	IMAGE（出力パラメータ）：読み込みおよび処理されたビデオフレームシーケンスを、画像テンソル形式で出力します。

使用シナリオ

ビデオスタイル転送やビデオサムネイルプレビュー生成のワークフローを作成する際に、このノードは非常に有用です。ユーザーはこれを画像アップスケーリング、フィルタ適用、またはフレーム補間ノードに接続し、読み込まれたビデオフレームを一括処理することで、ビデオクリップ全体を効率的に処理できます。

注意事項

このノードを使用する前に、ComfyUI-VideoHelperSuite 拡張機能がインストール済みであることを確認してください。また、高解像度または長時間のビデオを処理する際は、VRAM使用量に注意し、フレーム数上限やフレームスキップパラメータを設定することでデータ量を制御できます。

Load Videos From Folder ノードソースコードリンク

Load Videos From Folder ノードは ComfyUI-KJNodes ノードパッケージに含まれています。

Load Videos From Folder(LoadVideosFromFolder)