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
确定是否根据颜色顶点属性调整材质的 Alpha 模式。
确定是否将解析 I3S 符号系统并将其应用于图层。
确定是否为没有法线的 I3S 几何体生成平坦法线。
获取此对象的 I3S 数据。
readonly extent : Rectangle
获取此 I3S 覆盖的范围。
readonly geoidTiledTerrainProvider : ArcGISTiledElevationTerrainProvider
引用要用于正向椭球体转换的 GEOID 服务的 terrain 提供程序。
readonly layers : Array.<I3SLayer>
获取 layers 的集合。
获取此数据集的用户可读名称。
readonly resource : Resource
用于获取 I3S 数据集的资源。
确定是否显示数据集。
确定是否显示要素。
readonly sublayers : Array.<I3SSublayer>
获取建筑物子图层的集合.
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:
-
DeveloperError : 这个物体被摧毁了,destroy().
将场景的绘制元素过滤为特定的属性名称和值
Name | Type | Default | Description |
---|---|---|---|
filters |
Array.<I3SNode.AttributeFilter> |
[]
|
optional 属性过滤器的集合 |
Returns:
应用过滤器时解析的 Promise
返回所有可用属性的名称集合
Returns:
属性名称的集合
返回具有给定名称的属性的值集合
Name | Type | Description |
---|---|---|
name |
string | 属性名称 |
Returns:
属性值的集合
如果此对象已销毁,则返回 true;否则为 false。
如果此对象已销毁,则不应使用;调用
isDestroyed
将导致 DeveloperError
异常。
Returns:
true
,如果此对象被销毁;否则为 false
。
Type Definitions
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 以获取有效属性的列表。可以使用除 url 和 show 之外的所有选项,这些选项被 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,
};