EllipticArcBuilder Constructor(Coordinate2D,Double,Double,Double,Double,Double,SpatialReference)

Builds a new instance of the EllipticArcBuilder class. This method must be called on the MCT. Use QueuedTask.Run

Syntax

C#
Visual Basic (Declaration)

public EllipticArcBuilder( 
   Coordinate2D centerPt,
   double startAngle,
   double centralAngle,
   double rotationAngle,
   double semiMajorAxis,
   double minorMajorRatio,
   SpatialReference spatialReference
)

Public Function New( _
   ByVal centerPt As Coordinate2D, _
   ByVal startAngle As Double, _
   ByVal centralAngle As Double, _
   ByVal rotationAngle As Double, _
   ByVal semiMajorAxis As Double, _
   ByVal minorMajorRatio As Double, _
   Optional ByVal spatialReference As SpatialReference _
)

Parameters

centerPt: The center point of the ellipse.
startAngle: The start angle in radians measured from the rotated x-axis.
centralAngle: The central angle in radians measuring the span of the arc from startAngle to endAngle. A positive value corresponds to counterclockwise orientation.
rotationAngle: The angle in radians by which the ellipse is rotated from the x-axis. A positive value corresponds to counterclockwise rotation.
semiMajorAxis: The length of the semi-major axis.
minorMajorRatio: The ratio of the length of the semi-minor axis to the length of the semi-major axis. Must be < 1.
spatialReference: (Optional) The spatial reference of the arc. The default value is null.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
InvalidParameterException	An elliptic arc construction operation was given invalid axes. The minorMajorRatio should be < 1.

Example

// Construct an elliptic arc centered at (1,1), startAngle = 0, centralAngle = PI/2, 
// rotationAngle = 0, semiMajorAxis = 1, minorMajorRatio = 0.5.
// Use a builder convenience method or use a builder constructor.

Coordinate2D centerPt = new Coordinate2D(1, 1);

// Builder convenience methods don't need to run on the MCT.
EllipticArcSegment circularArc = EllipticArcBuilder.CreateEllipticArcSegment(centerPt, 0, Math.PI / 2, 0, 1, 0.5);

double semiMajor;
double semiMinor;
circularArc.GetAxes(out semiMajor, out semiMinor);
// semiMajor = 1, semiMinor = 0.5

// Builder constructors need to run on the MCT.
ArcGIS.Desktop.Framework.Threading.Tasks.QueuedTask.Run(() =>
{
  using (EllipticArcBuilder cab = new EllipticArcBuilder(centerPt, 0, Math.PI / 2, 0, 1, 0.5))
  {
    // do something with the builder

    EllipticArcSegment otherCircularArc = cab.ToSegment();
  }
});

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

EllipticArcBuilder Class
EllipticArcBuilder Members
Overload List