ComfyUI Node: Image Load

Image Load:

The Image Load node is designed to facilitate the loading of images into your workflow, whether they are stored locally or accessible via a URL. This node is essential for AI artists who need to incorporate external images into their projects, providing a seamless way to import images for further processing or analysis. By handling various image formats and ensuring proper orientation through EXIF data, the Image Load node ensures that your images are ready for immediate use. This node also supports the conversion of images to different color modes, making it versatile for various artistic and technical needs.

Image Load Input Parameters:

image_path

The image_path parameter specifies the location of the image you want to load. This can be a local file path or a URL. If the path is a URL, the node will download the image from the internet. This parameter is crucial as it determines the source of the image to be loaded. There are no specific minimum or maximum values, but the path must be valid and accessible.

RGBA

The RGBA parameter is a boolean option that determines whether the image should be loaded with an alpha channel (transparency). If set to true, the image will include the alpha channel; if set to false, the image will be converted to RGB, discarding any transparency information. The default value is false.

filename_text_extension

The filename_text_extension parameter is a boolean option that specifies whether the filename should include its extension. If set to true, the filename will include the extension (e.g., .jpg, .png); if set to false, the extension will be omitted. The default value is true.

Image Load Output Parameters:

image

The image output parameter provides the loaded image as a tensor. This tensor can be used in subsequent nodes for further processing or analysis. The image is normalized to a float32 array with values between 0 and 1.

mask

The mask output parameter provides a mask tensor derived from the alpha channel of the image, if available. This mask can be used for operations that require transparency information. If the image does not have an alpha channel, a default mask of zeros is provided.

filename

The filename output parameter provides the name of the loaded image file. This can be useful for tracking and referencing the image in your workflow. The filename can include or exclude the extension based on the filename_text_extension parameter.

Image Load Usage Tips:

• Ensure that the image_path is correct and accessible to avoid loading errors.
• Use the RGBA parameter to retain transparency information if your workflow requires it.
• Set the filename_text_extension parameter according to your needs for file tracking and management.

Image Load Common Errors and Solutions:

The image `<image_path>` specified doesn't exist!

• Explanation: This error occurs when the specified image path is invalid or the file does not exist at the given location.
• Solution: Verify that the image_path is correct and that the file exists at the specified location. If using a URL, ensure it is accessible and properly formatted.

Image loading failed due to unsupported format

• Explanation: This error occurs when the image format is not supported by the node.
• Solution: Convert the image to a supported format (e.g., JPEG, PNG) and try loading it again.

Failed to download image from URL

• Explanation: This error occurs when the node is unable to download the image from the specified URL.
• Solution: Check the URL for correctness and ensure that the server hosting the image is accessible. Verify your internet connection if necessary.