com.supermap.data
类 CoordSysTransParameter

java.lang.Object
  继承者 com.supermap.data.CoordSysTransParameter

public class CoordSysTransParameter
extends java.lang.Object

投影转换参照系转换参数类,通常包括平移、旋转和比例因子。

在进行投影转换时,如果源投影和目标投影的地理坐标系不同,则需要进行参照系转换。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 对象构造一个与其完全相同的新对象。
 
方法摘要
 void dispose()
          释放该对象所占用的资源。
 boolean fromXML(java.lang.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 轴的坐标偏移量。
 java.lang.String toXML()
          将该 CoordSysTransParameter 对象输出为 XML 字符串。
 
从类 java.lang.Object 继承的方法
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

CoordSysTransParameter

public CoordSysTransParameter()
构造一个新的 CoordSysTransParameter 对象。


CoordSysTransParameter

public CoordSysTransParameter(CoordSysTransParameter coordSysTransParameter)
根据给定的 CoordSysTransParameter 对象构造一个与其完全相同的新对象。

参数:
coordSysTransParameter - 指定的 CoordSysTransParameter 对象。
方法详细信息

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 - 投影比例尺差。

fromXML

public boolean fromXML(java.lang.String xml)
根据 XML 字符串构建 CoordSysTransParameter 对象,成功返回 true。

参数:
xml - 表示投影转换参数对象的 XML 字符串。
返回:
如果构建 XML 字符串成功则返回 true,否则返回 false。

toXML

public java.lang.String toXML()
将该 CoordSysTransParameter 对象输出为 XML 字符串。

返回:
CoordSysTransParameter 对象的 XML 格式字符串。

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坐标的量。