CreateElevationLayer

CreateImageryLayer creates an elevation layer in the 3D window. Adding the elevation source uses a set of plugins that support multiple file formats. The coordinates of the source can be passed via the UpperLeftX/Y and LowerRightX/Y parameters. If all four coordinate field values are zero, the coordinate information, if available, is read from the file. If the source file coordinate system is not the same as the MPT file Terrain Coordinate system, you can reproject it using the ITerrainRasterLayer::SetLayerCS() method.

HRESULT CreateElevationLayer(

[in] BSTR ElevationFileName,

[in] double UpperLeftX,

[in] double UpperLeftY,

[in] double LowerRightX,

[in] double LowerRightY,

[in, optional, defaultvalue(0)] VARIANT InitParam,

[in, optional, defaultvalue("")] VARIANT PlugName,

[in, optional, defaultvalue(0)] long GroupID,

[in, optional, defaultvalue("")] BSTR Description,

[in, optional, defaultvalue(1)] double HScale,

[in, optional, defaultvalue(0)] double HOffset,

[out, retval] ITerrainRasterLayer** pITerrainRasterLayer5)

Parameters:

• ElevationFileName – A full pathname to the elevation to import to the terrain.

• UpperLeftX – The West-East coordinate of the elevation upper left corner. If all four coordinate field values are zero, the coordinate information, if available, is read from the file. If you are working in a Lat-Long format, the Lat-Long values should be in decimal Lat-Long.

• UpperLeftY – The North-South coordinate of the elevation upper left corner. If all four coordinate field values are zero, the coordinate information, if available, is read from the file. If you are working in a Lat-Long format, the Lat-Long values should be in decimal Lat-Long.

• LowerRightX – The West-East coordinate of the elevation lower right corner. If all four coordinate field values are zero, the coordinate information, if available, is read from the file. If you are working in a Lat-Long format, the Lat-Long values should be in decimal Lat-Long.

• LowerRightY – The North-South coordinate of the elevation lower right corner. If all four coordinate field values are zero, the coordinate information, if available, is read from the file. If you are working in a Lat-Long format, the Lat-Long values should be in decimal Lat-Long.

• InitParam – Reserved. Currently not used.

• PlugName – The name of the plugin used to read the file, e.g., “tifplg.rct“. The available plugins are files with RCT extension, that exist in the “TBPlugs“ directory. If an empty string is passed into this parameter, the default plugin for the file type is used.

• GroupID – The Information Tree group in which the elevation layer is created. If it is set to zero, the object is created under the root. You can obtain the GroupID by one of the following methods:

• Create the group the IInformationTree5::CreateGroup.

• If you know the name of the group, find it using IInformationTree5::FindItem.

• Traverse the Tree using IInformationTree5 methods such as GetNextItem, until you come to the desired GroupID.

• Description –The name of the elevation layer as it appears in the Information Window. If an empty string is passed into this parameter, TerraExplorer assigns it a unique name.

• HScale – The scale factor for the elevation value.

• HOffset – The offset for the elevation value.

• pITerrainRasterLayer5 – An interface pointer to the newly created elevation layer. This parameter must not be Null.

Return Values:

The return value obtained from the returned HRESULT can be one of the following: