一个 4D 笛卡尔点。
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:
Members
W 分量。
-
Default Value:
0.0
X 组件。
-
Default Value:
0.0
Y 分量。
-
Default Value:
0.0
Z 分量。
-
Default Value:
0.0
static constant Cesium.Cartesian4.ONE : Cartesian4
一个不可变的 Cartesian4 实例,初始化为 (1.0, 1.0, 1.0, 1.0)。
用于将对象打包到数组中的元素数。
static constant Cesium.Cartesian4.UNIT_W : Cartesian4
一个不可变的 Cartesian4 实例,初始化为 (0.0, 0.0, 0.0, 1.0)。
static constant Cesium.Cartesian4.UNIT_X : Cartesian4
一个不可变的 Cartesian4 实例,初始化为 (1.0, 0.0, 0.0, 0.0)。
static constant Cesium.Cartesian4.UNIT_Y : Cartesian4
一个不可变的 Cartesian4 实例,初始化为 (0.0, 1.0, 0.0, 0.0)。
static constant Cesium.Cartesian4.UNIT_Z : Cartesian4
一个不可变的 Cartesian4 实例,初始化为 (0.0, 0.0, 1.0, 0.0)。
static constant Cesium.Cartesian4.ZERO : Cartesian4
一个不可变的 Cartesian4 实例,初始化为 (0.0, 0.0, 0.0, 0.0)。
Methods
clone ( result ) → Cartesian4
复制此 Cartesian4 实例。
Name | Type | Description |
---|---|---|
result
|
Cartesian4 | 可选 存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian4 实例(如果未提供)。
将此笛卡尔与提供的笛卡尔分量进行比较,如果它们相等则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
right
|
Cartesian4 | 可选 右手边的笛卡尔。 |
Returns:
如果它们相等,则为
true
,否则为
false
。
将此笛卡尔与提供的笛卡尔分量进行比较,如果它们通过绝对或相对容差测试,则返回
true
,否则返回
false
。
Name | Type | Default | Description |
---|---|---|---|
right
|
Cartesian4 | 可选 右手边的笛卡尔。 | |
relativeEpsilon
|
Number |
0
|
可选 用于相等测试的相对 epsilon 容差。 |
absoluteEpsilon
|
Number |
relativeEpsilon
|
可选 用于相等测试的绝对 epsilon 容差。 |
Returns:
如果它们在提供的 epsilon 内,则为
true
,否则为
false
。
以'(x,y,z,w)'格式创建一个表示此笛卡尔坐标的字符串。
Returns:
一个字符串,以'(x,y,z,w)'格式表示提供的笛卡尔坐标。
static Cesium.Cartesian4.abs (cartesian, result) → Cartesian4
计算提供的笛卡尔坐标的绝对值。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 要计算其绝对值的笛卡尔坐标。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian4.add (left, right, result) → Cartesian4
计算两个笛卡尔的分量和。
Name | Type | Description |
---|---|---|
left
|
Cartesian4 | 第一个笛卡尔。 |
right
|
Cartesian4 | 第二个笛卡尔。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian4.clamp (value, min, max, result) → Cartesian4
将一个值限制在两个值之间。
Name | Type | Description |
---|---|---|
value
|
Cartesian4 | 要钳位的值。 |
min
|
Cartesian4 | 最小界限。 |
max
|
Cartesian4 | 最大界限。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
限定值,使得 min <= result <= max。
static Cesium.Cartesian4.clone (cartesian, result ) → Cartesian4
复制 Cartesian4 实例。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 要复制的笛卡尔坐标。 |
result
|
Cartesian4 | 可选 存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian4 实例(如果未提供)。 (如果笛卡尔未定义,则返回未定义)
计算两点之间的 4 空间距离。
Name | Type | Description |
---|---|---|
left
|
Cartesian4 | 计算距离的第一个点。 |
right
|
Cartesian4 | 计算距离的第二个点。 |
Returns:
两点之间的距离。
Example:
// Returns 1.0
const d = Cesium.Cartesian4.distance(
new Cesium.Cartesian4(1.0, 0.0, 0.0, 0.0),
new Cesium.Cartesian4(2.0, 0.0, 0.0, 0.0));
计算两点之间的平方距离。使用此函数比较距离的平方比使用
Cartesian4#distance
比较距离更有效。
Name | Type | Description |
---|---|---|
left
|
Cartesian4 | 计算距离的第一个点。 |
right
|
Cartesian4 | 计算距离的第二个点。 |
Returns:
两点之间的距离。
Example:
// Returns 4.0, not 2.0
const d = Cesium.Cartesian4.distance(
new Cesium.Cartesian4(1.0, 0.0, 0.0, 0.0),
new Cesium.Cartesian4(3.0, 0.0, 0.0, 0.0));
static Cesium.Cartesian4.divideByScalar (cartesian, scalar, result) → Cartesian4
将提供的笛卡尔分量除以提供的标量。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 笛卡尔被划分。 |
scalar
|
Number | 要除以的标量。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian4.divideComponents (left, right, result) → Cartesian4
计算两个笛卡尔的分量商。
Name | Type | Description |
---|---|---|
left
|
Cartesian4 | 第一个笛卡尔。 |
right
|
Cartesian4 | 第二个笛卡尔。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
修改后的结果参数。
计算两个笛卡尔的点(标量)积。
Name | Type | Description |
---|---|---|
left
|
Cartesian4 | 第一个笛卡尔。 |
right
|
Cartesian4 | 第二个笛卡尔。 |
Returns:
点积。
比较提供的笛卡尔分量,如果相等则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
left
|
Cartesian4 | 可选 第一个笛卡尔。 |
right
|
Cartesian4 | 可选 第二个笛卡尔。 |
Returns:
如果左右相等,则为
true
,否则为
false
。
static Cesium.Cartesian4.equalsEpsilon ( left , right , relativeEpsilon , absoluteEpsilon ) → Boolean
比较提供的笛卡尔分量,如果它们通过绝对或相对容差测试,则返回
true
,否则返回
false
。
Name | Type | Default | Description |
---|---|---|---|
left
|
Cartesian4 | 可选 第一个笛卡尔。 | |
right
|
Cartesian4 | 可选 第二个笛卡尔。 | |
relativeEpsilon
|
Number |
0
|
可选 用于相等测试的相对 epsilon 容差。 |
absoluteEpsilon
|
Number |
relativeEpsilon
|
可选 用于相等测试的绝对 epsilon 容差。 |
Returns:
true
left 和 right 在提供的 epsilon 内,则为 true,否则为
false
。
static Cesium.Cartesian4.fromArray (array, startingIndex , result ) → Cartesian4
从数组中的四个连续元素创建 Cartesian4。
Name | Type | Default | Description |
---|---|---|---|
array
|
Array.<Number> | 其四个连续元素分别对应于 x、y、z 和 w 分量的数组。 | |
startingIndex
|
Number |
0
|
可选 第一个元素在数组中的偏移量,对应于 x 分量。 |
result
|
Cartesian4 | 可选 存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian4 实例(如果未提供)。
Example:
// Create a Cartesian4 with (1.0, 2.0, 3.0, 4.0)
const v = [1.0, 2.0, 3.0, 4.0];
const p = Cesium.Cartesian4.fromArray(v);
// Create a Cartesian4 with (1.0, 2.0, 3.0, 4.0) using an offset into an array
const v2 = [0.0, 0.0, 1.0, 2.0, 3.0, 4.0];
const p2 = Cesium.Cartesian4.fromArray(v2, 2);
static Cesium.Cartesian4.fromColor (color, result ) → Cartesian4
Name | Type | Description |
---|---|---|
color
|
Color | 源颜色。 |
result
|
Cartesian4 | 可选 存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian4 实例(如果未提供)。
static Cesium.Cartesian4.fromElements (x, y, z, w, result ) → Cartesian4
从 x、y、z 和 w 坐标创建 Cartesian4 实例。
Name | Type | Description |
---|---|---|
x
|
Number | x 坐标。 |
y
|
Number | y 坐标。 |
z
|
Number | z 坐标。 |
w
|
Number | w 坐标。 |
result
|
Cartesian4 | 可选 存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian4 实例(如果未提供)。
static Cesium.Cartesian4.lerp (start, end, t, result) → Cartesian4
使用提供的笛卡尔计算在 t 处的线性插值或外插。
Name | Type | Description |
---|---|---|
start
|
Cartesian4 | 在 0.0 时对应于 t 的值。 |
end
|
Cartesian4 | 在 1.0 时对应于 t 的值。 |
t
|
Number | 沿 t 进行插值的点。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
修改后的结果参数。
计算笛卡尔的大小(长度)。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 要计算其大小的笛卡尔实例。 |
Returns:
幅度。
计算提供的笛卡尔平方幅度。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 要计算其平方幅度的笛卡尔实例。 |
Returns:
平方幅度。
static Cesium.Cartesian4.maximumByComponent (first, second, result) → Cartesian4
比较两个笛卡尔并计算包含所提供笛卡尔的最大分量的笛卡尔。
Name | Type | Description |
---|---|---|
first
|
Cartesian4 | 一个笛卡尔比较。 |
second
|
Cartesian4 | 一个笛卡尔比较。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
具有最大分量的笛卡尔。
计算提供的笛卡尔坐标的最大分量的值。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 要使用的笛卡尔。 |
Returns:
最大分量的值。
static Cesium.Cartesian4.minimumByComponent (first, second, result) → Cartesian4
比较两个笛卡尔并计算包含所提供笛卡尔的最小分量的笛卡尔。
Name | Type | Description |
---|---|---|
first
|
Cartesian4 | 一个笛卡尔比较。 |
second
|
Cartesian4 | 一个笛卡尔比较。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
具有最少分量的笛卡尔坐标。
计算提供的笛卡尔坐标的最小分量的值。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 要使用的笛卡尔。 |
Returns:
最小分量的值。
static Cesium.Cartesian4.mostOrthogonalAxis (cartesian, result) → Cartesian4
返回与提供的笛卡尔坐标最正交的轴。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 找到最正交轴的笛卡尔坐标。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
最正交的轴。
static Cesium.Cartesian4.multiplyByScalar (cartesian, scalar, result) → Cartesian4
将提供的笛卡尔分量乘以提供的标量。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 要缩放的笛卡尔坐标。 |
scalar
|
Number | 要与之相乘的标量。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian4.multiplyComponents (left, right, result) → Cartesian4
计算两个笛卡尔的分量乘积。
Name | Type | Description |
---|---|---|
left
|
Cartesian4 | 第一个笛卡尔。 |
right
|
Cartesian4 | 第二个笛卡尔。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian4.negate (cartesian, result) → Cartesian4
否定提供的笛卡尔坐标。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 笛卡尔被否定。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian4.normalize (cartesian, result) → Cartesian4
计算提供的笛卡尔坐标的规范化形式。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | 要归一化的笛卡尔坐标。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
修改后的结果参数。
将提供的实例存储到提供的数组中。
Name | Type | Default | Description |
---|---|---|---|
value
|
Cartesian4 | 要打包的值。 | |
array
|
Array.<Number> | 要打包的数组。 | |
startingIndex
|
Number |
0
|
可选 开始打包元素的数组索引。 |
Returns:
装入的数组
将 Cartesian4 数组展平为组件数组。
Name | Type | Description |
---|---|---|
array
|
Array.< Cartesian4 > | 要打包的笛卡尔数组。 |
result
|
Array.<Number> |
可选
存储结果的数组。如果这是一个类型化数组,它必须有 array.length * 4 个组件,否则会抛出
DeveloperError
。如果它是一个常规数组,它将被调整大小以具有 (array.length * 4) 个元素。
|
Returns:
打包的数组。
static Cesium.Cartesian4.packFloat (value, result ) → Cartesian4
将任意浮点值打包为 4 个可使用 uint8 表示的值。
Name | Type | Description |
---|---|---|
value
|
Number | 一个浮点数。 |
result
|
Cartesian4 | 可选 将包含打包浮点数的 Cartesian4。 |
Returns:
一个 Cartesian4,表示封装为 x、y、z 和 w 中的值的浮点数。
static Cesium.Cartesian4.subtract (left, right, result) → Cartesian4
计算两个笛卡尔的分量差。
Name | Type | Description |
---|---|---|
left
|
Cartesian4 | 第一个笛卡尔。 |
right
|
Cartesian4 | 第二个笛卡尔。 |
result
|
Cartesian4 | 存储结果的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian4.unpack (array, startingIndex , result ) → Cartesian4
从打包数组中检索实例。
Name | Type | Default | Description |
---|---|---|---|
array
|
Array.<Number> | 打包的数组。 | |
startingIndex
|
Number |
0
|
可选 要解包的元素的起始索引。 |
result
|
Cartesian4 | 可选 存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian4 实例(如果未提供)。
static Cesium.Cartesian4.unpackArray (array, result ) → Array.< Cartesian4 >
将一组笛卡尔分量解包成一组笛卡尔4。
Name | Type | Description |
---|---|---|
array
|
Array.<Number> | 要解包的组件数组。 |
result
|
Array.< Cartesian4 > | 可选 存储结果的数组。 |
Returns:
解压后的数组。