Click or drag to resize

TerrainAlongLineComputePositionWithMaximumElevationAngle Method (Cartographic, Cartographic, TerrainProvider, Double, Double)

Computes the point on terrain with the highest elevation angle between the observer and target positions from the perspective of the position closest to the Shape.

Namespace:  AGI.Foundation.Terrain
Assembly:  AGI.Foundation.TerrainAnalysis (in AGI.Foundation.TerrainAnalysis.dll) Version: 24.3.420.0 (24.3.420.0)
Syntax
public static Cartesian ComputePositionWithMaximumElevationAngle(
	Cartographic observerPosition,
	Cartographic targetPosition,
	TerrainProvider terrainProvider,
	double minimumTerrainHeight,
	double maximumTerrainHeight
)

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: Cartesian
The point on terrain with the highest elevation angle between the observer and target positions from the perspective of the position closest to the Shape.
Exceptions
ExceptionCondition
ArgumentNullExceptionThrown if terrainProvider is .
See Also