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

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