Cartesian2

一个二维笛卡尔点。

new Cesium.Cartesian2(x, y)

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

Members

X 分量。
Default Value: 0.0
Y 分量。
Default Value: 0.0

static constant Cesium.Cartesian2.ONE : Cartesian2

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

static Cesium.Cartesian2.packedLength : number

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

static constant Cesium.Cartesian2.UNIT_X : Cartesian2

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

static constant Cesium.Cartesian2.UNIT_Y : Cartesian2

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

static constant Cesium.Cartesian2.ZERO : Cartesian2

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

Methods

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

equals(right)boolean

逐分量比较此笛卡尔与给定的笛卡尔,如果相等则返回 true,否则返回 false
Name Type Description
right Cartesian2 optional 右侧的笛卡尔。
Returns:
如果相等则返回 true,否则返回 false

equalsEpsilon(right, relativeEpsilon, absoluteEpsilon)boolean

逐分量比较此笛卡尔与给定的笛卡尔,如果通过绝对或相对容差测试则返回 true,否则返回 false
Name Type Default Description
right Cartesian2 optional 右侧的笛卡尔。
relativeEpsilon number 0 optional 用于相等性测试的相对 epsilon 容差。
absoluteEpsilon number relativeEpsilon optional 用于相等性测试的绝对 epsilon 容差。
Returns:
如果在给定的 epsilon 范围内则返回 true,否则返回 false

toString()string

创建一个表示此笛卡尔的字符串,格式为 '(x, y)'。
Returns:
表示给定笛卡尔的字符串,格式为 '(x, y)'。

static Cesium.Cartesian2.abs(cartesian, result)Cartesian2

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

static Cesium.Cartesian2.add(left, right, result)Cartesian2

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

static Cesium.Cartesian2.angleBetween(left, right)number

返回给定的两个笛卡尔之间的角度(弧度)。
Name Type Description
left Cartesian2 第一个笛卡尔。
right Cartesian2 第二个笛卡尔。
Returns:
两个笛卡尔之间的角度。

static Cesium.Cartesian2.clamp(value, min, max, result)Cartesian2

将值约束在两个值之间。
Name Type Description
value Cartesian2 要约束的值。
min Cartesian2 最小边界。
max Cartesian2 最大边界。
result Cartesian2 用于存储结果的对象。
Returns:
约束后的值,使得 min <= result <= max。

static Cesium.Cartesian2.clone(cartesian, result)Cartesian2

复制一个 Cartesian2 实例。
Name Type Description
cartesian Cartesian2 要复制的笛卡尔。
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的结果参数,如果未提供则为新的 Cartesian2 实例。(如果 cartesian 为 undefined 则返回 undefined)

static Cesium.Cartesian2.cross(left, right)number

计算将输入向量的 Z 坐标隐式设为 0 时所产生的叉积的模
Name Type Description
left Cartesian2 第一个笛卡尔。
right Cartesian2 第二个笛卡尔。
Returns:
叉积。

static Cesium.Cartesian2.distance(left, right)number

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

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

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

static Cesium.Cartesian2.divideComponents(left, right, result)Cartesian2

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

static Cesium.Cartesian2.dot(left, right)number

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

static Cesium.Cartesian2.equals(left, right)boolean

Compares the provided Cartesians componentwise and returns 如果相等则返回 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

逐分量比较给定的两个笛卡尔,如果通过绝对或相对容差测试则返回 true,否则返回 false
Name Type Default Description
left Cartesian2 optional 第一个笛卡尔。
right Cartesian2 optional 第二个笛卡尔。
relativeEpsilon number 0 optional 用于相等性测试的相对 epsilon 容差。
absoluteEpsilon number relativeEpsilon optional 用于相等性测试的绝对 epsilon 容差。
Returns:
如果 left 和 right 在给定的 epsilon 范围内则返回 true,否则返回 false

static Cesium.Cartesian2.fromArray(array, startingIndex, result)Cartesian2

从数组中两个连续元素创建一个 Cartesian2。
Name Type Default Description
array Array.<number> 数组中两个连续元素分别对应 x 和 y 分量。
startingIndex number 0 optional 数组中第一个元素(对应 x 分量)的偏移量。
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的结果参数,如果未提供则为新的 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

从现有的 Cartesian3 创建一个 Cartesian2 实例。此方法仅取 Cartesian3 的 x 和 y 属性并丢弃 z。
Name Type Description
cartesian Cartesian3 用于创建 Cartesian2 实例的 Cartesian3 实例。
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的结果参数,如果未提供则为新的 Cartesian2 实例。

static Cesium.Cartesian2.fromCartesian4(cartesian, result)Cartesian2

从现有的 Cartesian4 创建一个 Cartesian2 实例。此方法仅取 Cartesian4 的 x 和 y 属性并丢弃 z 和 w。
Name Type Description
cartesian Cartesian4 用于创建 Cartesian2 实例的 Cartesian4 实例。
result Cartesian2 optional 用于存储结果的对象。
Returns:
修改后的结果参数,如果未提供则为新的 Cartesian2 实例。

static Cesium.Cartesian2.fromElements(x, y, result)Cartesian2

从 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

使用给定的笛卡尔计算 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

计算笛卡尔的模(长度)。
Name Type Description
cartesian Cartesian2 要计算模的笛卡尔实例。
Returns:
模。

static Cesium.Cartesian2.magnitudeSquared(cartesian)number

计算给定笛卡尔的模的平方。
Name Type Description
cartesian Cartesian2 要计算模平方的笛卡尔实例。
Returns:
模的平方。

static Cesium.Cartesian2.maximumByComponent(first, second, result)Cartesian2

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

static Cesium.Cartesian2.maximumComponent(cartesian)number

计算给定笛卡尔的最大分量值。
Name Type Description
cartesian Cartesian2 要使用的笛卡尔。
Returns:
最大分量的值。

static Cesium.Cartesian2.minimumByComponent(first, second, result)Cartesian2

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

static Cesium.Cartesian2.minimumComponent(cartesian)number

计算给定笛卡尔的最小分量值。
Name Type Description
cartesian Cartesian2 要使用的笛卡尔。
Returns:
最小分量的值。

static Cesium.Cartesian2.mostOrthogonalAxis(cartesian, result)Cartesian2

返回与给定笛卡尔最正交的轴。
Name Type Description
cartesian Cartesian2 要查找最正交轴的笛卡尔。
result Cartesian2 用于存储结果的对象。
Returns:
最正交的轴。

static Cesium.Cartesian2.multiplyByScalar(cartesian, scalar, result)Cartesian2

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

static Cesium.Cartesian2.multiplyComponents(left, right, result)Cartesian2

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

static Cesium.Cartesian2.negate(cartesian, result)Cartesian2

对给定的笛卡尔取反。
Name Type Description
cartesian Cartesian2 要取反的笛卡尔。
result Cartesian2 用于存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian2.normalize(cartesian, result)Cartesian2

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

static Cesium.Cartesian2.pack(value, array, startingIndex)Array.<number>

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

static Cesium.Cartesian2.packArray(array, result)Array.<number>

将 Cartesian2 数组展平为分量数组。
Name Type Description
array Array.<Cartesian2> 要打包的笛卡尔数组。
result Array.<number> optional 用于存储结果的数组。如果是类型化数组,它必须有 array.length * 2 个分量,否则将抛出 DeveloperError。如果是普通数组,它将被调整为 (array.length * 2) 个元素。
Returns:
打包后的数组。

static Cesium.Cartesian2.subtract(left, right, result)Cartesian2

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

static Cesium.Cartesian2.unpack(array, startingIndex, result)Cartesian2

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

static Cesium.Cartesian2.unpackArray(array, result)Array.<Cartesian2>

将笛卡尔分量数组解包为 Cartesian2 数组。
Name Type Description
array Array.<number> 要解包的分量数组。
result Array.<Cartesian2> optional 用于存储结果的数组。
Returns:
解包后的数组。
需要帮助?获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。