Cartesian3

new Cesium.Cartesian3 ( x , y , z )
Core/Cartesian3.js 20

3D笛卡尔点。
Name Type Default Description
x Number 0.0 可选 X组件。
y Number 0.0 可选 Y分量。
z Number 0.0 可选 Z分量。
See:
翻译by:http://cesium.xin

Members

x : Number
Core/Cartesian3.js 26

X组件。
Default Value: 0.0

y : Number
Core/Cartesian3.js 33

Y分量。
Default Value: 0.0

z : Number
Core/Cartesian3.js 40

Z分量。
Default Value: 0.0

static Cesium.Cartesian3.packedLength : Number
Core/Cartesian3.js 125

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

static constant Cesium.Cartesian3.UNIT_X : Cartesian3
Core/Cartesian3.js 1110

一个不变的Cartesian3实例，初始化为（1.0，0.0，0.0）。

static constant Cesium.Cartesian3.UNIT_Y : Cartesian3
Core/Cartesian3.js 1118

一个不变的Cartesian3实例，初始化为（0.0，1.0，0.0）。

static constant Cesium.Cartesian3.UNIT_Z : Cartesian3
Core/Cartesian3.js 1126

一个不变的Cartesian3实例，初始化为（0.0，0.0，1.0）。

static constant Cesium.Cartesian3.ZERO : Cartesian3
Core/Cartesian3.js 1102

一个不变的Cartesian3实例，初始化为（0.0，0.0，0.0）。

Methods

clone ( result ) → Cartesian3
Core/Cartesian3.js 1134

复制此Cartesian3实例。
Name Type Description
result Cartesian3 可选 将结果存储到的对象。
Returns:
修改后的结果参数，或者未提供新的Cartesian3实例。

equals ( right ) → Boolean
Core/Cartesian3.js 1145

将此笛卡尔坐标与提供的笛卡尔分量进行比较，然后返回如果相等，则为 true ，否则为 false 。
Name Type Description
right Cartesian3 可选 右侧笛卡尔坐标。
Returns:
真正 如果相等， 假 除此以外。

equalsEpsilon ( right , relativeEpsilon , absoluteEpsilon ) → Boolean
Core/Cartesian3.js 1159

将此笛卡尔坐标与提供的笛卡尔分量进行比较，然后返回 true 如果它们通过绝对或相对公差测试，否则为 false 。
Name Type Default Description
right Cartesian3 可选 右侧笛卡尔坐标。
relativeEpsilon Number 0 可选 用于相等性测试的相对epsilon公差。
absoluteEpsilon Number relativeEpsilon 可选 用于相等性测试的绝对epsilon公差。
Returns:
真正 如果它们在提供的epsilon中， 假 除此以外。

toString () → String
Core/Cartesian3.js 1177

创建一个以'（x，y，z）'格式表示此笛卡尔坐标的字符串。
Returns:
以'（x，y，z）'格式表示此笛卡尔坐标的字符串。

static Cesium.Cartesian3.abs (cartesian, result) → Cartesian3
Core/Cartesian3.js 595

计算提供的笛卡尔坐标的绝对值。
Name Type Description
cartesian Cartesian3 要计算其绝对值的笛卡尔坐标。
result Cartesian3 将结果存储到的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.add (left, right, result) → Cartesian3
Core/Cartesian3.js 493

计算两个笛卡尔的按分量求和。
Name Type Description
left Cartesian3 第一个笛卡尔式。
right Cartesian3 第二个笛卡尔。
result Cartesian3 将结果存储到的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.angleBetween (left, right) → Number
Core/Cartesian3.js 639

返回所提供的笛卡尔坐标之间的角度（以弧度为单位）。
Name Type Description
left Cartesian3 第一个笛卡尔式。
right Cartesian3 第二个笛卡尔。
Returns:
笛卡尔之间的角度。

static Cesium.Cartesian3.clone (cartesian, result ) → Cartesian3
Core/Cartesian3.js 96

复制Cartesian3实例。
Name Type Description
cartesian Cartesian3 要复制的笛卡尔坐标。
result Cartesian3 可选 将结果存储到的对象。
Returns:
修改后的结果参数，或者未提供新的Cartesian3实例。 （如果未定义笛卡尔，则返回undefined）

static Cesium.Cartesian3.cross (left, right, result) → Cartesian3
Core/Cartesian3.js 788

计算两个笛卡尔的叉（外）乘积。
Name Type Description
left Cartesian3 第一个笛卡尔式。
right Cartesian3 第二个笛卡尔。
result Cartesian3 将结果存储到的对象。
Returns:
叉积。

static Cesium.Cartesian3.distance (left, right) → Number
Core/Cartesian3.js 367

计算两点之间的距离。
Name Type Description
left Cartesian3 计算距离的第一点。
right Cartesian3 计算距离的第二点。
Returns:
两点之间的距离。
Example: 
// Returns 1.0
var d = Cesium.Cartesian3.distance(new Cesium.Cartesian3(1.0, 0.0, 0.0), new Cesium.Cartesian3(2.0, 0.0, 0.0));

static Cesium.Cartesian3.distanceSquared (left, right) → Number
Core/Cartesian3.js 389

计算两点之间的平方距离。比较平方距离使用此功能比使用 Cartesian3＃distance 比较距离更有效。
Name Type Description
left Cartesian3 计算距离的第一点。
right Cartesian3 计算距离的第二点。
Returns:
两点之间的距离。
Example: 
// Returns 4.0, not 2.0
var d = Cesium.Cartesian3.distanceSquared(new Cesium.Cartesian3(1.0, 0.0, 0.0), new Cesium.Cartesian3(3.0, 0.0, 0.0));

static Cesium.Cartesian3.divideByScalar (cartesian, scalar, result) → Cartesian3
Core/Cartesian3.js 556

将提供的笛卡尔分量除以提供的标量。
Name Type Description
cartesian Cartesian3 要划分的笛卡尔坐标。
scalar Number 要除以的标量。
result Cartesian3 将结果存储到的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.divideComponents (left, right, result) → Cartesian3
Core/Cartesian3.js 472

计算两个笛卡尔的分量商。
Name Type Description
left Cartesian3 第一个笛卡尔式。
right Cartesian3 第二个笛卡尔。
result Cartesian3 将结果存储到的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.dot (left, right) → Number
Core/Cartesian3.js 434

计算两个笛卡尔的点（标量）乘积。
Name Type Description
left Cartesian3 第一个笛卡尔式。
right Cartesian3 第二个笛卡尔。
Returns:
点积。

static Cesium.Cartesian3.equals ( left , right ) → Boolean
Core/Cartesian3.js 716

比较提供的笛卡尔分量，然后返回如果相等，则为 true ，否则为 false 。
Name Type Description
left Cartesian3 可选 第一个笛卡尔式。
right Cartesian3 可选 第二个笛卡尔。
Returns:
真正 如果左右相等 假 除此以外。

static Cesium.Cartesian3.equalsEpsilon ( left , right , relativeEpsilon , absoluteEpsilon ) → Boolean
Core/Cartesian3.js 749

比较提供的笛卡尔分量，然后返回 true 如果它们通过绝对或相对公差测试，否则为 false 。
Name Type Default Description
left Cartesian3 可选 第一个笛卡尔式。
right Cartesian3 可选 第二个笛卡尔。
relativeEpsilon Number 0 可选 用于相等性测试的相对epsilon公差。
absoluteEpsilon Number relativeEpsilon 可选 用于相等性测试的绝对epsilon公差。
Returns:
真正 如果左右在提供的epsilon之内， 假 除此以外。

static Cesium.Cartesian3.fromArray (array, startingIndex , result ) → Cartesian3
Core/Cartesian3.js 253

从数组中的三个连续元素创建Cartesian3。
Name Type Default Description
array Array.<Number> 其三个连续元素分别对应于x，y和z分量的数组。
startingIndex Number 0 可选 第一个元素数组的偏移量，它对应于x分量。
result Cartesian3 可选 将结果存储到的对象。
Returns:
修改后的结果参数，或者未提供新的Cartesian3实例。
Example: 
// Create a Cartesian3 with (1.0, 2.0, 3.0)
var v = [1.0, 2.0, 3.0];
var p = Cesium.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 = Cesium.Cartesian3.fromArray(v2, 2);

static Cesium.Cartesian3.fromCartesian4 (cartesian, result ) → Cartesian3
Core/Cartesian3.js 119

从现有的Cartesian4创建Cartesian3实例。这只是需要笛卡尔4和水滴w的x，y和z属性。
Name Type Description
cartesian Cartesian4 Cartesian4实例，用于从中创建Cartesian3实例。
result Cartesian3 可选 将结果存储到的对象。
Returns:
修改后的结果参数，或者未提供新的Cartesian3实例。

static Cesium.Cartesian3.fromDegrees (longitude, latitude, height , ellipsoid , result ) → Cartesian3
Core/Cartesian3.js 846

从以度为单位的经度和纬度值返回Cartesian3位置。
Name Type Default Description
longitude Number 经度，以度为单位
latitude Number 纬度，以度为单位
height Number 0.0 可选 椭球上方的高度，以米为单位。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 位置所在的椭圆体。
result Cartesian3 可选 将结果存储到的对象。
Returns:
职位
Example: 
var position = Cesium.Cartesian3.fromDegrees(-115.0, 37.0);

static Cesium.Cartesian3.fromDegreesArray (coordinates, ellipsoid , result ) → Array.< Cartesian3 >
Core/Cartesian3.js 929

返回给定的经度和纬度值数组（以度为单位），该数组由Cartesian3位置组成。
Name Type Default Description
coordinates Array.<Number> 经度和纬度值列表。值交替显示[经度，纬度，经度，纬度...]。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 坐标所在的椭球。
result Array.< Cartesian3 > 可选 一组Cartesian3对象用于存储结果。
Returns:
位置数组。
Example: 
var positions = Cesium.Cartesian3.fromDegreesArray([-115.0, 37.0, -107.0, 33.0]);

static Cesium.Cartesian3.fromDegreesArrayHeights (coordinates, ellipsoid , result ) → Array.< Cartesian3 >
Core/Cartesian3.js 1017

返回给定的经度，纬度和高度值数组，其中经度和纬度以度为单位的Cartesian3位置数组。
Name Type Default Description
coordinates Array.<Number> 经度，纬度和高度值的列表。值交替显示[经度，纬度，高度，经度，纬度，高度...]。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 位置所在的椭圆体。
result Array.< Cartesian3 > 可选 一组Cartesian3对象用于存储结果。
Returns:
位置数组。
Example: 
var positions = Cesium.Cartesian3.fromDegreesArrayHeights([-115.0, 37.0, 100000.0, -107.0, 33.0, 150000.0]);

static Cesium.Cartesian3.fromElements (x, y, z, result ) → Cartesian3
Core/Cartesian3.js 78

根据x，y和z坐标创建Cartesian3实例。
Name Type Description
x Number x坐标。
y Number y坐标。
z Number z坐标。
result Cartesian3 可选 将结果存储到的对象。
Returns:
修改后的结果参数，或者未提供新的Cartesian3实例。

static Cesium.Cartesian3.fromRadians (longitude, latitude, height , ellipsoid , result ) → Cartesian3
Core/Cartesian3.js 884

从以弧度给出的经度和纬度值返回Cartesian3位置。
Name Type Default Description
longitude Number 经度，以弧度为单位
latitude Number 纬度，以弧度为单位
height Number 0.0 可选 椭球上方的高度，以米为单位。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 位置所在的椭圆体。
result Cartesian3 可选 将结果存储到的对象。
Returns:
职位
Example: 
var position = Cesium.Cartesian3.fromRadians(-2.007, 0.645);

static Cesium.Cartesian3.fromRadiansArray (coordinates, ellipsoid , result ) → Array.< Cartesian3 >
Core/Cartesian3.js 973

返回给定的笛卡尔3位置数组，该数组给出以弧度给出的经度和纬度值的数组。
Name Type Default Description
coordinates Array.<Number> 经度和纬度值列表。值交替显示[经度，纬度，经度，纬度...]。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 坐标所在的椭球。
result Array.< Cartesian3 > 可选 一组Cartesian3对象用于存储结果。
Returns:
位置数组。
Example: 
var positions = Cesium.Cartesian3.fromRadiansArray([-2.007, 0.645, -1.867, .575]);

static Cesium.Cartesian3.fromRadiansArrayHeights (coordinates, ellipsoid , result ) → Array.< Cartesian3 >
Core/Cartesian3.js 1062

返回给定的经度，纬度和高度值数组，其中经度和纬度以弧度表示的Cartesian3位置数组。
Name Type Default Description
coordinates Array.<Number> 经度，纬度和高度值的列表。值交替显示[经度，纬度，高度，经度，纬度，高度...]。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 位置所在的椭圆体。
result Array.< Cartesian3 > 可选 一组Cartesian3对象用于存储结果。
Returns:
位置数组。
Example: 
var positions = Cesium.Cartesian3.fromRadiansArrayHeights([-2.007, 0.645, 100000.0, -1.867, .575, 150000.0]);

static Cesium.Cartesian3.fromSpherical (spherical, result ) → Cartesian3
Core/Cartesian3.js 50

将提供的Spherical转换为Cartesian3坐标。
Name Type Description
spherical Spherical 要转换为笛卡尔3的球形。
result Cartesian3 可选 将结果存储到的对象。
Returns:
修改后的结果参数，或者未提供新的Cartesian3实例。

static Cesium.Cartesian3.lerp (start, end, t, result) → Cartesian3
Core/Cartesian3.js 617

使用提供的笛卡尔坐标计算t处的线性插值或外推。
Name Type Description
start Cartesian3 对应于t的值为0.0。
end Cartesian3 对应于t的值为1.0。
t Number 沿t的插值点。
result Cartesian3 将结果存储到的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.magnitude (cartesian) → Number
Core/Cartesian3.js 350

计算笛卡尔的大小（长度）。
Name Type Description
cartesian Cartesian3 要计算其大小的笛卡尔实例。
Returns:
幅度。

static Cesium.Cartesian3.magnitudeSquared (cartesian) → Number
Core/Cartesian3.js 332

计算提供的笛卡尔平方强度。
Name Type Description
cartesian Cartesian3 要计算其平方大小的笛卡尔实例。
Returns:
平方值。

static Cesium.Cartesian3.maximumByComponent (first, second, result) → Cartesian3
Core/Cartesian3.js 313

比较两个笛卡尔，并计算一个笛卡尔，其中包含所提供笛卡尔的最大分量。
Name Type Description
first Cartesian3 笛卡尔进行比较。
second Cartesian3 笛卡尔进行比较。
result Cartesian3 将结果存储到的对象。
Returns:
具有最大分量的笛卡尔。

static Cesium.Cartesian3.maximumComponent (cartesian) → Number
Core/Cartesian3.js 261

计算所提供的直角坐标的最大分量的值。
Name Type Description
cartesian Cartesian3 要使用的笛卡尔坐标。
Returns:
最大分量的值。

static Cesium.Cartesian3.midpoint (left, right, result) → Cartesian3
Core/Cartesian3.js 819

计算左右笛卡尔坐标之间的中点。
Name Type Description
left Cartesian3 第一个笛卡尔式。
right Cartesian3 第二个笛卡尔。
result Cartesian3 将结果存储到的对象。
Returns:
中点。

static Cesium.Cartesian3.minimumByComponent (first, second, result) → Cartesian3
Core/Cartesian3.js 291

比较两个笛卡尔，并计算一个笛卡尔，其中包含所提供笛卡尔的最小分量。
Name Type Description
first Cartesian3 笛卡尔进行比较。
second Cartesian3 笛卡尔进行比较。
result Cartesian3 将结果存储到的对象。
Returns:
具有最少成分的笛卡尔。

static Cesium.Cartesian3.minimumComponent (cartesian) → Number
Core/Cartesian3.js 275

计算所提供的直角坐标的最小分量的值。
Name Type Description
cartesian Cartesian3 要使用的笛卡尔坐标。
Returns:
最小成分的值。

static Cesium.Cartesian3.mostOrthogonalAxis (cartesian, result) → Cartesian3
Core/Cartesian3.js 666

返回与提供的笛卡尔坐标最正交的轴。
Name Type Description
cartesian Cartesian3 要在其上找到最正交轴的笛卡尔坐标。
result Cartesian3 将结果存储到的对象。
Returns:
最正交的轴。

static Cesium.Cartesian3.multiplyByScalar (cartesian, scalar, result) → Cartesian3
Core/Cartesian3.js 535

将提供的笛卡尔分量乘以提供的标量。
Name Type Description
cartesian Cartesian3 要缩放的笛卡尔坐标。
scalar Number 要与之相乘的标量。
result Cartesian3 将结果存储到的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.multiplyComponents (left, right, result) → Cartesian3
Core/Cartesian3.js 451

计算两个笛卡尔的分量积。
Name Type Description
left Cartesian3 第一个笛卡尔式。
right Cartesian3 第二个笛卡尔。
result Cartesian3 将结果存储到的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.negate (cartesian, result) → Cartesian3
Core/Cartesian3.js 576

取反提供的笛卡尔坐标。
Name Type Description
cartesian Cartesian3 笛卡尔要否定。
result Cartesian3 将结果存储到的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.normalize (cartesian, result) → Cartesian3
Core/Cartesian3.js 406

计算提供的笛卡尔坐标系的标准化形式。
Name Type Description
cartesian Cartesian3 要标准化的笛卡尔坐标。
result Cartesian3 将结果存储到的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.pack (value, array, startingIndex ) → Array.<Number>
Core/Cartesian3.js 136

将提供的实例存储到提供的数组中。
Name Type Default Description
value Cartesian3 要打包的值。
array Array.<Number> 要打包的数组。
startingIndex Number 0 可选 开始打包元素的数组索引。
Returns:
打包到的数组

static Cesium.Cartesian3.packArray (array, result ) → Array.<Number>
Core/Cartesian3.js 182

将笛卡尔3数组展平为组件数组。
Name Type Description
array Array.< Cartesian3 > 要打包的笛卡尔数组。
result Array.<Number> 可选 将结果存储到的数组。如果这是类型化的数组，则必须具有array.length * 3个组件，否则将抛出 DeveloperError 。如果它是常规数组，则将其大小调整为具有（array.length * 3）个元素。
Returns:
压缩数组。

static Cesium.Cartesian3.projectVector (a, b, result) → Cartesian3
Core/Cartesian3.js 697

将向量a投射到向量b上
Name Type Description
a Cartesian3 需要投影的向量
b Cartesian3 要投影到的向量
result Cartesian3 结果笛卡尔
Returns:
修改后的结果参数

static Cesium.Cartesian3.subtract (left, right, result) → Cartesian3
Core/Cartesian3.js 514

计算两个笛卡尔的分量差异。
Name Type Description
left Cartesian3 第一个笛卡尔式。
right Cartesian3 第二个笛卡尔。
result Cartesian3 将结果存储到的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.unpack (array, startingIndex , result ) → Cartesian3
Core/Cartesian3.js 159

从压缩数组中检索实例。
Name Type Default Description
array Array.<Number> 压缩数组。
startingIndex Number 0 可选 要解压缩的元素的起始索引。
result Cartesian3 可选 将结果存储到的对象。
Returns:
修改后的结果参数，或者未提供新的Cartesian3实例。

static Cesium.Cartesian3.unpackArray (array, result ) → Array.< Cartesian3 >
Core/Cartesian3.js 212

将笛卡尔组件数组解压缩为笛卡尔3数组。
Name Type Description
array Array.<Number> 要解包的组件数组。
result Array.< Cartesian3 > 可选 将结果存储到的数组。
Returns:
解压缩的数组。