GeoLine类参考

线几何对象类，派生于 <Geometry> 类。 更多...

继承自Geometry。

所有成员的列表。

公有成员
(id)	- initWithGeoLine:
	用指定的 GeoLine 对象构造一个与其完全相同的新对象。
(id)	- initWithPoint2Ds:
	根据指定的参数来构造一个 GeoLine 的新对象。
(BOOL)	- isEmpty
	获取或设置线几何对象是否为空，即其子对象个数是否为零。
(GeoLine *)	- clone
	返回当前 GeoLine 对象的一个拷贝。
(void)	- dispose
	释放该对象所占用的资源。调用该方法之后，此对象不再可用。
(double)	- getLength
	返回线几何对象的长度，其值为各个子对象长度之和。
(int)	- getPartCount
	返回线几何对象的子对象个数。
(int)	- addPart:
	向此线几何对象追加一个子对象。
(BOOL)	- removePart:
	删除此线几何对象中的指定序号的子对象。
(Point2D *)	- findPointOnLineByDistance:
	在线上以指定的距离找点，查找的起始点为线的起始点。 1.
(Point2Ds *)	- getPart:
	返回此线几何对象中指定序号的子对象，以有序点集合的方式返回该子对象。
(BOOL)	- insertPart:Points:
	往此线几何对象中的指定位置插入一个子对象。
(BOOL)	- setPart:Point2Ds:
	修改此线几何对象指定序号的子对象，即用新的有序点集合来替换原子对象的有序点集合。
(void)	- rotate:Angle:
	旋转几何对象。
(NSString *)	- toJson
	将线几何对象转换成Json串。
(BOOL)	- fromJson:
	将Json串转换成线几何对象。

---

详细描述

线几何对象类，派生于 <Geometry> 类。

该类用于描述线状地理实体，如河流，道路，等值线等，一般用一个或多个有序坐标点集合来表示。线的方向决定于有序坐标点的顺序，也可以通过调用 reverse 方法来改变线的方向。线对象由一个或多个部分组成，每个部分称为线对象的一个子对象，每个子对象用一个有序坐标点集合来表示。可以对子对象进行添加，删除，修改等操作。

---

成员函数文档

- (int) addPart:

(Point2Ds *)

points

向此线几何对象追加一个子对象。

参数:

points

一个有序点集合。

返回:

成功返回添加的子对象的序号。

异常:

IllegalArgumentException

如果 points 中的点的个数小于2。

- (GeoLine *) clone

返回当前 GeoLine 对象的一个拷贝。

返回:

通过克隆操作得到的 GeoLine 对象。

实现了Geometry。

- (void) dispose

释放该对象所占用的资源。调用该方法之后，此对象不再可用。

实现了Geometry。

- (Point2D *) findPointOnLineByDistance:

(double)

distance

在线上以指定的距离找点，查找的起始点为线的起始点。 1.

当 distance 大于 Length 时，返回线最后一个子对象的终点。 2. 当 distance=0 时，返回线几何对象的起始点； 3. 当线几何对象具有多个子对象的时候，按照子对象的序号依次查找。

参数:

distance

要找点的距离

返回:

查找成功返回要找的点，否则返回 null。

异常:

IllegalArgumentException

如果传入的距离为负值。

- (BOOL) fromJson:

(id)

JSONData

将Json串转换成线几何对象。

参数:

JSONData

id类型的Json串。

返回:

一个布尔值，转换成功返回true,否则返回false。

实现了Geometry。

- (double) getLength

返回线几何对象的长度，其值为各个子对象长度之和。

返回:

线几何对象的长度。

- (Point2Ds *) getPart:

(int)

index

返回此线几何对象中指定序号的子对象，以有序点集合的方式返回该子对象。

参数:

index

子对象的序号。

返回:

成功返回 <Point2Ds> 对象，失败返回空值。

- (int) getPartCount

返回线几何对象的子对象个数。

线几何对象清空后，其子对象的个数为0。

返回:

该线几何对象的子对象个数。

- (id) initWithGeoLine:

(GeoLine *)

geoLine

用指定的 GeoLine 对象构造一个与其完全相同的新对象。

参数:

geoLine

指定的GeoLine 对象。

异常:

ObjectDisposedException

如果作为拷贝源的线对象已调用dispose方法。

- (id) initWithPoint2Ds:

(Point2Ds *)

points

根据指定的参数来构造一个 GeoLine 的新对象。

参数:

points

构成线的有序点集合。

异常:

IllegalArgumentException

如果 points 中的点的总数小于2。

- (BOOL) insertPart:		(int)	index
Points:		(Point2Ds *)	points

往此线几何对象中的指定位置插入一个子对象。

参数:

	index	插入的位置。
	points	插入的有序点集合。

返回:

成功则返回 true，否则返回 false。

异常:

	IndexOutOfBoundsException	如果 index 大于该线几何对象的子对象总数或 index 为负。
	IllegalArgumentException	如果 points 中的点的总数小于2。

- (BOOL) isEmpty

获取或设置线几何对象是否为空，即其子对象个数是否为零。

返回:

如果线几何对象为空则返回 true，否则返回 false。

实现了Geometry。

- (BOOL) removePart:

(int)

index

删除此线几何对象中的指定序号的子对象。

参数:

index

指定的子对象的序号。

返回:

成功则返回 true，否则返回 false。

异常:

IndexOutOfBoundsException

如果序号大于等于子对象的个数或序号小于0。

- (void) rotate:		(Point2D *)	point
Angle:		(double)	angle

旋转几何对象。

参数:

	point	旋转基点。
	angle	旋转角度。

实现了Geometry。

- (BOOL) setPart:		(int)	index
Point2Ds:		(Point2Ds *)	points

修改此线几何对象指定序号的子对象，即用新的有序点集合来替换原子对象的有序点集合。

参数:

	index	被修改的子对象的序号。
	points	有序点的集合。

返回:

成功返回 true，否则返回 false。

异常:

	IndexOutOfBoundsException	如果 index 不小于子对象的个数或 index 为负。
	IllegalArgumentException	如果 points 中的点的个数小于2。

- (NSString*) toJson

将线几何对象转换成Json串。

返回:

线几何对象转换的Json串。

实现了Geometry。

---

该类的文档由以下文件生成：

• GeoLine.h