Load Image (Path) 🎥🅥🅗🅢(LoadImagePath)
This node technically processes the input path via the `load_video` function, so it can load not only common static image formats (such as PNG, JPG) but also handle sequences composed of multiple images.
Load Image Path
The Load Image (Path) 🎥🅥🅗🅢 node technically processes the input path via the load_video function, enabling it to load not only common static image formats (such as PNG, JPG) but also sequences composed of multiple images.
The Load Image (Path) node is a core tool within the Video Helper Suite, used to load a single image or an image sequence from the local file system. Its core functionality is to read image files from a specified path and convert them into an image tensor format usable within ComfyUI workflows, while also supporting optional resizing.
Node Functionality
This node technically processes the input path via the load_video function, enabling it to load not only common static image formats (such as PNG, JPG) but also sequences composed of multiple images. Its internal mechanism checks whether the image contains an Alpha channel (transparency). If present, it automatically separates the RGB image and the corresponding mask; if not, it outputs an empty mask placeholder. The node also includes path validation and hash checking functions to ensure input validity and cache updates.
Node Parameter Description - Load Image (Path) 🎥🅥🅗🅢
Connection Inputs (Inputs)
| Parameter Name | Data Type | Required | Default Value | Value Range/Options | Description |
|---|---|---|---|---|---|
vae | VAE | No | - | - | vae (Input Parameter): Optional VAE model. |
Control Parameters (Parameters)
| Parameter Name | Data Type | Required | Default Value | Value Range/Options | Description |
|---|---|---|---|---|---|
image | STRING | Yes | - | - | image (Input Parameter): Specifies the full system path of the image file to load. Supports common image formats. |
custom_width | INT | Yes | 0 | 0 - DIMMAX (Step: 8) | custom_width (Input Parameter): Custom width for the output image. Set to 0 to use the original image width. Value range is 0 to DIMMAX, with an adjustment step of 8. |
custom_height | INT | Yes | 0 | 0 - DIMMAX (Step: 8) | custom_height (Input Parameter): Custom height for the output image. Set to 0 to use the original image height. Value range is 0 to DIMMAX, with an adjustment step of 8. |
Output
| Parameter Name | Data Type | Description |
|---|---|---|
| IMAGE | UNKNOWN | IMAGE (Output Parameter): The output image tensor, used for subsequent image processing nodes. |
| MASK | MASK | MASK (Output Parameter): The mask output – the alpha channel of the loaded image if present, otherwise an empty mask placeholder. |
Usage Scenarios
This node is very useful in workflows for video frame processing or batch image preprocessing. For example, you can connect it to a "VAE Encode" node to encode the loaded image into a latent space representation for subsequent image-to-image operations; or, use its output mask in conjunction with nodes like "Apply ControlNet" to achieve fine-grained control over specific areas of the image.
Notes
Please note that the input image path must be a valid path accessible by the system. When the custom_width and custom_height parameters are set to 0, the original dimensions of the image will be maintained.
Load Image (Path) 🎥🅥🅗🅢 Node Source Code Link
The Load Image (Path) 🎥🅥🅗🅢 node is from the ComfyUI-VideoHelperSuite node package.
Comments
Sign in with GitHub to join the discussion.