Class: Cesium3DTilesCacheLayer

Cesium3DTilesCacheLayer

new Cesium3DTilesCacheLayer(options)

document/layer/Cesium3DTilesCacheLayer.js, line 8

Cesium 3D Tiles 模型缓存图层。

该图层用于加载 IGS 发布的 3DTilesServer 服务或静态 tileset.json 文件，适用于在三维场景中展示基于 3D Tiles 规范组织的模型缓存数据，并支持剖切封边、剖面分析等运行时能力配置。

Name Type Default Description
options Object {} 可选

构造参数。

Name Type Default Description
url String '' 可选

服务基地址，支持文件服务和IGS的3D Tiles服务
文件服务基地址格式：http://{ip}:{port}/{folder}/{serviceName}.json
M3D服务基地址格式(IGS1.0)：无此服务
M3D服务基地址格式(IGS2.0)：http://{ip}:{port}/igs/rest/services/{服务名}/3DTilesServer
boundingVolume Object | null null 可选

模型外包盒信息，通常来源于服务元信息。
sceneName String '' 可选

场景名称或服务名。
fieldInfo Array.<String> [] 可选

服务包含的属性字段名称数组。
description String 'Cesium3DTiles图层' 可选

图层描述信息，用于图层面板展示或序列化输出。
fillClip Boolean false 可选

是否启用模型缓存剖切封边效果。
enableSection Boolean false 可选

是否支持剖面分析。
Example

加载 Cesium 3D Tiles 图层

// ES5 引入方式
const { Cesium3DTilesCacheLayer } = zondy.layer

// ES6 引入方式
import { Cesium3DTilesCacheLayer } from '@mapgis/webclient-common'

const layer = new Cesium3DTilesCacheLayer({
  url: 'http://example.com/igs/rest/services/Scene/DYT/3DTilesServer',
  fillClip: true
})

Extends

Members

_paramUrlString

内部请求使用的实际地址。

当 url 指向 IGS 3DTilesServer 服务根地址时，会自动补齐为 tileset.json 地址； 当 url 已为静态 tileset.json 文件地址时则原样返回。该属性仅供内部请求流程使用。

boundingVolumeObject null

模型外包盒信息。

该属性通常来源于服务元信息，可用于辅助定位模型空间范围。

capabilitiesObject

图层支持能力。

默认仅 Cesium 引擎支持加载，Leaflet/MapboxGL 等非三维引擎会被标记为 loaded=false。

descriptionString

图层描述信息。

该属性可由外部自定义，用于图层列表展示或序列化保存。

enableSectionBoolean

是否支持剖面分析。

该属性用于声明当前图层在业务侧是否启用剖面分析相关能力。

fieldInfoArray.<String>

服务包含的字段名称数组。

该属性来源于服务元信息，用于描述模型可用属性字段。

fillClipBoolean

是否启用模型缓存剖切封边。

该属性由初始化配置决定，可在支持的三维场景中控制剖切结果是否自动封边。

positionObject

模型位置

sceneNameString

场景名称或服务名。

该属性通常来自服务端配置，可用于界面展示或业务标识。

typeLayerType

图层类型。

该属性在构造时根据图层类别固定设置，用于标识当前图层为 Cesium 3D Tiles 模型缓存图层。

urlString

服务基地址

versionString

服务版本号

Methods

clone(){Cesium3DTilesCacheLayer}

document/layer/Cesium3DTilesCacheLayer.js, line 283

克隆当前 Cesium 3D Tiles 图层。

会基于当前实例的序列化结果创建新的图层对象。

Returns:
Type Description
Cesium3DTilesCacheLayer 克隆后的图层对象。

toJSON(){Object}

document/layer/Cesium3DTilesCacheLayer.js, line 263

导出为 JSON 配置。

返回结果包含当前图层的基础配置、模型元信息、解密配置以及剖切和剖面能力开关。

Returns:
Type Description
Object 图层配置对象。

Cesium3DTilesCacheLayer.fromJSON(json){Cesium3DTilesCacheLayer}

document/layer/Cesium3DTilesCacheLayer.js, line 249

通过 JSON 配置创建一个 Cesium 3D Tiles 图层实例。

适用于从持久化配置恢复图层对象；返回实例仅恢复配置，不主动请求服务资源。

Name Type Default Description
json Object {} 可选

图层配置对象。
Returns:
Type Description
Cesium3DTilesCacheLayer 新的 Cesium 3D Tiles 图层实例。