6f5ed17fc5
This pull requests replaces type check hint assertions with type casts, library sanity check assertions with conditional console.assert statements in debug mode, and runtime sanity checks with assertions that throw an ol.AssertionError with an error code for lookup outside the library.
270 lines
7.7 KiB
JavaScript
270 lines
7.7 KiB
JavaScript
goog.provide('ol.geom.LineString');
|
|
|
|
goog.require('ol');
|
|
goog.require('ol.array');
|
|
goog.require('ol.extent');
|
|
goog.require('ol.geom.GeometryLayout');
|
|
goog.require('ol.geom.GeometryType');
|
|
goog.require('ol.geom.SimpleGeometry');
|
|
goog.require('ol.geom.flat.closest');
|
|
goog.require('ol.geom.flat.deflate');
|
|
goog.require('ol.geom.flat.inflate');
|
|
goog.require('ol.geom.flat.interpolate');
|
|
goog.require('ol.geom.flat.intersectsextent');
|
|
goog.require('ol.geom.flat.length');
|
|
goog.require('ol.geom.flat.segments');
|
|
goog.require('ol.geom.flat.simplify');
|
|
|
|
|
|
/**
|
|
* @classdesc
|
|
* Linestring geometry.
|
|
*
|
|
* @constructor
|
|
* @extends {ol.geom.SimpleGeometry}
|
|
* @param {Array.<ol.Coordinate>} coordinates Coordinates.
|
|
* @param {ol.geom.GeometryLayout=} opt_layout Layout.
|
|
* @api stable
|
|
*/
|
|
ol.geom.LineString = function(coordinates, opt_layout) {
|
|
|
|
ol.geom.SimpleGeometry.call(this);
|
|
|
|
/**
|
|
* @private
|
|
* @type {ol.Coordinate}
|
|
*/
|
|
this.flatMidpoint_ = null;
|
|
|
|
/**
|
|
* @private
|
|
* @type {number}
|
|
*/
|
|
this.flatMidpointRevision_ = -1;
|
|
|
|
/**
|
|
* @private
|
|
* @type {number}
|
|
*/
|
|
this.maxDelta_ = -1;
|
|
|
|
/**
|
|
* @private
|
|
* @type {number}
|
|
*/
|
|
this.maxDeltaRevision_ = -1;
|
|
|
|
this.setCoordinates(coordinates, opt_layout);
|
|
|
|
};
|
|
ol.inherits(ol.geom.LineString, ol.geom.SimpleGeometry);
|
|
|
|
|
|
/**
|
|
* Append the passed coordinate to the coordinates of the linestring.
|
|
* @param {ol.Coordinate} coordinate Coordinate.
|
|
* @api stable
|
|
*/
|
|
ol.geom.LineString.prototype.appendCoordinate = function(coordinate) {
|
|
ol.DEBUG && console.assert(coordinate.length == this.stride,
|
|
'length of coordinate array should match stride');
|
|
if (!this.flatCoordinates) {
|
|
this.flatCoordinates = coordinate.slice();
|
|
} else {
|
|
ol.array.extend(this.flatCoordinates, coordinate);
|
|
}
|
|
this.changed();
|
|
};
|
|
|
|
|
|
/**
|
|
* Make a complete copy of the geometry.
|
|
* @return {!ol.geom.LineString} Clone.
|
|
* @api stable
|
|
*/
|
|
ol.geom.LineString.prototype.clone = function() {
|
|
var lineString = new ol.geom.LineString(null);
|
|
lineString.setFlatCoordinates(this.layout, this.flatCoordinates.slice());
|
|
return lineString;
|
|
};
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
ol.geom.LineString.prototype.closestPointXY = function(x, y, closestPoint, minSquaredDistance) {
|
|
if (minSquaredDistance <
|
|
ol.extent.closestSquaredDistanceXY(this.getExtent(), x, y)) {
|
|
return minSquaredDistance;
|
|
}
|
|
if (this.maxDeltaRevision_ != this.getRevision()) {
|
|
this.maxDelta_ = Math.sqrt(ol.geom.flat.closest.getMaxSquaredDelta(
|
|
this.flatCoordinates, 0, this.flatCoordinates.length, this.stride, 0));
|
|
this.maxDeltaRevision_ = this.getRevision();
|
|
}
|
|
return ol.geom.flat.closest.getClosestPoint(
|
|
this.flatCoordinates, 0, this.flatCoordinates.length, this.stride,
|
|
this.maxDelta_, false, x, y, closestPoint, minSquaredDistance);
|
|
};
|
|
|
|
|
|
/**
|
|
* Iterate over each segment, calling the provided callback.
|
|
* If the callback returns a truthy value the function returns that
|
|
* value immediately. Otherwise the function returns `false`.
|
|
*
|
|
* @param {function(this: S, ol.Coordinate, ol.Coordinate): T} callback Function
|
|
* called for each segment.
|
|
* @param {S=} opt_this The object to be used as the value of 'this'
|
|
* within callback.
|
|
* @return {T|boolean} Value.
|
|
* @template T,S
|
|
* @api
|
|
*/
|
|
ol.geom.LineString.prototype.forEachSegment = function(callback, opt_this) {
|
|
return ol.geom.flat.segments.forEach(this.flatCoordinates, 0,
|
|
this.flatCoordinates.length, this.stride, callback, opt_this);
|
|
};
|
|
|
|
|
|
/**
|
|
* Returns the coordinate at `m` using linear interpolation, or `null` if no
|
|
* such coordinate exists.
|
|
*
|
|
* `opt_extrapolate` controls extrapolation beyond the range of Ms in the
|
|
* MultiLineString. If `opt_extrapolate` is `true` then Ms less than the first
|
|
* M will return the first coordinate and Ms greater than the last M will
|
|
* return the last coordinate.
|
|
*
|
|
* @param {number} m M.
|
|
* @param {boolean=} opt_extrapolate Extrapolate. Default is `false`.
|
|
* @return {ol.Coordinate} Coordinate.
|
|
* @api stable
|
|
*/
|
|
ol.geom.LineString.prototype.getCoordinateAtM = function(m, opt_extrapolate) {
|
|
if (this.layout != ol.geom.GeometryLayout.XYM &&
|
|
this.layout != ol.geom.GeometryLayout.XYZM) {
|
|
return null;
|
|
}
|
|
var extrapolate = opt_extrapolate !== undefined ? opt_extrapolate : false;
|
|
return ol.geom.flat.lineStringCoordinateAtM(this.flatCoordinates, 0,
|
|
this.flatCoordinates.length, this.stride, m, extrapolate);
|
|
};
|
|
|
|
|
|
/**
|
|
* Return the coordinates of the linestring.
|
|
* @return {Array.<ol.Coordinate>} Coordinates.
|
|
* @api stable
|
|
*/
|
|
ol.geom.LineString.prototype.getCoordinates = function() {
|
|
return ol.geom.flat.inflate.coordinates(
|
|
this.flatCoordinates, 0, this.flatCoordinates.length, this.stride);
|
|
};
|
|
|
|
|
|
/**
|
|
* Return the coordinate at the provided fraction along the linestring.
|
|
* The `fraction` is a number between 0 and 1, where 0 is the start of the
|
|
* linestring and 1 is the end.
|
|
* @param {number} fraction Fraction.
|
|
* @param {ol.Coordinate=} opt_dest Optional coordinate whose values will
|
|
* be modified. If not provided, a new coordinate will be returned.
|
|
* @return {ol.Coordinate} Coordinate of the interpolated point.
|
|
* @api
|
|
*/
|
|
ol.geom.LineString.prototype.getCoordinateAt = function(fraction, opt_dest) {
|
|
return ol.geom.flat.interpolate.lineString(
|
|
this.flatCoordinates, 0, this.flatCoordinates.length, this.stride,
|
|
fraction, opt_dest);
|
|
};
|
|
|
|
|
|
/**
|
|
* Return the length of the linestring on projected plane.
|
|
* @return {number} Length (on projected plane).
|
|
* @api stable
|
|
*/
|
|
ol.geom.LineString.prototype.getLength = function() {
|
|
return ol.geom.flat.length.lineString(
|
|
this.flatCoordinates, 0, this.flatCoordinates.length, this.stride);
|
|
};
|
|
|
|
|
|
/**
|
|
* @return {Array.<number>} Flat midpoint.
|
|
*/
|
|
ol.geom.LineString.prototype.getFlatMidpoint = function() {
|
|
if (this.flatMidpointRevision_ != this.getRevision()) {
|
|
this.flatMidpoint_ = this.getCoordinateAt(0.5, this.flatMidpoint_);
|
|
this.flatMidpointRevision_ = this.getRevision();
|
|
}
|
|
return this.flatMidpoint_;
|
|
};
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
ol.geom.LineString.prototype.getSimplifiedGeometryInternal = function(squaredTolerance) {
|
|
var simplifiedFlatCoordinates = [];
|
|
simplifiedFlatCoordinates.length = ol.geom.flat.simplify.douglasPeucker(
|
|
this.flatCoordinates, 0, this.flatCoordinates.length, this.stride,
|
|
squaredTolerance, simplifiedFlatCoordinates, 0);
|
|
var simplifiedLineString = new ol.geom.LineString(null);
|
|
simplifiedLineString.setFlatCoordinates(
|
|
ol.geom.GeometryLayout.XY, simplifiedFlatCoordinates);
|
|
return simplifiedLineString;
|
|
};
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
* @api stable
|
|
*/
|
|
ol.geom.LineString.prototype.getType = function() {
|
|
return ol.geom.GeometryType.LINE_STRING;
|
|
};
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
* @api stable
|
|
*/
|
|
ol.geom.LineString.prototype.intersectsExtent = function(extent) {
|
|
return ol.geom.flat.intersectsextent.lineString(
|
|
this.flatCoordinates, 0, this.flatCoordinates.length, this.stride,
|
|
extent);
|
|
};
|
|
|
|
|
|
/**
|
|
* Set the coordinates of the linestring.
|
|
* @param {Array.<ol.Coordinate>} coordinates Coordinates.
|
|
* @param {ol.geom.GeometryLayout=} opt_layout Layout.
|
|
* @api stable
|
|
*/
|
|
ol.geom.LineString.prototype.setCoordinates = function(coordinates, opt_layout) {
|
|
if (!coordinates) {
|
|
this.setFlatCoordinates(ol.geom.GeometryLayout.XY, null);
|
|
} else {
|
|
this.setLayout(opt_layout, coordinates, 1);
|
|
if (!this.flatCoordinates) {
|
|
this.flatCoordinates = [];
|
|
}
|
|
this.flatCoordinates.length = ol.geom.flat.deflate.coordinates(
|
|
this.flatCoordinates, 0, coordinates, this.stride);
|
|
this.changed();
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* @param {ol.geom.GeometryLayout} layout Layout.
|
|
* @param {Array.<number>} flatCoordinates Flat coordinates.
|
|
*/
|
|
ol.geom.LineString.prototype.setFlatCoordinates = function(layout, flatCoordinates) {
|
|
this.setFlatCoordinatesInternal(layout, flatCoordinates);
|
|
this.changed();
|
|
};
|