GetSurfaceLength(Multipart,SurfaceInterpolationMethod) Method

In This Topic

Gets the 3D length of the multipart by interpolating heights from the surface and calculating the sum of 3D distances between the vertices. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public double GetSurfaceLength( 
   Multipart multipart,
   SurfaceInterpolationMethod interpolationMethod
)

Public Overloads Function GetSurfaceLength( _
   ByVal multipart As Multipart, _
   ByVal interpolationMethod As SurfaceInterpolationMethod _
) As Double

Parameters

multipart: The multipart to calculate the 3D length for.
interpolationMethod: The method of interpolation. The default method of interpolation for TINs is SurfaceInterpolationMethod.Linear.

Return Value

the 3D length of the multipart.

Exceptions

Exception	Description
System.ArgumentNullException	multipart is null.
MappingException	An exception occurred within the GetSurfaceLength calculation.
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

Remarks

Portions of the multipart falling outside the interpolation zone are excluded from the calculation.

See also GetSurfaceLength(Multipart,SurfaceInterpolationMethod,Double,Double) if you wish to specify specific values for densification of the geometry before interpolation occurs depending upon your interpolation method.

Example

Get 3D length of multipart by interpolating heights

var tinLayer = MapView.Active.Map.GetLayersAsFlattenedList().OfType<TinLayer>().FirstOrDefault();
await QueuedTask.Run(() =>
{
  // interpolate heights and calculate the sum of 3D distances between the vertices
  double length3d = tinLayer.GetSurfaceLength(polygon, SurfaceInterpolationMethod.NaturalNeighbor);

  // or use a different interpolation method
  length3d = tinLayer.GetSurfaceLength(polyline, SurfaceInterpolationMethod.NaturalNeighborZNearest);


  // densify the shape before interpolating
  length3d = tinLayer.GetSurfaceLength(polygon, SurfaceInterpolationMethod.NaturalNeighbor, 0.01, 0);
});

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3.4 or higher.

Reference

TinLayer Class
TinLayer Members
Overload List

Send feedback