CreateThreatDome

Creates an object shaped as a dome, elevated above the terrain. The threat dome object represents the volume covered by a radar station located at the base of the dome.

JavaScript
CreateThreatDome(       Position,       Range,       AngularStep,       RadialStep,       Direction,       HorizontalFOV,       ElevationAngle,       Color ,       GroupID ,       Description )

 

C#
ITerrainThreatDome6 CreateThreatDome(       IPosition6 Position,       double Range,       double AngularStep,       double RadialStep,       double Direction,       double HorizontalFOV,       double ElevationAngle,       object Color = -16711936,       int GroupID = 0,       string Description = "")

 

C++
HRESULT CreateThreatDome(       IPosition6* Position,       double Range,       double AngularStep,       double RadialStep,       double Direction,       double HorizontalFOV,       double ElevationAngle,       VARIANT Color,       LONG_PTR GroupID,       BSTR Description,       ITerrainThreatDome6** pITerrainThreatDome6)

 

Parameters:

Position

An IPosition6 representing the position of the threat dome, defined by its coordinates in the  3D world.

Range

The detection range of the radar station.

AngularStep

The space between each sampling ray in degrees. The smaller the ray spacing, the more accurate the measurement, but the longer it takes to calculate.

RadialStep

This value represents the distance between sample points along each ray. The smaller the sample interval, the more accurate the measurement, but the longer it takes to calculate.

Direction

The object direction. An angle between 0º and 360º, where 0º is North and 180º is South.

HorizontalFOV

Value in degrees, representing the scan field of the threat dome.

ElevationAngle

The angle from the terrain, below which, the position point cannot see. An elevation angle of zero creates a complete half sphere, while an angle of 30º degrees creates an inverted cone, topped by a dome.

Color

The color of the lines that make up the threat dome. 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.

GroupID

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

Return Value

pITerrainThreatDome6 

An ITerrainThreatDome6 representing the newly created threat dome.

Exceptions

HRESULT can return any of the values listed in the HRESULT Return Values list, as well as the following value:

TE_E_USER_ABORT                 The user has aborted the operation (via the TE user interface)