Terrain - CesiumJS API 文档

new Cesium.Terrain(terrainProviderPromise)

一个管理地形提供者的合成操作的助手.

Name	Type	Description
`terrainProviderPromise`	Promise.<TerrainProvider>	A promise which resolves to a terrain provider

Examples:

// Create
const viewer = new Cesium.Viewer("cesiumContainer", {
  terrain: new Cesium.Terrain(Cesium.CesiumTerrainProvider.fromUrl("https://myTestTerrain.com"));
});

// Handle loading events
const terrain = new Cesium.Terrain(Cesium.CesiumTerrainProvider.fromUrl("https://myTestTerrain.com"));

scene.setTerrain(terrain);

terrain.readyEvent.addEventListener(provider => {
  scene.globe.enableLighting = true;

  terrain.provider.errorEvent.addEventListener(error => {
    alert(`Encountered an error while loading terrain tiles! ${error}`);
  });
});

terrain.errorEvent.addEventListener(error => {
  alert(`Encountered an error while creating terrain! ${error}`);
});

See:

Members

readonly errorEvent : Event.<Terrain.ErrorEventCallback>

获得一个在地形提供者遇到同步错误时上升的事件。通过签名对事件,您将被通知错误,并有可能从中恢复。活动听众被传递一个抛出错误的例子.

readonly provider : TerrainProvider

The terrain provider providing surface geometry to a globe. Do not use until Terrain.readyEvent is raised.

readonly ready : boolean

当地形提供者成功创建时返回真值。否则,返回假.

readonly readyEvent : Event.<Terrain.ReadyEventCallback>

获得一个成功创建地形提供者时要提起的事件。活动听众 are passed the created instance of TerrainProvider.

Methods

static Cesium.Terrain.fromWorldBathymetry(options) → Terrain

Creates a Terrain instance for Cesium World Bathymetry.

Name Type Description

options

object

optional 下列属性的对象 :

Name	Type	Default	Description
`requestVertexNormals`	boolean	`false`	optional Flag that indicates if the client should request additional lighting information from the server if available.

Returns:

铯列车的同步辅助对象

Examples:

// Create Cesium World Bathymetry with default settings
const viewer = new Cesium.Viewer("cesiumContainer", {
  terrain: Cesium.Terrain.fromWorldBathymetry)
});

// Create Cesium World Terrain with normals.
const viewer1 = new Cesium.Viewer("cesiumContainer", {
  terrain: Cesium.Terrain.fromWorldBathymetry({
     requestVertexNormals: true
   });
});

// Handle loading events
const bathymetry = Cesium.Terrain.fromWorldBathymetry();

scene.setTerrain(bathymetry);

bathymetry.readyEvent.addEventListener(provider => {
  scene.globe.enableLighting = true;

  bathymetry.provider.errorEvent.addEventListener(error => {
    alert(`Encountered an error while loading bathymetric terrain tiles! ${error}`);
  });
});

bathymetry.errorEvent.addEventListener(error => {
  alert(`Encountered an error while creating bathymetric terrain! ${error}`);
});

See:

static Cesium.Terrain.fromWorldTerrain(options) → Terrain

Creates a Terrain instance for Cesium World Terrain.

Name Type Description

options

object

optional 下列属性的对象 :

Name	Type	Default	Description
`requestVertexNormals`	boolean	`false`	optional Flag that indicates if the client should request additional lighting information from the server if available.
`requestWaterMask`	boolean	`false`	optional Flag that indicates if the client should request per tile water masks from the server if available.

Returns:

铯列车的同步辅助对象

Examples:

// Create Cesium World Terrain with default settings
const viewer = new Cesium.Viewer("cesiumContainer", {
  terrain: Cesium.Terrain.fromWorldTerrain()
});

// Create Cesium World Terrain with water and normals.
const viewer1 = new Cesium.Viewer("cesiumContainer", {
  terrain: Cesium.Terrain.fromWorldTerrain({
     requestWaterMask: true,
     requestVertexNormals: true
   });
});

// Handle loading events
const terrain = Cesium.Terrain.fromWorldTerrain();

scene.setTerrain(terrain);

terrain.readyEvent.addEventListener(provider => {
  scene.globe.enableLighting = true;

  terrain.provider.errorEvent.addEventListener(error => {
    alert(`Encountered an error while loading terrain tiles! ${error}`);
  });
});

terrain.errorEvent.addEventListener(error => {
  alert(`Encountered an error while creating terrain! ${error}`);
});

See:

Type Definitions

Cesium.Terrain.ErrorEventCallback(err)

发生错误时称为函数 .

This:

Terrain

Name	Type	Description
`err`	Error	一个关于发生错误的天体 .

Cesium.Terrain.ReadyEventCallback(provider)

当提供者创建时调用的函数

This:

Terrain

Name	Type	Description
`provider`	TerrainProvider	创建的地形提供者.