Rectangle

一個二維區域，指定為經度和緯度坐標。

new Rectangle(west, south, east, north)

Parameters:

west (Number) (default 0.0) 以弧度表示的最西端經度，范圍為[-pi，pi]。

south (Number) (default 0.0) 以弧度表示的最南端緯度，范圍為[-pi/2，pi/2]。

east (Number) (default 0.0) 以弧度表示的最東經，在范圍內[-pi，pi]。

north (Number) (default 0.0) 以弧度表示的最北緯，范圍為[-pi/2，pi/2]。

See:

Packable

Members

(static, constant) MAX_VALUE : Rectangle

最大的矩形。

(static) packedLength : Number

用于將對象打包到數組中的元素數。

east : Number

以弧度表示的最東經，范圍為[-pi，pi]。

Default Value: 0.0

height : Number

獲取以弧度表示的矩形高度。

north : Number

范圍內以弧度表示的最北緯[-pi/2，pi/2]。

Default Value: 0.0

south : Number

以弧度表示的最南端緯度，范圍為[-pi/2，pi/2]。

Default Value: 0.0

west : Number

以弧度表示的最西端經度，范圍為[-pi，pi]。

Default Value: 0.0

width : Number

獲取以弧度表示的矩形寬度。

Methods

(static) center(rectangle, result) → {Cartographic}

計算矩形的中心。

Parameters:

rectangle (Rectangle) 找到中心的矩形

result (Cartographic) 存儲結果的對象。

(static) clone(rectangle, result) → {Rectangle}

復制一個矩形。

Parameters:

rectangle (Rectangle) 要克隆的矩形。

result (Rectangle) 存儲結果的對象，如果要創建新實例，則為未定義對象。

(static) computeHeight(rectangle) → {Number}

以弧度計算矩形的高度。

Parameters:

rectangle (Rectangle) 計算高度的矩形。

(static) computeWidth(rectangle) → {Number}

以弧度計算矩形的寬度。

Parameters:

rectangle (Rectangle) 要計算寬度的矩形。

(static) contains(rectangle, cartographic) → {Boolean}

如果制圖在矩形上或矩形內，則返回“真”，否則返回“假”。

Parameters:

rectangle (Rectangle) 矩形

cartographic (Cartographic) 要測試的地圖。

(static) equals(left, right) → {Boolean}

比較提供的矩形，如果它們相等，則返回true，否則返回false。

Parameters:

left (Rectangle) 第一個矩形。

right (Rectangle) 第二個矩形。

(static) equalsEpsilon(left, right, absoluteEpsilon) → {Boolean}

比較提供的矩形的componentwise，如果通過絕對或相對公差測試，則返回true，否則返回false。

Parameters:

left (Rectangle) 第一個矩形。

right (Rectangle) 第二個矩形。

absoluteEpsilon (Number) 用于等同性測試的絕對epsilon公差。

(static) expand(rectangle, cartographic, result) → {Rectangle}

通過放大提供的矩形，直到它包含提供的地圖，來計算矩形。

Parameters:

rectangle (Rectangle) 要展開的矩形。

cartographic (Cartographic) 用長方形圍起來的地圖。

result (Rectangle) 存儲結果的對象。

(static) fromCartesianArray(cartesians, ellipsoid, result) → {Rectangle}

創建包含所提供數組中所有位置的最小可能矩形。

Parameters:

cartesians (Array.<Cartesian3>) 笛卡爾實例列表。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 卡特爾人所處的橢球體。

result (Rectangle) 存儲結果的對象，如果要創建新實例，則為未定義對象。

(static) fromCartographicArray(cartographics, result) → {Rectangle}

創建包含所提供數組中所有位置的最小可能矩形。

Parameters:

cartographics (Array.<Cartographic>) 地圖實例列表。

result (Rectangle) 存儲結果的對象，如果要創建新實例，則為未定義對象。

(static) fromDegrees(west, south, east, north, result) → {Rectangle}

在給定邊界經度和緯度（度）的情況下創建矩形。

Parameters:

west (Number) (default 0.0) 以度為單位的最西端經度，范圍為[-180.0，180.0]。

south (Number) (default 0.0) 范圍內最南端的緯度，以度為單位。

east (Number) (default 0.0) 范圍內以度為單位的最東經度[-180.0，180.0]。

north (Number) (default 0.0) 范圍內以度為單位的最北緯[-90.0，90.0]。

result (Rectangle) 存儲結果的對象，如果要創建新實例，則為未定義對象。

Example

var rectangle = bmgl.Rectangle.fromDegrees(0.0, 20.0, 10.0, 30.0);

(static) fromRadians(west, south, east, north, result) → {Rectangle}

根據邊界經度和緯度創建一個以弧度表示的矩形。

Parameters:

west (Number) (default 0.0) 以弧度表示的最西端經度，范圍為[-math.pi，math.pi]。

south (Number) (default 0.0) 以弧度表示的最南端緯度，范圍為[-math.pi/2，math.pi/2]。

east (Number) (default 0.0) 以弧度表示的最東經，范圍為[-math.pi，math.pi]。

north (Number) (default 0.0) 以弧度表示的最北緯，范圍為[-math.pi/2，math.pi/2]。

result (Rectangle) 存儲結果的對象，如果要創建新實例，則為未定義對象。

Example

var rectangle = bmgl.Rectangle.fromRadians(0.0, Math.PI/4, Math.PI/8, 3*Math.PI/4);

(static) intersection(rectangle, otherRectangle, result) → {Rectangle|undefined}

計算兩個矩形的交集。此函數假定矩形的坐標為經度和緯度（以弧度表示），并生成正確的交點，同時考慮到同一角度可以用多個值表示，以及經度在反經線處的環繞。對于忽略這些因素并可用于投影坐標的簡單交集，請參見Rectangle.simpleIntersection。

Parameters:

rectangle (Rectangle) 在矩形上查找交集

otherRectangle (Rectangle) 另一個矩形用于查找交集

result (Rectangle) 存儲結果的對象。

(static) northeast(rectangle, result) → {Cartographic}

計算矩形的東北角。

Parameters:

rectangle (Rectangle) 找到角的矩形

result (Cartographic) 存儲結果的對象。

(static) northwest(rectangle, result) → {Cartographic}

計算矩形的西北角。

Parameters:

rectangle (Rectangle) 找到角的矩形

result (Cartographic) 存儲結果的對象。

(static) pack(value, array, startingIndex) → {Array.<Number>}

將提供的實例存儲到提供的數組中。

Parameters:

value (Rectangle) 要打包的值。

array (Array.<Number>) 要打包的數組。

startingIndex (Number) (default 0) 數組中開始打包元素的索引。

(static) simpleIntersection(rectangle, otherRectangle, result) → {Rectangle|undefined}

計算兩個矩形的簡單交集。與Rectangle.intersection不同，此函數不嘗試將角度坐標置于一致的范圍內，也不考慮穿過反子午線。因此，它可以用于坐標不僅僅是緯度和經度（即投影坐標）的矩形。

Parameters:

rectangle (Rectangle) 在矩形上查找交集

otherRectangle (Rectangle) 另一個矩形用于查找交集

result (Rectangle) 存儲結果的對象。

(static) southeast(rectangle, result) → {Cartographic}

計算矩形的東南角。

Parameters:

rectangle (Rectangle) 找到角的矩形

result (Cartographic) 存儲結果的對象。

(static) southwest(rectangle, result) → {Cartographic}

計算矩形的西南角。

Parameters:

rectangle (Rectangle) 找到角的矩形

result (Cartographic) 存儲結果的對象。

(static) subsample(rectangle, ellipsoid, surfaceHeight, result) → {Array.<Cartesian3>}

對一個矩形進行采樣，使其包含適合傳遞到BoundingSphere#fromPoints的笛卡爾點列表。取樣是必要的，以說明矩形覆蓋極或橫跨赤道。

Parameters:

rectangle (Rectangle) 要進行次采樣的矩形。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 要使用的橢球體。

surfaceHeight (Number) (default 0.0) 橢圓體上方矩形的高度。

result (Array.<Cartesian3>) 存儲結果的cartesian數組。

(static) union(rectangle, otherRectangle, result) → {Rectangle}

計算兩個矩形的并集的矩形。

Parameters:

rectangle (Rectangle) 包圍在矩形中的矩形。

otherRectangle (Rectangle) 包圍在矩形中的矩形。

result (Rectangle) 存儲結果的對象。

(static) unpack(array, startingIndex, result) → {Rectangle}

從壓縮數組中檢索實例。

Parameters:

array (Array.<Number>) 壓縮數組。

startingIndex (Number) (default 0) 要解包的元素的起始索引。

result (Rectangle) 存儲結果的對象。

(static) validate(rectangle)

檢查矩形的屬性，如果它們不在有效范圍內，則拋出。

Parameters:

rectangle (Rectangle) 要驗證的矩形

Throws

DeveloperError : north必須在間隔[-Pi/2，Pi/2]中。
DeveloperError : south必須在間隔[-Pi/2，Pi/2]中。
DeveloperError : east必須在間隔[-Pi，Pi]中。
DeveloperError : west必須在間隔[-Pi，Pi]中。

clone(result) → {Rectangle}

復制此矩形。

Parameters:

result (Rectangle) 存儲結果的對象。

equals(other) → {Boolean}

將提供的矩形與此矩形組件進行比較，如果相等，則返回true，否則返回false。

Parameters:

other (Rectangle) 要比較的矩形。

equalsEpsilon(other, epsilon) → {Boolean}

將提供的矩形與此矩形的componentwise進行比較，如果它們在提供的epsilon中，則返回true，否則返回false。

Parameters:

other (Rectangle) 要比較的矩形。

epsilon (Number) 用于相等性測試的epsilon。