ComfyUI Node: Imitation Hue

Imitation Hue:

The ImitationHueNode is designed to facilitate the transfer of color characteristics from one image to another, allowing you to achieve a harmonious color palette across different images. This node is particularly useful for artists and designers who wish to maintain a consistent aesthetic or mood in their visual projects. By leveraging advanced color transfer techniques, the node can adjust the hue, brightness, contrast, saturation, and tone of an image to match a target image, while also offering options for skin tone protection and automatic adjustments. This ensures that the resulting image not only matches the desired color scheme but also retains natural and visually pleasing qualities.

Imitation Hue Input Parameters:

imitation_image

This parameter represents the source image(s) from which the color characteristics will be extracted. The node processes these images to determine the color profile that will be applied to the target image. The input should be in a format compatible with the node's processing capabilities, typically as a tensor.

target_image

The target image is the one that will receive the color characteristics from the imitation image. This parameter is crucial as it defines the canvas on which the color transfer will be applied. The target image should be provided in a compatible format, usually as a tensor.

strength

This parameter controls the intensity of the color transfer effect. A higher strength value results in a more pronounced color change, while a lower value yields a subtler effect. The range typically varies from 0.0 to 1.0, with a default value that balances between noticeable and natural-looking results.

skin_protection

Skin protection is a feature that helps preserve natural skin tones during the color transfer process. This parameter allows you to specify the degree of protection, ensuring that skin areas are not overly altered, which is particularly important in portrait images. The value usually ranges from 0.0 to 1.0.

auto_brightness

When enabled, this parameter allows the node to automatically adjust the brightness of the target image to better match the imitation image. This can help in achieving a more cohesive look without manual intervention. It is typically a boolean value.

brightness_range

This parameter defines the range within which the brightness can be adjusted when auto_brightness is enabled. It provides flexibility in how much the brightness can vary, ensuring that the adjustments remain within a desired scope. The range is usually specified as a float value.

auto_contrast

Similar to auto_brightness, this parameter enables automatic contrast adjustment to align the target image's contrast with that of the imitation image. It is a boolean value that, when set to true, activates this feature.

contrast_range

This parameter specifies the allowable range for contrast adjustments when auto_contrast is enabled. It ensures that the contrast changes remain controlled and within a specified limit, typically expressed as a float value.

auto_saturation

This parameter, when enabled, allows the node to automatically adjust the saturation levels of the target image to match the imitation image. It is a boolean value that helps in achieving a balanced color intensity across images.

saturation_range

Defines the range for saturation adjustments when auto_saturation is active. This parameter ensures that saturation changes are kept within a desired boundary, providing control over the color intensity. It is usually a float value.

auto_tone

Auto_tone is a feature that, when enabled, automatically adjusts the tonal balance of the target image to better match the imitation image. This parameter is a boolean value that helps in achieving a more harmonious overall tone.

tone_strength

This parameter controls the strength of the tonal adjustments when auto_tone is enabled. It allows you to specify how much the tone of the target image should be influenced by the imitation image, typically ranging from 0.0 to 1.0.

mask

An optional parameter that allows you to specify a mask image. The mask can be used to limit the color transfer to specific areas of the target image, providing greater control over which parts of the image are affected by the color changes. The mask should be in a compatible format, usually as a tensor.

Imitation Hue Output Parameters:

result_image

The output of the ImitationHueNode is the processed image with the color characteristics of the imitation image applied to the target image. This result is typically returned as a tensor, ready for further processing or display. The output image reflects the adjustments made based on the input parameters, providing a visually cohesive result that aligns with the desired aesthetic.

Imitation Hue Usage Tips:

• To achieve subtle color harmonization, start with a lower strength value and gradually increase it until the desired effect is achieved.
• Use the skin_protection parameter when working with portraits to ensure that skin tones remain natural and appealing.
• Experiment with auto_brightness and auto_contrast to quickly achieve a balanced look without manual adjustments.
• Utilize the mask parameter to selectively apply color changes to specific areas of the image, allowing for creative control over the final result.

Imitation Hue Common Errors and Solutions:

"Invalid image format"

• Explanation: This error occurs when the input images are not in the expected format, such as a tensor.
• Solution: Ensure that all input images are correctly formatted as tensors before passing them to the node.

"Parameter out of range"

• Explanation: One or more input parameters are set outside their allowable range.
• Solution: Double-check the values of parameters like strength, brightness_range, and contrast_range to ensure they fall within the specified limits.

"Mask size mismatch"

• Explanation: The mask image does not match the dimensions of the target image.
• Solution: Resize the mask to match the target image dimensions before using it in the node.