Cartesian2

一个二维笛卡尔点。

new Cesium.Cartesian2(x, y)
engine/Source/Core/Cartesian2.js 18

Name Type Default Description
x number 0.0 optional X 组件
y number 0.0 optional Y 分量
See:

Members

x : number
engine/Source/Core/Cartesian2.js 29

X 组件
Default Value: 0.0

y : number
engine/Source/Core/Cartesian2.js 36

Y 分量
Default Value: 0.0

static constant Cesium.Cartesian2.ONE : Cartesian2
engine/Source/Core/Cartesian2.js 805

一个不可变的 Cartesian2 实例，初始化为 (1.0, 1.0)。

static Cesium.Cartesian2.packedLength : number
engine/Source/Core/Cartesian2.js 760

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

static constant Cesium.Cartesian2.UNIT_X : Cartesian2
engine/Source/Core/Cartesian2.js 813

一个不可变的 Cartesian2 实例，初始化为 (1.0, 0.0)。

static constant Cesium.Cartesian2.UNIT_Y : Cartesian2
engine/Source/Core/Cartesian2.js 821

一个不可变的 Cartesian2 实例，初始化为 (0.0, 1.0)。

static constant Cesium.Cartesian2.ZERO : Cartesian2
engine/Source/Core/Cartesian2.js 797

一个不可变的 Cartesian2 实例，初始化为 (0.0, 0.0)。

Methods

clone(result) → Cartesian2
engine/Source/Core/Cartesian2.js 692

复制此 Cartesian2 实例。
Name Type Description
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的结果参数，或者如果未提供，则为一个新的 Cartesian2 实例。

equals(right) → boolean
engine/Source/Core/Cartesian2.js 703

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

equalsEpsilon(right, relativeEpsilon, absoluteEpsilon) → boolean
engine/Source/Core/Cartesian2.js 717

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

toString() → string
engine/Source/Core/Cartesian2.js 731

创建一个字符串，表示这个笛卡尔坐标，格式为“(x, y)”。
Returns:
一个字符串，表示给定的笛卡尔坐标，格式为“(x, y)”。

static Cesium.Cartesian2.abs(cartesian, result) → Cartesian2
engine/Source/Core/Cartesian2.js 550

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

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

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

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

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

static Cesium.Cartesian2.clamp(value, min, max, result) → Cartesian2
engine/Source/Core/Cartesian2.js 263

将一个值限制在两个值之间。
Name Type Description
value Cartesian2 要限制的值。
min Cartesian2 最小界限。
max Cartesian2 最大界限。
result Cartesian2 用于存储结果的对象。
Returns:
将值限制在 min 和 max 之间，使结果满足 min <= 结果 <= max。

static Cesium.Cartesian2.clone(cartesian, result) → Cartesian2
engine/Source/Core/Cartesian2.js 64

复制一个 Cartesian2 实例。
Name Type Description
cartesian Cartesian2 笛卡尔复制。
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的结果参数，或者如果未提供则为新的 Cartesian2 实例。（如果 cartesian 未定义，则返回 undefined）

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

计算输入向量的叉积的大小，假设将其 Z 坐标隐式设为 0
Name Type Description
left Cartesian2 第一个笛卡尔
right Cartesian2 第二个笛卡尔
Returns:
叉积

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

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

static Cesium.Cartesian2.distanceSquared(left, right) → number
engine/Source/Core/Cartesian2.js 336

计算两点之间的平方距离。使用此函数比较平方距离比使用 Cartesian2#distance 比较距离更高效。
Name Type Description
left Cartesian2 计算距离的第一个点。
right Cartesian2 要计算距离的第二个点。
Returns:
两点之间的距离。
Example:
// Returns 4.0, not 2.0
const d = Cesium.Cartesian2.distance(new Cesium.Cartesian2(1.0, 0.0), new Cesium.Cartesian2(3.0, 0.0));

static Cesium.Cartesian2.divideByScalar(cartesian, scalar, result) → Cartesian2
engine/Source/Core/Cartesian2.js 513

将提供的笛卡尔分量逐个除以提供的标量。
Name Type Description
cartesian Cartesian2 笛卡尔要被分割。
scalar number 要除以的标量。
result Cartesian2 用于存储结果的对象。
Returns:
修改后的结果参数。

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

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

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

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

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

对提供的笛卡尔坐标进行分量比较，如果它们相等则返回true，否则返回false。
Name Type Description
left Cartesian2 optional 第一个笛卡尔
right Cartesian2 optional 第二个笛卡尔
Returns:
如果 left 和 right 相等，则为 true，否则为 false。

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

对提供的笛卡尔坐标进行分量比较，如果它们通过绝对或相对容差测试，则返回 true，否则返回 false。
Name Type Default Description
left Cartesian2 optional 第一个笛卡尔
right Cartesian2 optional 第二个笛卡尔
relativeEpsilon number 0 optional 用于相等性测试的相对 epsilon 容差。
absoluteEpsilon number relativeEpsilon optional 用于相等性测试的绝对 epsilon 容差。
Returns:
如果左值和右值在提供的 epsilon 范围内，true，否则 false。

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

从数组中的两个连续元素创建一个 Cartesian2。
Name Type Default Description
array Array.<number> 数组，其两个连续元素分别对应 x 和 y 分量。
startingIndex number 0 optional 第一个元素在数组中的偏移量，对应 x 分量。
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的 result 参数，或者如果未提供则返回一个新的 Cartesian2 实例。
Example:
// Create a Cartesian2 with (1.0, 2.0)
const v = [1.0, 2.0];
const p = Cesium.Cartesian2.fromArray(v);

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

static Cesium.Cartesian2.fromCartesian3(cartesian, result) → Cartesian2
engine/Source/Core/Cartesian2.js 744

从现有的 Cartesian3 创建一个 Cartesian2 实例。这只是取 Cartesian3 的 x 和 y 属性，并忽略 z。
Name Type Description
cartesian Cartesian3 要从中创建 Cartesian2 实例的 Cartesian3 实例。
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的 result 参数，或者如果未提供，则返回一个新的 Cartesian2 实例。

static Cesium.Cartesian2.fromCartesian4(cartesian, result) → Cartesian2
engine/Source/Core/Cartesian2.js 754

从已有的 Cartesian4 创建一个 Cartesian2 实例。这只是取 Cartesian4 的 x 和 y 属性，忽略 z 和 w。
Name Type Description
cartesian Cartesian4 要从中创建 Cartesian2 实例的 Cartesian4 对象。
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的 result 参数，如果没有提供则返回一个新的 Cartesian2 实例。

static Cesium.Cartesian2.fromElements(x, y, result) → Cartesian2
engine/Source/Core/Cartesian2.js 47

根据 x 和 y 坐标创建一个 Cartesian2 实例。
Name Type Description
x number x 坐标。
y number y 坐标。
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的结果参数，或者如果未提供，则为一个新的 Cartesian2 实例。

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

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

static Cesium.Cartesian2.magnitude(cartesian) → number
engine/Source/Core/Cartesian2.js 300

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

static Cesium.Cartesian2.magnitudeSquared(cartesian) → number
engine/Source/Core/Cartesian2.js 286

计算所提供笛卡尔坐标的平方大小。
Name Type Description
cartesian Cartesian2 要计算其平方大小的笛卡尔实例。
Returns:
平方大小。

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

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

static Cesium.Cartesian2.maximumComponent(cartesian) → number
engine/Source/Core/Cartesian2.js 191

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

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

比较两个笛卡尔坐标，并计算一个包含所提供笛卡尔坐标中最小分量的笛卡尔坐标。
Name Type Description
first Cartesian2 一个用于比较的笛卡尔图。
second Cartesian2 一个用于比较的笛卡尔图。
result Cartesian2 用于存储结果的对象。
Returns:
一个具有最少分量的笛卡尔坐标

static Cesium.Cartesian2.minimumComponent(cartesian) → number
engine/Source/Core/Cartesian2.js 205

计算所提供笛卡尔坐标的最小分量值。
Name Type Description
cartesian Cartesian2 要使用的笛卡尔坐标
Returns:
最小组件的值。

static Cesium.Cartesian2.mostOrthogonalAxis(cartesian, result) → Cartesian2
engine/Source/Core/Cartesian2.js 610

返回与提供的笛卡尔坐标最正交的轴。
Name Type Description
cartesian Cartesian2 用于找到最正交轴的笛卡尔坐标系。
result Cartesian2 用于存储结果的对象。
Returns:
最正交的轴。

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

将提供的笛卡尔分量按提供的标量逐项相乘。
Name Type Description
cartesian Cartesian2 将要缩放的笛卡尔坐标。
scalar number 要相乘的标量。
result Cartesian2 用于存储结果的对象。
Returns:
修改后的结果参数。

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

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

static Cesium.Cartesian2.negate(cartesian, result) → Cartesian2
engine/Source/Core/Cartesian2.js 532

否定提供的笛卡尔坐标。
Name Type Description
cartesian Cartesian2 要否定的笛卡尔坐标。
result Cartesian2 用于存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian2.normalize(cartesian, result) → Cartesian2
engine/Source/Core/Cartesian2.js 353

计算所提供笛卡尔坐标的归一化形式。
Name Type Description
cartesian Cartesian2 需要归一化的笛卡尔坐标。
result Cartesian2 用于存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian2.pack(value, array, startingIndex) → Array.<number>|Float64Array|Float32Array
engine/Source/Core/Cartesian2.js 86

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

static Cesium.Cartesian2.packArray(array, result) → Array.<number>|Float64Array|Float32Array
engine/Source/Core/Cartesian2.js 130

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

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

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

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

从打包数组中检索实例。
Name Type Default Description
array Array.<number> | Float64Array | Float32Array 打包数组
startingIndex number 0 optional 要解包的元素的起始索引。
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的结果参数，或者如果未提供，则为一个新的 Cartesian2 实例。

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

将一组笛卡尔分量解包到一组 Cartesian2 中。
Name Type Description
array Array.<number> 要解压的组件数组。
result Array.<Cartesian2> optional 用于存储结果的数组。
Returns:
已解包的数组。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
CtrlK
packages/engine
packages/widgets