Rectangle - SuperMap3D Documentation

new SuperMap3D.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:

Packable

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 存储结果的对象，如果需要创建新实例，则未定义。

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.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.<Cartesian>		地图投影实例的列表。
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 直角坐标系所在的椭球体。
`result`	Rectangle		optional 存储结果的对象，如果需要创建新实例，则未定义。

Returns:

修改后的结果参数，或者一个新的矩形实例（如果没有提供）。

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

创建包围所提供数组中所有位置的最小矩形。

Name	Type	Description
`cartographics`	Array.<Cartographic>	地图投影实例的列表。
`result`	Rectangle	optional 存储结果的对象，如果需要创建新实例，则未定义。

Returns:

修改后的结果参数，或者一个新的矩形实例（如果没有提供）。

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 要在其上存储结果的对象，如果要创建新实例，则未定义。

Returns:

如果没有提供，则为修改后的结果参数或一个新的Rectangle实例。

Example:

var rectangle = SuperMap3D.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]。
`south`	Number	`0.0`	optional 范围内以弧度为单位的最南端纬度[-数学]。π/ 2,Math.PI / 2)。
`east`	Number	`0.0`	optional 范围内以弧度为单位的最东经[-数学]。π,Math.PI]。
`north`	Number	`0.0`	optional 范围内以弧度为单位的最北纬[-数学]。π/ 2,Math.PI / 2)。
`result`	Rectangle		optional 存储结果的对象，如果需要创建新实例，则未定义。

Returns:

修改后的结果参数，或者一个新的矩形实例（如果没有提供）。

Example:

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

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

计算两个矩形的交点。此函数假定矩形的坐标是以弧度为单位的经度和纬度，并考虑到同一角度可以用多个值表示以及反经线处的经度包络等因素，生成正确的交点。关于忽略这些因素并可用于投影坐标的简单相交，请参见 Rectangle.simpleIntersection。

Name	Type	Description
`rectangle`	Rectangle	在矩形上查找交点。
`otherRectangle`	Rectangle	另一个矩形的交点
`result`	Rectangle	optional 存储结果的对象。

Returns:

修改后的结果参数，如果没有提供，则是一个新的矩形实例；如果没有交集，则未定义。

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

计算两个矩形的简单交集。与 Rectangle.intersection 不同的是，此函数并不试图将角度坐标置于一致的范围内，也不考虑穿越反经线的情况。因此，它可以用于坐标不是简单经纬度（即投影坐标）的矩形。

Name	Type	Description
`rectangle`	Rectangle	在矩形上查找交点
`otherRectangle`	Rectangle	另一个矩形的交点
`result`	Rectangle	optional 存储结果的对象。

Returns:

修改后的结果参数，如果没有提供，则是一个新的矩形实例；如果没有交集，则未定义。

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的Cartesian点列表。以解释覆盖两极或跨越赤道的矩形。

Name	Type	Default	Description
`rectangle`	Rectangle		子样本的矩形区域。
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 要使用的椭球体。
`surfaceHeight`	Number	`0.0`	optional 矩形在椭圆体上方的高度。
`result`	Array.<Cartesian3>		optional 用于存储结果的Cartesians数组。

Returns:

修改后的结果参数，或者一个新的Cartesians实例数组（如果没有提供）。

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

计算由两个矩形合并而成的矩形。

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

Returns:

如果没有提供，则为修改后的结果参数或一个新的Rectangle实例。

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

将提供的矩形与此矩形进行比较，如果它们在提供的epsilon范围内，则返回true，否则返回false。

Name	Type	Description
`other`	Rectangle	optional 要比较的矩形。
`epsilon`	Number	用于等式测试的容差值。

Returns:

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