Class: LinearRing

SuperMap.Geometry.LinearRing

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

new SuperMap.Geometry.LinearRing(points)

common/commontypes/geometry/LinearRing.js, line 7
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>

存储几何对象的数组。

componentTypeArray.<string>

components 存储的的几何对象所支持的几何类型数组。

Default Value:
["SuperMap.Geometry.Point", "SuperMap.PointWithMeasure"]

componentTypesArray.<string>

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

Default Value:
["SuperMap.Geometry.Point"]

idstring

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

parentSuperMap.Geometry

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

SRIDnumber

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

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

Methods

addComponent(point, index){boolean}

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

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

Name Type Description
point SuperMap.Geometry.Point

点对象。
index number 可选

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

inherited addComponents(components)

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

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

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 33

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

Name Type Description
point SuperMap.Geometry.Point

添加的点。
index number 可选

下标。

inherited calculateBounds()

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

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

inherited clearBounds()

common/commontypes/Geometry.js, line 85

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

inherited clone(){SuperMap.Geometry.Collection}

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

克隆当前几何对象。

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

inherited destroy()

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

销毁几何图形。

inherited equals(geometry){boolean}

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

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

Name Type Description
geometry SuperMap.Geometry

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

inherited extendBounds(newBounds)

common/commontypes/Geometry.js, line 98

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(){number}

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

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

Returns:
Type Description
number 环的面积。

inherited getBounds(){SuperMap.Bounds}

common/commontypes/Geometry.js, line 115

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

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

inherited getComponentsString(){string}

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

获取 components 字符串。

Returns:
Type Description
string components 字符串。

inherited getSortedSegments(){Array}

common/commontypes/geometry/LineString.js, line 44
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 105

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

Name Type Description
nodes boolean 可选

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

removeComponent(point){boolean}

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

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

Name Type Description
point SuperMap.Geometry.Point

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

inherited removeComponents(components){boolean}

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

清除几何对象。

Name Type Description
components Array.<SuperMap.Geometry>

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

inherited removePoint(point)

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

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

Name Type Description
point SuperMap.Geometry.Point

移除的点对象。

inherited setBounds(bounds)

common/commontypes/Geometry.js, line 73

设置此几何对象的 bounds。

Name Type Description
bounds SuperMap.Bounds

范围。