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

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

配置

说明 避免添加多个聚光灯,会使性能开销过大。
配置面板
  • 搜索配置:单击配置面板右上角的搜索配置,可在搜索配置面板中输入您需要搜索的配置项名称,快速定位到该配置项,系统支持模糊匹配。详情请参见搜索资产配置
  • 聚光灯配置面板中的参数说明。
    • 通用
      参数说明
      光源位置设置聚光灯的光源位置信息。
      • 经度:拖动滑块设置聚光灯光源所处的经度值,取值范围为-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. 在蓝图编辑器配置页面,单击导入节点栏内的聚光灯图层,在画布中可以看到如下图所示的聚光灯的蓝图编辑器配置参数。聚光灯蓝图参数
    • 事件:无。
    • 动作
      动作说明
      显示组件显示组件,不需要参数。
      隐藏组件隐藏组件,不需要参数。