This document is archived and information here might be outdated.  Recommended version.


ITinSurface3.QueryLocateWithinDistance Method (ArcObjects .NET 10.6 SDK)
ArcObjects Library Reference (GeoDatabase)  

ITinSurface3.QueryLocateWithinDistance Method

Returns the intersections of the query ray and the TIN.

[Visual Basic .NET]
Public Sub QueryLocateWithinDistance ( _
    ByVal pRay As IRay, _
    ByVal maxDistance As Double, _
    ByVal pLocations As IGeometry _
)
[C#]
public void QueryLocateWithinDistance (
    IRay pRay,
    double maxDistance,
    IGeometry pLocations
);
[C++]
HRESULT QueryLocateWithinDistance(
  IRay* pRay,
  double maxDistance,
  IGeometry* pLocations
);
[C++]

Parameters pRay [in]
pRay is a parameter of type IRay* maxDistance [in]
maxDistance is a parameter of type double pLocations
pLocations is a parameter of type IGeometry*

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Description

Finds the points of intersection between a ray and the surface. Can return either the first point of intersection or all intersections. The search for intersections can also be constrained by distance.

pRay is the ray for which intersections will be calculated.

maxDistance is the 3D search distance along the ray that acts as a constraint. No intersections will be returned beyond this distance. Pass a negative value to turn the constraint off and search as far as possible (i.e., to the edge of the surface).

pLocations is either a point or multipoint. This must be instantiated before calling the method. Pass a point if you want only the first intersction. Use a multipoint to collect multiple intersections. If multiple intersections are found they will be placed in sorted order from first to last in the multipoint. If there is no intersection, either because the ray does not intersect the surface or doesn't intersect within the maxDistance, the output will be set to empty.

Notes:

 

See Also

ITinSurface3 Interface