> ## Documentation Index
> Fetch the complete documentation index at: https://comfytv.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 水面 (Water)

> 在画面上模拟起伏的流体表面——雨滴与漩涡水流，一次 ▶ Run 完成。

<Frame caption="水面 (Water) · 截图待补">
  <img src="https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/nodes/_placeholder.svg?fit=max&auto=format&n=dMkMxJDZdIo4YzAU&q=85&s=b54171099e5b02d4313fe581171ebbcc" alt="水面 (Water)" width="800" height="450" data-path="images/nodes/_placeholder.svg" />
</Frame>

## 这个节点做什么

**水面 (Water)** 在一段 `COMFYTV_VIDEO` 上运行流体表面模拟，让画面透过产生的涟漪折射，并在 **▶ Run** 时写出新快照。涟漪来自周期性的雨滴和／或有方向的漩涡水流，流体的黏度用 **physics** 预设选择。

输入与输出都是 `COMFYTV_VIDEO`。若要对接原生 ComfyUI 节点，请插入 **Bridge**——见[桥接指南](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)。

## 何时使用

* 把镜头置于「水下」或雨打玻璃之后。
* 添加固定正弦波无法伪造的、有生命的物理涟漪。
* 用 sludge 系列预设制造黏稠、糊状的扭曲。

## 参数

### physics

流体行为预设。选项：`water`（轻快涟漪）、`jelly`、`sludge`、`super_sludge`（逐级更黏稠、更慢、更迟滞）。默认 `water`。

### rain

生成周期性的雨滴涟漪。默认开启。

### swirl

添加有方向的漩涡水流。默认关闭。

> 若 **rain** 与 **swirl** 都关闭，节点原样透传片段。

### rain\_every

两次雨滴之间的帧数，`1`–`24`，默认 `4`。越小雨滴越频繁（表面更繁忙）。

### amplitude

涟漪／折射强度，`0.0`–`1.0`，默认 `0.5`。越高扭曲越深。

### swirl\_x / swirl\_y

漩涡水流的方向／强度，各为 `-0.5`–`0.5`，默认 `0.0`。仅在 **swirl** 开启时使用；推动数值以引导水流。

### seed

雨滴落点的随机种子，`0`–`99999`，默认 `7`。相同种子 = 相同涟漪图案。

## 输出

| 输出        | 类型              | 含义               |
| --------- | --------------- | ---------------- |
| **video** | `COMFYTV_VIDEO` | 涟漪化后的片段，作为新的项目快照 |

## 提示

* 同时关闭 **rain** 与 **swirl** 即可在不拔线的情况下旁路该效果。
* **swirl\_x/swirl\_y** 仅在 **swirl** 启用时才有效。
* 更黏稠的 **physics** 预设让涟漪保持更久，得到更慢、更黏糊的运动。

## 相关节点

* **波形扭曲 (Wave Warp)** — 更简单、确定性的正弦涟漪。
* **反馈特效 (Feedback FX)** — 递归拖影，另一种流动外观。