ComfyUI Node: ◎ Radiance White Balance

◎ Radiance White Balance:

RadianceWhiteBalance is a specialized node designed to adjust the color balance of an image by modifying its white balance settings. This node is particularly useful for AI artists who want to ensure that the colors in their images appear natural and consistent under different lighting conditions. By adjusting the white balance, you can correct color casts that may occur due to the lighting environment in which the image was captured or generated. The node provides flexibility through various parameters, allowing you to fine-tune the temperature and tint of the image to achieve the desired visual effect. This capability is essential for maintaining color accuracy and enhancing the overall aesthetic quality of your images.

◎ Radiance White Balance Input Parameters:

image

The image parameter is a tensor representing the image data that you want to adjust. This input is crucial as it serves as the base upon which the white balance adjustments will be applied. The image should be in a format compatible with the node's processing capabilities, typically a tensor format used in machine learning frameworks like PyTorch.

preset

The preset parameter allows you to select predefined white balance settings that correspond to common lighting conditions, such as daylight or tungsten. This parameter simplifies the process of achieving a natural look by providing a starting point for adjustments. If you choose a preset, the node will automatically apply the corresponding temperature and tint values.

temperature

The temperature parameter controls the warmth or coolness of the image. It is measured in Kelvin and affects the color balance by shifting the image towards blue (cooler) or yellow (warmer) tones. Adjusting this parameter can help correct color casts and achieve a more natural appearance. The default value is typically set to a neutral temperature, such as 5500K, which represents daylight.

tint

The tint parameter adjusts the green-magenta balance of the image. This is useful for fine-tuning the color balance after setting the temperature. A positive tint value will add a magenta cast, while a negative value will add a green cast. This parameter is essential for correcting subtle color imbalances that temperature adjustments alone cannot fix.

source_temperature

The source_temperature parameter specifies the assumed color temperature of the light source when the image was captured. This value is used as a reference point for calculating the necessary adjustments to achieve the desired white balance. The default value is typically set to 5500K, which is a standard daylight temperature.

intensity

The intensity parameter determines the strength of the white balance adjustment applied to the image. A higher intensity value will result in more pronounced changes, while a lower value will apply more subtle adjustments. This parameter allows you to control the degree of correction based on your artistic intent.

use_gpu

The use_gpu parameter is a boolean flag that indicates whether the node should utilize GPU acceleration for processing. Enabling this option can significantly speed up the white balance adjustment process, especially for high-resolution images, by leveraging the parallel processing capabilities of modern GPUs.

◎ Radiance White Balance Output Parameters:

adjusted_image

The adjusted_image parameter is the output tensor representing the image after the white balance adjustments have been applied. This output is crucial as it reflects the changes made to the original image, with corrected color balance and enhanced visual quality. The adjusted image can be used for further processing or as a final output for display or printing.

◎ Radiance White Balance Usage Tips:

• Use the preset parameter to quickly apply common white balance settings and then fine-tune with temperature and tint for more precise control.
• Enable use_gpu to accelerate processing times, especially when working with large images or batch processing multiple images.
• Experiment with different intensity values to achieve the desired level of correction without over-adjusting the image.

◎ Radiance White Balance Common Errors and Solutions:

"Invalid image format"

• Explanation: The input image is not in a compatible tensor format.
• Solution: Ensure that the image is converted to a tensor format compatible with PyTorch before inputting it into the node.

"Preset not recognized"

• Explanation: The specified preset does not match any of the available options.
• Solution: Double-check the preset name for typos or refer to the documentation for a list of valid preset options.

"GPU processing error"

• Explanation: An error occurred while attempting to use GPU acceleration.
• Solution: Verify that your system has a compatible GPU and that the necessary drivers and libraries are installed. If issues persist, try disabling use_gpu to process on the CPU instead.