com.supermap.data
类 PrjCoordSys
- java.lang.Object
-
- com.supermap.data.PrjCoordSys
-
public class PrjCoordSys extends java.lang.Object投影坐标系类。
投影坐标系统由地图投影方式、投影参数、坐标单位和地理坐标系组成。SuperMap iMobile for Android 中提供了很多预定义的投影系统,用户可以直接使用,此外,用户还可以定制自己投影系统。
投影坐标系是定义在二维平面上的,不同于地理坐标系用经纬度定位地面点,投影坐标系是用 X、Y 坐标来定位的。每一个投影坐标系都基于一个地理坐标系。
-
-
构造器概要
构造器 构造器和说明 PrjCoordSys()构造一个新的 PrjCoordSys 对象。PrjCoordSys(GeoCoordSys geoCoordSys, Projection projection, PrjParameter prjParameter, java.lang.String name)根据指定的参数来构造一个 PrjCoordSys 的新对象。PrjCoordSys(int EPSGCode)构造一个新的 PrjCoordSys 对象。PrjCoordSys(PrjCoordSys prjCoordSys)根据给定的 PrjCoordSys 对象构造一个与其完全相同的新对象。PrjCoordSys(PrjCoordSysType type)根据指定的参数来构造一个 PrjCoordSys 的新对象。
-
方法概要
所有方法 实例方法 具体方法 限定符和类型 方法和说明 PrjCoordSysclone()对PrjCoordSys进行clonevoiddispose()释放该对象所占用的资源。booleanfromFile(java.lang.String filePath, PrjFileType type)根据 XML 文件与投影文件类型构建PrjCoordSys对象。booleanfromXML(java.lang.String xml)据 XML 字符串构建PrjCoordSys对象,成功返回 true。UnitgetCoordUnit()返回投影系统坐标单位。UnitgetDistanceUnit()返回距离(长度)单位。GeoCoordSysgetGeoCoordSys()返回投影坐标系的地理坐标系统对象。java.lang.StringgetName()返回投影坐标系对象的名称。PrjParametergetPrjParameter()返回投影坐标系统对象的投影参数。ProjectiongetProjection()返回投影坐标系统的投影方式。PrjCoordSysTypegetType()返回投影坐标系类型。booleanisSame(PrjCoordSys prjCoordSys)左边是否相同voidsetCoordUnit(Unit value)设置投影系统坐标单位。voidsetDistanceUnit(Unit value)设置距离(长度)单位。voidsetGeoCoordSys(GeoCoordSys value)设置投影坐标系的地理坐标系统对象。voidsetName(java.lang.String value)设置投影坐标系对象的名称。voidsetPrjParameter(PrjParameter value)设置投影坐标系统对象的投影参数。voidsetProjection(Projection value)设置投影坐标系统的投影方式。voidsetType(PrjCoordSysType value)设置投影坐标系类型。booleantoFile(java.lang.String filePath, PrjFileVersion version)根据指定版本将PrjCoordSys对象导出到投影文件。java.lang.StringtoXML()将投影坐标系类的对象转换为 XML 格式的字符串。
-
-
-
构造器详细资料
-
PrjCoordSys
public PrjCoordSys()
构造一个新的 PrjCoordSys 对象。
-
PrjCoordSys
public PrjCoordSys(int EPSGCode)
构造一个新的 PrjCoordSys 对象。
-
PrjCoordSys
public PrjCoordSys(PrjCoordSysType type)
根据指定的参数来构造一个 PrjCoordSys 的新对象。- 参数:
type- 投影坐标系类型。
-
PrjCoordSys
public PrjCoordSys(GeoCoordSys geoCoordSys, Projection projection, PrjParameter prjParameter, java.lang.String name)
根据指定的参数来构造一个 PrjCoordSys 的新对象。- 参数:
geoCoordSys- 投影坐标系所基于的地理坐标系。projection- 投影方式。投影方式如等角圆锥投影、等距方位投影等等。prjParameter- 投影参数。name- 投影坐标系名称。
-
PrjCoordSys
public PrjCoordSys(PrjCoordSys prjCoordSys)
根据给定的 PrjCoordSys 对象构造一个与其完全相同的新对象。- 参数:
prjCoordSys- 指定的 PrjCoordSys 对象。
-
-
方法详细资料
-
isSame
public boolean isSame(PrjCoordSys prjCoordSys)
左边是否相同- 参数:
prjCoordSys- 投影坐标系- 返回:
- boolean
-
getName
public java.lang.String getName()
返回投影坐标系对象的名称。- 返回:
- 投影坐标系对象的名称。
- Default:
- 默认值为 "User Define"。
-
setName
public void setName(java.lang.String value)
设置投影坐标系对象的名称。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。- 参数:
value- 投影坐标系对象的名称。
-
getType
public PrjCoordSysType getType()
返回投影坐标系类型。当投影坐标系类型为自定义时,用户需另外指定地理坐标系、投影方法、坐标单位以及投影参数;其余的值为 SuperMap Object Java 系统预定义,用户不必指定其他参数。
- 返回:
- 投影坐标系类型。
- Default:
- 默认值为
PrjCoordSysType.PCS_USER_DEFINED。
-
setType
public void setType(PrjCoordSysType value)
设置投影坐标系类型。当投影坐标系类型为自定义时,用户需另外指定地理坐标系、投影方法、坐标单位以及投影参数;其余的值为 SuperMap Object Java 系统预定义,用户不必指定其他参数。
- 参数:
value- 投影坐标系类型。
-
getGeoCoordSys
public GeoCoordSys getGeoCoordSys()
返回投影坐标系的地理坐标系统对象。每个投影系都要依赖于一个地理坐标系。- 返回:
- 投影坐标系的地理坐标系统对象。
- Default:
- 默认值为空的
GeoCoordSys对象。
-
setGeoCoordSys
public void setGeoCoordSys(GeoCoordSys value)
设置投影坐标系的地理坐标系统对象。每个投影系都要依赖于一个地理坐标系。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。- 参数:
value- 投影坐标系的地理坐标系统对象。
-
getProjection
public Projection getProjection()
返回投影坐标系统的投影方式。投影方式如等角圆锥投影、等距方位投影等等。- 返回:
- 投影坐标系统的投影方式。
- Default:
- 默认值为空的
Projection对象。
-
setProjection
public void setProjection(Projection value)
设置投影坐标系统的投影方式。投影方式如等角圆锥投影、等距方位投影等等。该方法仅在坐标系类型为投影坐标系时有效。- 参数:
value- 投影坐标系统的投影方式。
-
getPrjParameter
public PrjParameter getPrjParameter()
返回投影坐标系统对象的投影参数。- 返回:
- 投影坐标系统对象的投影参数。
- Default:
- 默认值为空的
PrjParameter。
-
setPrjParameter
public void setPrjParameter(PrjParameter value)
设置投影坐标系统对象的投影参数。该方法仅在坐标系类型为投影坐标系时有效。- 参数:
value- 投影坐标系统对象的投影参数。
-
getCoordUnit
public Unit getCoordUnit()
返回投影系统坐标单位。投影系统的坐标单位与距离单位(DistanceUnits)可以不同,例如经纬度坐标下的坐标单位是度,距离单位可以是米、公里等; 即使是普通平面坐标或者投影坐标,这两个单位同样可不同。
- 返回:
- 投影系统坐标单位。
- Default:
- 默认值为
METER。
-
setCoordUnit
public void setCoordUnit(Unit value)
设置投影系统坐标单位。投影系统的坐标单位与距离单位(DistanceUnits)可以不同,例如经纬度坐标下的坐标单位是度,距离单位可以是米、公里等; 即使是普通平面坐标或者投影坐标,这两个单位同样可不同。
- 参数:
value- 投影系统坐标单位。
-
setDistanceUnit
public void setDistanceUnit(Unit value)
设置距离(长度)单位。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。- 参数:
value- 距离(长度)单位。
-
fromXML
public boolean fromXML(java.lang.String xml)
据 XML 字符串构建PrjCoordSys对象,成功返回 true。- 参数:
xml- 指定的 XML 字符串。- 返回:
- 如果构建成功返回 true,否则返回 false。
-
toXML
public java.lang.String toXML()
将投影坐标系类的对象转换为 XML 格式的字符串。- 返回:
- 表示投影坐标系类的对象的 XML 字符串。
-
fromFile
public boolean fromFile(java.lang.String filePath, PrjFileType type)根据 XML 文件与投影文件类型构建PrjCoordSys对象。- 参数:
filePath- XML 文件的全路径。type- 投影文件的类型。- 返回:
- 构建成功返回 true,否则返回 false。
-
toFile
public boolean toFile(java.lang.String filePath, PrjFileVersion version)根据指定版本将PrjCoordSys对象导出到投影文件。- 参数:
filePath- XML 文件的全路径。version- 导出投影文件的版本。- 返回:
- 导出成功返回 true,否则返回 false。
-
dispose
public void dispose()
释放该对象所占用的资源。当调用该方法之后,此对象不再可用。
-
clone
public PrjCoordSys clone()
对PrjCoordSys进行clone- 覆盖:
clone在类中java.lang.Object- 返回:
- PrjCoordSys的clone对象
-
-