Geometry类参考

所有具体几何类型（ <GeoPoint> , <GeoLine> , <GeoRegion> 等）的基类，提供了基本的几何类型的方法。 更多...

被GeoCircle、GeoGraphicObject、GeoLine、GeoLineM、Geometry3D、GeoPoint、GeoRegion及GeoText继承.

所有成员的列表。

公有成员
(Rectangle2D *)	- getBounds
	返回几何对象的最小外接矩形。点对象的最小外接矩形退化为一个点，即矩形的左边界坐标值等于其右边界坐标值，上边界坐标值等于其下边界的坐标值，分别为该点的 x 坐标和 y 坐标。
(Point2D *)	- getInnerPoint
	返回几何对象的内点。对于不同的几何对象，其位置不同。 1.
(int)	- getID
	返回几何对象的标识符，此标识符用于唯一标识该几何对象。
(bool)	- isEmpty
	判断几何对象是否为空值，不同的几何对象的是否为空的条件各异，请参见各具体几何类型的该方法。
(GeoStyle *)	- getStyle
	返回几何对象的几何风格。几何风格是用于定义几何对象在显示时的符号、线型、填充模式等信息。
(void)	- setStyle:
	设置几何对象的风格。几何风格是用于定义几何对象在显示时的符号、线型、填充模式等信息。
(GeometryType)	- getType
	返回几何对象的类型。该方法的返回值为 <GeometryType> 类所定义的常量值之一，具体请参见 <GeometryType> 类。
(Geometry *)	- clone
	返回当前对象的一个拷贝。
(bool)	- hitTest:With:
	测试在指定容限允许的范围内，指定的点是否在几何对象的范围内。
(void)	- offsetX:Y:
	将此几何对象偏移指定的量。
(void)	- resize:
	缩放此几何对象，使其最小外接矩形等于指定的矩形对象。
(void)	- rotate:Angle:
	以指定点为基点将此几何对象旋转指定角度，逆时针方向为正方向，角度以度为单位。
(void)	- setEmpty
	清空几何对象中的空间数据，但几何对象的标识符和几何风格保持不变。
(void)	- dispose
	释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
(NSString *)	- toJson
	将Geometry对象转换成Json串。
(BOOL)	- fromJson:
	将Json串转换成Geometry对象。
(NSString *)	- toGeoJson
	将Geometry转换成GeoJSON格式的字符串;具体实现由子类完成
(BOOL)	- fromGeoJson:
	从GeoJSON格式的字符串中获取Geometry;具体实现由子类完成
(NSString *)	- toXML
(BOOL)	- fromXML:

---

详细描述

所有具体几何类型（ <GeoPoint> , <GeoLine> , <GeoRegion> 等）的基类，提供了基本的几何类型的方法。

该类用于表示地理实体的空间特征，并提供相关的处理方法。根据地理实体的空间特征不同，分别用点 < GeoPoint > ，线 < GeoLine> ，面 <G eoregion>=""> 等加以描述。当该类的子类的对象实例被 dispose 后，再调用该类的方法会抛出 ObjectDisposedException。

用户自己创建的 <Geometry> 对象，例如 <GeoPoint> 、<GeoLine> 、 <GeoRegion> 等对象，在执行完系列操作后，需要对其进行释放。

---

成员函数文档

- (Geometry *) clone

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

返回:

通过克隆操作得到的一个新的几何对象。

在GeoCircle、GeoGraphicObject、GeoLine、GeoLine3D、GeoModel、GeoPlacemark、GeoPoint、GeoRegion、GeoRegion3D、GeoText及GeoText3D内被实现。

- (void) dispose

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

在GeoCircle、GeoGraphicObject、GeoLine、GeoPoint、GeoRegion及GeoText内被实现。

- (BOOL) fromGeoJson:

(NSString *)

geoJSON

从GeoJSON格式的字符串中获取Geometry;具体实现由子类完成

参数:

geoJSON

GeoJSON字符串

返回:

返回是否转换成功

- (BOOL) fromJson:

(id)

JSONData

将Json串转换成Geometry对象。

参数:

JSONData

id类型的Json串。

返回:

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

在GeoLine、GeoPoint及GeoRegion内被实现。

- (BOOL) fromXML:

(NSString *)

xml

参数:

- (Rectangle2D *) getBounds

返回几何对象的最小外接矩形。点对象的最小外接矩形退化为一个点，即矩形的左边界坐标值等于其右边界坐标值，上边界坐标值等于其下边界的坐标值，分别为该点的 x 坐标和 y 坐标。

返回:

一个 <Rectangle2D> 对象表示几何对象的最小外接矩形。

请参见 <Rectangle2D>

- (int) getID

返回几何对象的标识符，此标识符用于唯一标识该几何对象。

返回:

该几何对象的标识符。

- (Point2D *) getInnerPoint

返回几何对象的内点。对于不同的几何对象，其位置不同。 1.

点对象的内点是该点本身； 2. 线对象的内点是线对象的第一个子对象的内点（当线对象只有一个子对象时，取该子对象的内点），当该子对象有奇数个节点时，取中间一个节点为内点，当该子对象有偶数个节点时（多于两个节点的情况），取中间两个节点之后者，当该子对象有两个节点时，取两节点之中心为内点； 3. 面对象的内点是在几何对象的内部，并靠近中央的点； 4. 文本对象的内点是该文本对象的第一个子对象的锚点。

内点可以在很多情况下被使用。

返回:

几何对象的内点。

- (GeoStyle *) getStyle

返回几何对象的几何风格。几何风格是用于定义几何对象在显示时的符号、线型、填充模式等信息。

返回:

几何对象的风格。

- (GeometryType) getType

返回几何对象的类型。该方法的返回值为 <GeometryType> 类所定义的常量值之一，具体请参见 <GeometryType> 类。

返回:

几何对象的类型。

请参见 <GeometryType>

- (bool) hitTest:		(Point2D *)	point
With:		(double)	tolerance

测试在指定容限允许的范围内，指定的点是否在几何对象的范围内。

即判断以测试点为圆心，以指定的容限为半径的圆是否与该几何对象有交集，若有交集，则返回 true；否则返回 false。

参数:

	point	测试点。
	tolerance	容限值，单位与数据集的单位相同。

返回:

测试结果，点中了该几何对象返回 true；否则返回 false。

请参见 <Point2D>

- (bool) isEmpty

判断几何对象是否为空值，不同的几何对象的是否为空的条件各异，请参见各具体几何类型的该方法。

返回:

一个布尔值指定几何对象是否为空。

在GeoLine、GeoPoint、GeoRegion及GeoText内被实现。

- (void) offsetX:		(double)	dx
Y:		(double)	dy

将此几何对象偏移指定的量。

参数:

	dx	偏移 X 坐标的量。
	dy	偏移 Y 坐标的量。

- (void) resize:

(Rectangle2D *)

bounds

缩放此几何对象，使其最小外接矩形等于指定的矩形对象。

对于几何点，该方法只改变其位置，将其移动到指定的矩形的中心点；对于文本对象，该方法将缩放文本大小。

改变几何对象的大小 当宽度为负数时对象水平翻转，当高度为负数时，对象垂直翻转。

当传入的矩形对象的面积为0时，抛出异常 ArgumentInvalid。

参数:

bounds

调整大小后几何对象的范围。

异常:

ArgumentInvalid

如果 bounds 的面积为0。

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

以指定点为基点将此几何对象旋转指定角度，逆时针方向为正方向，角度以度为单位。

参数:

	basePoint	旋转的基点。
	angle	旋转的角度，单位为度。

在GeoLine内被实现。

- (void) setEmpty

清空几何对象中的空间数据，但几何对象的标识符和几何风格保持不变。

- (void) setStyle:

(GeoStyle *)

value

设置几何对象的风格。几何风格是用于定义几何对象在显示时的符号、线型、填充模式等信息。

参数:

value

用来设置几何对象风格的 <GeoStyle> 对象。

- (NSString*) toGeoJson

将Geometry转换成GeoJSON格式的字符串;具体实现由子类完成

返回:

返回GeoJSON字符串

- (NSString*) toJson

将Geometry对象转换成Json串。

返回:

Geometry对象转换的Json串。

在GeoLine、GeoPoint及GeoRegion内被实现。

- (NSString*) toXML

参数:

---

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

• Geometry.h