指定为经度和纬度坐标的二维区域。
Name | Type | Default | Description |
---|---|---|---|
west
|
Number |
0.0
|
可选 最西端的经度,以弧度为单位,在 [-Pi, Pi] 范围内。 |
south
|
Number |
0.0
|
可选 最南端的纬度,以弧度为单位,范围为 [-Pi/2, Pi/2]。 |
east
|
Number |
0.0
|
可选 最东经度,以弧度为单位,在 [-Pi, Pi] 范围内。 |
north
|
Number |
0.0
|
可选 最北纬度,以弧度表示,范围为 [-Pi/2, Pi/2]。 |
See:
Members
static constant Cesium.Rectangle.MAX_VALUE : Rectangle
可能的最大矩形。
用于将对象打包到数组中的元素数。
[-Pi, Pi] 范围内以弧度表示的最东经度。
-
Default Value:
0.0
以弧度为单位获取矩形的高度。
[-Pi/2, Pi/2] 范围内以弧度表示的最北纬度。
-
Default Value:
0.0
[-Pi/2, Pi/2] 范围内的最南端纬度(以弧度表示)。
-
Default Value:
0.0
[-Pi, Pi] 范围内以弧度表示的最西经度。
-
Default Value:
0.0
以弧度为单位获取矩形的宽度。
Methods
static Cesium.Rectangle.center (rectangle, result ) → Cartographic
计算矩形的中心。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 为其找到中心的矩形 |
result
|
Cartographic | 可选 存储结果的对象。 |
Returns:
如果未提供修改的结果参数或新的制图实例。
static Cesium.Rectangle.clone (rectangle, result ) → Rectangle
复制一个矩形。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 要克隆的矩形。 |
result
|
Rectangle | 可选 存储结果的对象,如果应该创建一个新实例,则为 undefined。 |
Returns:
如果未提供修改的结果参数或新的 Rectangle 实例。 (如果矩形未定义,则返回未定义)
以弧度计算矩形的高度。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 计算高度的矩形。 |
Returns:
高度。
以弧度计算矩形的宽度。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 要计算其宽度的矩形。 |
Returns:
宽度。
如果制图在矩形上或矩形内,则返回 true,否则返回 false。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 矩形 |
cartographic
|
Cartographic | 要测试的制图。 |
Returns:
如果提供的制图在矩形内,则为 true,否则为 false。
比较提供的矩形,如果相等则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
left
|
Rectangle | 可选 第一个矩形。 |
right
|
Rectangle | 可选 第二个矩形。 |
Returns:
如果左右相等,则为
true
;否则
false
。
比较提供的 Rectangles 组件,如果它们通过绝对或相对容差测试,则返回
true
,否则返回
false
。
Name | Type | Default | Description |
---|---|---|---|
left
|
Rectangle | 可选 第一个矩形。 | |
right
|
Rectangle | 可选 第二个矩形。 | |
absoluteEpsilon
|
Number |
0
|
可选 用于相等测试的绝对 epsilon 容差。 |
Returns:
true
left 和 right 在提供的 epsilon 内,则为 true,否则为
false
。
static Cesium.Rectangle.expand (rectangle, cartographic, result ) → Rectangle
通过扩大提供的矩形直到它包含提供的制图来计算一个矩形。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 要扩展的矩形。 |
cartographic
|
Cartographic | 包含在矩形中的地图。 |
result
|
Rectangle | 可选 存储结果的对象。 |
Returns:
修改后的结果参数或新的 Rectangle 实例(如果未提供)。
static Cesium.Rectangle.fromCartesianArray (cartesians, ellipsoid , result ) → Rectangle
创建包含所提供数组中所有位置的最小可能矩形。
Name | Type | Default | Description |
---|---|---|---|
cartesians
|
Array.< Cartesian3 > | 笛卡尔实例列表。 | |
ellipsoid
|
Ellipsoid |
Ellipsoid.WGS84
|
可选 笛卡尔所在的椭球体。 |
result
|
Rectangle | 可选 存储结果的对象,如果应该创建一个新实例,则为 undefined。 |
Returns:
如果未提供修改的结果参数或新的 Rectangle 实例。
static Cesium.Rectangle.fromCartographicArray (cartographics, result ) → Rectangle
创建包含所提供数组中所有位置的最小可能矩形。
Name | Type | Description |
---|---|---|
cartographics
|
Array.< Cartographic > | 制图实例列表。 |
result
|
Rectangle | 可选 存储结果的对象,如果应该创建一个新实例,则为 undefined。 |
Returns:
如果未提供修改的结果参数或新的 Rectangle 实例。
static Cesium.Rectangle.fromDegrees ( west , south , east , north , result ) → Rectangle
在给定边界经度和纬度(以度为单位)的情况下创建一个矩形。
Name | Type | Default | Description |
---|---|---|---|
west
|
Number |
0.0
|
可选 [-180.0, 180.0] 范围内的最西经度,以度为单位。 |
south
|
Number |
0.0
|
可选 [-90.0, 90.0] 范围内的最南端纬度,以度为单位。 |
east
|
Number |
0.0
|
可选 [-180.0, 180.0] 范围内的最东经度,以度为单位。 |
north
|
Number |
0.0
|
可选 在 [-90.0, 90.0] 范围内以度为单位的最北纬度。 |
result
|
Rectangle | 可选 存储结果的对象,如果应该创建一个新实例,则为 undefined。 |
Returns:
如果未提供修改的结果参数或新的 Rectangle 实例。
Example:
const rectangle = Cesium.Rectangle.fromDegrees(0.0, 20.0, 10.0, 30.0);
static Cesium.Rectangle.fromRadians ( west , south , east , north , result ) → Rectangle
在给定边界经度和纬度(以弧度为单位)的情况下创建一个矩形。
Name | Type | Default | Description |
---|---|---|---|
west
|
Number |
0.0
|
可选 在 [-Math.PI, Math.PI] 范围内以弧度表示的最西经度。 |
south
|
Number |
0.0
|
可选 在 [-Math.PI/2, Math.PI/2] 范围内以弧度表示的最南端纬度。 |
east
|
Number |
0.0
|
可选 在 [-Math.PI, Math.PI] 范围内以弧度表示的最东经度。 |
north
|
Number |
0.0
|
可选 在 [-Math.PI/2, Math.PI/2] 范围内以弧度表示的最北纬度。 |
result
|
Rectangle | 可选 存储结果的对象,如果应该创建一个新实例,则为 undefined。 |
Returns:
如果未提供修改的结果参数或新的 Rectangle 实例。
Example:
const rectangle = Cesium.Rectangle.fromRadians(0.0, Math.PI/4, Math.PI/8, 3*Math.PI/4);
static Cesium.Rectangle.intersection (rectangle, otherRectangle, result ) → Rectangle |undefined
计算两个矩形的交集。该函数假定矩形的坐标是以弧度为单位的纬度和经度并产生正确的交点,同时考虑到相同的角度可以用多个值表示以及经度在反子午线上的环绕这一事实。有关忽略这些因素并可与投影坐标一起使用的简单交集,请参阅
Rectangle.simpleIntersection
。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 在矩形上找到一个交点 |
otherRectangle
|
Rectangle | 寻找交点的另一个矩形 |
result
|
Rectangle | 可选 存储结果的对象。 |
Returns:
修改后的结果参数,如果没有提供新的 Rectangle 实例,如果没有交集,则为 undefined。
static Cesium.Rectangle.northeast (rectangle, result ) → Cartographic
计算矩形的东北角。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 为其找到角的矩形 |
result
|
Cartographic | 可选 存储结果的对象。 |
Returns:
如果未提供修改的结果参数或新的制图实例。
static Cesium.Rectangle.northwest (rectangle, result ) → Cartographic
计算矩形的西北角。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 为其找到角的矩形 |
result
|
Cartographic | 可选 存储结果的对象。 |
Returns:
如果未提供修改的结果参数或新的制图实例。
将提供的实例存储到提供的数组中。
Name | Type | Default | Description |
---|---|---|---|
value
|
Rectangle | 要打包的值。 | |
array
|
Array.<Number> | 要打包的数组。 | |
startingIndex
|
Number |
0
|
可选 开始打包元素的数组索引。 |
Returns:
装入的数组
static Cesium.Rectangle.simpleIntersection (rectangle, otherRectangle, result ) → Rectangle |undefined
计算两个矩形的简单交集。与
Rectangle.intersection
不同,此函数不会尝试将角坐标置于一致的范围内或考虑穿过反子午线。因此,它可以用于坐标不是简单的纬度和经度(即投影坐标)的矩形。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 在矩形上找到一个交点 |
otherRectangle
|
Rectangle | 寻找交点的另一个矩形 |
result
|
Rectangle | 可选 存储结果的对象。 |
Returns:
修改后的结果参数,如果没有提供新的 Rectangle 实例,如果没有交集,则为 undefined。
static Cesium.Rectangle.southeast (rectangle, result ) → Cartographic
计算矩形的东南角。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 为其找到角的矩形 |
result
|
Cartographic | 可选 存储结果的对象。 |
Returns:
如果未提供修改的结果参数或新的制图实例。
static Cesium.Rectangle.southwest (rectangle, result ) → Cartographic
计算矩形的西南角。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 为其找到角的矩形 |
result
|
Cartographic | 可选 存储结果的对象。 |
Returns:
如果未提供修改的结果参数或新的制图实例。
static Cesium.Rectangle.subsample (rectangle, ellipsoid , surfaceHeight , result ) → Array.< Cartesian3 >
对矩形进行采样,使其包含适合传递给
BoundingSphere#fromPoints
的笛卡尔点列表。抽样是必要的,以考虑覆盖两极或穿过赤道的矩形。
Name | Type | Default | Description |
---|---|---|---|
rectangle
|
Rectangle | 要进行二次采样的矩形。 | |
ellipsoid
|
Ellipsoid |
Ellipsoid.WGS84
|
可选 要使用的椭球体。 |
surfaceHeight
|
Number |
0.0
|
可选 椭圆体上方矩形的高度。 |
result
|
Array.< Cartesian3 > | 可选 存储结果的笛卡尔数组。 |
Returns:
如果未提供修改的结果参数或新的笛卡尔实例数组。
static Cesium.Rectangle.subsection (rectangle, westLerp, southLerp, eastLerp, northLerp, result ) → Rectangle
根据 [0.0, 1.0] 范围内的归一化坐标计算矩形的子部分。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 要分段的矩形。 |
westLerp
|
Number | [0.0, 1.0] 范围内的西插值因子。必须小于或等于eastLerp。 |
southLerp
|
Number | [0.0, 1.0] 范围内的南插值因子。必须小于或等于northLerp。 |
eastLerp
|
Number | [0.0, 1.0] 范围内的东插值因子。必须大于或等于 westLerp。 |
northLerp
|
Number | [0.0, 1.0] 范围内的北插值因子。必须大于或等于 southLerp。 |
result
|
Rectangle | 可选 存储结果的对象。 |
Returns:
如果未提供修改的结果参数或新的 Rectangle 实例。
static Cesium.Rectangle.union (rectangle, otherRectangle, result ) → Rectangle
计算一个矩形,它是两个矩形的并集。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 包围在矩形中的矩形。 |
otherRectangle
|
Rectangle | 包围在矩形中的矩形。 |
result
|
Rectangle | 可选 存储结果的对象。 |
Returns:
如果未提供修改的结果参数或新的 Rectangle 实例。
static Cesium.Rectangle.unpack (array, startingIndex , result ) → Rectangle
从打包数组中检索实例。
Name | Type | Default | Description |
---|---|---|---|
array
|
Array.<Number> | 打包的数组。 | |
startingIndex
|
Number |
0
|
可选 要解包的元素的起始索引。 |
result
|
Rectangle | 可选 存储结果的对象。 |
Returns:
修改后的结果参数或新的 Rectangle 实例(如果未提供)。
检查 Rectangle 的属性,如果它们不在有效范围内则抛出。
Name | Type | Description |
---|---|---|
rectangle
|
Rectangle | 要验证的矩形 |
Throws:
clone ( result ) → Rectangle
复制此矩形。
Name | Type | Description |
---|---|---|
result
|
Rectangle | 可选 存储结果的对象。 |
Returns:
如果未提供修改的结果参数或新的 Rectangle 实例。
将提供的 Rectangle 与此 Rectangle 组件进行比较,如果它们相等则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
other
|
Rectangle | 可选 要比较的矩形。 |
Returns:
如果矩形相等,则为
true
,否则为
false
。
将提供的 Rectangle 与此 Rectangle 组件进行比较,如果它们在提供的 epsilon 内,则返回
true
,否则返回
false
。
Name | Type | Default | Description |
---|---|---|---|
other
|
Rectangle | 可选 要比较的矩形。 | |
epsilon
|
Number |
0
|
可选 用于相等性测试的 epsilon。 |
Returns:
如果矩形在提供的 epsilon 内,则为
true
,否则为
false
。