CreateImageryLayer

CreateImageryLayer loads an imagery layer into the project. Adding the image 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 ITerrainRasterLayer61. CoordinateSystem.   

 

JavaScript
CreateImageryLayer(        ImageryFileName,        UpperLeftX,        UpperLeftY,        LowerRightX,        LowerRightY,        InitParam ,        PlugName ,        GroupID ,        Description )

 

C#
ITerrainRasterLayer61 CreateImageryLayer(        string   ImageryFileName,        double   UpperLeftX,        double   UpperLeftY,        double   LowerRightX,        double   LowerRightY,        object   InitParam = 0,        object   PlugName = "",        int      GroupID = 0,        string   Description = "")

 

C++

HRESULT CreateImageryLayer(         BSTR                          ImageryFileName,         double                        UpperLeftX,         double                        UpperLeftY,         double                        LowerRightX,         double                        LowerRightY,         VARIANT                       InitParam,         VARIANT                       PlugName,         LONG_PTR                      GroupID,         BSTR                          Description,         ITerrainRasterLayer61 **      pITerrainRasterLayer61)

Parameters

ImageryFileName

A full path name to the image 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 imagery 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 IProjectTree61.CreateGroup.

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

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

Description

The name of the imagery layer as it appears in the Project Tree. If an empty string is passed into this parameter, TerraExplorer assigns it a unique name.

Return Value

pITerrainRasterLayer61

An ITerrainRasterLayer61, representing the newly created imagery layer.

Exceptions

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