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


该类的文档由以下文件生成:
 å…¨éƒ¨ ç±» æ–‡ä»¶ å‡½æ•° å˜é‡ ç±»åž‹å®šä¹‰ æžšä¸¾ æžšä¸¾å€¼ å±žæ€§ å®å®šä¹‰