要创建Cesium3DTilesTerrainProvider,请调用
一个访问3D瓦片格式地形数据的 Cesium3DTilesTerrainProvider.fromIonAssetId 或 Cesium3DTilesTerrainProvider.fromUrl。不要直接调用构造器。
TerrainProvider。
| Name | Type | Description |
|---|---|---|
options |
Cesium3DTilesTerrainProvider.ConstructorOptions | optional 描述初始化选项的对象 |
- TerrainProvider
- Cesium3DTilesTerrainProvider.fromUrl
- Cesium3DTilesTerrainProvider.fromIonAssetId // 使用顶点法线创建GTOPO30 try { const viewer = new Cesium.Viewer("cesiumContainer", { terrainProvider: await Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(2732686, { requestVertexNormals: true }) }); } catch (error) { console.log(error); }
Experimental
This 该功能尚未最终确定,可能会根据Cesium的标准弃用政策进行变更。
See:
Members
availability : TileAvailability|undefined
获取可用于确定此提供程序所提供地形可用性的对象,例如
在点和矩形上。
获取当前地形提供程序激活时显示的信用值。通常用于显示地形的来源。
获取提供程序使用的镶嵌方案。
在地形提供程序遇到异步错误时触发事件。通过订阅该事件,您将收到错误通知并可能从中恢复。事件监听器
接收
TileProviderError 的实例。
are passed an instance of TileProviderError.
获取指示请求的瓦片是否包含顶点法线的值。
获取指示提供程序是否包含水掩膜的值。水掩膜
指示地球上的哪些区域是水而不是陆地,因此可以被渲染为具有动画波浪的反射表面。
获取指示请求的瓦片是否包含顶点法线的值。
获取提供程序使用的镶嵌方案。
Methods
static Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(assetId, options) → Promise.<CesiumTerrainProvider>
从Cesium离子资产ID创建一个访问Cesium 3D瓦片格式地形数据的
TerrainProvider
| Name | Type | Description |
|---|---|---|
assetId |
number | Cesium离子资产ID。 |
options |
CesiumTerrainProvider.ConstructorOptions | optional 描述初始化选项的对象。 |
Returns:
Throws:
-
RuntimeError : layer.json 未指定格式
-
RuntimeError : layer.json 指定了未知格式
-
RuntimeError : layer.json 指定了不支持的量化网格版本
-
RuntimeError : layer.json 未指定 tiles 属性,或指定了空数组
-
RuntimeError : layer.json 未指定任何 tile URL 模板
Example:
// 使用顶点法线创建GTOPO30
try {
const viewer = new Cesium.Viewer("cesiumContainer", {
terrainProvider: await Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(2732686, {
requestVertexNormals: true
})
});
} catch (error) {
console.log(error);
}
static Cesium.Cesium3DTilesTerrainProvider.fromUrl(url, options) → Promise.<Cesium3DTilesTerrainProvider>
创建一个访问Cesium 3D瓦片格式地形数据的
TerrainProvider。
| Name | Type | Description |
|---|---|---|
url |
Resource | string | Promise.<Resource> | Promise.<string> | Cesium地形服务器的URL。 |
options |
Cesium3DTilesTerrainProvider.ConstructorOptions | optional 描述初始化选项的对象。 |
Returns:
A 解析为地形提供器的promise。
Example:
// 使用法线创建地形。
try {
const viewer = new Cesium.Viewer("cesiumContainer", {
terrainProvider: await Cesium.Cesium3DTilesTerrainProvider.fromUrl(
Cesium.IonResource.fromAssetId(3956), {
requestVertexNormals: true
})
});
} catch (error) {
console.log(error);
}
获取给定层级下瓦片允许的最大几何误差。
| Name | Type | Description |
|---|---|---|
level |
number | 获取最大几何误差的瓦片层级。 |
Returns:
The 最大几何误差。
确定特定 tiles 的数据是否可加载
| Name | Type | Description |
|---|---|---|
x |
number | 请求几何数据的 tiles 的 X 坐标 |
y |
number | 请求几何数据的 tiles 的 Y 坐标 |
level |
number | 请求几何数据的 tiles 的层级 |
Returns:
Undefined 如果不支持或可用性未知,否则为 true 或 false
确保我们加载了瓦片的可用性数据。
| Name | Type | Description |
|---|---|---|
_x |
number | 请求几何数据的瓦片的X坐标。 |
_y |
number | 请求几何数据的瓦片的Y坐标。 |
_level |
number | 请求几何数据的瓦片层级。 |
Returns:
Undefined 如果无需加载,或当所有必需的瓦片被加载时Promise会解析。
requestTileGeometry(x, y, level, request) → Promise.<Cesium3DTilesTerrainData>|undefined
请求特定 tiles 的几何数据。此函数不应在之前调用
Cesium3DTilesTerrainProvider#ready 返回 true。结果必须包含地形数据
可选择性地包含水掩码以及哪些子 tiles 可用的指示信息
| Name | Type | Description |
|---|---|---|
x |
number | 请求几何数据的 tiles 的 X 坐标 |
y |
number | 请求几何数据的 tiles 的 Y 坐标 |
level |
number | 请求几何数据的 tiles 的层级 |
request |
Request | optional 请求对象。仅用于内部使用 |
Returns:
A 请求几何数据的 promise。如果此方法
返回 undefined 而不是 promise,说明当前有太多请求正在等待中
并将在稍后重试
Type Definitions
Cesium3DTilesTerrainProvider构造器的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
requestVertexNormals |
boolean |
<optional> |
false | 标志,指示客户端是否应从服务器请求额外的光照信息,如果可用则以每个顶点法线形式提供。 |
requestWaterMask |
boolean |
<optional> |
false | 标志,指示客户端是否应从服务器请求瓦片水掩膜,如果可用。 |
ellipsoid |
Ellipsoid |
<optional> |
Ellipsoid.default | 椭球体。如果未指定,则使用WGS84椭球体。 |
credit |
Credit | string |
<optional> |
数据源的标识,在画布上显示。 |
