Image Color Match(imageColorMatch)

Description

Image Color Match applies a color transfer from a reference image (image_ref) to a target image (image_target), returning a recolored version of the target image. It is part of the EasyUse/Image category and is implemented by the imageColorMatch node.

The node provides several color matching algorithms, from statistical and histogram-based methods to more advanced hybrid approaches, so the same inputs can produce very different color grading results depending on the selected method.

Inputs

image_ref

• Type: IMAGE
• Required: Yes

The reference image whose color characteristics, tones, or color distribution will be transferred to the target image.

image_target

• Type: IMAGE
• Required: Yes

The image that will be recolored. The output is a color-matched version of this image.

method

• Type: COMBO
• Required: Yes
• Options: wavelet, adain, mkl, hm, reinhard, mvgd, hm-mvgd-hm, hm-mkl-hm

Selects the color matching algorithm:

• wavelet — wavelet-based color transfer.
• adain — adaptive instance normalization transfer.
• mkl — a kernel-learning based color mapping method.
• hm — histogram matching.
• reinhard — the classic Reinhard statistical color transfer method.
• mvgd — multivariate Gaussian distribution-based color transfer.
• hm-mvgd-hm — a hybrid combination of histogram matching and multivariate Gaussian distribution transfer.
• hm-mkl-hm — a hybrid combination of histogram matching and kernel-learning based transfer.

The best method depends on the content and color relationship between the reference and target images.

image_output

• Type: COMBO
• Required: Yes
• Default: Preview
• Options: Hide, Preview, Save, Hide/Save

Controls how the resulting image is handled:

• Hide — do not display or save the output automatically.
• Preview — show the output in the UI for preview.
• Save — save the output to disk.
• Hide/Save — save the output to disk without showing a preview.

save_prefix

• Type: STRING
• Required: Yes
• Default: ComfyUI

The filename prefix used when saving the output image. This only applies when image_output is set to Save or Hide/Save.

Outputs

• IMAGE — the color-matched target image.

Usage Notes

• The node works directly on batched image inputs, so multiple images can be processed in one call.
• When saving outputs, the save_prefix is combined with the standard ComfyUI save naming scheme.
• For best results, experiment with different method values, as each algorithm handles color statistics and image detail differently.