ComfyUI Node: Film Gate Weave

Film Gate Weave:

The FilmGateWeave node is designed to apply a dynamic weave effect to a batch of images, simulating the visual characteristics of film passing through a gate. This effect is achieved by introducing sinusoidal distortions to the image frames, creating a unique visual texture reminiscent of traditional film projection. The node allows for both preset and custom configurations, enabling you to tailor the effect to your artistic vision. By manipulating parameters such as amplitude, frequency, and phase shift, you can control the intensity and style of the weave effect, making it suitable for a wide range of creative applications. This node is particularly beneficial for artists looking to add a vintage or cinematic feel to their digital artwork, enhancing the visual storytelling with a touch of analog charm.

Film Gate Weave Input Parameters:

images

This parameter accepts a batch of images that you want to apply the weave effect to. The images should be in a format compatible with the node, typically as a tensor, and will be processed frame by frame to achieve the desired effect.

weave_preset

The weave_preset parameter allows you to select from predefined settings for the weave effect, including options like "none," "subtle," "moderate," "heavy," and "custom." These presets adjust the intensity and style of the effect, with "subtle" providing a gentle weave and "heavy" offering a more pronounced distortion. The default value is "subtle."

custom_expression

This parameter is used when the weave_preset is set to "custom." It allows you to define a mathematical expression that dictates the weave pattern, providing full control over the effect's behavior. The default expression is sin(t * 0.1) * 5, which can be modified to achieve different visual results.

amplitude_x

amplitude_x controls the horizontal displacement of the weave effect. It determines how far the image is shifted along the x-axis, with a default value of 3.0. The range is from 0.0 to 20.0, allowing for subtle to dramatic horizontal movements.

amplitude_y

Similar to amplitude_x, amplitude_y affects the vertical displacement of the weave effect. It controls the shift along the y-axis, with a default value of 1.0 and a range from 0.0 to 20.0. Adjusting this parameter changes the vertical intensity of the weave.

frequency

The frequency parameter sets the rate at which the weave pattern oscillates. A higher frequency results in more rapid changes in the weave effect, while a lower frequency produces a slower, more gradual effect. The default value is 1.0, with a range from 0.1 to 5.0.

phase_shift

phase_shift adjusts the starting point of the weave pattern's oscillation. By changing this value, you can offset the weave effect, creating variations in the visual output. The default is 0.0, with a range from 0.0 to 2π, allowing for a full cycle of phase adjustment.

Film Gate Weave Output Parameters:

IMAGE

The output of the FilmGateWeave node is a batch of images with the weave effect applied. This output retains the original image dimensions and format but includes the dynamic distortions introduced by the weave effect. The processed images can be used directly in your projects, adding a unique visual texture that enhances the overall aesthetic.

Film Gate Weave Usage Tips:

• Experiment with different weave_preset options to quickly achieve various artistic effects without manually adjusting each parameter.
• Use the custom_expression parameter to create unique and complex weave patterns that can add a personalized touch to your artwork.
• Adjust amplitude_x and amplitude_y to control the intensity of the weave effect, balancing between subtlety and dramatic distortion based on your creative needs.

Film Gate Weave Common Errors and Solutions:

"Invalid image format"

• Explanation: The input images are not in a compatible format for processing.
• Solution: Ensure that the images are provided as a tensor and are correctly formatted before inputting them into the node.

"Expression evaluation error"

• Explanation: There is an error in the custom expression syntax or logic.
• Solution: Double-check the custom expression for syntax errors or logical issues, and ensure it is a valid mathematical expression.

"Parameter out of range"

• Explanation: One or more parameters are set outside their allowed range.
• Solution: Verify that all parameters are within their specified ranges and adjust them accordingly.