Skyline软件开发接口分类.doc

Skyline软件开发接口分类
ITerraExplorer
IPlane
IObjectManager
IInformationTree
ITerrain
IContainer
IRender
ISnapShot
IStartPosition
ITerraExplorerEvents
ICoordSysICoordSys3
ICoordSys接口提供了相关坐标功能,允许定义一种输入坐标系,使TerraExplorer将其转化为当前地形数据库的坐标系,在设置了用户的坐标系以后,从客户端可以得到相应坐标系下的坐标,并转化为地形的坐标系统,这个接口也提供了高级的对话框,充许自定义坐标系统,有以下方法,四个关键值:GroupKey, SystemKey, DatumKey and UnitKey,通过这些值定义一个坐标系统,用户会使用不同的坐标系统,必需为每一个客户定义属于自己的坐标系统
The ICoordSys2 接口, 继承了 ICoordSys接口, 增加了国际军事格网参考系Military Grid Reference System (MGRS) 采用ChooseCSDialogEx支持并更新了ChooseCSDialog 方法。
注: 这个接口只有在TerraExplorer Pro – GIS edition可用
如图:
ICoordSys
方法:
GetTerrainCS, SetTerrainCS, SetSourceCS, ChooseCSDialog, GetCSHandle, GetCSHandleFromEPSG, ReleaseCSHandle, Reproject, GetUnitFactor, MoveCoord, MoveCoordEx, GetDistance, GetAimingAngles
ICoordSys2
方法:
ConvertToMGRS, ConvertFromMGRS, ChooseCSDialogEx
ICoordSys3
方法:
GetDistanceEx, GetAimingAnglesEx
GetTerrainCS
这个方法返回地形的坐标系统,每一个地形数据包括了一个坐标系统,这个方法可以帮助得到相关信息,与这种方法相类似的有ITerrain3::GroupKey, ITerrain3::DatumKey等
 
语法: GetTerrainCS(
 [out] VARIANT* bstrGroupKey,
 [out] VARIANT* bstrSystemKey,
 [out] VARIANT* bstrDatumKey,
 [out] VARIANT* bstrUnitKey,
 [out] VARIANT* longEPSG)
参数:
§         bstrGroupKey –坐标组唯一字符串.
§         bstrSystemKey –坐标唯一字符串
§         bstrDatumKey –坐标投影唯一字符串.
§         bstrUnitKey –坐标单位字符串
§         longEPSG –保留
返回值: 
返回值
意义
S_OK
成功
E_FAIL
失败
TE_E_MPTNOTLOADED
TerraExplorer必载加载一个MPT, 这个方法才能使用
TE_E_NOLICENSE
运行地是基础版,没有授权
SetTerrainCS
这个方法用于设置坐标系. 通常坐标系源于地形数据(mpt)的坐标. 但是有时坐标系与地形数据(MPT)不一致或是有错误, 这时将手工定制
在设置了地形数据的坐标系后,每一个坐标值将转化的新的坐标系下,如果是设置源地形坐标系必须采用 ICoordSys::SetSourceCS().方法,这一点要区分。
 
语法: SetTerrainCS(
 [in] BSTR GroupKey,
 [in] BSTR SystemKey,
 [in] BSTR DatumKey,
 [in] BSTR UnitKey,
 [in] long EPSG)
Parameters:
§         bstrGroupKey –坐标组唯一字符串.
§         bstrSystemKey –坐标唯一字符串
§         bstrDatumKey –坐标投影唯一字符串.
§         bstrUnitKey –坐标单位字符串
§         longEPSG –保留
返回值: 
返回值
意义
S_OK
成功
E_FAIL
失