Cartesian2 - SuperMap3D Documentation

new SuperMap3D.Cartesian2(x, y)

二维笛卡尔坐标点。

Name	Type	Default	Description
`x`	Number	`0.0`	optional X部分。
`y`	Number	`0.0`	optional Y部分。

See:

Members

x : Number

X部分。

Default Value: 0.0

y : Number

Y部分。

Default Value: 0.0

staticSuperMap3D.Cartesian2.packedLength : Number

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

staticconstantSuperMap3D.Cartesian2.UNIT_X : Cartesian2

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

staticconstantSuperMap3D.Cartesian2.UNIT_Y : Cartesian2

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

staticconstantSuperMap3D.Cartesian2.ZERO : Cartesian2

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

Methods

clone(result) → 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		用于相等测试的相对 epsilon 容差。
`absoluteEpsilon`	Number	`relativeEpsilon`	optional 用于相等测试的绝对 epsilon 容差。

Returns:

如果它们在提供的 epsilon 内，则为 true ，否则为 false 。

toString() → String

创建一个以'（x，y）'格式表示此笛卡尔坐标的字符串。

Returns:

以'（x，y）'格式表示提供的笛卡尔坐标的字符串。

staticSuperMap3D.Cartesian2.abs(cartesian, result) → Cartesian2

计算提供的笛卡尔坐标的绝对值。

Name	Type	Description
`cartesian`	Cartesian2	要计算其绝对值的笛卡尔坐标。
`result`	Cartesian2	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian2.add(left, right, result) → Cartesian2

计算两个笛卡尔的分量和。

Name	Type	Description
`left`	Cartesian2	第一个笛卡尔。
`right`	Cartesian2	第二个笛卡尔。
`result`	Cartesian2	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian2.angleBetween(left, right) → Number

返回提供的笛卡尔之间的角度（以弧度为单位）。

Name	Type	Description
`left`	Cartesian2	第一个笛卡尔。
`right`	Cartesian2	第二个笛卡尔。

Returns:

笛卡尔之间的角度。

staticSuperMap3D.Cartesian2.clone(cartesian, result) → Cartesian2

复制 Cartesian2 实例。

Name	Type	Description
`cartesian`	Cartesian2	要复制的笛卡尔坐标。
`result`	Cartesian2	optional 存储结果的对象。

Returns:

修改后的结果参数或新的 Cartesian2 实例（如果未提供）。（如果笛卡尔未定义，则返回未定义）

staticSuperMap3D.Cartesian2.distance(left, right) → Number

计算两点之间的距离。

Name	Type	Description
`left`	Cartesian2	计算距离的第一个点。
`right`	Cartesian2	计算距离的第二个点。

Returns:

两点之间的距离。

Example:

// Returns 1.0
var d = SuperMap3D.Cartesian2.distance(new SuperMap3D.Cartesian2(1.0, 0.0), new SuperMap3D.Cartesian2(2.0, 0.0));

staticSuperMap3D.Cartesian2.distanceSquared(left, right) → Number

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

Name	Type	Description
`left`	Cartesian2	计算距离的第一个点。
`right`	Cartesian2	计算距离的第二个点。

Returns:

两点之间的距离。

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));

staticSuperMap3D.Cartesian2.divideByScalar(cartesian, scalar, result) → Cartesian2

将提供的笛卡尔分量除以提供的标量。

Name	Type	Description
`cartesian`	Cartesian2	笛卡尔被划分。
`scalar`	Number	要除以的标量。
`result`	Cartesian2	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian2.divideComponents(left, right, result) → Cartesian2

计算两个笛卡尔的分量商。

Name	Type	Description
`left`	Cartesian2	第一个笛卡尔。
`right`	Cartesian2	第二个笛卡尔。
`result`	Cartesian2	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian2.dot(left, right) → Number

计算两个笛卡尔的点（标量）积。

Name	Type	Description
`left`	Cartesian2	第一个笛卡尔。
`right`	Cartesian2	第二个笛卡尔。

Returns:

点积。

staticSuperMap3D.Cartesian2.equals(left, right) → Boolean

比较提供的笛卡尔分量，如果相等则返回 true ，否则返回 false。

Name	Type	Description
`left`	Cartesian2	optional 第一个笛卡尔。
`right`	Cartesian2	optional 第二个笛卡尔。

Returns:

如果左右相等，则为 true ，否则为 false 。

staticSuperMap3D.Cartesian2.equalsEpsilon(left, right, relativeEpsilon, absoluteEpsilon) → Boolean

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

Name	Type	Default	Description
`left`	Cartesian2		optional 第一个笛卡尔。
`right`	Cartesian2		optional 第二个笛卡尔。
`relativeEpsilon`	Number		用于相等测试的相对 epsilon 容差。
`absoluteEpsilon`	Number	`relativeEpsilon`	optional 用于相等测试的绝对 epsilon 容差。

Returns:

如果左和右在提供的范围内，则为true，否则为false。

staticSuperMap3D.Cartesian2.fromArray(array, startingIndex, result) → Cartesian2

从数组中两个连续的元素创建一个直角坐标系。

Name	Type	Default	Description
`array`	Array.<Number>		数组，其两个连续的元素分别对应x和y分量。
`startingIndex`	Number	`0`	optional 第一个元素在数组中的偏移量，对应于x分量。
`result`	Cartesian2		optional 要在其上存储结果的对象。

Returns:

如果没有提供新的Cartesian2实例，则使用修改后的结果参数。

Example:

// 用(1.0,2.0)创建笛卡尔坐标系
var v = [1.0, 2.0];
var p = SuperMap3D.Cartesian2.fromArray(v);

// 用(1.0,2.0)在数组中创建一个直角坐标系
var v2 = [0.0, 0.0, 1.0, 2.0];
var p2 = SuperMap3D.Cartesian2.fromArray(v2, 2);

staticSuperMap3D.Cartesian2.fromCartesian3(cartesian, result) → Cartesian2

从现有的Cartesian3创建Cartesian2实例。这只需要笛卡尔坐标系的x和y的性质。

Name	Type	Description
`cartesian`	Cartesian3	创建Cartesian2实例的Cartesian3实例。
`result`	Cartesian2	optional 要在其上存储结果的对象。

Returns:

如果没有提供新的Cartesian2实例，则使用修改后的结果参数。

staticSuperMap3D.Cartesian2.fromCartesian4(cartesian, result) → Cartesian2

从现有的Cartesian4创建Cartesian2实例。这只需要笛卡尔坐标系的x和y的性质以及z和w的下降。

Name	Type	Description
`cartesian`	Cartesian4	创建Cartesian2实例的Cartesian4实例。
`result`	Cartesian2	optional 要在其上存储结果的对象。

Returns:

如果没有提供新的Cartesian2实例，则使用修改后的结果参数。

staticSuperMap3D.Cartesian2.fromElements(x, y, result) → Cartesian2

从x和y坐标创建一个笛卡尔实例。

Name	Type	Description
`x`	Number	x坐标。
`y`	Number	y坐标。
`result`	Cartesian2	optional 要在其上存储结果的对象。

Returns:

如果没有提供新的Cartesian2实例，则使用修改后的结果参数。

staticSuperMap3D.Cartesian2.lerp(start, end, t, result) → Cartesian2

使用提供的笛卡尔计算t处的线性插值或外推。

Name	Type	Description
`start`	Cartesian2	对应于t在0.0处的值。
`end`	Cartesian2	对应于1.0时t的值。
`t`	Number	沿着t进行插值的点。
`result`	Cartesian2	要在其上存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian2.magnitude(cartesian) → Number

计算笛卡尔的大小(长度)。

Name	Type	Description
`cartesian`	Cartesian2	要计算其大小的笛卡尔实例。

Returns:

大小。

staticSuperMap3D.Cartesian2.magnitudeSquared(cartesian) → Number

计算给定的笛卡尔坐标的平方幅度。

Name	Type	Description
`cartesian`	Cartesian2	要计算其模的平方的笛卡尔实例。

Returns:

大小的平方。

staticSuperMap3D.Cartesian2.maximumByComponent(first, second, result) → Cartesian2

比较两个笛卡尔坐标并计算一个包含所提供笛卡尔坐标的最大分量的笛卡尔坐标。

Name	Type	Description
`first`	Cartesian2	用笛卡尔坐标来比较。
`second`	Cartesian2	用笛卡尔坐标来比较。
`result`	Cartesian2	要在其中存储结果的对象。

Returns:

一个有最大分量的笛卡尔坐标。

staticSuperMap3D.Cartesian2.maximumComponent(cartesian) → Number

计算所提供的笛卡尔坐标的最大分量的值。

Name	Type	Description
`cartesian`	Cartesian2	用笛卡尔坐标。

Returns:

最大分量的值。

staticSuperMap3D.Cartesian2.minimumByComponent(first, second, result) → Cartesian2

比较两个笛卡尔坐标并计算一个包含所提供笛卡尔坐标的最小分量的笛卡尔坐标。

Name	Type	Description
`first`	Cartesian2	用笛卡尔坐标来比较。
`second`	Cartesian2	用笛卡尔坐标来比较。
`result`	Cartesian2	要在其中存储结果的对象。

Returns:

具有最小分量的笛卡尔曲线。

staticSuperMap3D.Cartesian2.minimumComponent(cartesian) → Number

为所提供的笛卡尔坐标计算最小分量的值。

Name	Type	Description
`cartesian`	Cartesian2	用笛卡尔坐标。

Returns:

最小分量的值。

staticSuperMap3D.Cartesian2.mostOrthogonalAxis(cartesian, result) → Cartesian2

返回与所提供的笛卡尔坐标最正交的轴。

Name	Type	Description
`cartesian`	Cartesian2	在笛卡尔坐标系上找到最正交的轴。
`result`	Cartesian2	要在其上存储结果的对象。

Returns:

最正交的轴。

staticSuperMap3D.Cartesian2.multiplyByScalar(cartesian, scalar, result) → Cartesian2

将所提供的笛卡尔分量与所提供的标量相乘。

Name	Type	Description
`cartesian`	Cartesian2	要缩放的笛卡尔坐标。
`scalar`	Number	与之相乘的标量。
`result`	Cartesian2	要在其上存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian2.multiplyComponents(left, right, result) → Cartesian2

计算两个笛卡尔坐标的分量积。

Name	Type	Description
`left`	Cartesian2	第一个笛卡尔坐标系。
`right`	Cartesian2	第二个笛卡尔坐标系。
`result`	Cartesian2	要在其上存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian2.negate(cartesian, result) → Cartesian2

否定提供的笛卡尔坐标。

Name	Type	Description
`cartesian`	Cartesian2	笛卡尔坐标被否定。
`result`	Cartesian2	要在其上存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian2.normalize(cartesian, result) → Cartesian2

计算提供的笛卡尔坐标的规范化形式。

Name	Type	Description
`cartesian`	Cartesian2	被规范化的笛卡尔坐标。
`result`	Cartesian2	要在其上存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian2.pack(value, array, startingIndex) → Array.<Number>

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

Name	Type	Default	Description
`value`	Cartesian2		要打包的值。
`array`	Array.<Number>		要装入的数组。
`startingIndex`	Number	`0`	optional 开始打包元素的数组的索引。

Returns:

被装入的数组。

staticSuperMap3D.Cartesian2.packArray(array, result) → Array.<Number>

将Cartesian2的数组平展为一个分量数组。

Name	Type	Description
`array`	Array.<Cartesian2>	要打包的笛卡尔数组。
`result`	Array.<Number>	要在其中存储结果的数组。

Returns:

打包数组。

staticSuperMap3D.Cartesian2.subtract(left, right, result) → Cartesian2

计算两个笛卡尔坐标的分量差。

Name	Type	Description
`left`	Cartesian2	第一个笛卡尔坐标系。
`right`	Cartesian2	第二个笛卡尔坐标系。
`result`	Cartesian2	要在其上存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian2.unpack(array, startingIndex, result) → Cartesian2

从打包数组中检索实例。

Name	Type	Default	Description
`array`	Array.<Number>		打包数组。
`startingIndex`	Number	`0`	optional 要解压缩的元素的起始索引。
`result`	Cartesian2		optional 要在其中存储结果的对象。

Returns:

如果没有提供新的Cartesian2实例，则使用修改后的结果参数。

staticSuperMap3D.Cartesian2.unpackArray(array, result) → Array.<Cartesian2>

将一个笛卡尔分量数组解包为一个Cartesian2元素数组。

Name	Type	Description
`array`	Array.<Number>	要解包的组件数组。
`result`	Array.<Cartesian2>	要在其中存储结果的数组。

Returns:

未打包的数组。