com.supermap.data
类 CoordSysTransParameter
- 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
方法。不同的参照系转换方法需要指定不同的转换参数:- 三参数转换法(GeocentricTranslation)、莫洛金斯基转换法(Molodensky)、简化的莫洛金斯基转换法(MolodenskyAbridged)属于精度较低的几种转换方法,在数据精度要求不高的情况下一般可以采用这几种方法。这三种转换法需要给定三个平移转换参数:X 轴坐标偏移量(
setTranslateX
)、Y 轴坐标偏移量(setTranslateY
)和 Z 轴坐标偏移量(setTranslateZ
)。 - 位置矢量法(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 字符串。
-
-
-
构造器详细资料
-
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()
-
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 格式字符串。
-
-
Copyright © 2021–2024 SuperMap. All rights reserved.