Show / Hide Table of Contents

Constructor EllipticArcSegment

EllipticArcSegment(MapPoint, Double, Double, Double, Double, Double, SpatialReference)

Initializes a new instance of the EllipticArcSegment class based on parameters that define an ellipse and the portion of that ellipse that defines the arc.

Declaration
public EllipticArcSegment(MapPoint centerPoint, double rotationAngle, double semiMajorAxis, double minorMajorRatio, double startAngle, double centralAngle, SpatialReference spatialReference)
Parameters
Type Name Description
MapPoint centerPoint

The center point of the embedded ellipse.

System.Double rotationAngle

The angle in radians by which the major axis of the embedded ellipse is rotated from the x-axis. A positive value corresponds to a counterclockwise rotation from the x-axis. The value is taken in the form of the modulo of 2 * PI (360 degrees). For example, an input rotation angle of 7.5 radians (430 degrees) would return a segment with a rotation angle of 1.22 radians (70 degrees).

System.Double semiMajorAxis

The length of the semi-major axis of the embedded ellipse in the units of the spatial reference.

System.Double minorMajorRatio

The ratio of the length of the semi-minor axis to the length of the semi-major axis of the embedded ellipse.

System.Double startAngle

The parametric angle in radians of the start of the arc relative to the major axis of the embedded ellipse. A positive value corresponds to a counterclockwise rotation from the major axis. The value is taken in the form of the modulo of 2 * PI (360 degrees). For example, an input rotation angle of 7.5 radians (430 degrees) would return a segment with a rotation angle of 1.22 radians (70 degrees).

System.Double centralAngle

The parametric angle in radians measuring the span of the arc from startAngle to EndAngle. A positive value corresponds to a counterclockwise arc sweep. Values larger than 2 * PI (360 degrees) return a segment with a central angle of exactly 2 * PI (360 degrees), resulting in a full ellipse where the start and end points are identical.

SpatialReference spatialReference

A spatial reference to use for the segment if the center point parameter does not have a spatial reference set.

Remarks

The spatial reference parameter is used if the center point parameter has a null spatial reference. If both spatial references are supplied, they must be equal.

The z-value and m-value of the center point (if present) are ignored. Use EllipticArcSegment(MapPoint, MapPoint, Double, Boolean, Boolean, Double, Double, SpatialReference) to create an EllipticArcSegment with end points with a z-value and/or m-value.

Exceptions
Type Condition
System.ArgumentException

Indicates that the spatial reference objects supplied (as a parameter or as a property of the center point parameter, that are not null), are not equal.

Applies to

Platforms and versions
TargetVersions
.NET Standard 2.0100.12 - 200.7
.NET100.13 - 200.7
.NET Windows100.13 - 200.7
.NET Android200.0 - 200.7
.NET iOS200.0 - 200.7
.NET Framework100.12 - 200.7
Xamarin.Android100.12 - 100.15
Xamarin.iOS100.12 - 100.15
UWP100.12 - 200.7

EllipticArcSegment(MapPoint, MapPoint, Double, Boolean, Boolean, Double, Double, SpatialReference)

Initializes a new instance of the EllipticArcSegment class from the given start and end points, and other parameters that define an ellipse.

Declaration
public EllipticArcSegment(MapPoint startPoint, MapPoint endPoint, double rotationAngle, bool isMinor, bool isCounterClockwise, double semiMajorAxis, double minorMajorRatio, SpatialReference spatialReference)
Parameters
Type Name Description
MapPoint startPoint

The start point of the segment.

MapPoint endPoint

The end point of the segment.

System.Double rotationAngle

The angle in radians by which the major axis of the embedded ellipse is rotated from the x-axis. A positive value corresponds to a counterclockwise rotation from the x-axis.

System.Boolean isMinor

true if CentralAngle of the segment is less than PI.

System.Boolean isCounterClockwise

true if the direction of the segment, from start point to end point, proceeds in a counterclockwise direction, otherwise false.

System.Double semiMajorAxis

The length of the semi-major axis of the embedded ellipse in the units of the spatial reference.

System.Double minorMajorRatio

The ratio of the length of the semi-minor axis to the length of the semi-major axis of the embedded ellipse.

SpatialReference spatialReference

A spatial reference to use for the segment if the points do not have spatial references set.

Remarks

The z-value and m-value of the start and end points (if present) are used in the EllipticArcSegment.

To maintain the given startPoint and endPoint in the new segment, the other parameters may be adjusted if required. Such adjustments are made according to the Scalable Vector Graphics 1.1 Specification, Appendix F.6.5. If these cannot be adjusted sufficiently, an arc represented with a straight line is created.

Exceptions
Type Condition
System.ArgumentException

Indicates that the spatial reference objects supplied (as a parameter or as a property of the center point parameter, that are not null), are not equal.

Applies to

Platforms and versions
TargetVersions
.NET Standard 2.0100.12 - 200.7
.NET100.13 - 200.7
.NET Windows100.13 - 200.7
.NET Android200.0 - 200.7
.NET iOS200.0 - 200.7
.NET Framework100.12 - 200.7
Xamarin.Android100.12 - 100.15
Xamarin.iOS100.12 - 100.15
UWP100.12 - 200.7
In This Article
Back to top Copyright © 2022 Esri.