ComfyUI Node: ◎ Apply Grade Info

◎ Apply Grade Info:

RadianceApplyGradeInfo is a specialized node designed to apply color grading adjustments to images using a JSON string that encapsulates grading parameters. This node is particularly useful for artists and designers who want to replicate specific color grading effects consistently across multiple images. By utilizing a grade_info JSON string, which contains detailed grading parameters such as lift, gamma, gain, offset, contrast, pivot, and saturation, this node allows for precise and repeatable color adjustments. The node's primary function is to interpret these parameters and apply them to an image, enabling users to achieve desired visual effects with ease. This capability is especially beneficial for maintaining a consistent look and feel across a series of images or projects.

◎ Apply Grade Info Input Parameters:

image

The image parameter is a tensor representing the image to which the grading will be applied. It is crucial that the image is in the correct format, typically a batch of images with at least three color channels. If the image has only one channel, it will be automatically expanded to three channels to ensure compatibility with the grading process. This parameter is essential as it serves as the canvas for the color grading adjustments.

grade_info

The grade_info parameter is a JSON string that contains the color grading settings to be applied to the image. This JSON includes various parameters such as lift, gamma, gain, offset, contrast, pivot, and saturation, each of which influences the final appearance of the image. The JSON string must be correctly formatted, as any errors in the JSON structure will prevent the node from applying the grading.

strength

The strength parameter is a float value that determines the intensity of the applied grading effect. It ranges from 0.0 to 1.0, where 0.0 means no grading is applied, and 1.0 means the full effect of the grading is applied. This parameter allows users to blend the original image with the graded version, providing flexibility in achieving the desired visual outcome. The default value is 1.0, indicating full application of the grading.

◎ Apply Grade Info Output Parameters:

image

The image output is the tensor of the image after the grading has been applied. This output reflects the visual changes made according to the grade_info parameters, allowing users to see the effects of their adjustments. The graded image can be used for further processing or as a final output for display or publication.

grade_info

The grade_info output is the same JSON string that was input into the node. This output serves as a confirmation of the grading parameters used and can be reused or modified for subsequent grading tasks. It ensures that users have a record of the exact settings applied to the image.

◎ Apply Grade Info Usage Tips:

• Ensure that the grade_info JSON string is correctly formatted to avoid errors during processing.
• Use the strength parameter to fine-tune the intensity of the grading effect, allowing for subtle adjustments or full application as needed.
• Consider saving the grade_info JSON for future use, enabling consistent application of grading across different projects or images.

◎ Apply Grade Info Common Errors and Solutions:

Invalid JSON: <error_message>

• Explanation: This error occurs when the grade_info JSON string is not properly formatted or contains syntax errors.
• Solution: Verify the JSON structure for any missing brackets, commas, or incorrect syntax. Use a JSON validator tool to ensure the JSON is correctly formatted before inputting it into the node.

Image shape mismatch

• Explanation: This error arises when the input image does not have the required number of color channels.
• Solution: Ensure that the input image has at least three color channels. If the image is grayscale, it should be expanded to three channels before processing.