CreateElevationLayer

CreateImageryLayer loads an elevation layer into the project. 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 ITerrainRasterLayer6. CoordinateSystem.

 

JavaScript
CreateElevationLayer(       ElevationFileName,       UpperLeftX,       UpperLeftY,       LowerRightX,       LowerRightY,       InitParam ,       PlugName ,       GroupID ,       Description ,       HScale ,       HOffset )

 

C#
ITerrainRasterLayer6 CreateElevationLayer(       string    ElevationFileName,       double    UpperLeftX,       double    UpperLeftY,       double    LowerRightX,       double    LowerRightY,       object    InitParam = 0,       object    PlugName = "",       int       GroupID = 0,       string    Description = "",       double    HScale = 1,       double    HOffset = 0)

 

C++

HRESULT CreateElevationLayer(        BSTR                      ElevationFileName,        double                    UpperLeftX,        double                    UpperLeftY,        double                    LowerRightX,        double                    LowerRightY,        VARIANT                   InitParam,        VARIANT                   PlugName,        LONG_PTR                  GroupID,        BSTR                      Description,        double                    HScale,        double                    HOffset,        ITerrainRasterLayer6 **   pITerrainRasterLayer6)

 

Parameters

ElevationFileName

A full pathname to the elevation to import to the terrain.

UpperLeftX

The West-East coordinate of the elevation upper left corner in the project’s coordinate system units. If all four coordinate field values are zero, the coordinate information, if available, is read from the file.

UpperLeftY

The North-South coordinate of the elevation upper left corner in the project’s coordinate system units. If all four coordinate field values are zero, the coordinate information, if available, is read from the file.

LowerRightX

The West-East coordinate of the elevation lower right corner in the project’s coordinate system units. If all four coordinate field values are zero, the coordinate information, if available, is read from the file.

LowerRightY

The North-South coordinate of the elevation lower right corner in the project’s coordinate system units. If all four coordinate field values are zero, the coordinate information, if available, is read from the file.

InitParam

Reserved. Always pass null for this parameter.

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 Project 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 using IProjectTree6.CreateGroup.

§  Find the group, if you know the name, using IProjectTree6.FindItem.

§  Traverse the Tree using IProjectTree6 methods such as GetNextItem(), until you come to the desired GroupID.

Description

The name of the elevation layer as it appears in the Project Tree. 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.

Return Value

pITerrainRasterLayer6

An ITerrainRasterLayer6, representing the newly created elevation layer.

Exceptions

See: HRESULT Return Values for a list of possible values returned by the HRESULT.