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 1139

一个不可变的 三维笛卡尔 实例初始化为 (1.0, 1.0, 1.0).

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

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

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

一个不可变的 三维笛卡尔 实例初始化为 (1.0, 0.0, 0.0).

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

一个不可变的 三维笛卡尔 实例初始化为 (0.0, 1.0, 0.0).

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

一个不可变的 三维笛卡尔 实例初始化为 (0.0, 0.0, 1.0).

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

一个不可变的 三维笛卡尔 实例初始化为 (0.0, 0.0, 0.0).

Methods

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

复制此 Cartesian3 实例.
Name Type Description
result Cartesian3 optional 存储结果的对象.
Returns:
修改后的结果参数或新的 三维笛卡尔 实例（如果未提供）

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

将此笛卡尔坐标与提供的笛卡尔坐标逐个分量进行比较并返回 如果相等则为 true，否则为 false
Name Type Description
right Cartesian3 optional 右侧笛卡尔.
Returns:
如果相等则为 true，否则为 false

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

将此笛卡尔坐标与提供的笛卡尔坐标逐个分量进行比较并返回 如果通过绝对或相对公差测试，则为 true，否则为 false。
Name Type Default Description
right Cartesian3 optional 右侧笛卡尔.
relativeEpsilon number 0 optional 用于相等性测试的相对 epsilon 容差.
absoluteEpsilon number relativeEpsilon optional 用于平等测试的绝对 epsilon 容差.
Returns:
如果它们在提供的 epsilon 范围内，则为 true，否则为 false

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

创建一个表示该笛卡尔坐标的字符串，格式为"(x, y, z)".
Returns:
以"（x，y，z）"格式表示此笛卡尔的字符串.

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

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

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

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

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

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

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

将一个值限制在两个值之间.
Name Type Description
cartesian Cartesian3 要 clamp 的值.
min Cartesian3 最小边界.
max Cartesian3 最大边界.
result Cartesian3 存储结果的对象.
Returns:
限制值应满足：最小值 <= 值 <= 最大值。

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

复制 三维笛卡尔 实例.
Name Type Description
cartesian Cartesian3 笛卡尔重复.
result Cartesian3 optional 存储结果的对象.
Returns:
修改后的结果参数或新的 三维笛卡尔 实例（如果未提供)

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

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

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

计算两点之间的距离.
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 416

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

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

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

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

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

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

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

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

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

逐个比较提供的笛卡尔坐标并返回 如果通过绝对或相对公差测试，则为 true，否则为 false。
Name Type Default Description
left Cartesian3 optional 第一个笛卡尔.
right Cartesian3 optional 第二个笛卡尔.
relativeEpsilon number 0 optional 用于相等性测试的相对 epsilon 容差.
absoluteEpsilon number relativeEpsilon optional 用于平等测试的绝对 epsilon 容差.
Returns:
如果左侧和右侧在提供的 epsilon 范围内，则为 true，否则为 false。

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

根据数组中三个连续元素创建一个 三维笛卡尔 实例.
Name Type Default Description
array Array.<number> 三个连续元素分别对应 x、y 和 z 分量的数组.
startingIndex number 0 optional 第一个元素在数组中的偏移量，对应于 x 分量.
result Cartesian3 optional 存储结果的对象.
Returns:
修改后的结果参数或新的 三维笛卡尔 实例（如果未提供）
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 118

从现有的 四维笛卡尔 创建 三维笛卡尔 实例。这仅获取 四维笛卡尔 的 x、y 和 z 属性并删除 w.
Name Type Description
cartesian Cartesian4 从 四维笛卡尔 实例创建 三维笛卡尔 实例.
result Cartesian3 optional 存储结果的对象.
Returns:
修改后的结果参数或新的 三维笛卡尔 实例（如果未提供）

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

根据以度为单位的经度和纬度值返回三维笛卡尔坐标.
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.fromDegrees(-115.0, 37.0);

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

根据给定的经度和纬度值数组（以度为单位）返回 三维笛卡尔坐标数组.
Name Type Default Description
coordinates Array.<number> 经度和纬度值的列表。值交替为 [经度、纬度、经度、纬度...].
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 1046

根据经度、纬度和高度值的数组返回一个 三维笛卡尔坐标数组，其中经度和纬度以度为单位。
Name Type Default Description
coordinates Array.<number> 经度、纬度和高度值的列表。值交替为 [经度、纬度、高度、经度、纬度、高度...].
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 坐标创建一个 三维笛卡尔 实例.
Name Type Description
x number x坐标
y number y坐标
z number z坐标
result Cartesian3 optional 存储结果的对象.
Returns:
修改后的结果参数或新的 三维笛卡尔 实例（如果未提供）

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

根据以弧度表示的经度和纬度值返回 三维笛卡尔坐标.
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 1002

根据给定的弧度表示的经度和纬度值数组，返回 三维笛卡尔坐标数组.
Name Type Default Description
coordinates Array.<number> 经度和纬度值的列表。值交替为 [经度、纬度、经度、纬度...].
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 1091

根据给定的经度、纬度和高度值数组返回一个 三维笛卡尔坐标数组，其中经度和纬度以弧度表示。
Name Type Default Description
coordinates Array.<number> 经度、纬度和高度值的列表。值交替为 [经度、纬度、高度、经度、纬度、高度...].
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 要转换为 三维笛卡尔 的球面坐标.
result Cartesian3 optional 存储结果的对象.
Returns:
修改后的结果参数或新的 三维笛卡尔 实例（如果未提供）.

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

使用提供的笛卡尔坐标计算 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
engine/Source/Core/Cartesian3.js 379

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

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

计算提供的笛卡尔量级.
Name Type Description
cartesian Cartesian3 计算提供的笛卡尔量级.
Returns:
平方幅度.

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

比较两个笛卡尔坐标并计算一个包含所提供笛卡尔坐标最大分量的笛卡尔坐标。
Name Type Description
first Cartesian3 一个笛卡尔坐标.
second Cartesian3 一个笛卡尔坐标.
result Cartesian3 存储结果的对象.
Returns:
具有最大分量的笛卡尔.

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

计算提供的笛卡尔坐标系中最大分量的值.
Name Type Description
cartesian Cartesian3 要使用的笛卡尔.
Returns:
最大分量的值.

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

计算左右笛卡尔坐标之间的中点.
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 292

比较两个笛卡尔坐标并计算一个包含所提供笛卡尔坐标的最小分量的笛卡尔坐标.
Name Type Description
first Cartesian3 一个笛卡尔坐标.
second Cartesian3 一个笛卡尔坐标.
result Cartesian3 存储结果的对象.
Returns:
具有最少组件的笛卡尔.

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

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

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

返回与提供的笛卡尔坐标最正交的轴.
Name Type Description
cartesian Cartesian3 寻找最正交轴的笛卡尔坐标.
result Cartesian3 存储结果的对象.
Returns:
最正交轴.

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

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

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

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

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

否定所提供的笛卡尔.
Name Type Description
cartesian Cartesian3 笛卡尔被否定.
result Cartesian3 存储结果的对象.
Returns:
修改的结果参数

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

计算所提供的笛卡尔的规范化形式。
Name Type Description
cartesian Cartesian3 要规范化的笛卡尔.
result Cartesian3 存储结果的对象.
Returns:
修改的结果参数

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

将提供的实例存储到提供的数组中.
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 181

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

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

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

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

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

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

从打包数组中检索实例.
Name Type Default Description
array Array.<number> 压缩数组.
startingIndex number 0 optional 需要解包的元素的起始索引.
result Cartesian3 optional 存储结果的对象.
Returns:
修改后的结果参数或新的 三维笛卡尔 实例（如果未提供）

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

将笛卡尔分量数组解包为 三维笛卡尔 数组.
Name Type Description
array Array.<number> 要解包的组件数组。
result Array.<Cartesian3> optional 存储结果的数组.
Returns:
解包后的数组.
需要帮助？获得答案的最快方法是来自社区和团队 Cesium Forum.
packages/engine
packages/widgets