new Cartesian4(x, y, z, w)
四维笛卡尔坐标点类。
| Name | Type | Default | Description |
|---|---|---|---|
x |
Number | 0.0 |
可选
X分量。 |
y |
Number | 0.0 |
可选
Y分量。 |
z |
Number | 0.0 |
可选
Z分量。 |
w |
Number | 0.0 |
可选
W分量。 |
- See:
-
- Cartesian2
- Cartesian3
- Packable
Members
-
wNumber
-
W分量。
- Default Value: 0.0
xNumber
X分量。
- Default Value: 0.0
yNumber
Y分量。
- Default Value: 0.0
zNumber
Z分量。
- Default Value: 0.0
static packedLengthNumber
用于将对象打包到数组中的元素数量。
(static, constant) UNIT_WCartesian4
一个不可变的 Cartesian4 实例，初始化为(0.0,0.0,0.0,1.0)。
(static, constant) UNIT_XCartesian4
一个不可变的 Cartesian4 实例，初始化为 (1.0, 0.0, 0.0)。
(static, constant) UNIT_YCartesian4
一个不可变的 Cartesian4 实例，初始化为 (0.0, 1.0, 0.0)。
(static, constant) UNIT_ZCartesian4
一个不可变的 Cartesian4 实例，初始化为 (0.0, 0.0, 1.0)。
(static, constant) ZEROCartesian4
一个不可变的 Cartesian4 实例，初始化为 (0.0, 0.0, 0.0)。
Methods
-
clone(result){Cartesian4}
-
复制这个Cartesian实例。
Name Type Description resultCartesian4 可选 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数，如果没有提供新的Cartesian4实例，则提供新的Cartesian4实例。 -
equals(right){Boolean}
-
将此Cartesian与提供的Cartesian分量进行比较，如果它们相等则返回 true ，否则返回 false 。
Name Type Description rightCartesian4 可选 右侧的Cartesian。
Returns:
Type Description Boolean 如果它们相等，则为 true ，否则为 false 。 -
equalsEpsilon(right, relativeEpsilon, absoluteEpsilon){Boolean}
-
将此Cartesian与提供的Cartesian分量进行比较，如果它们通过绝对或相对容差测试，则返回 true ，否则返回 false 。
Name Type Default Description rightCartesian3 可选 右侧的Cartesian。
relativeEpsilonNumber 用于相等测试的相对 epsilon 容差。
absoluteEpsilonNumber 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){Cartesian4}
-
计算提供的Cartesian坐标的绝对值。
Name Type Description cartesianCartesian4 要计算其绝对值的Cartesian坐标。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数。 -
static add(left, right, result){Cartesian4}
-
计算两个Cartesians的分量和。
Name Type Description leftCartesian4 第一个Cartesian。
rightCartesian4 第二个Cartesian。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数。 -
static clone(cartesian, result){Cartesian4}
-
复制 Cartesian4 实例。
Name Type Description cartesianCartesian4 要复制的Cartesian坐标。
resultCartesian4 可选 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数或新的 Cartesian4 实例（如果未提供）。（如果Cartesian未定义，则返回未定义） -
static distance(left, right){Number}
-
计算两点之间的空间距离。
Name Type Description leftCartesian4 计算距离的第一个点。
rightCartesian4 计算距离的第二个点。
Returns:
Type Description Number 两点之间的距离。 Example
// Returns 1.0 var d = SuperMap3D.Cartesian4.distance( new SuperMap3D.Cartesian4(1.0, 0.0, 0.0, 0.0), new SuperMap3D.Cartesian4(2.0, 0.0, 0.0, 0.0)); -
static distanceSquared(left, right){Number}
-
计算两点之间的平方距离。使用此函数比较距离的平方比使用
Cartesian4#distance比较距离更有效。Name Type Description leftCartesian4 计算距离的第一个点
rightCartesian4 计算距离的第二个点。
Returns:
Type Description Number 两点之间的距离。 Example
// Returns 4.0, not 2.0 var d = SuperMap3D.Cartesian4.distance( new SuperMap3D.Cartesian4(1.0, 0.0, 0.0, 0.0), new SuperMap3D.Cartesian4(3.0, 0.0, 0.0, 0.0)); -
static divideByScalar(cartesian, scalar, result){Cartesian4}
-
将提供的Cartesian分量除以提供的标量。
Name Type Description cartesianCartesian4 被划分的 Cartesian。
scalarNumber 要除以的标量。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数。 -
static divideComponents(left, right, result){Cartesian4}
-
计算两个Cartesians的分量商。
Name Type Description leftCartesian4 第一个Cartesian。
rightCartesian4 第二个Cartesian。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数。 -
static dot(left, right){Number}
-
计算两个Cartesian的点（标量）积。
Name Type Description leftCartesian4 第一个 Cartesian。
rightCartesian4 第二个 Cartesian。
Returns:
Type Description Number 点积。 -
static equals(left, right){Boolean}
-
比较提供的Cartesian分量，如果相等则返回 true ，否则返回 false 。
Name Type Description leftCartesian4 可选 第一个 Cartesian。
rightCartesian4 可选 第二个 Cartesian。
Returns:
Type Description Boolean 如果它们相等，则为 true ，否则为 false 。 -
static equalsEpsilon(left, right, relativeEpsilon, absoluteEpsilon){Boolean}
-
比较提供的Cartesian分量，如果它们通过绝对或相对容差测试，则返回 true ，否则返回 false 。
Name Type Default Description leftCartesian4 可选 第一个 Cartesian.
rightCartesian4 可选 第二个 Cartesian.
relativeEpsilonNumber 用于相等测试的相对 epsilon 容差。
absoluteEpsilonNumber relativeEpsilon 可选 用于相等测试的绝对 epsilon 容差。
Returns:
Type Description Boolean 在提供的 epsilon 内，则为 true，否则为 false 。 -
static fromArray(array, startingIndex, result){Cartesian4}
-
从数组中的四个连续元素创建 Cartesian4。
Name Type Default Description arrayArray.<Number> 其四个连续元素分别对应于 x、y、z 和 w 分量的数组。
startingIndexNumber 0 可选 第一个元素在数组中的偏移量，对应于 x 分量。
resultCartesian4 可选 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数或新的 Cartesian4 实例（如果未提供）。 Example
// Create a Cartesian4 with (1.0, 2.0, 3.0, 4.0) var v = [1.0, 2.0, 3.0, 4.0]; var p = SuperMap3D.Cartesian4.fromArray(v); // Create a Cartesian4 with (1.0, 2.0, 3.0, 4.0) using an offset into an array var v2 = [0.0, 0.0, 1.0, 2.0, 3.0, 4.0]; var p2 = SuperMap3D.Cartesian4.fromArray(v2, 2); -
static fromColor(color, result){Cartesian4}
-
从 Color 创建一个 Cartesian4 实例。red 、green 、blue 和 alpha 分别映射到 x 、 y 、 z 和 w 。
Name Type Description colorColor 源色。
resultCartesian4 可选 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数或新的 Cartesian4 实例（如果未提供）。 -
static fromElements(x, y, z, w, result){Cartesian4}
-
从 x、y、z 和 w 坐标创建 Cartesian4 实例。
Name Type Description xNumber x 坐标。
yNumber y 坐标。
zNumber z 坐标。
wNumber w 坐标。
resultCartesian4 可选 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数或新的 Cartesian4 实例（如果未提供）。 -
static lerp(start, end, t, result){Cartesian4}
-
使用提供的Cartesian计算在 t 处的线性插值或外插。
Name Type Description startCartesian4 在 0.0 时对应于 t 的值。
endCartesian4 在 1.0 时对应于 t 的值。
tNumber 沿 t 进行插值的点。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数。 -
static magnitude(cartesian){Number}
-
计算Cartesian的大小（长度）。
Name Type Description cartesianCartesian4 要计算其大小的Cartesian实例。
Returns:
Type Description Number 幅度。 -
static magnitudeSquared(cartesian){Number}
-
计算提供的Cartesian平方幅度。
Name Type Description cartesianCartesian4 要计算其平方幅度的Cartesian实例。
Returns:
Type Description Number 平方幅度。 -
static maximumByComponent(first, second, result){Cartesian4}
-
比较两个Cartesians并计算包含所提供Cartesian的最大分量的Cartesian。
Name Type Description firstCartesian4 第一个Cartesian坐标。
secondCartesian4 第二个Cartesian坐标。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 具有最大分量的Cartesian坐标。 -
static maximumComponent(cartesian){Number}
-
计算提供的Cartesian坐标的最大分量的值。
Name Type Description cartesianCartesian4 要使用的cartesian。
Returns:
Type Description Number 最大分量的值。 -
static minimumByComponent(first, second, result){Cartesian4}
-
比较两个Cartesians并计算包含所提供Cartesian的最小分量的Cartesian。
Name Type Description firstCartesian4 第一个Cartesian。
secondCartesian4 第二个Cartesian。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 具有最少分量的Cartesian。 -
static minimumComponent(cartesian){Number}
-
计算提供的Cartesian坐标的最小分量的值。
Name Type Description cartesianCartesian4 要使用的cartesian。
Returns:
Type Description Number 最小分量的值。 -
static mostOrthogonalAxis(cartesian, result){Cartesian4}
-
返回与提供的Cartesian坐标最正交的轴。
Name Type Description cartesianCartesian4 找到最正交轴的Cartesian坐标。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 最正交的轴。 -
static multiplyByScalar(cartesian, scalar, result){Cartesian4}
-
将提供的Cartesian分量乘以提供的标量。
Name Type Description cartesianCartesian4 要缩放的Cartesian。
scalarNumber 要与之相乘的标量。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数。 -
static multiplyComponents(left, right, result){Cartesian4}
-
计算两个Cartesian的分量乘积。
Name Type Description leftCartesian4 第一个 Cartesian。
rightCartesian4 第二个 Cartesian。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数。 -
static negate(cartesian, result){Cartesian4}
-
否定所提供的Cartesian。
Name Type Description cartesianCartesian4 要被否定的Cartesian。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数。 -
static normalize(cartesian, result){Cartesian4}
-
计算提供的Cartesian坐标的规范化形式。
Name Type Description cartesianCartesian4 要规范化的Cartesian坐标。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数。 -
static pack(value, array, startingIndex){Array.<Number>}
-
将提供的实例存储到提供的数组中。
Name Type Default Description valueCartesian4 要打包的值。
arrayArray.<Number> 要打包的数组。
startingIndexNumber 0 可选 开始打包元素的数组索引。
Returns:
Type Description Array.<Number> 装入的数组。 -
static packArray(array, result){Array.<Number>}
-
将 Cartesian4 数组展平为组件数组。
Name Type Description arrayArray.<Cartesian4> 要打包的cartesians数组。
resultArray.<Number> 要在其中存储结果的数组。
Returns:
Type Description Array.<Number> 打包的数组。 -
static packFloat(value, result){Cartesian4}
-
将一个浮点值打包成由4个无符号整数8字节类型表示的对象
Name Type Description valueNumber 一个浮点数值点
resultCartesian4 可选 如果没有提供新的Cartesian4实例，则使用修改后的结果参数。
Returns:
Type Description Cartesian4 A Cartesian4 representing the float packed to values in x, y, z, and w. -
static subtract(left, right, result){Cartesian4}
-
计算两个Cartesians的分量差。
Name Type Description leftCartesian4 第一个Cartesian。
rightCartesian4 第二个Cartesian。
resultCartesian4 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数。 -
static unpack(array, startingIndex, result){Cartesian4}
-
从打包数组中检索实例。
Name Type Default Description arrayArray.<Number> 打包的数组。
startingIndexNumber 0 可选 要解包的元素的起始索引。
resultCartesian4 可选 存储结果的对象。
Returns:
Type Description Cartesian4 修改后的结果参数或新的 Cartesian4 实例（如果未提供）。 -
static unpackArray(array, result){Array.<Cartesian4>}
-
将一组cartesian分量解包成一组Cartesian4s。
Name Type Description arrayArray.<Number> 要解包的组件数组。
resultArray.<Cartesian4> 存储结果的数组。
Returns:
Type Description Array.<Cartesian4> 解压后的数组。