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

用于将对象打包到数组中的元素数。

(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}

创建一个字符串，以'（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}

计算两点之间的平方距离。使用此函数比较平方距离比使用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}

从数组中的三个连续元素创建cartesian3。

Parameters:

array (Array.<Number>) 其三个连续元素分别对应于x、y和z组件的数组。

startingIndex (Number) (default 0) 第一个元素数组的偏移量，它对应于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}

从现有cartesian4创建cartesian3实例。这只需要取cartesian4的x、y和z属性，然后滴w。

Parameters:

cartesian (Cartesian4) 要从中创建cartesian3实例的cartesian4实例。

result (Cartesian3) 存储结果的对象。

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

从以度为单位的经度和纬度值返回cartesian3位置。

Parameters:

longitude (Number) 经度，以度为单位

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>}

返回给定经度和纬度值数组（以度为单位）的cartesian3位置数组。

Parameters:

coordinates (Array.<Number>) 经度和纬度值的列表。值可选[经度、纬度、经度、纬度…]。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 坐标所在的椭球体。

result (Array.<Cartesian3>) 存储结果的cartesian3对象数组。

Example

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

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

返回给定经度、纬度和高度值数组的cartesian3位置数组，其中经度和纬度以度为单位。

Parameters:

coordinates (Array.<Number>) 经度、纬度和高度值的列表。值可选[经度、纬度、高度、经度、纬度、高度…]。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 位置所在的椭球体。

result (Array.<Cartesian3>) 存储结果的cartesian3对象数组。

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坐标创建cartesian3实例。

Parameters:

x (Number) X坐标。

y (Number) Y坐标。

z (Number) Z坐标。

result (Cartesian3) 存储结果的对象。

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

从以弧度表示的经度和纬度值返回cartesian3位置。

Parameters:

longitude (Number) 经度，以弧度表示

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位置数组，该数组以弧度表示经度和纬度值。

Parameters:

coordinates (Array.<Number>) 经度和纬度值的列表。值可选[经度、纬度、经度、纬度…]。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 坐标所在的椭球体。

result (Array.<Cartesian3>) 存储结果的cartesian3对象数组。

Example

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

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

返回给定经度、纬度和高度值数组的cartesian3位置数组，其中经度和纬度以弧度表示。

Parameters:

coordinates (Array.<Number>) 经度、纬度和高度值的列表。值可选[经度、纬度、高度、经度、纬度、高度…]。

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 位置所在的椭球体。

result (Array.<Cartesian3>) 存储结果的cartesian3对象数组。

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}

使用提供的笛卡尔数来计算t处的线性插值或外推。

Parameters:

start (Cartesian3) 0.0时与t对应的值。

end (Cartesian3) 与t对应的值为1.0。

t (Number) 沿t插入的点。

result (Cartesian3) 存储结果的对象。

(static) magnitude(cartesian) → {Number}

计算笛卡尔级数（长度）。

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}

计算所提供笛卡尔的规范化形式。

Parameters:

cartesian (Cartesian3) 要归一化的笛卡尔。

result (Cartesian3) 存储结果的对象。

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

将提供的实例存储到提供的数组中。

Parameters:

value (Cartesian3) 要打包的值。

array (Array.<Number>) 要打包的数组。

startingIndex (Number) (default 0) 数组中开始打包元素的索引。

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

将一组cartesian3展平为一组组件。

Parameters:

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

result (Array.<Number>) 存储结果的数组。

(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}

从压缩数组中检索实例。

Parameters:

array (Array.<Number>) 压缩数组。

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

result (Cartesian3) 存储结果的对象。

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

将笛卡尔分量数组解包为笛卡尔3数组。

Parameters:

array (Array.<Number>) 要解包的组件数组。

result (Array.<Cartesian3>) 存储结果的数组。