聚光灯

聚光灯 是由一个点向一个方向发射一束锥形光线，类似于手电筒或舞台照明灯产生的光线。与其他光源相比，聚光灯多了 SpotAngle 属性，用于调整聚光灯的光照范围。

在编辑器中可以直观地看到光源的位置、颜色、光照范围以及它的聚光角度等，如下图所示。配合编辑器左上角的变换工具可调整聚光灯的位置及照射方向等。

在场景中添加聚光灯的方式可参考添加光源。

聚光灯组件接口请参考 SpotLight API。

注意：从 v3.5 开始，聚光灯光阴影 从场景设置面板中独立出来，不再受到全局阴影参数的影响。

聚光灯属性

属性	说明
Color	设置光源颜色
UseColorTemperature	是否启用色温
ColorTemperature	调节色温
Size	设置光源大小
Range	设置光照影响范围
SpotAngle	调整聚光角度，控制光照范围
Term	设置光照强度单位类型，包括光通量（LUMINOUS_POWER）和亮度（LUMINANCE）两种
LuminousPower	光通量，单位流明（lm）当 Term 设置为 LUMINOUS_POWER 时生效
Luminance	亮度，单位坎德拉每平方米（cd/m²）当 Term 设置为 LUMINANCE 时生效
StaticSettings	静态灯光设置，详情请参考光照贴图

阴影属性需要在场景中开启阴影。开启方法请参考阴影 - 开启阴影。

开启后，聚光灯会展示如下动态阴影界面：

属性	说明
ShadowEnabled	是否开启平行光阴影
ShadowPcf	设置阴影边缘反走样等级，目前支持 HARD、SOFT、SOFT_2X，详情可参考下文 PCF 软阴影部分的介绍。
ShadowBias	设置阴影偏移值，防止 z-fiting
ShadowNormalBias	设置法线偏移值，防止曲面出现锯齿状

百分比渐近过滤（PCF）是一个简单、常见的用于实现阴影边缘反走样的技术，通过对阴影边缘进行平滑处理来消除阴影贴图的锯齿现象。原理是在当前像素（也叫做片段）周围进行采样，然后计算样本跟片段相比更接近光源的比例，使用这个比例对散射光和镜面光成分进行缩放，然后再对片段着色，以达到模糊阴影边缘的效果。

目前 Cocos Creator 支持 硬采样、4 倍采样（SOFT 模式）、9 倍采样（SOFT_2X 模式），倍数越大，采样区域越大，阴影边缘也就越柔和。

对于材质中已经开启 instancing 的模型，平面阴影也会自动同步使用 instancing 绘制，详情请参考动态合批。