TOD+天气系统¶
通过案例教学帮助用户学习和理解如何配置案例环境。
从早到晚光照效果
天气效果
如何配置案例环境(TOD+天气系统)¶
SimOne 依托 UE5 UDS 插件和自主开发的参数完成环境里的时间与光照、天气、材质影响等参数设置。
| 缩写/名称 | 定义 |
|---|---|
| TOD | Time of Day |
| UE5 | Unreal Engine(虚幻引擎5),SimOne 依托的可视化渲染引擎 |
| UDS / UDW | Ultra Dynamic Sky(超级动态天空)/ Ultra Dynamic Weather(超级动态天气) |
注意
提供 两种方式 进行环境参数调整。
案例编辑器环境面板:用户可以在 案例编辑器 > 环境 面板根据需要自行配置,可以使用 案例资源库 中的 环境预设 ,将其拖入案例编辑视窗中。
UE 可视化工具控制台:用户可以在 UE 可视化工具控制台上按下 键盘上的 ` 键,输入相应的 weather.参数名 值 ,可直观修改天气环境。
1. 环境编辑器调整环境参数¶
环境编辑器面板提供 时间与光照、天气、材质影响 三方面的环境参数。
新建案例。
点击 资源列表>环境,打开环境编辑器。
可以根据需要调整 时间与光照、天气、材质影响 三方面的环境参数。
也可选择 环境预设 拖入视窗。
注意
具体参数参考图及详细介绍可查看 附录:参数详解。
点击左上角 保存(案例) ,运行案例(开启UE高精度可视化工具)即可看到效果。
注意
可以通过 环境参数面板 的右上角 保存自己定义的天气预设,便于别的案例下次使用。
2. 可视化工具调整参数¶
用户可以在 UE 可视化工具控制台上按下 键盘上的 ` 键,输入相应的 weather.参数名 值 ,可直观修改天气环境,参数名可参考 附录 - 参数详解。
在 UE 可视化工具上按下 键盘上的 ` 键,调出控制台。
输入 sun ,会出现相关参数提示。根据提示进行上下选择,按下 空格 ,选择该参数进行参数调整。
注意
输入 weather. 将直接精准定位到 TOD+天气系统 相关参数部分。
参数右侧栏有相应 参数范围提示,输入想要的数值,如 10,按下回车,即可看到效果。
此时太阳光会变得更加明亮。
附录¶
参数详解¶
1. 时间与光照¶
2.1.1 当前时间 / timeOfDay¶
注意
早上路灯关闭时间 7:00 ,车灯关闭时间 6:00
晚上路灯开启时间 18:00,车灯开启时间 18:01
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 当前时间 | timeOfDay | 0:00 - 24:00 | 10:00 | 无 | Sky > Basic Controls > Time Of Day |
2.1.2 模拟真实 / simulateReality¶
注意
模拟真实 功能旨在模拟现实的地点时间下读取真实太阳月亮的位置。
默认开启后,“太阳方位角”、“太阳倾角”、“月球方位角”、“月球倾角” 功能将失效,参数置灰。
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 启用模拟真实 | simulateReality | True / False | True | 无 | Sky > 模拟 > Simulate Real Sun/Moon |
| 地点 | / | 选择地点 | - | 无 | Sky > 模拟 > Location Preset |
| 经度 | longitude | -180 - 180 | 110.1983 | ° | Sky > 模拟 > Longitude |
| 纬度 | latitude | -90 - 90 | 20.0442 | ° | Sky > 模拟 > Latitude |
| 时区 | timeZone | -12 - 12 | 8 | 时区 | Sky > 模拟 > Time Zone |
| 年 | date | 1800 - 2100 | 2023 | 年 | Sky > 模拟 > Year |
| 月 | 1 - 12 | 3 | 月 | Sky > 模拟 > Month | |
| 日 | 1 - 31 | 21 | 日 | Sky > 模拟 > Day |
注意
方向遵从 编辑器视窗 的 上北 下南 左西 右东 的原则。
注意
开启模拟真实 时,太阳会从东边升起。
关闭模拟真实 时(此时太阳方位角为 0°),太阳默认从北边升起。
2.1.3 ☀ 太阳 / sun¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 太阳光强度 | sunIntensity | 0 - 10 | 5.0 | lux | Sky > Sun > Sun Light Intensity |
| 太阳方位角 | sunAzimuth | 0 - 360 | 0.0 | ° | Sky > Sun > Sun Angle |
| 太阳倾角 | sunInclination | -85 - 85 | 30.0 | ° | Sky > Sun > Sun Inclination |
| 太阳大小 | sunSize | 0 - 5 | 1.0 | 无 | Sky > Sun > Sun Radius |
2.1.3.1 太阳光强度 / sunIntensity¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 太阳光强度 | sunIntensity | 0 - 10 | 5.0 | lux | Sky > Sun > Sun Light Intensity |
2.1.3.2 太阳方位角 / sunAzimuth¶
注意
方向遵从 编辑器视窗 的 上北 下南 左西 右东 的原则。
参数名 |
console |
参数范围 |
默认值 |
单位 |
UE5参数位置 |
|---|---|---|---|---|---|
太阳方位角 |
sunAzimuth |
0 - 360 |
0.0 |
° |
Sky > Sun > Sun Angle |
太阳所在方位(0-360°),从正北方向(0°)沿地平线顺时针量角,决定太阳升起/落下方向。使用 “模拟真实” 时禁用。 |
|||||
2.1.3.3 太阳倾角 / sunInclination¶
参数名 |
console |
参数范围 |
默认值 |
单位 |
UE5参数位置 |
|---|---|---|---|---|---|
太阳倾角 |
sunInclination |
-85 - 85 |
30.0 |
° |
Sky > Sun > Sun Inclination |
太阳光入射方向与天顶方向夹角。使用“模拟真实”时禁用。 |
|||||
2.1.3.4 太阳大小 / sunSize¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 太阳大小 | sunSize | 0 - 5 | 1.0 | 无 | Sky > Sun > Sun Radius |
2.1.4 🌙 月 / moon¶
注意
月参考图默认时间设定为20:00
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 月光强度 | moonIntensity | 0 - 1 | 0.12 | 无 | Sky > Moon > Moon Light Intensity |
| 月球方位角 | moonAzimuth | 0 - 360 | 15.0 | ° | Sky > Moon > Moon Angle |
| 月球倾角 | moonInclination | -90 - 90 | 35.0 | ° | Sky > Moon > Moon Inclination |
| 月球大小 | moonSize | 0 - 12 | 0.7 | 无 | Sky > Moon > Moon Scale |
| 月相 | moonPhase | 0 - 29.53 | 0.0 | 无 | Sky > Moon > Moon Phase |
| 月球颜色 | moonColorAmoonColorRmoonColorGmoonColorB | R G B A 值 | R 0.486328, G 0.574971, B 0.864583, A 1.0 | 无 | Sky > Moon > Moon Material Color |
2.1.4.1 月光强度 / moonIntensity¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 月光强度 | moonIntensity | 0 - 1 | 0.12 | 无 | Sky > Moon > Moon Light Intensity |
2.1.4.2 月球方位角 / moonAzimuth¶
参数名 |
console |
参数范围 |
默认值 |
单位 |
UE5参数位置 |
|---|---|---|---|---|---|
月球方位角 |
moonAzimuth |
0 - 360 |
15.0 |
° |
Sky > Moon > Moon Angle |
月球所在方位(0-360°),从正北方向(0°)沿地平线顺时针量角,决定月球升起/落下方向。使用 “模拟真实” 时禁用。 |
|||||
注意
方向遵从 编辑器视窗 的 上北 下南 左西 右东 的原则。
注意
可以通过在可视化界面中按下 ` 快捷键,调出 console 控制台,输入 weather.moonAzimuth -15 ,回车后可以看到超范围数值效果。
2.1.4.3 月球倾角 / moonInclination¶
参数名 |
console |
参数范围 |
默认值 |
单位 |
UE5参数位置 |
|---|---|---|---|---|---|
月球倾角 |
moonInclination |
-90 - 90 |
35.0 |
° |
Sky > Moon > Moon Inclination |
月球光入射方向与天顶方向夹角。使用 “模拟真实” 时禁用。 |
|||||
2.1.4.4 月球大小 / moonSize¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 月球大小 | moonSize | 0 - 12 | 0.7 | 无 | Sky > Moon > Moon Scale |
2.1.4.5 月相 / moonPhase¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 月相 | moonPhase | 0 - 29.53 | 0.0 | 无 | Sky > Moon > Moon Phase |
2.1.4.6 月球颜色 / moonColorA moonColorR moonColorG moonColorB¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 月球颜色 | moonColorAmoonColorRmoonColorGmoonColorB | R G B A 值 | R 0.486328, G 0.574971, B 0.864583, A 1.0 | 无 | Sky > Moon > Moon Material Color |
2.2 天气¶
2.2.1 ☁ 云 / cloud¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 云 | cloudDensity | 0 - 7.5 | 2.0 | % | Weather > Manual Weather State > Cloud Coverage |
| 云层高度 | cloudHeight | 0 - 2 | 0.6 | km | Sky > Volumetric Clouds > Bottom Altitude |
| 云层厚度 | cloudThickness | 0.1 - 2 | 1.0 | 无 | Sky > Volumetric Clouds > Layer Height Scale |
2.2.1.1 云 / cloudDensity¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 云 | cloudDensity | 0 - 7.5 | 2.0 | % | Weather > Manual Weather State > Cloud Coverage |
2.2.1.2 云层高度 / cloudHeight¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 云层高度 | cloudHeight | 0 - 2 | 0.6 | km | Sky > Volumetric Clouds > Bottom Altitude |
2.2.1.3 云层厚度 / cloudThickness¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 云层厚度 | cloudThickness | 0.1 - 2 | 1.0 | 无 | Sky > Volumetric Clouds > Layer Height Scale |
2.2.2 🌫 雾 / fogDensity¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雾 | fogDensity | 0 - 10 | 0 | m | Weather > Manual Weather State > Fog |
2.2.3 🌀 风 / wind¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 风 | windDensity | 0 - 10 | 3.0 | m/s | Weather > Manual Weather State > Wind Intensity |
| 风向 | windDirection | 0 - 360 | 180.0 | ° | Weather > Basic Controls > Wind Direction |
2.2.3.1 风 / windDensity¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 风 | windDensity | 0 - 10 | 3.0 | m/s | Weather > Manual Weather State > Wind Intensity |
2.2.3.2 风向 / windDirection¶
参数名 |
console |
参数范围 |
默认值 |
单位 |
UE5参数位置 |
|---|---|---|---|---|---|
风向 |
windDirection |
0 - 360 |
180.0 |
° |
Weather > Basic Controls > Wind Direction |
风吹来的方向。以北为0°,顺时针分为8个主要方位。 |
|||||
2.2.4 🌧 雨 / rain¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雨 | rainDensity | 0 - 10 | 0 | mm | Weather > Manual Weather State > Rain |
| 雨滴密度系数 | raindropDensity | 0 - 20000 | 2000 | 无 | Weather > Rain Particles > Max Rain Particle Spawn Rate |
| 雨滴粒子大小 | raindropParticle | 0 - 3 | 1.0 | 无 | Weather > Rain Particles > Rain Drops Scale |
2.2.4.1 雨 / rainDensity¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雨 | rainDensity | 0 - 10 | 0 | mm | Weather > Manual Weather State > Rain |
2.2.4.2 雨滴密度系数 / raindropDensity¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雨滴密度系数 | raindropDensity | 0 - 20000 | 2000 | 无 | Weather > Rain Particles > Max Rain Particle Spawn Rate |
注意
雨量大小 rainDensity = 10 时,可通过雨滴密度系数 raindropDensity 调节,实现 雨量大小 和 雨滴密度系数 相乘,得到更大雨量。
2.2.4.3 雨滴粒子大小 / raindropParticle¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雨滴粒子大小 | raindropParticle | 0 - 3 | 1.0 | 无 | Weather > Rain Particles > Rain Drops Scale |
2.2.5 ❄ 雪 / snow¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雪 | snowDensity | 0 - 10 | 0 | mm | Weather > Manual Weather State > Snow |
| 雪花密度系数 | snowflakeDensity | 0 - 30000 | 2000 | 无 | Weather > Snow Particles > Max Snow Particle Spawn Rate |
| 雪花粒子大小 | snowflakeParticle | 0 - 3 | 1.0 | 无 | Weather > Snow Particles > Snow Flakes Scale |
2.2.5.1 雪 / snowDensity¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雪 | snowDensity | 0 - 10 | 0 | mm | Weather > Manual Weather State > Snow |
2.2.5.2 雪花密度系数 / snowflakeDensity¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雪花密度系数 | snowflakeDensity | 0 - 30000 | 2000 | 无 | Weather > Snow Particles > Max Snow Particle Spawn Rate |
2.2.5.3 雪花粒子大小 / snowflakeParticle¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雪花粒子大小 | snowflakeParticle | 0 - 3 | 1.0 | 无 | Weather > Snow Particles > Snow Flakes Scale |
2.2.6 ⚡ 雷/闪电 / thunder¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雷/闪电 | thunderLightning | 0 - 10 | 0 | 无 | Weather > Manual Weather State > Thunder/Lightning |
| 闪电时间间隔 | thunderInterval | 0 - 10 | 7 | 无 | Weather > Lightning > Lightning Flash Interval (Min/Max) |
| 闪电亮度 | thunderBrightness | 1 - 25 | 14.0 | 无 | Weather > Lightning > Maximum Lightning Flash Light Intensity |
注意
使用闪电参数时,最好将时间调成晚上(18:00 以后)效果较为明显
2.2.6.1 雷/闪电 / thunderLightning¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雷/闪电 | thunderLightning | 0 - 10 | 0 | 无 | Weather > Manual Weather State > Thunder/Lightning |
控制闪电频率
2.2.6.2 闪电时间间隔 / thunderInterval¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 闪电时间间隔 | thunderInterval | 0 - 10 | 7 | 无 | Weather > Lightning > Lightning Flash Interval (Min/Max) |
2.2.6.3 闪电亮度 / thunderBrightness¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 闪电亮度 | thunderBrightness | 1 - 25 | 14.0 | 无 | Weather > Lightning > Maximum Lightning Flash Light Intensity |
2.2.7 🌪 沙尘 / dust¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 沙尘 | dustDensity | 0 - 10 | 0 | m | Weather > Manual Weather State > Dust |
| 沙尘密度系数 | dustDensityCoefficient | 0 - 3000 | 300 | 无 | Weather > Dust Particles > Max Dust Particle Spawn Rate |
| 沙尘粒子大小 | dustParticle | 0 - 3 | 1.0 | 无 | Weather > Dust Particles > Dust Particle Scale |
2.2.7.1 沙尘 / dustDensity¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 沙尘 | dustDensity | 0 - 10 | 0 | m | Weather > Manual Weather State > Dust |
2.2.7.2 沙尘密度系数 / dustDensityCoefficient¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 沙尘密度系数 | dustDensityCoefficient | 0 - 3000 | 300 | 无 | Weather > Dust Particles > Max Dust Particle Spawn Rate |
2.2.7.3 沙尘粒子大小 / dustParticle¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 沙尘粒子大小 | dustParticle | 0 - 3 | 1.0 | 无 | Weather > Dust Particles > Dust Particle Scale |
2.3 材质影响¶
2.3.1 地面摩擦系数¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 地面摩擦系数 | 0 - 1 | 1 | 无 | 自研 |
2.3.2 覆盖¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 干湿度 | groundHumidityLevel | 0 - 1 | 0 | 无 | Weather > Manual Weather State > Material Wetness |
| 雪覆盖度 | groundSnowLevel | 0 - 1 | 0 | 无 | Weather > Manual Weather State > Material Snow Coverage |
| 沙尘覆盖度 | groundDirtyLevel | 0 - 1 | 0 | 无 | Weather > Manual Weather State > Material Dust Coverage |
2.3.2.1 干湿度 / groundHumidityLevel¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 干湿度 | groundHumidityLevel | 0 - 1 | 0 | 无 | Weather > Manual Weather State > Material Wetness |
2.3.2.2 雪覆盖度 / groundSnowLevel¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 雪覆盖度 | groundSnowLevel | 0 - 1 | 0 | 无 | Weather > Manual Weather State > Material Snow Coverage |
2.3.2.3 沙尘覆盖度 / groundDirtyLevel¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 沙尘覆盖度 | groundDirtyLevel | 0 - 1 | 0 | 无 | Weather > Manual Weather State > Material Dust Coverage |
2.3.3 破损脏污¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 道路脏污度 | roadDirtyLevel | 0 - 1 | 0 | 无 | 自研 |
| 标线破损度 | lineDamageLevel | 0 - 1 | 0 | 无 | 自研 |
| 标志脏污度 | signDirtyLevel | 0 - 1 | 0 | 无 | 自研 |
| 标志破损度 | signDamageLevel | 0 - 1 | 0 | 无 | 自研 |
2.3.3.1 道路脏污度 / roadDirtyLevel¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 道路脏污度 | roadDirtyLevel | 0 - 1 | 0 | 无 | 自研 |
2.3.3.2 标线破损度 / lineDamageLevel¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 标线破损度 | lineDamageLevel | 0 - 1 | 0 | 无 | 自研 |
2.3.3.3 标志脏污度 / signDirtyLevel¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 标志脏污度 | signDirtyLevel | 0 - 1 | 0 | 无 | 自研 |
2.3.3.4 标志破损度 / signDamageLevel¶
| 参数名 | console | 参数范围 | 默认值 | 单位 | UE5参数位置 |
|---|---|---|---|---|---|
| 标志破损度 | signDamageLevel | 0 - 1 | 0 | 无 | 自研 |