聚光灯是三维城市构建器补充额外的光源的图层，用于模拟聚光灯的打光和颜色效果，投射的光线可根据需要调节聚光样式，使得在一定范围内，可使光区放大或缩小。聚光灯支持独立的样式配置，包括聚光灯辅助体样式、投射阴影参数、光的强度、颜色等。本文介绍聚光灯各配置项的含义。

在场景编辑器左侧图层列表中，单击聚光灯图层，进入配置面板配置聚光灯图层的样式和数据。
说明 如果图层列表中没有聚光灯，说明您还未添加聚光灯图层，请参见添加子组件进行添加。

配置

说明 避免添加多个聚光灯，会使性能开销过大。
配置面板
  • 搜索配置：单击配置面板右上角的搜索配置，可在搜索配置面板中输入您需要搜索的配置项名称，快速定位到该配置项，系统支持模糊匹配。详情请参见搜索资产配置。
  • 聚光灯配置面板中的参数说明。
    • 通用
      参数说明
      光源位置设置聚光灯的光源位置信息。
      • 经度：拖动滑块设置聚光灯光源所处的经度值，取值范围为-180~180。
      • 纬度：拖动滑块设置聚光灯光源所处的纬度值，取值范围为-90~90。
      • 高程：拖动滑块设置聚光灯光源距离地面所处的高度值，取值范围为-1000~20000。
      目标位置设置聚光灯的目标位置信息。
      • 经度：拖动滑块设置聚光灯光源照向的目标位置的经度值，取值范围为-180~180。
      • 纬度：拖动滑块设置聚光灯光源照向的目标位置的纬度值，取值范围为-90~90。
      • 高程：拖动滑块设置聚光灯光源照向的目标位置距离地面的高度值，取值范围为-1000~20000。
    • 图形
      参数说明
      光照颜色聚光灯光照的颜色，请参见颜色选择器说明修改颜色。
      光照强度拖动滑块设置聚光灯光照强度系数，取值范围为0~10。
      衰减系数拖动滑块设置聚光灯的灯光投射衰减系数值，取值范围为0~2。
      视角拖动滑块设置聚光灯的灯光视角，取值范围为0~0.5。
      距离拖动滑块设置聚光灯能照到的距离，默认为0，即可以照到无限远，取值范围为0~30000。
      半影锥拖动滑块设置聚光灯阴影边缘模糊渐变的半径比例值，取值范围为0~1。
      投射阴影打开开关，开启聚光灯投射阴影效果；关闭开关，聚光灯不投射阴影效果。
      说明 开启聚光灯投射阴影效果，需要其他组件材质支持接受阴影，而且光影会影响所有支持该光源的材质，使用投射阴影会使得电脑配置性能开销变大，请谨慎使用该功能。
      辅助体包括控制辅助体光源和阴影相机样式。打开开关，显示聚光灯辅助体样式；关闭开关，隐藏聚光灯辅助体样式。
      阴影参数打开投射阴影效果后，可自定义设置聚光灯的阴影参数，包括阴影近平面距离、远平面距离、阴影贴图和focus。

数据

此图层不需要配置数据。

蓝图编辑器交互配置

  1. 在当前场景编辑器页面，单击左侧图层列表中聚光灯右侧的导出到蓝图编辑器图标。
  2. 单击页面左上角的蓝图图标图标。
  3. 在蓝图编辑器配置页面，单击导入节点栏内的聚光灯图层，在画布中可以看到如下图所示的聚光灯的蓝图编辑器配置参数。聚光灯蓝图参数
    • 事件：无。
    • 动作
      动作说明
      显示组件显示组件，不需要参数。
      隐藏组件隐藏组件，不需要参数。