JSAPI Three API Reference
    正在准备搜索索引...

    类 Tiles3DFlatten

    3DTiles 区域压平配置,支持多边形、圆形和矩形区域;重叠部分使用数组中靠后的区域高度。 将实例赋给瓦片集的 tiles3DFlatten,并设置 enableFlatten = true 后启用。 同一实例不能同时绑定多个瓦片集。

    区域坐标使用经纬度。平面地图的高度为投影空间的 Z 值;地球模式的高度为 所有区域控制点中心处局部 ENU 坐标系的 Z 值,单位均为米。 地球模式形成局部平面,不是处处等海拔的曲面。

    索引

    构造函数

    方法

    访问器

    构造函数

    • 参数

      • 可选options: { enabled?: boolean; height?: number; regions?: any[] } = {}

        压平配置

        • 可选enabled?: boolean

          是否启用,还需瓦片集的 enableFlatten 为 true

        • 可选height?: number

          未单独指定高度的区域所使用的默认高度,须为有限数值

        • 可选regions?: any[]

          压平区域,格式见 regions

      返回 Tiles3DFlatten

    方法

    • 释放压平纹理及网格相关资源,并解除与瓦片集的关联。

      返回 void

    • 查询坐标所在区域的压平高度,重叠时以靠后的区域为准。

      参数

      • coordinate: number[]

        经纬度坐标 [lng, lat]

      返回 number

      压平高度;未关联有效地图、未启用压平或未命中区域时返回 null

    访问器

    • get enabled(): boolean

      是否启用压平,默认 true。赋值后更新已关联网格并请求重绘,无需调用 build()。 瓦片集的 enableFlatten 也须为 true。

      返回 boolean

    • get height(): number

      默认压平高度,初始值为 0,单位为米;坐标含义见类说明。 赋值后自动更新未单独指定 height 的区域,已有独立高度的区域不受影响。 非有限数值会被忽略并输出警告。

      返回 number

    • get regions(): any[]

      压平区域数组,默认空数组。每项支持以下格式,height 均可省略以继承默认高度:

      • polygon:{type: 'polygon', area: [[lng, lat], ...], height}。 area 长度为 3 至 20,允许首尾闭合,不支持自交、孔洞及零面积多边形。
      • circle:{type: 'circle', center: [lng, lat], radius, height}。 radius 为压平坐标系中的半径,单位为米,须大于 0。
      • rect:{type: 'rect', bounds: [[lng1, lat1], [lng2, lat2]], height}。 bounds 为两个对角点,经度和纬度均须不同。

      读取返回副本;编辑后须重新赋值才生效。赋值自动更新已关联网格,无需调用 build()。 若任一区域无效,会保留原数组并输出警告;赋空数组可清除全部区域。

      返回 any[]