组合模型加载器是城市三维场景构建器的基底图层,适用于同时查看多个模型数据。组合模型加载器支持独立的样式和数据配置,包括组合模型加载器的动画配置、样式配置和阴影设置等样式配置。本文介绍组合模型加载器配置项的含义。

在场景编辑器左侧图层列表中,单击组合模型加载器图层,进入配置面板配置组合模型加载器图层的样式和数据。
说明 如果图层列表中没有组合模型加载器,说明您还未添加组合模型加载器图层,请参见添加子组件进行添加。

配置

组合模型加载器配置面板
组合模型加载器配置页签参数说明。
参数 说明
动画配置 组合模型加载器的动画配置样式。
  • 显示骨骼:打开开关,显示模型动画骨骼样式; 关闭开关,不显示动画骨骼。
  • 启动动画:打开开关,开启动画;关闭开关,不启动动画。
  • 默认循环模式:单击下拉列表选择动画播放模式,可选重复一次反向
  • 动画速率:拖动滑块调整动画的播放速率,取值范围-1.5~1.5。仅在打开启动动画开关后可以配置。
  • 动作列表:单击右侧的加号图标垃圾桶图标图标,添加或删除一个动作系列。单击横排列图标竖排列图标图标,配置多个动作系列的排列样式。单击右侧的复制系列图标,即可复制当前选中系列并新增一个同样配置的系列动作。
    • 动作名:您可以自定义设置动作名的内容,当设置的动作名无效时会启用第一个动作。
    • 循环模式:单击下列表选择动画动作的循环模式,可选重复一次反向
    • 权重:拖动滑块调整动作的权重值,取值范围为0~1。
样式配置 组合模型加载器的样式配置。
  • 深度测试:打开开关,组件会判断模型加载器与其他三维物体相对相机的前后位置,开启深度测试会得到三维场景中正确的物体前后遮挡效果;关闭开关,不判断前后位置关系,减少计算性能开销。
  • 显示线框:打开开关,显示线框样式; 关闭开关,不显示线框样式。
  • 透明度:拖动滑块调整模型全局透明度值,取值范围为0~1。
阴影设置 设置组合模型加载器的阴影样式,通过打开或关闭发射阴影接收阴影的开关加载,控制组合模型加载器的阴影效果样式。
点击事件 设置组合模型加载器的点击事件样式。
  • 点击:打开开关,开启单击模型时触发交互事件的样式; 关闭开关,不开启单击模型触发交互事件样式。
  • 单击或双击:仅在打开点击开关时可配置模型内部件的触发交互事件点击类型,可选单击双击
  • 颜色:仅在打开点击开关时可配置模型内部件被单击后显示的颜色。
  • 交互响应区域:仅在打开点击开关时可配置模型内部件被触发交互响应的区域范围,可选局部整体
爆炸效果 设置组合模型加载器的爆炸效果样式。
  • 爆炸:打开开关,开启组合模型加载器的爆炸效果样式;关闭开关,组合模型加载器不显示爆炸样式效果。
  • 爆炸系数:拖动滑块调整爆炸效果扩散的范围值,取值范围为0~1000。爆炸系数配置项仅在打开爆炸开关后可配置。
切割效果 设置组合模型加载器的切割效果样式。
  • 切割炸:打开开关,开启组合模型加载器的切割效果样式;关闭开关,组合模型加载器不显示切割样式效果。
  • 切割面X切割面Y切割面Z:拖动滑块调整切割面X轴、Y轴和Z轴方向坐标的值,取值范围为-1~1。切割面X切割面Y切割面Z配置项仅在打开切割开关后可配置。
  • 切割面高度:拖动滑块调整切割面高度的值,取值范围为-1000~1000。切割面高度配置项仅在打开切割开关后可配置。

数据

组合模型加载器数据面板

重新选择数据:在数据页签内可以单击下方重新选择数据,打开选择范围对话框,重新选择仅针对通过默认基底数据模式创建添加的组合模型加载器图层的数据范围,详情请参见添加组件并使用官方基底数据方式选择场景范围区域中的选择场景范围区域的操作步骤。

组合模型加载器数据页签中,除了可以常规数据源配置方法外,还可通过配置空间构建数据源的方法,获取空间地图上精模建筑模型数据, 详情请参见配置空间构建数据源

表 1. 配置项说明
配置项 说明
受控模式 打开开关,资产初始化状态下不请求数据,仅通过回调ID或蓝图编辑器配置的方法发起请求数据;关闭开关,可以使用自动更新请求数据。开关默认为关闭状态。
自动更新请求 选中后可以设置动态轮询,还可以手动输入轮询的时间频次。取消选中后则不会自动更新,需要手动刷新页面,或通过蓝图编辑器和回调ID事件来触发请求更新数据。
数据源 单击配置数据源,可在设置数据源面板中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果,详情请参见配置资产数据
数据过滤器 数据过滤器提供数据结构转换、筛选和一些简单的计算功能。单击添加过滤器,可在设置数据源面板配置数据过滤器脚本,详情请参见过滤器使用说明
数据响应结果 展示数据请求的响应结果。当数据源发生改变时,可单击右侧的刷新图标 图标,实时查看数据响应结果。

蓝图编辑器交互配置

  1. 在当前场景编辑器页面,单击左侧图层列表中组合模型加载器右侧的导出到蓝图编辑器图标。
  2. 鼠标移动到页面左上角的返回图标,单击弹出对话框中的蓝图编辑器
  3. 在蓝图编辑器配置页面,单击导入节点栏内的组合模型加载器图层,在画布中可以看到如下图所示的组合模型加载器的蓝图编辑器配置参数。组合模型加载器蓝图参数
    • 事件
      事件 说明
      当模型层请求完成时 模型层数据接口请求返回并经过过滤器处理后抛出的事件,同时抛出处理后的object或array类型数据。
      当模型层请求失败时 模型层数据接口请求失败时(请求失败的情况可能是:网络问题或接口报错等)返回并经过过滤器处理后抛出的事件,同时抛出处理后的object或array类型数据。
      模型加载完成 组合模型加载器模型加载完成时抛出的事件,同时抛出object类型的数据。
      左键点击模型 当鼠标左键单击模型时抛出的事件,同时抛出object类型的数据。
      中键点击模型 当鼠标中键单击模型时抛出的事件,同时抛出object类型的数据。
      右键点击模型 当鼠标右键单击模型时抛出的事件,同时抛出object类型的数据。
    • 动作
      动作 说明
      请求模型层 重新请求服务端数据,上游数据处理节点或图层节点抛出的数据将作为参数。例如模型层配置了API数据源为http://api.test,传到请求模型层动作的数据为{ id: '1'},则最终请求接口为http://api.test?id=1
      导入模型层 按组件绘制格式处理数据后,导入组件,重新绘制。不需要重新请求服务端数据。
      更新配置 动态更新组件的样式配置。需要先在组件的配置页签中,单击复制配置到剪贴板,获取组件配置数据。再根据需要在蓝图编辑器配置页面的数据处理节点中更改对应样式的字段值。
      更新数据 动态更新组件的数据配置,同时传入object类型的数据。
      组件销毁 销毁组件,不需要参数。
      显示组件 显示组件,不需要参数。
      隐藏组件 隐藏组件,不需要参数。
      模型展开 将模型展开。参考数据示例如下。
      {
        "id": [],        //模型分组ID
        "offset": 0,     //偏移量
        "axisType": "y", //偏移方向
        "duration": 1000 //持续时间,单位为毫秒
      }
      模型分组展开 将模型分组后展开。参考数据示例如下。
      {
        "id": [],        //模型分组ID
        "offset": 0,     //偏移量
        "axisType": "y", //偏移方向
        "duration": 1000 //持续时间,单位为毫秒
      }
      材质渐变 模型材质渐变。参考数据示例如下。
      {
        "id": [],          //模型分组ID
        "duration": 1000,  //持续时间,单位为毫秒
        "options": {       //透明度颜色参数
          "color": "",     //颜色
          "opacity": 1     //透明度
        }
      }