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

# God Rays

> 从某一点辐射而出的体积光束（曙暮光线）—— 就像穿过云层或窗户的阳光。

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

## 这个节点做什么

**God Rays（神光）** 通过不断对帧的明亮版本朝某个点缩放并衰减，制造从光源位置扇形放射的光束。它产生经典的"光束"观感 —— 阳光、圣光、明亮的门口。

这是一个需要渲染的节点 —— 必须 **▶ Run**，使用 torch（GPU）后端。输入 `COMFYTV_VIDEO`，输出 `COMFYTV_VIDEO`。

要把结果交给原生 ComfyUI 节点，请插入 **Bridge**。参见 [bridges.md](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)。

## 何时使用

* 添加穿过树木、云层或窗户的阳光。
* 给明亮光源加上戏剧性的体积光晕。
* 营造氛围感、朦胧或神圣的情绪。

## 参数

### translate\_x / translate\_y

各 `-2000.0`–`2000.0`（步长 `1.0`），默认 `0.0`。光束辐射所自的光源位置，相对画面中心的像素偏移。移动它们来放置"太阳"。

### scale

`0.2`–`4.0`，默认 `1.4`。每个光束步进能延伸多远 —— 值越大光束越长、越铺展。

### rotate\_deg

`-180.0`–`180.0`（步长 `0.5`），默认 `0.0`。光束方向的旋转，单位度（正值为逆时针）。

### steps

`1`–`7`，默认 `5`。构建光束所用的放射采样步数。步数越多光束越平滑越长（计算量也更大）。

### decay

`0.001`–`1.0`，默认 `0.3`。光束随离光源距离衰减的速度。越低光束越短；越高光束越长越亮。

### max\_mode

布尔，默认 `false`。开启时，光束用取最大值（变亮）方式合成，而非默认的加法混合 —— 有助于避免高光过曝。

### mix

`0.0`–`1.0`，默认 `1.0`。光束与原帧的混合。调低可让效果更微妙。

## 输出

| 输出        | 类型              | 含义       |
| --------- | --------------- | -------- |
| **video** | `COMFYTV_VIDEO` | 添加光束后的片段 |

## 提示

* 把 `translate_x`/`translate_y` 设到画面里真实的光源（窗户、太阳）上，结果更可信。
* 与 **Glow** 组合，可在光源处叠加泛光 + 放射光束。

## 相关节点

* **Glow（辉光）** —— 明亮区域周围的柔和泛光（无方向性光束）。
* **Old Film（老电影）** —— 用于朦胧、做旧的情绪。