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

目录:

1. 概述编辑

适用场景:安装了「FVS大屏编辑模式」插件的用户,可参考本文了解 FVS 模板的相关功能。

注:不支持移动端。

1.1 版本

报表服务器版本
插件版本功能变动
11.0.9V1.13.0

新增:「场景>环境」属性新增 场景时间 设置项,天空背景、环境光和光源设置项均配合场景时间优化设置。详情请参见 3.3 节

新增:「场景>图像」属性新增「发光」设置项。详情参见 3.3 节

查看历史版本更新
报表服务器版本
插件版本功能变动
11.0.2V1.2.0-
11.0.5V1.4.0

优化:数据图层中,标签可设置多个字段,并支持富文本自定义标签内容。详情参见 5.1、5.2 节

新增:数据图层新增「数据预警」,可设置模型预警条件、模型预警内容及标签。详情参见 5.3 节

11.0.6V1.5.0新增:三维场景属性中,新增相机景深效果,新增三维图像处理功能。详情参见 3.3 节
11.0.6V1.5.1

新增:模型支持复制,相同模型无需重复添加操作。详情参见 4.3 节

优化:模型选中时,不再自动切换视角,可通过点击新增的「聚焦」按钮切换视角。详情参见 4.4 节

11.0.6V1.6.0优化:为了避免自定义模型组件卡顿崩溃,限制上传模型的网格数(Mesh 数)不能超过 3000。详情参见 4.1.1 节
11.0.6V1.6.1

优化:模型复制逻辑优化,复制时,可复制原模型已设置的相关属性。详情参见 4.3 节

优化:模型选中时的位移工具新增旋转、缩放效果。详情参见 4.4 节

11.0.6V1.7.0

新增:上传模型时新增风格预处理功能,可启用线框风格,提升科技感氛围。详情参见 4.1.2 节

优化:上传模型的网格数限制优化,支持上传成功,但仍弹出强提示。详情参见 4.1.1 节

11.0.9V1.9.0优化:场景属性配置面板交互优化。详情参见 3.3 节
11.0.9V1.11.0

优化:对自定义模型场景属性进行优化,提升三维场景效果。详情参见 3.3 节

11.0.9V1.11.1新增:「场景>图像」属性新增饱和度、亮度、对比度设置。详情参见 3.3 节
11.0.9V1.12.0优化:模型编辑界面支持直接点击模型进行选中。详情参见 4.4 节

1.2 应用场景

「自定义模型」组件无需依托于三维城市组件,支持用户生成空场景,上传 glb 格式的自定义模型,通过组件事件和数据图层,实现独立的三维模型效果。

注:关于 glb 文件说明请参见 glb格式说明 。

应用示例文档请参见:构建3D园区监控场景 。模型资源请点击下载:智慧园区监控glb资源.zip 。

效果如下图所示:

1648178396196103.gif

2. 新建组件编辑

新建一个 FVS 大屏模板:

新增一个「自定义模型」组件,点击「编辑组件」,进入自定义模型编辑页面。如下图所示:

Snag_4f176177.png

3. 场景管理编辑

3.1 创建场景

若首次编辑该自定义模型组件,则需要先创建场景。

创建场景有两种方式:生成空场景,导入已有场景。

3.1.1 生成空场景

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

注:V1.11.0 版本之前是科技网格风格、科技丰巢风格和拟真风格,V1.11.0 版本对其进行了整合优化。

Snag_4f1ba708.png

3.1.2 导入已有场景

若用户获得了他人给与的 .scene/.fcust 文件类型的自定义模型场景,用户在此步骤可直接导入。如下图所示:

1641280125jsZh.png

3.2 导出场景

在自定义模型编辑界面,用户可导出当前场景。

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

注:V1.3.0 之前的版本导出场景为 .scene 文件格式。

导出的文件可参考上文 3.1.2 节,在其他自定义模型组件导入使用。

Snag_4f1d77c1.png

3.3 设置场景属性

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

1673514772596691.png

注:V1.11.0 版本对场景属性做了大量优化,旧版本插件文档可参考 V1.11.0 版本之前的自定义模型组件 。

设置项说明
整体风格

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

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

环境场景时间

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

详情请参见文档:FVS自定义模型组件场景时间

天空背景

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

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

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

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

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

环境光

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

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

光源

可设置场景的光源和投影效果,存在一个「默认平行光」。详情请参见文档:FVS自定义模型组件的光源和投影 

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

地面

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

详情请参见文档:自定义模型地面特效

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

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

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

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

Snag_595e03e9.png

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

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

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

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

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

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

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

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

若勾选「开启景深效果」,可实现焦点距离范围内清晰,范围外模糊的效果

可设置对焦距离、光圈系数和模糊半径

1)对焦距离:指焦点物体对相机的距离,可设置为「动态」或「固定」

  • 动态:永远以当前视角的中心物体为对焦对象,自动计算对焦距离

  • 固定:可设置固定对焦距离。可以一键获取当前自动对焦的距离

2)光圈系数:指相机的光圈系数,可以控制景深的深浅,值越小,景深越浅,清晰的部分越少。可设置范围为 0.1~40

3)模糊半径:指景深的模糊半径效果,即画面模糊程度,可设置为低,中,高

视角

若勾选「开启视角变化」,可自动 360° 旋转三维模型的效果,可以调整视角旋转的速度

开启此功能,不影响用户鼠标调整模型视角

图像抗锯齿

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

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

2)FXAA:快速近似抗锯齿,是传统 MSAA 效应的高性能近似值,适用于性能较低的计算机配置

泛光

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

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

发光

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

可设置发光的强度和半径

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

注2:旧版本模板打开时,默认勾选「开启发光」

饱和度

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

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

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

4. 模型管理编辑

4.1 上传自定义模型

4.1.1 上传新模型

首先用户需要通过建模软件生成 .glb 格式的自定义模型。

在组件编辑界面,点击右侧配置栏的「模型>添加模型对象>自定义模型」,点击「上传新模型」,选择本地准备好的 .glb 文件类型的自定义模型,即可上传到模板中。

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

1641364920GFN1.png

为了避免自定义模型在使用时过于卡顿甚至崩溃,V1.6.0 版本的插件新增上传限制,限制上传的模型网格数(Mesh 数)不能超过 3000 。否则提示上传失败,请精简后重新上传。

但此限制阻断用户使用影响较大,V1.7.0 版本插件优化该限制,可成功上传,但仍弹出强提示,建议精简模型。

点击「查看帮助」,可查看网格数过多的影响以及如何优化网格数。如下图所示:

Snag_4ae71bc2.png

4.1.2 模型预处理

1)数据预处理

支持调整模型的显示层级。默认层级上限为 2。

上传模型时设置的显示层级不可撤销,适用于所有使用该自定义模型的组件。

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

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

Snag_37420374.png

2)风格预处理

V1.7.0 版本新增功能,可选择是否「启用线框风格」,启用后可选择「默认线框」或「自定义线框」。

更多内容请查看文档:FVS自定义模型线框风格

Snag_37444769.png

4.2 添加自定义模型

选择配置栏「模型>添加模型对象>自定义模型」,选中上传的任意一个模型,点击「完成」,模型即被添加到「模型列表>自定义模型」处,如下图所示:

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

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

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

4.3 模型配置

选中模型列表中的自定义模型,支持配置相关模型属性。

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

Snag_1e65d6a2.png

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

属性
简介
模型动画管理若模型中存在动画效果,可以通过右上角「模型动画管理」添加动画方案,显示动画效果
隐藏点击模型列表对应模型前的「隐藏」按钮,可控制模型的显示或隐藏
聚焦点击模型列表对应模型的「聚焦」按钮,可切换到该模型的视角
注:仅支持 V1.5.1 版本及之后的插件
复制

点击模型列表对应模型的「复制」按钮,可复制该模型

注:仅支持 V1.5.1 版本及之后的插件

V1.6.1 版本之前复制的新模型不继承原模型的属性,需重新设置缩放、位置、旋转等

V1.6.1 版本及之后的插件,复制的新模型将一同复制原模型的相关属性
重命名点击模型列表对应模型的「重命名」按钮,可直接在列表中重命名,不支持重名
删除点击模型列表对应模型的「重删除」按钮,可删除该模型
注:模型删除后不支持撤销删除操作,请谨慎删除
名称选中模型后,可自定义命名模型名称
缩放

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

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

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

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

注:仅支持 V1.7.0 版本及之后的插件

动画

启用了线框风格的模型,可添加线框变化动画片段

注:仅支持 V1.7.0 版本及之后的插件

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

4.4 模型选中和移动

1)V1.12.0 版本之前,仅支持从右侧模型列表选中模型,V1.12.1 及之后版本,支持直接点击模型选中,列表中被选中的模型高亮。点击非模型外的区域或上方工具栏的「取消选中」按钮,即可取消选中模型。

注:仅支持选中 mesh 。

2)在模型列表点击模型名称右侧的「聚焦」按钮,则可切换视角。不支持直接选中编辑界面中的模型。

注:V1.5.1 版本之前的插件中,选中模型就会自动切换到该模型的视角。

3)选中模型后,会出现位移工具,拖动位移工具即可调整模型位置。V1.6.1 版本及之后的插件,位移工具新增旋转和缩放效果。

  • 拉动 X、Y、Z 轴的顶端箭头,可移动模型位置

  • 拉动 X、Y、Z 轴直线上的小方块,可改变缩放比例,右侧属性面板中的「缩放」值随之变化

  • 鼠标悬浮圆圈,移动鼠标可改变旋转角度,右侧属性面板中的旋转角度随之变化

操作演示如下所示:

[helpvideo]4078[/helpvideo]

5. 数据图层编辑

5.1 数据图层-数据集

1)在绑定数据前,必须确保数据集中的模型名称与 4.3 节模型配置中的模型名称是一致的,这样才能正常匹配并显示。

注:选中模型时,不能看见模型内容的对象,是一个空对象,不支持匹配数据。

Snag_1918a029.png

2)自 V1.4.0 版本起,模型内容支持绑定多个字段。如下图所示:

Snag_191318f0.png

5.2 数据图层-标签

1)内容

标签显示的内容默认为绑定的模型名称和模型内容,取消勾选则不显示。点击右侧「格式」可设置数据显示的格式类型。如下图所示:

Snag_155adcb9.png

自 V1.4.0 版本起,标签内容还支持以富文本的形式编辑自定义内容,可选择数据字段,也可直接输入文本。如下图所示:

Snag_155c81dd.png

2)字符缩放

可设置标签内容字符缩放的比例,范围为 1-10。点击右侧 Snag_14b9f9d5.png 按钮可设置标签内容的文字颜色。效果如下图所示:

Snag_155dd373.png

3)色相

通过滑动色相值,可改变标签背景的颜色。效果如下图所示:

Snag_155e7745.png

4)显示形式

「始终显示」时标签则一直显示于界面,「悬浮显示」时,则在预览模板时鼠标悬浮才显示标签。

5.3 数据图层-数据预警

自 V1.4.0 版本起,数据图层中新增数据预警设置,可添加多个数据预警,实现满足某个条件时,显示不同的预警内容。

添加预警后,可控制预警的开启与关闭。如下图所示:

注:当设置了多个条件,但条件存在冲突时,以下方的条件为准。

Snag_14da0a25.png

1)点击「添加数据预警」,弹出设置框。输入预警名称后,点击「添加条件」才可编辑条件。

Snag_101e9fa6.png

2)在选中一个条件的情况下,才能编辑该条件的内容。

预警对象可选择该数据图层绑定的名称或内容;预警条件的值可设置为自定义内容,自定义公式或字段。

如下图所示:

Snag_1561713b.png

3)当需要同时满足多个条件时,可通过连接线上的按钮 Snag_14f52173.png 新增条件,在条件连接线上选择条件之间的关系为「且」还是「或」。如下图所示:

690BFFB4-9037-4374-9797-8D9F45C8349B.GIF

注:初始条件默认自带关系属性为「且」,连接线上的关系属性绑定的是第二个条件,选中并移动条件时,其属性「且/或」会根据条件产生变化。

例如设置「条件1 或 条件2」,如下图所示:

Snag_10417f14.png

将 条件1 下移,会变成「条件2 且 条件1」。如下图所示:

Snag_1042d935.png

4)鼠标悬浮在某条件上时,出现按钮「+组合条件」,表示可以给当前条件再添加子条件。

添加的组合条件前的 icon 可以收起或展开,收起时表现为一个组合条件,展开时表现为子条件树。如下图所示:

81625C73-459F-406C-AD53-8C1A7A23D882.GIF

5)条件操作项说明如下表所示:

条件操作
说明
上移当选中的条件上方有条件时,可上移该条件
下移当选中的条件下方有条件时,可下移该条件
+()添加
当按住 shift 多选超过两个条件时,可添加括号,使其变成一个组合条件
-()去除当选中一个组合条件时,可去除括号,使其变成两个条件
删除选中条件后可删除条件,支持 shift 多选删除

6)预警内容:预警内容包含「预警标签」和「预警样式」设置项。默认均为红色。如下图所示:

注:符合预警条件的数据,预警标签内容会取代原标签内容。

Snag_6118be1c.png

6. 视角调整编辑

6.1 操作说明

自定义模型组件预定义了三个视角,可一键调整:顶视图、主视图、侧视图。

鼠标左键、右键、滚轮均可用于视角调整。点击编辑界面左上角的「操作说明」弹出对应操作演示。

1)鼠标左键:按住鼠标左键拖动,可旋转当前视角。

2)鼠标右键:按住鼠标右键拖动,可平移/拉升/降低视角。

3)鼠标滚轮:滚动鼠标滚轮,可放大/缩小视角。

Snag_1549ba4f.png

6.2 调整视角的方法

支持两种方式手动调整场景视角。

6.2.1 在画布界面调整

在画布页面,选中组件,点击右上角「视角调整」按钮,即可在组件区域内使用鼠标调整视角,按钮变为「完成」按钮。

调整完成后,鼠标点击右上角「完成」按钮,或点击组件外任意区域,即可保存最终视角。

注:V1.11.1 版本之前的组件只能通过点击组件外区域保存调整后的视角。

48B6E38F-CB52-472F-8865-C0BD2A55D24E.GIF

6.2.2 在模型编辑界面调整

用户在自定义模型编辑页面,通过鼠标可直接调整模型的显示视角,点击「返回大屏编辑器」,即可自动保存最终视角。如下图所示:

945CE2CF-8493-4F55-9411-2AE26E49234C.GIF

7. 注意事项编辑

7.1 数据图层对点击事件的影响

自定义模型组件配置「交互>点击事件」时,是按照模型的层级去触发的,数据图层匹配到了哪一层数据,点击事件就作用于哪一层模型。

例如上传模型时设置层级为 2,配置数据图层时,同时添加了层级 0 和层级 1 的数据图层。如下图所示:

Snag_2dd546.png

则在自定义模型组件「交互>点击事件」中,层级 1 的点击事件生效,层级 0 的点击事件不生效。如下图所示:

Snag_30fc38.png