I3SDataProvider - CesiumJS API 文档

new Cesium.I3SDataProvider(options)

I3SData Provider是 NT 0 支持的主要公共类. url 选项应返回场景对象。目前支持的 I3S 版本为1.6和 1.7/1.8 ( OGC I3S 1.2). I3SFeature 和 I3SNODE 类用于 NT 0 实体的对象模型,具有公共界面.

此天体通常不直接即时化,使用 I3SDataProvider.fromUrl .

Name	Type	Description
`options`	I3SDataProvider.ConstructorOptions	描述初始化选项的对象

Examples:

try {
  const i3sData = await I3SDataProvider.fromUrl(
    "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/Frankfurt2017_vi3s_18/SceneServer/layers/0"
  );
  viewer.scene.primitives.add(i3sData);
} catch (error) {
  console.log(`There was an error creating the I3S Data Provider: ${error}`);
}

try {
  const geoidService = await Cesium.ArcGISTiledElevationTerrainProvider.fromUrl(
    "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/EGM2008/ImageServer"
  );
  const i3sData = await I3SDataProvider.fromUrl(
    "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/Frankfurt2017_vi3s_18/SceneServer/layers/0", {
      geoidTiledTerrainProvider: geoidService
  });
  viewer.scene.primitives.add(i3sData);
} catch (error) {
  console.log(`There was an error creating the I3S Data Provider: ${error}`);
}

See:

Members

readonly adjustMaterialAlphaMode : boolean

确定材料的α模式是否会根据颜色顶点属性进行调整.

readonly applySymbology : boolean

确定是否解析并应用到图层中 .

readonly calculateNormals : boolean

确定平面常态是否会生成无常态的 I3S 几何.

readonly data : object

获取此天体的 NT 0 数据.

readonly extent : Rectangle

得到这个NT=0 的覆盖范围.

readonly geoidTiledTerrainProvider : ArcGISTiledElevationTerrainProvider

地形提供者引用了用于对称到椭圆转换的 NT 0 服务.

readonly layers : Array.<I3SLayer>

获得分层集.

readonly name : string

获取此数据集的人类可读名称 .

readonly resource : Resource

用于获取 I3S 数据集的资源.

show : boolean

确定数据集是否会显示.

readonly showFeatures : boolean

确定是否显示特性.

readonly sublayers : Array.<I3SSublayer>

获得建筑子层的集合.

Methods

static Cesium.I3SDataProvider.fromUrl(url, options) → Promise.<I3SDataProvider>

创建 I3SData 服务器。目前支持的 I3S 版本为1.6和 1.7/1.8 ( OGC I3S 1.2).

Name	Type	Description
`url`	string \| Resource	NT 0 数据集的url,该数据集应返回 NT 1 场景对象
`options`	I3SDataProvider.ConstructorOptions	描述初始化选项的对象

Returns:

Examples:

try {
  const i3sData = await I3SDataProvider.fromUrl(
    "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/Frankfurt2017_vi3s_18/SceneServer/layers/0"
  );
  viewer.scene.primitives.add(i3sData);
} catch (error) {
  console.log(`There was an error creating the I3S Data Provider: ${error}`);
}

try {
  const geoidService = await Cesium.ArcGISTiledElevationTerrainProvider.fromUrl(
    "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/EGM2008/ImageServer"
  );
  const i3sData = await I3SDataProvider.fromUrl(
    "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/Frankfurt2017_vi3s_18/SceneServer/layers/0", {
      geoidTiledTerrainProvider: geoidService
  });
  viewer.scene.primitives.add(i3sData);
} catch (error) {
  console.log(`There was an error creating the I3S Data Provider: ${error}`);
}

destroy()

Destroys the WebGL resources held by this object. Destroying an object allows for deterministic 释放 WebGL 资源,而不是依赖垃圾收集器来摧毁此对象.

Once an object is destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception. Therefore, assign the return value (undefined) to the object as done in the example.

Throws:

DeveloperError : This object was destroyed, i.e., destroy() was called.

See:

I3SDataProvider#isDestroyed

filterByAttributes(filters) → Promise.<void>

过滤一个场景中绘制的元素到特定属性名称和值

Name	Type	Default	Description
`filters`	Array.<I3SNode.AttributeFilter>	`[]`	optional The collection of attribute filters

Returns:

当过滤器被应用时解答的承诺

getAttributeNames() → Array.<string>

返回所有可用属性的名称收藏

Returns:

属性名称的收集

getAttributeValues(name) → Array.<string>

以给定的名称返回属性的值集合

Name	Type	Description
`name`	string	属性名称

Returns:

属性值的收集

isDestroyed() → boolean

如果此对象被销毁, 返回真实; 否则, 错误 .

If this object was destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception.

Returns:

true if this object was destroyed; otherwise, false.

See:

I3SDataProvider#destroy

Type Definitions

Cesium.I3SDataProvider.ConstructorOptions

I3SData 创建器的初始化选项

Properties:

Name	Type	Attributes	Default	Description
`name`	string	<optional>		NT 0 数据集名称.
`show`	boolean	<optional>	true	Determines if the dataset will be shown.
`geoidTiledTerrainProvider`	ArcGISTiledElevationTerrainProvider \| Promise.<ArcGISTiledElevationTerrainProvider>	<optional>		Tiled elevation provider describing an Earth Gravitational Model. If defined, geometry will be shifted based on the offsets given by this provider. Required to position I3S data sets with gravity-related height at the correct location.
`cesium3dTilesetOptions`	Cesium3DTileset.ConstructorOptions	<optional>		Object containing options to pass to an internally created `Cesium3DTileset`. See `Cesium3DTileset` for list of valid properties. All options can be used with the exception of `url` and `show` which are overridden by values from I3SDataProvider.
`showFeatures`	boolean	<optional>	false	Determines if the features will be shown.
`adjustMaterialAlphaMode`	boolean	<optional>	false	The option to adjust the alpha mode of the material based on the transparency of the vertex color. When `true`, the alpha mode of the material (if not defined) will be set to BLEND for geometry with any transparency in the color vertex attribute.
`applySymbology`	boolean	<optional>	false	Determines if the I3S symbology will be parsed and applied for the layers.
`calculateNormals`	boolean	<optional>	false	Determines if the flat normals will be generated for I3S geometry without normals.

Examples:

// Increase LOD by reducing SSE
const cesium3dTilesetOptions = {
  maximumScreenSpaceError: 1,
};
const i3sOptions = {
  cesium3dTilesetOptions: cesium3dTilesetOptions,
};

// Set a custom outline color to replace the color defined in I3S symbology
const cesium3dTilesetOptions = {
  outlineColor: Cesium.Color.BLUE,
};
const i3sOptions = {
  cesium3dTilesetOptions: cesium3dTilesetOptions,
  applySymbology: true,
};