Documentation for ImageColorMatch+

Overview

ImageColorMatch+ is a node in the ComfyUI Essentials repository designed to perform color matching between an input image and a reference image using various color spaces. This node helps adjust the color tones of an input image to align with those of a reference image, making the images appear more consistent in terms of color grading.

Features

• Supports multiple color spaces for matching, including LAB, YCbCr, RGB, LUV, YUV, and XYZ.
• Adjustable matching intensity, allowing users to control the degree of color correction applied.
• Optional reference mask to limit color matching to specific areas of the reference image.
• Flexible execution across different devices, including CPU and GPU.

Inputs

• Image: The primary image that will undergo color matching. This is the image whose colors you wish to adjust.
• Reference: The image whose color scheme you want to apply to the main image. It serves as the guide for color adjustments.
• Color Space: Choose from several color spaces like LAB, YCbCr, RGB, LUV, YUV, and XYZ for the matching process.
• Factor: A float value ranging from 0.0 to 1.0 that controls the intensity of the color match. A factor of 1.0 applies full matching, while 0.0 retains the original image's colors.
• Device: Determines where the computation is performed — options include "auto", "cpu", and "gpu".
• Batch Size: This optional parameter defines how many images are processed in one batch. It's helpful in managing resource usage when working with large image sets.
• Reference Mask (optional): A mask to specify which parts of the reference image to consider during the matching. This allows for partial color matching, focusing on particular areas.

Outputs

• Image: The result is an image with colors adjusted to match those of the reference image. The output retains the resolution and other properties of the original input image but with modified color tones according to the specified factor and color space.

Usage in ComfyUI Workflows

• Consistency Across Images: Use this node to ensure consistent color grading across a series of images, making it especially beneficial for animations or series of related artworks.
• Color Correction: Ideal for correcting color imbalances or achieving a specific aesthetic by borrowing the color palette of a target reference image.
• Selective Color Matching: By employing a reference mask, users can apply color correction only to certain parts of the image, allowing for creative control and precision.
• Enhancing Image Harmony: Blend images from different sources harmoniously by aligning their color schemes, making this node invaluable for digital art projects, collage work, and mood boarding.

Considerations

• Performance: Depending on the device chosen, performance may vary. Using a GPU is recommended for faster processing, particularly with high-resolution images.
• Color Space Selection: The choice of color space can significantly affect the results. LAB is often preferable for perceptual uniformity, while RGB can be more straightforward for simpler tasks.
• Batch Processing: Adjusting the batch size can optimize performance but may require balancing with available memory resources.
• Mask Usage: When using masks, ensure they are correctly formatted and aligned with the reference image to achieve the desired effect.

Incorporating ImageColorMatch+ into your ComfyUI workflows can significantly enhance visual consistency and color precision, offering a wide range of possibilities for image customization and artistic expression.