Class: LinearRing

LinearRing

几何对象线环类，是一个特殊的封闭的线串，在每次addPoint/removePoint之后会通过添加一个点（此点是复制的第一个点得到的） 作为最后的一个点来自动关闭线环。

new SuperMap.Geometry.LinearRing(points)

common/commontypes/geometry/LinearRing.js, line 4
Name Type Description
points Array.<SuperMap.Geometry.Point>

组成线性环的点。
Example
var points = [new SuperMap.Geometry.Point(4933.319287022352, -3337.3849141502124),
     new SuperMap.Geometry.Point(4960.9674060199022, -3349.3316322355736),
     new SuperMap.Geometry.Point(5006.0235999418364, -3358.8890067038628),
     new SuperMap.Geometry.Point(5075.3145648369318, -3378.0037556404409),
     new SuperMap.Geometry.Point(5305.19551436013, -3376.9669111768926)],
var linearRing = new SuperMap.Geometry.LinearRing(points);

Extends

Members

boundsSuperMap.Bounds

几何对象的范围

componentsArray.<SuperMap.Geometry>

存储几何对象的数组。

readonlycomponentTypesArray.<string>

components存储的的几何对象所支持的几何类型数组,为空表示类型不受限制。

Default Value:

idstring

此几何对象的唯一标示符。

parentSuperMap.Geometry

This is set when a Geometry is added as component of another geometry

SRIDinterger

投影坐标参数。通过该参数，服务器判断Geometry对象的坐标参考系是否与数据集相同，如果不同，则在数据入库前进行投影变换。

Example
var geometry= new SuperMap.Geometry();
  geometry. SRID=4326;

Methods

addComponent(point, index){Boolean}

common/commontypes/geometry/LinearRing.js, line 32

添加一个点到几何图形数组中，如果这个点将要被添加到组件数组的末端，并且与数组中已经存在的最后一个点相同， 重复的点是不能被添加的。这将影响未关闭环的关闭。 这个方法可以通过将非空索引（组件数组的下标）作为第二个参数重写。

Name Type Description
point SuperMap.Geometry.Point

点对象。
index Integer

插入组件数组的下标。
Returns:
Type Description
Boolean 点对象是否添加成功。

inherited addComponents(components)

common/commontypes/geometry/Collection.js, line 101

给几何图形对象添加元素。

Name Type Description
components Array.<SuperMap.Geometry>

几何对象组件。
Example
var collection = new SuperMap.Geometry.Collection();
collection.addComponents(new SuerpMap.Geometry.Point(10,10));

inherited addPoint(point, index)

common/commontypes/geometry/MultiPoint.js, line 29

添加点，封装了 SuperMap.Geometry.Collection.addComponent方法。

Name Type Description
point SuperMap.Geometry.Point

添加的点。
index integer

可选的下标。

inherited calculateBounds()

common/commontypes/geometry/Collection.js, line 80

通过遍历数组重新计算边界，在遍历每一子项中时调用 extend 方法。

inherited clearBounds()

common/commontypes/Geometry.js, line 81

清除几何对象的bounds。 如果该对象有父类，也会清除父类几何对象的bounds。

inherited clone(){SuperMap.Geometry.Collection}

common/commontypes/geometry/Collection.js, line 50

克隆当前几何对象。

Returns:
Type Description
SuperMap.Geometry.Collection 克隆的几何对象集合。

inherited destroy()

common/commontypes/geometry/Collection.js, line 40

销毁几何图形。

inherited equals(geometry){Boolean}

common/commontypes/geometry/Collection.js, line 198

判断两个几何图形是否相等。如果所有的 components 具有相同的坐标，则认为是相等的。

Name Type Description
geometry SuperMap.Geometry

需要判断的几何图形。
Returns:
Type Description
Boolean 输入的几何图形与当前几何图形是否相等。

inherited extendBounds(newBounds)

common/commontypes/Geometry.js, line 94

Extend the existing bounds to include the new bounds. If geometry's bounds is not yet set, then set a new Bounds.

Name Type Description
newBounds SuperMap.Bounds

-

getArea(){float}

common/commontypes/geometry/LinearRing.js, line 81

获得当前几何对象区域大小，如果是沿顺时针方向的环则是正值，否则为负值。

Returns:
Type Description
float 环的面积。

inherited getBounds(){SuperMap.Bounds}

common/commontypes/Geometry.js, line 111

获得几何图形的边界。如果没有设置边界，可通过计算获得。

Returns:
Type Description
SuperMap.Bounds 返回的几何对象的边界。

inherited getComponentsString(){string}

common/commontypes/geometry/Collection.js, line 67

获取components字符串

Returns:
Type Description
string components字符串

inherited getSortedSegments(){Array}

common/commontypes/geometry/LineString.js, line 39
Returns:
Type Description
Array An array of segment objects. Segment objects have properties x1, y1, x2, and y2. The start point is represented by x1 and y1. The end point is represented by x2 and y2. Start and end are ordered so that x1 < x2.

getVertices(nodes){Array}

common/commontypes/geometry/LinearRing.js, line 100

返回几何图形的所有点的列表。

Name Type Description
nodes Boolean

对于线来说，仅仅返回作为端点的顶点，如果设为false，则返回非端点的顶点 如果没有设置此参数，则返回所有顶点。
Returns:
Type Description
Array 几何对象所有点的列表。

removeComponent(point){Boolean}

common/commontypes/geometry/LinearRing.js, line 60

从几何组件中删除一个点。

Name Type Description
point SuperMap.Geometry.Point

点对象。
Returns:
Type Description
Boolean 点对象是否删除。

inherited removeComponents(components){Boolean}

common/commontypes/geometry/Collection.js, line 151

清除几何对象。

Name Type Description
components Array.<SuperMap.Geometry>

需要清除的几何对象。
Returns:
Type Description
Boolean 元素是否被删除。

inherited removePoint(point)

common/commontypes/geometry/MultiPoint.js, line 40

移除点,封装了 SuperMap.Geometry.Collection.removeComponent 方法。

Name Type Description
point SuperMap.Geometry.Point

移除的点对象。

inherited setBounds(bounds)

common/commontypes/Geometry.js, line 69

设置此几何对象的bounds。

Name Type Description
bounds SuperMap.Bounds

-

inherited toString(){string}

common/commontypes/Geometry.js, line 155

返回geometry对象的字符串表述，需要引入SuperMap.Format.WKT。此方法只能在子类实现，在父类使用会报错。

Returns:
Type Description
string geometry对象的字符串表述(Well-Known Text)