Load Video (Path) 🎥🅥🅗🅢 (LoadVideoPath) - ComfyUI-VideoHelperSuite

Load Video (Path) 🎥🅥🅗🅢 ノードは、豊富な動画処理オプションを提供し、ユーザーが読み込みプロセスを詳細に制御できるようにします。

Load Video (Path) ノードは、Video Helper Suite ツールキットのコアコンポーネントであり、ローカルファイルシステムまたはネットワーク URL から動画ファイルを読み込むために使用されます。その主な機能は、動画ファイルを一連の連続した画像フレーム（IMAGE）にデコードし、ComfyUI のワークフロー内で後続の画像処理、分析、または生成タスクを行えるようにすることです。

ノード機能

このノードは豊富な動画処理オプションを提供し、ユーザーが読み込みプロセスを詳細に制御できるようにします。例えば、ユーザーは読み込むフレーム数を制限したり、最初の数フレームをスキップしたり、一定間隔でフレームを抽出したり、さらには出力フレームのサイズやフレームレートを強制的に指定することもできます。これにより、大規模な動画ファイルの処理や、特定の前処理ステップが必要なシナリオに非常に適しています。

ノードパラメータ説明 - Load Video (Path) 🎥🅥🅗🅢

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`meta_batch`	VHS_BatchManager	否	-	-	：バッチ処理マネージャーに接続し、バッチ処理モードで複数の動画の読み込みを調整します。
`vae`	VAE	否	-	-	：VAE モデルに接続します。提供された場合、動画フレームの潜在空間表現（LATENT）を直接出力します。それ以外の場合は画像（IMAGE）を出力します。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`video`	STRING	是	-	-	：読み込む動画ファイルのパスまたはネットワーク URL を指定します。一般的な動画形式（例：.mp4, .mov, .avi など）をサポートします。
`force_rate`	コンボ	是	0	0 - 60 (ステップ: 1)	：出力フレームシーケンスのフレームレート（FPS）を強制的に設定します。範囲は 0 から 60、ステップは 1 です。0 に設定すると、動画の元のフレームレートを使用します。
`custom_width`	INT	是	0	0 - DIMMAX	：出力画像の幅を強制的に設定します。範囲は 0 から DIMMAX、0 に設定すると動画の元の幅を保持します。
`custom_height`	INT	是	0	0 - DIMMAX	：出力画像の高さを強制的に設定します。範囲は 0 から DIMMAX、0 に設定すると動画の元の高さを保持します。
`frame_load_cap`	INT	是	0	0 - BIGMAX (ステップ: 1)	：読み込む最大フレーム数を制限します。範囲は 0 から BIGMAX、ステップは 1 です。0 に設定するとすべてのフレームを読み込みます。
`skip_first_frames`	INT	是	0	0 - BIGMAX (ステップ: 1)	：動画の先頭から指定された数のフレームをスキップしてから読み込みを開始します。範囲は 0 から BIGMAX、ステップは 1 です。
`select_every_nth`	INT	是	1	1 - BIGMAX (ステップ: 1)	：N フレームごとに 1 フレームを読み込み、ダウンサンプリングに使用します。範囲は 1 から BIGMAX、ステップは 1 です。

出力

パラメータ名	データ型	説明
IMAGE	不明	：出力される動画フレームシーケンス（画像または潜在空間表現）。
frame_count	INT	：実際に正常に読み込まれた動画フレームの総数。
audio	AUDIO	：動画から抽出されたオーディオトラックデータ。
VHS_VIDEOINFO	VHS_VIDEOINFO	：元のサイズやフレームレートを含む動画メタデータ。

使用シナリオ

このノードの重要な特性は、VAE（変分オートエンコーダ）との接続をサポートしていることです。VAE モデルが提供されると、ノードは動画フレームを直接潜在空間表現（LATENT）にエンコードして出力するため、明示的な画像デコードステップをスキップできます。これにより、処理パイプラインの効率が大幅に向上し、特に動画入力を潜在空間ベースの生成モデル（Stable Diffusion など）に渡すワークフローに適しています。

注意事項

さらに、ノードは動画のメタ情報（元のサイズ、フレームレートなど）、抽出されたオーディオトラック、および実際に読み込まれたフレームの総数も出力します。これらの出力は、後続のノードに必要なコンテキスト情報を提供し、複雑な動画処理パイプラインの構築を容易にします。

Load Video (Path) 🎥🅥🅗🅢 ノードソースコードリンク

Load Video (Path) 🎥🅥🅗🅢 ノードは ComfyUI-VideoHelperSuite ノードパッケージから提供されています。

Load Video (Path) 🎥🅥🅗🅢(LoadVideoPath)

Load Video Path