HeightmapTerrainData

單個瓦片的地形數據，其中地形數據表示為高度圖。高度圖是從北到南、從西到東的一排主要高度的矩形陣列。

new HeightmapTerrainData(options)

Parameters:

options (Object)

Name Description

options.buffer
TypedArray 包含高度數據的緩沖區。

options.width
Number 高度圖的寬度（經度方向），以樣本為單位。

options.height
Number 高度圖的高度（緯度方向），以樣本為單位。

options.childTileMask
Number
default 15 一個位掩碼，指示此瓦片的四個子項中存在哪一個。如果設置了子位，則需要時也將請求該瓦片的幾何圖形。如果清除了位，則不會請求子瓦片，而是從父瓦片中向上采樣幾何圖形。

options.waterMask
Uint8Array 地形數據中包含的水面掩蔽（如果有）。一個水面掩蔽是一個正方形的uint8數組或圖像，其中值255表示水，值0表示土地。允許0到255之間的值在陸地和水之間平滑混合。

options.structure

Object

描述高度數據結構的對象。

Properties

Name	Description
options.structure.heightScale `Number` default `1.0`	乘以高度樣本以獲得高度偏移以上高度的系數，單位為米。將高度偏移量乘以比例后添加到生成的高度。
options.structure.heightOffset `Number` default `0.0`	要添加到縮放高度以獲得最終高度（以米為單位）的偏移量。高度樣本乘以高度比例后，將添加偏移量。
options.structure.elementsPerHeight `Number` default `1`	緩沖區中組成單個高度樣本的元素數。這通常是1，表示每個元素都是單獨的高度樣本。如果它大于1，那么元素的數量加在一起構成高度示例，高度示例根據structure.element乘數和structure.isbigendian屬性計算。
options.structure.stride `Number` default `1`	要從一個高度的第一個元素跳到下一個高度的第一個元素的元素數。
options.structure.elementMultiplier `Number` default `256.0`	當“步幅”屬性大于1時，用于計算高度值的乘數。例如，如果步幅為4，步幅倍增器為256，則高度計算如下：`height=buffer[index]+buffer[index+1]256+buffer[index+2]256256+buffer[index+3]256256256`假定isbigendian屬性為假。如果為真，則元素的順序顛倒。
options.structure.isBigEndian `Boolean` default `false`	當stride屬性大于1時，指示緩沖區中元素的endianness。如果此屬性為假，則第一個元素是低階元素。如果為真，則第一個元素是高階元素。
options.structure.lowestEncodedHeight `Number`	可存儲在高度緩沖區中的最小值。使用“heightscale”和“heightoffset”編碼后，任何低于此值的高度都將被固定到此值。例如，如果高度緩沖區是“uint16array”，則此值應為0，因為“uint16array”不能存儲負數。如果未指定此參數，則不會強制使用最小值。
options.structure.highestEncodedHeight `Number`	可存儲在高度緩沖區中的最大值。使用“heightscale”和“heightoffset”編碼后，任何高于此值的高度都將被固定到此值。例如，如果高度緩沖區是“uint16array”，則該值應為“256*256-1”或65535，因為“uint16array”不能存儲大于65535的數字。如果未指定此參數，則不會強制使用最大值。

options.encoding
HeightmapEncoding
default HeightmapEncoding.NONE 緩沖區上使用的編碼。

options.createdByUpsampling
Boolean
default false 如果此實例是通過向上采樣另一個實例創建的，則為true；否則為false。

Example

var buffer = ...
var heightBuffer = new Uint16Array(buffer, 0, that._heightmapWidth * that._heightmapWidth);
var childTileMask = new Uint8Array(buffer, heightBuffer.byteLength, 1)[0];
var waterMask = new Uint8Array(buffer, heightBuffer.byteLength + 1, buffer.byteLength - heightBuffer.byteLength - 1);
var terrainData = new bmgl.HeightmapTerrainData({
  buffer : heightBuffer,
  width : 65,
  height : 65,
  childTileMask : childTileMask,
  waterMask : waterMask
});

See:

Members

credits : Array.<Credit>

此瓦片的信用證數組。

waterMask : (Uint8Array|Image|Canvas)

地形數據中包含的水面掩蔽（如果有）。一個水面掩蔽是一個正方形的uint8數組或圖像，其中值255表示水，值0表示土地。允許0到255之間的值在陸地和水之間平滑混合。

Methods

interpolateHeight(rectangle, longitude, latitude) → {Number}

計算指定經度和緯度的地形高度。

Parameters:

rectangle (Rectangle) 地形數據覆蓋的矩形。

longitude (Number) 經度以弧度表示。

latitude (Number) 以弧度表示的緯度。

isChildAvailable(thisX, thisY, childX, childY) → {Boolean}

根據HeightmapTerrainData.childTileMask確定給定的子瓦片是否可用。給定的子瓦片坐標假定為該瓦片的四個子瓦片之一。如果給出了非子瓦片坐標，則返回東南子瓦片的可用性。

Parameters:

thisX (Number) 此（父）瓦片的瓦片X坐標。

thisY (Number) 此（父）瓦片的瓦片Y坐標。

childX (Number) 子瓦片的瓦片X坐標，用于檢查可用性。

childY (Number) 子瓦片的瓦片Y坐標，用于檢查可用性。

upsample(tilingScheme, thisX, thisY, thisLevel, descendantX, descendantY, descendantLevel) → {Promise.<HeightmapTerrainData>|undefined}

向上采樣此地形數據，以供后代瓦片使用。生成的實例將包含此實例中高度示例的子集，必要時進行插值。

Parameters:

tilingScheme (TilingScheme) 地形數據的切片方案。

thisX (Number) 瓦片方案中切片方案的X坐標。

thisY (Number) 瓦片方案中切片方案的Y坐標。

thisLevel (Number) 瓦片方案中此切片方案的級別。

descendantX (Number) 在瓦片方案中的切片方案中，我們正在對其進行上采樣的X坐標。

descendantY (Number) 在瓦片方案中的Y坐標，我們正在對切片方案進行采樣。

descendantLevel (Number) 在瓦片方案中的切片方案中，我們正在對其進行上采樣。

wasCreatedByUpsampling() → {Boolean}

獲取一個值，該值指示此地形數據是否是通過向上采樣低分辨率地形數據創建的。如果該值為假，則數據是從其他來源獲得的，例如從遠程服務器下載。對于調用HeightmapTerrainData#upsample返回的實例，此方法應返回true。