三维自定义场景组件的光源和阴影

适用场景：安装了「FineVis数据可视化」插件的用户，可参考本文了解 FineVis 的相关功能。

1.1 版本

1.2 功能简介

V1.11.0 版本之前，在上传模型处可选择「光源」模型，给场景增加光源效果。如下图所示：

V1.11.0 版本对其进行了优化，将设置项移至「场景」属性中，并增加了阴影质量的选择，以实现更好的光源和阴影效果。如下图所示：

V4.8.0 进行了优化，「投影质量」更名为「阴影质量」，移至光源设置界面内，支持为不同光源单独配置阴影质量。同时增加了阴影强度、半透明阴影、阴影范围设置，以优化模型外轮廓丰富或大场景下的阴影呈现效果。

2.1 内置光源

在「场景>光源」处点击「添加光源」，可选择「平行光、点光、聚光」三种光源。

• 存在一个「默认平行光」，跟随「场景时间」变化而变化。

• 支持多次添加相同或不同类型的光源，但最多仅可添加三个光源。

• 光源列表中支持隐藏、编辑或删除已添加的光源。V1.13.0 及之后版本，「默认平行光」仅支持编辑，不支持删除。

• 添加光源后，场景中会出现对应光源的模型，光源模型仅在编辑界面显示，返回画布及预览模板时不显示。

如下图所示：

2.2 光源类型

2.2.1 平行光

具体设置项如下表所示：

如下图所示：

2.2.2 点光

具体设置项如下表所示：

如下图所示：

2.2.3 聚光

具体设置项如下表所示：

如下图所示：

2.3 模型包含的光源

上传自定义模型到模型库后，将模型添加到模型列表中时，若选择的模型在制作时添加有光源，那么添加时支持选择并添加光源。

例如模型：光源5_灯光层级.zip ，下载解压后将 glb 文件上传到模型库。如下图所示：

选中模型，点击「载入场景」，弹出添加光源设置框。若已经在「场景>光源」处添加有光源，则会在右侧已添加光源列表中显示，此时也支持删除已添加的光源。如下图所示：

添加的光源属于场景中的属性，同样显示在「场景>光源」列表中，在模型列表中将不显示，且删除模型，光源也不受影响。如下图所示：

2.3 阴影

新建光源默认关闭阴影功能；进入光源编辑界面后，建议调节光照强度并开启阴影，若未开启阴影，画面易缺失细节、呈现效果失真。

例如模型：主体2.zip 下载解压后将 glb 文件上传到模型库。如下图所示：

注：当存在多个光源时，开启阴影将影响性能，建议仅对主要光源开启阴影。

开启阴影后画面效果会更自然，支持设置阴影的质量、强度和阴影范围。如下图所示：

2.3.1 阴影质量

仅作用于开启阴影的光源，阴影质量越高则阴影边缘细节越清晰。

注：阴影质量越高，对性能影响越大。

2.3.2 阴影强度

阴影强度越高，阴影越明显。

默认为 1，范围为 0-1 。当设置为 0 时，关闭阴影渲染，不增加性能消耗。

2.3.3 半透明阴影

开启后，阴影会根据模型自身的透明度自适应调节，使阴影效果的呈现更细节。如下图所示：

2.3.4 阴影范围

可通过调整阴影范围（阴影渲染的视锥体区域），实现重点区域的精准阴影渲染。支持选择「自动」和「自定义」两种方式。

• 自动：根据场景中的产生阴影的网格自动计算包围盒。

• 自定义：根据当前的视锥体大小作为自定义初始参数。

注：选择自定义后，切换至自动后再次切回自定义，原自定义配置参数将保留。

选择自定义后，场景变为阴影范围编辑状态。可以看到场景中出现一个彩色包围盒，即阴影范围框，模型需要在阴影范围框内才能显示阴影。如下图所示：

开启阴影范围边缘过渡选项之后，物体的阴影会过渡的更加自然。

可在左下角控制面板取消勾选「开启」，关闭阴影范围框；勾选「位置」「方向」「大小」，可按需显示场景内的 Gizmo 工具。

注：支持通过快捷键 1/2/3/4 切换不同手柄，依次对应全选、仅显示位置、仅显示方向、仅显示大小。

• 通过 Gizmo 工具可调整阴影范围框覆盖场景大小，支持对阴影范围的六个面大小进行独立设置。如下图所示：

• 通过中心的 Gizmo 工具可对平行光源的方向和位置进行调整。

建议将阴影范围框控制在场景主体范围区域，可让视觉主体的模型细节更丰富，氛围场景部分更干净简洁，以此突出视觉主体，让整体画面视觉层次更分明。