Cartesian4

四维笛卡尔点。

new Cesium.Cartesian4(x, y, z, w)
engine/Source/Core/Cartesian4.js 18

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

Members

w : number
engine/Source/Core/Cartesian4.js 52

W分量。
Default Value: 0.0

x : number
engine/Source/Core/Cartesian4.js 31

X分量。
Default Value: 0.0

y : number
engine/Source/Core/Cartesian4.js 38

Y分量。
Default Value: 0.0

z : number
engine/Source/Core/Cartesian4.js 45

Z分量。
Default Value: 0.0

static constant Cesium.Cartesian4.ONE : Cartesian4
engine/Source/Core/Cartesian4.js 940

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

static Cesium.Cartesian4.packedLength : number
engine/Source/Core/Cartesian4.js 898

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

static constant Cesium.Cartesian4.UNIT_W : Cartesian4
engine/Source/Core/Cartesian4.js 972

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

static constant Cesium.Cartesian4.UNIT_X : Cartesian4
engine/Source/Core/Cartesian4.js 948

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

static constant Cesium.Cartesian4.UNIT_Y : Cartesian4
engine/Source/Core/Cartesian4.js 956

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

static constant Cesium.Cartesian4.UNIT_Z : Cartesian4
engine/Source/Core/Cartesian4.js 964

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

static constant Cesium.Cartesian4.ZERO : Cartesian4
engine/Source/Core/Cartesian4.js 932

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

Methods

clone(result) → Cartesian4
engine/Source/Core/Cartesian4.js 789

复制此Cartesian4实例。
Name Type Description
result Cartesian4 optional 存储结果的对象。
Returns:
修改后的结果参数；如果未提供则返回新的Cartesian4实例。

equals(right) → boolean
engine/Source/Core/Cartesian4.js 800

逐分量将此笛卡尔坐标与提供的笛卡尔坐标进行比较，如果相等则返回 true，否则返回false。
Name Type Description
right Cartesian4 optional 右侧的笛卡尔坐标。
Returns:
如果相等则返回true，否则返回false。

equalsEpsilon(right, relativeEpsilon, absoluteEpsilon) → boolean
engine/Source/Core/Cartesian4.js 813

逐分量将此笛卡尔坐标与提供的笛卡尔坐标进行比较，如果通过绝对或相对容差测试则返回 true，否则返回false。
Name Type Default Description
right Cartesian4 optional 右侧的笛卡尔坐标。
relativeEpsilon number 0 optional 用于相等性测试的相对epsilon容差。
absoluteEpsilon number relativeEpsilon optional 用于相等性测试的绝对epsilon容差。
Returns:
如果它们在提供的epsilon范围内则返回true，否则返回false。

toString() → string
engine/Source/Core/Cartesian4.js 827

创建表示此笛卡尔坐标的字符串，格式为'(x, y, z, w)'。
Returns:
表示此笛卡尔坐标的字符串，格式为'(x, y, z, w)'。

static Cesium.Cartesian4.abs(cartesian, result) → Cartesian4
engine/Source/Core/Cartesian4.js 628

计算提供的笛卡尔坐标的绝对值。
Name Type Description
cartesian Cartesian4 要计算绝对值的笛卡尔坐标。
result Cartesian4 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian4.add(left, right, result) → Cartesian4
engine/Source/Core/Cartesian4.js 521

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

static Cesium.Cartesian4.clamp(value, min, max, result) → Cartesian4
engine/Source/Core/Cartesian4.js 320

将值限制在两个值之间。
Name Type Description
value Cartesian4 要限制的值。
min Cartesian4 最小边界。
max Cartesian4 最大边界。
result Cartesian4 存储结果的对象。
Returns:
限制后的值，满足 min <= result <= max。

static Cesium.Cartesian4.clone(cartesian, result) → Cartesian4
engine/Source/Core/Cartesian4.js 107

复制Cartesian4实例。
Name Type Description
cartesian Cartesian4 要复制的笛卡尔坐标。
result Cartesian4 optional 存储结果的对象。
Returns:
修改后的结果参数；如果未提供则返回新的Cartesian4实例。（如果cartesian未定义则返回undefined）

static Cesium.Cartesian4.distance(left, right) → number
engine/Source/Core/Cartesian4.js 383

计算两点之间的4维空间距离。
Name Type Description
left Cartesian4 要计算距离的的第一个点。
right Cartesian4 要计算距离的第二个点。
Returns:
两点之间的距离。
Example:
// 返回 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));

static Cesium.Cartesian4.distanceSquared(left, right) → number
engine/Source/Core/Cartesian4.js 407

计算两点之间的平方距离。使用此函数 比较平方距离比使用Cartesian4#distance比较距离更高效。
Name Type Description
left Cartesian4 要计算距离的的第一个点。
right Cartesian4 要计算距离的第二个点。
Returns:
两点之间的距离平方。
Example:
// 返回 4.0，不是 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
engine/Source/Core/Cartesian4.js 587

将提供的笛卡尔坐标按分量除以提供的标量。
Name Type Description
cartesian Cartesian4 要除的笛卡尔坐标。
scalar number 要除以的标量。
result Cartesian4 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian4.divideComponents(left, right, result) → Cartesian4
engine/Source/Core/Cartesian4.js 499

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

static Cesium.Cartesian4.dot(left, right) → number
engine/Source/Core/Cartesian4.js 458

计算两个笛卡尔坐标的点积（标量积）。
Name Type Description
left Cartesian4 第一个笛卡尔坐标。
right Cartesian4 第二个笛卡尔坐标。
Returns:
点积。

static Cesium.Cartesian4.equals(left, right) → boolean
engine/Source/Core/Cartesian4.js 714

逐分量比较提供的笛卡尔坐标，如果相等则返回 true，否则返回false。
Name Type Description
left Cartesian4 optional 第一个笛卡尔坐标。
right Cartesian4 optional 第二个笛卡尔坐标。
Returns:
如果left和right相等则返回true，否则返回false。

static Cesium.Cartesian4.equalsEpsilon(left, right, relativeEpsilon, absoluteEpsilon) → boolean
engine/Source/Core/Cartesian4.js 751

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

static Cesium.Cartesian4.fromArray(array, startingIndex, result) → Cartesian4
engine/Source/Core/Cartesian4.js 918

从数组中四个连续元素创建Cartesian4。
Name Type Default Description
array Array.<number> 其四个连续元素分别对应x、y、z和w分量的数组。
startingIndex number 0 optional 第一个元素（对应x分量）在数组中的偏移量。
result Cartesian4 optional 存储结果的对象。
Returns:
修改后的结果参数；如果未提供则返回新的Cartesian4实例。
Example:
// 创建具有(1.0, 2.0, 3.0, 4.0)的Cartesian4
const v = [1.0, 2.0, 3.0, 4.0];
const p = Cesium.Cartesian4.fromArray(v);

// 使用数组偏移量创建具有(1.0, 2.0, 3.0, 4.0)的Cartesian4
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
engine/Source/Core/Cartesian4.js 85

从Color创建Cartesian4实例。red、green、blue、 和alpha分别映射到x、y、z和w。
Name Type Description
color Color 源颜色。
result Cartesian4 optional 存储结果的对象。
Returns:
修改后的结果参数；如果未提供则返回新的Cartesian4实例。

static Cesium.Cartesian4.fromElements(x, y, z, w, result) → Cartesian4
engine/Source/Core/Cartesian4.js 65

从x、y、z和w坐标创建Cartesian4实例。
Name Type Description
x number x坐标。
y number y坐标。
z number z坐标。
w number w坐标。
result Cartesian4 optional 存储结果的对象。
Returns:
修改后的结果参数；如果未提供则返回新的Cartesian4实例。

static Cesium.Cartesian4.lerp(start, end, t, result) → Cartesian4
engine/Source/Core/Cartesian4.js 650

使用提供的笛卡尔坐标计算t处的线性插值或外推。
Name Type Description
start Cartesian4 t为0.0时对应的值。
end Cartesian4 t为1.0时对应的值。
t number 要插值的t点。
result Cartesian4 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian4.magnitude(cartesian) → number
engine/Source/Core/Cartesian4.js 366

计算笛卡尔坐标的模长（长度）。
Name Type Description
cartesian Cartesian4 要计算模长的笛卡尔实例。
Returns:
模长。

static Cesium.Cartesian4.magnitudeSquared(cartesian) → number
engine/Source/Core/Cartesian4.js 347

计算提供的笛卡尔坐标的平方模长。
Name Type Description
cartesian Cartesian4 要计算平方模长的笛卡尔实例。
Returns:
平方模长。

static Cesium.Cartesian4.maximumByComponent(first, second, result) → Cartesian4
engine/Source/Core/Cartesian4.js 296

比较两个笛卡尔坐标并计算包含两者最大分量的笛卡尔坐标。
Name Type Description
first Cartesian4 要比较的笛卡尔坐标。
second Cartesian4 要比较的笛卡尔坐标。
result Cartesian4 存储结果的对象。
Returns:
包含最大分量的笛卡尔坐标。

static Cesium.Cartesian4.maximumComponent(cartesian) → number
engine/Source/Core/Cartesian4.js 243

计算提供的笛卡尔坐标的最大分量值。
Name Type Description
cartesian Cartesian4 要使用的笛卡尔坐标。
Returns:
最大分量的值。

static Cesium.Cartesian4.minimumByComponent(first, second, result) → Cartesian4
engine/Source/Core/Cartesian4.js 273

比较两个笛卡尔坐标并计算包含两者最小分量的笛卡尔坐标。
Name Type Description
first Cartesian4 要比较的笛卡尔坐标。
second Cartesian4 要比较的笛卡尔坐标。
result Cartesian4 存储结果的对象。
Returns:
包含最小分量的笛卡尔坐标。

static Cesium.Cartesian4.minimumComponent(cartesian) → number
engine/Source/Core/Cartesian4.js 257

计算提供的笛卡尔坐标的最小分量值。
Name Type Description
cartesian Cartesian4 要使用的笛卡尔坐标。
Returns:
最小分量的值。

static Cesium.Cartesian4.mostOrthogonalAxis(cartesian, result) → Cartesian4
engine/Source/Core/Cartesian4.js 670

返回与提供的笛卡尔坐标最正交的轴。
Name Type Description
cartesian Cartesian4 要在其上查找最正交轴的笛卡尔坐标。
result Cartesian4 存储结果的对象。
Returns:
最正交的轴。

static Cesium.Cartesian4.multiplyByScalar(cartesian, scalar, result) → Cartesian4
engine/Source/Core/Cartesian4.js 565

将提供的笛卡尔坐标按分量乘以提供的标量。
Name Type Description
cartesian Cartesian4 要缩放的笛卡尔坐标。
scalar number 要相乘的标量。
result Cartesian4 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian4.multiplyComponents(left, right, result) → Cartesian4
engine/Source/Core/Cartesian4.js 477

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

static Cesium.Cartesian4.negate(cartesian, result) → Cartesian4
engine/Source/Core/Cartesian4.js 608

对提供的笛卡尔坐标取反。
Name Type Description
cartesian Cartesian4 要取反的笛卡尔坐标。
result Cartesian4 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian4.normalize(cartesian, result) → Cartesian4
engine/Source/Core/Cartesian4.js 424

计算提供的笛卡尔坐标的归一化形式。
Name Type Description
cartesian Cartesian4 要归一化的笛卡尔坐标。
result Cartesian4 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian4.pack(value, array, startingIndex) → Array.<number>
engine/Source/Core/Cartesian4.js 132

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

static Cesium.Cartesian4.packArray(array, result) → Array.<number>
engine/Source/Core/Cartesian4.js 180

将Cartesian4数组展平为分量数组。
Name Type Description
array Array.<Cartesian4> 要打包的笛卡尔坐标数组。
result Array.<number> optional 存储结果的数组。如果是类型化数组，则必须包含array.length * 4个分量，否则将抛出DeveloperError。如果是常规数组，则会调整大小以具有(array.length * 4)个元素。
Returns:
打包后的数组。

static Cesium.Cartesian4.packFloat(value, result) → Cartesian4
engine/Source/Core/Cartesian4.js 838

将任意浮点值打包为可使用uint8表示的4个值。
Name Type Description
value number 浮点数。
result Cartesian4 optional 将包含打包浮点数的Cartesian4。
Returns:
表示打包到x、y、z和w值中的浮点数的Cartesian4。

static Cesium.Cartesian4.subtract(left, right, result) → Cartesian4
engine/Source/Core/Cartesian4.js 543

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

static Cesium.Cartesian4.unpack(array, startingIndex, result) → Cartesian4
engine/Source/Core/Cartesian4.js 156

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

static Cesium.Cartesian4.unpackArray(array, result) → Array.<Cartesian4>
engine/Source/Core/Cartesian4.js 214

将笛卡尔分量数组解包为Cartesian4数组。
Name Type Description
array Array.<number> 要解包的分量数组。
result Array.<Cartesian4> optional 存储结果的数组。
Returns:
解包后的数组。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
CtrlK
packages/engine
packages/widgets