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.
createThreatDome(position, color, range, angularStep, radialStep, direction, horizontalFOV, elevationAngle, [name]);
|
Parameter |
Description |
|
position |
The position of the object, defined by its coordinates in the 3D world Can be one of the following: SGCoord3D, SGCoord2D, SGPosition |
|
color |
|
|
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 |
|
name |
Optional The node name |
Return Value
An SGNode object. If the method fails, the return value is null. SGWorld.lastError will contain the failure reason.
Remarks
To modify other properties of the threat dome, access the node innerObj. See SGNode.innerObj property for more details.
Unlike a 2D object (e.g., rectangle), a 3D object has volume and cannot be drawn on the terrain surface. Therefore, if specifying the position of a 3D object using SGCoord2D, its height will be set to 0 and its height type will we set to sgHeightRelative.