GetSubCurve Method—ArcGIS Pro

Gets the subcurve of the input multipart between fromDistance and toDistance.

Syntax

C#
Visual Basic (Declaration)

public Polyline GetSubCurve( 
   Multipart multipart,
   double fromDistance,
   double toDistance,
   AsRatioOrLength asRatioOrLength
)

Public Function GetSubCurve( _
   ByVal multipart As Multipart, _
   ByVal fromDistance As Double, _
   ByVal toDistance As Double, _
   ByVal asRatioOrLength As AsRatioOrLength _
) As Polyline

Parameters

multipart: The multipart from which the subcurve will be extracted.
fromDistance: The distance along the multipart to start the subcurve.
toDistance: The distance along the multipart to end the subcurve.
asRatioOrLength: Indicates whether the fromDistance and toDistance are given as lengths or ratios along the multipart.

Return Value

The polyline representing the subcurve.

Exceptions

Exception	Description
System.ArgumentNullException	Multipart is null or empty.

Example

SpatialReference sr = SpatialReferences.WGS84;

List<Coordinate2D> coords = new List<Coordinate2D>()
{
  new Coordinate2D(-111, 72),
  new Coordinate2D(-108, 68),
  new Coordinate2D(-114, 68)
};

Polyline polyline = PolylineBuilder.CreatePolyline(coords, sr);

Polyline subCurve = GeometryEngine.Instance.GetSubCurve(polyline, 0, 5, AsRatioOrLength.AsLength);
// subCurve.PartCount = 1
// subCurve.PointCount = 2

ReadOnlyPointCollection points = subCurve.Points;
// points[0] = -111, 72
// points[1] = -108, 68

subCurve = GeometryEngine.Instance.GetSubCurve(polyline, 0, 0.5, AsRatioOrLength.AsRatio);
// subCurve.PointCount = 3

points = subCurve.Points;
// points[0] = -111, 72
// points[1] = -108, 68
// points[2] = -108.5, 68


List<Coordinate3D> coords3D = new List<Coordinate3D>()
{
  new Coordinate3D(0, 0, 0),
  new Coordinate3D(0, 1, 1),
  new Coordinate3D(1, 1, 2),
  new Coordinate3D(1, 0, 3)
};

Polygon polygon = PolygonBuilder.CreatePolygon(coords3D, sr);

subCurve = GeometryEngine.Instance.GetSubCurve3D(polygon, 0, 1, AsRatioOrLength.AsLength);
// subCurve.HasZ = true

points = subCurve.Points;
// points.Count = 2
// points[0] = 0, 0, 0
// points[1] = 0, 0.70710678118654746, 0.70710678118654746

Requirements

Target Platforms: Windows 10, Windows 8.1

Reference

GeometryEngine Class
GeometryEngine Members