SSParallaxX - 3D Parallax Animation for ComfyUI
详情
下载文件
关于此版本
模型描述
SSParallaxX - ComfyUI 的 3D 视差动画
将任何 2D 图像转化为惊艳的基于深度的视差动画!
🎬 使用基于深度的运动创建惊艳的视差动画!
借助我们先进的深度估计算法和集成的视频处理工具,创建视差动画比以往任何时候都更简单!只需:
使用 👀 SS 图像上传器 加载您的图像
通过 👀 3D 视差动画 节点处理,生成带有深度运动的帧
使用 👀 SS 图像转视频组合器 将帧组合成视频或 GIF
无需外部深度图或独立视频处理工具——所有步骤都在一个无缝工作流中自动完成!
欢迎来到 ComfyUI 的 SSParallaxX 仓库!🚀 创建惊艳的视差动画,为您的图像注入真实的 3D 运动效果!这个强大的深度估计算法节点可将普通 2D 图像转化为沉浸式动画,其中物体根据其在场景中的深度进行移动。非常适合打造令人眼前一亮、仿佛跃出屏幕的逼真深度内容!
简介
SSParallaxX 节点是一款专为 ComfyUI 设计的前沿 2D 转 3D 动画工具,内置深度图生成功能,可生成专业级视差动画。借助先进的 AI 深度估计算法,它能自动从您的图像中创建高质量深度图,无需依赖外部深度源。该工具可生成沉浸式动画,使物体根据其在场景中的深度在 3D 空间中移动,营造出令人惊叹的视觉效果,赋予您的图像生命!
可用节点
本仓库提供强大的视差动画与视频处理节点,用于创建惊艳的 3D 运动效果:
核心动画节点
- 👀 SamSeen 的 3D 视差动画:我们的旗舰 AI 驱动深度估计算法节点,可创建惊艳的视差动画。只需输入标准 2D 图像,它将自动为您生成具有真实深度感知的沉浸式动画。
视频处理节点
👀 SamSeen 的 SS 图像上传器:一款简单而强大的工具,用于加载和调整单张图像尺寸,支持自定义分辨率,非常适合从多种图像源创建一致的 3D 内容。
👀 SamSeen 的 SS 图像转视频组合器:将处理后的图像序列重新组合为惊艳的视频或 GIF,支持多种格式(MP4、WebM、GIF)并可集成音频,打造完整的沉浸式体验。
安装
要为 ComfyUI 安装此视差动画扩展,请克隆仓库并将其添加至 ComfyUI 安装目录下的 custom_nodes 文件夹中:
cd ComfyUI/custom_nodes
git clone https://github.com/SamSeen/SSParallaxX.git
cd SSParallaxX
pip install -r requirements.txt
安装完成后,重启 ComfyUI 或重新加载网页界面,即可在节点浏览器的 “👀 SamSeen” 分类下看到新节点。
详细功能
👀 SamSeen 的 3D 视差动画
此节点利用高级深度估计算法,自动从图像中生成深度图,并创建基于深度的视差动画:
输入参数:
- base_image:待动画化的输入图像
- num_frames:生成帧数(默认:20)
- horizontal_shift:最大水平像素位移(默认:30.0)
- vertical_shift:最大垂直像素位移(默认:10.0)
- blur_radius:平滑深度图以获得更自然效果(默认:3)
- invert_depth:如需交换前景/背景(默认:false)
- clockwise:椭圆运动方向(默认:true)
- loop_type:选择“Forward”(前向)或“Bounce”(反弹)动画样式
- external_depth_map:可选的自定义深度图,用于精确控制
输出:
- frames:生成的动画帧序列
- depth_map:生成的深度图,可用于后续处理或分析
👀 SS 图像上传器
此节点加载并调整单张图像尺寸:
输入参数:
- image:选择要上传的图像文件
- max_width:调整尺寸的最大宽度(默认:512)
- max_height:调整尺寸的最大高度(0 = 自动)
输出:
- image:加载并调整尺寸后的图像
👀 SS 图像转视频组合器
此节点将图像序列合成为视频或 GIF:
输入参数:
- images:待合并的输入图像序列
- frame_rate:输出视频的每秒帧数(默认:30)
- filename_prefix:输出文件名前缀
- format:输出格式(mp4、webm、gif)
- save_output:是否将输出保存至输出目录
- audio:可选的音频文件,添加至视频中
输出:
- video_path:生成的视频文件路径
AI 深度估计算法
3D 视差动画节点采用先进的 AI 模型进行深度估计。深度图用于确定每个像素在视差动画中的移动量:深度图中较亮的区域(近景)移动幅度更大,较暗的区域(远景)移动幅度更小。
首次使用该节点时,深度模型将自动下载。初次运行需要互联网连接。
手动安装深度模型
如自动下载深度图模型失败,可手动安装深度估计算法模型:
- 访问 Hugging Face 上的模型卡片
- 下载模型文件
- 将其放置于指定目录
- 重启 ComfyUI 或重新加载网页界面
依赖项
此扩展需要以下 Python 包:
torch>=2.0.0 # 神经网络处理
pillow # 图像处理
numpy # 数值计算
opencv-python # 计算机视觉
tqdm # 进度跟踪
优化您的视差动画
为实现专业级、逼真的深度视差动画效果,请参考以下建议:
- 水平与垂直位移:调整
horizontal_shift和vertical_shift参数以控制视差效果强度。默认值(水平30、垂直10)可产生优美的椭圆运动,您可尝试不同比例以获得理想效果。 - 模糊半径优化:调节
blur_radius以平滑深度过渡。较高值产生柔和的深度边界,较低值保留锐利的深度边缘。 - 深度反转:如场景呈现“内外翻转”(背景移动幅度大于前景),请切换
invert_depth选项以纠正视差效果。 - 帧数设置:增加
num_frames参数以获得更流畅的动画,尤其在使用“Bounce”循环类型时。 - 方向与循环类型:尝试顺时针/逆时针运动及“Forward”/“Bounce”循环类型,找到最适合您图像的视觉效果。
用视差动画重塑您的图像
借助我们先进的 AI 驱动深度图提取技术,创建专业级视差动画从未如此简单:
- 🎬 惊艳动画:将静态图像转化为具有真实 3D 运动的动态视差动画
- 🔄 可定制效果:通过可调的水平/垂直位移、顺时针/逆时针运动及多种循环类型微调视差效果
- 🎮 内容增强:为社交媒体、演示文稿、网站等创建引人注目的动画
- 🖼️ 深度可视化:利用深度图输出直观理解图像的 3D 结构
- 📱 跨平台兼容:生成多种格式(GIF、MP4、WebM)动画,适配不同平台使用
示例工作流
我们的集成处理工具使创建视差动画变得简单高效:
- 图像输入:使用 👀 SS 图像上传器,以自定义分辨率加载您的图像
- 视差处理:通过 👀 3D 视差动画节点处理图像,生成基于深度运动的帧序列
- 视频输出:使用 👀 SS 图像转视频组合器,将帧合并为视频或 GIF
示例
使用 SSParallaxX 节点创建的视差动画示例
故障排除
如遇到视差动画相关问题,请尝试以下方法:
- 深度图质量:如深度图未能准确反映场景深度,请尝试调整
blur_radius参数,或提供自定义深度图。 - 运动强度:如运动过强或过弱,请调整
horizontal_shift和vertical_shift参数以获得最佳效果。 - 深度颠倒:如前景与背景相互颠倒,请切换
invert_depth选项以纠正视差效果。 - 模型下载失败:如深度模型未能自动下载,请参考文档中的手动安装说明。
- 内存限制:处理大图像时,建议降低输入分辨率以避免内存不足问题。
贡献
我们欢迎您为 SSParallaxX 节点做出贡献!要参与贡献:
- 分叉本仓库
- 创建功能分支
- 实现您的更改
- 提交拉取请求
请确保您的代码遵循我们的风格规范,并包含适当的测试。
许可与归属
本项目采用 MIT 许可证——详情请参见 LICENSE 文件。
致谢
- 感谢 ComfyUI 团队打造了如此出色的 AI 图像处理平台
- 特别感谢为本节点提供支持的深度估计算法模型的创作者



