Create3DPolygon

The Create3DPolygon method creates an ITerrain3DPolygon6 object.

 

JavaScript
Create3DPolygon(pIGeometry, ObjectHeight, LineColor, FillColor, AltitudeType, GroupID, Description)

 

C#
ITerrain3DPolygon6 Create3DPolygon(   IGeometry       pIGeometry,   double ObjectHeight = 20,   object LineColor = -16711936,   object FillColor = -10197916,   AltitudeTypeCode AltitudeType = AltitudeTypeCode.ATC_TERRAIN_RELATIVE,   int GroupID = 0,   string Description = "")

 

C++
HRESULT Create3DPolygon(        IGeometry *      pIGeometry,        double     ObjectHeight,        VARIANT    LineColor,        VARIANT    FillColor,        AltitudeTypeCode       AltitudeType,        LONG_PTR   GroupID,        BSTR       Description,        ITerrain3DPolygon6 **  pITerrain3DPolygon6)

 

Parameters

pIGeometry

An IGeometry representing the geometric properties and behavior of the object.

ObjectHeight

The height of the 3-dimensional polygon in meters.

LineColor

The color of the lines that make up the 3-dimensional polygon. The color value is used to specify an RGB color. When specifying an explicit RGB color, the color value has the following hexadecimal form: 0x00bbggrr. The low-order byte contains a value for the relative intensity of red; the second byte contains a value for green; and the third byte contains a value for blue. The high-order byte must be zero. The maximum value for a single byte is 0xFF.

FillColor

The color with which the 3-dimensional polygon is filled if the alpha value is greater than 0. The color value is used to specify an RGB color. When specifying an explicit RGB color, the color value has the following hexadecimal form: 0x00bbggrr. The low-order byte contains a value for the relative intensity of red; the second byte contains a value for green; and the third byte contains a value for blue. The high-order byte must be zero. The maximum value for a single byte is 0xFF.

AltitudeType

An enum that determines the altitude type to be used by the shape. The following are the possible AltitudeType values:

·         ATC_TERRAIN_RELATIVE = 0
Relative to Terrain - Places the shape’s pivot point at a specified altitude above the ground.

·         ATC_TERRAIN_ABSOLUTE = 3

Absolute - Places the shape’s pivot point at a specified altitude above the terrain database vertical datum base ellipsoid.

GroupID

The Project Tree group in which the 3-dimensional polygon 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 3-dimensional polygon as it appears in the Project Tree. If an empty string is passed into this parameter, TerraExplorer assigns it a unique name.

Return Value

pITerrain3DPolygon6

An ITerrain3DPolygon6 object, representing the created object.

Exceptions

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