ComfyUI Node: ColorshiftColor

ColorshiftColor:

The ColorshiftColor node is designed to manipulate the color palette of an image by applying shifts in hue, saturation, and value (HSV). This node is particularly useful for AI artists who want to experiment with color variations and achieve unique visual effects in their artwork. By adjusting the HSV values, you can create dynamic and vibrant color transformations, enhancing the aesthetic appeal of your images. The node provides flexibility in color manipulation, allowing for both random and controlled adjustments, which can be applied selectively to specific colors within the image. This capability makes it an essential tool for creative projects that require precise color control and artistic expression.

ColorshiftColor Input Parameters:

images

This parameter represents the input image or batch of images that you want to process. The images are expected to be in a format compatible with the node's processing capabilities, typically a tensor format. The input images serve as the canvas on which the color transformations will be applied.

color_count

This parameter specifies the number of distinct colors in the image's palette that you want to consider for transformation. It helps in defining the scope of the color manipulation, ensuring that only a specific number of colors are targeted for shifting. The value should be a positive integer, with the default being determined by the image's existing color diversity.

lock_masks

This optional parameter allows you to specify masks that lock certain colors from being altered during the color shift process. By providing a mask, you can protect specific areas of the image from color changes, maintaining their original appearance. This is useful for preserving important details or elements within the artwork.

palette_override

This parameter provides an option to override the existing color palette of the image with a custom palette. By supplying a new palette, you can redefine the color scheme entirely, allowing for creative experimentation and the introduction of new color dynamics into the image.

font_size

This parameter determines the size of the font used for any text annotations or labels that might be applied to the image during processing. It is an integer value, with a default size of 20, ensuring that any text remains legible and appropriately scaled to the image dimensions.

sampling_rate

This parameter controls the rate at which colors are sampled from the image for processing. It is a float value, typically ranging from 0 to 1, with a default of 0.25. A higher sampling rate results in more colors being considered for transformation, while a lower rate focuses on a smaller subset, allowing for more targeted adjustments.

n_init

This parameter specifies the number of initializations or iterations to perform during the color processing. It is an integer value, with a default of 3, which helps in stabilizing the color transformations and achieving consistent results across different runs.

ColorshiftColor Output Parameters:

processed_images

This output parameter provides the images after the color shift transformations have been applied. The processed images reflect the changes in hue, saturation, and value, showcasing the new color dynamics introduced by the node. These images can be used for further artistic exploration or as final outputs for creative projects.

modified_palette

This parameter outputs the modified color palette that was used during the transformation process. It represents the new set of colors that define the image's appearance post-processing, offering insights into the color shifts that occurred.

pixel_mask

This output parameter provides a mask indicating which pixels in the image were affected by the color transformations. It is useful for understanding the extent of the changes and for further processing or analysis of the image.

ColorshiftColor Usage Tips:

• Experiment with different hue_shift, saturation_scale, and value_scale settings to discover unique color combinations and effects that enhance your artwork.
• Use the lock_masks parameter to protect specific areas of your image from color changes, ensuring that important details remain intact while other parts of the image are transformed.
• Consider using the palette_override option to introduce entirely new color schemes to your images, allowing for creative exploration and the development of distinctive visual styles.

ColorshiftColor Common Errors and Solutions:

ValueError: Invalid color index

• Explanation: This error occurs when an invalid color index is specified in the lock_color_num parameter, which is outside the range of the current palette.
• Solution: Ensure that all indices specified in lock_color_num are within the valid range of the palette's length.

RuntimeError: Mismatched image dimensions

• Explanation: This error arises when the input images have dimensions that do not match the expected format for processing.
• Solution: Verify that the input images are correctly formatted and have consistent dimensions that align with the node's requirements.

TypeError: Unsupported palette format

• Explanation: This error is triggered when the palette_override parameter is provided in an unsupported format.
• Solution: Ensure that the custom palette is supplied in a compatible format, typically as a tensor or list of RGB values.