TerrainAlongLineComputeElevationAngleAboveTerrain Method (Cartographic, Cartographic, TerrainProvider, Double, Double)

Computes the angle from the line of sight between the target and observer positions and the direction to the point on terrain with the highest elevation angle. The angle is determined from the perspective of the position closest to the Shape.

Namespace: AGI.Foundation.Terrain
Assembly: AGI.Foundation.TerrainAnalysis (in AGI.Foundation.TerrainAnalysis.dll) Version: 25.1.421.0 (25.1.421.0)

Syntax

C++

Copy

public static double ComputeElevationAngleAboveTerrain(
	Cartographic observerPosition,
	Cartographic targetPosition,
	TerrainProvider terrainProvider,
	double minimumTerrainHeight,
	double maximumTerrainHeight
)

Public Shared Function ComputeElevationAngleAboveTerrain ( 
	observerPosition As Cartographic,
	targetPosition As Cartographic,
	terrainProvider As TerrainProvider,
	minimumTerrainHeight As Double,
	maximumTerrainHeight As Double
) As Double

public:
static double ComputeElevationAngleAboveTerrain(
	Cartographic observerPosition, 
	Cartographic targetPosition, 
	TerrainProvider^ terrainProvider, 
	double minimumTerrainHeight, 
	double maximumTerrainHeight
)

static member ComputeElevationAngleAboveTerrain : 
        observerPosition : Cartographic * 
        targetPosition : Cartographic * 
        terrainProvider : TerrainProvider * 
        minimumTerrainHeight : float * 
        maximumTerrainHeight : float -> float

Parameters

observerPosition: Type: AGI.Foundation.CoordinatesCartographic
The planetodetic position of the observer object, expressed as a longitude, latitude, and altitude relative to the ellipsoid specified by the Shape property of the terrainProvider.
targetPosition: Type: AGI.Foundation.CoordinatesCartographic
The planetodetic position of the target object, expressed as a longitude, latitude, and altitude relative to the ellipsoid specified by the Shape property of the terrainProvider.
terrainProvider: Type: AGI.Foundation.TerrainTerrainProvider
The terrain provider describing the terrain that is potentially obscuring the path between the two objects.
minimumTerrainHeight: Type: SystemDouble
The minimum height in meters that can be returned by the TerrainProvider's GetHeightRelativeToShape(Double, Double) method. Setting this value lower than necessary will not affect the results, but it will decrease performance. Setting it too high can cause incorrect results. For realistic Earth-based terrain data, DefaultMinimumTerrainHeight is a safe value to use for this parameter.
maximumTerrainHeight: Type: SystemDouble
The maximum height in meters that can be returned by the TerrainProvider's GetHeightRelativeToShape(Double, Double) method. Setting this value higher than necessary will not affect the results, but it will decrease performance. Setting it too low can cause incorrect results. For realistic Earth-based terrain data, DefaultMaximumTerrainHeight is a safe value to use for this parameter.

Return Value

Type: Double
The angle from the line of sight between the target and observer positions and the direction to the point on terrain with the highest elevation angle. The angle is determined from the perspective of the position closest to the Shape. Positive numbers indicate that the line of sight between the objects is not obscured by terrain. Negative numbers indicate that it is obscured.

Exceptions

Exception	Condition
ArgumentNullException	Thrown if terrainProvider is .

Reference

TerrainAlongLine Class

ComputeElevationAngleAboveTerrain Overload

AGI.Foundation.Terrain Namespace

TerrainAlongLineAddLanguageSpecificTextSet("LST20C80D52_0?cpp=::|nu=.");ComputeElevationAngleAboveTerrain Method (Cartographic, Cartographic, TerrainProvider, Double, Double)

Parameters

Return Value

Reference

TerrainAlongLineComputeElevationAngleAboveTerrain Method (Cartographic, Cartographic, TerrainProvider, Double, Double)