InterpolatePolygonToMultipatch Method (TerrainLayer)

In This Topic

Creates a surface conforming multipatch by draping a polygon over the surface. This method requires a 3D Analyst license. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Function InterpolatePolygonToMultipatch( _
   ByVal polygon As Polygon, _
   ByVal maximumStripSize As Integer, _
   ByVal pyramidResolution As Double _
) As Multipatch

public Multipatch InterpolatePolygonToMultipatch( 
   Polygon polygon,
   int maximumStripSize,
   double pyramidResolution
)

Parameters

polygon: The polygon to be interpolated.
maximumStripSize: The maximum number of vertices allowed in any triangle strip used in constructing the multipatch. Must be 3 or larger. The recommended range is between 128 and 2048. A reasonable default value is 1024.
pyramidResolution: The z-tolerance or window-size resolution of the terrain pyramid level that will be used. The default is 0, or full resolution.

Return Value

A ArcGIS.Core.Geometry.Multipatch with surface elevation z values.

Exceptions

Exception	Description
System.ArgumentNullException	polygon cannot be null.
System.ArgumentException	polygon cannot be empty.
System.ArgumentException	maximumStripSize must be 3 or larger.
System.ArgumentException	pyramidResolution must be 0 or larger.
MappingException	An exception occurred within the InterpolatePolygonToMultipatch calculation.
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
ArcGIS.Core.Licensing.Exceptions.LicenseException	A 3D Analyst license is required.

Remarks

The polygon has its boundary profiled along the surface. Heights are obtained using linear interpolation by sampling at each input vertex and wherever the boundary line intersects surface triangle edges and nodes. This natural densification captures the full definition of the linear surface using a minimal number of samples. Then, all nodes that fall within the polygon are extracted. The nodes are re-triangulated in a new memory-based TIN, and the 3D polygon boundary is enforced as a clip polygon. The triangles of this new TIN are then extracted in a series of strips that are used to define a multipatch-based geomtry.

Example

Interpolate Polygon To Multipatch

{
  // Note: Needs QueuedTask to run
  // Note: Needs 3d Analyst license to run
  {
    var multipatch = terrainLayer.InterpolatePolygonToMultipatch(polygon, 1024, 0);
    if (multipatch != null)
    {
      // process the output
    }
  }
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.7 or higher.

Reference

TerrainLayer Class
TerrainLayer Members

Send feedback