三维城市父组件
三维城市父组件
【3维城市】父组件是搭建整个三维城市场景的入口，在三维城市父组件上可以添加相关子组件完成三维城市场景的搭建。三维城市父组件初始化如下。
子组件管理
点击右侧菜单上方的子组件管理 “+” 按钮，可以看见三维城市父组件附带的所有子组件，我们可以点击选择多个子组件，并点击 “添加子组件” 按钮添加到子组件列表中。
如下图，将鼠标悬浮在子组件列表的某一项中，可以看见该子组件所对应的所有功能按钮。下列表格 将详细介绍这些功能按钮所对应的功能。
| 序号 | 按钮图标 | 功能介绍 |
|---|---|---|
| 1 |  | 在三维场景中显示/隐藏该子组件 |
| 2 |  | 将该子组件导入/导出蓝图编辑器 |
| 3 |  | 在三维场景(画布)中定位该子组件 |
| 4 |  | 在蓝图编辑器中定位该子组件 |
| 5 |  | 复制该子组件，新复制的子组件会加入子组件列表尾部 |
| 6 |  | 重命名该子组件 |
| 7 |  | 在子组件列表中删除该子组件 |
| 8 |  | 子组件排序，点击长按上下拖动排序 |
基础属性
| 序号 | 设置项 | 设置项描述 |
|---|---|---|
| 1 | 图表宽度 | 三维城市画布容器宽度，单位px像素 |
| 2 | 图表高度 | 三维城市画布容器高度，单位px像素 |
| 3 | 横坐标 | 三维城市画布容器在画布上的横坐标，单位px像素 |
| 4 | 纵坐标 | 三维城市画布容器在画布上的纵坐标，单位px像素 |
| 5 | 旋转角度 | 以组件的中心为中心点，进行旋转，单位为度（°） |
| 6 | 透明度 | 取值范围为0~1。为0时，图表隐藏；为1时，图表全部显示。默认为1 |
场景配置
配置渲染三维城市所需要EarthSDK在线资源地址，默认关闭，一般也不需要去修改，除非需要升级SDK版本。
天气设置
整个三维城市场景的天气设置，默认都是关闭的。
大气
| 序号 | 设置项 | 取值范围 |
|---|---|---|
| 1 | 亮度偏移 | [-1, 1] |
| 2 | 色调偏移 | [0, 1] |
| 3 | 饱和度偏移 | [-1, 1] |
信息
大气设置的效果需要将整个三维场景放大到地球级别时才能看见明显效果。
雾
| 序号 | 设置项 | 取值范围 |
|---|---|---|
| 1 | 密度 | [0.00002, 0.002] |
| 2 | 最小亮度 | [0, 1] |
信息
雾设置的效果需要将整个三维场景放大到地球级别时才能看见明显效果。
雨
点击天气-雨的开启按钮时，三维城市场景的天气将变为雨天。
雪
点击天气-雪的开启按钮时，三维城市场景天气将变为雪天。还支持积雪程度的设置，取值范围为[0, 1]。
控件设置
-
开关交互拾取从操作：开启/关闭场景交换拾取操作功能，所谓交互拾取操作，就是能通过鼠标来获取场景中添加进来的覆盖物，如模型、建筑、图标点等。覆盖物的点击操作需要开启此功能。
-
开关地图比例尺: 如下图
-
开关指北针：如下图
蓝图编辑器
事件
- 当地球加载完成时： 当场景地球加载完成时，会抛出一个加载完成状态的数据，可以用于整个三维场景交互的起步操作。
- 实时抛出相机高度：当场景的相机高度发生改变时，就会抛出当前相机高度数据，可以用来与某个临界值做比较，当相机高度大于临界值时触发某些的子组件的相关动作。
动作
- 开关交互拾取操作： 需要传入布尔值。示例数据如下
{
"state": false // true为开启，false为关闭
}