CoordSysTransParameter (iObjects Java Help)

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.data.CoordSysTransParameter

所有已实现的接口:

IDisposable
```
public class CoordSysTransParameter
extends com.supermap.data.InternalHandleDisposable
```
投影转换参照系转换参数类，通常包括平移、旋转和比例因子。

在进行投影转换时，如果源投影和目标投影的地理坐标系不同，则需要进行参照系转换。SuperMap 提供常用的六种参照系转换方法，详见 CoordSysTransMethod 方法。不同的参照系转换方法需要指定不同的转换参数：
1. 三参数转换法（GeocentricTranslation）、莫洛金斯基转换法（Molodensky）、简化的莫洛金斯基转换法（MolodenskyAbridged）属于精度较低的几种转换方法，在数据精度要求不高的情况下一般可以采用这几种方法。这三种转换法需要给定三个平移转换参数：X 轴坐标偏移量（setTranslateX）、Y 轴坐标偏移量（setTranslateY）和 Z 轴坐标偏移量（setTranslateZ）。
2. 位置矢量法（PositionVector）、基于地心的七参数转换法（CoordinateFrame）、布尔莎方法（BursaWolf）属于精度较高的几种转换方法。需要七个参数来进行调整和转换，包括除上述的三个平移转换参数外，还需要设置三个旋转转换参数（X 轴旋转角度（setRotateX）、Y 轴旋转角度（setRotateY）和 Z 轴旋转角度（setRotateZ））和投影比例尺差参数（setScaleDifference）。
有关投影转换的详细介绍，请参阅《地图投影》和《地理数据坐标系转换》技术文档。

构造器概要

构造器
构造器和说明
`CoordSysTransParameter()` 构造一个新的 CoordSysTransParameter 对象。
`CoordSysTransParameter(CoordSysTransParameter coordSysTransParameter)` 根据给定的 CoordSysTransParameter 对象构造一个与其完全相同的新对象。
`CoordSysTransParameter(long handle, boolean disposable)`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`clearHandle()` 当内存先被释放，必须调用该函数以标记对象为不可用
`CoordSysTransParameter`	`clone()`
`void`	`dispose()` 释放该对象所占用的资源。
`boolean`	`fromXML(String xml)` 根据 XML 字符串构建 CoordSysTransParameter 对象，成功返回 true。
`double`	`getRotateX()` 返回 X 轴的旋转角度。
`double`	`getRotateY()` 返回 Y 轴的旋转角度。
`double`	`getRotateZ()` 返回 Z 轴的旋转角度。
`double`	`getRotationOriginX()` 返回旋转原点的X坐标的量。
`double`	`getRotationOriginY()` 返回旋转原点的Y坐标的量。
`double`	`getRotationOriginZ()` 返回旋转原点的Z坐标的量。
`double`	`getScaleDifference()` 返回投影比例尺差。
`double`	`getTranslateX()` 返回 X 轴的坐标偏移量。
`double`	`getTranslateY()` 返回 Y 轴的坐标偏移量。
`double`	`getTranslateZ()` 返回 Z 轴的坐标偏移量。
`void`	`setRotateX(double value)` 设置 X 轴的旋转角度。
`void`	`setRotateY(double value)` 设置 Y 轴的旋转角度。
`void`	`setRotateZ(double value)` 设置 Z 轴的旋转角度。
`void`	`setRotationOriginX(double value)` 设置旋转原点的X坐标。
`void`	`setRotationOriginY(double value)` 设置旋转原点的Y坐标。
`void`	`setRotationOriginZ(double value)` 设置旋转原点的Z坐标。
`void`	`setScaleDifference(double value)` 设置投影比例尺差。
`void`	`setTranslateX(double value)` 设置 X 轴的坐标偏移量。
`void`	`setTranslateY(double value)` 设置 Y 轴的坐标偏移量。
`void`	`setTranslateZ(double value)` 设置 Z 轴的坐标偏移量。
`String`	`toXML()` 将该 CoordSysTransParameter 对象输出为 XML 字符串。

从类继承的方法 com.supermap.data.InternalHandleDisposable
makeSureNativeObjectLive

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

- 构造器详细资料
  - CoordSysTransParameter
```
public CoordSysTransParameter()
```
    构造一个新的 CoordSysTransParameter 对象。
  - CoordSysTransParameter
```
public CoordSysTransParameter(CoordSysTransParameter coordSysTransParameter)
```
    根据给定的 CoordSysTransParameter 对象构造一个与其完全相同的新对象。
    
    参数:
    
    coordSysTransParameter - 指定的 CoordSysTransParameter 对象。
  - CoordSysTransParameter
```
public CoordSysTransParameter(long handle,
                              boolean disposable)
```
- 方法详细资料
  - clearHandle
```
public void clearHandle()
```
    从类复制的说明: com.supermap.data.InternalHandle
    
    当内存先被释放，必须调用该函数以标记对象为不可用
    
    覆盖:
    
    clearHandle 在类中 com.supermap.data.InternalHandle
  - clone
```
public CoordSysTransParameter clone()
```
    覆盖:
    
    clone 在类中 Object
  - dispose
```
public void dispose()
```
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
  - getTranslateX
```
public double getTranslateX()
```
    返回 X 轴的坐标偏移量。单位为米。
    
    返回:
    
    X 轴的坐标偏移量。
    
    默认值:
    
    默认值为 0。
  - setTranslateX
```
public void setTranslateX(double value)
```
    设置 X 轴的坐标偏移量。单位为米。
    
    参数:
    
    value - X 轴的坐标偏移量。
  - getTranslateY
```
public double getTranslateY()
```
    返回 Y 轴的坐标偏移量。单位为米。
    
    返回:
    
    Y 轴的坐标偏移量。
    
    默认值:
    
    默认值为 0。
  - setTranslateY
```
public void setTranslateY(double value)
```
    设置 Y 轴的坐标偏移量。单位为米。
    
    参数:
    
    value - Y 轴的坐标偏移量。
  - getTranslateZ
```
public double getTranslateZ()
```
    返回 Z 轴的坐标偏移量。单位为米。
    
    返回:
    
    Z 轴的坐标偏移量。
    
    默认值:
    
    默认值为 0。
  - setTranslateZ
```
public void setTranslateZ(double value)
```
    设置 Z 轴的坐标偏移量。单位为米。
    
    参数:
    
    value - Z 轴的坐标偏移量。
  - getRotateX
```
public double getRotateX()
```
    返回 X 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
    
    返回:
    
    X 轴的旋转角度。
    
    默认值:
    
    默认值为 0。
  - setRotateX
```
public void setRotateX(double value)
```
    设置 X 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
    
    参数:
    
    value - X 轴的旋转角度。
  - getRotateY
```
public double getRotateY()
```
    返回 Y 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
    
    返回:
    
    Y 轴的旋转角度。
    
    默认值:
    
    默认值为 0。
  - setRotateY
```
public void setRotateY(double value)
```
    设置 Y 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
    
    参数:
    
    value - Y 轴的旋转角度。
  - getRotateZ
```
public double getRotateZ()
```
    返回 Z 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
    
    返回:
    
    Z 轴的旋转角度。
    
    默认值:
    
    默认值为 0。
  - setRotateZ
```
public void setRotateZ(double value)
```
    设置 Z 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
    
    参数:
    
    value - Z 轴的旋转角度。
  - getScaleDifference
```
public double getScaleDifference()
```
    返回投影比例尺差。单位为百万分之一。用于不同大地参照系之间的转换。
    
    返回:
    
    投影比例尺差。
    
    默认值:
    
    默认值为 0。
  - setScaleDifference
```
public void setScaleDifference(double value)
```
    设置投影比例尺差。单位为百万分之一。用于不同大地参照系之间的转换。
    
    参数:
    
    value - 投影比例尺差。
  - getRotationOriginX
```
public double getRotationOriginX()
```
    返回旋转原点的X坐标的量。
    
    返回:
    
    返回旋转原点的X坐标的量。
  - setRotationOriginX
```
public void setRotationOriginX(double value)
```
    设置旋转原点的X坐标。
    
    参数:
    
    value - 旋转原点的X坐标的量。
  - getRotationOriginY
```
public double getRotationOriginY()
```
    返回旋转原点的Y坐标的量。
    
    返回:
    
    返回旋转原点的Y坐标的量。
  - setRotationOriginY
```
public void setRotationOriginY(double value)
```
    设置旋转原点的Y坐标。
    
    参数:
    
    value - 旋转原点的Y坐标的量。
  - getRotationOriginZ
```
public double getRotationOriginZ()
```
    返回旋转原点的Z坐标的量。
    
    返回:
    
    返回旋转原点的Z坐标的量。
  - setRotationOriginZ
```
public void setRotationOriginZ(double value)
```
    设置旋转原点的Z坐标。
    
    参数:
    
    value - 旋转原点的Z坐标的量。
  - fromXML
```
public boolean fromXML(String xml)
```
    根据 XML 字符串构建 CoordSysTransParameter 对象，成功返回 true。
    
    参数:
    
    xml - 表示投影转换参数对象的 XML 字符串。
    
    返回:
    
    如果构建 XML 字符串成功则返回 true，否则返回 false。
  - toXML
```
public String toXML()
```
    将该 CoordSysTransParameter 对象输出为 XML 字符串。
    
    返回:
    
    CoordSysTransParameter 对象的 XML 格式字符串。

类 CoordSysTransParameter

构造器概要

方法概要

从类继承的方法 com.supermap.data.InternalHandleDisposable

从类继承的方法 java.lang.Object

构造器详细资料

CoordSysTransParameter

CoordSysTransParameter

CoordSysTransParameter

方法详细资料

clearHandle

clone

dispose

getTranslateX

setTranslateX

getTranslateY

setTranslateY

getTranslateZ

setTranslateZ

getRotateX

setRotateX

getRotateY

setRotateY

getRotateZ

setRotateZ

getScaleDifference

setScaleDifference

getRotationOriginX

setRotationOriginX

getRotationOriginY

setRotationOriginY

getRotationOriginZ

setRotationOriginZ

fromXML

toXML