虚幻引擎5文档已被迁移至 Epic开发者社区

在某些情况下，太阳在天空中的位置并不是根据美学效果而选择的。相反，它是一个关键的设计因素。

在大型架构与构造项目中往往也是如此，而且在任何需要生成逼真的渲染图来反映真实的阳光和阴影模式时，也可能如此。

在这些情况下，你需要能够根据与用于控制太阳在地球真实天空中的位置的相同数学方程，将太阳精确地放置在虚幻引擎关卡中。这些复杂的方程包含许多设置，包括观察者在地球上的地理位置、日期和时间。

太阳位置计算器（Sun Position Calculator） 插件可以在虚幻引擎中求解这些数学方程。你可以定义纬度、经度、基点、日期和时间。然后，太阳位置计算器与虚幻引擎中的默认天空球协同工作，将日轮放置在天空球中，并确定关卡中主定向光源的方向。

入门指南

开始操作：

1. 从主菜单选择 编辑（Edit）> 插件（Plugins） 。

2. 在 杂项（Misc） 类目下找到 太阳位置计算器（Sun Position Calculator） 插件，并选中其 启用（Enabled） 复选框。
   

3. 单击 立即重启（Restart Now） 以应用更改并重新打开虚幻编辑器。
   

4. 在 内容浏览器（Content Browser） 中，打开 源（Sources） 面板。
   

5. 在 内容浏览器（Content Browser） 的右下方打开 查看选项（View Options） 菜单，并启用 显示引擎内容（Show Engine Content） 和 显示插件内容（Show Plugin Content） 。
   

6. 在 太阳位置内容（SunPosition Content） 文件夹中找到 BP_SunPosition 资产，并将其拖至视口中。
   它由一个看起来像指南针的基点的小工具表示。（该小工具只出现在虚幻编辑器中，运行项目时不出现。）

7. 在视口中选择该小工具，或者在 世界大纲视图（World Outliner） 中选择 BP_SunPosition Actor。
   

8. 在 细节（Details） 面板中，设置控制太阳位置的场景属性。
   
   

   设置	说明
   纬度（Latitude）	对赤道以南的坐标使用负值，对赤道以北的坐标使用正值。
   经度（Longitude）	对子午线以西的坐标使用负值，对子午线以东的坐标使用正值。
   时区（Time Zone）	设置该值以指示场景与世界协调时（UTC）或格林威治标准时间（GMT）偏差的小时数。
   北偏移（North Offset）	控制关卡中的对象与指南针的基点之间的关联。改变该控件还将旋转 BP_SunPosition 小工具在关卡中的可视位置。调整该值，直到该小工具上显示的基点相对于关卡中的对象正确定向为止。 不要使用旋转工具在关卡视口中旋转该小工具本身。仅使用该北偏移（North Offset）设置来控制基点。
   日期（Date） 和 时间（Time）	设置想要模拟的一年中的时间和一天中的时间。

当你更改了这些属性的值时，应该会在虚幻编辑器中看到太阳在天空中移动，阴影也发生了改变。

在运行时修改设置

你可以在运行时更改 BP_SunPosition Actor的设置。这允许你基于UI空间或其他Gameplay事件驱动太阳的位置和光线角度。

1. 为了能够在运行时改变阳光的角度，你需要将关卡中的定向光源设置为可移动（Movable）。在 世界大纲视图（World Outliner） 或关卡视口中选择定向光源，在 细节（Details） 面板中找到 移动性（Mobility） 设置，并将其设置为 可移动（Movable） 。
   

2. 当你想要在运行时修改蓝图脚本中的一个值时，需要一个指向关卡中包含的 BP_SunPosition Actor 的对象引用。你可以使用 获取类的所有Actor（Get All Actors of Class） 节点来动态检索它，如下所示：
   
   

   由于 获取类的所有Actor（Get All Actors of Class） 开销较高，所以最好只执行一次（例如在加载关卡或构造控件时），并将结果保存到变量中，而不是每次需要获取或设置值时都执行一次。

3. 有了对象引用后，从其输出端口向右拖动，展开 变量（Variables） 类别以找到 获取（Get） 和 设置（Set） 节点的列表，你可以使用该列表来检索和设置在虚幻编辑器的 细节（Details） 面板中公开的相同值。
   

4. 将所需的值设置为新的值。完成后，从 BP_SunPosition 变量的输出端口向右拖动，并调用其 更新太阳（Update Sun） 节点。
   

例如，下面来自控件蓝图的一个片段设置了一个UI滑条，该滑条可将小时更改为早上6点到晚上10点之间的任意值。

在操作中，该滑动条是这样的：