ComfyUI Node: Nuke Levels

Nuke Levels:

The NukeLevels node is designed to adjust the input and output levels of an image, similar to the ColorLookup node in Nuke. This node allows you to fine-tune the tonal range and contrast of your images by manipulating the black and white points, as well as the gamma. By adjusting these parameters, you can enhance the visual quality of your images, making them more vibrant or subdued according to your artistic vision. The NukeLevels node is particularly useful for achieving precise control over the brightness and contrast of your images, ensuring that the final output aligns with your creative goals.

Nuke Levels Input Parameters:

image

This parameter represents the input image that you want to adjust. It is the starting point for the levels adjustment process.

input_black

This parameter sets the black point for the input image. It determines the darkest point in the image that will be mapped to black in the output. The value ranges from 0.0 to 1.0, with a default of 0.0. Lowering this value can increase the contrast by making more of the image appear darker.

input_white

This parameter sets the white point for the input image. It determines the brightest point in the image that will be mapped to white in the output. The value ranges from 0.0 to 1.0, with a default of 1.0. Raising this value can increase the contrast by making more of the image appear brighter.

gamma

This parameter adjusts the midtones of the image. It affects the overall brightness without altering the black and white points. The value ranges from 0.1 to 3.0, with a default of 1.0. A value less than 1.0 will darken the midtones, while a value greater than 1.0 will lighten them.

output_black

This parameter sets the black point for the output image. It determines the darkest point in the output image. The value ranges from 0.0 to 1.0, with a default of 0.0. Adjusting this can help in achieving the desired level of darkness in the final image.

output_white

This parameter sets the white point for the output image. It determines the brightest point in the output image. The value ranges from 0.0 to 1.0, with a default of 1.0. Adjusting this can help in achieving the desired level of brightness in the final image.

mix

This parameter controls the blend between the original image and the adjusted image. The value ranges from 0.0 to 1.0, with a default of 1.0. A value of 0.0 will result in the original image, while a value of 1.0 will result in the fully adjusted image.

Nuke Levels Output Parameters:

IMAGE

The output is an adjusted image where the input levels have been modified according to the specified parameters. This output reflects the changes in tonal range and contrast, providing a visually enhanced version of the original image.

Nuke Levels Usage Tips:

• To achieve a high-contrast image, decrease the input_black value and increase the input_white value.
• Use the gamma parameter to fine-tune the brightness of midtones without affecting the overall contrast.
• Experiment with the mix parameter to blend the original and adjusted images, allowing for subtle enhancements.

Nuke Levels Common Errors and Solutions:

"Division by zero in input range"

• Explanation: This error occurs when the input_black and input_white values are set too close to each other, resulting in a zero or near-zero range.
• Solution: Ensure that there is a sufficient difference between input_black and input_white to avoid a zero range. Adjust these values to maintain a minimum difference.

"Gamma value out of range"

• Explanation: This error happens when the gamma value is set outside the allowed range of 0.1 to 3.0.
• Solution: Adjust the gamma value to be within the specified range to ensure proper midtone adjustment.