Rectangle

Members

staticconstantSuperMap3D.Rectangle.MAX_VALUE : Rectangle

最大的矩形。

staticSuperMap3D.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

staticSuperMap3D.Rectangle.center(rectangle, result) → Cartographic

计算矩形的中心。

Name	Type	Description
rectangle	Rectangle	为其找到中心的矩形。
result	Cartographic	optional 存储结果的对象。

Returns:

如果未提供修改的结果参数或新的制图实例。

staticSuperMap3D.Rectangle.clone(rectangle, result) → Rectangle

复制一个矩形。

Name	Type	Description
rectangle	Rectangle	要克隆的矩形。
result	Rectangle	optional 存储结果的对象，如果应该创建一个新实例，则为 undefined。

Returns:

如果未提供修改的结果参数或新的 Rectangle 实例。 （如果矩形未定义，则返回未定义）

staticSuperMap3D.Rectangle.computeHeight(rectangle) → Number

以弧度计算矩形的高度。

Name	Type	Description
rectangle	Rectangle	计算高度的矩形。

Returns:

高度。

staticSuperMap3D.Rectangle.computeWidth(rectangle) → Number

以弧度计算矩形的宽度。

Name	Type	Description
rectangle	Rectangle	要计算其宽度的矩形。

Returns:

宽度。

staticSuperMap3D.Rectangle.contains(rectangle, cartographic) → Boolean

如果地图在矩形上或矩形内，则返回 true，否则返回 false。

Name	Type	Description
rectangle	Rectangle	矩形。
cartographic	Cartographic	要测试的地图。

Returns:

如果提供的地图在矩形内，则为True，否则为false。

staticSuperMap3D.Rectangle.equals(left, right) → Boolean

比较提供的矩形，如果相等则返回 true ，否则返回 false 。

Name	Type	Description
left	Rectangle	optional 第一个矩形。
right	Rectangle	optional 第二个矩形。

Returns:

如果相等，则为 true ；否则 false 。

staticSuperMap3D.Rectangle.equalsEpsilon(left, right, absoluteEpsilon) → Boolean

比较提供的矩形组件，如果它们通过绝对或相对容差测试，则返回 true ，否则返回 false 。

Name	Type	Description
left	Rectangle	optional 第一个矩形。
right	Rectangle	optional 第二个矩形。
absoluteEpsilon	Number	用于相等测试的绝对 epsilon 容差。

Returns:

在提供的 epsilon 内，则为 true，否则为 false 。

staticSuperMap3D.Rectangle.expand(rectangle, cartographic, result) → Rectangle

通过放大所提供的矩形，直到其中包含所提供的绘图，计算矩形。

Name	Type	Description
rectangle	Rectangle	要扩展的矩形。
cartographic	Cartographic	包含在矩形中的地图。
result	Rectangle	optional 存储结果的对象。

Returns:

修改后的结果参数或新的矩形实例（如果未提供）。

staticSuperMap3D.Rectangle.fromCartesianArray(cartesians, ellipsoid, result) → Rectangle

创建包含所提供数组中所有位置的尽可能小的矩形。

Name	Type	Default	Description
cartesians	Array.<Cartesian3>		笛卡尔实例列表。
ellipsoid	Ellipsoid	Ellipsoid.WGS84	optional 笛卡尔所在的椭球体。
result	Rectangle		optional 存储结果的对象，如果应该创建一个新实例，则为 undefined。

Returns:

如果未提供修改的结果参数或新的 Rectangle 实例。

staticSuperMap3D.Rectangle.fromCartographicArray(cartographics, result) → Rectangle

创建包含所提供数组中所有位置的尽可能小的矩形。

Name	Type	Description
cartographics	Array.<Cartographic>	地图的实例列表。
result	Rectangle	optional 存储结果的对象，如果应该创建一个新实例，则为 undefined。

Returns:

如果未提供修改的结果参数或新的 Rectangle 实例。

staticSuperMap3D.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 存储结果的对象，如果应该创建一个新实例，则为 undefined。

Returns:

如果未提供修改的结果参数或新的 Rectangle 实例。

Example:

var rectangle = Rectangle.fromDegrees(0.0, 20.0, 10.0, 30.0);

staticSuperMap3D.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 存储结果的对象，如果应该创建一个新实例，则为 undefined。

Returns:

如果未提供修改的结果参数或新的 Rectangle 实例。

Example:

var rectangle = Rectangle.fromRadians(0.0, Math.PI/4, Math.PI/8, 3*Math.PI/4);

staticSuperMap3D.Rectangle.intersection(rectangle, otherRectangle, result) → Rectangle|undefined

计算两个矩形的交点。这个函数假设矩形的坐标为经纬度以弧度表示，并产生一个正确的交点，考虑到这一事实 相同的角度可以用多个值表示，也可以在位置上包裹经度anti-meridian。对于一个简单的交叉点，忽略这些因素，可以使用投影坐标，请参考Rectangle.simpleIntersection.

Name	Type	Description
rectangle	Rectangle	求一个矩形的交点。
otherRectangle	Rectangle	求另一个矩形的交点。
result	Rectangle	optional 存储结果的对象。

Returns:

修改后的结果参数，如果没有提供新的矩形实例，如果没有交集，则为 undefined。

staticSuperMap3D.Rectangle.northeast(rectangle, result) → Cartographic

计算矩形的东北角。

Name	Type	Description
rectangle	Rectangle	需要找到角的矩形。
result	Cartographic	optional 存储结果的对象。

Returns:

如果未提供修改的结果参数或新的地图实例。

staticSuperMap3D.Rectangle.northwest(rectangle, result) → Cartographic

计算矩形的西北角。

Name	Type	Description
rectangle	Rectangle	需要找到角的矩形。
result	Cartographic	optional 存储结果的对象。

Returns:

修改后的结果参数，如果没有提供则使用新的地图实例。

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

将提供的实例存储到提供的数组中。

Name	Type	Default	Description
value	Rectangle		要打包的值。
array	Array.<Number>		要打包的数组。
startingIndex	Number	0	optional 开始打包元素的数组索引。

Returns:

装入的数组。

staticSuperMap3D.Rectangle.simpleIntersection(rectangle, otherRectangle, result) → Rectangle|undefined

计算两个矩形的交点。这个函数假设矩形的坐标为经纬度以弧度表示，并产生一个正确的交点，考虑到这一事实相同的角度可以用多个值表示，也可以在位置上包裹经度 anti-meridian。对于一个简单的交叉点，忽略这些因素，可以使用投影坐标，参考Rectangle.intersection

Name	Type	Description
rectangle	Rectangle	求一个矩形的交点。
otherRectangle	Rectangle	求另一个矩形的交点。
result	Rectangle	optional 存储结果的对象。

Returns:

修改后的结果参数，如果没有提供新的矩形实例，如果没有交集，则为 undefined。

staticSuperMap3D.Rectangle.northeast(rectangle, result) → Cartographic

计算矩形的东北角。

staticSuperMap3D.Rectangle.southeast(rectangle, result) → Cartographic

计算矩形的东南角。

Name	Type	Description
rectangle	Rectangle	需要找到角的矩形。
result	Cartographic	optional 存储结果的对象。

Returns:

如果未提供修改的结果参数或新的地图实例。

staticSuperMap3D.Rectangle.southwest(rectangle, result) → Cartographic

计算矩形的西南角。

Name	Type	Description
rectangle	Rectangle	需要找到角的矩形。
result	Cartographic	optional 存储结果的对象。

Returns:

修改后的结果参数，如果没有提供则使用新的地图实例。

staticSuperMap3D.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:

修改后的结果参数，如果没有提供则使用新的地图实例。

staticSuperMap3D.Rectangle.union(rectangle, otherRectangle, result) → Rectangle

根据 [0.0, 1.0] 范围内的归一化坐标计算矩形的子部分。

Name	Type	Description
rectangle	Rectangle	包围在矩形中的矩形。
otherRectangle	Rectangle	包围在矩形中的矩形。
result	Rectangle	optional 存储结果的对象。

Returns:

修改后的结果参数，如果没有提供则使用新的地图实例。

staticSuperMap3D.Rectangle.unpack(array, startingIndex, result) → Rectangle

从打包数组中检索实例。

Name	Type	Default	Description
array	Array.<Number>		打包的数组。
startingIndex	Number	0	optional 要解包的元素的起始索引。
result	Rectangle		optional 存储结果的对象。

Returns:

修改后的结果参数，如果没有提供则使用新的矩形实例。

staticSuperMap3D.Rectangle.validate(rectangle)

检查矩形的属性，如果它们不在有效范围内则抛出。

Name	Type	Description
rectangle	Rectangle	要验证的矩形。

Throws:

• DeveloperError : 北必须在区间 [ -Pi/2 , Pi/2 ] 中。
• DeveloperError : 南必须在区间 [ -Pi/2 , Pi/2 ] 中。
• DeveloperError : 东必须在区间 [ -Pi , Pi ] 中。
• DeveloperError : 西必须在区间 [ -Pi , Pi ] 中。

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

将提供的 Rectangle 与此 Rectangle 组件进行比较，如果它们在提供的 epsilon 内，则返回 true ，否则返回 false 。

Name	Type	Description
other	Rectangle	optional 要比较的矩形。
epsilon	Number	用于相等性测试的 epsilon。

Returns:

如果矩形在提供的 epsilon 内，则为 true ，否则为 false 。