DensifyByLength Method (GeometryEngine)

In This Topic

Densifies the specified geometry.

Syntax

Visual Basic (Declaration)
C#

Public Function DensifyByLength( _
   ByVal geometry As Geometry, _
   ByVal maxSegmentLength As Double _
) As Geometry

public Geometry DensifyByLength( 
   Geometry geometry,
   double maxSegmentLength
)

Parameters

geometry: The geometry to be densified.
maxSegmentLength: The maximum segment length allowed in the output geometry.

Return Value

Returns the densified geometry. If the input geometry is empty, then it is returned unchanged.

Exceptions

Exception	Description
System.ArgumentNullException	Geometry is null.
System.NotImplementedException	The method is not implemented for GeometryBag or Multipatch.
System.ArgumentNullException	Geometry is null.

Remarks

The densify operation adds vertices to the input geometry.

GeometryEngine DensifyByLength

Example

Densify by Length

{
  // densify a line segment
  MapPoint startPt = MapPointBuilderEx.CreateMapPoint(1.0, 1.0);
  MapPoint endPt = MapPointBuilderEx.CreateMapPoint(1, 21);
  LineSegment line = LineBuilderEx.CreateLineSegment(startPt, endPt);
  polyline = PolylineBuilderEx.CreatePolyline(line);

  Geometry geom = GeometryEngine.Instance.DensifyByLength(polyline, 2);
  Polyline result = geom as Polyline;

  // densify a circular arc
  MapPoint fromPt = MapPointBuilderEx.CreateMapPoint(2, 1);
  MapPoint toPt = MapPointBuilderEx.CreateMapPoint(1, 2);
  Coordinate2D interiorPt = new(1 + Math.Sqrt(2) / 2, 1 + Math.Sqrt(2) / 2);

  EllipticArcBuilderEx cab = new(fromPt, toPt, interiorPt);
  EllipticArcSegment circularArc = cab.ToSegment();
  polyline = PolylineBuilderEx.CreatePolyline(circularArc);
  geom = GeometryEngine.Instance.DensifyByLength(polyline, 2);
  result = geom as Polyline;
}

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

GeometryEngine Class
GeometryEngine Members

Send feedback