要构造 VRTheWorldTerrainProvider，请调用 To construct a VRTheWorldTerrainProvider, call
A VRTheWorldTerrainProvider.fromUrl。不要直接调用构造函数。 . Do not call the constructor directly.
TerrainProvider 通过对从检索到的高度图进行细分来生成地形几何形状 that produces terrain geometry by tessellating height maps retrieved from a VT MÄK VR-TheWorld server.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
options |
VRTheWorldTerrainProvider.ConstructorOptions | 可选 optional 描述初始化选项的对象。 An object describing initialization options. |
示例： Example:
const terrainProvider = await Cesium.VRTheWorldTerrainProvider.fromUrl(
"https://www.vr-theworld.com/vr-theworld/tiles1.0.0/73/"
);
viewer.terrainProvider = terrainProvider;另见： See:
成员 Members
readonly availability : TileAvailability|undefined
获取一个对象，该对象可用于确定此提供者提供的地形的可用性，例如点和矩形中的地形。如果可用性信息不可用，则此属性可能未定义。 Gets an object that can be used to determine availability of terrain from this provider, such as at points and in rectangles. This property may be undefined if availability information is not available.
readonly credit : Credit
获取此地形提供程序处于活动状态时要显示的积分。通常，这用于证明地形的来源。 Gets the credit to display when this terrain provider is active. Typically this is used to credit the source of the terrain.
readonly errorEvent : Event
获取当地形提供程序遇到异步错误时引发的事件。通过订阅该事件，您将收到错误通知，并有可能从中恢复。事件监听器传递一个实例 Gets an event that is raised when the terrain provider encounters an asynchronous error. By subscribing to the event, you will be notified of the error and can potentially recover from it. Event listeners are passed an instance of
TileProviderError.
获取一个值，该值指示请求的切片是否包含顶点法线。 Gets a value indicating whether or not the requested tiles include vertex normals.
获取一个值，该值指示提供程序是否包含水罩。水掩模指示地球的哪些区域是水而不是陆地，因此可以将它们渲染为带有动画波浪的反射表面。 Gets a value indicating whether or not the provider includes a water mask. The water mask indicates which areas of the globe are water rather than land, so they can be rendered as a reflective surface with animated waves.
readonly tilingScheme : GeographicTilingScheme
获取此提供程序使用的切片方案。 Gets the tiling scheme used by this provider.
方法 Methods
static Cesium.VRTheWorldTerrainProvider.fromUrl(url, options) → Promise.<VRTheWorldTerrainProvider>
创建一个 Creates a
TerrainProvider 通过对从检索到的高度图进行细分来生成地形几何形状 that produces terrain geometry by tessellating height maps retrieved from a VT MÄK VR-TheWorld server.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
url |
Resource | string | VR-TheWorld TileMap 的 URL。 The URL of the VR-TheWorld TileMap. |
options |
VRTheWorldTerrainProvider.ConstructorOptions | 可选 optional 描述初始化选项的对象。 An object describing initialization options. |
返回： Returns:
抛出： Throws:
-
RuntimeError : metadata specifies and unknown SRS
示例： Example:
const terrainProvider = await Cesium.VRTheWorldTerrainProvider.fromUrl(
"https://www.vr-theworld.com/vr-theworld/tiles1.0.0/73/"
);
viewer.terrainProvider = terrainProvider;
获取给定级别的图块中允许的最大几何误差。 Gets the maximum geometric error allowed in a tile at a given level.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
level |
number | 获得最大几何误差的图块级别。 The tile level for which to get the maximum geometric error. |
返回： Returns:
最大几何误差。 The maximum geometric error.
确定图块的数据是否可供加载。 Determines whether data for a tile is available to be loaded.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
x |
number | 请求几何图形的图块的 X 坐标。 The X coordinate of the tile for which to request geometry. |
y |
number | 请求几何图形的图块的 Y 坐标。 The Y coordinate of the tile for which to request geometry. |
level |
number | 请求几何图形的图块的级别。 The level of the tile for which to request geometry. |
返回： Returns:
如果不支持则未定义，否则 true 或 false。 Undefined if not supported, otherwise true or false.
确保我们加载图块的可用性数据 Makes sure we load availability data for a tile
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
x |
number | 请求几何图形的图块的 X 坐标。 The X coordinate of the tile for which to request geometry. |
y |
number | 请求几何图形的图块的 Y 坐标。 The Y coordinate of the tile for which to request geometry. |
level |
number | 请求几何图形的图块的级别。 The level of the tile for which to request geometry. |
返回： Returns:
如果不需要加载任何内容，或者在加载所有必需的图块时解析的 Promise，则为未定义 Undefined if nothing need to be loaded or a Promise that resolves when all required tiles are loaded
requestTileGeometry(x, y, level, request) → Promise.<TerrainData>|undefined
请求给定图块的几何形状。结果包括地形数据并指示所有子图块均可用。 Requests the geometry for a given tile. The result includes terrain data and indicates that all child tiles are available.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
x |
number | 请求几何图形的图块的 X 坐标。 The X coordinate of the tile for which to request geometry. |
y |
number | 请求几何图形的图块的 Y 坐标。 The Y coordinate of the tile for which to request geometry. |
level |
number | 请求几何图形的图块的级别。 The level of the tile for which to request geometry. |
request |
Request | 可选 optional 请求对象。仅供内部使用。 The request object. Intended for internal use only. |
返回： Returns:
对所要求的几何形状的承诺。如果此方法返回未定义而不是承诺，则表明已有太多请求处于待处理状态，稍后将重试该请求。 A promise for the requested geometry. If this method returns undefined instead of a promise, it is an indication that too many requests are already pending and the request will be retried later.
类型定义 Type Definitions
VRTheWorldTerrainProvider 构造函数的初始化选项 Initialization options for the VRTheWorldTerrainProvider constructor
属性： Properties:
| 名称 Name | 类型 Type | Attributes | 默认值 Default | 说明 Description |
|---|---|---|---|---|
ellipsoid |
Ellipsoid |
<可选> <optional> |
Ellipsoid.default | 椭球体。如果未指定，则使用默认椭球体。 The ellipsoid. If not specified, the default ellipsoid is used. |
credit |
Credit | string |
<可选> <optional> |
数据源的来源，显示在画布上。 A credit for the data source, which is displayed on the canvas. |