ArcGIS Runtime SDK for iOS
100.15
|
An elliptic arc segment for use in a multipart geometry.
An elliptic arc is the portion of the boundary of a 2D ellipse that connects two points.
Instance Methods | |
(nullable instancetype) | - initWithCenterPoint:rotationAngle:semiMajorAxis:minorMajorRatio:startAngle:centralAngle:spatialReference: |
(nullable instancetype) | - initWithStartPoint:endPoint:rotationAngle:isMinor:isCounterClockwise:semiMajorAxis:minorMajorRatio:spatialReference: |
(BOOL) | - isEqualToSegment: |
Properties | |
AGSPoint * | centerPoint |
double | centralAngle |
BOOL | circular |
BOOL | closed |
BOOL | counterClockwise |
BOOL | curve |
double | endAngle |
AGSPoint * | endPoint |
double | minorMajorRatio |
double | rotationAngle |
double | semiMajorAxis |
double | semiMinorAxis |
AGSSpatialReference * | spatialReference |
double | startAngle |
AGSPoint * | startPoint |
+ (nullable AGSEllipticArcSegment *) createCircularEllipticArcWithCenterPoint: | (AGSPoint *) | centerPoint | |
radius: | (double) | radius | |
startAngle: | (double) | startAngle | |
centralAngle: | (double) | centralAngle | |
spatialReference: | (nullable AGSSpatialReference *) | spatialReference | |
Creates an AGSEllipticArcSegment
that is a partial circle shape from the center point and radius of the embedded circle, and the start and central angle around that circle.
The z-value and m-value of the center point (if present) are ignored. Use createCircularEllipticArcWithStartPoint:endPoint:interiorPoint:spatialReference:
to create a circular AGSEllipticArcSegment
with end points with z-value and/or m-value.
centerPoint | The center point of the embedded circle. |
radius | The distance from the center of the embedded circle to its perimeter. |
startAngle | The parametric angle in radians of the start of the arc relative to the major axis of the embedded ellipse. |
centralAngle | The parametric angle in radians measuring the span of the arc from AGSEllipticArcSegment::startAngle to AGSEllipticArcSegment::endAngle . |
spatialReference | The spatial reference of the new segment. |
AGSEllipticArcSegment
with the given center point, radius, start and central angles, and spatial reference, where AGSEllipticArcSegment::circular
is YES
. + (nullable AGSEllipticArcSegment *) createCircularEllipticArcWithStartPoint: | (AGSPoint *) | startPoint | |
endPoint: | (AGSPoint *) | endPoint | |
interiorPoint: | (AGSPoint *) | interiorPoint | |
spatialReference: | (nullable AGSSpatialReference *) | spatialReference | |
Creates an AGSEllipticArcSegment
from start, end, and interior points that is a partial circle shape.
The z-value and m-value of the start and end points (if present) are used in the circular AGSEllipticArcSegment
. The z-value and m-value of the interior point (if present) are ignored.
startPoint | The start point of the segment. |
endPoint | The end point of the segment. |
interiorPoint | A point along the circular arc, between the start and end points. |
spatialReference | The spatial reference of the new segment. |
AGSEllipticArcSegment
with the given start, through and end point, and spatial reference, where AGSEllipticArcSegment::circular
is YES
. + (nullable instancetype) ellipticArcSegmentWithCenterPoint: | (AGSPoint *) | centerPoint | |
rotationAngle: | (double) | rotationAngle | |
semiMajorAxis: | (double) | semiMajorAxis | |
minorMajorRatio: | (double) | minorMajorRatio | |
startAngle: | (double) | startAngle | |
centralAngle: | (double) | centralAngle | |
spatialReference: | (nullable AGSSpatialReference *) | spatialReference | |
Creates an elliptic arc based on parameters that define an ellipse and the portion of that ellipse that defines the arc.
The spatial reference parameter is used if the center point parameter has a nil
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 initWithStartPoint:endPoint:rotationAngle:isMinor:isCounterClockwise:semiMajorAxis:minorMajorRatio:spatialReference:
to create an AGSEllipticArcSegment
with end points with z-value and/or m-value.
centerPoint | The center point of the embedded ellipse. |
rotationAngle | The angle in radians by which the major axis of the embedded ellipse is rotated from the x-axis. |
semiMajorAxis | The length of the semi-major axis of the embedded ellipse in the units of the spatial reference. |
minorMajorRatio | The ratio of the length of the semi-minor axis to the length of the semi-major axis of the embedded ellipse. |
startAngle | The parametric angle in radians of the start of the arc relative to the major axis of the embedded ellipse. |
centralAngle | The parametric angle in radians measuring the span of the arc from AGSEllipticArcSegment::startAngle to AGSEllipticArcSegment::endAngle . |
spatialReference | A spatial reference to use for the segment if the center point parameter does not have a spatial reference set. |
+ (nullable instancetype) ellipticArcSegmentWithStartPoint: | (AGSPoint *) | startPoint | |
endPoint: | (AGSPoint *) | endPoint | |
rotationAngle: | (double) | rotationAngle | |
isMinor: | (BOOL) | isMinor | |
isCounterClockwise: | (BOOL) | isCounterClockwise | |
semiMajorAxis: | (double) | semiMajorAxis | |
minorMajorRatio: | (double) | minorMajorRatio | |
spatialReference: | (nullable AGSSpatialReference *) | spatialReference | |
Creates an elliptic arc segment from the given start and end points, and other parameters that define an ellipse.
The z-value and m-value of the start and end points (if present) are used in the AGSEllipticArcSegment
.
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 returned.
startPoint | The start point of the segment. |
endPoint | The end point of the segment. |
rotationAngle | The angle in radians by which the major axis of the embedded ellipse is rotated from the x-axis. |
isMinor | YES if AGSEllipticArcSegment::centralAngle of the segment is less than PI. |
isCounterClockwise | YES if the direction of the segment, from start point to end point, proceeds in a counterclockwise direction, otherwise NO . |
semiMajorAxis | The length of the semi-major axis of the embedded ellipse in the units of the spatial reference. |
minorMajorRatio | The ratio of the length of the semi-minor axis to the length of the semi-major axis of the embedded ellipse. |
spatialReference | A spatial reference to use for the segment if the points do not have spatial references set. |
- (nullable instancetype) initWithCenterPoint: | (AGSPoint *) | centerPoint | |
rotationAngle: | (double) | rotationAngle | |
semiMajorAxis: | (double) | semiMajorAxis | |
minorMajorRatio: | (double) | minorMajorRatio | |
startAngle: | (double) | startAngle | |
centralAngle: | (double) | centralAngle | |
spatialReference: | (nullable AGSSpatialReference *) | spatialReference | |
Creates an elliptic arc based on parameters that define an ellipse and the portion of that ellipse that defines the arc.
The spatial reference parameter is used if the center point parameter has a nil
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 initWithStartPoint:endPoint:rotationAngle:isMinor:isCounterClockwise:semiMajorAxis:minorMajorRatio:spatialReference:
to create an AGSEllipticArcSegment
with end points with z-value and/or m-value.
centerPoint | The center point of the embedded ellipse. |
rotationAngle | The angle in radians by which the major axis of the embedded ellipse is rotated from the x-axis. |
semiMajorAxis | The length of the semi-major axis of the embedded ellipse in the units of the spatial reference. |
minorMajorRatio | The ratio of the length of the semi-minor axis to the length of the semi-major axis of the embedded ellipse. |
startAngle | The parametric angle in radians of the start of the arc relative to the major axis of the embedded ellipse. |
centralAngle | The parametric angle in radians measuring the span of the arc from AGSEllipticArcSegment::startAngle to AGSEllipticArcSegment::endAngle . |
spatialReference | A spatial reference to use for the segment if the center point parameter does not have a spatial reference set. |
- (nullable instancetype) initWithStartPoint: | (AGSPoint *) | startPoint | |
endPoint: | (AGSPoint *) | endPoint | |
rotationAngle: | (double) | rotationAngle | |
isMinor: | (BOOL) | isMinor | |
isCounterClockwise: | (BOOL) | isCounterClockwise | |
semiMajorAxis: | (double) | semiMajorAxis | |
minorMajorRatio: | (double) | minorMajorRatio | |
spatialReference: | (nullable AGSSpatialReference *) | spatialReference | |
Creates an elliptic arc segment from the given start and end points, and other parameters that define an ellipse.
The z-value and m-value of the start and end points (if present) are used in the AGSEllipticArcSegment
.
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 returned.
startPoint | The start point of the segment. |
endPoint | The end point of the segment. |
rotationAngle | The angle in radians by which the major axis of the embedded ellipse is rotated from the x-axis. |
isMinor | YES if AGSEllipticArcSegment::centralAngle of the segment is less than PI. |
isCounterClockwise | YES if the direction of the segment, from start point to end point, proceeds in a counterclockwise direction, otherwise NO . |
semiMajorAxis | The length of the semi-major axis of the embedded ellipse. |
minorMajorRatio | The ratio of the length of the semi-minor axis to the length of the semi-major axis of the embedded ellipse. |
spatialReference | A spatial reference to use for the segment if the points do not have spatial references set. |
- (BOOL) isEqualToSegment: | (AGSSegment *) | other |
Determines whether or not two time segments are equal.
other | The segment to compare the current segment with. |
|
readnonatomicstrong |
The center point of the ellipse that this segment is defined upon.
|
readnonatomicassign |
The parametric angle in radians measuring the span of the arc from AGSEllipticArcSegment::startAngle
to AGSEllipticArcSegment::endAngle
.
A positive value corresponds to a counterclockwise arc sweep.
This value is always between -2 * PI and 2 * PI, these limits indicating this arc forms a complete ellipse in either clockwise or counterclockwise direction.
|
readnonatomicassign |
Indicates if this arc is a portion of the boundary of a 2D circle.
An elliptic arc is circular if the ellipse upon which it is based is a circle, meaning the lengths of its major and minor axes are equal.
Use createCircularEllipticArcWithCenterPoint:radius:startAngle:centralAngle:spatialReference:
and createCircularEllipticArcWithStartPoint:endPoint:interiorPoint:spatialReference:
to create circular arcs.
|
readnonatomicassigninherited |
Determines whether the segment is closed or not.
|
readnonatomicassign |
Indicates if the direction of the segment, from start point to end point, proceeds in a counterclockwise direction.
|
readnonatomicassigninherited |
NO
if the object is an AGSLineSegment
, YES
otherwise.
Prior to v100.12, only AGSLineSegment
instances were supported when creating new geometries using an AGSMultipartBuilder
or iterating the AGSSegment
instances in an existing AGSMultipart
geometry.
From v100.12, you can add curve segments (AGSCubicBezierSegment
, AGSEllipticArcSegment
) when using an AGSMultipartBuilder
, and get them back from an existing AGSMultipart
geometry when AGSGeometry::hasCurves
is YES
.
AGSGeometryBuilder::hasCurves
, AGSMutablePart::hasCurves
, AGSCubicBezierSegment
, AGSEllipticArcSegment
|
readnonatomicassign |
The parametric angle in radians of the end of the arc relative to the major axis of the embedded ellipse.
A positive value corresponds to a counterclockwise rotation from the major axis.
|
readnonatomicstronginherited |
The end point of the segment.
|
readnonatomicassign |
The ratio of the length of the semi-minor axis to the semi-major axis.
|
readnonatomicassign |
The angle in radians by which the major axis of the ellipse this segment is based upon is rotated from the x-axis.
|
readnonatomicassign |
The length of the longer of the two axes of the ellipse upon which this arc is based.
The semi-major axis always lies on the line between 0 and PI radians.
The length is in the units of the spatial reference.
|
readnonatomicassign |
The length of the shorter of the two axes of the ellipse upon which this arc is based.
The semi-minor axis always lies on the line between PI / 2 and 3 * PI / 2 radians.
The length is in the units of the spatial reference.
|
readnonatomicstronginherited |
The spatial reference of the segment.
|
readnonatomicassign |
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.
|
readnonatomicstronginherited |
The start point of the segment.