ComfyUI Node: Convert color space

Convert color space:

The ColorspaceConvert node is designed to facilitate the conversion of images between different color spaces, such as RGB, BGR, HLS, HSV, YCrCb, and YUV. This node is particularly useful for AI artists who need to manipulate images in various color formats for different processing tasks. By converting images to the appropriate color space, you can achieve more accurate color adjustments, filtering, and other image processing operations. The node leverages the powerful OpenCV library to perform these conversions efficiently, ensuring high-quality results.

Convert color space Input Parameters:

image

This parameter represents the input image that you want to convert. The image should be in a tensor format, typically used in AI and machine learning workflows. The image is processed in batches, allowing for efficient handling of multiple images simultaneously.

src

The src parameter specifies the source color space of the input image. It determines the current color format of the image before conversion. The available options are "RGB", "BGR", "HLS", "HSV", "YCrCb", and "YUV". The default value is "RGB". Choosing the correct source color space is crucial for accurate conversion results.

dst

The dst parameter defines the destination color space to which the input image will be converted. Similar to the src parameter, the available options are "RGB", "BGR", "HLS", "HSV", "YCrCb", and "YUV". The default value is "RGB". Selecting the appropriate destination color space allows you to prepare the image for subsequent processing steps that require a specific color format.

Convert color space Output Parameters:

IMAGE

The output parameter is the converted image in the specified destination color space. The output is provided in a tensor format, maintaining the batch structure of the input. This converted image can then be used for further processing or analysis in the desired color space.

Convert color space Usage Tips:

• Ensure that the src and dst parameters are correctly set to match the current and desired color spaces of your image to avoid conversion errors.
• Use this node to prepare images for specific tasks that require a particular color space, such as HSV for color-based segmentation or YUV for compression algorithms.
• When working with multiple images, take advantage of the batch processing capability to convert all images in a single operation, improving efficiency.

Convert color space Common Errors and Solutions:

Color conversion failed! Missing cv2 op 'COLOR_<src>2<dst>'

• Explanation: This error occurs when the specified color space conversion is not supported by the OpenCV library.
• Solution: Verify that the src and dst parameters are set to valid and supported color spaces. Refer to the OpenCV documentation for a list of supported color space conversions.

AssertionError: Batch size mismatch!

• Explanation: This error indicates that the input images in the batch do not have consistent dimensions or batch sizes.
• Solution: Ensure that all input images have the same dimensions and batch sizes before passing them to the node for conversion.