ComfyUI Node: Film Grain FX (CRT)

Film Grain FX (CRT):

FilmGrainFX is a powerful node designed to simulate the classic film grain effect on digital images, adding a layer of texture and depth that mimics the aesthetic of traditional film photography. This node is particularly beneficial for artists looking to infuse their digital creations with a vintage or cinematic feel, enhancing the visual storytelling of their work. By applying a controlled amount of noise to an image, FilmGrainFX can create a sense of realism and warmth that is often associated with analog film. The node offers a range of customizable parameters, allowing you to fine-tune the grain's appearance, size, intensity, and color, ensuring that the effect complements the original image while preserving its essential qualities. Whether you're aiming for a subtle enhancement or a pronounced grainy texture, FilmGrainFX provides the flexibility to achieve your desired artistic vision.

Film Grain FX (CRT) Input Parameters:

image

This parameter represents the input image to which the film grain effect will be applied. It is essential as it serves as the base for the grain effect, and the quality and characteristics of the input image will influence the final output.

grain_amount

This parameter controls the overall strength of the grain effect applied to the image. It ranges from 0.0 to 1.0, with a default value of 0.333. A higher value results in a more pronounced grain effect, while a lower value yields a subtler texture.

grain_size

Grain size determines the scale of the grain particles. It ranges from 0.5 to 8.0, with a default value of 1.5. Smaller values produce finer grain, while larger values create coarser grain, affecting the visual texture of the image.

grain_intensity

This parameter adjusts the contrast of the grain effect, ranging from 0.0 to 1.0, with a default of 0.65. Higher intensity values result in more distinct and visible grain, enhancing the texture's prominence.

grain_density

Grain density influences the distribution of grain across the image, with a range from 0.0 to 11.0 and a default of 10.0. Lower values create sparse grain, while higher values lead to a denser grain pattern.

grain_color

This parameter controls the color blending of the grain effect, ranging from 0.0 to 1.0, with a default of 1.0. A value of 1.0 maintains the original color of the grain, while lower values blend the grain towards a monochrome appearance.

intensity_shadows

This parameter adjusts the grain intensity specifically in shadow areas, ranging from 0.0 to 1.0, with a default of 1.0. It allows for nuanced control over how grain appears in darker regions of the image.

intensity_highlights

This parameter modifies the grain intensity in highlight areas, also ranging from 0.0 to 1.0, with a default of 1.0. It provides control over the grain's visibility in brighter parts of the image.

negative_noise_in_highlights

A boolean parameter that, when enabled, applies negative noise in highlight areas, creating a unique visual effect. The default setting is False, meaning this effect is not applied unless explicitly activated.

preserve_original_color

This boolean parameter determines whether the original color of the image is preserved after applying the grain effect. The default is True, ensuring that the grain does not alter the image's color balance unless desired.

seed

The seed parameter is an integer used to initialize the random number generator for the grain effect, ensuring reproducibility. It ranges from 0 to 0xFFFFFFFFFFFFFFFF, with a default of 0, allowing for consistent results across different runs.

Film Grain FX (CRT) Output Parameters:

IMAGE

The output is the processed image with the film grain effect applied. This output retains the original image's dimensions and color profile, with the added texture of the grain effect enhancing its visual appeal. The grain effect is integrated seamlessly, providing a natural and artistic enhancement to the image.

Film Grain FX (CRT) Usage Tips:

• Experiment with different grain_amount and grain_size settings to achieve the desired level of texture and detail in your image.
• Use grain_intensity and grain_density to fine-tune the contrast and distribution of the grain, ensuring it complements the image's overall aesthetic.
• Adjust intensity_shadows and intensity_highlights to control how the grain appears in different lighting conditions within the image, allowing for a more dynamic and realistic effect.
• Consider enabling negative_noise_in_highlights for creative effects, especially in high-contrast images, to add a unique twist to the grain pattern.

Film Grain FX (CRT) Common Errors and Solutions:

Image tensor shape mismatch

• Explanation: This error occurs when the input image tensor does not have the expected shape, which should be in the format of (batch_size, height, width, channels).
• Solution: Ensure that your input image tensor is correctly formatted and matches the expected dimensions before applying the FilmGrainFX node.

Invalid parameter value

• Explanation: This error arises when a parameter is set outside its allowed range, such as a negative grain_size or a grain_amount greater than 1.0.
• Solution: Double-check all parameter values to ensure they fall within the specified ranges and adjust them accordingly.

Seed value out of range

• Explanation: This error occurs if the seed value is set outside the permissible range of 0 to 0xFFFFFFFFFFFFFFFF.
• Solution: Verify that the seed value is within the valid range and adjust it if necessary to avoid this error.