> ## Documentation Index
> Fetch the complete documentation index at: https://comfytv.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Regrain
> 添加逼真的胶片颗粒，并对阴影、中间调、高光分别控制 —— 用于给干净渲染重新加颗粒，或匹配真实胶片。
## 这个节点做什么
**Regrain（重加颗粒）** 在片段上叠加合成胶片颗粒。不同于一刀切的噪声，你可以分别设定落在**阴影（shadows）**、**中间调（midtones）**、**高光（highlights）** 的颗粒量，外加颗粒大小和颜色饱和度 —— 呼应真实胶片颗粒随色调范围变化的规律。这是获得可信有机胶片质感的工具。
这是一个需要渲染的节点 —— 必须 **▶ Run**（torch/GPU 后端）。输入 `COMFYTV_VIDEO`，输出 `COMFYTV_VIDEO`。
若三个色调量（`shadows`、`midtones`、`highlights`）全为零，节点原样穿过片段（没有颗粒可加）。
要把结果交给原生 ComfyUI 节点，请插入 **Bridge**。参见 [bridges.md](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)。
## 何时使用
* 给干净的 AI/CG 渲染添加有机胶片颗粒，使其与真实素材融合。
* 匹配某种特定胶片的颗粒特性。
* 在降噪或放大把颗粒抹平后恢复颗粒。
## 参数
### grain\_size
`0.0`–`4.0`（步长 `0.05`），默认 `0.8`。颗粒粒子的大小。越小越细密；越大越粗大块。
### shadows
`0.0`–`1.0`，默认 `0.3`。最暗色调中的颗粒量。
### midtones
`0.0`–`1.0`，默认 `0.15`。中间色调中的颗粒量。
### highlights
`0.0`–`1.0`，默认 `0.05`。最亮色调中的颗粒量。（真实胶片通常在高光处颗粒最少，故默认值较低。）
### grain\_sat
`0.0`–`1.0`，默认 `0.4`。颗粒的颜色饱和度。`0.0` 为单色（仅亮度）颗粒；越高越添加彩色颗粒。
### seed
`0`–`99999`，默认 `7`。颗粒图案的随机种子。改变它得到不同的颗粒分布；固定它以获得可复现的结果。
## 输出
| 输出 | 类型 | 含义 |
| --------- | --------------- | -------- |
| **video** | `COMFYTV_VIDEO` | 重加颗粒后的片段 |
## 提示
* 遵循胶片惯例：阴影颗粒最多，中间调较少，高光最少（默认值已如此）。
* 想要经典单色胶片颗粒感就把 `grain_sat` 保持低；仅在需要可见彩色噪声时才调高。
* 三个色调量都设为 `0` 时节点无操作（原样穿过）。
## 相关节点
* **Old Film（老电影）** —— 完整的胶片损伤模拟（颗粒外加划痕、闪烁、抖动）。
* **Video Stylize（视频风格化）** —— 含更简单的 `grain` 预设。