ComfyStereo - ComfyUI Stereoscopic nodes
详情
下载文件
关于此版本
模型描述
ComfyStereo
来自:https://github.com/Dobidop/ComfyStereo 欢迎提供反馈和帮助
简介
- 立体图像节点 – 基于 Automatic1111 立体脚本 的移植版本,新增了边缘感知和方向感知的深度图模糊功能。节点支持左右、交叉式和红蓝立体模式。
- DeoVR 观看节点 – 用于在 DeoVR 中启动和查看图像与视频的节点。
DeoVR 观看节点设置
在 DeoVR 的开发者设置中,将“启用远程控制”设为 true。
要通过此节点启动 DeoVR,必须在配置文件中设置 DeoVR.exe 的路径:
ComfyUI\custom_nodes\comfystereo\config.json
默认路径:
"C:\\Program Files (x86)\\Steam\\steamapps\\common\\DeoVR Video Player\\DeoVR.exe"
重要说明:
- 在使用此节点更改头显中显示内容之前,您必须已在 DeoVR 中打开一张图像或视频。
- 如果 DeoVR 正处于主菜单界面,此功能将无法工作。
- 启动器会自动跳过主菜单界面,但如果您手动启动 DeoVR,则需先打开一张图像/视频,再使用此节点。
---
新功能与深度图模糊
新增功能包括深度图的边缘感知和方向感知模糊、额外的插值方法以及立体畸变改进。
深度图模糊:
- 在最终立体图像中减少瑕疵与剧烈过渡,尤其在较高发散设置下效果明显。
- 权衡:它会增加计算时间(5-25%)。若注重速度,可考虑关闭此功能。
- depth_map_threshhold 设置深度图梯度锐度的阈值。较低值会使模糊作用于更平缓的梯度,从而更广泛地模糊深度图(可能对最终结果产生负面影响);较高值则仅作用于陡峭梯度。
如何启用自适应模糊
- 将 'depth_map_blur' 设为 True。
掩码输出说明
- 掩码输出不完美,主要用于**“不填充”** 和 “不完美填充” 选项。它输出一个黑白图像,显示未被填充的区域。
---
立体图像生成方法
关键参数
分离(separation)
- 定义应用于左右图像的额外水平偏移百分比。
- 调整立体对之间的距离,影响对齐效果。
发散(divergence)
- 控制3D效果强度(以百分比表示)。
- 较高的发散值增强深度感知,较低值则产生更平坦的效果。
立体平衡(stereo_balance)
- 决定发散效果在双眼间的分配方式。
- 0.0 = 均衡分配
- 正/负值将效果偏向单眼。
立体偏移指数(stereo_offset_exponent)
- 调整深度到偏移的映射关系,影响深度值如何转换为水平位移。
---
填充方法
部分填充方法更快,而另一些则更好地保留结构。
- 朴素方法 稍微快一些。
- Polylines Soft 通常是通用填充的最佳选择。
填充技术对比
不填充:根据深度直接移动像素,不填补空隙。
不填充 - 反向投影:反向计算像素值,但会留下空隙。
不完美填充 - 混合边缘:结合“Polylines”与“反向投影”,以获得更好结构。
填充 - 朴素:使用最近像素填充空隙(导致拉伸)。
填充 - 朴素插值:使用插值平滑空隙。
填充 - Polylines Soft:使用具有柔和边缘的多段线以保留结构。
填充 - Polylines Sharp:与“Soft”类似,但具有更锐利的过渡。
填充 - 后填充:“不填充” + 边缘感知插值。
填充 - 反向投影 + 后填充:“反向投影” + 方向性插值。
填充 - 混合边缘增强版:增强版“混合边缘” + 自适应平滑。
---
安装
简易方法(推荐)
使用 ComfyUI-Manager 快速安装。
手动安装
克隆仓库并将其放入 ComfyUI 的 custom_nodes 目录:
git clone https://github.com/Dobidop/ComfyStereo.git
pip install -r requirements.txt
---
示例工作流
图像工作流

视频工作流
https://github.com/user-attachments/assets/0a61bc30-1821-40b8-b90d-12733f85bdea)
---
故障排除
- CPU 利用率低?
- 尝试更新 Python 和 ComfyUI-Manager——曾有用户通过此方法解决问题。


