历史版本45 :FVS三维自定义场景组件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

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

1.1 版本

报表服务器版本
插件版本功能变动
11.0.2V1.xV1.x 版本文档请参考 自定义模型组件历史版本 
11.0.16
V2.0.0
  • 组件由「自定义模型」更名为「三维自定义场景」

  • 数据图层结构变化,更便于独立设置

  • 模型管理功能优化,更便于管理上传的模型

  • 「场景>环境」添加冲击波设置上限,最多支持添加 10 个冲击波

11.0.22V2.1.1场景编辑界面模型操作能力增强,部分操作支持撤销还原。详情参见 4.4 节

1.2 应用场景

「三维自定义场景」组件支持用户生成空场景,上传 glb 格式 的模型文件,通过数据图层和事件,搭建三维自定义场景。

应用示例文档可参见:构建3D园区监控场景 。效果如下图所示:

注:不支持移动端。

1648178396196103.gif

1.3 操作步骤

本文将为大家介绍 FVS 三维自定义组件的场景设置、模型导入、视角转换等操作。

三维自定义场景的搭建,建议操作步骤如下表所示:

序号步骤简介
1模板准备新建 FVS 模板,新建页面,新增「三维自定义场景」组件,编辑组件
2创建场景生成空场景/导入已有场景
3场景管理配置三维场景的风格、环境特效、视角旋转等
4模型管理导入模型,配置模型的名称、隐藏、缩放、位置、旋转等
5数据管理添加数据图层,配置数据集,让数据和模型相结合
6视角调整调整最终预览视角效果

另外本文提供模型资源可供用户试用,请点击下载解压后使用:智慧园区监控glb资源.zip 。

1.4 视频教程

[helpvideo]3210[/helpvideo]

2. 新建组件编辑

点击设计器「文件>新建可视化看板」,创建一张空白看板。如下图所示:

Snag_50e55ca.png

点击组件区「3D>三维自定义场景」,即可将其添加到画布中,点击「编辑组件」,进入三维自定义场景编辑页面。如下图所示:

Snag_fbe8a60e.png

3. 场景管理编辑

3.1 创建场景

若首次编辑该自定义场景组件,则需要先创建场景。创建场景有两种方式:生成空场景,导入已有场景。

3.1.1 生成空场景

生成空场景,FVS 提供两种场景风格:实景风格、科技风格。默认选中实景风格,如下图所示:

1672135345468627.png

3.1.2 导入已有场景

三维自定义场景可导出使用,详情可参见 3.2 节。若用户获得了导出的三维自定义场景文件,可选择「导入已有场景」直接导入。如下图所示:

Snag_fbecab1b.png

3.2 导出场景

在场景编辑界面,用户可导出当前场景。

导出场景时,会包括场景风格、右侧「场景」配置和「模型」配置,生成 .fcust 文件。

导出的文件可参考上文 3.1.2 节,在其他三维自定义场景组件中导入使用。

Snag_2a554e86.png

3.3 设置场景属性

添加场景后,可对场景的属性进行配置,如下图所示:

图片1.png

设置项说明
整体风格

整体风格包括两种风格:实景风格、科技风格

更改整体风格将会覆盖所有已配置的样式设置

环境场景时间

通过时间体系可快速设置出满意的光照、天空等效果,可用于呈现场景跟随时间动态的过渡效果

详情请参见文档:三维自定义场景组件场景时间

天空背景

默认开启天空背景,背景选择「动态」,与场景时间配合展现

若选择背景为「静态」,可选择背景使用「天空盒」或「颜色」:

  • 天空盒:支持内置素材或自定义上传图片,自定义上传支持的贴图格式包括 jpg、jpeg 和 png

  • 颜色:支持设置单色或渐变色

注:调整场景时间时,天空背景默认恢复为「动态」设置

环境光

默认开启环境光,开启后可设置环境光的强度,范围为 0-100

注:调整场景时间时,环境光恢复为时间对应的默认值

光源

可设置场景的光源和投影效果,存在一个「默认平行光」

详情请参见文档:三维自定义场景组件的光源和投影 

注:调整场景时间时,「默认平行光」设置跟随时间变化,且恢复为时间对应的默认值

地面

可选择是否「开启地面」,开启地面后可设置地面风格,地面背景和地面特效

详情请参见文档:三维自定义场景组件地面特效

环境贴图环境贴图主要体现在「金属材质」的模型上,例如模型:材质球.zip

可选择是否「开启环境贴图」,开启后可设置环境贴图及其强度

  • 环境贴图:支持使用内置素材和自定义上传,自定义上传的贴图格式仅支持 hdr

  • 强度:支持设置环境贴图的强度,范围为 0-2

Snag_595e03e9.png

可选择是否「开启雾」,开启后可设置雾颜色、近雾距离、远雾距离

  • 近雾距离:近处的雾和镜头之间的距离

  • 远雾距离:远处的雾和镜头之间的距离

粒子可选择是否「开启粒子特效」,开启后空中会有类似雪花飞舞的效果出现
冲击波

为了突出显示某个区域,可添加冲击波,将区域设置为冲击波的中心点

支持添加、修改、删除、隐藏冲击波

支持设置冲击波的名称、坐标、辐射范围、冲击波速度、冲击波颜色等属性

最多支持添加 10 个冲击波

飞升线条可选择是否「开启飞升线条」,开启后会不断的有光柱从地面飞升至空中
相机视角

支持设置场景视角基础属性:缩放设置、垂直角度

支持开启景深、视角变化;支持添加相机视角

详情请参见文档:三维场景相机视角

漫游路径

支持添加漫游路径,设置漫游路径动画。详情请参见文档:三维场景漫游路径动画

图像抗锯齿

为了提高三维画面质量,支持开启 MSAA 和 FXAA 抗锯齿方案,支持同时开启

1)MSAA:多重采样抗锯齿,可以简单理解为只对多边形的边缘进行抗锯齿处理

2)FXAA:快速近似抗锯齿,是传统 MSAA 效应的高性能近似值,适用于性能较低的计算机配置。其原理大概是将图像柔化,所以会使得画面看起来有一些模糊

泛光

若勾选「开启泛光」,会产生从图像明亮区域边界向外延伸的光线条纹

可设置泛光的强度、阈值和模糊度

发光

若勾选「开启发光」,具有发光效果材质的模型会通过模糊叠加的方式达到发光效果 

可设置发光的强度和半径

注:发光也会对线框和溶蚀生效

饱和度

支持设置场景整体色彩的纯度,饱和度越高色彩越纯,低则逐渐变灰

调整区间为 -100~100,默认为 0

亮度支持设置场景整体的亮度,调整区间为 -100~100,默认为 0
对比度支持设置场景中明暗的对比度,调整区间为 -100~100,默认为 0

4. 模型配置与管理编辑

4.1 添加模型

模型列表中未添加模型对象时,可点击「添加模型对象」或「添加模型」进入「模型管理」页面。如下图所示:

图片2.png

4.2 模型管理

在模型管理页面,上传模型后可进行模型管理,支持删除模型、载入场景、查看模型详细信息、模型预处理等操作。

4.2.1 上传模型

仅支持上传 .glb 格式模型文件,可通过 FineVis模型库 下载通用模型使用,更多模型相关问题可参考 三维模型相关文档快速引导

点击「上传模型」,选择需要的模型文件上传即可,支持多选模型批量上传。如下图所示:

注:glb 文件名称中不得包含【】中提到的字符 【 ? ! @ # $ ^ & % * + , : ; = ' \ " ` < > () [] {} / | 空格 】 。

Snag_fc1b30d6.png

上传的模型网格数(Mesh 数)超过 3000 时,弹出提示:可能卡顿,建议精简模型。点击「查看帮助」,可查看网格数过多的影响以及如何优化网格数。

Snag_fc16948a.png

4.2.2 模型预处理

模型初次上传时,会弹出模型预处理设置框。可进行模型「数据预处理」和「风格预处理」。

若多选模型上传,会逐个弹出预处理设置框,逐个设置即可。

1)数据预处理

支持调整模型的显示层级上限,超出显示层级上限的模型数据不会在模型列表中展示,也不会触发其他交互效果。

注:数据预处理设置暂不支持撤销,不可二次修改,请谨慎操作。

例如一个模型是一个班级,班级又分为两组人,每组里面又分为 6 个单独的同学。

0 级代表模型为 1 个整体,班级不可拆分。1 级代表可点击小组。以此类推。

Snag_fc30a3ed.png

2)风格预处理

可选择是否「启用线框风格」,启用后可选择「默认线框」或「自定义线框」。风格预处理可进行二次修改,初次上传模型时可选择略过。

更多详细内容请查看文档:三维自定义场景组件线框风格

Snag_fc2f7408.png

模型上传后,鼠标悬浮模型缩略图,出现「模型预处理」按钮,点击弹出设置框。可对「风格预处理」进行修改,「数据预处理」灰化不可修改。

Snag_fcbfe41b.png

4.2.3 模型载入场景

选中一个或多个模型,点击「载入场景」,即可将模型添加到场景中。

V2.3.0 及之后版本,模型载入成功会提示「模型载入场景成功」;若有模型载入失败,会提示载入失败及失败的模型名称。

模型载入场景后,模型管理页面不会自动关闭,可继续进行模型管理操作。

1695201319461859.png

添加模型会检测当前场景的 fps(帧率),如果小于 15,则提示「检测到场景帧数较低,是否开启流畅效果」。

开启流畅效果可有效提升使用体验,但会关闭部分特效配置,被关闭的特效配置项可手动重新打开。

4.2.4 删除模型

鼠标悬浮模型模型缩略图,出现「删除」按钮,点击即可删除;或选中模型后,点击「删除模型」按钮删除,支持多选批量删除。

1695211890174260.png

若模型对象已应用于场景,点击删除时,会弹出确认删除提示:

Snag_4b9040e.png

4.2.5 模型信息

点击模型右下角「查看」按钮,可查看模型信息。如下图所示:

Snag_4bbf8f4.png

4.2.6 搜索模型

在搜索框可对模型进行模糊搜索,快速查找模型。如下图所示:

Snag_4bd4588.png

4.3 模型配置面板

选择模型载入场景后,关闭「模型管理」页面回到模型列表。选中模型列表中的模型,可配置模型相关属性。

按照上传模型时设置的显示层级,可选中模型或模型中的部分子模型,对其属性进行单独配置,不会影响其他部分的模型。

1695213412314528.png

各属性设置项详细说明如下表所示:

注:若添加的模型在中间展示区未显示,可能是因为模型太大, 需要将视角拉远/模型缩放后才能正常显示。

属性
简介
模型动画管理若模型中存在动画效果,可以通过右上角「模型动画管理」添加动画方案,显示动画效果
隐藏点击模型列表对应模型前的「隐藏」按钮,可控制模型的显示或隐藏
聚焦点击模型列表对应模型的「聚焦」按钮,可切换到该模型的默认视角
复制

点击模型列表对应模型的「复制」按钮,可复制该模型及模型的相关属性

重命名

点击模型列表对应模型的「重命名」按钮,可直接在列表中重命名

同一层级的模型不支持重名

删除点击模型列表对应模型的「删除」按钮,可删除该模型
注:模型删除后不支持撤销删除操作,请谨慎删除
名称

选中模型后,可自定义模型名称,与列表中「重命名」功能一致

缩放

支持设置模型长宽高的缩放比例

若勾选「固定比例」,长宽高同时等比缩放,默认勾选

位置调整模型在组件中的位置,可通过调整为负值实现翻转、镜像等效果
旋转调整模型的展示视角
风格

可选择模型展示风格为「默认」或「线框风格」

动画

用于添加线框变化动画片段,详情可参考文档:三维自定义场景组件线框风格 

反射

模型整体可设置是否开启环境反射,开启时模型在地面上会有倒影。默认不勾选

注:开启反射可实现较好的效果,但同时会消耗更多性能,若明显卡顿建议关闭反射

注:风格、动画、反射 仅选中模型整体时支持配置,子层级模型不支持

在模型列表中,选中模型,鼠标右键可键出操作菜单,支持复制、删除及显示隐藏模型。

Snag_4963c54f.png

4.4 场景中模型相关操作

4.4.1 选中模型

在模型列表和场景编辑界面均支持选中模型,被选中的模型高亮。

  • 模型列表:点击即可选中模型对象;按住 ctrl,使用鼠标左键点选可实现多选/减选;按住 shift ,使用鼠标左键可实现连选。

  • 场景编辑界面:点击模型对象即可选中;按住 shift ,使用鼠标左键框选可实现多选模型对象。

    注:仅支持选中 mesh 。

  • 点击非模型外的区域或上方工具栏的「取消选中」按钮,即可取消选中。

注:支持单独选中子层级对象进行操作,但选中父层级对象时,可操作对象包含子层级对象。

3593501B-1CF8-467E-973E-6AD48640F02F.GIF

4.4.2 移动、旋转和缩放模型

选中模型对象后,出现 Gizmo 工具,操作 Gizmo 即可调整模型对象位置、旋转和缩放效果。

1)移动 Gizmo:

  • 鼠标悬浮 X、Y、Z 轴的顶端箭头,箭头变色后,拖动箭头即可在对应方向上移动模型位置。

  • 拖动坐标系中间的方形区域,可在 XZ 轴平面随意移动模型位置。

955536F9-F8ED-4B96-877B-ADCE1E294DD7.GIF

2)旋转 Gizmo:鼠标悬浮圆圈,圆圈变色后,移动鼠标即可改变旋转角度。

4ED328D0-E2F2-4701-BCFA-AFFFEEBFBCC0.GIF

3)缩放 Gizmo:鼠标悬浮 X、Y、Z 轴直线上的小方块,方块变色后,拖动方块即可改变对应方向上的缩放比例。

右侧属性面板中的「缩放」勾选了「固定比例」,则 X、Y、Z 轴同时等比缩放

56DB7AB1-F87A-4AE5-89C5-C4BBEE67ECBB.GIF

4.4.3 复制粘贴模型

在模型列表或场景中选中模型后,即可复制粘贴模型。

  • 支持使用快捷键 Ctrl+C/V 进行复制/粘贴;也支持在场景中,单击鼠标右键,键出复制选项,点击即可复制并粘贴。

注:V2.4.0 版本取消右键粘贴选项,点击复制后直接复制并粘贴。

  • 复制粘贴后,默认选中粘贴的模型,粘贴的模型展示在原模型相同位置,需手动移动位置。

2CB9CED6-CC43-44E6-BD71-0FC3427FF665.GIF

4.4.4 撤销还原

撤销和还原仅对 移动、旋转和缩放模型 生效。

  • 可通过顶部工具栏按钮撤销或还原,也支持快捷键操作。ctrl+Z 为撤销,shift+ctrl+Z 为还原。

  • 退出场景再进入,不记忆上次操作,需重新操作后才能撤销或还原。

75E7BDC7-83DA-4B9C-AD26-CEA71F11A14D.GIF

5. 数据图层编辑

三维自定义场景组件中仅支持添加模型数据图层。

添加数据图层并绑定数据后,支持为图层添加「数据更新后」和「单击鼠标左键」事件,实现模型数据展示、联动交互等效果。

功能详细介绍请参见文档:三维场景组件数据图层 。

Snag_fcfb7f33.png

V2.2.1 及之后版本,配置了数据图层的自定义模型,在预览时,鼠标悬浮有轮廓高亮效果。如下图所示:

3C49E65F-014C-4675-901D-4A010909C6E0.GIF

6. 工具栏编辑

V2.2.0 版本工具栏优化,固定在场景顶部显示。工具栏具体介绍如下表所示:

设置项说明
Snag_1ac36575.png点击返回可视化看板画布界面
Snag_1ac55eb5.png开启流畅渲染后,可提升场景编辑性能。详情请参见:三维场景流畅渲染模式
Snag_1ac3e17b.png一键查看场景顶视图、主视图、侧视图
Snag_1ac60f67.png选中模型后,点击可取消选中
Snag_1ac44b60.png

「撤销」和「还原」操作,仅对自定义模型的移动、旋转和缩放操作生效

Snag_1ac46c56.png场景视角调整的操作说明,以及「自定义模型位置调整」和「模型多选」操作说明