Cartesian3

三維笛卡爾點。

new Cartesian3(x, y, z)

Parameters:

x (Number) (default 0.0) X分量。

y (Number) (default 0.0) Y分量。

z (Number) (default 0.0) Z分量。

See:

Members

x : Number

X分量。

Default Value: 0.0

y : Number

Y分量。

Default Value: 0.0

z : Number

Z分量。

Default Value: 0.0

(static) packedLength : Number

用于將對象打包到數(shù)組中的元素數(shù)。

(static, constant) UNIT_X : Cartesian3

初始化為（1.0、0.0、0.0）的不可變cartesian3實例。

(static, constant) UNIT_Y : Cartesian3

初始化為（0.0、1.0、0.0）的不可變cartesian3實例。

(static, constant) UNIT_Z : Cartesian3

初始化為（0.0、0.0、1.0）的不可變cartesian3實例。

(static, constant) ZERO : Cartesian3

初始化為（0.0、0.0、0.0）的不可變cartesian3實例。

Methods

clone(result) → {Cartesian3}

復制此cartesian3實例。

Parameters:

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

equals(right) → {Boolean}

將該笛卡爾與提供的笛卡爾分量進行比較，如果相等則返回true，否則返回false。

Parameters:

right (Cartesian3) 右手邊笛卡爾。

equalsEpsilon(right, relativeEpsilon, absoluteEpsilon) → {Boolean}

將該笛卡爾與提供的笛卡爾分量進行比較，如果通過絕對或相對公差測試，則返回true，否則返回false。

Parameters:

right (Cartesian3) 右手邊笛卡爾。

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

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

toString() → {String}

創(chuàng)建一個字符串，以'（x，y，z）'格式表示此笛卡爾。

(static) abs(cartesian, result) → {Cartesian3}

計算所提供笛卡爾的絕對值。

Parameters:

cartesian (Cartesian3) 要計算其絕對值的笛卡爾。

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

(static) add(left, right, result) → {Cartesian3}

計算兩個笛卡爾的分量和。

Parameters:

left (Cartesian3) 第一個笛卡爾。

right (Cartesian3) 第二個笛卡爾。

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

(static) angleBetween(left, right) → {Number}

返回所提供cartesian之間的角度（以弧度表示）。

Parameters:

left (Cartesian3) 第一個笛卡爾。

right (Cartesian3) 第二個笛卡爾。

(static) clone(cartesian, result) → {Cartesian3}

復制cartesian3實例。

Parameters:

cartesian (Cartesian3) 要復制的笛卡爾坐標。

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

(static) cross(left, right, result) → {Cartesian3}

計算兩個卡特爾人的叉（外）積。

Parameters:

left (Cartesian3) 第一個笛卡爾。

right (Cartesian3) 第二個笛卡爾。

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

(static) distance(left, right) → {Number}

計算兩點之間的距離。

Parameters:

left (Cartesian3) 計算距離的第一個點。

right (Cartesian3) 計算距離的第二個點。

Example

// Returns 1.0
var d = bmgl.Cartesian3.distance(new bmgl.Cartesian3(1.0, 0.0, 0.0), new bmgl.Cartesian3(2.0, 0.0, 0.0));

(static) distanceSquared(left, right) → {Number}

計算兩點之間的平方距離。使用此函數(shù)比較平方距離比使用Cartesian3#distance比較距離更有效。

Parameters:

left (Cartesian3) 計算距離的第一個點。

right (Cartesian3) 計算距離的第二個點。

Example

// Returns 4.0, not 2.0
var d = bmgl.Cartesian3.distanceSquared(new bmgl.Cartesian3(1.0, 0.0, 0.0), new bmgl.Cartesian3(3.0, 0.0, 0.0));

(static) divideByScalar(cartesian, scalar, result) → {Cartesian3}

將提供的笛卡爾分量除以提供的標量。

Parameters:

cartesian (Cartesian3) 要分割的笛卡爾。

scalar (Number) 要除以的標量。

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

(static) divideComponents(left, right, result) → {Cartesian3}

計算兩個笛卡爾人的分量商。

Parameters:

left (Cartesian3) 第一個笛卡爾。

right (Cartesian3) 第二個笛卡爾。

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

(static) dot(left, right) → {Number}

計算兩個笛卡爾的點（標量）積。

Parameters:

left (Cartesian3) 第一個笛卡爾。

right (Cartesian3) 第二個笛卡爾。

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

比較提供的cartesian組件，如果相等則返回true，否則返回false。

Parameters:

left (Cartesian3) 第一個笛卡爾。

right (Cartesian3) 第二個笛卡爾。

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

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

Parameters:

left (Cartesian3) 第一個笛卡爾。

right (Cartesian3) 第二個笛卡爾。

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

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

(static) fromArray(array, startingIndex, result) → {Cartesian3}

從數(shù)組中的三個連續(xù)元素創(chuàng)建cartesian3。

Parameters:

array (Array.<Number>) 其三個連續(xù)元素分別對應于x、y和z組件的數(shù)組。

startingIndex (Number) (default 0) 第一個元素數(shù)組的偏移量，它對應于x組件。

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

Example

// Create a Cartesian3 with (1.0, 2.0, 3.0)
var v = [1.0, 2.0, 3.0];
var p = bmgl.Cartesian3.fromArray(v);

// Create a Cartesian3 with (1.0, 2.0, 3.0) using an offset into an array
var v2 = [0.0, 0.0, 1.0, 2.0, 3.0];
var p2 = bmgl.Cartesian3.fromArray(v2, 2);

(static) fromCartesian4(cartesian, result) → {Cartesian3}

從現(xiàn)有cartesian4創(chuàng)建cartesian3實例。這只需要取cartesian4的x、y和z屬性，然后滴w。

Parameters:

cartesian (Cartesian4) 要從中創(chuàng)建cartesian3實例的cartesian4實例。

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

(static) fromDegrees(longitude, latitude, height, ellipsoid, result) → {Cartesian3}

從以度為單位的經(jīng)度和緯度值返回cartesian3位置。

Parameters:

longitude (Number) 經(jīng)度，以度為單位

latitude (Number) 緯度，以度為單位

height (Number) (default 0.0) 橢球面以上的高度，單位為米。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 位置所在的橢球體。

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

Example

var position = bmgl.Cartesian3.fromDegrees(-115.0, 37.0);

(static) fromDegreesArray(coordinates, ellipsoid, result) → {Array.<Cartesian3>}

返回給定經(jīng)度和緯度值數(shù)組（以度為單位）的cartesian3位置數(shù)組。

Parameters:

coordinates (Array.<Number>) 經(jīng)度和緯度值的列表。值可選[經(jīng)度、緯度、經(jīng)度、緯度…]。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 坐標所在的橢球體。

result (Array.<Cartesian3>) 存儲結果的cartesian3對象數(shù)組。

Example

var positions = bmgl.Cartesian3.fromDegreesArray([-115.0, 37.0, -107.0, 33.0]);

(static) fromDegreesArrayHeights(coordinates, ellipsoid, result) → {Array.<Cartesian3>}

返回給定經(jīng)度、緯度和高度值數(shù)組的cartesian3位置數(shù)組，其中經(jīng)度和緯度以度為單位。

Parameters:

coordinates (Array.<Number>) 經(jīng)度、緯度和高度值的列表。值可選[經(jīng)度、緯度、高度、經(jīng)度、緯度、高度…]。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 位置所在的橢球體。

result (Array.<Cartesian3>) 存儲結果的cartesian3對象數(shù)組。

Example

var positions = bmgl.Cartesian3.fromDegreesArrayHeights([-115.0, 37.0, 100000.0, -107.0, 33.0, 150000.0]);

(static) fromElements(x, y, z, result) → {Cartesian3}

從x、y和z坐標創(chuàng)建cartesian3實例。

Parameters:

x (Number) X坐標。

y (Number) Y坐標。

z (Number) Z坐標。

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

(static) fromRadians(longitude, latitude, height, ellipsoid, result) → {Cartesian3}

從以弧度表示的經(jīng)度和緯度值返回cartesian3位置。

Parameters:

longitude (Number) 經(jīng)度，以弧度表示

latitude (Number) 緯度，以弧度表示

height (Number) (default 0.0) 橢球面以上的高度，單位為米。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 位置所在的橢球體。

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

Example

var position = bmgl.Cartesian3.fromRadians(-2.007, 0.645);

(static) fromRadiansArray(coordinates, ellipsoid, result) → {Array.<Cartesian3>}

返回cartesian3位置數(shù)組，該數(shù)組以弧度表示經(jīng)度和緯度值。

Parameters:

coordinates (Array.<Number>) 經(jīng)度和緯度值的列表。值可選[經(jīng)度、緯度、經(jīng)度、緯度…]。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 坐標所在的橢球體。

result (Array.<Cartesian3>) 存儲結果的cartesian3對象數(shù)組。

Example

var positions = bmgl.Cartesian3.fromRadiansArray([-2.007, 0.645, -1.867, .575]);

(static) fromRadiansArrayHeights(coordinates, ellipsoid, result) → {Array.<Cartesian3>}

返回給定經(jīng)度、緯度和高度值數(shù)組的cartesian3位置數(shù)組，其中經(jīng)度和緯度以弧度表示。

Parameters:

coordinates (Array.<Number>) 經(jīng)度、緯度和高度值的列表。值可選[經(jīng)度、緯度、高度、經(jīng)度、緯度、高度…]。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 位置所在的橢球體。

result (Array.<Cartesian3>) 存儲結果的cartesian3對象數(shù)組。

Example

var positions = bmgl.Cartesian3.fromRadiansArrayHeights([-2.007, 0.645, 100000.0, -1.867, .575, 150000.0]);

(static) fromSpherical(spherical, result) → {Cartesian3}

將提供的球面轉換為cartesian3坐標。

Parameters:

spherical (Spherical) 要轉換為cartesian3的球形。

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

(static) lerp(start, end, t, result) → {Cartesian3}

使用提供的笛卡爾數(shù)來計算t處的線性插值或外推。

Parameters:

start (Cartesian3) 0.0時與t對應的值。

end (Cartesian3) 與t對應的值為1.0。

t (Number) 沿t插入的點。

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

(static) magnitude(cartesian) → {Number}

計算笛卡爾級數(shù)（長度）。

Parameters:

cartesian (Cartesian3) 要計算其大小的笛卡爾實例。

(static) magnitudeSquared(cartesian) → {Number}

計算提供的笛卡爾平方量級。

Parameters:

cartesian (Cartesian3) 要計算其平方大小的笛卡爾實例。

(static) maximumByComponent(first, second, result) → {Cartesian3}

比較兩個笛卡爾并計算包含所提供笛卡爾最大成分的笛卡爾。

Parameters:

first (Cartesian3) 要比較的笛卡爾。

second (Cartesian3) 要比較的笛卡爾。

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

(static) maximumComponent(cartesian) → {Number}

計算所提供笛卡爾坐標系的最大分量的值。

Parameters:

cartesian (Cartesian3) 要使用的笛卡爾。

(static) midpoint(left, right, result) → {Cartesian3}

計算右笛卡爾和左笛卡爾之間的中點。

Parameters:

left (Cartesian3) 第一個笛卡爾。

right (Cartesian3) 第二個笛卡爾。

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

(static) minimumByComponent(first, second, result) → {Cartesian3}

比較兩個笛卡爾并計算包含所提供笛卡爾的最小分量的笛卡爾。

Parameters:

first (Cartesian3) 要比較的笛卡爾。

second (Cartesian3) 要比較的笛卡爾。

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

(static) minimumComponent(cartesian) → {Number}

計算所提供笛卡爾坐標系的最小分量的值。

Parameters:

cartesian (Cartesian3) 要使用的笛卡爾。

(static) mostOrthogonalAxis(cartesian, result) → {Cartesian3}

返回與提供的笛卡爾坐標最正交的軸。

Parameters:

cartesian (Cartesian3) 找到最正交軸的笛卡爾坐標。

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

(static) multiplyByScalar(cartesian, scalar, result) → {Cartesian3}

將提供的笛卡爾分量乘以提供的標量。

Parameters:

cartesian (Cartesian3) 要縮放的笛卡爾坐標。

scalar (Number) 要與之相乘的標量。

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

(static) multiplyComponents(left, right, result) → {Cartesian3}

計算兩個笛卡爾的分量積。

Parameters:

left (Cartesian3) 第一個笛卡爾。

right (Cartesian3) 第二個笛卡爾。

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

(static) negate(cartesian, result) → {Cartesian3}

否定提供的笛卡爾。

Parameters:

cartesian (Cartesian3) 要否定的笛卡爾。

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

(static) normalize(cartesian, result) → {Cartesian3}

計算所提供笛卡爾的規(guī)范化形式。

Parameters:

cartesian (Cartesian3) 要歸一化的笛卡爾。

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

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

將提供的實例存儲到提供的數(shù)組中。

Parameters:

value (Cartesian3) 要打包的值。

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

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

(static) packArray(array, result) → {Array.<Number>}

將一組cartesian3展平為一組組件。

Parameters:

array (Array.<Cartesian3>) 要打包的笛卡爾人的陣列。

result (Array.<Number>) 存儲結果的數(shù)組。

(static) projectVector(a, b, result) → {Cartesian3}

將向量A投影到向量B上

Parameters:

a (Cartesian3) 需要投影的向量

b (Cartesian3) 要投射到的向量

result (Cartesian3) 結果笛卡爾

(static) subtract(left, right, result) → {Cartesian3}

計算兩個笛卡爾人的成分差異。

Parameters:

left (Cartesian3) 第一個笛卡爾。

right (Cartesian3) 第二個笛卡爾。

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

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

從壓縮數(shù)組中檢索實例。

Parameters:

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

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

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

(static) unpackArray(array, result) → {Array.<Cartesian3>}

將笛卡爾分量數(shù)組解包為笛卡爾3數(shù)組。

Parameters:

array (Array.<Number>) 要解包的組件數(shù)組。

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