Ellipsoid

笛卡爾坐標系中由方程(x / a)^2 + (y / b)^2 + (z / c)^2 = 1定義的二次曲面。主要由Bigemap GL用來表示行星體的形狀。通常使用提供的常量之一，而不是直接構造此對象。

new Ellipsoid(x, y, z)

Parameters:

x (Number) (default 0) X方向的半徑。

y (Number) (default 0) Y方向的半徑。

z (Number) (default 0) Z方向的半徑。

Throws

DeveloperError : 所有半徑分量必須大于或等于零。

See:

Members

(static, constant) MOON : Ellipsoid

初始化為具有月球半徑的球體的橢球體實例。

(static) packedLength : Number

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

(static, constant) UNIT_SPHERE : Ellipsoid

初始化為半徑（1.0、1.0、1.0）的橢球體實例。

(static, constant) WGS84 : Ellipsoid

初始化為wgs84標準的橢球體實例。

(readonly) maximumRadius : Number

獲取橢圓體的最大半徑。

(readonly) minimumRadius : Number

獲取橢球的最小半徑。

(readonly) oneOverRadii : Cartesian3

在橢圓體的半徑上獲取一個。

(readonly) oneOverRadiiSquared : Cartesian3

在橢圓體的平方半徑上獲取一個。

(readonly) radii : Cartesian3

獲取橢球的半徑。

(readonly) radiiSquared : Cartesian3

獲取橢球的平方半徑。

(readonly) radiiToTheFourth : Cartesian3

求橢球的半徑上升到四次方。

Methods

(static) clone(ellipsoid, result) → {Ellipsoid}

復制橢球體實例。

Parameters:

ellipsoid (Ellipsoid) 要復制的橢球體。

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

(static) fromCartesian3(cartesian, result) → {Ellipsoid}

從指定X、Y和Z方向的半徑的笛卡爾坐標計算橢球。

Parameters:

cartesian (Cartesian3) (default Cartesian3.ZERO) 橢球在x、y和z方向上的半徑。

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

Throws

DeveloperError : 所有半徑分量必須大于或等于零。

See:

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

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

Parameters:

value (Ellipsoid) 要打包的值。

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

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

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

從壓縮數組中檢索實例。

Parameters:

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

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

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

cartesianArrayToCartographicArray(cartesians, result) → {Array.<Cartographic>}

將提供的cartesian數組轉換為一組制圖。

Parameters:

cartesians (Array.<Cartesian3>) 笛卡爾位置數組。

result (Array.<Cartographic>) 存儲結果的對象。

Example

//Create an array of Cartesians and determine their Cartographic representation on a WGS84 ellipsoid.
var positions = [new bmgl.Cartesian3(17832.12, 83234.52, 952313.73),
                 new bmgl.Cartesian3(17832.13, 83234.53, 952313.73),
                 new bmgl.Cartesian3(17832.14, 83234.54, 952313.73)]
var cartographicPositions = bmgl.Ellipsoid.WGS84.cartesianArrayToCartographicArray(positions);

cartesianToCartographic(cartesian, result) → {Cartographic}

將提供的笛卡爾坐標轉換為地圖表示。笛卡爾坐標系在橢球的中心沒有定義。

Parameters:

cartesian (Cartesian3) 要轉換為地圖表示的笛卡爾位置。

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

Example

//Create a Cartesian and determine it's Cartographic representation on a WGS84 ellipsoid.
var position = new bmgl.Cartesian3(17832.12, 83234.52, 952313.73);
var cartographicPosition = bmgl.Ellipsoid.WGS84.cartesianToCartographic(position);

cartographicArrayToCartesianArray(cartographics, result) → {Array.<Cartesian3>}

將提供的制圖數組轉換為笛卡爾數組。

Parameters:

cartographics (Array.<Cartographic>) 一系列制圖位置。

result (Array.<Cartesian3>) 存儲結果的對象。

Example

//Convert an array of Cartographics and determine their Cartesian representation on a WGS84 ellipsoid.
var positions = [new bmgl.Cartographic(bmgl.Math.toRadians(21), bmgl.Math.toRadians(78), 0),
                 new bmgl.Cartographic(bmgl.Math.toRadians(21.321), bmgl.Math.toRadians(78.123), 100),
                 new bmgl.Cartographic(bmgl.Math.toRadians(21.645), bmgl.Math.toRadians(78.456), 250)];
var cartesianPositions = bmgl.Ellipsoid.WGS84.cartographicArrayToCartesianArray(positions);

cartographicToCartesian(cartographic, result) → {Cartesian3}

將提供的地圖轉換為笛卡爾表示。

Parameters:

cartographic (Cartographic) 地圖的位置。

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

Example

//Create a Cartographic and determine it's Cartesian representation on a WGS84 ellipsoid.
var position = new bmgl.Cartographic(bmgl.Math.toRadians(21), bmgl.Math.toRadians(78), 5000);
var cartesianPosition = bmgl.Ellipsoid.WGS84.cartographicToCartesian(position);

clone(result) → {Ellipsoid}

復制橢球體實例。

Parameters:

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

equals(right) → {Boolean}

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

Parameters:

right (Ellipsoid) 另一個橢球體。

geocentricSurfaceNormal(cartesian, result) → {Cartesian3}

計算從該橢球體中心指向給定笛卡爾位置的單位向量。

Parameters:

cartesian (Cartesian3) 確定地心法向的笛卡爾坐標。

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

geodeticSurfaceNormal(cartesian, result) → {Cartesian3}

計算在給定位置與橢球表面相切的平面的法向。

Parameters:

cartesian (Cartesian3) 確定曲面法向的笛卡爾位置。

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

geodeticSurfaceNormalCartographic(cartographic, result) → {Cartesian3}

計算在給定位置與橢球表面相切的平面的法向。

Parameters:

cartographic (Cartographic) 確定大地測量法向的制圖位置。

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

getSurfaceNormalIntersectionWithZAxis(position, buffer, result) → {Cartesian3|undefined}

計算曲面法向與Z軸相交的點。

Parameters:

position (Cartesian3) 位置。必須在橢球面上。

buffer (Number) (default 0.0) 在檢查點是否在橢球體中時，從橢球體大小中減去的緩沖區。在地球情況下，由于交叉點總是（相對地）非?？拷行模虼藢τ谄胀ǖ牡厍蚧鶞?，不需要這種緩沖器。在WGS84基準面中，交叉點位于最大Z=+-42841.3115131382處（Z軸的0.673%）。如果長軸/軸旋轉比大于2的平方根，則交點可能在橢球體之外。

result (Cartesian3) 要將結果復制到的笛卡爾，或未定義以創建和返回新實例。

Throws

DeveloperError : 職位是必需的。
DeveloperError : 橢球必須是旋轉橢球（radii.x==radii.y）。
DeveloperError : 橢球體.radii.z必須大于0。

scaleToGeocentricSurface(cartesian, result) → {Cartesian3}

沿地心面法向縮放提供的笛卡爾坐標位置，使其位于該橢球的表面上。

Parameters:

cartesian (Cartesian3) 要縮放的笛卡爾位置。

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

scaleToGeodeticSurface(cartesian, result) → {Cartesian3}

沿大地測量面法向縮放提供的笛卡爾坐標位置，使其位于該橢球的表面上。如果位置在橢球體的中心，則此函數返回UNDEFINED。

Parameters:

cartesian (Cartesian3) 要縮放的笛卡爾位置。

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

toString() → {String}

創建一個字符串，以“radii.x，radii.y，radii.z”格式表示此橢球體。

transformPositionFromScaledSpace(position, result) → {Cartesian3}

通過將其分量乘以Ellipsoid#radii的結果，從橢球縮放空間轉換笛卡爾X、Y、Z位置。

Parameters:

position (Cartesian3) 要轉換的位置。

result (Cartesian3) 要將結果復制到的位置，或未定義以創建和返回新實例的位置。

transformPositionToScaledSpace(position, result) → {Cartesian3}

將笛卡爾X、Y、Z位置轉換為橢球縮放空間，方法是將其分量乘以Ellipsoid#oneOverRadii的結果。

Parameters:

position (Cartesian3) 要轉換的位置。

result (Cartesian3) 要將結果復制到的位置，或未定義以創建和返回新實例的位置。