SSParallaxX - 3D Parallax Animation for ComfyUI

Transform any 2D image into stunning parallax animations with depth-based motion!

🎬 Create Stunning Parallax Animations with Depth-Based Motion!

With our advanced depth estimation and integrated video processing tools, creating parallax animations is now easier than ever! Simply:

1. Use the 👀 SS Image Uploader to load your image

2. Process it through the 👀 3D Parallax Animation node to generate frames with depth-based motion

3. Combine the frames into a video or GIF with the 👀 SS Images to Video Combiner

No external depth maps or separate video processing tools needed - everything is handled automatically in one seamless workflow!

Welcome to the SSParallaxX repository for ComfyUI! 🚀 Create stunning parallax animations that bring your images to life with realistic 3D motion! This powerful depth-estimation node transforms ordinary 2D images into immersive animations where objects move based on their depth in the scene. Perfect for creating eye-catching content that leaps off the screen with realistic depth!

Introduction

The SSParallaxX node is a cutting-edge 2D-to-3D animation tool designed for ComfyUI to generate professional-quality parallax animations with built-in depth map generation. Powered by advanced AI depth estimation, it automatically creates high-quality depth maps from your images, eliminating the need for external depth sources. This tool creates immersive animations where objects appear to move in 3D space based on their depth in the scene, creating a stunning visual effect that brings your images to life!

Available Nodes

This repository provides powerful parallax animation and video handling nodes for creating stunning 3D motion effects:

Core Animation Node

• 👀 3D Parallax Animation by SamSeen: Our flagship AI-powered depth estimation node that creates stunning parallax animations. Just feed it your standard 2D images and watch as it automatically creates immersive animations with realistic depth perception.

Video Processing Nodes

• 👀 SS Image Uploader by SamSeen: A simple yet powerful tool for loading and resizing single images with customizable dimensions, perfect for creating consistent 3D content from various image sources.

• 👀 SS Images to Video Combiner by SamSeen: Combine your processed image sequences back into stunning videos or GIFs with support for multiple formats (MP4, WebM, GIF) and audio integration for complete immersive experiences.

Installation

To install this parallax animation extension for ComfyUI, clone the repository and add it to the custom_nodes folder in your ComfyUI installation directory:

cd ComfyUI/custom_nodes
git clone https://github.com/SamSeen/SSParallaxX.git
cd SSParallaxX
pip install -r requirements.txt

After installation, restart ComfyUI or reload the web interface to see the new nodes in the node browser under the "👀 SamSeen" category.

Detailed Functionality

👀 3D Parallax Animation by SamSeen

This node uses advanced depth estimation to automatically generate depth maps from your images, then creates parallax animations where objects move based on their depth:

Input Parameters:

• base_image: The input image to animate

• num_frames: Number of frames to generate (default: 20)

• horizontal_shift: Maximum horizontal pixel shift (default: 30.0)

• vertical_shift: Maximum vertical pixel shift (default: 10.0)

• blur_radius: Smooths the depth map for more natural results (default: 3)

• invert_depth: Swaps foreground/background if needed (default: false)

• clockwise: Direction of the elliptical motion (default: true)

• loop_type: Choose between "Forward" or "Bounce" animation styles

• external_depth_map: Optional custom depth map for precise control

Outputs:

• frames: The generated animation frames as an image sequence

• depth_map: The generated depth map for further processing or analysis

👀 SS Image Uploader

This node loads and resizes a single image:

Input Parameters:

• image: Select an image file to upload

• max_width: Maximum width for resizing (default: 512)

• max_height: Maximum height for resizing (0 = auto)

Outputs:

• image: The loaded and resized image

👀 SS Images to Video Combiner

This node combines a sequence of images into a video or GIF:

Input Parameters:

• images: The input image sequence to combine

• frame_rate: Frames per second for the output video (default: 30)

• filename_prefix: Prefix for the output filename

• format: Output format (mp4, webm, gif)

• save_output: Whether to save the output to the output directory

• audio: Optional audio to add to the video

Outputs:

• video_path: Path to the generated video file

AI Depth Estimation

The 3D Parallax Animation node uses advanced AI models for depth estimation. The depth map is used to determine how much each pixel should move in the parallax animation, with closer objects (lighter in the depth map) moving more than farther objects (darker in the depth map).

The depth estimation model will be downloaded automatically when you first use the node. This requires an internet connection during the initial run.

Manual Depth Model Installation

If the automatic depth map extraction model download fails, you can manually install the depth estimation model:

1. Visit the model card on Hugging Face

2. Download the model files

3. Place them in the appropriate directory

4. Restart ComfyUI or reload the web interface

Dependencies

This extension requires the following Python packages:

torch>=2.0.0          # Neural network processing
pillow                # Image processing
numpy                 # Numerical processing
opencv-python         # Computer vision
tqdm                  # Progress tracking

Optimizing Your Parallax Animation

To achieve professional-quality parallax animations with realistic depth effects:

1. Horizontal and Vertical Shift: Adjust the horizontal_shift and vertical_shift parameters to control the intensity of the parallax effect. The default values (30 horizontal, 10 vertical) create a nice elliptical motion, but you can experiment with different ratios.

2. Blur Radius Optimization: Adjust the blur_radius to smooth depth transitions. Higher values create softer depth boundaries, while lower values maintain sharper depth edges.

3. Depth Inversion: If your scene looks "inside out" (background appears to move more than foreground), toggle the invert_depth option to correct the parallax effect.

4. Frame Count: Increase the num_frames parameter for smoother animations, especially when using the "Bounce" loop type.

5. Direction and Loop Type: Experiment with clockwise/counter-clockwise motion and Forward/Bounce loop types to find the most appealing effect for your specific image.

Transform Your Images with Parallax Animation

With our advanced AI-powered depth map extraction technology, creating professional-quality parallax animations has never been more accessible:

• 🎬 Stunning Animations: Transform static images into dynamic parallax animations with realistic 3D motion

• 🔄 Customizable Effects: Fine-tune the parallax effect with adjustable horizontal and vertical shift, clockwise or counter-clockwise motion, and different loop types

• 🎮 Content Enhancement: Create eye-catching animations for social media, presentations, websites, and more

• 🖼️ Depth Visualization: Use the depth map output to visualize and understand the 3D structure of your images

• 📱 Cross-Platform Compatibility: Create animations in various formats (GIF, MP4, WebM) for use across different platforms

Example Workflow

Our integrated processing tools make creating parallax animations simple and efficient:

1. Image Input: Use the 👀 SS Image Uploader to load your image with customizable resolution

2. Parallax Processing: Process the image with the 👀 3D Parallax Animation node to generate frames with depth-based motion

3. Video Output: Combine the frames into a video or GIF with the 👀 SS Images to Video Combiner

Examples

Examples of parallax animations created with the SSParallaxX node

Troubleshooting

If you encounter any issues with the parallax animation:

1. Depth Map Quality: If the depth map doesn't accurately represent the scene's depth, try adjusting the blur_radius parameter or providing a custom depth map.

2. Motion Intensity: If the motion is too strong or weak, adjust the horizontal_shift and vertical_shift parameters to find the optimal effect.

3. Inverted Depth Perception: If foreground and background appear swapped, toggle the invert_depth option to correct the parallax effect.

4. Model Download Issues: If the depth model fails to download automatically, follow the manual installation instructions in the documentation.

5. Memory Limitations: For processing large images, consider reducing the input resolution to avoid memory constraints.

Contributing

We welcome contributions to enhance the SSParallaxX nodes! To contribute:

1. Fork the repository

2. Create a feature branch

3. Implement your changes

4. Submit a pull request

Please ensure your code follows our style guidelines and includes appropriate tests.

License and Attribution

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Thanks to the ComfyUI team for creating an amazing platform for AI image processing

• Special thanks to the creators of the depth estimation models that power this node