ComfyUI Node: Tonemap (Mantiuk)

Tonemap (Mantiuk):

The CV2TonemapMantiuk node is designed to apply the Mantiuk tonemapping algorithm to high dynamic range (HDR) images, making them suitable for display on standard monitors. This method is particularly effective in preserving details and enhancing the visual quality of images by adjusting the luminance and contrast. The Mantiuk algorithm is known for its ability to produce images with a high level of detail and natural appearance, making it a valuable tool for AI artists looking to enhance their HDR images. By using this node, you can achieve a balanced and visually appealing result that maintains the integrity of the original image while making it more accessible for various display devices.

Tonemap (Mantiuk) Input Parameters:

image

This parameter represents the input image that you want to apply the tonemapping to. It should be an HDR image that you wish to convert for display on standard monitors.

gamma

This parameter controls the gamma correction applied to the image. Gamma correction adjusts the luminance of the image to make it appear more natural to the human eye. The value ranges from 0.0 to 8.0, with a default value of 1.0. Lower values will darken the image, while higher values will brighten it.

scale

This parameter adjusts the overall scale of the luminance in the image. It helps in controlling the brightness and contrast of the final output. The value ranges from 0.0 to 8.0, with a default value of 1.0. Increasing the scale will make the image brighter, while decreasing it will make it darker.

saturation

This parameter controls the color saturation of the image. Saturation affects the intensity of the colors in the image. The value ranges from 0.0 to 8.0, with a default value of 1.0. Higher values will make the colors more vivid, while lower values will make them more muted.

mult

This parameter is a multiplier that adjusts the final output image's intensity. It allows you to fine-tune the overall brightness of the image after tonemapping. The value ranges from 0.0 to 8.0, with a default value of 1.0. Increasing the multiplier will make the image brighter, while decreasing it will make it darker.

Tonemap (Mantiuk) Output Parameters:

IMAGE

The output parameter is the processed image that has been tonemapped using the Mantiuk algorithm. This image is suitable for display on standard monitors and retains the details and natural appearance of the original HDR image. The output is a tensor that can be used in further image processing or directly displayed.

Tonemap (Mantiuk) Usage Tips:

• Adjust the gamma parameter to correct the luminance of your image for a more natural look. Start with the default value and make small adjustments to see the effect.
• Use the scale parameter to control the overall brightness and contrast of the image. This can help in achieving the desired visual effect.
• Experiment with the saturation parameter to enhance or mute the colors in your image. This is particularly useful for artistic effects.
• Fine-tune the mult parameter to adjust the final brightness of the image after tonemapping. This can help in achieving the perfect balance for your display device.

Tonemap (Mantiuk) Common Errors and Solutions:

ColorMod: Ignoring node ' Tonemap (Mantiuk)' due to cv2 edition/version

• Explanation: This error occurs when the version of OpenCV installed does not support the Mantiuk tonemapping algorithm.
• Solution: Ensure that you have a compatible version of OpenCV installed. You may need to upgrade or downgrade your OpenCV version to one that includes the createTonemapMantiuk function.

TypeError: 'NoneType' object is not callable

• Explanation: This error occurs when the tonemap_op attribute is not properly initialized, likely due to an unsupported OpenCV version.
• Solution: Verify that the createTonemapMantiuk function is available in your OpenCV installation. If not, install a version of OpenCV that includes this function.

ValueError: Input image must be an HDR image

• Explanation: This error occurs when the input image is not in the correct HDR format required for tonemapping.
• Solution: Ensure that your input image is an HDR image. Convert your image to the appropriate HDR format if necessary before using this node.