Files
coopgo/node_modules/ol/resolutionconstraint.js
sgauthier 6e64e138e2
All checks were successful
Publish To Prod / deploy_and_publish (push) Successful in 35s
planning
2024-10-14 09:15:30 +02:00

176 lines
8.0 KiB
JavaScript

/**
* @module ol/resolutionconstraint
*/
import { clamp } from './math.js';
import { getHeight, getWidth } from './extent.js';
import { linearFindNearest } from './array.js';
/**
* @typedef {function((number|undefined), number, import("./size.js").Size, boolean=): (number|undefined)} Type
*/
/**
* Returns a modified resolution taking into account the viewport size and maximum
* allowed extent.
* @param {number} resolution Resolution
* @param {import("./extent.js").Extent} maxExtent Maximum allowed extent.
* @param {import("./size.js").Size} viewportSize Viewport size.
* @param {boolean} showFullExtent Whether to show the full extent.
* @return {number} Capped resolution.
*/
function getViewportClampedResolution(resolution, maxExtent, viewportSize, showFullExtent) {
var xResolution = getWidth(maxExtent) / viewportSize[0];
var yResolution = getHeight(maxExtent) / viewportSize[1];
if (showFullExtent) {
return Math.min(resolution, Math.max(xResolution, yResolution));
}
return Math.min(resolution, Math.min(xResolution, yResolution));
}
/**
* Returns a modified resolution to be between maxResolution and minResolution while
* still allowing the value to be slightly out of bounds.
* Note: the computation is based on the logarithm function (ln):
* - at 1, ln(x) is 0
* - above 1, ln(x) keeps increasing but at a much slower pace than x
* The final result is clamped to prevent getting too far away from bounds.
* @param {number} resolution Resolution.
* @param {number} maxResolution Max resolution.
* @param {number} minResolution Min resolution.
* @return {number} Smoothed resolution.
*/
function getSmoothClampedResolution(resolution, maxResolution, minResolution) {
var result = Math.min(resolution, maxResolution);
var ratio = 50;
result *=
Math.log(1 + ratio * Math.max(0, resolution / maxResolution - 1)) / ratio +
1;
if (minResolution) {
result = Math.max(result, minResolution);
result /=
Math.log(1 + ratio * Math.max(0, minResolution / resolution - 1)) /
ratio +
1;
}
return clamp(result, minResolution / 2, maxResolution * 2);
}
/**
* @param {Array<number>} resolutions Resolutions.
* @param {boolean} [opt_smooth] If true, the view will be able to slightly exceed resolution limits. Default: true.
* @param {import("./extent.js").Extent} [opt_maxExtent] Maximum allowed extent.
* @param {boolean} [opt_showFullExtent] If true, allows us to show the full extent. Default: false.
* @return {Type} Zoom function.
*/
export function createSnapToResolutions(resolutions, opt_smooth, opt_maxExtent, opt_showFullExtent) {
return (
/**
* @param {number|undefined} resolution Resolution.
* @param {number} direction Direction.
* @param {import("./size.js").Size} size Viewport size.
* @param {boolean} [opt_isMoving] True if an interaction or animation is in progress.
* @return {number|undefined} Resolution.
*/
function (resolution, direction, size, opt_isMoving) {
if (resolution !== undefined) {
var maxResolution = resolutions[0];
var minResolution = resolutions[resolutions.length - 1];
var cappedMaxRes = opt_maxExtent
? getViewportClampedResolution(maxResolution, opt_maxExtent, size, opt_showFullExtent)
: maxResolution;
// during interacting or animating, allow intermediary values
if (opt_isMoving) {
var smooth = opt_smooth !== undefined ? opt_smooth : true;
if (!smooth) {
return clamp(resolution, minResolution, cappedMaxRes);
}
return getSmoothClampedResolution(resolution, cappedMaxRes, minResolution);
}
var capped = Math.min(cappedMaxRes, resolution);
var z = Math.floor(linearFindNearest(resolutions, capped, direction));
if (resolutions[z] > cappedMaxRes && z < resolutions.length - 1) {
return resolutions[z + 1];
}
return resolutions[z];
}
else {
return undefined;
}
});
}
/**
* @param {number} power Power.
* @param {number} maxResolution Maximum resolution.
* @param {number} [opt_minResolution] Minimum resolution.
* @param {boolean} [opt_smooth] If true, the view will be able to slightly exceed resolution limits. Default: true.
* @param {import("./extent.js").Extent} [opt_maxExtent] Maximum allowed extent.
* @param {boolean} [opt_showFullExtent] If true, allows us to show the full extent. Default: false.
* @return {Type} Zoom function.
*/
export function createSnapToPower(power, maxResolution, opt_minResolution, opt_smooth, opt_maxExtent, opt_showFullExtent) {
return (
/**
* @param {number|undefined} resolution Resolution.
* @param {number} direction Direction.
* @param {import("./size.js").Size} size Viewport size.
* @param {boolean} [opt_isMoving] True if an interaction or animation is in progress.
* @return {number|undefined} Resolution.
*/
function (resolution, direction, size, opt_isMoving) {
if (resolution !== undefined) {
var cappedMaxRes = opt_maxExtent
? getViewportClampedResolution(maxResolution, opt_maxExtent, size, opt_showFullExtent)
: maxResolution;
var minResolution = opt_minResolution !== undefined ? opt_minResolution : 0;
// during interacting or animating, allow intermediary values
if (opt_isMoving) {
var smooth = opt_smooth !== undefined ? opt_smooth : true;
if (!smooth) {
return clamp(resolution, minResolution, cappedMaxRes);
}
return getSmoothClampedResolution(resolution, cappedMaxRes, minResolution);
}
var tolerance = 1e-9;
var minZoomLevel = Math.ceil(Math.log(maxResolution / cappedMaxRes) / Math.log(power) - tolerance);
var offset = -direction * (0.5 - tolerance) + 0.5;
var capped = Math.min(cappedMaxRes, resolution);
var cappedZoomLevel = Math.floor(Math.log(maxResolution / capped) / Math.log(power) + offset);
var zoomLevel = Math.max(minZoomLevel, cappedZoomLevel);
var newResolution = maxResolution / Math.pow(power, zoomLevel);
return clamp(newResolution, minResolution, cappedMaxRes);
}
else {
return undefined;
}
});
}
/**
* @param {number} maxResolution Max resolution.
* @param {number} minResolution Min resolution.
* @param {boolean} [opt_smooth] If true, the view will be able to slightly exceed resolution limits. Default: true.
* @param {import("./extent.js").Extent} [opt_maxExtent] Maximum allowed extent.
* @param {boolean} [opt_showFullExtent] If true, allows us to show the full extent. Default: false.
* @return {Type} Zoom function.
*/
export function createMinMaxResolution(maxResolution, minResolution, opt_smooth, opt_maxExtent, opt_showFullExtent) {
return (
/**
* @param {number|undefined} resolution Resolution.
* @param {number} direction Direction.
* @param {import("./size.js").Size} size Viewport size.
* @param {boolean} [opt_isMoving] True if an interaction or animation is in progress.
* @return {number|undefined} Resolution.
*/
function (resolution, direction, size, opt_isMoving) {
if (resolution !== undefined) {
var cappedMaxRes = opt_maxExtent
? getViewportClampedResolution(maxResolution, opt_maxExtent, size, opt_showFullExtent)
: maxResolution;
var smooth = opt_smooth !== undefined ? opt_smooth : true;
if (!smooth || !opt_isMoving) {
return clamp(resolution, minResolution, cappedMaxRes);
}
return getSmoothClampedResolution(resolution, cappedMaxRes, minResolution);
}
else {
return undefined;
}
});
}
//# sourceMappingURL=resolutionconstraint.js.map