麻辣GIS微信平台

更多 GIS 干货

微信关注不错过

Cesium API - Cartesian4 中文文档

发布时间: 2019-11-07 所属分类: Cesium中文API文档（v1.63.1） 文章标签: cesiumCesium中文文档
当前位置：
麻辣GIS » GIS手册 » Cesium中文API文档（v1.63.1） » Cesium API - Cartesian4 中文文档

本文介绍下Cesium中 Cartesian4 API的详细使用说明。

Cartesian4 API 调用方法

new Cesium.Cartesian4(x, y, z, w)
Core/Cartesian4.js 22
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 分量。
Default Value: 0.0
X 分量。
Default Value: 0.0
Y 分量。
Default Value: 0.0
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)。

内置方法

复制这个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 存储结果的对象。
返回值：
修改后的结果参数，或者一个新的Cartesian4实例（如果没有提供）。
staticCesium.Cartesian4.unpackArray(array, result) → Array.<Cartesian4>
Core/Cartesian4.js 262
将一个笛卡儿分量数组解包到Cartesian4s数组中。
Name Type Description
array Array.<Number> 要解包的组件分量。
result Array.<Cartesian4> optional 存储结果的数组。
返回值：
解包后的数组。

其他API

Cesium中文API文档手册（v1.63.1版本）参考：《Cesium中文API文档手册（v1.63.1版本）》

相关阅读

快速搭建一个Cesium应用示例
快速搭建一个Cesium应用示例
2024-01-03
Cesium ion支持私有化部署
Cesium ion支持私有化部署
2023-12-15
3D Tiles格式说明电子版(中文版PDF)
3D Tiles格式说明电子版(中文版PDF)
2023-12-13
Cesium中的常用格式 3D Tiles简介
Cesium中的常用格式 3D Tiles简介
2023-12-12
Cesium中的glTF是什么
Cesium中的glTF是什么
2023-12-05
为什么选择Cesium
为什么选择Cesium
2023-12-04
麻辣GIS-Sailor

作者：

GIS爱好者，学GIS，更爱玩GIS。
B站关注 加入微信群

声明

1.本文所分享的所有需要用户下载使用的内容（包括但不限于软件、数据、图片）来自于网络或者麻辣GIS粉丝自行分享，版权归该下载资源的合法拥有者所有，如有侵权请第一时间联系本站删除。

2.下载内容仅限个人学习使用，请切勿用作商用等其他用途，否则后果自负。

手机阅读
公众号关注
知识星球
手机阅读
麻辣GIS微信公众号关注
最新GIS干货
关注麻辣GIS知识星球
私享圈子

留言板（小编看到第一时间回复）