所有类

概要:
嵌套 |
字段 |
构造器 |
方法

详细资料:
字段 |
构造器 |
方法

java.lang.Object
- com.supermap.data.Geometry

直接已知子类:

GeoArc, GeoBSpline, GeoCardinal, GeoChord, GeoCircle, GeoCompound, GeoCurve, GeoEllipse, GeoEllipticArc, GeoGraphicObject, GeoLine, GeoLineM, Geometry3D, GeoPie, GeoPoint, GeoRectangle, GeoRegion, GeoText
```
public abstract class Geometry
extends java.lang.Object
```
所有具体几何类型（GeoPoint, GeoLine, GeoRegion 等）的基类，提供了基本的几何类型的方法。
该类用于表示地理实体的空间特征，并提供相关的处理方法。根据地理实体的空间特征不同，分别用点（GeoPoint），线(GeoLine)，面(GeoRegion)等加以描述。当该类的子类的对象实例被 dispose 后，再调用该类的方法会抛出 ObjectDisposedException。

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

方法概要

所有方法实例方法抽象方法具体方法
限定符和类型	方法和说明
`abstract Geometry`	`clone()` 返回当前对象的一个拷贝。
`void`	`dispose()` 释放该对象所占用的资源。
`boolean`	`fromGeoJSON(java.lang.String geoJSON)` 从GeoJSON格式的字符串中获取Geometry;具体实现由子类完成。
`boolean`	`fromXML(java.lang.String xml)` 从XML加载几何对象。
`Rectangle2D`	`getBounds()` 返回几何对象的最小外接矩形。
`int`	`getID()` 返回几何对象的标识符，此标识符用于唯一标识该几何对象。
`Point2D`	`getInnerPoint()` 返回几何对象的内点。
`GeoStyle`	`getStyle()` 返回几何对象的几何风格。
`GeometryType`	`getType()` 返回几何对象的类型。
`boolean`	`hitTest(Point2D point, double tolerance)` 测试在指定容限允许的范围内，指定的点是否在几何对象的范围内。
`boolean`	`isEmpty()` 判断几何对象是否为空值，不同的几何对象的是否为空的条件各异，请参见各具体几何类型的该方法。
`void`	`offset(double dx, double dy)` 将此几何对象偏移指定的量。
`void`	`resize(Rectangle2D bounds)` 缩放此几何对象，使其最小外接矩形等于指定的矩形对象。
`void`	`rotate(Point2D basePoint, double angle)` 以指定点为基点将此几何对象旋转指定角度，逆时针方向为正方向，角度以度为单位。
`void`	`setEmpty()` 清空几何对象中的空间数据，但几何对象的标识符和几何风格保持不变。
`void`	`setStyle(GeoStyle value)` 设置几何对象的风格。
`java.lang.String`	`toGeoJSON()` 将Geometry转换成GeoJSON格式的字符串,具体实现由子类完成。
`java.lang.String`	`toXML()` 返回几何对象的XML表示。

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - getBounds
```
public Rectangle2D getBounds()
```
    返回几何对象的最小外接矩形。点对象的最小外接矩形退化为一个点，即矩形的左边界坐标值等于其右边界坐标值，上边界坐标值等于其下边界的坐标值，分别为该点的 x 坐标和 y 坐标。
    
    返回:
    
    一个 Rectangle2D 对象表示几何对象的最小外接矩形。
    
    另请参阅:
    
    Rectangle2D
    
    Default:
    
    默认值为 Rectangle2D(0,0,0,0)。
  - getInnerPoint
```
public Point2D getInnerPoint()
```
    返回几何对象的内点。对于不同的几何对象，其位置不同。
    1. 点对象的内点是该点本身；
    2. 线对象的内点是线对象的第一个子对象的内点（当线对象只有一个子对象时，取该子对象的内点），当该子对象有奇数个节点时，取中间一个节点为内点，当该子对象有偶数个节点时（多于两个节点的情况），取中间两个节点之后者，当该子对象有两个节点时，取两节点之中心为内点；
    3. 面对象的内点是在几何对象的内部，并靠近中央的点；
    4. 文本对象的内点是该文本对象的第一个子对象的锚点。
    内点可以在很多情况下被使用。
    返回:
    
    几何对象的内点。
    
    Default:
    
    默认值为 Point2D(0,0)。
  - getID
```
public int getID()
```
    返回几何对象的标识符，此标识符用于唯一标识该几何对象。
    
    返回:
    
    该几何对象的标识符。
    
    Default:
    
    几何对象的标识默认值为0。
  - isEmpty
```
public boolean isEmpty()
```
    判断几何对象是否为空值，不同的几何对象的是否为空的条件各异，请参见各具体几何类型的该方法。
    
    返回:
    
    一个布尔值指定几何对象是否为空。
    
    Default:
    
    如果几何对象为空值则为 true，否则为 false。默认值为 true。
  - getStyle
```
public GeoStyle getStyle()
```
    返回几何对象的几何风格。几何风格是用于定义几何对象在显示时的符号、线型、填充模式等信息。
    
    返回:
    
    几何对象的风格。
    
    Default:
    
    默认值为 null。
  - setStyle
```
public void setStyle(GeoStyle value)
```
    设置几何对象的风格。几何风格是用于定义几何对象在显示时的符号、线型、填充模式等信息。
    
    参数:
    
    value - 用来设置几何对象风格的 GeoStyle 对象。
  - getType
```
public GeometryType getType()
```
    返回几何对象的类型。该方法的返回值为 GeometryType 类所定义的常量值之一，具体请参见 GeometryType类。
    
    返回:
    
    几何对象的类型。
    
    另请参阅:
    
    GeometryType
  - clone
```
public abstract Geometry clone()
```
    返回当前对象的一个拷贝。
    
    覆盖:
    
    clone 在类中 java.lang.Object
    
    返回:
    
    通过克隆操作得到的一个新的几何对象。
  - hitTest
```
public boolean hitTest(Point2D point,
                       double tolerance)
```
    测试在指定容限允许的范围内，指定的点是否在几何对象的范围内。
    即判断以测试点为圆心，以指定的容限为半径的圆是否与该几何对象有交集，若有交集，则返回 true；否则返回 false。
    
    参数:
    
    point - 测试点。
    
    tolerance - 容限值，单位与数据集的单位相同。
    
    返回:
    
    测试结果，点中了该几何对象返回 true；否则返回 false。
    
    另请参阅:
    
    Point2D
  - offset
```
public void offset(double dx,
                   double dy)
```
    将此几何对象偏移指定的量。
    如图所示为一个面对象平移后的效果。
    参数:
    
    dx - 偏移 X 坐标的量。
    
    dy - 偏移 Y 坐标的量。
    
    Example:
    以下代码示范如何为几何对象进行重构、设置样式、平移、对称、旋转以及缩放操作。
    public void offsetTest() { // 假设打开一个工作空间 workspace 对象，工作空间中存在一个数据源 datasource 对象 // 从数据源中取出一个数据集 dataset // 取出数据集中 SmID=53 的记录，返回其对应的几何对象 DatasetVector dataset = (DatasetVector) datasource.getDatasets().get( "World"); Recordset recordset = dataset.query("SmID=53", CursorType.STATIC); Geometry geometry = recordset.getGeometry(); // 判断几何对象是否为空，不为空时依次对几何对象进行重构、设置样式、平移、对称、旋转以及缩放操作 if (!geometry.isEmpty()) { geometry.fromXML(geometry.toXML()); geometry.setStyle(new GeoStyle()); geometry.offset(100, 100); Rectangle2D rectangle2D = geometry.getBounds(); geometry.mirror(geometry.getInnerPoint(), new Point2D(rectangle2D .getBottom(), rectangle2D.getRight())); geometry.rotate(geometry.getInnerPoint(), 30); geometry.resize(new Rectangle2D(0, 0, 1024, 1024)); } // 释放资源 recordset.dispose(); dataset.close(); geometry.dispose(); }
  - resize
```
public void resize(Rectangle2D bounds)
```
    缩放此几何对象，使其最小外接矩形等于指定的矩形对象。
    对于几何点，该方法只改变其位置，将其移动到指定的矩形的中心点；对于文本对象，该方法将缩放文本大小。
    
    改变几何对象的大小当宽度为负数时对象水平翻转，当高度为负数时，对象垂直翻转。
    
    如图所示为对面对象的缩放的效果。
    
    当传入的矩形对象的面积为0时，抛出异常 ArgumentInvalid。
    
    参数:
    
    bounds - 调整大小后几何对象的范围。
    
    抛出:
    
    ArgumentInvalid - 如果 bounds 的面积为0。
  - rotate
```
public void rotate(Point2D basePoint,
                   double angle)
```
    以指定点为基点将此几何对象旋转指定角度，逆时针方向为正方向，角度以度为单位。
    
    如图所示的是对面对象以指定基点旋转90度后的效果。
    
    参数:
    
    basePoint - 旋转的基点。
    
    angle - 旋转的角度，单位为度。
  - setEmpty
```
public void setEmpty()
```
    清空几何对象中的空间数据，但几何对象的标识符和几何风格保持不变。
  - dispose
```
public void dispose()
```
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
  - toGeoJSON
```
public java.lang.String toGeoJSON()
```
    将Geometry转换成GeoJSON格式的字符串,具体实现由子类完成。
    支持的几何类型：点(GeoPoint)、线(GeoLine)、面(GeoRegion)，包括具有多个子对象的线和面。
    
    返回:
    
    返回GeoJSON字符串,不支持的类型将返回null
  - fromGeoJSON
```
public boolean fromGeoJSON(java.lang.String geoJSON)
```
    从GeoJSON格式的字符串中获取Geometry;具体实现由子类完成。
    
    参数:
    
    geoJSON - GeoJSON字符串
    
    返回:
    
    返回是否转换成功
  - fromXML
```
public boolean fromXML(java.lang.String xml)
```
    从XML加载几何对象。
    
    参数:
    
    xml - 几何对象的xml字符串
    
    返回:
    
    boolean 读取成功返回true,否则返回false
  - toXML
```
public java.lang.String toXML()
```
    返回几何对象的XML表示。
    
    返回:
    
    返回几何对象的xml字符串