A multipart linear shape.
Polyline geometries represent the shape and location of linear features, such as a street in a road network, a contour line representing an elevation value, or a hiking trail. A polyline can be used to define geometry for features and graphics, or as input or output for tasks or geoprocessing operations, such as the output of a network trace.
A polyline can be used as the geometry of an AGSFeature
or AGSGraphic
. To obtain the geometry on these objects, use AGSGeoElement::geometry
.
A polyline is composed of a series of connected segments, where each AGSSegment
defines a continuous line between a start and an end point. You can define a new polyline from a collection of AGSPoint
objects to create a series of straight AGSLineSegment
objects connecting the points you specified. You can use AGSPolylineBuilder
to build a polyline one point at a time, or to modify an existing polyline.
A polyline can have multiple parts. Each part is a series of connected segments, but the parts can be disjoint, for example, a polyline representing a street that ends, and starts again a block later. Parts can also intersect at one or more points (or vertices), for example, a polyline representing a river and its tributaries.
Polylines inherit from AGSMultipart
, which provides members for iterating the segments and points of each part in a polyline.
Polylines are based upon the parent AGSGeometry
class which is immutable, meaning you can not change its shape once it is created. If you need to modify a polyline once it has been created, use the AGSPolylineBuilder
class.
- Since
- 100
- Note
- This class represents an immutable polyline geometry, it cannot be modified after being created. Use
toBuilder (AGSPolyline):
to get a polyline builder using a copy of this geometry as a starting off point. The builder can then be modified to produce a new geometry.
- See also
AGSPolylineBuilder
to construct or modify polylines programmatically.
-
AGSSketchEditor
to construct or modify geometries interactively by sketching on a map.
-
AGSGeometryEngine
to perform operations on geometries.
|
readnonatomicassigninherited |
YES
if this geometry contains curve segments, NO
otherwise.
The ArcGIS Platform supports polygon and polyline geometries that contain curve segments (where AGSSegment::curve
is YES
, sometimes known as true curves or nonlinear segments). Curves may be present in certain types of data - for example Mobile Map Packages (MMPK) or geometry JSON. When connecting to ArcGIS feature services that support curves (AGSArcGISFeatureServiceInfo::supportsTrueCurve
), ArcGIS Runtime retrieves densified versions of curve feature geometries by default.
If a polygon or polyline geometry contains curve segments, this property is YES
. Prior to v100.12, it was not possible to access curve segments, and only AGSLineSegment
instances would be returned when iterating through the segments in an AGSPolygon
or AGSPolyline
object, irrespective of this property.
From v100.12, you can use curve segments when using an AGSMultipartBuilder
to create or edit polygon and polyline geometries, and also get curve segments when iterating through the segments of existing AGSMultipart
geometries when this property returns YES
. You can also choose to return true curves from feature services by using AGSArcGISRuntimeEnvironment::serviceCurveGeometryMode
.
- See also
AGSGeometryBuilder::hasCurves
, AGSPart::hasCurves
, AGSSegment::curve
, AGSCubicBezierSegment
, AGSEllipticArcSegment
- Since
- 100