聚合热力

聚合热力是一种用于在三维场景中展示数据密度和分布的标绘节点，通过颜色渐变和高度变化来直观地表现数据的聚合程度和热力分布。

在聚合热力节点的各配置用以配置通用的聚合热力样式模板，所有子元素都会应用该样式。不同子元素之间不会有聚合效应。

在 图层面板 中 聚合热力节点 下会根据当前的子元素数据展示对应的子元素节点，可点击对应子元素节点修改子元素的名称、点位数据等信息。

属性

基础

• 名称： 节点的名称。

• 位置： 子元素的原点三维位置，修改后所有子实例的三维位置都会相对其变化。单位为 米。

热力配置

• 半径： 设置热力点影响的半径范围，控制单个数据点的影响区域大小。单位为 米。

• 模糊因子： 设置热力图的模糊程度，数值越大颜色渐变过渡效果越平滑。

• 热力范围： 设置热力值的范围，包含最小值（min）和最大值（max），用于控制颜色映射的数据区间。

• 颜色渐变： 配置热力图的颜色渐变效果，从低热力值到高热力值的颜色映射对应颜色渐变的从左到右。

热力网格

• 最大高度： 设置热力图网格的最大高度值，控制数据峰值的显示高度。

• 线框模式： 控制是否启用线框模式显示，启用后热力图将以线框形式展示。

• 细分数量： 设置热力图网格的细分密度，数值越大网格越精细。细分越多锯齿现象也越少，但无法完全避免。

  提示

  细分数量越大对渲染的效率影响也越大。

自定义属性

可根据实际需求，为节点添加自定义属性。可通过配置 自定义数据 添加节点的自定义静态数据，进而与外部进行业务与数据的交互。

例如场景的楼宇模型中有多个摄像头模型，给摄像头模型配置对应的视频流 ID，在外部监听场景的点击事件，可获取到点击的摄像头配置的视频流 ID 播放对应的摄像头视频，实现点击摄像头播放对应视频的功能。

• 自定义属性列表： 点击右侧的 + 号图标或面板底部的 添加属性 按钮，均可在列表末尾添加一个新的自定义属性。

  • 名称： 自定义属性字段名。

  • 字段值类型： 字段值支持三种类型 字符、 数值、 布尔 。

子元素

子元素用于管理多个实例，每个子元素可以设置名称和点位数据等。

• 名称： 子元素的名称。

• 点位列表： 子元素线路的热力点列表。

  • 位置： 热力点的三维位置，单位为 米。

  • 热力值： 该点位的热力值。

自定义属性值

在根节点添加 自定义属性 后，可在子元素的热力点位上配置 自定义属性 的值。自定义属性的数据将会以键值对的形式在子元素的点位数据中提供。

状态

支持配置多个节点状态，可切换不同状态展示不同效果。

• 初始状态： 用于设置节点的默认状态，切换状态可在 3D 场景编辑器内查看到节点的实时效果。

• 状态列表： 可添加多个节点状态。

  • ID： 当前状态的唯一标识，可通过 ID 值切换当前节点状态。

  • 名称： 当前状态的名称。

编辑模式

激活 当前节点 或 子元素节点 时，场景窗口下方会出现操作栏。

在激活 当前节点 时，编辑的是新的子元素的点位数据，而激活的是 子元素节点 时编辑的是该子元素的点位数据。

编辑

点击 编辑 按钮，进入 编辑模式。

在 编辑模式 下：

• 点击 鼠标左键 会添加一个位置为鼠标位置映射在地面的三维坐标的热力点，并提供一个默认的热力值。

• 点击 鼠标右键 会移除上一个热力点位。

取消

在 编辑模式下，点击 取消 按钮，热力点位素数据会恢复到进入 编辑模式 前的状态，并退出 编辑模式。

完成

在 编辑模式 下，点击 完成 按钮，会保存当前编辑后的热力点位数据，并退出 编辑模式。

提示

在 编辑模式 下切换到其他节点时，会自动退出 编辑模式，并将热力点位数据恢复到进入 编辑模式 前的状态。