单个图块的地形数据，其中地形数据表示为高度图。高度图是从北到南、从西到东按行优先顺序排列的高度矩形数组。 Terrain data for a single tile where the terrain data is represented as a heightmap. A heightmap is a rectangular array of heights in row-major order from north to south and west to east.
| 名称 Name | 类型 Type | 说明 Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
具有以下属性的对象： Object with the following properties:
|
示例： Example:
const buffer = ...
const heightBuffer = new Uint16Array(buffer, 0, that._heightmapWidth * that._heightmapWidth);
const childTileMask = new Uint8Array(buffer, heightBuffer.byteLength, 1)[0];
const waterMask = new Uint8Array(buffer, heightBuffer.byteLength + 1, buffer.byteLength - heightBuffer.byteLength - 1);
const terrainData = new Cesium.HeightmapTerrainData({
buffer : heightBuffer,
width : 65,
height : 65,
childTileMask : childTileMask,
waterMask : waterMask
});另见： See:
成员 Members
credits : Array.<Credit>
该图块的一系列制作人员名单。 An array of credits for this tile.
该地形数据中包含的水掩模（如果有）。水蒙版是一个方形 Uint8Array 或图像，其中值 255 表示水，值 0 表示陆地。 0 到 255 之间的值也允许在陆地和水之间平滑地混合。 The water mask included in this terrain data, if any. A water mask is a square Uint8Array or image where a value of 255 indicates water and a value of 0 indicates land. Values in between 0 and 255 are allowed as well to smoothly blend between land and water.
方法 Methods
计算指定经度和纬度处的地形高度。 Computes the terrain height at a specified longitude and latitude.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
rectangle |
Rectangle | 该地形数据覆盖的矩形。 The rectangle covered by this terrain data. |
longitude |
number | 以弧度表示的经度。 The longitude in radians. |
latitude |
number | 以弧度为单位的纬度。 The latitude in radians. |
返回： Returns:
指定位置的地形高度。如果位置位于矩形之外，此方法将推断高度，这对于远离矩形之外的位置可能非常不正确。 The terrain height at the specified position. If the position is outside the rectangle, this method will extrapolate the height, which is likely to be wildly incorrect for positions far outside the rectangle.
根据以下条件确定给定的子图块是否可用 Determines if a given child tile is available, based on the
HeightmapTerrainData.childTileMask。假定给定的子图块坐标是该图块的四个子图块之一。如果给出非子图块坐标，则返回东南子图块的可用性。 . The given child tile coordinates are assumed to be one of the four children of this tile. If non-child tile coordinates are given, the availability of the southeast child tile is returned.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
thisX |
number | 此（父）图块的图块 X 坐标。 The tile X coordinate of this (the parent) tile. |
thisY |
number | 此（父）图块的图块 Y 坐标。 The tile Y coordinate of this (the parent) tile. |
childX |
number | 用于检查可用性的子图块的图块 X 坐标。 The tile X coordinate of the child tile to check for availability. |
childY |
number | 用于检查可用性的子图块的图块 Y 坐标。 The tile Y coordinate of the child tile to check for availability. |
返回： Returns:
如果子图块可用，则为 True；否则为假。 True if the child tile is available; otherwise, false.
upsample(tilingScheme, thisX, thisY, thisLevel, descendantX, descendantY, descendantLevel) → Promise.<HeightmapTerrainData>|undefined
对该地形数据进行上采样以供后代图块使用。生成的实例将包含此实例中高度样本的子集，如有必要，将进行插值。 Upsamples this terrain data for use by a descendant tile. The resulting instance will contain a subset of the height samples in this instance, interpolated if necessary.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
tilingScheme |
TilingScheme | 该地形数据的切片方案。 The tiling scheme of this terrain data. |
thisX |
number | 切片方案中该切片的 X 坐标。 The X coordinate of this tile in the tiling scheme. |
thisY |
number | 切片方案中该切片的 Y 坐标。 The Y coordinate of this tile in the tiling scheme. |
thisLevel |
number | 该切片在切片方案中的级别。 The level of this tile in the tiling scheme. |
descendantX |
number | 我们正在对其进行上采样的后代切片的切片方案中的 X 坐标。 The X coordinate within the tiling scheme of the descendant tile for which we are upsampling. |
descendantY |
number | 我们要对其进行上采样的后代切片的切片方案中的 Y 坐标。 The Y coordinate within the tiling scheme of the descendant tile for which we are upsampling. |
descendantLevel |
number | 我们正在对其进行上采样的后代切片的切片方案中的级别。 The level within the tiling scheme of the descendant tile for which we are upsampling. |
返回： Returns:
承诺为后代图块提供上采样高度图地形数据，或者如果网格不可用则未定义。 A promise for upsampled heightmap terrain data for the descendant tile, or undefined if the mesh is unavailable.
获取一个值，该值指示此地形数据是否是通过对较低分辨率地形数据进行上采样而创建的。如果该值为 false，则数据是从其他来源获取的，例如从远程服务器下载。对于从调用返回的实例，此方法应返回 true Gets a value indicating whether or not this terrain data was created by upsampling lower resolution terrain data. If this value is false, the data was obtained from some other source, such as by downloading it from a remote server. This method should return true for instances returned from a call to
HeightmapTerrainData#upsample.
返回： Returns:
如果此实例是通过上采样创建的，则为 True；否则为假。 True if this instance was created by upsampling; otherwise, false.