ComfyUI Node: HSVThresholdMask

HSVThresholdMask:

The HSVThresholdMask node is designed to create a mask from an image based on specified thresholds in the HSV (Hue, Saturation, Value) color space. This node is particularly useful for isolating specific colors or intensity ranges within an image, allowing you to focus on or manipulate certain parts of the image based on their color properties. By converting the image to the HSV color space, the node can apply thresholds to the hue, saturation, or value channels, generating a binary mask that highlights the areas of the image that fall within the specified thresholds. This can be beneficial for tasks such as color-based segmentation, object detection, or any scenario where color properties are a key factor.

HSVThresholdMask Input Parameters:

image

This parameter expects an image tensor in the format of a 4D tensor (batch_size, height, width, channels). The image will be processed to generate the mask based on the specified HSV thresholds.

low_threshold

This parameter sets the lower bound of the threshold for the selected HSV channel. It is a float value ranging from 0 to 1, with a default value of 0.2. Adjusting this value will determine the minimum value of the HSV channel that will be included in the mask.

high_threshold

This parameter sets the upper bound of the threshold for the selected HSV channel. It is a float value ranging from 0 to 1, with a default value of 0.7. Adjusting this value will determine the maximum value of the HSV channel that will be included in the mask.

hsv_channel

This parameter specifies which HSV channel to apply the threshold to. It can be one of the following options: "hue", "saturation", or "value". Selecting the appropriate channel will determine which aspect of the color space the thresholds will be applied to.

HSVThresholdMask Output Parameters:

IMAGE

The output is a binary mask image where the pixels that fall within the specified HSV thresholds are highlighted. This mask can be used for further image processing tasks, such as segmentation or object detection.

HSVThresholdMask Usage Tips:

• To isolate specific colors in an image, use the "hue" channel and adjust the low and high thresholds to the desired color range.
• For tasks requiring intensity-based segmentation, use the "value" channel to focus on brightness levels within the image.
• Experiment with different threshold values to fine-tune the mask and achieve the desired level of detail and accuracy.

HSVThresholdMask Common Errors and Solutions:

Image tensor shape mismatch

• Explanation: The input image tensor does not have the expected shape (batch_size, height, width, channels).
• Solution: Ensure that the input image tensor is correctly formatted as a 4D tensor with the appropriate dimensions.

Invalid HSV channel selection

• Explanation: The specified HSV channel is not one of the allowed options ("hue", "saturation", "value").
• Solution: Verify that the hsv_channel parameter is set to either "hue", "saturation", or "value".

Threshold values out of range

• Explanation: The low_threshold or high_threshold values are outside the allowed range of 0 to 1.
• Solution: Adjust the threshold values to be within the range of 0 to 1.