This method sets the terrain coordinate system. By default, the terrain coordinate system is read from the terrain database. However, in rare cases where you know the coordinate system does not exist in the terrain database, or is erroneous, you can define it manually.
After setting the terrain coordinate system, each coordinate given by this client is converted to this coordinate system. To set the source coordinate system use ICoordSys::SetSourceCS().
HRESULT SetTerrainCS(
[in] BSTR GroupKey,
[in] BSTR SystemKey,
[in] BSTR DatumKey,
[in] BSTR UnitKey,
[in] long EPSG)
Parameters:
GroupKey – The unique string of the coordinate system group.
SystemKey – The unique string of the coordinate system.
DatumKey – The unique string of the coordinate system datum.
UnitKey – The unique string of the coordinate system units.
EPSG – Reserved.
Return Values:
The return value obtained from the returned HRESULT can be one of the following:
|
Return value |
Meaning |
|
S_OK |
Success. |
|
E_FAIL |
Catastrophic failure. |
|
TE_E_MPTNOTLOADED |
An MPT file must be loaded in TerraExplorer for this method to work. |
|
TE_E_NOLICENSE |
You are running TerraExplorer Viewer and therefore do not have permission to work with this interface. |