ComfyUI Node: 🔧 Image Histogram Match

🔧 Image Histogram Match+:

The ImageHistogramMatch+ node is designed to adjust the color distribution of an image to match the histogram of a reference image. This process, known as histogram matching, ensures that the color tones and intensities of the target image closely resemble those of the reference image. This can be particularly useful in applications where you want to achieve a consistent look across multiple images or when you need to apply a specific color grading style from one image to another. The node leverages advanced techniques to compute and apply the necessary transformations, making it a powerful tool for image processing and enhancement tasks.

🔧 Image Histogram Match+ Input Parameters:

image1

This parameter represents the target image whose histogram will be adjusted. The image should be provided in a compatible format, typically as a tensor. The quality and resolution of this image will directly impact the final result, so using high-quality images is recommended.

image2

This parameter is the reference image whose histogram will be used as the template for adjustment. Similar to the target image, it should be provided in a compatible format. The reference image's color distribution will dictate the transformation applied to the target image, so choose an image with the desired color characteristics.

🔧 Image Histogram Match+ Output Parameters:

IMAGE

The output is the transformed image with its histogram matched to that of the reference image. This image will have color tones and intensities adjusted to closely resemble those of the reference image, providing a consistent and visually appealing result.

🔧 Image Histogram Match+ Usage Tips:

• Ensure that both the target and reference images are of similar resolution and quality to achieve the best results.
• Use high-quality reference images with the desired color characteristics to guide the histogram matching process effectively.
• Experiment with different reference images to see how various color distributions affect the target image.

🔧 Image Histogram Match+ Common Errors and Solutions:

AssertionError: dst.device == ref.device

• Explanation: This error occurs when the target and reference images are not on the same device (e.g., one is on the CPU and the other on the GPU).
• Solution: Ensure that both images are loaded onto the same device before passing them to the node.

RuntimeError: size mismatch

• Explanation: This error happens when the dimensions of the target and reference images do not match.
• Solution: Resize the reference image to match the dimensions of the target image before performing histogram matching.

ValueError: Unsupported image format

• Explanation: This error indicates that the provided images are in an unsupported format.
• Solution: Convert the images to a supported format, such as RGB, before using the node.