Load Image (Path) 🎥🅥🅗🅢 (LoadImagePath) - ComfyUI-VideoHelperSuite

Load Image (Path) 🎥🅥🅗🅢 ノードは、技術的には load_video 関数を使用して入力パスを処理するため、PNGやJPGなどの一般的な静的画像フォーマットだけでなく、複数の画像で構成されるシーケンスも読み込むことができます。

Load Image (Path) ノードは、Video Helper Suite のコアツールの一つで、ローカルファイルシステムから単一の画像または画像シーケンスを読み込むために使用されます。その主な機能は、指定されたパスの画像ファイルを読み込み、ComfyUI ワークフローで使用可能な画像テンソル形式に変換することです。また、オプションでのサイズ変更もサポートしています。

ノードの機能

このノードは、技術的には load_video 関数を使用して入力パスを処理するため、PNGやJPGなどの一般的な静的画像フォーマットだけでなく、複数の画像で構成されるシーケンスも読み込むことができます。内部メカニズムでは、画像にアルファチャンネル（透明度）が含まれているかどうかをチェックし、含まれている場合は自動的にRGB画像と対応するマスクを分離します。含まれていない場合は、空のマスクプレースホルダーを出力します。ノードには、入力の有効性とキャッシュの更新を確保するためのパス検証とハッシュチェック機能も含まれています。

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

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`vae`	VAE	任意	-	-	vae (入力パラメータ): オプションのVAEモデル。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`image`	STRING	必須	-	-	image (入力パラメータ): 読み込む画像ファイルの完全なシステムパスを指定します。一般的な画像フォーマットをサポートします。
`custom_width`	INT	必須	0	0 - DIMMAX (ステップ: 8)	custom_width (入力パラメータ): 出力画像の幅をカスタマイズします。0に設定すると元の画像の幅を使用します。範囲は0からDIMMAXまでで、調整ステップは8です。
`custom_height`	INT	必須	0	0 - DIMMAX (ステップ: 8)	custom_height (入力パラメータ): 出力画像の高さをカスタマイズします。0に設定すると元の画像の高さを使用します。範囲は0からDIMMAXまでで、調整ステップは8です。

出力 (Output)

パラメータ名	データ型	説明
IMAGE	UNKNOWN	IMAGE (出力パラメータ): 後続の画像処理ノードで使用するための出力画像テンソル。
MASK	MASK	MASK (出力パラメータ): ロードした画像のアルファチャンネルがある場合はそのマスク、それ以外の場合は空のマスクプレースホルダー。

使用シナリオ

ビデオフレーム処理やバッチ画像前処理のワークフローにおいて、このノードは非常に有用です。例えば、「VAE Encode」ノードに接続して、読み込んだ画像を潜在空間表現にエンコードし、後続の画像から画像への操作を行ったり、または、出力されるマスクを「Apply ControlNet」などのノードと組み合わせて使用し、画像の特定領域に対する精密な制御を実現したりできます。

注意事項

入力する画像パスは、システムがアクセス可能な有効なパスでなければなりません。custom_width および custom_height パラメータを0に設定すると、画像の元のサイズが維持されます。

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

Load Image (Path) 🎥🅥🅗🅢 ノードは ComfyUI-VideoHelperSuite ノードパッケージに含まれています。

Load Image (Path) 🎥🅥🅗🅢(LoadImagePath)

Load Image Path