require(["esri/geometry/operators/extendOperator"], (extendOperator) => { /* code goes here */ });
import * as extendOperator from "@arcgis/core/geometry/operators/extendOperator.js";
esri/geometry/operators/extendOperator
Extend 2D polylines with a polyline.
By default, this considers both ends of parts. The old ends remain and new points are added at the extended ends. The new points have attributes that are extrapolated from adjacent existing segments.
Method Overview
Name | Return Type | Summary | Object |
---|---|---|---|
Performs the extend operation on a polyline using a polyline as the extender. | extendOperator |
Method Details
-
Performs the extend operation on a polyline using a polyline as the extender.
ParametersSpecificationpolyline1 PolylineThe polyline to be extended.
polyline2 PolylineThe polyline to extend to.
options ObjectoptionalAdditional options.
SpecificationrelocateEnds BooleanoptionalIf an extension is performed at an end, relocate the end point to the new position instead of leaving the old point and adding a new point at the new position.
keepEndAttributes BooleanoptionalIf an extension is performed at an end, do not extrapolate the end-segment's attributes for the new point. Instead, make its attributes the same as the current end. Incompatible with
noEndAttributes
.noEndAttributes BooleanoptionalIf an extension is performed at an end, do not extrapolate the end-segment's attributes for the new point. Instead, make its attributes empty. Incompatible with
keepEndAttributes
.noExtendAtFrom BooleanoptionalDo not extend the 'from' end of any part.
noExtendAtTo BooleanoptionalDo not extend the 'to' end of any part.
ReturnsType Description Polyline | null Returns the extended polyline or null. The output polyline will have the first and last segment of each path extended to polyline2
if the segments can be interpolated to intersect it. In the case that the segments can be extended to multiple segments of the extender,polyline2
, the shortest extension is chosen. Only end points for paths that are not shared by the end points of other paths will be extended. If the polyline cannot be extended, then null is returned.