# 光照API

光照系统采取**光强等级**来表示光照的强弱。光强等级为整数，有效区间为\[0, 32]，0为无光强，32为最大光强。

一个光源由如下四个光强分量来表示：

* `alpha`分量表示**总光照强度**。
* `red`分量表示光照中**红色光**的多少。
* `green`分量表示光照中**绿色光**的多少。
* `blue`分量表示光照中**蓝色光**的多少。

## 光照通用模块（LightingUtils）

<table data-header-hidden><thead><tr><th width="302.3333333333333">函数</th><th align="center">返回值</th><th>描述</th></tr></thead><tbody><tr><td>函数</td><td align="center">返回值</td><td>描述</td></tr><tr><td>LightingUtils.Add(int xi, int yi, int alpha, int red = 0, int green = 0, int blue = 0)</td><td align="center">void</td><td>为指定格子添加一个光源。</td></tr><tr><td>LightingUtils.AddDelay(int xi, int yi, int delayTime, int alpha, int red = 0, int green = 0, int blue = 0)</td><td align="center">void</td><td>为指定格子添加一个延迟光源。光源在<code>delayTime</code>时间内会逐渐延迟消失。</td></tr><tr><td>LightingUtils.SetState(LightingState state)</td><td align="center">void</td><td>设定客户端当前的光照状态。光照渲染完毕后恢复状态为<em><code>LIGHTING_STATE_NORMAL</code>。</em></td></tr></tbody></table>

