CreateCircularArc(MapPoint,MapPoint,Coordinate2D,SpatialReference) Method

In This Topic

Convenience method to create a new instance of the EllipticArcSegment class. The segment will be a circular arc built from three points.

Syntax

Visual Basic (Declaration)
C#

Public Overloads Shared Function CreateCircularArc( _
   ByVal startPt As MapPoint, _
   ByVal endPt As MapPoint, _
   ByVal interiorPt As Coordinate2D, _
   Optional ByVal spatialReference As SpatialReference _
) As EllipticArcSegment

public static EllipticArcSegment CreateCircularArc( 
   MapPoint startPt,
   MapPoint endPt,
   Coordinate2D interiorPt,
   SpatialReference spatialReference
)

Parameters

startPt: The point from which the arc starts.
endPt: The point to which the arc ends.
interiorPt: An interior point on the arc.
spatialReference: (Optional) The spatial reference. The default value is null. The spatial references of the start and end points are ignored.

Return Value

An EllipticArcSegment

Exceptions

Exception	Description
System.ArgumentNullException	startPt or endPt is null or empty.

Remarks

If the start and end points are equal, the elliptic arc will degenerate to a point. To create a circle, use CreateCircle

Example

Construct a Circular Arc - using an interior point

{
  // Construct a circular arc from (2, 1) to (1, 2) with interior pt (1 + sqrt(2)/2, 1 + sqrt(2)/2).
  // Use a builderEx convenience method or use a builderEx constructor.

  MapPoint fromPtCircArc = MapPointBuilderEx.CreateMapPoint(2, 1);
  MapPoint toPtCircArc = MapPointBuilderEx.CreateMapPoint(1, 2);
  Coordinate2D interiorPtNew = new Coordinate2D(1 + Math.Sqrt(2) / 2, 1 + Math.Sqrt(2) / 2);

  // BuilderEx convenience methods don't need to run on the MCT.
  EllipticArcSegment circularArcBuilder = EllipticArcBuilderEx.CreateCircularArc(fromPtCircArc, toPtCircArc, interiorPtNew);

  // BuilderEx constructors don't need to run on the MCT.
  EllipticArcBuilderEx eab = new EllipticArcBuilderEx(fromPtCircArc, toPtCircArc, interiorPtNew);
  // do something with the builder

  EllipticArcSegment anotherCircularArc = eab.ToSegment();
}

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

EllipticArcBuilderEx Class
EllipticArcBuilderEx Members
Overload List

Send feedback