ComfyUI Node: Tonemap

Tonemap:

The Tonemap node is designed to convert high dynamic range (HDR) images into a more visually appealing format by applying a tonemapping process. This process helps in compressing the range of luminance values in an image, making it suitable for display on standard dynamic range (SDR) devices. The node allows you to adjust the tonemap scale, which controls the intensity of the tonemapping effect, and provides options to specify the input and output color spaces. By using this node, you can enhance the visual quality of your images, ensuring that details in both the shadows and highlights are preserved and displayed correctly.

Tonemap Input Parameters:

images

This parameter accepts the image(s) that you want to apply the tonemapping process to. The input should be in the form of an image tensor.

input_mode

This parameter specifies the color space of the input image. You can choose between linear and sRGB. If your image is in the sRGB color space, the node will convert it to linear space before applying the tonemapping process. This ensures that the tonemapping is applied correctly.

output_mode

This parameter specifies the color space of the output image. You can choose between sRGB and linear. After the tonemapping process, the node will convert the image back to the specified color space. This allows you to control the final appearance of the image based on your display requirements.

tonemap_scale

This parameter controls the intensity of the tonemapping effect. It is a floating-point value with a default of 1, a minimum of 0.1, and a maximum of 10. Adjusting this value allows you to fine-tune the tonemapping process to achieve the desired visual effect. A higher value will result in a stronger tonemapping effect, while a lower value will produce a more subtle effect.

Tonemap Output Parameters:

IMAGE

The output of the Tonemap node is the tonemapped image. This image has been processed to compress the dynamic range, making it suitable for display on standard dynamic range (SDR) devices. The output image will be in the color space specified by the output_mode parameter.

Tonemap Usage Tips:

• To achieve a natural-looking tonemapped image, start with the default tonemap_scale value of 1 and adjust incrementally.
• If your input image is in sRGB color space, ensure that you set the input_mode to sRGB for accurate tonemapping.
• Use the output_mode parameter to match the color space of your output image with the requirements of your display device or further processing pipeline.

Tonemap Common Errors and Solutions:

Image tensor is not in the correct format

• Explanation: The input image tensor must be in a specific format for the tonemapping process to work correctly.
• Solution: Ensure that your input image tensor is properly formatted and contains valid image data.

Invalid value for tonemap_scale

• Explanation: The tonemap_scale parameter must be a floating-point value within the specified range (0.1 to 10).
• Solution: Check the value of the tonemap_scale parameter and ensure it is within the valid range. Adjust the value if necessary.

Unsupported input_mode or output_mode

• Explanation: The input_mode and output_mode parameters must be set to either linear or sRGB.
• Solution: Verify that the values for input_mode and output_mode are correctly set to one of the supported options.