%20(1).png)
🌊 ComfyUI-Depthflow-Nodes 插件完全教程
1. 插件简介
插件地址： https://github.com/akatz-ai/ComfyUI-Depthflow-Nodes
这个插件就像一个神奇的魔法棒，能把你的静态2D图片变成超酷的2.5D视差动画！想象一下，你有一张普通的照片，通过这个插件，照片里的物体就能产生前后层次的运动效果，就像电影里的那种立体感一样。
能带来什么效果：
- 把平面照片变成有深度感的动画
- 创造各种运动效果：缩放、旋转、上下左右移动
- 添加电影级的景深模糊和暗角效果
- 制作出类似3D相机运动的视觉效果
2. 如何安装
方法一：通过ComfyUI管理器安装（推荐）
- 打开ComfyUI管理器
- 在自定义节点区域搜索"Depthflow"
- 找到"🌊 Depthflow Nodes"并点击安装
- 重启ComfyUI
方法二：手动安装
- 打开终端或命令提示符
- 进入ComfyUI的custom_nodes文件夹
- 运行命令：
git clone https://github.com/akatz-ai/ComfyUI-Depthflow-Nodes.git - 重启ComfyUI
3. 节点详细解析
3.1 🌊 Depthflow 核心节点
这是整个插件的心脏，就像一个超级加工厂，把你的图片和深度图混合在一起，加上各种运动效果，最后输出一系列动画帧。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | IMAGE类型 | - | 输入的原始图片，就像给机器喂食的原料 | 输入图像数据，支持单帧或多帧序列 | 连接你要处理的图片节点 |
| depth_map | depth_map | IMAGE类型 | - | 深度图，告诉机器哪里远哪里近，就像地形图 | 对应输入图像的深度信息图 | 连接深度估计节点的输出 |
| motion | motion | DEPTHFLOW_MOTION类型 | - | 运动方式，决定画面怎么动 | 定义动画运动模式的对象 | 连接运动预设或组件节点 |
| animation_speed | animation_speed | 0.01-无限 | 1.0 | 动画播放速度，就像视频播放器的倍速 | 控制动画播放的时间缩放因子 | 设为2.0播放速度翻倍，0.5慢一半 |
| input_fps | input_fps | 1.0以上 | 30.0 | 输入帧率，原始素材每秒多少帧 | 输入视频或图像序列的帧率 | 如果原图是24fps视频就填24 |
| output_fps | output_fps | 1.0以上 | 30.0 | 输出帧率，最终动画每秒多少帧 | 生成动画的目标帧率 | 想要流畅动画就设30或60 |
| num_frames | num_frames | 1以上 | 30 | 总帧数，动画有多少张图片 | 生成动画的总帧数 | 30帧配合30fps就是1秒动画 |
| quality | quality | 1-100 | 50 | 画质，数字越大越清晰但处理越慢 | 输出图像的质量等级 | 测试用30-50，最终输出用80-100 |
| ssaa | ssaa | 0.0-2.0 | 1.0 | 抗锯齿强度，让边缘更平滑 | 超采样抗锯齿的采样倍数 | 1.2能减少锯齿，但会增加处理时间 |
| invert | invert | 0.0-1.0 | 0.0 | 深度图反转，0是正常，1是完全颠倒远近 | 是否反转深度图的深度值 | 如果效果反了就调到1.0 |
| tiling_mode | tiling_mode | mirror/repeat/none | mirror | 边缘处理方式，画面边缘怎么填充 | 图像边界的平铺模式 | mirror镜像最自然，repeat重复 |
| effects | effects | DEPTHFLOW_EFFECTS类型 | 可选 | 视觉效果，比如模糊、暗角等装饰 | 可选的视觉效果处理对象 | 连接效果节点添加景深等效果 |
3.2 🌊 Depthflow Motion Preset Circle 圆形运动预设
让画面像摄像机绕着物体转圈一样运动，产生旋转的立体效果。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | intensity | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| intensity | intensity | 0.0-10.0 | 1.0 | 运动强度，数字越大转得越厉害 | 圆形运动的强度系数 | 0.5轻微转动，2.0剧烈转动 |
| reverse | reverse | True/False | False | 是否反向，改变转动方向 | 是否反转运动方向 | True逆时针，False顺时针 |
| smooth | smooth | True/False | True | 是否平滑，让运动更自然 | 是否应用平滑过渡 | True运动更流畅，False更机械 |
| phase_x | phase_x | -10.0-10.0 | 0.0 | X轴相位，调节水平方向的起始位置 | X轴运动的相位偏移 | 调节水平转动的起始角度 |
| phase_y | phase_y | -10.0-10.0 | 0.0 | Y轴相位，调节垂直方向的起始位置 | Y轴运动的相位偏移 | 调节垂直转动的起始角度 |
| phase_z | phase_z | -10.0-10.0 | 0.0 | Z轴相位，调节深度方向的起始位置 | Z轴运动的相位偏移 | 调节前后运动的起始位置 |
| amplitude_x | amplitude_x | 0.0-1.0 | 1.0 | X轴幅度，水平转动的范围大小 | X轴运动的振幅 | 1.0最大水平转动，0.5减半 |
| amplitude_y | amplitude_y | 0.0-1.0 | 1.0 | Y轴幅度，垂直转动的范围大小 | Y轴运动的振幅 | 1.0最大垂直转动，0减少晃动 |
| amplitude_z | amplitude_z | 0.0-1.0 | 0.0 | Z轴幅度，前后运动的范围大小 | Z轴运动的振幅 | 0.3添加前后摆动效果 |
| static_value | static_value | 0.0-1.0 | 0.3 | 静态值，运动的基础偏移量 | 运动的基准偏移值 | 调节整体运动的中心位置 |
3.3 🌊 Depthflow Motion Preset Zoom 缩放运动预设
让画面产生放大缩小的效果，就像镜头拉近拉远一样。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | intensity | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| intensity | intensity | 0.0-10.0 | 1.0 | 缩放强度，数字越大缩放越明显 | 缩放运动的强度系数 | 0.5轻微缩放，2.0剧烈缩放 |
| reverse | reverse | True/False | False | 是否反向，改变缩放方向 | 是否反转缩放方向 | True先缩小后放大，False相反 |
| smooth | smooth | True/False | True | 是否平滑，让缩放更自然 | 是否应用平滑过渡 | True缩放更流畅，False更突兀 |
| phase | phase | -10.0-10.0 | 0.0 | 相位偏移，调节缩放的起始时机 | 缩放运动的相位偏移 | 调节缩放开始的时间点 |
| loop | loop | True/False | False | 是否循环，让缩放来回重复 | 是否启用循环缩放 | True持续缩放循环，False单次 |
3.4 🌊 Depthflow Motion Preset Dolly 推拉运动预设
模拟摄像机前后移动的效果，就像电影里的推拉镜头。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | intensity | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| intensity | intensity | 0.0-10.0 | 1.0 | 推拉强度，数字越大移动越明显 | 推拉运动的强度系数 | 0.5轻微推拉，2.0剧烈推拉 |
| reverse | reverse | True/False | False | 是否反向，改变推拉方向 | 是否反转推拉方向 | True先拉远后推近，False相反 |
| smooth | smooth | True/False | True | 是否平滑，让推拉更自然 | 是否应用平滑过渡 | True推拉更流畅，False更机械 |
| loop | loop | True/False | True | 是否循环，让推拉来回重复 | 是否启用循环推拉 | True持续推拉循环，False单次 |
| depth | depth | 0.0-1.0 | 0.5 | 深度值，控制推拉的深度范围 | 推拉运动的深度参数 | 0.3浅层推拉，0.8深层推拉 |
3.5 🌊 Depthflow Motion Preset Vertical 垂直运动预设
让画面上下移动，就像摄像机垂直摇摆。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | intensity | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| intensity | intensity | 0.0-10.0 | 1.0 | 垂直运动强度，数字越大上下摆动越厉害 | 垂直运动的强度系数 | 0.5轻微摆动，2.0剧烈摆动 |
| reverse | reverse | True/False | False | 是否反向，改变上下运动方向 | 是否反转垂直运动方向 | True先向下后向上，False相反 |
| loop | loop | True/False | True | 是否循环，让上下运动来回重复 | 是否启用循环垂直运动 | True持续上下循环，False单次 |
| smooth | smooth | True/False | True | 是否平滑，让上下运动更自然 | 是否应用平滑过渡 | True运动更流畅，False更机械 |
| phase | phase | -10.0-10.0 | 0.0 | 相位偏移，调节上下运动的起始时机 | 垂直运动的相位偏移 | 调节运动开始的时间点 |
| steady_value | steady_value | 0.0-1.0 | 0.3 | 稳定值，运动的基础位置 | 垂直运动的基准位置 | 调节整体运动的中心高度 |
3.6 🌊 Depthflow Motion Preset Horizontal 水平运动预设
让画面左右移动，就像摄像机水平摇摆。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | intensity | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| intensity | intensity | 0.0-10.0 | 1.0 | 水平运动强度，数字越大左右摆动越厉害 | 水平运动的强度系数 | 0.5轻微摆动，2.0剧烈摆动 |
| reverse | reverse | True/False | False | 是否反向，改变左右运动方向 | 是否反转水平运动方向 | True先向右后向左，False相反 |
| loop | loop | True/False | True | 是否循环，让左右运动来回重复 | 是否启用循环水平运动 | True持续左右循环，False单次 |
| smooth | smooth | True/False | True | 是否平滑，让左右运动更自然 | 是否应用平滑过渡 | True运动更流畅，False更机械 |
| phase | phase | -10.0-10.0 | 0.0 | 相位偏移，调节左右运动的起始时机 | 水平运动的相位偏移 | 调节运动开始的时间点 |
| steady_value | steady_value | 0.0-1.0 | 0.3 | 稳定值，运动的基础位置 | 水平运动的基准位置 | 调节整体运动的中心位置 |
3.7 🌊 Depthflow Motion Preset Orbital 轨道运动预设
创造轨道式的运动效果，就像卫星绕地球转一样。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | intensity | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| intensity | intensity | 0.0-10.0 | 1.0 | 轨道运动强度，数字越大轨道越明显 | 轨道运动的强度系数 | 0.5轻微轨道，2.0剧烈轨道 |
| reverse | reverse | True/False | False | 是否反向，改变轨道运动方向 | 是否反转轨道运动方向 | True逆向轨道，False正向轨道 |
| depth | depth | 0.0-1.0 | 0.5 | 轨道深度，控制轨道的立体感 | 轨道运动的深度参数 | 0.3浅层轨道，0.8深层轨道 |
3.8 🌊 Depthflow Motion Sine 正弦运动组件
用数学中的正弦波来控制运动，产生平滑的波浪式运动。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | amplitude | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| target | target | 参数列表 | Height | 要控制的目标参数，比如高度、缩放等 | 正弦波作用的目标参数 | Height控制高度，Zoom控制缩放 |
| amplitude | amplitude | -10.0-10.0 | 1.0 | 波动幅度，数字越大摆动越厉害 | 正弦波的振幅 | 2.0大幅摆动，0.5小幅摆动 |
| cycles | cycles | 0.0-10.0 | 1.0 | 循环次数，一个动画里波动几次 | 正弦波的周期数 | 2.0两个完整波动，0.5半个波动 |
| phase | phase | -10.0-10.0 | 0.0 | 相位偏移，调节波动的起始位置 | 正弦波的相位偏移 | 调节波动开始的时间点 |
| reverse | reverse | True/False | False | 是否反向，改变波动方向 | 是否反转时间方向 | True时间倒流效果，False正常 |
| bias | bias | -10.0-10.0 | 0.0 | 偏移量，整体向上或向下移动 | 正弦波的直流偏移 | 0.5整体上移，-0.5整体下移 |
| cumulative | cumulative | True/False | False | 是否累积，每帧都叠加上一帧的值 | 是否累积前一帧的数值 | True产生加速效果，False独立计算 |
3.9 🌊 Depthflow Motion Cosine 余弦运动组件
用数学中的余弦波来控制运动，和正弦波类似但起始位置不同。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | amplitude | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| target | target | 参数列表 | Height | 要控制的目标参数，比如高度、缩放等 | 余弦波作用的目标参数 | Height控制高度，Zoom控制缩放 |
| amplitude | amplitude | -10.0-10.0 | 1.0 | 波动幅度，数字越大摆动越厉害 | 余弦波的振幅 | 2.0大幅摆动，0.5小幅摆动 |
| cycles | cycles | 0.0-10.0 | 1.0 | 循环次数，一个动画里波动几次 | 余弦波的周期数 | 2.0两个完整波动，0.5半个波动 |
| phase | phase | -10.0-10.0 | 0.0 | 相位偏移，调节波动的起始位置 | 余弦波的相位偏移 | 调节波动开始的时间点 |
| reverse | reverse | True/False | False | 是否反向，改变波动方向 | 是否反转时间方向 | True时间倒流效果，False正常 |
| bias | bias | -10.0-10.0 | 0.0 | 偏移量，整体向上或向下移动 | 余弦波的直流偏移 | 0.5整体上移，-0.5整体下移 |
| cumulative | cumulative | True/False | False | 是否累积，每帧都叠加上一帧的值 | 是否累积前一帧的数值 | True产生加速效果，False独立计算 |
3.10 🌊 Depthflow Motion Linear 线性运动组件
创造直线式的运动，从一个值平滑过渡到另一个值。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | start | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| target | target | 参数列表 | Height | 要控制的目标参数，比如高度、缩放等 | 线性运动作用的目标参数 | Height控制高度，Zoom控制缩放 |
| start | start | 0.0-1.0 | 0.0 | 起始值，运动开始时的数值 | 线性插值的起始值 | 0.0从最小开始，0.5从中间开始 |
| end | end | 0.0-1.0 | 1.0 | 结束值，运动结束时的数值 | 线性插值的结束值 | 1.0到最大结束，0.5到中间结束 |
| low | low | -9999.0-9999.0 | 0.0 | 最小边界，运动的最小值限制 | 输出值的下边界 | -1.0允许负值，0.0限制为正值 |
| high | high | -9999.0-9999.0 | 1.0 | 最大边界，运动的最大值限制 | 输出值的上边界 | 2.0允许超过1，1.0限制在1以内 |
| exponent | exponent | 0.0-9999.0 | 1.0 | 指数，控制运动的加速度曲线 | 插值的指数函数 | 2.0加速运动，0.5减速运动 |
| reverse | reverse | True/False | False | 是否反向，改变运动方向 | 是否反转时间方向 | True从end到start，False从start到end |
| cumulative | cumulative | True/False | False | 是否累积，每帧都叠加上一帧的值 | 是否累积前一帧的数值 | True产生加速效果，False独立计算 |
3.11 🌊 Depthflow Motion Exponential 指数运动组件
创造指数式的运动，开始慢后来快，或者开始快后来慢。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | base | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| target | target | 参数列表 | Height | 要控制的目标参数，比如高度、缩放等 | 指数运动作用的目标参数 | Height控制高度，Zoom控制缩放 |
| base | base | 任意数值 | 2.0 | 指数底数，决定增长的快慢 | 指数函数的底数 | 2.0翻倍增长，10.0快速增长 |
| scale | scale | 任意数值 | 1.0 | 缩放系数，调节整体大小 | 指数结果的缩放因子 | 0.5减半效果，2.0加倍效果 |
| reverse | reverse | True/False | False | 是否反向，改变运动方向 | 是否反转时间方向 | True时间倒流效果，False正常 |
| cumulative | cumulative | True/False | False | 是否累积，每帧都叠加上一帧的值 | 是否累积前一帧的数值 | True产生加速效果，False独立计算 |
3.12 🌊 Depthflow Motion Arc 弧形运动组件
创造弧形的运动轨迹，通过三个点定义一个平滑的弧线。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | start | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| target | target | 参数列表 | Height | 要控制的目标参数，比如高度、缩放等 | 弧形运动作用的目标参数 | Height控制高度，Zoom控制缩放 |
| start | start | -9999.0-9999.0 | 0.0 | 起始点，弧线的开始位置 | 弧形轨迹的起始点 | 0.0从原点开始，1.0从高位开始 |
| middle | middle | -9999.0-9999.0 | 0.0 | 中间点，弧线的最高或最低点 | 弧形轨迹的中间控制点 | 1.0形成向上弧，-1.0形成向下弧 |
| end | end | -9999.0-9999.0 | 0.0 | 结束点，弧线的结束位置 | 弧形轨迹的结束点 | 0.0回到原点，1.0结束在高位 |
| reverse | reverse | True/False | False | 是否反向，改变弧线方向 | 是否反转时间方向 | True反向走弧线，False正向走弧线 |
| cumulative | cumulative | True/False | False | 是否累积，每帧都叠加上一帧的值 | 是否累积前一帧的数值 | True产生加速效果，False独立计算 |
3.13 🌊 Depthflow Motion Set Target 设置目标运动组件
直接设置某个参数为固定值，不产生运动变化。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | value | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| target | target | 参数列表 | Height | 要设置的目标参数，比如高度、缩放等 | 要设置固定值的目标参数 | Height设置高度，Zoom设置缩放 |
| value | value | -9999.0-9999.0 | 0.0 | 固定值，要设置的具体数值 | 目标参数的固定数值 | 0.5设为中等值，1.0设为最大值 |
3.14 🌊 Depthflow Effect Vignette 暗角效果
给画面边缘添加暗角效果，就像老式相机镜头的暗角一样。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | vignette_intensity | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| vignette_enable | vignette_enable | True/False | True | 是否启用暗角，开关暗角效果 | 是否启用暗角效果 | True显示暗角，False关闭暗角 |
| vignette_intensity | vignette_intensity | 0.0-100.0 | 30 | 暗角强度，数字越大边缘越暗 | 暗角效果的强度 | 10轻微暗角，50明显暗角 |
| vignette_decay | vignette_decay | 0.0-1.0 | 0.1 | 暗角衰减，控制暗角的渐变范围 | 暗角从中心到边缘的衰减率 | 0.05渐变范围大，0.3渐变范围小 |
3.15 🌊 Depthflow Effect DOF 景深效果
添加景深模糊效果，让远近不同的物体有不同的清晰度，就像相机的景深效果。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| strength | strength | 0.0-10.0 | 1.0 | 特征调节强度，配合其他功能使用 | 特征调制的强度系数 | 通常保持1.0，除非使用高级功能 |
| feature_threshold | feature_threshold | 0.0-1.0 | 0.0 | 特征阈值，低于这个值就不生效 | 特征激活的最小阈值 | 配合音频等特征使用时调节 |
| feature_param | feature_param | 参数列表 | dof_intensity | 要调节的参数名称 | 被特征调制的目标参数 | 选择想要随特征变化的参数 |
| feature_mode | feature_mode | relative/absolute | relative | 调节模式，相对或绝对 | 特征调制的计算模式 | relative更自然，absolute更直接 |
| dof_enable | dof_enable | True/False | True | 是否启用景深，开关景深效果 | 是否启用景深模糊效果 | True显示景深，False关闭景深 |
| dof_start | dof_start | 0.0-1.0 | 0.6 | 景深开始，从哪个深度开始模糊 | 景深效果的起始深度值 | 0.3近处开始模糊，0.8远处开始模糊 |
| dof_end | dof_end | 0.0-1.0 | 1.0 | 景深结束，到哪个深度完全模糊 | 景深效果的结束深度值 | 0.7部分模糊，1.0完全模糊 |
| dof_exponent | dof_exponent | -10.0-10.0 | 2.0 | 景深指数，控制模糊的渐变曲线 | 景深模糊的指数函数 | 1.0线性渐变，3.0快速渐变 |
| dof_intensity | dof_intensity | 0.0-2.0 | 1.0 | 景深强度，模糊的程度 | 景深模糊的强度系数 | 0.5轻微模糊，1.5强烈模糊 |
| dof_quality | dof_quality | 1-16 | 4 | 景深质量，模糊的精细程度 | 景深模糊的采样质量 | 2快速但粗糙，8慢速但精细 |
| dof_directions | dof_directions | 1-32 | 16 | 景深方向，模糊的方向数量 | 景深模糊的采样方向数 | 8较少方向，24更多方向 |
4. 使用技巧和建议
4.1 新手入门建议
- 先从简单的运动预设开始，比如Zoom或Circle
- 建议先用低质量(quality=30)和少帧数(num_frames=15)测试效果
- 深度图质量直接影响最终效果，建议使用专业的深度估计模型
4.2 参数调节技巧
- intensity参数：从0.5开始调试，太大会产生不自然的效果
- 帧率设置：input_fps和output_fps保持一致通常效果最好
- tiling_mode：mirror模式适合大部分场景，repeat适合纹理类图片
4.3 性能优化
- 使用ssaa=1.0可以获得最快的渲染速度
- 大分辨率图片建议先缩小处理，再放大输出
- 复杂运动组合会显著增加处理时间
4.4 效果组合建议
- 运动预设 + 景深效果 = 电影级视觉效果
- 多个运动组件可以叠加使用，创造复杂运动
- 暗角效果适合配合所有运动类型使用
5. 常见问题解答
Q1: 为什么我的动画效果很奇怪？
A: 检查深度图是否正确，深度图的黑白对比度直接影响效果。如果效果相反，尝试调节invert参数。
Q2: 渲染速度太慢怎么办？
A: 降低quality参数、减少num_frames、设置ssaa=1.0，或者先用小分辨率测试。
Q3: 画面边缘出现黑边怎么办？
A: 调整tiling_mode参数，mirror模式通常能解决边缘问题。
Q4: 如何制作循环动画？
A: 在运动预设中启用loop参数，或者使用正弦/余弦组件创建周期性运动。
Q5: 可以同时使用多个运动效果吗？
A: 可以！运动组件支持叠加，你可以连接多个运动节点创造复杂效果。
6. 总结
这个Depthflow插件是一个功能强大的2.5D动画制作工具，通过15个不同的节点，你可以：
- 轻松入门：使用6个运动预设快速制作各种动画效果
- 精细控制：通过6个运动组件实现复杂的自定义运动
- 视觉增强：用2个效果节点添加专业的视觉效果
- 灵活组合：所有节点都可以自由组合，创造无限可能
无论你是新手还是专业用户，这个插件都能帮你把静态图片变成令人惊艳的动态视觉作品。记住，好的深度图是成功的一半，多实验不同的参数组合，你会发现更多有趣的效果！
所有节点都已详细解析完毕！🎉