ComfyUI Node: RAW Image Processor (beta)

RAW Image Processor (beta):

The RawImageProcessor is an advanced image processing node designed to handle high-quality image formats such as camera raw, HDR, and lossless formats. It supports a wide range of formats including DNG, ARW, CR2, NEF, EXR, HDR, and TIFF 16-bit, making it an essential tool for photographers and digital artists who work with high-resolution and high-dynamic-range images. The primary goal of this node is to convert these complex image formats into processed image data that is compatible with the EasyColorCorrection system. This allows for seamless integration into workflows that require precise color correction and image enhancement. By leveraging sophisticated algorithms, the RawImageProcessor ensures that the output images maintain their original quality while being optimized for further processing.

RAW Image Processor (beta) Input Parameters:

file_path

The file_path parameter specifies the location of the image file to be processed. It is a string input that should contain the full path to the image file on your system. This parameter is crucial as it directs the node to the specific image that needs processing. The default value is an empty string, and it does not support multiline input, meaning the path should be provided in a single line.

format_type

The format_type parameter determines the format of the image file. By default, it is set to "auto," which allows the node to automatically detect the format of the input image. This parameter is important for ensuring that the correct processing techniques are applied based on the image format.

white_balance

The white_balance parameter controls the white balance adjustment applied to the image. It is set to "auto" by default, which automatically adjusts the white balance based on the image content. Adjusting the white balance can significantly impact the color accuracy and overall appearance of the processed image.

demosaic_algorithm

The demosaic_algorithm parameter specifies the algorithm used for demosaicing raw images. The default value is "AHD" (Adaptive Homogeneity-Directed), which is known for producing high-quality results. Demosaicing is a critical step in converting raw sensor data into a full-color image.

tone_mapping

The tone_mapping parameter determines the tone mapping technique used for HDR images. It is set to "aces" by default, which stands for the Academy Color Encoding System, a widely used standard for high-quality tone mapping. This parameter affects the dynamic range and contrast of the processed image.

hdr_exposure

The hdr_exposure parameter allows you to adjust the exposure level of HDR images. It is a floating-point value with a default of 0.0, which means no additional exposure adjustment is applied. This parameter can be used to brighten or darken HDR images to achieve the desired visual effect.

brightness

The brightness parameter controls the overall brightness of the processed image. It is a floating-point value with a default of 0.0, and it can range from -1.0 to 1.0, allowing for both darkening and brightening of the image. Adjusting brightness can help enhance image details and improve visibility.

saturation

The saturation parameter adjusts the color saturation of the image. It is a floating-point value with a default of 0.0, ranging from -1.0 to 1.0. Increasing saturation can make colors more vivid, while decreasing it can create a more muted look.

noise_reduction

The noise_reduction parameter controls the level of noise reduction applied to the image. It is a floating-point value with a default of 0.0, ranging from 0.0 to 1.0. Noise reduction is essential for improving image quality, especially in low-light conditions.

output_colorspace

The output_colorspace parameter specifies the color space of the output image. Options include "sRGB," "Adobe RGB," and "ProPhoto RGB," with "sRGB" as the default. Choosing the appropriate color space is important for ensuring color accuracy and compatibility with other devices and software.

output_gamma

The output_gamma parameter determines the gamma correction applied to the output image. Options include "sRGB," "linear," "1.8," and "2.2," with "sRGB" as the default. Gamma correction affects the brightness and contrast of the image, and selecting the right gamma setting is crucial for achieving the desired visual effect.

RAW Image Processor (beta) Output Parameters:

image

The image output parameter provides the processed image data in a format compatible with the EasyColorCorrection system. This output is crucial for further image editing and enhancement, ensuring that the processed image maintains its quality and is ready for color correction.

metadata

The metadata output parameter contains a string representation of the image's metadata. This includes information about the processing settings and any adjustments made during the image processing. Metadata is important for understanding the context of the processed image and for maintaining a record of the processing steps applied.

RAW Image Processor (beta) Usage Tips:

• To achieve the best results, ensure that the file_path is correctly specified and points to a supported image format. This will allow the node to apply the appropriate processing techniques automatically.
• Experiment with the white_balance and tone_mapping settings to enhance the color accuracy and dynamic range of your images, especially when working with HDR content.

RAW Image Processor (beta) Common Errors and Solutions:

RAW processing not available

• Explanation: This error occurs when the necessary libraries or dependencies for processing raw images are not installed or configured correctly.
• Solution: Ensure that all required libraries, such as rawpy, are installed and properly configured in your environment. Check the documentation for any additional setup instructions.

Invalid file path

• Explanation: This error indicates that the specified file_path does not point to a valid image file or the file does not exist.
• Solution: Double-check the file path for accuracy and ensure that the file exists at the specified location. Correct any typos or path errors.