Cesium API - Cartesian4 中文文档

new Cesium.Cartesian4(x, y, z, w)

4D笛卡尔点。

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 分量。

参考：

成员变量

w : Number

Core/Cartesian4.js 49

W 分量。

Default Value: 0.0

x : Number

Core/Cartesian4.js 28

X 分量。

Default Value: 0.0

y : Number

Core/Cartesian4.js 35

Y 分量。

Default Value: 0.0

z : Number

Core/Cartesian4.js 42

Z 分量。

Default Value: 0.0

staticCesium.Cartesian4.packedLength : Number

Core/Cartesian4.js 147

用于将对象打包成数组的元素数。

staticconstantCesium.Cartesian4.UNIT_W : Cartesian4

Core/Cartesian4.js 1008

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

staticconstantCesium.Cartesian4.UNIT_X : Cartesian4

Core/Cartesian4.js 984

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

staticconstantCesium.Cartesian4.UNIT_Y : Cartesian4

Core/Cartesian4.js 992

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

staticconstantCesium.Cartesian4.UNIT_Z : Cartesian4

Core/Cartesian4.js 1000

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

staticconstantCesium.Cartesian4.ZERO : Cartesian4

Core/Cartesian4.js 976

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

内置方法

clone(result) → Cartesian4

Core/Cartesian4.js 1016

复制这个Cartesian4实例。

Name	Type	Description
`result`	Cartesian4	optional 存储结果的对象。

返回值：

修改后的结果参数，或新的Cartesian4实例（如果没有提供）。

equals(right) → Boolean

Core/Cartesian4.js 1033

将此笛卡尔坐标与提供的笛卡尔坐标分量进行比较，如果相等，则返回true，否则返回false。

Name	Type	Description
`right`	Cartesian4	optional 要比较的笛卡尔坐标。

返回值：

true 如果相等，否则false。

equalsEpsilon(right, relativeEpsilon, absoluteEpsilon) → Boolean

Core/Cartesian4.js 1055

将这个笛卡尔坐标与所提供的笛卡尔坐标分量进行比较，如果通过了绝对或相对公差测试，则返回true，否则返回false。

Name	Type	Default	Description
`right`	Cartesian4		optional 要比较的笛卡尔坐标。
`relativeEpsilon`	Number		用于相等性测试的相对epsilon公差。
`absoluteEpsilon`	Number	`relativeEpsilon`	optional 用于相等性测试的绝对epsilon公差。

返回值：

true如果它们都在规定的epsilon范围内，否则false。

toString() → String

Core/Cartesian4.js 1064

以'(x, y, z, w)'的格式创建表示该笛卡尔坐标的字符串。

返回值：

表示格式为‘(x, y, z, w)’的所提供的笛卡尔坐标的字符串。

staticCesium.Cartesian4.abs(cartesian, result) → Cartesian4

Core/Cartesian4.js 810

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

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

返回值：

修改后的结果参数。

staticCesium.Cartesian4.add(left, right, result) → Cartesian4

Core/Cartesian4.js 665

计算两个笛卡儿坐标的分量和。

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

返回值：

修改后的结果参数。

staticCesium.Cartesian4.clone(cartesian, result) → Cartesian4

Core/Cartesian4.js 123

复制一个 Cartesian4 实例。

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

返回值：

修改后的结果参数，或者一个新的Cartesian3实例（如果没有提供）。（如果笛卡尔坐标未定义，则返回undefined）

staticCesium.Cartesian4.distance(left, right) → Number

Core/Cartesian4.js 484

计算两点之间的4空间（4-space）距离。

Name	Type	Description
`left`	Cartesian4	第一个点。
`right`	Cartesian4	第二个点。

返回值：

两点之间的距离。

示例：

// Returns 1.0
var 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));

staticCesium.Cartesian4.distanceSquared(left, right) → Number

Core/Cartesian4.js 520

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

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

返回值：

两点之间的距离。

示例：

// 返回 4.0, 而不是 2.0。
var 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));

staticCesium.Cartesian4.divideByScalar(cartesian, scalar, result) → Cartesian4

Core/Cartesian4.js 755

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

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

返回值：

修改后的结果参数。

staticCesium.Cartesian4.divideComponents(left, right, result) → Cartesian4

Core/Cartesian4.js 635

计算两个笛卡儿坐标的分量商。

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

返回值：

修改后的结果参数。

staticCesium.Cartesian4.dot(left, right) → Number

Core/Cartesian4.js 580

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

Name	Type	Description
`left`	Cartesian4	第一个笛卡尔坐标。
`right`	Cartesian4	第二个笛卡尔坐标。

返回值：

点积。

staticCesium.Cartesian4.equals(left, right) → Boolean

Core/Cartesian4.js 920

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

Name	Type	Description
`left`	Cartesian4	optional 第一个笛卡尔坐标。
`right`	Cartesian4	optional 第二个笛卡尔坐标。

返回值：

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

staticCesium.Cartesian4.equalsEpsilon(left, right, relativeEpsilon, absoluteEpsilon) → Boolean

Core/Cartesian4.js 960

比较所提供的笛卡尔坐标分量，如果通过了绝对或相对公差测试，则返回true，否则返回false。

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

返回值：

true如果left和right都在规定的epsilon范围内，否则false。

staticCesium.Cartesian4.fromArray(array, startingIndex, result) → Cartesian4

Core/Cartesian4.js 316

从数组中的四个连续元素创建Cartesian4。

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

返回值：

修改后的结果参数，或新的Cartesian4实例（如果没有提供）

示例：

// 使用 (1.0, 2.0, 3.0, 4.0)创建一个Cartesian3
var v = [1.0, 2.0, 3.0, 4.0];
var p = Cesium.Cartesian4.fromArray(v);
// 使用(1.0, 2.0, 3.0, 4.0)在数组中使用偏移量创建Cartesian4
var v2 = [0.0, 0.0, 1.0, 2.0, 3.0, 4.0];
var p2 = Cesium.Cartesian4.fromArray(v2, 2);

staticCesium.Cartesian4.fromColor(color, result) → Cartesian4

Core/Cartesian4.js 100

从一个Color创建一个Cartesian4实例。 red, green, blue, 和alpha 分别映射为 x, y, z, 和 w。

Name	Type	Description
`color`	Color	源的颜色。
`result`	Cartesian4	optional 存储结果的对象。

返回值：

修改后的结果参数，或者一个新的Cartesian4实例（如果没有提供）。

staticCesium.Cartesian4.fromElements(x, y, z, w, result) → Cartesian4

Core/Cartesian4.js 72

从x、y、z和w坐标创建一个Cartesian4实例。

Name	Type	Description
`x`	Number	x 坐标。
`y`	Number	y 坐标。
`z`	Number	z 坐标。
`w`	Number	w 坐标。
`result`	Cartesian4	optional 存储结果的对象。

返回值：

修改后的结果参数，或者一个新的Cartesian4实例（如果没有提供）。

staticCesium.Cartesian4.lerp(start, end, t, result) → Cartesian4

Core/Cartesian4.js 842

使用所提供的笛卡尔坐标计算t处的线性插值或外推（extrapolation）。

Name	Type	Description
`start`	Cartesian4	对应于0.0的t值。
`end`	Cartesian4	对应于1.0的t值。
`t`	Number	在t上做插值的点。
`result`	Cartesian4	存储结果的对象。

返回值：

修改后的结果参数。

staticCesium.Cartesian4.magnitude(cartesian) → Number

Core/Cartesian4.js 452

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

Name	Type	Description
`cartesian`	Cartesian4	要计算其大小的笛卡儿坐标实例。

返回值：

大小。

staticCesium.Cartesian4.magnitudeSquared(cartesian) → Number

Core/Cartesian4.js 432

计算所提供的笛卡尔坐标的平方大小。

Name	Type	Description
`cartesian`	Cartesian4	要计算其平方大小的笛卡儿坐标实例。

返回值：

平方大小。

staticCesium.Cartesian4.maximumByComponent(first, second, result) → Cartesian4

Core/Cartesian4.js 405

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

Name	Type	Description
`first`	Cartesian4	第一个笛卡尔坐标
`second`	Cartesian4	第二个笛卡尔坐标
`result`	Cartesian4	存储结果的对象。

返回值：

包含最大分量的笛卡尔坐标。

staticCesium.Cartesian4.maximumComponent(cartesian) → Number

Core/Cartesian4.js 330

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

Name	Type	Description
`cartesian`	Cartesian4	使用的笛卡尔坐标。

返回值：

最大分量的值。

staticCesium.Cartesian4.minimumByComponent(first, second, result) → Cartesian4

Core/Cartesian4.js 374

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

Name	Type	Description
`first`	Cartesian4	第一个笛卡尔坐标
`second`	Cartesian4	第二个笛卡尔坐标
`result`	Cartesian4	存储结果的对象。

返回值：

包含最小分量的笛卡尔坐标。

staticCesium.Cartesian4.minimumComponent(cartesian) → Number

Core/Cartesian4.js 350

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

Name	Type	Description
`cartesian`	Cartesian4	使用的笛卡尔坐标。

返回值：

最小分量的值。

staticCesium.Cartesian4.mostOrthogonalAxis(cartesian, result) → Cartesian4

Core/Cartesian4.js 870

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

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

返回值：

最正交的轴。

staticCesium.Cartesian4.multiplyByScalar(cartesian, scalar, result) → Cartesian4

Core/Cartesian4.js 725

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

Name	Type	Description
`cartesian`	Cartesian4	要被乘的笛卡尔坐标。
`scalar`	Number	要乘以的标量。
`result`	Cartesian4	存储结果的对象。

返回值：

修改后的结果参数。

staticCesium.Cartesian4.multiplyComponents(left, right, result) → Cartesian4

Core/Cartesian4.js 605

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

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

返回值：

修改后的结果参数。

staticCesium.Cartesian4.negate(cartesian, result) → Cartesian4

Core/Cartesian4.js 783

对所提供的笛卡尔坐标取反。

Name	Type	Description
`cartesian`	Cartesian4	要取反的笛卡尔坐标。
`result`	Cartesian4	存储结果的对象。

返回值：

修改后的结果参数。

staticCesium.Cartesian4.normalize(cartesian, result) → Cartesian4

Core/Cartesian4.js 544

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

Name	Type	Description
`cartesian`	Cartesian4	要标准化的笛卡尔坐标。
`result`	Cartesian4	存储结果的对象。

返回值：

修改后的结果参数。

staticCesium.Cartesian4.pack(value, array, startingIndex) → Array.<Number>

Core/Cartesian4.js 167

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

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

返回值：

被打包到的数组。

staticCesium.Cartesian4.packArray(array, result) → Array.<Number>

Core/Cartesian4.js 230

将Cartesian4s数组展平为分量数组。

Name	Type	Description
`array`	Array.<Cartesian4>	要打包的笛卡尔坐标数组。
`result`	Array.<Number>	optional 存储结果的数组。

返回值：

打包后的数组。

staticCesium.Cartesian4.packFloat(value, result) → Cartesian4

Core/Cartesian4.js 1093

使用uint8将任意浮点值包装为4个可表示的值。

Name	Type	Description
`value`	Number	浮点数.
`result`	Cartesian4	optional 将包含包装浮点数的Cartesian4。

返回值：

一个Cartesian4，表示被包装成x、y、z和w中的值的浮点数。

staticCesium.Cartesian4.subtract(left, right, result) → Cartesian4

Core/Cartesian4.js 695

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

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

返回值：

修改后的结果参数。

staticCesium.Cartesian4.unpack(array, startingIndex, result) → Cartesian4

Core/Cartesian4.js 199

从已打包的数组中检索实例。

Name	Type	Default	Description
`array`	Array.<Number>		被打包到的数组。
`startingIndex`	Number	`0`	optional 要解包的元素的起始索引。
`result`	Cartesian4		optional 存储结果的对象。