Cartesian3

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

一个三维笛卡尔点。
Name Type Default Description
x number 0.0 optional X分量。
y number 0.0 optional Y分量。
z number 0.0 optional Z分量。
See:

Members

x : number
engine/Source/Core/Cartesian3.js 26

X分量。
Default Value: 0.0

y : number
engine/Source/Core/Cartesian3.js 33

Y分量。
Default Value: 0.0

z : number
engine/Source/Core/Cartesian3.js 40

Z分量。
Default Value: 0.0

static constant Cesium.Cartesian3.ONE : Cartesian3
engine/Source/Core/Cartesian3.js 1144

初始化为的不可变的Cartesian3实例 (1.0, 1.0, 1.0).

static Cesium.Cartesian3.packedLength : number
engine/Source/Core/Cartesian3.js 125

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

static constant Cesium.Cartesian3.UNIT_X : Cartesian3
engine/Source/Core/Cartesian3.js 1152

初始化为的不可变的Cartesian3实例 (1.0, 0.0, 0.0).

static constant Cesium.Cartesian3.UNIT_Y : Cartesian3
engine/Source/Core/Cartesian3.js 1160

初始化为的不可变的Cartesian3实例 (0.0, 1.0, 0.0).

static constant Cesium.Cartesian3.UNIT_Z : Cartesian3
engine/Source/Core/Cartesian3.js 1168

初始化为的不可变的Cartesian3实例 (0.0, 0.0, 1.0).

static constant Cesium.Cartesian3.ZERO : Cartesian3
engine/Source/Core/Cartesian3.js 1136

初始化为的不可变的Cartesian3实例 (0.0, 0.0, 0.0).

Methods

clone(result) → Cartesian3
engine/Source/Core/Cartesian3.js 1176

复制Cartesian3 instance.
Name Type Description
result Cartesian3 optional 要在其上存储结果的对象。
Returns:
如果没有提供新的Cartesian3实例，则使用修改后的结果参数。

equals(right) → boolean
engine/Source/Core/Cartesian3.js 1187

将此笛卡尔与提供的笛卡尔分量进行比较并返回 true，否则为false。
Name Type Description
right Cartesian3 optional 右边 Cartesian.
Returns:
true，否则为false。

equalsEpsilon(right, relativeEpsilon, absoluteEpsilon) → boolean
engine/Source/Core/Cartesian3.js 1201

将此笛卡尔与提供的笛卡尔分量进行比较并返回 true 如果它们通过了绝对或相对耐受性测试， 否则 false。
Name Type Default Description
right Cartesian3 optional 右边 Cartesian.
relativeEpsilon number 0 optional 用于相等性检验的相对容差。
absoluteEpsilon number relativeEpsilon optional 用于相等性检验的绝对公差。
Returns:
true如果它们在提供的epsilon内，否则 false。

toString() → string
engine/Source/Core/Cartesian3.js 1219

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

static Cesium.Cartesian3.abs(cartesian, result) → Cartesian3
engine/Source/Core/Cartesian3.js 626

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

static Cesium.Cartesian3.add(left, right, result) → Cartesian3
engine/Source/Core/Cartesian3.js 524

计算两个笛卡尔坐标的分量和。
Name Type Description
left Cartesian3 第一个笛卡尔坐标系。
right Cartesian3 第二个笛卡尔坐标系。
result Cartesian3 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.angleBetween(left, right) → number
engine/Source/Core/Cartesian3.js 670

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

static Cesium.Cartesian3.clamp(cartesian, min, max, result) → Cartesian3
engine/Source/Core/Cartesian3.js 338

将一个值约束在两个值之间。
Name Type Description
cartesian Cartesian3 夹位的值。
min Cartesian3 最小值。
max Cartesian3 最大值。
result Cartesian3 要在其中存储结果的对象。
Returns:
使min <= value <= max的固定值。

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

复制Cartesian3 instance.
Name Type Description
cartesian Cartesian3 复制的笛卡尔坐标。
result Cartesian3 optional 要在其上存储结果的对象。
Returns:
如果没有提供新的Cartesian3实例，则使用修改后的结果参数。 (如果cartesian未定义则返回未定义)

static Cesium.Cartesian3.cross(left, right, result) → Cartesian3
engine/Source/Core/Cartesian3.js 819

计算两个笛卡尔的叉乘(外)积。
Name Type Description
left Cartesian3 第一个笛卡尔坐标系。
right Cartesian3 第二个笛卡尔坐标系。
result Cartesian3 要在其上存储结果的对象。
Returns:
叉乘

static Cesium.Cartesian3.distance(left, right) → number
engine/Source/Core/Cartesian3.js 398

计算两点之间的距离。
Name Type Description
left Cartesian3 第一个计算距离的点。
right Cartesian3 计算距离的第二个点。
Returns:
两点之间的距离
Example:
// Returns 1.0
const 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
engine/Source/Core/Cartesian3.js 420

计算两点之间距离的平方。比较平方距离 使用此函数比使用 Cartesian3#distance.
Name Type Description
left Cartesian3 第一个计算距离的点。
right Cartesian3 计算距离的第二个点。
Returns:
两点之间的距离
Example:
// Returns 4.0, not 2.0
const 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
engine/Source/Core/Cartesian3.js 587

将给定的笛卡尔分量除以给定的标量。
Name Type Description
cartesian Cartesian3 要划分的笛卡尔坐标。
scalar number 要除以的标量。
result Cartesian3 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.divideComponents(left, right, result) → Cartesian3
engine/Source/Core/Cartesian3.js 503

计算两个笛卡尔的分量商。
Name Type Description
left Cartesian3 第一个笛卡尔坐标系。
right Cartesian3 第二个笛卡尔坐标系。
result Cartesian3 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.dot(left, right) → number
engine/Source/Core/Cartesian3.js 465

计算两个笛卡尔坐标的点(标量)积。
Name Type Description
left Cartesian3 第一个笛卡尔坐标系。
right Cartesian3 第二个笛卡尔坐标系。
Returns:
点积。

static Cesium.Cartesian3.equals(left, right) → boolean
engine/Source/Core/Cartesian3.js 747

比较所提供的笛卡尔分量并返回 true，否则为false。
Name Type Description
left Cartesian3 optional 第一个Cartesian.
right Cartesian3 optional 第二个 Cartesian.
Returns:
true如果左和右相等，否则false。

static Cesium.Cartesian3.equalsEpsilon(left, right, relativeEpsilon, absoluteEpsilon) → boolean
engine/Source/Core/Cartesian3.js 780

比较所提供的笛卡尔分量并返回 true 如果它们通过了绝对或相对耐受性测试， 否则 false。
Name Type Default Description
left Cartesian3 optional 第一个Cartesian.
right Cartesian3 optional 第二个 Cartesian.
relativeEpsilon number 0 optional 用于相等性检验的相对容差。
absoluteEpsilon number relativeEpsilon optional 用于相等性检验的绝对公差。
Returns:
true如果左和右在提供的epsilon内，否则 false。

static Cesium.Cartesian3.fromArray(array, startingIndex, result) → Cartesian3
engine/Source/Core/Cartesian3.js 256

从数组中三个连续的元素创建一个Cartesian3坐标系。
Name Type Default Description
array Array.<number> 数组，其三个连续的元素分别对应x、y和z分量。
startingIndex number 0 optional 第一个元素在数组中的偏移量，对应于X分量。
result Cartesian3 optional 要在其上存储结果的对象。
Returns:
如果没有提供新的Cartesian3实例，则使用修改后的结果参数。
Example:
// Create a Cartesian3 with (1.0, 2.0, 3.0)
const v = [1.0, 2.0, 3.0];
const p = Cesium.Cartesian3.fromArray(v);

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

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

从现有的Cartesian4创建Cartesian3实例。这只需要 x, y, z的Cartesian4坐标的性质。
Name Type Description
cartesian Cartesian4 创建Cartesian3实例的Cartesian4实例。
result Cartesian3 optional 要在其上存储结果的对象。
Returns:
如果没有提供新的Cartesian3实例，则使用修改后的结果参数。

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

从以度表示的经度和纬度值返回笛卡尔位置。
Name Type Default Description
longitude number 经度，以度为单位
latitude number 纬度，以度为单位
height number 0.0 optional 椭球体上方的高度，单位为米。
ellipsoid Ellipsoid Ellipsoid.default optional 位置所在的椭球体。
result Cartesian3 optional 要在其上存储结果的对象。
Returns:
position
Example:
const position = Cesium.Cartesian3.fromDegrees(-115.0, 37.0);

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

返回Cartesian3位置数组，给定经度和纬度值数组，以度表示。
Name Type Default Description
coordinates Array.<number> 经度和纬度值的列表。值替代 [longitude, latitude, longitude, latitude...].
ellipsoid Ellipsoid Ellipsoid.default optional 坐标所在的椭球体。
result Array.<Cartesian3> optional 存储结果的笛卡尔对象数组。
Returns:
位置数组。
Example:
const positions = Cesium.Cartesian3.fromDegreesArray([-115.0, 37.0, -107.0, 33.0]);

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

返回一个Cartesian3位置数组，给定经度、纬度和高度值数组，其中经度和纬度以度数表示。
Name Type Default Description
coordinates Array.<number> 经度、纬度和高度值的列表。值替代 [longitude, latitude, height, longitude, latitude, height...].
ellipsoid Ellipsoid Ellipsoid.default optional 位置所在的椭球体。
result Array.<Cartesian3> optional 存储结果的笛卡尔对象数组。
Returns:
位置数组。
Example:
const 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
engine/Source/Core/Cartesian3.js 78

从x, y和z坐标创建一个Cartesian3实例。
Name Type Description
x number x坐标。
y number y坐标。
z number z坐标。
result Cartesian3 optional 要在其上存储结果的对象。
Returns:
如果没有提供新的Cartesian3实例，则使用修改后的结果参数。

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

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

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

返回一个笛卡尔位置数组，给定以弧度表示的经度和纬度值数组。
Name Type Default Description
coordinates Array.<number> 经度和纬度值的列表。值替代 [longitude, latitude, longitude, latitude...].
ellipsoid Ellipsoid Ellipsoid.default optional 坐标所在的椭球体。
result Array.<Cartesian3> optional 存储结果的笛卡尔对象数组。
Returns:
位置数组。
Example:
const positions = Cesium.Cartesian3.fromRadiansArray([-2.007, 0.645, -1.867, .575]);

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

返回一个Cartesian3位置数组，给定经度、纬度和高度值数组，其中经度和纬度以弧度表示。
Name Type Default Description
coordinates Array.<number> 经度、纬度和高度值的列表。值替代 [longitude, latitude, height, longitude, latitude, height...].
ellipsoid Ellipsoid Ellipsoid.default optional 位置所在的椭球体。
result Array.<Cartesian3> optional 存储结果的笛卡尔对象数组。
Returns:
位置数组。
Example:
const positions = Cesium.Cartesian3.fromRadiansArrayHeights([-2.007, 0.645, 100000.0, -1.867, .575, 150000.0]);

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

将提供的球面转换为笛卡尔坐标。
Name Type Description
spherical Spherical 将球面转换为Cartesian3坐标系。
result Cartesian3 optional 要在其上存储结果的对象。
Returns:
如果没有提供新的Cartesian3实例，则使用修改后的结果参数。

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

使用提供的笛卡儿计算t处的线性插值或外推。
Name Type Description
start Cartesian3 对应于t在0.0处的值。
end Cartesian3 对应于1.0时t的值。
t number 沿着t进行插值的点。
result Cartesian3 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.magnitude(cartesian) → number
engine/Source/Core/Cartesian3.js 381

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

static Cesium.Cartesian3.magnitudeSquared(cartesian) → number
engine/Source/Core/Cartesian3.js 363

计算给定的笛卡尔坐标的平方幅度。
Name Type Description
cartesian Cartesian3 要计算其模的平方的笛卡尔实例。
Returns:
大小的平方。

static Cesium.Cartesian3.maximumByComponent(first, second, result) → Cartesian3
engine/Source/Core/Cartesian3.js 316

比较两个笛卡尔坐标并计算一个包含所提供笛卡尔坐标的最大分量的笛卡尔坐标。
Name Type Description
first Cartesian3 用笛卡尔坐标来比较。
second Cartesian3 用笛卡尔坐标来比较。
result Cartesian3 要在其中存储结果的对象。
Returns:
A cartesian with the maximum components.

static Cesium.Cartesian3.maximumComponent(cartesian) → number
engine/Source/Core/Cartesian3.js 264

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

static Cesium.Cartesian3.midpoint(left, right, result) → Cartesian3
engine/Source/Core/Cartesian3.js 850

计算左右笛卡尔坐标之间的中点。
Name Type Description
left Cartesian3 第一个笛卡尔坐标系。
right Cartesian3 第二个笛卡尔坐标系。
result Cartesian3 要在其上存储结果的对象。
Returns:
The midpoint.

static Cesium.Cartesian3.minimumByComponent(first, second, result) → Cartesian3
engine/Source/Core/Cartesian3.js 294

比较两个笛卡尔坐标并计算一个包含所提供笛卡尔坐标的最小分量的笛卡尔坐标。
Name Type Description
first Cartesian3 用笛卡尔坐标来比较。
second Cartesian3 用笛卡尔坐标来比较。
result Cartesian3 要在其中存储结果的对象。
Returns:
具有最小分量的笛卡尔曲线。

static Cesium.Cartesian3.minimumComponent(cartesian) → number
engine/Source/Core/Cartesian3.js 278

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

static Cesium.Cartesian3.mostOrthogonalAxis(cartesian, result) → Cartesian3
engine/Source/Core/Cartesian3.js 697

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

static Cesium.Cartesian3.multiplyByScalar(cartesian, scalar, result) → Cartesian3
engine/Source/Core/Cartesian3.js 566

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

static Cesium.Cartesian3.multiplyComponents(left, right, result) → Cartesian3
engine/Source/Core/Cartesian3.js 482

计算两个笛卡尔坐标的分量积。
Name Type Description
left Cartesian3 第一个笛卡尔坐标系。
right Cartesian3 第二个笛卡尔坐标系。
result Cartesian3 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.negate(cartesian, result) → Cartesian3
engine/Source/Core/Cartesian3.js 607

否定提供的笛卡尔坐标。
Name Type Description
cartesian Cartesian3 笛卡尔坐标被否定了。
result Cartesian3 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.normalize(cartesian, result) → Cartesian3
engine/Source/Core/Cartesian3.js 437

计算提供的笛卡尔坐标的规范化形式。
Name Type Description
cartesian Cartesian3 笛卡尔坐标被归一化。
result Cartesian3 要在其上存储结果的对象。
Returns:
修改后的结果参数。

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

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

static Cesium.Cartesian3.packArray(array, result) → Array.<number>
engine/Source/Core/Cartesian3.js 183

将笛Cartesian3的数组平展为一个分量数组。
Name Type Description
array Array.<Cartesian3> 要打包的笛卡儿数组。
result Array.<number> optional 要在其中存储结果的数组。 如果这是一个类型化数组，它必须有array。 array.length * 3个组件，否则将抛出DeveloperError。如果它是一个常规数组，它的大小将被调整为(array.length * 3)元素。
Returns:
打包数组。

static Cesium.Cartesian3.projectVector(a, b, result) → Cartesian3
engine/Source/Core/Cartesian3.js 728

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

static Cesium.Cartesian3.subtract(left, right, result) → Cartesian3
engine/Source/Core/Cartesian3.js 545

计算两个笛卡尔坐标的分量差。
Name Type Description
left Cartesian3 第一个笛卡尔坐标系。
right Cartesian3 第二个笛卡尔坐标系。
result Cartesian3 要在其上存储结果的对象。
Returns:
修改后的结果参数。

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

从打包数组中检索实例。
Name Type Default Description
array Array.<number> 打包数组。
startingIndex number 0 optional 要解压缩的元素的起始索引。
result Cartesian3 optional 要在其中存储结果的对象。
Returns:
如果没有提供新的Cartesian3实例，则使用修改后的结果参数。

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

将一个笛卡尔分量数组解包为一个Cartesian3数组。
Name Type Description
array Array.<number> 要解包的组件数组。
result Array.<Cartesian3> optional 要在其中存储结果的数组。
Returns:
未打包的数组。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
packages/engine
packages/widgets