3D笛卡尔点。
Name | Type | Default | Description |
---|---|---|---|
x
|
Number |
0.0
|
可选 X组件。 |
y
|
Number |
0.0
|
可选 Y分量。 |
z
|
Number |
0.0
|
可选 Z分量。 |
See:
Members
X组件。
-
Default Value:
0.0
Y分量。
-
Default Value:
0.0
Z分量。
-
Default Value:
0.0
用于将对象打包到数组中的元素数。
static constant Cesium.Cartesian3.UNIT_X : Cartesian3
一个不变的Cartesian3实例,初始化为(1.0,0.0,0.0)。
static constant Cesium.Cartesian3.UNIT_Y : Cartesian3
一个不变的Cartesian3实例,初始化为(0.0,1.0,0.0)。
static constant Cesium.Cartesian3.UNIT_Z : Cartesian3
一个不变的Cartesian3实例,初始化为(0.0,0.0,1.0)。
static constant Cesium.Cartesian3.ZERO : Cartesian3
一个不变的Cartesian3实例,初始化为(0.0,0.0,0.0)。
Methods
clone ( result ) → Cartesian3
复制此Cartesian3实例。
Name | Type | Description |
---|---|---|
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,或者未提供新的Cartesian3实例。
将此笛卡尔坐标与提供的笛卡尔分量进行比较,然后返回如果相等,则为
true
,否则为
false
。
Name | Type | Description |
---|---|---|
right
|
Cartesian3 | 可选 右侧笛卡尔坐标。 |
Returns:
真正
如果相等,
假
除此以外。
将此笛卡尔坐标与提供的笛卡尔分量进行比较,然后返回
true
如果它们通过绝对或相对公差测试,否则为
false
。
Name | Type | Default | Description |
---|---|---|---|
right
|
Cartesian3 | 可选 右侧笛卡尔坐标。 | |
relativeEpsilon
|
Number | 用于相等性测试的相对epsilon公差。 | |
absoluteEpsilon
|
Number |
relativeEpsilon
|
可选 用于相等性测试的绝对epsilon公差。 |
Returns:
真正
如果它们在提供的epsilon中,
假
除此以外。
创建一个以'(x,y,z)'格式表示此笛卡尔坐标的字符串。
Returns:
表示此笛卡尔格式的字符串,格式为((x,y,z)'。
static Cesium.Cartesian3.abs (cartesian, result) → Cartesian3
计算提供的笛卡尔坐标的绝对值。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要计算其绝对值的笛卡尔坐标。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian3.add (left, right, result) → Cartesian3
计算两个笛卡尔的按分量求和。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 第一个笛卡尔式。 |
right
|
Cartesian3 | 第二个笛卡尔。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
修改后的结果参数。
返回所提供的笛卡尔坐标之间的角度(以弧度为单位)。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 第一个笛卡尔式。 |
right
|
Cartesian3 | 第二个笛卡尔。 |
Returns:
笛卡尔之间的角度。
static Cesium.Cartesian3.clone (cartesian, result ) → Cartesian3
复制Cartesian3实例。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要复制的笛卡尔坐标。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,或者未提供新的Cartesian3实例。 (如果未定义笛卡尔,则返回undefined)
static Cesium.Cartesian3.cross (left, right, result) → Cartesian3
计算两个笛卡尔的叉(外)乘积。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 第一个笛卡尔式。 |
right
|
Cartesian3 | 第二个笛卡尔。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
叉积。
计算两点之间的距离。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 计算距离的第一点。 |
right
|
Cartesian3 | 计算距离的第二点。 |
Returns:
两点之间的距离。
Example:
// Returns 1.0
var d = Cesium.Cartesian3.distance(new Cesium.Cartesian3(1.0, 0.0, 0.0), new Cesium.Cartesian3(2.0, 0.0, 0.0));
计算两点之间的平方距离。比较平方距离使用此功能比使用
Cartesian3#distance
比较距离更为有效。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 计算距离的第一点。 |
right
|
Cartesian3 | 计算距离的第二点。 |
Returns:
两点之间的距离。
Example:
// Returns 4.0, not 2.0
var d = Cesium.Cartesian3.distanceSquared(new Cesium.Cartesian3(1.0, 0.0, 0.0), new Cesium.Cartesian3(3.0, 0.0, 0.0));
static Cesium.Cartesian3.divideByScalar (cartesian, scalar, result) → Cartesian3
将提供的笛卡尔分量除以提供的标量。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要划分的笛卡尔坐标。 |
scalar
|
Number | 要除以的标量。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian3.divideComponents (left, right, result) → Cartesian3
计算两个笛卡尔的分量商。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 第一个笛卡尔式。 |
right
|
Cartesian3 | 第二个笛卡尔。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
修改后的结果参数。
计算两个笛卡尔的点(标量)乘积。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 第一个笛卡尔式。 |
right
|
Cartesian3 | 第二个笛卡尔。 |
Returns:
点积。
比较提供的笛卡尔分量并返回如果相等,则为
true
,否则为
false
。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 可选 第一个笛卡尔式。 |
right
|
Cartesian3 | 可选 第二个笛卡尔。 |
Returns:
真正
如果左右相等
假
除此以外。
static Cesium.Cartesian3.equalsEpsilon ( left , right , relativeEpsilon, absoluteEpsilon ) → Boolean
比较提供的笛卡尔分量并返回
true
如果它们通过绝对或相对公差测试,否则为
false
。
Name | Type | Default | Description |
---|---|---|---|
left
|
Cartesian3 | 可选 第一个笛卡尔式。 | |
right
|
Cartesian3 | 可选 第二个笛卡尔。 | |
relativeEpsilon
|
Number | 用于相等性测试的相对epsilon公差。 | |
absoluteEpsilon
|
Number |
relativeEpsilon
|
可选 用于相等性测试的绝对epsilon公差。 |
Returns:
真正
如果左右在提供的epsilon内,
假
除此以外。
static Cesium.Cartesian3.fromArray (array, startingIndex , result ) → Cartesian3
从数组中的三个连续元素创建Cartesian3。
Name | Type | Default | Description |
---|---|---|---|
array
|
Array.<Number> | 其三个连续元素分别对应于x,y和z分量的数组。 | |
startingIndex
|
Number |
0
|
可选 第一个元素的数组的偏移量,它对应于x分量。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,或者未提供新的Cartesian3实例。
Example:
// Create a Cartesian3 with (1.0, 2.0, 3.0)
var v = [1.0, 2.0, 3.0];
var p = Cesium.Cartesian3.fromArray(v);
// Create a Cartesian3 with (1.0, 2.0, 3.0) using an offset into an array
var v2 = [0.0, 0.0, 1.0, 2.0, 3.0];
var p2 = Cesium.Cartesian3.fromArray(v2, 2);
static Cesium.Cartesian3.fromCartesian4 (cartesian, result ) → Cartesian3
从现有的Cartesian4创建Cartesian3实例。这只是需要笛卡尔4和水滴w的x,y和z属性。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian4 | Cartesian4实例,从中创建Cartesian3实例。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,或者未提供新的Cartesian3实例。
static Cesium.Cartesian3.fromDegrees (longitude, latitude, height , ellipsoid , result ) → Cartesian3
从以度为单位的经度和纬度值返回Cartesian3位置。
Name | Type | Default | Description |
---|---|---|---|
longitude
|
Number | 经度,以度为单位 | |
latitude
|
Number | 纬度,以度为单位 | |
height
|
Number |
0.0
|
可选 椭球上方的高度(以米为单位)。 |
ellipsoid
|
Ellipsoid |
Ellipsoid.WGS84
|
可选 位置所在的椭圆体。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
职位
Example:
var position = Cesium.Cartesian3.fromDegrees(-115.0, 37.0);
static Cesium.Cartesian3.fromDegreesArray (coordinates, ellipsoid , result ) → Array.< Cartesian3 >
返回以给定的经度和纬度值(以度为单位)数组为单位的Cartesian3位置数组。
Name | Type | Default | Description |
---|---|---|---|
coordinates
|
Array.<Number> | 经度和纬度值列表。值交替显示[经度,纬度,经度,纬度...]。 | |
ellipsoid
|
Ellipsoid |
Ellipsoid.WGS84
|
可选 坐标所在的椭球。 |
result
|
Array.< Cartesian3 > | 可选 一组Cartesian3对象用于存储结果。 |
Returns:
位置数组。
Example:
var positions = Cesium.Cartesian3.fromDegreesArray([-115.0, 37.0, -107.0, 33.0]);
static Cesium.Cartesian3.fromDegreesArrayHeights (coordinates, ellipsoid , result ) → Array.< Cartesian3 >
返回给定的经度,纬度和高度值数组,其中,经度和纬度以度为单位的Cartesian3位置数组。
Name | Type | Default | Description |
---|---|---|---|
coordinates
|
Array.<Number> | 经度,纬度和高度值的列表。值交替显示[经度,纬度,高度,经度,纬度,高度...]。 | |
ellipsoid
|
Ellipsoid |
Ellipsoid.WGS84
|
可选 位置所在的椭圆体。 |
result
|
Array.< Cartesian3 > | 可选 一组Cartesian3对象用于存储结果。 |
Returns:
位置数组。
Example:
var positions = Cesium.Cartesian3.fromDegreesArrayHeights([-115.0, 37.0, 100000.0, -107.0, 33.0, 150000.0]);
static Cesium.Cartesian3.fromElements (x, y, z, result ) → Cartesian3
根据x,y和z坐标创建Cartesian3实例。
Name | Type | Description |
---|---|---|
x
|
Number | x坐标。 |
y
|
Number | y坐标。 |
z
|
Number | z坐标。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,或者未提供新的Cartesian3实例。
static Cesium.Cartesian3.fromRadians (longitude, latitude, height , ellipsoid , result ) → Cartesian3
从以弧度给出的经度和纬度值返回Cartesian3位置。
Name | Type | Default | Description |
---|---|---|---|
longitude
|
Number | 经度,以弧度为单位 | |
latitude
|
Number | 纬度,以弧度为单位 | |
height
|
Number |
0.0
|
可选 椭球上方的高度(以米为单位)。 |
ellipsoid
|
Ellipsoid |
Ellipsoid.WGS84
|
可选 位置所在的椭圆体。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
职位
Example:
var position = Cesium.Cartesian3.fromRadians(-2.007, 0.645);
static Cesium.Cartesian3.fromRadiansArray (coordinates, ellipsoid , result ) → Array.< Cartesian3 >
返回给定的笛卡尔3位置数组,该数组给出以弧度给出的经度和纬度值数组。
Name | Type | Default | Description |
---|---|---|---|
coordinates
|
Array.<Number> | 经度和纬度值列表。值交替显示[经度,纬度,经度,纬度...]。 | |
ellipsoid
|
Ellipsoid |
Ellipsoid.WGS84
|
可选 坐标所在的椭球。 |
result
|
Array.< Cartesian3 > | 可选 一组Cartesian3对象用于存储结果。 |
Returns:
位置数组。
Example:
var positions = Cesium.Cartesian3.fromRadiansArray([-2.007, 0.645, -1.867, .575]);
static Cesium.Cartesian3.fromRadiansArrayHeights (coordinates, ellipsoid , result ) → Array.< Cartesian3 >
返回给定的经度,纬度和高度值数组,其中,经度和纬度以弧度表示的Cartesian3位置数组。
Name | Type | Default | Description |
---|---|---|---|
coordinates
|
Array.<Number> | 经度,纬度和高度值的列表。值交替显示[经度,纬度,高度,经度,纬度,高度...]。 | |
ellipsoid
|
Ellipsoid |
Ellipsoid.WGS84
|
可选 位置所在的椭圆体。 |
result
|
Array.< Cartesian3 > | 可选 一组Cartesian3对象用于存储结果。 |
Returns:
位置数组。
Example:
var positions = Cesium.Cartesian3.fromRadiansArrayHeights([-2.007, 0.645, 100000.0, -1.867, .575, 150000.0]);
static Cesium.Cartesian3.fromSpherical (spherical, result ) → Cartesian3
将提供的Spherical转换为Cartesian3坐标。
Name | Type | Description |
---|---|---|
spherical
|
Spherical | 要转换为笛卡尔3的球形。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,或者未提供新的Cartesian3实例。
static Cesium.Cartesian3.lerp (start, end, t, result) → Cartesian3
使用提供的笛卡尔坐标计算t处的线性插值或外推。
Name | Type | Description |
---|---|---|
start
|
Cartesian3 | 对应于t的值为0.0。 |
end
|
Cartesian3 | 对应于t的值为1.0。 |
t
|
Number | 沿t的插值点。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
修改后的结果参数。
计算笛卡尔的大小(长度)。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要计算其大小的笛卡尔实例。 |
Returns:
幅度。
计算提供的笛卡尔平方强度。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要计算其平方大小的笛卡尔实例。 |
Returns:
平方值。
static Cesium.Cartesian3.maximumByComponent (first, second, result) → Cartesian3
比较两个笛卡尔,并计算一个笛卡尔,其中包含所提供笛卡尔的最大分量。
Name | Type | Description |
---|---|---|
first
|
Cartesian3 | 笛卡尔进行比较。 |
second
|
Cartesian3 | 笛卡尔进行比较。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
具有最大分量的笛卡尔。
计算所提供的笛卡尔的最大分量的值。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要使用的笛卡尔坐标。 |
Returns:
最大分量的值。
static Cesium.Cartesian3.midpoint (left, right, result) → Cartesian3
计算左右笛卡尔坐标之间的中点。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 第一个笛卡尔式。 |
right
|
Cartesian3 | 第二个笛卡尔。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
中点。
static Cesium.Cartesian3.minimumByComponent (first, second, result) → Cartesian3
比较两个笛卡尔,并计算一个笛卡尔,其中包含所提供笛卡尔的最小分量。
Name | Type | Description |
---|---|---|
first
|
Cartesian3 | 笛卡尔进行比较。 |
second
|
Cartesian3 | 笛卡尔进行比较。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
具有最少成分的笛卡尔。
计算所提供的直角坐标的最小分量的值。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要使用的笛卡尔坐标。 |
Returns:
最小成分的值。
static Cesium.Cartesian3.mostOrthogonalAxis (cartesian, result) → Cartesian3
返回与提供的笛卡尔坐标最正交的轴。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要在其上找到最正交轴的笛卡尔坐标。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
最正交的轴。
static Cesium.Cartesian3.multiplyByScalar (cartesian, scalar, result) → Cartesian3
将提供的笛卡尔分量乘以提供的标量。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要缩放的笛卡尔坐标。 |
scalar
|
Number | 要与之相乘的标量。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian3.multiplyComponents (left, right, result) → Cartesian3
计算两个笛卡尔的分量积。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 第一个笛卡尔式。 |
right
|
Cartesian3 | 第二个笛卡尔。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian3.negate (cartesian, result) → Cartesian3
取反提供的笛卡尔坐标。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 笛卡尔要否定。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian3.normalize (cartesian, result) → Cartesian3
计算提供的笛卡尔坐标系的标准化形式。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要标准化的笛卡尔坐标。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
修改后的结果参数。
将提供的实例存储到提供的数组中。
Name | Type | Default | Description |
---|---|---|---|
value
|
Cartesian3 | 要打包的值。 | |
array
|
Array.<Number> | 要打包的数组。 | |
startingIndex
|
Number |
0
|
可选 开始包装元素的数组索引。 |
Returns:
打包到的数组
将笛卡尔3数组展平为组件数组。
Name | Type | Description |
---|---|---|
array
|
Array.< Cartesian3 > | 要打包的笛卡尔数组。 |
result
|
Array.<Number> | 可选 将结果存储到的数组。 |
Returns:
压缩数组。
static Cesium.Cartesian3.projectVector (a, b, result) → Cartesian3
将向量a投射到向量b上
Name | Type | Description |
---|---|---|
a
|
Cartesian3 | 需要投影的向量 |
b
|
Cartesian3 | 要投影到的向量 |
result
|
Cartesian3 | 结果笛卡尔 |
Returns:
修改后的结果参数
static Cesium.Cartesian3.subtract (left, right, result) → Cartesian3
计算两个笛卡尔的分量差异。
Name | Type | Description |
---|---|---|
left
|
Cartesian3 | 第一个笛卡尔式。 |
right
|
Cartesian3 | 第二个笛卡尔。 |
result
|
Cartesian3 | 将结果存储到的对象。 |
Returns:
修改后的结果参数。
static Cesium.Cartesian3.unpack (array, startingIndex , result ) → Cartesian3
从压缩数组中检索实例。
Name | Type | Default | Description |
---|---|---|---|
array
|
Array.<Number> | 压缩数组。 | |
startingIndex
|
Number |
0
|
可选 要解压缩的元素的起始索引。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,或者未提供新的Cartesian3实例。
static Cesium.Cartesian3.unpackArray (array, result ) → Array.< Cartesian3 >
将笛卡尔分量数组解压缩为笛卡尔3s数组。
Name | Type | Description |
---|---|---|
array
|
Array.<Number> | 要解包的组件数组。 |
result
|
Array.< Cartesian3 > | 可选 将结果存储到的数组。 |
Returns:
解压缩的数组。