Rectangle

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

指定经度和纬度坐标的二维区域。
Name Type Default Description
west Number 0.0 optional 最西端的经度,以弧度为单位,在[-Pi, Pi]范围内。
south Number 0.0 optional 最南端的纬度,以弧度为单位,在[-Pi/2, Pi/2]范围内。
east Number 0.0 optional 最东端的经度,以弧度为单位,在[-Pi, Pi]范围内。
north Number 0.0 optional 最北端的纬度,以弧度为单位,在[-Pi/2, Pi/2]范围内。
See:

Members

staticconstantCesium.Rectangle.MAX_VALUE : Rectangle

可能的最大矩形。

staticCesium.Rectangle.packedLength : Number

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

east : Number

最东端的经度,以弧度为单位,在[-Pi, Pi]范围内。
Default Value: 0.0

height : Number

获取矩形的高度(以弧度为单位)。

north : Number

最北端的纬度,以弧度为单位,在[-Pi/2, Pi/2]范围内。
Default Value: 0.0

south : Number

最南端的纬度,以弧度为单位,在[-Pi/2, Pi/2]范围内。
Default Value: 0.0

west : Number

最西端的经度,以弧度为单位,在[-Pi, Pi]范围内。
Default Value: 0.0

width : Number

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

Methods

staticCesium.Rectangle.center(rectangle, result)Cartographic

计算矩形的中心。
Name Type Description
rectangle Rectangle 要找到中心的矩形。
result Cartographic optional 存储结果的对象。
Returns:
修改后的结果参数或新的Cartographic实例(如果没有提供)。

staticCesium.Rectangle.clone(rectangle, result)Rectangle

复制一个矩形。
Name Type Description
rectangle Rectangle 要克隆的矩形。
result Rectangle optional 存储结果的对象,如果要创建新实例,则为未定义对象。
Returns:
修改后的结果参数或新矩形实例(如果没有提供)。(如果矩形未定义,则返回undefined。)

staticCesium.Rectangle.computeHeight(rectangle)Number

计算矩形的高度(以弧度为单位)。
Name Type Description
rectangle Rectangle 要计算高度的矩形。
Returns:
高度。

staticCesium.Rectangle.computeWidth(rectangle)Number

计算矩形的宽度(以弧度为单位)。
Name Type Description
rectangle Rectangle 要计算宽度的矩形。
Returns:
宽度。

staticCesium.Rectangle.contains(rectangle, cartographic)Boolean

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

staticCesium.Rectangle.equals(left, right)Boolean

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

staticCesium.Rectangle.equalsEpsilon(left, right, absoluteEpsilon)Boolean

比较提供的矩形分量,如果通过了绝对或相对公差测试,则返回true,否则返回false
Name Type Description
left Rectangle optional 第一个矩形。
right Rectangle optional 第二个矩形。
absoluteEpsilon Number 用于等式检验的绝对epsilon公差。
Returns:
如果两个矩形都在给定的范围内,则为true ;否则,false

staticCesium.Rectangle.expand(rectangle, cartographic, result)Rectangle

通过放大所提供的矩形直到它包含所提供的cartographic来计算矩形。
Name Type Description
rectangle Rectangle 要扩大的矩形。
cartographic Cartographic 要用矩形包围的cartographic。
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数或新矩形实例(如果没有提供)。

staticCesium.Rectangle.fromCartesianArray(cartesians, ellipsoid, result)Rectangle

创建包含所提供的数组中所有位置的尽可能小的矩形。
Name Type Default Description
cartesians Array.<Cartesian3> 笛卡尔实例的列表。
ellipsoid Ellipsoid Ellipsoid.WGS84 optional 椭球上的笛卡尔坐标。
result Rectangle optional 存储结果的对象,如果要创建新实例,则为未定义对象。
Returns:
修改后的结果参数或新矩形实例(如果没有提供)。

staticCesium.Rectangle.fromCartographicArray(cartographics, result)Rectangle

创建包含所提供的数组中所有位置的尽可能小的矩形。
Name Type Description
cartographics Array.<Cartographic> Cartographic实例的列表。
result Rectangle optional 存储结果的对象,如果要创建新实例,则为未定义对象。
Returns:
修改后的结果参数或新矩形实例(如果没有提供)。

staticCesium.Rectangle.fromDegrees(west, south, east, north, result)Rectangle

创建给定边界经度和纬度的矩形(以角度表示)。
Name Type Default Description
west Number 0.0 optional 在[-180.0, 180.0]范围内以角度表示的最西侧经度。
south Number 0.0 optional 在[-90.0, 90.0]范围内以角度表示的最南侧经度。
east Number 0.0 optional 在[-180.0, 180.0]范围内以角度表示的最东侧经度。
north Number 0.0 optional 在[-90.0, 90.0]范围内以角度表示的最北侧经度。
result Rectangle optional 存储结果的对象,如果要创建新实例,则为未定义对象。
Returns:
修改后的结果参数或新矩形实例(如果没有提供)。
Example:
var rectangle = Cesium.Rectangle.fromRadians(0.0, Math.PI/4, Math.PI/8, 3*Math.PI/4);

staticCesium.Rectangle.fromRadians(west, south, east, north, result)Rectangle

创建给定边界经度和纬度的矩形(以弧度表示)。
Name Type Default Description
west Number 0.0 optional 在[-Math.PI, Math.PI]范围内以弧度表示的最西侧经度。
south Number 0.0 optional 在[-Math.PI/2, Math.PI/2]范围内以弧度表示的最南侧经度。
east Number 0.0 optional 在[-Math.PI, Math.PI]范围内以弧度表示的最东侧经度。
north Number 0.0 optional 在[-Math.PI/2, Math.PI/2]范围内以弧度表示的最北侧经度。
result Rectangle optional 存储结果的对象,如果要创建新实例,则为未定义对象。
Returns:
修改后的结果参数或新矩形实例(如果没有提供)。
Example:
var rectangle = Cesium.Rectangle.fromRadians(0.0, Math.PI/4, Math.PI/8, 3*Math.PI/4);

staticCesium.Rectangle.intersection(rectangle, otherRectangle, result)Rectangle|undefined

计算两个矩形的交集。这个函数假设矩形的坐标是以弧度表示的经纬度,并生成一个正确的交集, 同时考虑到相同的角度可以用多个值表示,以及经度在反面子午线(anti-meridian)处的缠绕(wrapping)。 对于忽略这些因素并可与投影坐标一起使用的简单交集,请参见Rectangle.simpleIntersection
Name Type Description
rectangle Rectangle 在矩形上找到一个交集
otherRectangle Rectangle 求交集的另一个矩形。
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数或新的矩形实例(如果没有提供),或如果没有交集,则为undefined。

staticCesium.Rectangle.northeast(rectangle, result)Cartographic

计算矩形的东北角。
Name Type Description
rectangle Rectangle 要找到角的矩形
result Cartographic optional 存储结果的对象。
Returns:
修改后的结果参数或新的Cartographic实例(如果没有提供)。

staticCesium.Rectangle.northwest(rectangle, result)Cartographic

计算矩形的西北角。
Name Type Description
rectangle Rectangle 要找到角的矩形
result Cartographic optional 存储结果的对象。
Returns:
修改后的结果参数或新的Cartographic实例(如果没有提供)。

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

将提供的实例存储到提供的数组中。
Name Type Default Description
value Rectangle 要包装的值。
array Array.<Number> 要被包装到的数组。
startingIndex Number 0 optional 开始包装元素的数组索引。
Returns:
被包装到的数组。

staticCesium.Rectangle.simpleIntersection(rectangle, otherRectangle, result)Rectangle|undefined

计算两个矩形的简单交集。 与Rectangle.intersection不同,此函数不尝试将角坐标放入一致的范围,也不考虑跨越反面子午线(anti-meridian)。 因此,它可以用于坐标不是简单的经纬度(即投影坐标)的矩形。
Name Type Description
rectangle Rectangle 在矩形上找到一个交集
otherRectangle Rectangle 求交集的另一个矩形。
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数或新的矩形实例(如果没有提供),或如果没有交集,则为undefined。

staticCesium.Rectangle.southeast(rectangle, result)Cartographic

计算矩形的东南角。
Name Type Description
rectangle Rectangle 要找到角的矩形
result Cartographic optional 存储结果的对象。
Returns:
修改后的结果参数或新的Cartographic实例(如果没有提供)。

staticCesium.Rectangle.southwest(rectangle, result)Cartographic

计算矩形的西南角。
Name Type Description
rectangle Rectangle 要找到角的矩形
result Cartographic optional 存储结果的对象。
Returns:
修改后的结果参数或新的Cartographic实例(如果没有提供)。

staticCesium.Rectangle.subsample(rectangle, ellipsoid, surfaceHeight, result)Array.<Cartesian3>

对一个矩形进行采样,使它包含一个适合传递给BoundingSphere#fromPoints的笛卡尔坐标点列表。 采样是必要的,以考虑矩形覆盖两极或跨越赤道。
Name Type Default Description
rectangle Rectangle 要采样的矩形。
ellipsoid Ellipsoid Ellipsoid.WGS84 optional 使用的椭球。
surfaceHeight Number 0.0 optional 矩形在椭球上的高度。
result Array.<Cartesian3> optional 用于存储结果的笛卡儿数组。
Returns:
修改后的结果参数新的笛卡尔实例数组(如果没有提供)。

staticCesium.Rectangle.union(rectangle, otherRectangle, result)Rectangle

计算由两个矩形合并而成的矩形。
Name Type Description
rectangle Rectangle 用矩形包围的矩形。
otherRectangle Rectangle 用矩形包围的矩形。
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数或新矩形实例(如果没有提供)。

staticCesium.Rectangle.unpack(array, startingIndex, result)Rectangle

从已包装的数组中检索实例。
Name Type Default Description
array Array.<Number> 包装的数组。
startingIndex Number 0 optional 要解包的元素的起始索引。
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数或新的Rectangle实例(如果没有提供)。

staticCesium.Rectangle.validate(rectangle)

检查矩形的属性,如果它们不在有效范围内,则抛出异常。
Name Type Description
rectangle Rectangle 要验证的矩形。
Throws:

clone(result)Rectangle

复制这个矩形。
Name Type Description
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数或新矩形实例(如果没有提供)。

equals(other)Boolean

将提供的矩形与此矩形分量进行比较,如果相等,则返回true,否则返回false
Name Type Description
other Rectangle optional 要比较的矩形。
Returns:
如果两个矩形相等,则为true; 否则,false

equalsEpsilon(other, epsilon)Boolean

将提供的矩形与此矩形分量进行比较,如果在提供的epsilon范围内,则返回true,否则返回false
Name Type Description
other Rectangle optional 要比较的矩形。
epsilon Number 用于等式检验的epsilon。
Returns:
如果矩形在规定的epsilon范围内,则为true;否则,false