Class: Cartesian2

Cartesian2

new Cartesian2(x, y)

二维笛卡尔坐标点类

Name Type Default Description
x Number 0.0 可选

The X component.

y Number 0.0 可选

The Y component.

See:

Members

xNumber

X部分。

Default Value:
0.0

yNumber

Y部分。

Default Value:
0.0

static packedLengthNumber

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

(static, constant) UNIT_XCartesian2

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

(static, constant) UNIT_YCartesian2

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

(static, constant) ZEROCartesian2

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

Methods

clone(result){Cartesian2}

复制此 Cartesian2 实例。

Name Type Description
result Cartesian2 可选

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数或新的 Cartesian2 实例(如果未提供)。

equals(right){Boolean}

将此Cartesian与提供的Cartesian分量进行比较,如果相等则返回 true ,否则返回 false 。

Name Type Description
right Cartesian2 可选

右侧的Cartesian。

Returns:
Type Description
Boolean 如果它们相等,则为 true ,否则为 false 。

equalsEpsilon(right, relativeEpsilon, absoluteEpsilon){Boolean}

将此Cartesian与提供的Cartesian分量进行比较,如果它们通过绝对或相对容差测试,则返回 true ,否则返回 false 。

Name Type Default Description
right Cartesian2 可选

右侧的Cartesian。

relativeEpsilon Number

用于相等测试的相对 epsilon 容差。

absoluteEpsilon Number relativeEpsilon 可选

用于相等测试的绝对 epsilon 容差

Returns:
Type Description
Boolean 如果它们在提供的 epsilon 内,则为 true ,否则为 false 。

toString(){String}

创建一个以'(x,y)'格式表示此Cartesian坐标的字符串。

Returns:
Type Description
String 以'(x,y)'格式表示提供的Cartesian坐标的字符串。

static abs(cartesian, result){Cartesian2}

计算提供的Cartesian坐标的绝对值。

Name Type Description
cartesian Cartesian2

要计算其绝对值的Cartesian坐标。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数。

static add(left, right, result){Cartesian2}

计算两个Cartesians的分量和。

Name Type Description
left Cartesian2

第一个 Cartesian。

right Cartesian2

第二个 Cartesian。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数。

static angleBetween(left, right){Number}

返回提供的Cartesians之间的角度(以弧度为单位)。

Name Type Description
left Cartesian2

第一个 Cartesian。

right Cartesian2

第二个 Cartesian。

Returns:
Type Description
Number Cartesians之间的角度。

static clone(cartesian, result){Cartesian2}

复制 Cartesian2 实例。

Name Type Description
cartesian Cartesian2

要复制的Cartesian坐标。

result Cartesian2 可选

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数或新的 Cartesian2 实例(如果未提供)。 (如果Cartesian未定义,则返回未定义)

static distance(left, right){Number}

计算两点之间的距离。

Name Type Description
left Cartesian2

计算距离的第一个点。

right Cartesian2

计算距离的第二个点。

Returns:
Type Description
Number 两点之间的距离。
Example
// Returns 1.0
var d = SuperMap3D.Cartesian2.distance(new SuperMap3D.Cartesian2(1.0, 0.0), new SuperMap3D.Cartesian2(2.0, 0.0));

static distanceSquared(left, right){Number}

计算两点之间的平方距离。使用此函数比较距离的平方比使用 Cartesian2#distance.比较距离更有效。

Name Type Description
left Cartesian2

计算距离的第一个点。

right Cartesian2

计算距离的第二个点。

Returns:
Type Description
Number 两点之间的距离。
Example
// Returns 4.0, not 2.0
var d = SuperMap3D.Cartesian2.distance(new SuperMap3D.Cartesian2(1.0, 0.0), new SuperMap3D.Cartesian2(3.0, 0.0));

static divideByScalar(cartesian, scalar, result){Cartesian2}

将提供的Cartesian分量除以提供的标量。

Name Type Description
cartesian Cartesian2

Cartesian被划分。

scalar Number

要除以的标量。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数。

static divideComponents(left, right, result){Cartesian2}

计算两个Cartesians的分量商。

Name Type Description
left Cartesian2

第一个 Cartesian。

right Cartesian2

第二个 Cartesian。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数。

static dot(left, right){Number}

计算两个Cartesians的点(标量)积。

Name Type Description
left Cartesian2

第一个 Cartesian。

right Cartesian2

第二个 Cartesian。

Returns:
Type Description
Number 点积。

static equals(left, right){Boolean}

比较提供的Cartesians分量,如果相等则返回 true ,否则返回 false 。

Name Type Description
left Cartesian2 可选

第一个 Cartesian.

right Cartesian2 可选

第二个 Cartesian.

Returns:
Type Description
Boolean 如果左右相等,则为 true ,否则为 false 。

static equalsEpsilon(left, right, relativeEpsilon, absoluteEpsilon){Boolean}

比较提供的Cartesian分量,如果它们通过绝对或相对容差测试,则返回 true ,否则返回 false 。

Name Type Default Description
left Cartesian2 可选

第一个 Cartesian.

right Cartesian2 可选

第二个 Cartesian.

relativeEpsilon Number

用于相等测试的相对 epsilon 容差。

absoluteEpsilon Number relativeEpsilon 可选

用于相等测试的绝对 epsilon 容差。

Returns:
Type Description
Boolean 在提供的 epsilon 内,则为 true,否则为 false 。

static fromArray(array, startingIndex, result){Cartesian2}

从数组中的两个连续元素创建 Cartesian2。

Name Type Default Description
array Array.<Number>

其两个连续元素分别对应于 x 和 y 分量的数组。

startingIndex Number 0 可选

第一个元素在数组中的偏移量,对应于 x 分量

result Cartesian2 可选

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数或新的 Cartesian2 实例(如果未提供)。
Example
// Create a Cartesian2 with (1.0, 2.0)
var v = [1.0, 2.0];
var p = SuperMap3D.Cartesian2.fromArray(v);

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

static fromCartesian3(cartesian, result){Cartesian2}

从现有的 Cartesian3 创建一个 Cartesian2 实例。这只是简单地采用Cartesian3 的 x 和 y 属性并删除 z。

Name Type Description
cartesian Cartesian3

要从中创建 Cartesian2 实例的 Cartesian3 实例。

result Cartesian2 可选

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数或新的 Cartesian2 实例(如果未提供)。

static fromCartesian4(cartesian, result){Cartesian2}

从现有的 Cartesian4 创建一个 Cartesian2 实例。这只是简单地采用Cartesian4 的 x 和 y 属性并删除 z 和 w。

Name Type Description
cartesian Cartesian4

要从中创建 Cartesian2 实例的 Cartesian4 实例。

result Cartesian2 可选

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数或新的 Cartesian2 实例(如果未提供)。

static fromElements(x, y, result){Cartesian2}

从 x 和 y 坐标创建 Cartesian2 实例。

Name Type Description
x Number

x 坐标。

y Number

y 坐标。

result Cartesian2 可选

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数或新的 Cartesian2 实例(如果未提供)。

static lerp(start, end, t, result){Cartesian2}

使用提供的Cartesian计算在 t 处的线性插值或外插。

Name Type Description
start Cartesian2

在 0.0 时对应于 t 的值。

end Cartesian2

在 1.0 时对应于 t 的值。

t Number

沿 t 进行插值的点。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数。

static magnitude(cartesian){Number}

计算Cartesian的大小(长度)。

Name Type Description
cartesian Cartesian2

要计算其大小的cartesian实例。

Returns:
Type Description
Number 幅度。

static magnitudeSquared(cartesian){Number}

计算给定的Cartesian坐标的平方幅度。

Name Type Description
cartesian Cartesian2

要计算其平方幅度的Cartesian实例。

Returns:
Type Description
Number 平方幅度。

static maximumByComponent(first, second, result){Cartesian2}

比较两个Cartesians并计算包含所提供Cartesian的最大分量的Cartesian。

Name Type Description
first Cartesian2

第一个cartesian 进行比较。

second Cartesian2

第二个cartesian 进行比较。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 具有最大分量的cartesian曲线。

static maximumComponent(cartesian){Number}

计算提供的Cartesian坐标的最大分量的值。

Name Type Description
cartesian Cartesian2

要使用的cartesian。

Returns:
Type Description
Number 最大分量的值。

static minimumByComponent(first, second, result){Cartesian2}

比较两个Cartesians并计算包含所提供Cartesian的最小分量的Cartesian。

Name Type Description
first Cartesian2

第一个cartesian 进行比较。

second Cartesian2

第二个cartesian 进行比较。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 具有最小分量的cartesian曲线。

static minimumComponent(cartesian){Number}

计算提供的Cartesian坐标的最小分量的值。

Name Type Description
cartesian Cartesian2

要使用的cartesian。

Returns:
Type Description
Number 最小分量的值。

static mostOrthogonalAxis(cartesian, result){Cartesian2}

返回与提供的Cartesian坐标最正交的轴。

Name Type Description
cartesian Cartesian2

找到最正交轴的Cartesian坐标。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 最正交的轴。

static multiplyByScalar(cartesian, scalar, result){Cartesian2}

将提供的Cartesian分量乘以提供的标量。

Name Type Description
cartesian Cartesian2

要缩放的Cartesian坐标。

scalar Number

要与之相乘的标量。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数。

static multiplyComponents(left, right, result){Cartesian2}

计算两个Cartesians的分量乘积。

Name Type Description
left Cartesian2

第一个 Cartesian。

right Cartesian2

第二个 Cartesian。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数。

static negate(cartesian, result){Cartesian2}

否定所提供的Cartesian。

Name Type Description
cartesian Cartesian2

要被否定的Cartesian。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数。

static normalize(cartesian, result){Cartesian2}

计算提供的Cartesian坐标的规范化形式。

Name Type Description
cartesian Cartesian2

要规范化的Cartesian坐标。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数。

static pack(value, array, startingIndex){Array.<Number>}

将提供的实例存储到提供的数组中。

Name Type Default Description
value Cartesian2

要打包的值。

array Array.<Number>

要打包的数组。

startingIndex Number 0 可选

开始打包元素的数组索引。

Returns:
Type Description
Array.<Number> 装入的数组。

static packArray(array, result){Array.<Number>}

将 Cartesian2 数组展平为组件数组。

Name Type Description
array Array.<Cartesian2>

要打包的cartesians数组。

result Array.<Number>

存储结果的数组。

Returns:
Type Description
Array.<Number> 打包数组。

static subtract(left, right, result){Cartesian2}

计算两个Cartesians的分量差。

Name Type Description
left Cartesian2

第一个 Cartesian。

right Cartesian2

第二个 Cartesian。

result Cartesian2

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数。

static unpack(array, startingIndex, result){Cartesian2}

从打包数组中检索实例。

Name Type Default Description
array Array.<Number>

打包的数组。

startingIndex Number 0 可选

要解包的元素的起始索引。

result Cartesian2 可选

存储结果的对象。

Returns:
Type Description
Cartesian2 修改后的结果参数或新的 Cartesian2 实例(如果未提供)。

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

将一组Cartesian分量解压缩为一组Cartesian2s。

Name Type Description
array Array.<Number>

要解包的组件数组。

result Array.<Cartesian2>

存储结果的数组。

Returns:
Type Description
Array.<Cartesian2> 解压后的数组。