CreateEllipse Method

In This Topic

Convenience method to create a new instance of the EllipticArcSegment class. The segment will be an ellipse.

Syntax

C#
Visual Basic (Declaration)

public static EllipticArcSegment CreateEllipse( 
   Coordinate2D centerPt,
   double rotationAngle,
   double semiMajorAxis,
   double minorMajorRatio,
   ArcOrientation orientation,
   SpatialReference spatialReference
)

Public Shared Function CreateEllipse( _
   ByVal centerPt As Coordinate2D, _
   ByVal rotationAngle As Double, _
   ByVal semiMajorAxis As Double, _
   ByVal minorMajorRatio As Double, _
   ByVal orientation As ArcOrientation, _
   Optional ByVal spatialReference As SpatialReference _
) As EllipticArcSegment

Parameters

centerPt: The center point of the ellipse.
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. The absolute value must be <= 1.
orientation: The ellipse orientation, clockwise or counterclockwise.
spatialReference: (Optional) The spatial reference of the ellipse. The default value is null.

Return Value

An EllipticArcSegment

Exceptions

Exception	Description
System.ArgumentException	rotationAngle, semiMajorAxis or minorMajorRatio is NaN.
System.ArgumentException	An elliptic arc construction operation was given invalid axes. The absolute value of minorMajorRatio is > 1.
System.ArgumentException	centerPt is empty.

Remarks

If is equal to one, then a circular arc will be created and the rotation angle will be equal to zero.

Example

Construct an Ellipse

// Construct an ellipse centered at (1, 2) with rotationAngle = -pi/6,  
// semiMajorAxis = 5, minorMajorRatio = 0.2, oriented clockwise.
// Use a builderEx convenience method or use a builderEx constructor.

Coordinate2D centerPt = new Coordinate2D(1, 2);

// BuilderEx convenience methods don't need to run on the MCT.
EllipticArcSegment ellipse = EllipticArcBuilderEx.CreateEllipse(centerPt, -1 * Math.PI / 6, 5, 0.2, ArcOrientation.ArcClockwise);

// This EllipticArcBuilderEx constructor doesn't need to run on the MCT.
EllipticArcBuilderEx builder = new EllipticArcBuilderEx(centerPt, -1 * Math.PI / 6, 5, 0.2, ArcOrientation.ArcClockwise);
EllipticArcSegment anotherEllipse = builder.ToSegment();

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

EllipticArcBuilderEx Class
EllipticArcBuilderEx Members

Send feedback