sgauthier
6e64e138e2
All checks were successful
Publish To Prod / deploy_and_publish (push) Successful in 35s
1816 lines
78 KiB
JavaScript
1816 lines
78 KiB
JavaScript
var __extends = (this && this.__extends) || (function () {
|
|
var extendStatics = function (d, b) {
|
|
extendStatics = Object.setPrototypeOf ||
|
|
({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
|
|
function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
|
|
return extendStatics(d, b);
|
|
};
|
|
return function (d, b) {
|
|
if (typeof b !== "function" && b !== null)
|
|
throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
|
|
extendStatics(d, b);
|
|
function __() { this.constructor = d; }
|
|
d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
|
|
};
|
|
})();
|
|
/**
|
|
* @module ol/View
|
|
*/
|
|
import BaseObject from './Object.js';
|
|
import Units from './proj/Units.js';
|
|
import ViewHint from './ViewHint.js';
|
|
import ViewProperty from './ViewProperty.js';
|
|
import { DEFAULT_TILE_SIZE } from './tilegrid/common.js';
|
|
import { METERS_PER_UNIT, createProjection, disableCoordinateWarning, fromUserCoordinate, fromUserExtent, getUserProjection, toUserCoordinate, toUserExtent, } from './proj.js';
|
|
import { VOID } from './functions.js';
|
|
import { add as addCoordinate, equals as coordinatesEqual, equals, rotate as rotateCoordinate, } from './coordinate.js';
|
|
import { assert } from './asserts.js';
|
|
import { assign } from './obj.js';
|
|
import { none as centerNone, createExtent } from './centerconstraint.js';
|
|
import { clamp, modulo } from './math.js';
|
|
import { createMinMaxResolution, createSnapToPower, createSnapToResolutions, } from './resolutionconstraint.js';
|
|
import { createSnapToN, createSnapToZero, disable, none as rotationNone, } from './rotationconstraint.js';
|
|
import { easeOut, inAndOut } from './easing.js';
|
|
import { getCenter, getForViewAndSize, getHeight, getWidth, isEmpty, } from './extent.js';
|
|
import { linearFindNearest } from './array.js';
|
|
import { fromExtent as polygonFromExtent } from './geom/Polygon.js';
|
|
/**
|
|
* An animation configuration
|
|
*
|
|
* @typedef {Object} Animation
|
|
* @property {import("./coordinate.js").Coordinate} [sourceCenter] Source center.
|
|
* @property {import("./coordinate.js").Coordinate} [targetCenter] Target center.
|
|
* @property {number} [sourceResolution] Source resolution.
|
|
* @property {number} [targetResolution] Target resolution.
|
|
* @property {number} [sourceRotation] Source rotation.
|
|
* @property {number} [targetRotation] Target rotation.
|
|
* @property {import("./coordinate.js").Coordinate} [anchor] Anchor.
|
|
* @property {number} start Start.
|
|
* @property {number} duration Duration.
|
|
* @property {boolean} complete Complete.
|
|
* @property {function(number):number} easing Easing.
|
|
* @property {function(boolean):void} callback Callback.
|
|
*/
|
|
/**
|
|
* @typedef {Object} Constraints
|
|
* @property {import("./centerconstraint.js").Type} center Center.
|
|
* @property {import("./resolutionconstraint.js").Type} resolution Resolution.
|
|
* @property {import("./rotationconstraint.js").Type} rotation Rotation.
|
|
*/
|
|
/**
|
|
* @typedef {Object} FitOptions
|
|
* @property {import("./size.js").Size} [size] The size in pixels of the box to fit
|
|
* the extent into. Default is the current size of the first map in the DOM that
|
|
* uses this view, or `[100, 100]` if no such map is found.
|
|
* @property {!Array<number>} [padding=[0, 0, 0, 0]] Padding (in pixels) to be
|
|
* cleared inside the view. Values in the array are top, right, bottom and left
|
|
* padding.
|
|
* @property {boolean} [nearest=false] If the view `constrainResolution` option is `true`,
|
|
* get the nearest extent instead of the closest that actually fits the view.
|
|
* @property {number} [minResolution=0] Minimum resolution that we zoom to.
|
|
* @property {number} [maxZoom] Maximum zoom level that we zoom to. If
|
|
* `minResolution` is given, this property is ignored.
|
|
* @property {number} [duration] The duration of the animation in milliseconds.
|
|
* By default, there is no animation to the target extent.
|
|
* @property {function(number):number} [easing] The easing function used during
|
|
* the animation (defaults to {@link module:ol/easing.inAndOut}).
|
|
* The function will be called for each frame with a number representing a
|
|
* fraction of the animation's duration. The function should return a number
|
|
* between 0 and 1 representing the progress toward the destination state.
|
|
* @property {function(boolean):void} [callback] Function called when the view is in
|
|
* its final position. The callback will be called with `true` if the animation
|
|
* series completed on its own or `false` if it was cancelled.
|
|
*/
|
|
/**
|
|
* @typedef {Object} ViewOptions
|
|
* @property {import("./coordinate.js").Coordinate} [center] The initial center for
|
|
* the view. If a user projection is not set, the coordinate system for the center is
|
|
* specified with the `projection` option. Layer sources will not be fetched if this
|
|
* is not set, but the center can be set later with {@link #setCenter}.
|
|
* @property {boolean|number} [constrainRotation=true] Rotation constraint.
|
|
* `false` means no constraint. `true` means no constraint, but snap to zero
|
|
* near zero. A number constrains the rotation to that number of values. For
|
|
* example, `4` will constrain the rotation to 0, 90, 180, and 270 degrees.
|
|
* @property {boolean} [enableRotation=true] Enable rotation.
|
|
* If `false`, a rotation constraint that always sets the rotation to zero is
|
|
* used. The `constrainRotation` option has no effect if `enableRotation` is
|
|
* `false`.
|
|
* @property {import("./extent.js").Extent} [extent] The extent that constrains the
|
|
* view, in other words, nothing outside of this extent can be visible on the map.
|
|
* @property {boolean} [constrainOnlyCenter=false] If true, the extent
|
|
* constraint will only apply to the view center and not the whole extent.
|
|
* @property {boolean} [smoothExtentConstraint=true] If true, the extent
|
|
* constraint will be applied smoothly, i.e. allow the view to go slightly outside
|
|
* of the given `extent`.
|
|
* @property {number} [maxResolution] The maximum resolution used to determine
|
|
* the resolution constraint. It is used together with `minResolution` (or
|
|
* `maxZoom`) and `zoomFactor`. If unspecified it is calculated in such a way
|
|
* that the projection's validity extent fits in a 256x256 px tile. If the
|
|
* projection is Spherical Mercator (the default) then `maxResolution` defaults
|
|
* to `40075016.68557849 / 256 = 156543.03392804097`.
|
|
* @property {number} [minResolution] The minimum resolution used to determine
|
|
* the resolution constraint. It is used together with `maxResolution` (or
|
|
* `minZoom`) and `zoomFactor`. If unspecified it is calculated assuming 29
|
|
* zoom levels (with a factor of 2). If the projection is Spherical Mercator
|
|
* (the default) then `minResolution` defaults to
|
|
* `40075016.68557849 / 256 / Math.pow(2, 28) = 0.0005831682455839253`.
|
|
* @property {number} [maxZoom=28] The maximum zoom level used to determine the
|
|
* resolution constraint. It is used together with `minZoom` (or
|
|
* `maxResolution`) and `zoomFactor`. Note that if `minResolution` is also
|
|
* provided, it is given precedence over `maxZoom`.
|
|
* @property {number} [minZoom=0] The minimum zoom level used to determine the
|
|
* resolution constraint. It is used together with `maxZoom` (or
|
|
* `minResolution`) and `zoomFactor`. Note that if `maxResolution` is also
|
|
* provided, it is given precedence over `minZoom`.
|
|
* @property {boolean} [multiWorld=false] If `false` the view is constrained so
|
|
* only one world is visible, and you cannot pan off the edge. If `true` the map
|
|
* may show multiple worlds at low zoom levels. Only used if the `projection` is
|
|
* global. Note that if `extent` is also provided it is given precedence.
|
|
* @property {boolean} [constrainResolution=false] If true, the view will always
|
|
* animate to the closest zoom level after an interaction; false means
|
|
* intermediary zoom levels are allowed.
|
|
* @property {boolean} [smoothResolutionConstraint=true] If true, the resolution
|
|
* min/max values will be applied smoothly, i. e. allow the view to exceed slightly
|
|
* the given resolution or zoom bounds.
|
|
* @property {boolean} [showFullExtent=false] Allow the view to be zoomed out to
|
|
* show the full configured extent. By default, when a view is configured with an
|
|
* extent, users will not be able to zoom out so the viewport exceeds the extent in
|
|
* either dimension. This means the full extent may not be visible if the viewport
|
|
* is taller or wider than the aspect ratio of the configured extent. If
|
|
* showFullExtent is true, the user will be able to zoom out so that the viewport
|
|
* exceeds the height or width of the configured extent, but not both, allowing the
|
|
* full extent to be shown.
|
|
* @property {import("./proj.js").ProjectionLike} [projection='EPSG:3857'] The
|
|
* projection. The default is Spherical Mercator.
|
|
* @property {number} [resolution] The initial resolution for the view. The
|
|
* units are `projection` units per pixel (e.g. meters per pixel). An
|
|
* alternative to setting this is to set `zoom`. Layer sources will not be
|
|
* fetched if neither this nor `zoom` are defined, but they can be set later
|
|
* with {@link #setZoom} or {@link #setResolution}.
|
|
* @property {Array<number>} [resolutions] Resolutions that determine the
|
|
* zoom levels if specified. The index in the array corresponds to the zoom level,
|
|
* therefore the resolution values have to be in descending order. It also constrains
|
|
* the resolution by the minimum and maximum value. If set the `maxResolution`,
|
|
* `minResolution`, `minZoom`, `maxZoom`, and `zoomFactor` options are ignored.
|
|
* @property {number} [rotation=0] The initial rotation for the view in radians
|
|
* (positive rotation clockwise, 0 means North).
|
|
* @property {number} [zoom] Only used if `resolution` is not defined. Zoom
|
|
* level used to calculate the initial resolution for the view.
|
|
* @property {number} [zoomFactor=2] The zoom factor used to compute the
|
|
* corresponding resolution.
|
|
* @property {!Array<number>} [padding=[0, 0, 0, 0]] Padding (in css pixels).
|
|
* If the map viewport is partially covered with other content (overlays) along
|
|
* its edges, this setting allows to shift the center of the viewport away from
|
|
* that content. The order of the values is top, right, bottom, left.
|
|
*/
|
|
/**
|
|
* @typedef {Object} AnimationOptions
|
|
* @property {import("./coordinate.js").Coordinate} [center] The center of the view at the end of
|
|
* the animation.
|
|
* @property {number} [zoom] The zoom level of the view at the end of the
|
|
* animation. This takes precedence over `resolution`.
|
|
* @property {number} [resolution] The resolution of the view at the end
|
|
* of the animation. If `zoom` is also provided, this option will be ignored.
|
|
* @property {number} [rotation] The rotation of the view at the end of
|
|
* the animation.
|
|
* @property {import("./coordinate.js").Coordinate} [anchor] Optional anchor to remain fixed
|
|
* during a rotation or resolution animation.
|
|
* @property {number} [duration=1000] The duration of the animation in milliseconds.
|
|
* @property {function(number):number} [easing] The easing function used
|
|
* during the animation (defaults to {@link module:ol/easing.inAndOut}).
|
|
* The function will be called for each frame with a number representing a
|
|
* fraction of the animation's duration. The function should return a number
|
|
* between 0 and 1 representing the progress toward the destination state.
|
|
*/
|
|
/**
|
|
* @typedef {Object} State
|
|
* @property {import("./coordinate.js").Coordinate} center Center.
|
|
* @property {import("./proj/Projection.js").default} projection Projection.
|
|
* @property {number} resolution Resolution.
|
|
* @property {import("./coordinate.js").Coordinate} [nextCenter] The next center during an animation series.
|
|
* @property {number} [nextResolution] The next resolution during an animation series.
|
|
* @property {number} [nextRotation] The next rotation during an animation series.
|
|
* @property {number} rotation Rotation.
|
|
* @property {number} zoom Zoom.
|
|
*/
|
|
/**
|
|
* Default min zoom level for the map view.
|
|
* @type {number}
|
|
*/
|
|
var DEFAULT_MIN_ZOOM = 0;
|
|
/**
|
|
* @typedef {import("./ObjectEventType").Types|'change:center'|'change:resolution'|'change:rotation'} ViewObjectEventTypes
|
|
*/
|
|
/***
|
|
* @template Return
|
|
* @typedef {import("./Observable").OnSignature<import("./Observable").EventTypes, import("./events/Event.js").default, Return> &
|
|
* import("./Observable").OnSignature<ViewObjectEventTypes, import("./Object").ObjectEvent, Return> &
|
|
* import("./Observable").CombinedOnSignature<import("./Observable").EventTypes|ViewObjectEventTypes, Return>} ViewOnSignature
|
|
*/
|
|
/**
|
|
* @classdesc
|
|
* A View object represents a simple 2D view of the map.
|
|
*
|
|
* This is the object to act upon to change the center, resolution,
|
|
* and rotation of the map.
|
|
*
|
|
* A View has a `projection`. The projection determines the
|
|
* coordinate system of the center, and its units determine the units of the
|
|
* resolution (projection units per pixel). The default projection is
|
|
* Web Mercator (EPSG:3857).
|
|
*
|
|
* ### The view states
|
|
*
|
|
* A View is determined by three states: `center`, `resolution`,
|
|
* and `rotation`. Each state has a corresponding getter and setter, e.g.
|
|
* `getCenter` and `setCenter` for the `center` state.
|
|
*
|
|
* The `zoom` state is actually not saved on the view: all computations
|
|
* internally use the `resolution` state. Still, the `setZoom` and `getZoom`
|
|
* methods are available, as well as `getResolutionForZoom` and
|
|
* `getZoomForResolution` to switch from one system to the other.
|
|
*
|
|
* ### The constraints
|
|
*
|
|
* `setCenter`, `setResolution` and `setRotation` can be used to change the
|
|
* states of the view, but any constraint defined in the constructor will
|
|
* be applied along the way.
|
|
*
|
|
* A View object can have a *resolution constraint*, a *rotation constraint*
|
|
* and a *center constraint*.
|
|
*
|
|
* The *resolution constraint* typically restricts min/max values and
|
|
* snaps to specific resolutions. It is determined by the following
|
|
* options: `resolutions`, `maxResolution`, `maxZoom` and `zoomFactor`.
|
|
* If `resolutions` is set, the other three options are ignored. See
|
|
* documentation for each option for more information. By default, the view
|
|
* only has a min/max restriction and allow intermediary zoom levels when
|
|
* pinch-zooming for example.
|
|
*
|
|
* The *rotation constraint* snaps to specific angles. It is determined
|
|
* by the following options: `enableRotation` and `constrainRotation`.
|
|
* By default rotation is allowed and its value is snapped to zero when approaching the
|
|
* horizontal.
|
|
*
|
|
* The *center constraint* is determined by the `extent` option. By
|
|
* default the view center is not constrained at all.
|
|
*
|
|
* ### Changing the view state
|
|
*
|
|
* It is important to note that `setZoom`, `setResolution`, `setCenter` and
|
|
* `setRotation` are subject to the above mentioned constraints. As such, it
|
|
* may sometimes not be possible to know in advance the resulting state of the
|
|
* View. For example, calling `setResolution(10)` does not guarantee that
|
|
* `getResolution()` will return `10`.
|
|
*
|
|
* A consequence of this is that, when applying a delta on the view state, one
|
|
* should use `adjustCenter`, `adjustRotation`, `adjustZoom` and `adjustResolution`
|
|
* rather than the corresponding setters. This will let view do its internal
|
|
* computations. Besides, the `adjust*` methods also take an `opt_anchor`
|
|
* argument which allows specifying an origin for the transformation.
|
|
*
|
|
* ### Interacting with the view
|
|
*
|
|
* View constraints are usually only applied when the view is *at rest*, meaning that
|
|
* no interaction or animation is ongoing. As such, if the user puts the view in a
|
|
* state that is not equivalent to a constrained one (e.g. rotating the view when
|
|
* the snap angle is 0), an animation will be triggered at the interaction end to
|
|
* put back the view to a stable state;
|
|
*
|
|
* @api
|
|
*/
|
|
var View = /** @class */ (function (_super) {
|
|
__extends(View, _super);
|
|
/**
|
|
* @param {ViewOptions} [opt_options] View options.
|
|
*/
|
|
function View(opt_options) {
|
|
var _this = _super.call(this) || this;
|
|
/***
|
|
* @type {ViewOnSignature<import("./events").EventsKey>}
|
|
*/
|
|
_this.on;
|
|
/***
|
|
* @type {ViewOnSignature<import("./events").EventsKey>}
|
|
*/
|
|
_this.once;
|
|
/***
|
|
* @type {ViewOnSignature<void>}
|
|
*/
|
|
_this.un;
|
|
var options = assign({}, opt_options);
|
|
/**
|
|
* @private
|
|
* @type {Array<number>}
|
|
*/
|
|
_this.hints_ = [0, 0];
|
|
/**
|
|
* @private
|
|
* @type {Array<Array<Animation>>}
|
|
*/
|
|
_this.animations_ = [];
|
|
/**
|
|
* @private
|
|
* @type {number|undefined}
|
|
*/
|
|
_this.updateAnimationKey_;
|
|
/**
|
|
* @private
|
|
* @const
|
|
* @type {import("./proj/Projection.js").default}
|
|
*/
|
|
_this.projection_ = createProjection(options.projection, 'EPSG:3857');
|
|
/**
|
|
* @private
|
|
* @type {import("./size.js").Size}
|
|
*/
|
|
_this.viewportSize_ = [100, 100];
|
|
/**
|
|
* @private
|
|
* @type {import("./coordinate.js").Coordinate|undefined}
|
|
*/
|
|
_this.targetCenter_ = null;
|
|
/**
|
|
* @private
|
|
* @type {number|undefined}
|
|
*/
|
|
_this.targetResolution_;
|
|
/**
|
|
* @private
|
|
* @type {number|undefined}
|
|
*/
|
|
_this.targetRotation_;
|
|
/**
|
|
* @private
|
|
* @type {import("./coordinate.js").Coordinate}
|
|
*/
|
|
_this.nextCenter_ = null;
|
|
/**
|
|
* @private
|
|
* @type {number}
|
|
*/
|
|
_this.nextResolution_;
|
|
/**
|
|
* @private
|
|
* @type {number}
|
|
*/
|
|
_this.nextRotation_;
|
|
/**
|
|
* @private
|
|
* @type {import("./coordinate.js").Coordinate|undefined}
|
|
*/
|
|
_this.cancelAnchor_ = undefined;
|
|
if (options.projection) {
|
|
disableCoordinateWarning();
|
|
}
|
|
if (options.center) {
|
|
options.center = fromUserCoordinate(options.center, _this.projection_);
|
|
}
|
|
if (options.extent) {
|
|
options.extent = fromUserExtent(options.extent, _this.projection_);
|
|
}
|
|
_this.applyOptions_(options);
|
|
return _this;
|
|
}
|
|
/**
|
|
* Set up the view with the given options.
|
|
* @param {ViewOptions} options View options.
|
|
*/
|
|
View.prototype.applyOptions_ = function (options) {
|
|
var properties = assign({}, options);
|
|
for (var key in ViewProperty) {
|
|
delete properties[key];
|
|
}
|
|
this.setProperties(properties, true);
|
|
var resolutionConstraintInfo = createResolutionConstraint(options);
|
|
/**
|
|
* @private
|
|
* @type {number}
|
|
*/
|
|
this.maxResolution_ = resolutionConstraintInfo.maxResolution;
|
|
/**
|
|
* @private
|
|
* @type {number}
|
|
*/
|
|
this.minResolution_ = resolutionConstraintInfo.minResolution;
|
|
/**
|
|
* @private
|
|
* @type {number}
|
|
*/
|
|
this.zoomFactor_ = resolutionConstraintInfo.zoomFactor;
|
|
/**
|
|
* @private
|
|
* @type {Array<number>|undefined}
|
|
*/
|
|
this.resolutions_ = options.resolutions;
|
|
/**
|
|
* @type {Array<number>|undefined}
|
|
* @private
|
|
*/
|
|
this.padding_ = options.padding;
|
|
/**
|
|
* @private
|
|
* @type {number}
|
|
*/
|
|
this.minZoom_ = resolutionConstraintInfo.minZoom;
|
|
var centerConstraint = createCenterConstraint(options);
|
|
var resolutionConstraint = resolutionConstraintInfo.constraint;
|
|
var rotationConstraint = createRotationConstraint(options);
|
|
/**
|
|
* @private
|
|
* @type {Constraints}
|
|
*/
|
|
this.constraints_ = {
|
|
center: centerConstraint,
|
|
resolution: resolutionConstraint,
|
|
rotation: rotationConstraint,
|
|
};
|
|
this.setRotation(options.rotation !== undefined ? options.rotation : 0);
|
|
this.setCenterInternal(options.center !== undefined ? options.center : null);
|
|
if (options.resolution !== undefined) {
|
|
this.setResolution(options.resolution);
|
|
}
|
|
else if (options.zoom !== undefined) {
|
|
this.setZoom(options.zoom);
|
|
}
|
|
};
|
|
Object.defineProperty(View.prototype, "padding", {
|
|
/**
|
|
* Padding (in css pixels).
|
|
* If the map viewport is partially covered with other content (overlays) along
|
|
* its edges, this setting allows to shift the center of the viewport away from that
|
|
* content. The order of the values in the array is top, right, bottom, left.
|
|
* The default is no padding, which is equivalent to `[0, 0, 0, 0]`.
|
|
* @type {Array<number>|undefined}
|
|
* @api
|
|
*/
|
|
get: function () {
|
|
return this.padding_;
|
|
},
|
|
set: function (padding) {
|
|
var oldPadding = this.padding_;
|
|
this.padding_ = padding;
|
|
var center = this.getCenter();
|
|
if (center) {
|
|
var newPadding = padding || [0, 0, 0, 0];
|
|
oldPadding = oldPadding || [0, 0, 0, 0];
|
|
var resolution = this.getResolution();
|
|
var offsetX = (resolution / 2) *
|
|
(newPadding[3] - oldPadding[3] + oldPadding[1] - newPadding[1]);
|
|
var offsetY = (resolution / 2) *
|
|
(newPadding[0] - oldPadding[0] + oldPadding[2] - newPadding[2]);
|
|
this.setCenterInternal([center[0] + offsetX, center[1] - offsetY]);
|
|
}
|
|
},
|
|
enumerable: false,
|
|
configurable: true
|
|
});
|
|
/**
|
|
* Get an updated version of the view options used to construct the view. The
|
|
* current resolution (or zoom), center, and rotation are applied to any stored
|
|
* options. The provided options can be used to apply new min/max zoom or
|
|
* resolution limits.
|
|
* @param {ViewOptions} newOptions New options to be applied.
|
|
* @return {ViewOptions} New options updated with the current view state.
|
|
*/
|
|
View.prototype.getUpdatedOptions_ = function (newOptions) {
|
|
var options = this.getProperties();
|
|
// preserve resolution (or zoom)
|
|
if (options.resolution !== undefined) {
|
|
options.resolution = this.getResolution();
|
|
}
|
|
else {
|
|
options.zoom = this.getZoom();
|
|
}
|
|
// preserve center
|
|
options.center = this.getCenterInternal();
|
|
// preserve rotation
|
|
options.rotation = this.getRotation();
|
|
return assign({}, options, newOptions);
|
|
};
|
|
/**
|
|
* Animate the view. The view's center, zoom (or resolution), and rotation
|
|
* can be animated for smooth transitions between view states. For example,
|
|
* to animate the view to a new zoom level:
|
|
*
|
|
* view.animate({zoom: view.getZoom() + 1});
|
|
*
|
|
* By default, the animation lasts one second and uses in-and-out easing. You
|
|
* can customize this behavior by including `duration` (in milliseconds) and
|
|
* `easing` options (see {@link module:ol/easing}).
|
|
*
|
|
* To chain together multiple animations, call the method with multiple
|
|
* animation objects. For example, to first zoom and then pan:
|
|
*
|
|
* view.animate({zoom: 10}, {center: [0, 0]});
|
|
*
|
|
* If you provide a function as the last argument to the animate method, it
|
|
* will get called at the end of an animation series. The callback will be
|
|
* called with `true` if the animation series completed on its own or `false`
|
|
* if it was cancelled.
|
|
*
|
|
* Animations are cancelled by user interactions (e.g. dragging the map) or by
|
|
* calling `view.setCenter()`, `view.setResolution()`, or `view.setRotation()`
|
|
* (or another method that calls one of these).
|
|
*
|
|
* @param {...(AnimationOptions|function(boolean): void)} var_args Animation
|
|
* options. Multiple animations can be run in series by passing multiple
|
|
* options objects. To run multiple animations in parallel, call the method
|
|
* multiple times. An optional callback can be provided as a final
|
|
* argument. The callback will be called with a boolean indicating whether
|
|
* the animation completed without being cancelled.
|
|
* @api
|
|
*/
|
|
View.prototype.animate = function (var_args) {
|
|
if (this.isDef() && !this.getAnimating()) {
|
|
this.resolveConstraints(0);
|
|
}
|
|
var args = new Array(arguments.length);
|
|
for (var i = 0; i < args.length; ++i) {
|
|
var options = arguments[i];
|
|
if (options.center) {
|
|
options = assign({}, options);
|
|
options.center = fromUserCoordinate(options.center, this.getProjection());
|
|
}
|
|
if (options.anchor) {
|
|
options = assign({}, options);
|
|
options.anchor = fromUserCoordinate(options.anchor, this.getProjection());
|
|
}
|
|
args[i] = options;
|
|
}
|
|
this.animateInternal.apply(this, args);
|
|
};
|
|
/**
|
|
* @param {...(AnimationOptions|function(boolean): void)} var_args Animation options.
|
|
*/
|
|
View.prototype.animateInternal = function (var_args) {
|
|
var animationCount = arguments.length;
|
|
var callback;
|
|
if (animationCount > 1 &&
|
|
typeof arguments[animationCount - 1] === 'function') {
|
|
callback = arguments[animationCount - 1];
|
|
--animationCount;
|
|
}
|
|
var i = 0;
|
|
for (; i < animationCount && !this.isDef(); ++i) {
|
|
// if view properties are not yet set, shortcut to the final state
|
|
var state = arguments[i];
|
|
if (state.center) {
|
|
this.setCenterInternal(state.center);
|
|
}
|
|
if (state.zoom !== undefined) {
|
|
this.setZoom(state.zoom);
|
|
}
|
|
else if (state.resolution) {
|
|
this.setResolution(state.resolution);
|
|
}
|
|
if (state.rotation !== undefined) {
|
|
this.setRotation(state.rotation);
|
|
}
|
|
}
|
|
if (i === animationCount) {
|
|
if (callback) {
|
|
animationCallback(callback, true);
|
|
}
|
|
return;
|
|
}
|
|
var start = Date.now();
|
|
var center = this.targetCenter_.slice();
|
|
var resolution = this.targetResolution_;
|
|
var rotation = this.targetRotation_;
|
|
var series = [];
|
|
for (; i < animationCount; ++i) {
|
|
var options = /** @type {AnimationOptions} */ (arguments[i]);
|
|
var animation = {
|
|
start: start,
|
|
complete: false,
|
|
anchor: options.anchor,
|
|
duration: options.duration !== undefined ? options.duration : 1000,
|
|
easing: options.easing || inAndOut,
|
|
callback: callback,
|
|
};
|
|
if (options.center) {
|
|
animation.sourceCenter = center;
|
|
animation.targetCenter = options.center.slice();
|
|
center = animation.targetCenter;
|
|
}
|
|
if (options.zoom !== undefined) {
|
|
animation.sourceResolution = resolution;
|
|
animation.targetResolution = this.getResolutionForZoom(options.zoom);
|
|
resolution = animation.targetResolution;
|
|
}
|
|
else if (options.resolution) {
|
|
animation.sourceResolution = resolution;
|
|
animation.targetResolution = options.resolution;
|
|
resolution = animation.targetResolution;
|
|
}
|
|
if (options.rotation !== undefined) {
|
|
animation.sourceRotation = rotation;
|
|
var delta = modulo(options.rotation - rotation + Math.PI, 2 * Math.PI) - Math.PI;
|
|
animation.targetRotation = rotation + delta;
|
|
rotation = animation.targetRotation;
|
|
}
|
|
// check if animation is a no-op
|
|
if (isNoopAnimation(animation)) {
|
|
animation.complete = true;
|
|
// we still push it onto the series for callback handling
|
|
}
|
|
else {
|
|
start += animation.duration;
|
|
}
|
|
series.push(animation);
|
|
}
|
|
this.animations_.push(series);
|
|
this.setHint(ViewHint.ANIMATING, 1);
|
|
this.updateAnimations_();
|
|
};
|
|
/**
|
|
* Determine if the view is being animated.
|
|
* @return {boolean} The view is being animated.
|
|
* @api
|
|
*/
|
|
View.prototype.getAnimating = function () {
|
|
return this.hints_[ViewHint.ANIMATING] > 0;
|
|
};
|
|
/**
|
|
* Determine if the user is interacting with the view, such as panning or zooming.
|
|
* @return {boolean} The view is being interacted with.
|
|
* @api
|
|
*/
|
|
View.prototype.getInteracting = function () {
|
|
return this.hints_[ViewHint.INTERACTING] > 0;
|
|
};
|
|
/**
|
|
* Cancel any ongoing animations.
|
|
* @api
|
|
*/
|
|
View.prototype.cancelAnimations = function () {
|
|
this.setHint(ViewHint.ANIMATING, -this.hints_[ViewHint.ANIMATING]);
|
|
var anchor;
|
|
for (var i = 0, ii = this.animations_.length; i < ii; ++i) {
|
|
var series = this.animations_[i];
|
|
if (series[0].callback) {
|
|
animationCallback(series[0].callback, false);
|
|
}
|
|
if (!anchor) {
|
|
for (var j = 0, jj = series.length; j < jj; ++j) {
|
|
var animation = series[j];
|
|
if (!animation.complete) {
|
|
anchor = animation.anchor;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
this.animations_.length = 0;
|
|
this.cancelAnchor_ = anchor;
|
|
this.nextCenter_ = null;
|
|
this.nextResolution_ = NaN;
|
|
this.nextRotation_ = NaN;
|
|
};
|
|
/**
|
|
* Update all animations.
|
|
*/
|
|
View.prototype.updateAnimations_ = function () {
|
|
if (this.updateAnimationKey_ !== undefined) {
|
|
cancelAnimationFrame(this.updateAnimationKey_);
|
|
this.updateAnimationKey_ = undefined;
|
|
}
|
|
if (!this.getAnimating()) {
|
|
return;
|
|
}
|
|
var now = Date.now();
|
|
var more = false;
|
|
for (var i = this.animations_.length - 1; i >= 0; --i) {
|
|
var series = this.animations_[i];
|
|
var seriesComplete = true;
|
|
for (var j = 0, jj = series.length; j < jj; ++j) {
|
|
var animation = series[j];
|
|
if (animation.complete) {
|
|
continue;
|
|
}
|
|
var elapsed = now - animation.start;
|
|
var fraction = animation.duration > 0 ? elapsed / animation.duration : 1;
|
|
if (fraction >= 1) {
|
|
animation.complete = true;
|
|
fraction = 1;
|
|
}
|
|
else {
|
|
seriesComplete = false;
|
|
}
|
|
var progress = animation.easing(fraction);
|
|
if (animation.sourceCenter) {
|
|
var x0 = animation.sourceCenter[0];
|
|
var y0 = animation.sourceCenter[1];
|
|
var x1 = animation.targetCenter[0];
|
|
var y1 = animation.targetCenter[1];
|
|
this.nextCenter_ = animation.targetCenter;
|
|
var x = x0 + progress * (x1 - x0);
|
|
var y = y0 + progress * (y1 - y0);
|
|
this.targetCenter_ = [x, y];
|
|
}
|
|
if (animation.sourceResolution && animation.targetResolution) {
|
|
var resolution = progress === 1
|
|
? animation.targetResolution
|
|
: animation.sourceResolution +
|
|
progress *
|
|
(animation.targetResolution - animation.sourceResolution);
|
|
if (animation.anchor) {
|
|
var size = this.getViewportSize_(this.getRotation());
|
|
var constrainedResolution = this.constraints_.resolution(resolution, 0, size, true);
|
|
this.targetCenter_ = this.calculateCenterZoom(constrainedResolution, animation.anchor);
|
|
}
|
|
this.nextResolution_ = animation.targetResolution;
|
|
this.targetResolution_ = resolution;
|
|
this.applyTargetState_(true);
|
|
}
|
|
if (animation.sourceRotation !== undefined &&
|
|
animation.targetRotation !== undefined) {
|
|
var rotation = progress === 1
|
|
? modulo(animation.targetRotation + Math.PI, 2 * Math.PI) -
|
|
Math.PI
|
|
: animation.sourceRotation +
|
|
progress *
|
|
(animation.targetRotation - animation.sourceRotation);
|
|
if (animation.anchor) {
|
|
var constrainedRotation = this.constraints_.rotation(rotation, true);
|
|
this.targetCenter_ = this.calculateCenterRotate(constrainedRotation, animation.anchor);
|
|
}
|
|
this.nextRotation_ = animation.targetRotation;
|
|
this.targetRotation_ = rotation;
|
|
}
|
|
this.applyTargetState_(true);
|
|
more = true;
|
|
if (!animation.complete) {
|
|
break;
|
|
}
|
|
}
|
|
if (seriesComplete) {
|
|
this.animations_[i] = null;
|
|
this.setHint(ViewHint.ANIMATING, -1);
|
|
this.nextCenter_ = null;
|
|
this.nextResolution_ = NaN;
|
|
this.nextRotation_ = NaN;
|
|
var callback = series[0].callback;
|
|
if (callback) {
|
|
animationCallback(callback, true);
|
|
}
|
|
}
|
|
}
|
|
// prune completed series
|
|
this.animations_ = this.animations_.filter(Boolean);
|
|
if (more && this.updateAnimationKey_ === undefined) {
|
|
this.updateAnimationKey_ = requestAnimationFrame(this.updateAnimations_.bind(this));
|
|
}
|
|
};
|
|
/**
|
|
* @param {number} rotation Target rotation.
|
|
* @param {import("./coordinate.js").Coordinate} anchor Rotation anchor.
|
|
* @return {import("./coordinate.js").Coordinate|undefined} Center for rotation and anchor.
|
|
*/
|
|
View.prototype.calculateCenterRotate = function (rotation, anchor) {
|
|
var center;
|
|
var currentCenter = this.getCenterInternal();
|
|
if (currentCenter !== undefined) {
|
|
center = [currentCenter[0] - anchor[0], currentCenter[1] - anchor[1]];
|
|
rotateCoordinate(center, rotation - this.getRotation());
|
|
addCoordinate(center, anchor);
|
|
}
|
|
return center;
|
|
};
|
|
/**
|
|
* @param {number} resolution Target resolution.
|
|
* @param {import("./coordinate.js").Coordinate} anchor Zoom anchor.
|
|
* @return {import("./coordinate.js").Coordinate|undefined} Center for resolution and anchor.
|
|
*/
|
|
View.prototype.calculateCenterZoom = function (resolution, anchor) {
|
|
var center;
|
|
var currentCenter = this.getCenterInternal();
|
|
var currentResolution = this.getResolution();
|
|
if (currentCenter !== undefined && currentResolution !== undefined) {
|
|
var x = anchor[0] -
|
|
(resolution * (anchor[0] - currentCenter[0])) / currentResolution;
|
|
var y = anchor[1] -
|
|
(resolution * (anchor[1] - currentCenter[1])) / currentResolution;
|
|
center = [x, y];
|
|
}
|
|
return center;
|
|
};
|
|
/**
|
|
* Returns the current viewport size.
|
|
* @private
|
|
* @param {number} [opt_rotation] Take into account the rotation of the viewport when giving the size
|
|
* @return {import("./size.js").Size} Viewport size or `[100, 100]` when no viewport is found.
|
|
*/
|
|
View.prototype.getViewportSize_ = function (opt_rotation) {
|
|
var size = this.viewportSize_;
|
|
if (opt_rotation) {
|
|
var w = size[0];
|
|
var h = size[1];
|
|
return [
|
|
Math.abs(w * Math.cos(opt_rotation)) +
|
|
Math.abs(h * Math.sin(opt_rotation)),
|
|
Math.abs(w * Math.sin(opt_rotation)) +
|
|
Math.abs(h * Math.cos(opt_rotation)),
|
|
];
|
|
}
|
|
else {
|
|
return size;
|
|
}
|
|
};
|
|
/**
|
|
* Stores the viewport size on the view. The viewport size is not read every time from the DOM
|
|
* to avoid performance hit and layout reflow.
|
|
* This should be done on map size change.
|
|
* Note: the constraints are not resolved during an animation to avoid stopping it
|
|
* @param {import("./size.js").Size} [opt_size] Viewport size; if undefined, [100, 100] is assumed
|
|
*/
|
|
View.prototype.setViewportSize = function (opt_size) {
|
|
this.viewportSize_ = Array.isArray(opt_size)
|
|
? opt_size.slice()
|
|
: [100, 100];
|
|
if (!this.getAnimating()) {
|
|
this.resolveConstraints(0);
|
|
}
|
|
};
|
|
/**
|
|
* Get the view center.
|
|
* @return {import("./coordinate.js").Coordinate|undefined} The center of the view.
|
|
* @observable
|
|
* @api
|
|
*/
|
|
View.prototype.getCenter = function () {
|
|
var center = this.getCenterInternal();
|
|
if (!center) {
|
|
return center;
|
|
}
|
|
return toUserCoordinate(center, this.getProjection());
|
|
};
|
|
/**
|
|
* Get the view center without transforming to user projection.
|
|
* @return {import("./coordinate.js").Coordinate|undefined} The center of the view.
|
|
*/
|
|
View.prototype.getCenterInternal = function () {
|
|
return /** @type {import("./coordinate.js").Coordinate|undefined} */ (this.get(ViewProperty.CENTER));
|
|
};
|
|
/**
|
|
* @return {Constraints} Constraints.
|
|
*/
|
|
View.prototype.getConstraints = function () {
|
|
return this.constraints_;
|
|
};
|
|
/**
|
|
* @return {boolean} Resolution constraint is set
|
|
*/
|
|
View.prototype.getConstrainResolution = function () {
|
|
return this.get('constrainResolution');
|
|
};
|
|
/**
|
|
* @param {Array<number>} [opt_hints] Destination array.
|
|
* @return {Array<number>} Hint.
|
|
*/
|
|
View.prototype.getHints = function (opt_hints) {
|
|
if (opt_hints !== undefined) {
|
|
opt_hints[0] = this.hints_[0];
|
|
opt_hints[1] = this.hints_[1];
|
|
return opt_hints;
|
|
}
|
|
else {
|
|
return this.hints_.slice();
|
|
}
|
|
};
|
|
/**
|
|
* Calculate the extent for the current view state and the passed size.
|
|
* The size is the pixel dimensions of the box into which the calculated extent
|
|
* should fit. In most cases you want to get the extent of the entire map,
|
|
* that is `map.getSize()`.
|
|
* @param {import("./size.js").Size} [opt_size] Box pixel size. If not provided, the size
|
|
* of the map that uses this view will be used.
|
|
* @return {import("./extent.js").Extent} Extent.
|
|
* @api
|
|
*/
|
|
View.prototype.calculateExtent = function (opt_size) {
|
|
var extent = this.calculateExtentInternal(opt_size);
|
|
return toUserExtent(extent, this.getProjection());
|
|
};
|
|
/**
|
|
* @param {import("./size.js").Size} [opt_size] Box pixel size. If not provided,
|
|
* the map's last known viewport size will be used.
|
|
* @return {import("./extent.js").Extent} Extent.
|
|
*/
|
|
View.prototype.calculateExtentInternal = function (opt_size) {
|
|
var size = opt_size || this.getViewportSizeMinusPadding_();
|
|
var center = /** @type {!import("./coordinate.js").Coordinate} */ (this.getCenterInternal());
|
|
assert(center, 1); // The view center is not defined
|
|
var resolution = /** @type {!number} */ (this.getResolution());
|
|
assert(resolution !== undefined, 2); // The view resolution is not defined
|
|
var rotation = /** @type {!number} */ (this.getRotation());
|
|
assert(rotation !== undefined, 3); // The view rotation is not defined
|
|
return getForViewAndSize(center, resolution, rotation, size);
|
|
};
|
|
/**
|
|
* Get the maximum resolution of the view.
|
|
* @return {number} The maximum resolution of the view.
|
|
* @api
|
|
*/
|
|
View.prototype.getMaxResolution = function () {
|
|
return this.maxResolution_;
|
|
};
|
|
/**
|
|
* Get the minimum resolution of the view.
|
|
* @return {number} The minimum resolution of the view.
|
|
* @api
|
|
*/
|
|
View.prototype.getMinResolution = function () {
|
|
return this.minResolution_;
|
|
};
|
|
/**
|
|
* Get the maximum zoom level for the view.
|
|
* @return {number} The maximum zoom level.
|
|
* @api
|
|
*/
|
|
View.prototype.getMaxZoom = function () {
|
|
return /** @type {number} */ (this.getZoomForResolution(this.minResolution_));
|
|
};
|
|
/**
|
|
* Set a new maximum zoom level for the view.
|
|
* @param {number} zoom The maximum zoom level.
|
|
* @api
|
|
*/
|
|
View.prototype.setMaxZoom = function (zoom) {
|
|
this.applyOptions_(this.getUpdatedOptions_({ maxZoom: zoom }));
|
|
};
|
|
/**
|
|
* Get the minimum zoom level for the view.
|
|
* @return {number} The minimum zoom level.
|
|
* @api
|
|
*/
|
|
View.prototype.getMinZoom = function () {
|
|
return /** @type {number} */ (this.getZoomForResolution(this.maxResolution_));
|
|
};
|
|
/**
|
|
* Set a new minimum zoom level for the view.
|
|
* @param {number} zoom The minimum zoom level.
|
|
* @api
|
|
*/
|
|
View.prototype.setMinZoom = function (zoom) {
|
|
this.applyOptions_(this.getUpdatedOptions_({ minZoom: zoom }));
|
|
};
|
|
/**
|
|
* Set whether the view should allow intermediary zoom levels.
|
|
* @param {boolean} enabled Whether the resolution is constrained.
|
|
* @api
|
|
*/
|
|
View.prototype.setConstrainResolution = function (enabled) {
|
|
this.applyOptions_(this.getUpdatedOptions_({ constrainResolution: enabled }));
|
|
};
|
|
/**
|
|
* Get the view projection.
|
|
* @return {import("./proj/Projection.js").default} The projection of the view.
|
|
* @api
|
|
*/
|
|
View.prototype.getProjection = function () {
|
|
return this.projection_;
|
|
};
|
|
/**
|
|
* Get the view resolution.
|
|
* @return {number|undefined} The resolution of the view.
|
|
* @observable
|
|
* @api
|
|
*/
|
|
View.prototype.getResolution = function () {
|
|
return /** @type {number|undefined} */ (this.get(ViewProperty.RESOLUTION));
|
|
};
|
|
/**
|
|
* Get the resolutions for the view. This returns the array of resolutions
|
|
* passed to the constructor of the View, or undefined if none were given.
|
|
* @return {Array<number>|undefined} The resolutions of the view.
|
|
* @api
|
|
*/
|
|
View.prototype.getResolutions = function () {
|
|
return this.resolutions_;
|
|
};
|
|
/**
|
|
* Get the resolution for a provided extent (in map units) and size (in pixels).
|
|
* @param {import("./extent.js").Extent} extent Extent.
|
|
* @param {import("./size.js").Size} [opt_size] Box pixel size.
|
|
* @return {number} The resolution at which the provided extent will render at
|
|
* the given size.
|
|
* @api
|
|
*/
|
|
View.prototype.getResolutionForExtent = function (extent, opt_size) {
|
|
return this.getResolutionForExtentInternal(fromUserExtent(extent, this.getProjection()), opt_size);
|
|
};
|
|
/**
|
|
* Get the resolution for a provided extent (in map units) and size (in pixels).
|
|
* @param {import("./extent.js").Extent} extent Extent.
|
|
* @param {import("./size.js").Size} [opt_size] Box pixel size.
|
|
* @return {number} The resolution at which the provided extent will render at
|
|
* the given size.
|
|
*/
|
|
View.prototype.getResolutionForExtentInternal = function (extent, opt_size) {
|
|
var size = opt_size || this.getViewportSizeMinusPadding_();
|
|
var xResolution = getWidth(extent) / size[0];
|
|
var yResolution = getHeight(extent) / size[1];
|
|
return Math.max(xResolution, yResolution);
|
|
};
|
|
/**
|
|
* Return a function that returns a value between 0 and 1 for a
|
|
* resolution. Exponential scaling is assumed.
|
|
* @param {number} [opt_power] Power.
|
|
* @return {function(number): number} Resolution for value function.
|
|
*/
|
|
View.prototype.getResolutionForValueFunction = function (opt_power) {
|
|
var power = opt_power || 2;
|
|
var maxResolution = this.getConstrainedResolution(this.maxResolution_);
|
|
var minResolution = this.minResolution_;
|
|
var max = Math.log(maxResolution / minResolution) / Math.log(power);
|
|
return (
|
|
/**
|
|
* @param {number} value Value.
|
|
* @return {number} Resolution.
|
|
*/
|
|
function (value) {
|
|
var resolution = maxResolution / Math.pow(power, value * max);
|
|
return resolution;
|
|
});
|
|
};
|
|
/**
|
|
* Get the view rotation.
|
|
* @return {number} The rotation of the view in radians.
|
|
* @observable
|
|
* @api
|
|
*/
|
|
View.prototype.getRotation = function () {
|
|
return /** @type {number} */ (this.get(ViewProperty.ROTATION));
|
|
};
|
|
/**
|
|
* Return a function that returns a resolution for a value between
|
|
* 0 and 1. Exponential scaling is assumed.
|
|
* @param {number} [opt_power] Power.
|
|
* @return {function(number): number} Value for resolution function.
|
|
*/
|
|
View.prototype.getValueForResolutionFunction = function (opt_power) {
|
|
var logPower = Math.log(opt_power || 2);
|
|
var maxResolution = this.getConstrainedResolution(this.maxResolution_);
|
|
var minResolution = this.minResolution_;
|
|
var max = Math.log(maxResolution / minResolution) / logPower;
|
|
return (
|
|
/**
|
|
* @param {number} resolution Resolution.
|
|
* @return {number} Value.
|
|
*/
|
|
function (resolution) {
|
|
var value = Math.log(maxResolution / resolution) / logPower / max;
|
|
return value;
|
|
});
|
|
};
|
|
/**
|
|
* Returns the size of the viewport minus padding.
|
|
* @private
|
|
* @param {number} [opt_rotation] Take into account the rotation of the viewport when giving the size
|
|
* @return {import("./size.js").Size} Viewport size reduced by the padding.
|
|
*/
|
|
View.prototype.getViewportSizeMinusPadding_ = function (opt_rotation) {
|
|
var size = this.getViewportSize_(opt_rotation);
|
|
var padding = this.padding_;
|
|
if (padding) {
|
|
size = [
|
|
size[0] - padding[1] - padding[3],
|
|
size[1] - padding[0] - padding[2],
|
|
];
|
|
}
|
|
return size;
|
|
};
|
|
/**
|
|
* @return {State} View state.
|
|
*/
|
|
View.prototype.getState = function () {
|
|
var projection = this.getProjection();
|
|
var resolution = this.getResolution();
|
|
var rotation = this.getRotation();
|
|
var center = /** @type {import("./coordinate.js").Coordinate} */ (this.getCenterInternal());
|
|
var padding = this.padding_;
|
|
if (padding) {
|
|
var reducedSize = this.getViewportSizeMinusPadding_();
|
|
center = calculateCenterOn(center, this.getViewportSize_(), [reducedSize[0] / 2 + padding[3], reducedSize[1] / 2 + padding[0]], resolution, rotation);
|
|
}
|
|
return {
|
|
center: center.slice(0),
|
|
projection: projection !== undefined ? projection : null,
|
|
resolution: resolution,
|
|
nextCenter: this.nextCenter_,
|
|
nextResolution: this.nextResolution_,
|
|
nextRotation: this.nextRotation_,
|
|
rotation: rotation,
|
|
zoom: this.getZoom(),
|
|
};
|
|
};
|
|
/**
|
|
* Get the current zoom level. This method may return non-integer zoom levels
|
|
* if the view does not constrain the resolution, or if an interaction or
|
|
* animation is underway.
|
|
* @return {number|undefined} Zoom.
|
|
* @api
|
|
*/
|
|
View.prototype.getZoom = function () {
|
|
var zoom;
|
|
var resolution = this.getResolution();
|
|
if (resolution !== undefined) {
|
|
zoom = this.getZoomForResolution(resolution);
|
|
}
|
|
return zoom;
|
|
};
|
|
/**
|
|
* Get the zoom level for a resolution.
|
|
* @param {number} resolution The resolution.
|
|
* @return {number|undefined} The zoom level for the provided resolution.
|
|
* @api
|
|
*/
|
|
View.prototype.getZoomForResolution = function (resolution) {
|
|
var offset = this.minZoom_ || 0;
|
|
var max, zoomFactor;
|
|
if (this.resolutions_) {
|
|
var nearest = linearFindNearest(this.resolutions_, resolution, 1);
|
|
offset = nearest;
|
|
max = this.resolutions_[nearest];
|
|
if (nearest == this.resolutions_.length - 1) {
|
|
zoomFactor = 2;
|
|
}
|
|
else {
|
|
zoomFactor = max / this.resolutions_[nearest + 1];
|
|
}
|
|
}
|
|
else {
|
|
max = this.maxResolution_;
|
|
zoomFactor = this.zoomFactor_;
|
|
}
|
|
return offset + Math.log(max / resolution) / Math.log(zoomFactor);
|
|
};
|
|
/**
|
|
* Get the resolution for a zoom level.
|
|
* @param {number} zoom Zoom level.
|
|
* @return {number} The view resolution for the provided zoom level.
|
|
* @api
|
|
*/
|
|
View.prototype.getResolutionForZoom = function (zoom) {
|
|
if (this.resolutions_) {
|
|
if (this.resolutions_.length <= 1) {
|
|
return 0;
|
|
}
|
|
var baseLevel = clamp(Math.floor(zoom), 0, this.resolutions_.length - 2);
|
|
var zoomFactor = this.resolutions_[baseLevel] / this.resolutions_[baseLevel + 1];
|
|
return (this.resolutions_[baseLevel] /
|
|
Math.pow(zoomFactor, clamp(zoom - baseLevel, 0, 1)));
|
|
}
|
|
else {
|
|
return (this.maxResolution_ / Math.pow(this.zoomFactor_, zoom - this.minZoom_));
|
|
}
|
|
};
|
|
/**
|
|
* Fit the given geometry or extent based on the given map size and border.
|
|
* The size is pixel dimensions of the box to fit the extent into.
|
|
* In most cases you will want to use the map size, that is `map.getSize()`.
|
|
* Takes care of the map angle.
|
|
* @param {import("./geom/SimpleGeometry.js").default|import("./extent.js").Extent} geometryOrExtent The geometry or
|
|
* extent to fit the view to.
|
|
* @param {FitOptions} [opt_options] Options.
|
|
* @api
|
|
*/
|
|
View.prototype.fit = function (geometryOrExtent, opt_options) {
|
|
/** @type {import("./geom/SimpleGeometry.js").default} */
|
|
var geometry;
|
|
assert(Array.isArray(geometryOrExtent) ||
|
|
typeof ( /** @type {?} */(geometryOrExtent).getSimplifiedGeometry) ===
|
|
'function', 24); // Invalid extent or geometry provided as `geometry`
|
|
if (Array.isArray(geometryOrExtent)) {
|
|
assert(!isEmpty(geometryOrExtent), 25); // Cannot fit empty extent provided as `geometry`
|
|
var extent = fromUserExtent(geometryOrExtent, this.getProjection());
|
|
geometry = polygonFromExtent(extent);
|
|
}
|
|
else if (geometryOrExtent.getType() === 'Circle') {
|
|
var extent = fromUserExtent(geometryOrExtent.getExtent(), this.getProjection());
|
|
geometry = polygonFromExtent(extent);
|
|
geometry.rotate(this.getRotation(), getCenter(extent));
|
|
}
|
|
else {
|
|
var userProjection = getUserProjection();
|
|
if (userProjection) {
|
|
geometry = /** @type {import("./geom/SimpleGeometry.js").default} */ (geometryOrExtent
|
|
.clone()
|
|
.transform(userProjection, this.getProjection()));
|
|
}
|
|
else {
|
|
geometry = geometryOrExtent;
|
|
}
|
|
}
|
|
this.fitInternal(geometry, opt_options);
|
|
};
|
|
/**
|
|
* Calculate rotated extent
|
|
* @param {import("./geom/SimpleGeometry.js").default} geometry The geometry.
|
|
* @return {import("./extent").Extent} The rotated extent for the geometry.
|
|
*/
|
|
View.prototype.rotatedExtentForGeometry = function (geometry) {
|
|
var rotation = this.getRotation();
|
|
var cosAngle = Math.cos(rotation);
|
|
var sinAngle = Math.sin(-rotation);
|
|
var coords = geometry.getFlatCoordinates();
|
|
var stride = geometry.getStride();
|
|
var minRotX = +Infinity;
|
|
var minRotY = +Infinity;
|
|
var maxRotX = -Infinity;
|
|
var maxRotY = -Infinity;
|
|
for (var i = 0, ii = coords.length; i < ii; i += stride) {
|
|
var rotX = coords[i] * cosAngle - coords[i + 1] * sinAngle;
|
|
var rotY = coords[i] * sinAngle + coords[i + 1] * cosAngle;
|
|
minRotX = Math.min(minRotX, rotX);
|
|
minRotY = Math.min(minRotY, rotY);
|
|
maxRotX = Math.max(maxRotX, rotX);
|
|
maxRotY = Math.max(maxRotY, rotY);
|
|
}
|
|
return [minRotX, minRotY, maxRotX, maxRotY];
|
|
};
|
|
/**
|
|
* @param {import("./geom/SimpleGeometry.js").default} geometry The geometry.
|
|
* @param {FitOptions} [opt_options] Options.
|
|
*/
|
|
View.prototype.fitInternal = function (geometry, opt_options) {
|
|
var options = opt_options || {};
|
|
var size = options.size;
|
|
if (!size) {
|
|
size = this.getViewportSizeMinusPadding_();
|
|
}
|
|
var padding = options.padding !== undefined ? options.padding : [0, 0, 0, 0];
|
|
var nearest = options.nearest !== undefined ? options.nearest : false;
|
|
var minResolution;
|
|
if (options.minResolution !== undefined) {
|
|
minResolution = options.minResolution;
|
|
}
|
|
else if (options.maxZoom !== undefined) {
|
|
minResolution = this.getResolutionForZoom(options.maxZoom);
|
|
}
|
|
else {
|
|
minResolution = 0;
|
|
}
|
|
var rotatedExtent = this.rotatedExtentForGeometry(geometry);
|
|
// calculate resolution
|
|
var resolution = this.getResolutionForExtentInternal(rotatedExtent, [
|
|
size[0] - padding[1] - padding[3],
|
|
size[1] - padding[0] - padding[2],
|
|
]);
|
|
resolution = isNaN(resolution)
|
|
? minResolution
|
|
: Math.max(resolution, minResolution);
|
|
resolution = this.getConstrainedResolution(resolution, nearest ? 0 : 1);
|
|
// calculate center
|
|
var rotation = this.getRotation();
|
|
var sinAngle = Math.sin(rotation);
|
|
var cosAngle = Math.cos(rotation);
|
|
var centerRot = getCenter(rotatedExtent);
|
|
centerRot[0] += ((padding[1] - padding[3]) / 2) * resolution;
|
|
centerRot[1] += ((padding[0] - padding[2]) / 2) * resolution;
|
|
var centerX = centerRot[0] * cosAngle - centerRot[1] * sinAngle;
|
|
var centerY = centerRot[1] * cosAngle + centerRot[0] * sinAngle;
|
|
var center = this.getConstrainedCenter([centerX, centerY], resolution);
|
|
var callback = options.callback ? options.callback : VOID;
|
|
if (options.duration !== undefined) {
|
|
this.animateInternal({
|
|
resolution: resolution,
|
|
center: center,
|
|
duration: options.duration,
|
|
easing: options.easing,
|
|
}, callback);
|
|
}
|
|
else {
|
|
this.targetResolution_ = resolution;
|
|
this.targetCenter_ = center;
|
|
this.applyTargetState_(false, true);
|
|
animationCallback(callback, true);
|
|
}
|
|
};
|
|
/**
|
|
* Center on coordinate and view position.
|
|
* @param {import("./coordinate.js").Coordinate} coordinate Coordinate.
|
|
* @param {import("./size.js").Size} size Box pixel size.
|
|
* @param {import("./pixel.js").Pixel} position Position on the view to center on.
|
|
* @api
|
|
*/
|
|
View.prototype.centerOn = function (coordinate, size, position) {
|
|
this.centerOnInternal(fromUserCoordinate(coordinate, this.getProjection()), size, position);
|
|
};
|
|
/**
|
|
* @param {import("./coordinate.js").Coordinate} coordinate Coordinate.
|
|
* @param {import("./size.js").Size} size Box pixel size.
|
|
* @param {import("./pixel.js").Pixel} position Position on the view to center on.
|
|
*/
|
|
View.prototype.centerOnInternal = function (coordinate, size, position) {
|
|
this.setCenterInternal(calculateCenterOn(coordinate, size, position, this.getResolution(), this.getRotation()));
|
|
};
|
|
/**
|
|
* Calculates the shift between map and viewport center.
|
|
* @param {import("./coordinate.js").Coordinate} center Center.
|
|
* @param {number} resolution Resolution.
|
|
* @param {number} rotation Rotation.
|
|
* @param {import("./size.js").Size} size Size.
|
|
* @return {Array<number>|undefined} Center shift.
|
|
*/
|
|
View.prototype.calculateCenterShift = function (center, resolution, rotation, size) {
|
|
var centerShift;
|
|
var padding = this.padding_;
|
|
if (padding && center) {
|
|
var reducedSize = this.getViewportSizeMinusPadding_(-rotation);
|
|
var shiftedCenter = calculateCenterOn(center, size, [reducedSize[0] / 2 + padding[3], reducedSize[1] / 2 + padding[0]], resolution, rotation);
|
|
centerShift = [
|
|
center[0] - shiftedCenter[0],
|
|
center[1] - shiftedCenter[1],
|
|
];
|
|
}
|
|
return centerShift;
|
|
};
|
|
/**
|
|
* @return {boolean} Is defined.
|
|
*/
|
|
View.prototype.isDef = function () {
|
|
return !!this.getCenterInternal() && this.getResolution() !== undefined;
|
|
};
|
|
/**
|
|
* Adds relative coordinates to the center of the view. Any extent constraint will apply.
|
|
* @param {import("./coordinate.js").Coordinate} deltaCoordinates Relative value to add.
|
|
* @api
|
|
*/
|
|
View.prototype.adjustCenter = function (deltaCoordinates) {
|
|
var center = toUserCoordinate(this.targetCenter_, this.getProjection());
|
|
this.setCenter([
|
|
center[0] + deltaCoordinates[0],
|
|
center[1] + deltaCoordinates[1],
|
|
]);
|
|
};
|
|
/**
|
|
* Adds relative coordinates to the center of the view. Any extent constraint will apply.
|
|
* @param {import("./coordinate.js").Coordinate} deltaCoordinates Relative value to add.
|
|
*/
|
|
View.prototype.adjustCenterInternal = function (deltaCoordinates) {
|
|
var center = this.targetCenter_;
|
|
this.setCenterInternal([
|
|
center[0] + deltaCoordinates[0],
|
|
center[1] + deltaCoordinates[1],
|
|
]);
|
|
};
|
|
/**
|
|
* Multiply the view resolution by a ratio, optionally using an anchor. Any resolution
|
|
* constraint will apply.
|
|
* @param {number} ratio The ratio to apply on the view resolution.
|
|
* @param {import("./coordinate.js").Coordinate} [opt_anchor] The origin of the transformation.
|
|
* @api
|
|
*/
|
|
View.prototype.adjustResolution = function (ratio, opt_anchor) {
|
|
var anchor = opt_anchor && fromUserCoordinate(opt_anchor, this.getProjection());
|
|
this.adjustResolutionInternal(ratio, anchor);
|
|
};
|
|
/**
|
|
* Multiply the view resolution by a ratio, optionally using an anchor. Any resolution
|
|
* constraint will apply.
|
|
* @param {number} ratio The ratio to apply on the view resolution.
|
|
* @param {import("./coordinate.js").Coordinate} [opt_anchor] The origin of the transformation.
|
|
*/
|
|
View.prototype.adjustResolutionInternal = function (ratio, opt_anchor) {
|
|
var isMoving = this.getAnimating() || this.getInteracting();
|
|
var size = this.getViewportSize_(this.getRotation());
|
|
var newResolution = this.constraints_.resolution(this.targetResolution_ * ratio, 0, size, isMoving);
|
|
if (opt_anchor) {
|
|
this.targetCenter_ = this.calculateCenterZoom(newResolution, opt_anchor);
|
|
}
|
|
this.targetResolution_ *= ratio;
|
|
this.applyTargetState_();
|
|
};
|
|
/**
|
|
* Adds a value to the view zoom level, optionally using an anchor. Any resolution
|
|
* constraint will apply.
|
|
* @param {number} delta Relative value to add to the zoom level.
|
|
* @param {import("./coordinate.js").Coordinate} [opt_anchor] The origin of the transformation.
|
|
* @api
|
|
*/
|
|
View.prototype.adjustZoom = function (delta, opt_anchor) {
|
|
this.adjustResolution(Math.pow(this.zoomFactor_, -delta), opt_anchor);
|
|
};
|
|
/**
|
|
* Adds a value to the view rotation, optionally using an anchor. Any rotation
|
|
* constraint will apply.
|
|
* @param {number} delta Relative value to add to the zoom rotation, in radians.
|
|
* @param {import("./coordinate.js").Coordinate} [opt_anchor] The rotation center.
|
|
* @api
|
|
*/
|
|
View.prototype.adjustRotation = function (delta, opt_anchor) {
|
|
if (opt_anchor) {
|
|
opt_anchor = fromUserCoordinate(opt_anchor, this.getProjection());
|
|
}
|
|
this.adjustRotationInternal(delta, opt_anchor);
|
|
};
|
|
/**
|
|
* @param {number} delta Relative value to add to the zoom rotation, in radians.
|
|
* @param {import("./coordinate.js").Coordinate} [opt_anchor] The rotation center.
|
|
*/
|
|
View.prototype.adjustRotationInternal = function (delta, opt_anchor) {
|
|
var isMoving = this.getAnimating() || this.getInteracting();
|
|
var newRotation = this.constraints_.rotation(this.targetRotation_ + delta, isMoving);
|
|
if (opt_anchor) {
|
|
this.targetCenter_ = this.calculateCenterRotate(newRotation, opt_anchor);
|
|
}
|
|
this.targetRotation_ += delta;
|
|
this.applyTargetState_();
|
|
};
|
|
/**
|
|
* Set the center of the current view. Any extent constraint will apply.
|
|
* @param {import("./coordinate.js").Coordinate|undefined} center The center of the view.
|
|
* @observable
|
|
* @api
|
|
*/
|
|
View.prototype.setCenter = function (center) {
|
|
this.setCenterInternal(center ? fromUserCoordinate(center, this.getProjection()) : center);
|
|
};
|
|
/**
|
|
* Set the center using the view projection (not the user projection).
|
|
* @param {import("./coordinate.js").Coordinate|undefined} center The center of the view.
|
|
*/
|
|
View.prototype.setCenterInternal = function (center) {
|
|
this.targetCenter_ = center;
|
|
this.applyTargetState_();
|
|
};
|
|
/**
|
|
* @param {import("./ViewHint.js").default} hint Hint.
|
|
* @param {number} delta Delta.
|
|
* @return {number} New value.
|
|
*/
|
|
View.prototype.setHint = function (hint, delta) {
|
|
this.hints_[hint] += delta;
|
|
this.changed();
|
|
return this.hints_[hint];
|
|
};
|
|
/**
|
|
* Set the resolution for this view. Any resolution constraint will apply.
|
|
* @param {number|undefined} resolution The resolution of the view.
|
|
* @observable
|
|
* @api
|
|
*/
|
|
View.prototype.setResolution = function (resolution) {
|
|
this.targetResolution_ = resolution;
|
|
this.applyTargetState_();
|
|
};
|
|
/**
|
|
* Set the rotation for this view. Any rotation constraint will apply.
|
|
* @param {number} rotation The rotation of the view in radians.
|
|
* @observable
|
|
* @api
|
|
*/
|
|
View.prototype.setRotation = function (rotation) {
|
|
this.targetRotation_ = rotation;
|
|
this.applyTargetState_();
|
|
};
|
|
/**
|
|
* Zoom to a specific zoom level. Any resolution constrain will apply.
|
|
* @param {number} zoom Zoom level.
|
|
* @api
|
|
*/
|
|
View.prototype.setZoom = function (zoom) {
|
|
this.setResolution(this.getResolutionForZoom(zoom));
|
|
};
|
|
/**
|
|
* Recompute rotation/resolution/center based on target values.
|
|
* Note: we have to compute rotation first, then resolution and center considering that
|
|
* parameters can influence one another in case a view extent constraint is present.
|
|
* @param {boolean} [opt_doNotCancelAnims] Do not cancel animations.
|
|
* @param {boolean} [opt_forceMoving] Apply constraints as if the view is moving.
|
|
* @private
|
|
*/
|
|
View.prototype.applyTargetState_ = function (opt_doNotCancelAnims, opt_forceMoving) {
|
|
var isMoving = this.getAnimating() || this.getInteracting() || opt_forceMoving;
|
|
// compute rotation
|
|
var newRotation = this.constraints_.rotation(this.targetRotation_, isMoving);
|
|
var size = this.getViewportSize_(newRotation);
|
|
var newResolution = this.constraints_.resolution(this.targetResolution_, 0, size, isMoving);
|
|
var newCenter = this.constraints_.center(this.targetCenter_, newResolution, size, isMoving, this.calculateCenterShift(this.targetCenter_, newResolution, newRotation, size));
|
|
if (this.get(ViewProperty.ROTATION) !== newRotation) {
|
|
this.set(ViewProperty.ROTATION, newRotation);
|
|
}
|
|
if (this.get(ViewProperty.RESOLUTION) !== newResolution) {
|
|
this.set(ViewProperty.RESOLUTION, newResolution);
|
|
this.set('zoom', this.getZoom(), true);
|
|
}
|
|
if (!newCenter ||
|
|
!this.get(ViewProperty.CENTER) ||
|
|
!equals(this.get(ViewProperty.CENTER), newCenter)) {
|
|
this.set(ViewProperty.CENTER, newCenter);
|
|
}
|
|
if (this.getAnimating() && !opt_doNotCancelAnims) {
|
|
this.cancelAnimations();
|
|
}
|
|
this.cancelAnchor_ = undefined;
|
|
};
|
|
/**
|
|
* If any constraints need to be applied, an animation will be triggered.
|
|
* This is typically done on interaction end.
|
|
* Note: calling this with a duration of 0 will apply the constrained values straight away,
|
|
* without animation.
|
|
* @param {number} [opt_duration] The animation duration in ms.
|
|
* @param {number} [opt_resolutionDirection] Which direction to zoom.
|
|
* @param {import("./coordinate.js").Coordinate} [opt_anchor] The origin of the transformation.
|
|
*/
|
|
View.prototype.resolveConstraints = function (opt_duration, opt_resolutionDirection, opt_anchor) {
|
|
var duration = opt_duration !== undefined ? opt_duration : 200;
|
|
var direction = opt_resolutionDirection || 0;
|
|
var newRotation = this.constraints_.rotation(this.targetRotation_);
|
|
var size = this.getViewportSize_(newRotation);
|
|
var newResolution = this.constraints_.resolution(this.targetResolution_, direction, size);
|
|
var newCenter = this.constraints_.center(this.targetCenter_, newResolution, size, false, this.calculateCenterShift(this.targetCenter_, newResolution, newRotation, size));
|
|
if (duration === 0 && !this.cancelAnchor_) {
|
|
this.targetResolution_ = newResolution;
|
|
this.targetRotation_ = newRotation;
|
|
this.targetCenter_ = newCenter;
|
|
this.applyTargetState_();
|
|
return;
|
|
}
|
|
var anchor = opt_anchor || (duration === 0 ? this.cancelAnchor_ : undefined);
|
|
this.cancelAnchor_ = undefined;
|
|
if (this.getResolution() !== newResolution ||
|
|
this.getRotation() !== newRotation ||
|
|
!this.getCenterInternal() ||
|
|
!equals(this.getCenterInternal(), newCenter)) {
|
|
if (this.getAnimating()) {
|
|
this.cancelAnimations();
|
|
}
|
|
this.animateInternal({
|
|
rotation: newRotation,
|
|
center: newCenter,
|
|
resolution: newResolution,
|
|
duration: duration,
|
|
easing: easeOut,
|
|
anchor: anchor,
|
|
});
|
|
}
|
|
};
|
|
/**
|
|
* Notify the View that an interaction has started.
|
|
* The view state will be resolved to a stable one if needed
|
|
* (depending on its constraints).
|
|
* @api
|
|
*/
|
|
View.prototype.beginInteraction = function () {
|
|
this.resolveConstraints(0);
|
|
this.setHint(ViewHint.INTERACTING, 1);
|
|
};
|
|
/**
|
|
* Notify the View that an interaction has ended. The view state will be resolved
|
|
* to a stable one if needed (depending on its constraints).
|
|
* @param {number} [opt_duration] Animation duration in ms.
|
|
* @param {number} [opt_resolutionDirection] Which direction to zoom.
|
|
* @param {import("./coordinate.js").Coordinate} [opt_anchor] The origin of the transformation.
|
|
* @api
|
|
*/
|
|
View.prototype.endInteraction = function (opt_duration, opt_resolutionDirection, opt_anchor) {
|
|
var anchor = opt_anchor && fromUserCoordinate(opt_anchor, this.getProjection());
|
|
this.endInteractionInternal(opt_duration, opt_resolutionDirection, anchor);
|
|
};
|
|
/**
|
|
* Notify the View that an interaction has ended. The view state will be resolved
|
|
* to a stable one if needed (depending on its constraints).
|
|
* @param {number} [opt_duration] Animation duration in ms.
|
|
* @param {number} [opt_resolutionDirection] Which direction to zoom.
|
|
* @param {import("./coordinate.js").Coordinate} [opt_anchor] The origin of the transformation.
|
|
*/
|
|
View.prototype.endInteractionInternal = function (opt_duration, opt_resolutionDirection, opt_anchor) {
|
|
this.setHint(ViewHint.INTERACTING, -1);
|
|
this.resolveConstraints(opt_duration, opt_resolutionDirection, opt_anchor);
|
|
};
|
|
/**
|
|
* Get a valid position for the view center according to the current constraints.
|
|
* @param {import("./coordinate.js").Coordinate|undefined} targetCenter Target center position.
|
|
* @param {number} [opt_targetResolution] Target resolution. If not supplied, the current one will be used.
|
|
* This is useful to guess a valid center position at a different zoom level.
|
|
* @return {import("./coordinate.js").Coordinate|undefined} Valid center position.
|
|
*/
|
|
View.prototype.getConstrainedCenter = function (targetCenter, opt_targetResolution) {
|
|
var size = this.getViewportSize_(this.getRotation());
|
|
return this.constraints_.center(targetCenter, opt_targetResolution || this.getResolution(), size);
|
|
};
|
|
/**
|
|
* Get a valid zoom level according to the current view constraints.
|
|
* @param {number|undefined} targetZoom Target zoom.
|
|
* @param {number} [opt_direction=0] Indicate which resolution should be used
|
|
* by a renderer if the view resolution does not match any resolution of the tile source.
|
|
* If 0, the nearest resolution will be used. If 1, the nearest lower resolution
|
|
* will be used. If -1, the nearest higher resolution will be used.
|
|
* @return {number|undefined} Valid zoom level.
|
|
*/
|
|
View.prototype.getConstrainedZoom = function (targetZoom, opt_direction) {
|
|
var targetRes = this.getResolutionForZoom(targetZoom);
|
|
return this.getZoomForResolution(this.getConstrainedResolution(targetRes, opt_direction));
|
|
};
|
|
/**
|
|
* Get a valid resolution according to the current view constraints.
|
|
* @param {number|undefined} targetResolution Target resolution.
|
|
* @param {number} [opt_direction=0] Indicate which resolution should be used
|
|
* by a renderer if the view resolution does not match any resolution of the tile source.
|
|
* If 0, the nearest resolution will be used. If 1, the nearest lower resolution
|
|
* will be used. If -1, the nearest higher resolution will be used.
|
|
* @return {number|undefined} Valid resolution.
|
|
*/
|
|
View.prototype.getConstrainedResolution = function (targetResolution, opt_direction) {
|
|
var direction = opt_direction || 0;
|
|
var size = this.getViewportSize_(this.getRotation());
|
|
return this.constraints_.resolution(targetResolution, direction, size);
|
|
};
|
|
return View;
|
|
}(BaseObject));
|
|
/**
|
|
* @param {Function} callback Callback.
|
|
* @param {*} returnValue Return value.
|
|
*/
|
|
function animationCallback(callback, returnValue) {
|
|
setTimeout(function () {
|
|
callback(returnValue);
|
|
}, 0);
|
|
}
|
|
/**
|
|
* @param {ViewOptions} options View options.
|
|
* @return {import("./centerconstraint.js").Type} The constraint.
|
|
*/
|
|
export function createCenterConstraint(options) {
|
|
if (options.extent !== undefined) {
|
|
var smooth = options.smoothExtentConstraint !== undefined
|
|
? options.smoothExtentConstraint
|
|
: true;
|
|
return createExtent(options.extent, options.constrainOnlyCenter, smooth);
|
|
}
|
|
var projection = createProjection(options.projection, 'EPSG:3857');
|
|
if (options.multiWorld !== true && projection.isGlobal()) {
|
|
var extent = projection.getExtent().slice();
|
|
extent[0] = -Infinity;
|
|
extent[2] = Infinity;
|
|
return createExtent(extent, false, false);
|
|
}
|
|
return centerNone;
|
|
}
|
|
/**
|
|
* @param {ViewOptions} options View options.
|
|
* @return {{constraint: import("./resolutionconstraint.js").Type, maxResolution: number,
|
|
* minResolution: number, minZoom: number, zoomFactor: number}} The constraint.
|
|
*/
|
|
export function createResolutionConstraint(options) {
|
|
var resolutionConstraint;
|
|
var maxResolution;
|
|
var minResolution;
|
|
// TODO: move these to be ol constants
|
|
// see https://github.com/openlayers/openlayers/issues/2076
|
|
var defaultMaxZoom = 28;
|
|
var defaultZoomFactor = 2;
|
|
var minZoom = options.minZoom !== undefined ? options.minZoom : DEFAULT_MIN_ZOOM;
|
|
var maxZoom = options.maxZoom !== undefined ? options.maxZoom : defaultMaxZoom;
|
|
var zoomFactor = options.zoomFactor !== undefined ? options.zoomFactor : defaultZoomFactor;
|
|
var multiWorld = options.multiWorld !== undefined ? options.multiWorld : false;
|
|
var smooth = options.smoothResolutionConstraint !== undefined
|
|
? options.smoothResolutionConstraint
|
|
: true;
|
|
var showFullExtent = options.showFullExtent !== undefined ? options.showFullExtent : false;
|
|
var projection = createProjection(options.projection, 'EPSG:3857');
|
|
var projExtent = projection.getExtent();
|
|
var constrainOnlyCenter = options.constrainOnlyCenter;
|
|
var extent = options.extent;
|
|
if (!multiWorld && !extent && projection.isGlobal()) {
|
|
constrainOnlyCenter = false;
|
|
extent = projExtent;
|
|
}
|
|
if (options.resolutions !== undefined) {
|
|
var resolutions = options.resolutions;
|
|
maxResolution = resolutions[minZoom];
|
|
minResolution =
|
|
resolutions[maxZoom] !== undefined
|
|
? resolutions[maxZoom]
|
|
: resolutions[resolutions.length - 1];
|
|
if (options.constrainResolution) {
|
|
resolutionConstraint = createSnapToResolutions(resolutions, smooth, !constrainOnlyCenter && extent, showFullExtent);
|
|
}
|
|
else {
|
|
resolutionConstraint = createMinMaxResolution(maxResolution, minResolution, smooth, !constrainOnlyCenter && extent, showFullExtent);
|
|
}
|
|
}
|
|
else {
|
|
// calculate the default min and max resolution
|
|
var size = !projExtent
|
|
? // use an extent that can fit the whole world if need be
|
|
(360 * METERS_PER_UNIT[Units.DEGREES]) / projection.getMetersPerUnit()
|
|
: Math.max(getWidth(projExtent), getHeight(projExtent));
|
|
var defaultMaxResolution = size / DEFAULT_TILE_SIZE / Math.pow(defaultZoomFactor, DEFAULT_MIN_ZOOM);
|
|
var defaultMinResolution = defaultMaxResolution /
|
|
Math.pow(defaultZoomFactor, defaultMaxZoom - DEFAULT_MIN_ZOOM);
|
|
// user provided maxResolution takes precedence
|
|
maxResolution = options.maxResolution;
|
|
if (maxResolution !== undefined) {
|
|
minZoom = 0;
|
|
}
|
|
else {
|
|
maxResolution = defaultMaxResolution / Math.pow(zoomFactor, minZoom);
|
|
}
|
|
// user provided minResolution takes precedence
|
|
minResolution = options.minResolution;
|
|
if (minResolution === undefined) {
|
|
if (options.maxZoom !== undefined) {
|
|
if (options.maxResolution !== undefined) {
|
|
minResolution = maxResolution / Math.pow(zoomFactor, maxZoom);
|
|
}
|
|
else {
|
|
minResolution = defaultMaxResolution / Math.pow(zoomFactor, maxZoom);
|
|
}
|
|
}
|
|
else {
|
|
minResolution = defaultMinResolution;
|
|
}
|
|
}
|
|
// given discrete zoom levels, minResolution may be different than provided
|
|
maxZoom =
|
|
minZoom +
|
|
Math.floor(Math.log(maxResolution / minResolution) / Math.log(zoomFactor));
|
|
minResolution = maxResolution / Math.pow(zoomFactor, maxZoom - minZoom);
|
|
if (options.constrainResolution) {
|
|
resolutionConstraint = createSnapToPower(zoomFactor, maxResolution, minResolution, smooth, !constrainOnlyCenter && extent, showFullExtent);
|
|
}
|
|
else {
|
|
resolutionConstraint = createMinMaxResolution(maxResolution, minResolution, smooth, !constrainOnlyCenter && extent, showFullExtent);
|
|
}
|
|
}
|
|
return {
|
|
constraint: resolutionConstraint,
|
|
maxResolution: maxResolution,
|
|
minResolution: minResolution,
|
|
minZoom: minZoom,
|
|
zoomFactor: zoomFactor,
|
|
};
|
|
}
|
|
/**
|
|
* @param {ViewOptions} options View options.
|
|
* @return {import("./rotationconstraint.js").Type} Rotation constraint.
|
|
*/
|
|
export function createRotationConstraint(options) {
|
|
var enableRotation = options.enableRotation !== undefined ? options.enableRotation : true;
|
|
if (enableRotation) {
|
|
var constrainRotation = options.constrainRotation;
|
|
if (constrainRotation === undefined || constrainRotation === true) {
|
|
return createSnapToZero();
|
|
}
|
|
else if (constrainRotation === false) {
|
|
return rotationNone;
|
|
}
|
|
else if (typeof constrainRotation === 'number') {
|
|
return createSnapToN(constrainRotation);
|
|
}
|
|
else {
|
|
return rotationNone;
|
|
}
|
|
}
|
|
else {
|
|
return disable;
|
|
}
|
|
}
|
|
/**
|
|
* Determine if an animation involves no view change.
|
|
* @param {Animation} animation The animation.
|
|
* @return {boolean} The animation involves no view change.
|
|
*/
|
|
export function isNoopAnimation(animation) {
|
|
if (animation.sourceCenter && animation.targetCenter) {
|
|
if (!coordinatesEqual(animation.sourceCenter, animation.targetCenter)) {
|
|
return false;
|
|
}
|
|
}
|
|
if (animation.sourceResolution !== animation.targetResolution) {
|
|
return false;
|
|
}
|
|
if (animation.sourceRotation !== animation.targetRotation) {
|
|
return false;
|
|
}
|
|
return true;
|
|
}
|
|
/**
|
|
* @param {import("./coordinate.js").Coordinate} coordinate Coordinate.
|
|
* @param {import("./size.js").Size} size Box pixel size.
|
|
* @param {import("./pixel.js").Pixel} position Position on the view to center on.
|
|
* @param {number} resolution Resolution.
|
|
* @param {number} rotation Rotation.
|
|
* @return {import("./coordinate.js").Coordinate} Shifted center.
|
|
*/
|
|
function calculateCenterOn(coordinate, size, position, resolution, rotation) {
|
|
// calculate rotated position
|
|
var cosAngle = Math.cos(-rotation);
|
|
var sinAngle = Math.sin(-rotation);
|
|
var rotX = coordinate[0] * cosAngle - coordinate[1] * sinAngle;
|
|
var rotY = coordinate[1] * cosAngle + coordinate[0] * sinAngle;
|
|
rotX += (size[0] / 2 - position[0]) * resolution;
|
|
rotY += (position[1] - size[1] / 2) * resolution;
|
|
// go back to original angle
|
|
sinAngle = -sinAngle; // go back to original rotation
|
|
var centerX = rotX * cosAngle - rotY * sinAngle;
|
|
var centerY = rotY * cosAngle + rotX * sinAngle;
|
|
return [centerX, centerY];
|
|
}
|
|
export default View;
|
|
//# sourceMappingURL=View.js.map
|