ComfyUI Node: ParallaxZoom

ParallaxZoom:

The ParallaxZoom node is designed to create a 3D video effect by applying a 3D depth parallax to an input image. This effect is achieved by manipulating the foreground and background layers of the image independently, allowing for a dynamic zoom and pan effect that simulates depth. The node is particularly useful for generating engaging and visually appealing animations from static images, enhancing the perception of depth and movement. By adjusting parameters such as zoom factors and pan direction, you can control the intensity and direction of the parallax effect, making it a versatile tool for AI artists looking to add a 3D touch to their creations.

ParallaxZoom Input Parameters:

masks

This parameter expects an image that serves as a mask to distinguish between the foreground and background layers. The mask helps in applying different zoom and pan effects to these layers, enhancing the 3D effect.

image_slices

This parameter takes an image that is divided into slices, which are used to create the parallax effect. The slices allow for more granular control over the zoom and pan effects applied to different parts of the image.

foreground_zoom_factor

This parameter controls the amount of zoom applied to the foreground layer of the image. The default value is 1.1, with a step size of 0.001. Adjusting this value will increase or decrease the zoom effect on the foreground, making it appear closer or further away. The minimum value is not specified, but it should be greater than 0 to avoid inversion.

background_zoom_factor

This parameter controls the amount of zoom applied to the background layer of the image. The default value is 1.05, with a step size of 0.001. Adjusting this value will increase or decrease the zoom effect on the background, making it appear closer or further away. The minimum value is not specified, but it should be greater than 0 to avoid inversion.

pan_left

This parameter controls the amount of horizontal shift applied to the image. The default value is 0.1, with a range from -1.0 to 1.0 and a step size of 0.001. Adjusting this value will move the image left or right, adding to the parallax effect.

n_frames

This parameter specifies the number of frames to generate for the animation. The default value is 25. Increasing this value will result in a longer animation, while decreasing it will shorten the animation.

loop

This boolean parameter determines whether the animation should loop. The default value is False. When set to True, the animation will create a seamless loop, making it ideal for continuous playback.

ParallaxZoom Output Parameters:

frames

This output parameter provides the generated frames of the 3D video effect. Each frame is an image that represents a step in the animation, showing the dynamic zoom and pan effects applied to the input image.

masks

This output parameter provides the masks used in the animation. These masks help in distinguishing between the foreground and background layers, ensuring that the zoom and pan effects are applied correctly.

ParallaxZoom Usage Tips:

• Experiment with different foreground and background zoom factors to achieve the desired depth effect. Higher values will create a more pronounced 3D effect.
• Use the pan_left parameter to add horizontal movement to your animation, enhancing the parallax effect.
• Adjust the n_frames parameter to control the length of your animation. More frames will result in a smoother and longer animation.
• Enable the loop parameter for seamless looping animations, perfect for creating GIFs or continuous video loops.

ParallaxZoom Common Errors and Solutions:

"Invalid mask image"

• Explanation: The provided mask image is not in the correct format or is missing.
• Solution: Ensure that the mask image is correctly formatted and provided as an input.

"Invalid zoom factor"

• Explanation: The zoom factor provided is not within the acceptable range.
• Solution: Check the zoom factor values and ensure they are greater than 0 to avoid inversion.

"Invalid number of frames"

• Explanation: The number of frames specified is not a positive integer.
• Solution: Ensure that the n_frames parameter is set to a positive integer value.

"Image slices not provided"

• Explanation: The image slices input is missing or incorrectly formatted.
• Solution: Provide a correctly formatted image slices input to ensure the parallax effect can be applied.