com.supermap.data
类 CoordSysTransRunnableArgs

java.lang.Object
  com.supermap.data.CoordSysTransRunnableArgs

public class CoordSysTransRunnableArgs
extends java.lang.Object

投影坐标系转换

构造方法摘要

CoordSysTransRunnableArgs(Point2D[] point2ds, Point3D[] point3ds, PrjCoordSys sourcePrj, PrjCoordSys targetPrj, CoordSysTransParameter parameter, CoordSysTransMethod method, CoordSysTransRunnableAction action)
构造一个新的 CoordSysTransRunnableArgs 对象。

方法摘要

CoordSysTransRunnableAction	getAction() 所执行的转换行为。
Point2D[]	getPoint2ds() 需要进行转换的坐标点串（二维点）。
Point3D[]	getPoint3ds() 需要进行转换的坐标点串（三维点）。
PrjCoordSys	getSourcePrjCoordSys() 被转换的数据的投影坐标系。
PrjCoordSys	getTargetPrjCoordSys() 转换的目标投影坐标系。
CoordSysTransMethod	getTransMethod() 使在实现Run方法时能够方便地获得用户在CoordSysTranslator.Convert方法中所指定关转换方法的参数。
CoordSysTransParameter	getTransParameter() 使在实现Run方法时能够方便地获得用户在CoordSysTranslator.Convert方法中所指定关于地理坐标系的参数。

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

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

CoordSysTransRunnableArgs

public CoordSysTransRunnableArgs(Point2D[] point2ds,
                                 Point3D[] point3ds,
                                 PrjCoordSys sourcePrj,
                                 PrjCoordSys targetPrj,
                                 CoordSysTransParameter parameter,
                                 CoordSysTransMethod method,
                                 CoordSysTransRunnableAction action)

构造一个新的 CoordSysTransRunnableArgs 对象。

参数：

point2ds - 需要进行转换的坐标点串（二维点）。

point3ds - 需要进行转换的坐标点串（三维点）。

sourcePrj - 被转换的数据的投影坐标系。

targetPrj - 转换的目标投影坐标系。

parameter - 理坐标系的参数。

method - 转换方法。

action - 所执行的转换行为。具体描述参见：getAction()方法。

方法详细信息

getPoint2ds

public Point2D[] getPoint2ds()

需要进行转换的坐标点串（二维点）。

返回：

需要进行转换的坐标点串（二维点）。

getPoint3ds

public Point3D[] getPoint3ds()

需要进行转换的坐标点串（三维点）。

返回：

需要进行转换的坐标点串（三维点）。

getSourcePrjCoordSys

public PrjCoordSys getSourcePrjCoordSys()

被转换的数据的投影坐标系。

返回：

被转换的数据的投影坐标系。

getTargetPrjCoordSys

public PrjCoordSys getTargetPrjCoordSys()

转换的目标投影坐标系。

返回：

转换的目标投影坐标系。

getAction

public CoordSysTransRunnableAction getAction()

所执行的转换行为。

所执行的转换行为，分为以下几种情况：

1.SourcePrjForward：对于源投影坐标系，从地理坐标系转到投影坐标系。

2.SourcePrjInverse：对于源投影坐标系，从投影坐标系转到地理坐标系。

3.GeoSourceToTarget：不同地理坐标系，从源转到目标。

4.GeoTargetToSource：不同地理坐标系，从目标转到源。

5.TargetPrjForward：对于目标投影坐标系，从地理坐标系转到投影坐标系。

6.TargetPrjInverse：对于目标投影坐标系，从投影坐标系转到地理坐标系。

根据实际需要，用户去实现对应的转换方法，一般情况用户需要同时实现正转和逆转一对方法，例如：实现GeoSourceToTarget转换行为的同时，还需要实现它的逆转，即GeoTargetToSource。如果对于该参数的枚举还是不太明白，请参见下文的具体描述。

SuperMap在处理数据投影转换（数据从源投影坐标系转换到目标投影坐标系时）时，实质是这样一个流程:

将源投影坐标系转换为大地经纬度坐标系->大地经纬度坐标系转换为空间直角坐标系->空间直角坐标系转换为目标空间直角坐标系->目标空间直角坐标系转换为大地经纬度坐标系->大地经纬度坐标系转换为投影坐标系。

说明：上述流程为源投影与目标投影不同且源与目标的地理坐标系也不同时的情况。

CoordSysTransRunnableAction枚举值与上述的转换关系对应如下：（这里将被转换的数据的投影及大地经纬度坐标系称为源投影坐标系及源大地经纬度坐标系；要转换到的称为目标。）

当被转换的数据投影坐标系和大地参考系都不同，用户在处理转换算法时，需要同时处理以下六种情况的转换算法：SourcePrjForward、SourcePrjInverse、GeoSourceToTarget、GeoTargetToSource、TargetPrjForward、TargetPrjInverse。这六种情况的具体含义参见下图所示。

当被转换的数据投影坐标系不同，但是大地参考系相同，则用户在处理转换算法时，只需要处理投影坐标的正转和逆转，即SourcePrjForward和SourcePrjInverse两种情况。

返回：

返回所执行的转换行为。

getTransParameter

public CoordSysTransParameter getTransParameter()

使在实现Run方法时能够方便地获得用户在CoordSysTranslator.Convert方法中所指定关于地理坐标系的参数。

返回：

使在实现Run方法时能够方便地获得用户在CoordSysTranslator.Convert方法中所指定关于地理坐标系的参数。

getTransMethod

public CoordSysTransMethod getTransMethod()

使在实现Run方法时能够方便地获得用户在CoordSysTranslator.Convert方法中所指定关转换方法的参数。

返回：

使在实现Run方法时能够方便地获得用户在CoordSysTranslator.Convert方法中所指定关转换方法的参数。