Rectangle

new Cesium.Rectangle ( west , south , east , north )

指定为经度和纬度坐标的二维区域。
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

可能的最大矩形。

static Cesium.Rectangle.packedLength : Number

用于将对象打包到数组中的元素数。
[-Pi, Pi] 范围内以弧度表示的最东经度。
Default Value: 0.0

readonly height : Number

以弧度为单位获取矩形的高度。
[-Pi/2, Pi/2] 范围内以弧度表示的最北纬度。
Default Value: 0.0
[-Pi/2, Pi/2] 范围内的最南端纬度(以弧度表示)。
Default Value: 0.0
[-Pi, Pi] 范围内以弧度表示的最西经度。
Default Value: 0.0

readonly width : Number

以弧度为单位获取矩形的宽度。

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 实例。 (如果矩形未定义,则返回未定义)

static Cesium.Rectangle.computeHeight (rectangle) Number

以弧度计算矩形的高度。
Name Type Description
rectangle Rectangle 计算高度的矩形。
Returns:
高度。

static Cesium.Rectangle.computeWidth (rectangle) Number

以弧度计算矩形的宽度。
Name Type Description
rectangle Rectangle 要计算其宽度的矩形。
Returns:
宽度。

static Cesium.Rectangle.contains (rectangle, cartographic) Boolean

如果制图在矩形上或矩形内,则返回 true,否则返回 false。
Name Type Description
rectangle Rectangle 矩形
cartographic Cartographic 要测试的制图。
Returns:
如果提供的制图在矩形内,则为 true,否则为 false。

static Cesium.Rectangle.equals ( left , right ) Boolean

比较提供的矩形,如果相等则返回 true ,否则返回 false
Name Type Description
left Rectangle 可选 第一个矩形。
right Rectangle 可选 第二个矩形。
Returns:
如果左右相等,则为 true ;否则 false

static Cesium.Rectangle.equalsEpsilon ( left , right , absoluteEpsilon ) Boolean

比较提供的 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:
如果未提供修改的结果参数或新的制图实例。

static Cesium.Rectangle.pack (value, array, startingIndex ) Array.<Number>

将提供的实例存储到提供的数组中。
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 实例(如果未提供)。

static Cesium.Rectangle.validate (rectangle)

检查 Rectangle 的属性,如果它们不在有效范围内则抛出。
Name Type Description
rectangle Rectangle 要验证的矩形
Throws:
复制此矩形。
Name Type Description
result Rectangle 可选 存储结果的对象。
Returns:
如果未提供修改的结果参数或新的 Rectangle 实例。

equals ( other ) Boolean

将提供的 Rectangle 与此 Rectangle 组件进行比较,如果它们相等则返回 true ,否则返回 false
Name Type Description
other Rectangle 可选 要比较的矩形。
Returns:
如果矩形相等,则为 true ,否则为 false

equalsEpsilon ( other , epsilon ) Boolean

将提供的 Rectangle 与此 Rectangle 组件进行比较,如果它们在提供的 epsilon 内,则返回 true ,否则返回 false
Name Type Default Description
other Rectangle 可选 要比较的矩形。
epsilon Number 0 可选 用于相等性测试的 epsilon。
Returns:
如果矩形在提供的 epsilon 内,则为 true ,否则为 false