I3SDataProvider

new Cesium.I3SDataProvider(options)

I3SDataProvider 是 I3S 支持的主要公共类。url 选项 应返回一个 scene 对象。当前支持的 I3S 版本为 1.6 和 1.7/1.8 (OGC I3S 1.2)。I3SFeature 和 I3SNode 类实现 I3S 实体的对象模型,具有公共接口。
此对象通常不会直接实例化,请使用 I3SDataProvider.fromUrl.
Name Type Description
options I3SDataProvider.ConstructorOptions An 描述初始化选项的对象
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

确定是否根据颜色顶点属性调整材质的 Alpha 模式。

readonly applySymbology : boolean

确定是否将解析 I3S 符号系统并将其应用于图层。

readonly calculateNormals : boolean

确定是否为没有法线的 I3S 几何体生成平坦法线。
获取此对象的 I3S 数据。
获取此 I3S 覆盖的范围。
引用要用于正向椭球体转换的 GEOID 服务的 terrain 提供程序。
获取 layers 的集合。
获取此数据集的用户可读名称。
用于获取 I3S 数据集的资源。
确定是否显示数据集。

readonly showFeatures : boolean

确定是否显示要素。
获取建筑物子图层的集合.

Methods

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

创建 I3SDataProvider。当前支持的 I3S 版本为 1.6 和 1.7/1.8 (OGC I3S 1.2)。
Name Type Description
url string | Resource I3S 数据集的 url,应返回 I3S 场景对象
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}`);
}
销毁此对象持有的 WebGL 资源。销毁对象允许确定性 释放 WebGL 资源,而不是依赖垃圾回收器来销毁这个对象。

一旦对象被销毁,就不应该使用它;调用 isDestroyed 将导致 DeveloperError 异常。因此 将返回值 (undefined) 分配给对象,如示例中所示。

Throws:
See:

filterByAttributes(filters)Promise.<void>

将场景的绘制元素过滤为特定的属性名称和值
Name Type Default Description
filters Array.<I3SNode.AttributeFilter> [] optional 属性过滤器的集合
Returns:
应用过滤器时解析的 Promise

getAttributeNames()Array.<string>

返回所有可用属性的名称集合
Returns:
属性名称的集合

getAttributeValues(name)Array.<string>

返回具有给定名称的属性的值集合
Name Type Description
name string 属性名称
Returns:
属性值的集合

isDestroyed()boolean

如果此对象已销毁,则返回 true;否则为 false。

如果此对象已销毁,则不应使用;调用 isDestroyed 将导致 DeveloperError 异常。

Returns:
true,如果此对象被销毁;否则为 false
See:

Type Definitions

Cesium.I3SDataProvider.ConstructorOptions

I3SDataProvider 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
name string <optional>
I3S 数据集的名称。
show boolean <optional>
true 确定是否显示数据集。
geoidTiledTerrainProvider ArcGISTiledElevationTerrainProvider | Promise.<ArcGISTiledElevationTerrainProvider> <optional>
描述地球引力模型的平铺高程提供者。如果已定义,则几何图形将根据此提供程序提供的偏移量进行移动。需要将具有重力相关高度的 I3S 数据集定位在正确的位置。
cesium3dTilesetOptions Cesium3DTileset.ConstructorOptions <optional>
包含要传递给内部创建的 Cesium3DTileset 的选项的对象。请参阅 Cesium3DTileset 以获取有效属性的列表。可以使用除 urlshow 之外的所有选项,这些选项被 I3SDataProvider 中的值覆盖。
showFeatures boolean <optional>
false 确定是否显示特征。
adjustMaterialAlphaMode boolean <optional>
false 根据顶点颜色的透明度调整材质的 Alpha 模式的选项。如果为 true,则材质的 Alpha 模式(如果未定义)将设置为 BLEND,用于颜色顶点属性中具有任何透明度的几何体。
applySymbology boolean <optional>
false 确定是否解析 I3S 符号并将其应用于图层。
calculateNormals boolean <optional>
false 确定是否为没有法线的 I3S 几何体生成平坦法线。
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,
};
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.