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

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

配置

聚光灯样式
  • 搜索配置:单击配置面板右上角的搜索配置,可在搜索配置对话框中输入您需要搜索的配置项名称,快速定位到该配置项,系统支持模糊匹配。详情请参见搜索组件配置
  • 聚光灯配置面板中的参数说明。
    参数 说明
    辅助体 打开开关,显示聚光灯辅助体样式;关闭开关,隐藏聚光灯辅助体样式。
    投射阴影 打开开关,开启聚光灯投射阴影效果;关闭开关,聚光灯不投射阴影效果。
    说明 开启聚光灯投射阴影效果,需要其他组件材质支持接受阴影,而且光影会影响所有支持该光源的材质,使用投射阴影会使得电脑配置性能开销变大,请谨慎使用该功能。
    阴影参数 打开投射阴影效果后,可自定义设置聚光灯的阴影参数,包括阴影贴图精度值、bias(偏差值)、阴影半径值、fov(视场角值)、近平面距离值和远平面值。
    颜色 聚光灯光线的颜色,请参见颜色选择器说明修改颜色。
    光照强度 拖动滑块设置聚光灯光照强度系数,取值范围为0~1000。
    视角 拖动滑块设置聚光灯的灯光视角,取值范围为0~1.5。
    衰减系数 拖动滑块设置聚光灯的灯光投射衰减系数值,取值范围为0~2。
    距离 拖动滑块设置聚光灯能照到的距离,默认为0,即可以照到无限远,取值范围为0~30000。
    半影锥 拖动滑块设置聚光灯阴影边缘模糊渐变的半径比例值,取值范围为0~1。
    经度 拖动滑块设置聚光灯所处的经度值。
    纬度 拖动滑块设置聚光灯所处的纬度值。
    高度 拖动滑块设置聚光灯距离地面所处的高度值。
    目标经度 拖动滑块设置聚光灯光源照向的目标位置的经度值。
    目标纬度 拖动滑块设置聚光灯光源照向的目标位置的纬度值。
    目标高度 拖动滑块设置聚光灯光源照向的目标位置距离地面的高度值。

数据

此组件不需要配置数据。

蓝图编辑器交互配置

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