TerrainAlongLineComputeTerrainIntersection Method (Cartesian, Cartographic, UnitCartesian, Double, Double, TerrainProvider)

Computes the location of the first intersection with terrain from the provided location along the indicated direction. Both Cartesian and Cartographic representations of the location are provided which eliminates the need for conversion within the algorithm and results in greater efficiency. The DefaultMinimumTerrainHeight and DefaultMaximumTerrainHeight are used for the computation.

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

Syntax

C++

Copy

public static Cartographic? ComputeTerrainIntersection(
	Cartesian cartesian,
	Cartographic cartographic,
	UnitCartesian direction,
	double granularity,
	double maximumDistance,
	TerrainProvider terrainProvider
)

Public Shared Function ComputeTerrainIntersection ( 
	cartesian As Cartesian,
	cartographic As Cartographic,
	direction As UnitCartesian,
	granularity As Double,
	maximumDistance As Double,
	terrainProvider As TerrainProvider
) As Cartographic?

public:
static Nullable<Cartographic> ComputeTerrainIntersection(
	Cartesian cartesian, 
	Cartographic cartographic, 
	UnitCartesian direction, 
	double granularity, 
	double maximumDistance, 
	TerrainProvider^ terrainProvider
)

static member ComputeTerrainIntersection : 
        cartesian : Cartesian * 
        cartographic : Cartographic * 
        direction : UnitCartesian * 
        granularity : float * 
        maximumDistance : float * 
        terrainProvider : TerrainProvider -> Nullable<Cartographic>

Parameters

cartesian: Type: AGI.Foundation.CoordinatesCartesian
The Cartesian representation of the location expressed in the reference frame fixed to the ellipsoid specified by the Shape property of the terrainProvider.
cartographic: Type: AGI.Foundation.CoordinatesCartographic
The planetodetic cartographic representation of the location expressed in the reference frame fixed to the ellipsoid specified by the Shape property of the terrainProvider.
direction: Type: AGI.Foundation.CoordinatesUnitCartesian
The direction along which to check for intersection with terrain.
granularity: Type: SystemDouble
The sampling step as a positively valued fraction of the terrain resolution.
maximumDistance: Type: SystemDouble
A positively valued limit on the distance in meters along the indicated direction at which intersection with terrain is no longer checked.
terrainProvider: Type: AGI.Foundation.TerrainTerrainProvider
The terrain provider describing the terrain that is potentially obscuring the path between the two objects.

Return Value

Type: NullableCartographic
The planetodetic location of intersection with terrain expressed in the reference frame fixed to the ellipsoid specified by the Shape property of the terrainProvider or null if no intersection exists. The provided location may be returned as the point of intersection if it lies on the terrain surface and the indicated direction is directly into the terrain surface.

Exceptions

Exception	Condition
ArgumentNullException	Thrown if terrainProvider is .

Reference

TerrainAlongLine Class

ComputeTerrainIntersection Overload

AGI.Foundation.Terrain Namespace

TerrainAlongLineAddLanguageSpecificTextSet("LST3FF49B0E_0?cpp=::|nu=.");ComputeTerrainIntersection Method (Cartesian, Cartographic, UnitCartesian, Double, Double, TerrainProvider)

Parameters

Return Value

Reference

TerrainAlongLineComputeTerrainIntersection Method (Cartesian, Cartographic, UnitCartesian, Double, Double, TerrainProvider)