devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
554 lines (550 loc) • 20.3 kB
JavaScript
/**
* DevExtreme (esm/viz/core/utils.js)
* Version: 21.1.4
* Build date: Mon Jun 21 2021
*
* Copyright (c) 2012 - 2021 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import {
noop
} from "../../core/utils/common";
import {
isDefined,
isNumeric,
isExponential,
isFunction,
isString
} from "../../core/utils/type";
import {
extend
} from "../../core/utils/extend";
import {
each
} from "../../core/utils/iterator";
import {
adjust,
sign
} from "../../core/utils/math";
import dateUtils from "../../core/utils/date";
import Color from "../../color";
var {
PI: PI,
LN10: LN10,
abs: abs,
log: log,
floor: floor,
ceil: ceil,
pow: pow,
sqrt: sqrt,
atan2: atan2
} = Math;
var _min = Math.min;
var _max = Math.max;
var _cos = Math.cos;
var _sin = Math.sin;
var _round = Math.round;
var dateToMilliseconds = dateUtils.dateToMilliseconds;
var MAX_PIXEL_COUNT = 1e10;
var PI_DIV_180 = PI / 180;
var _isNaN = isNaN;
var _Number = Number;
var _NaN = NaN;
export var PANE_PADDING = 10;
export var getLog = function(value, base) {
if (!value) {
return _NaN
}
return log(value) / log(base)
};
export var getAdjustedLog10 = function(value) {
return adjust(getLog(value, 10))
};
export var raiseTo = function(power, base) {
return pow(base, power)
};
export var normalizeAngle = function(angle) {
return (angle % 360 + 360) % 360
};
export var convertAngleToRendererSpace = function(angle) {
return 90 - angle
};
export var degreesToRadians = function(value) {
return PI * value / 180
};
export var getCosAndSin = function(angle) {
var angleInRadians = degreesToRadians(angle);
return {
cos: _cos(angleInRadians),
sin: _sin(angleInRadians)
}
};
var DECIMAL_ORDER_THRESHOLD = 1e-14;
export var getDistance = function(x1, y1, x2, y2) {
var diffX = x2 - x1;
var diffY = y2 - y1;
return sqrt(diffY * diffY + diffX * diffX)
};
export var getDecimalOrder = function(number) {
var n = abs(number);
var cn;
if (!_isNaN(n)) {
if (n > 0) {
n = log(n) / LN10;
cn = ceil(n);
return cn - n < DECIMAL_ORDER_THRESHOLD ? cn : floor(n)
}
return 0
}
return _NaN
};
export var getAppropriateFormat = function(start, end, count) {
var order = _max(getDecimalOrder(start), getDecimalOrder(end));
var precision = -getDecimalOrder(abs(end - start) / count);
var format;
if (!_isNaN(order) && !_isNaN(precision)) {
if (abs(order) <= 4) {
format = "fixedPoint";
precision < 0 && (precision = 0);
precision > 4 && (precision = 4)
} else {
format = "exponential";
precision += order - 1;
precision > 3 && (precision = 3)
}
return {
type: format,
precision: precision
}
}
return null
};
export var roundValue = function(value, precision) {
if (precision > 20) {
precision = 20
}
if (isNumeric(value)) {
if (isExponential(value)) {
return _Number(value.toExponential(precision))
} else {
return _Number(value.toFixed(precision))
}
}
};
export var getPower = function(value) {
return value.toExponential().split("e")[1]
};
export function map(array, callback) {
var i = 0;
var len = array.length;
var result = [];
var value;
while (i < len) {
value = callback(array[i], i);
if (null !== value) {
result.push(value)
}
i++
}
return result
}
function selectByKeys(object, keys) {
return map(keys, key => object[key] ? object[key] : null)
}
function decreaseFields(object, keys, eachDecrease, decrease) {
var dec = decrease;
each(keys, (_, key) => {
if (object[key]) {
object[key] -= eachDecrease;
dec -= eachDecrease
}
});
return dec
}
export function normalizeEnum(value) {
return String(value).toLowerCase()
}
export function setCanvasValues(canvas) {
if (canvas) {
canvas.originalTop = canvas.top;
canvas.originalBottom = canvas.bottom;
canvas.originalLeft = canvas.left;
canvas.originalRight = canvas.right
}
return canvas
}
function normalizeBBoxField(value) {
return -MAX_PIXEL_COUNT < value && value < +MAX_PIXEL_COUNT ? value : 0
}
export function normalizeBBox(bBox) {
var xl = normalizeBBoxField(floor(bBox.x));
var yt = normalizeBBoxField(floor(bBox.y));
var xr = normalizeBBoxField(ceil(bBox.width + bBox.x));
var yb = normalizeBBoxField(ceil(bBox.height + bBox.y));
var result = {
x: xl,
y: yt,
width: xr - xl,
height: yb - yt
};
result.isEmpty = !result.x && !result.y && !result.width && !result.height;
return result
}
export function rotateBBox(bBox, center, angle) {
var cos = _Number(_cos(angle * PI_DIV_180).toFixed(3));
var sin = _Number(_sin(angle * PI_DIV_180).toFixed(3));
var w2 = bBox.width / 2;
var h2 = bBox.height / 2;
var centerX = bBox.x + w2;
var centerY = bBox.y + h2;
var w2_ = abs(w2 * cos) + abs(h2 * sin);
var h2_ = abs(w2 * sin) + abs(h2 * cos);
var centerX_ = center[0] + (centerX - center[0]) * cos + (centerY - center[1]) * sin;
var centerY_ = center[1] - (centerX - center[0]) * sin + (centerY - center[1]) * cos;
return normalizeBBox({
x: centerX_ - w2_,
y: centerY_ - h2_,
width: 2 * w2_,
height: 2 * h2_
})
}
export var decreaseGaps = function(object, keys, decrease) {
var arrayGaps;
do {
arrayGaps = selectByKeys(object, keys);
arrayGaps.push(ceil(decrease / arrayGaps.length));
decrease = decreaseFields(object, keys, _min.apply(null, arrayGaps), decrease)
} while (decrease > 0 && arrayGaps.length > 1);
return decrease
};
export var parseScalar = function(value, defaultValue) {
return void 0 !== value ? value : defaultValue
};
export var enumParser = function(values) {
var stored = {};
var i;
var ii;
for (i = 0, ii = values.length; i < ii; ++i) {
stored[normalizeEnum(values[i])] = 1
}
return function(value, defaultValue) {
var _value = normalizeEnum(value);
return stored[_value] ? _value : defaultValue
}
};
export var patchFontOptions = function(options) {
var fontOptions = {};
each(options || {}, (function(key, value) {
if (/^(cursor)$/i.test(key)) {} else if ("opacity" === key) {
value = null
} else if ("color" === key) {
key = "fill";
if ("opacity" in options) {
var color = new Color(value);
value = "rgba(".concat(color.r, ",").concat(color.g, ",").concat(color.b, ",").concat(options.opacity, ")")
}
} else {
key = "font-" + key
}
fontOptions[key] = value
}));
return fontOptions
};
export function convertPolarToXY(centerCoords, startAngle, angle, radius) {
var normalizedRadius = radius > 0 ? radius : 0;
angle = isDefined(angle) ? angle + startAngle - 90 : 0;
var cosSin = getCosAndSin(angle);
return {
x: _round(centerCoords.x + normalizedRadius * cosSin.cos),
y: _round(centerCoords.y + normalizedRadius * cosSin.sin)
}
}
export var convertXYToPolar = function(centerCoords, x, y) {
var radius = getDistance(centerCoords.x, centerCoords.y, x, y);
var angle = atan2(y - centerCoords.y, x - centerCoords.x);
return {
phi: _round(normalizeAngle(180 * angle / PI)),
r: _round(radius)
}
};
export var processSeriesTemplate = function(seriesTemplate, items) {
var customizeSeries = isFunction(seriesTemplate.customizeSeries) ? seriesTemplate.customizeSeries : noop;
var nameField = seriesTemplate.nameField;
var generatedSeries = {};
var seriesOrder = [];
var series;
var i = 0;
var length;
var data;
items = items || [];
for (length = items.length; i < length; i++) {
data = items[i];
if (nameField in data) {
series = generatedSeries[data[nameField]];
if (!series) {
series = generatedSeries[data[nameField]] = {
name: data[nameField],
nameFieldValue: data[nameField]
};
seriesOrder.push(series.name)
}
}
}
return map(seriesOrder, (function(orderedName) {
var group = generatedSeries[orderedName];
return extend(group, customizeSeries.call(null, group.name))
}))
};
export var getCategoriesInfo = function(categories, startValue, endValue) {
if (0 === categories.length) {
return {
categories: []
}
}
startValue = isDefined(startValue) ? startValue : categories[0];
endValue = isDefined(endValue) ? endValue : categories[categories.length - 1];
var categoriesValue = map(categories, category => null === category || void 0 === category ? void 0 : category.valueOf());
var indexStartValue = categoriesValue.indexOf(startValue.valueOf());
var indexEndValue = categoriesValue.indexOf(endValue.valueOf());
var swapBuf;
var inverted = false;
indexStartValue < 0 && (indexStartValue = 0);
indexEndValue < 0 && (indexEndValue = categories.length - 1);
if (indexEndValue < indexStartValue) {
swapBuf = indexEndValue;
indexEndValue = indexStartValue;
indexStartValue = swapBuf;
inverted = true
}
var visibleCategories = categories.slice(indexStartValue, indexEndValue + 1);
var lastIdx = visibleCategories.length - 1;
return {
categories: visibleCategories,
start: visibleCategories[inverted ? lastIdx : 0],
end: visibleCategories[inverted ? 0 : lastIdx],
inverted: inverted
}
};
export function isRelativeHeightPane(pane) {
return !(pane.unit % 2)
}
export function normalizePanesHeight(panes) {
panes.forEach(pane => {
var height = pane.height;
var unit = 0;
var parsedHeight = parseFloat(height) || void 0;
if (isString(height) && height.indexOf("px") > -1 || isNumeric(height) && height > 1) {
parsedHeight = _round(parsedHeight);
unit = 1
}
if (!unit && parsedHeight) {
if (isString(height) && height.indexOf("%") > -1) {
parsedHeight /= 100;
unit = 2
} else if (parsedHeight < 0) {
parsedHeight = parsedHeight < -1 ? 1 : abs(parsedHeight)
}
}
pane.height = parsedHeight;
pane.unit = unit
});
var relativeHeightPanes = panes.filter(isRelativeHeightPane);
var weightSum = relativeHeightPanes.reduce((prev, next) => prev + (next.height || 0), 0);
var weightHeightCount = relativeHeightPanes.length;
var emptyHeightPanes = relativeHeightPanes.filter(pane => !pane.height);
var emptyHeightCount = emptyHeightPanes.length;
if (weightSum < 1 && emptyHeightCount) {
emptyHeightPanes.forEach(pane => pane.height = (1 - weightSum) / emptyHeightCount)
} else if (weightSum > 1 || weightSum < 1 && !emptyHeightCount || 1 === weightSum && emptyHeightCount) {
if (emptyHeightCount) {
var weightForEmpty = weightSum / weightHeightCount;
var emptyWeightSum = emptyHeightCount * weightForEmpty;
relativeHeightPanes.filter(pane => pane.height).forEach(pane => pane.height *= (weightSum - emptyWeightSum) / weightSum);
emptyHeightPanes.forEach(pane => pane.height = weightForEmpty)
}
relativeHeightPanes.forEach(pane => pane.height *= 1 / weightSum)
}
}
export function updatePanesCanvases(panes, canvas, rotated) {
var distributedSpace = 0;
var padding = PANE_PADDING;
var paneSpace = rotated ? canvas.width - canvas.left - canvas.right : canvas.height - canvas.top - canvas.bottom;
var totalCustomSpace = panes.reduce((prev, cur) => prev + (!isRelativeHeightPane(cur) ? cur.height : 0), 0);
var usefulSpace = paneSpace - padding * (panes.length - 1) - totalCustomSpace;
var startName = rotated ? "left" : "top";
var endName = rotated ? "right" : "bottom";
panes.forEach(pane => {
var calcLength = !isRelativeHeightPane(pane) ? pane.height : _round(pane.height * usefulSpace);
pane.canvas = pane.canvas || {};
extend(pane.canvas, canvas);
pane.canvas[startName] = canvas[startName] + distributedSpace;
pane.canvas[endName] = canvas[endName] + (paneSpace - calcLength - distributedSpace);
distributedSpace = distributedSpace + calcLength + padding;
setCanvasValues(pane.canvas)
})
}
export var unique = function(array) {
var values = {};
return map(array, (function(item) {
var result = !values[item] ? item : null;
values[item] = true;
return result
}))
};
export var getVerticallyShiftedAngularCoords = function(bBox, dy, center) {
var isPositive = bBox.x + bBox.width / 2 >= center.x;
var horizontalOffset1 = (isPositive ? bBox.x : bBox.x + bBox.width) - center.x;
var verticalOffset1 = bBox.y - center.y;
var verticalOffset2 = verticalOffset1 + dy;
var horizontalOffset2 = _round(sqrt(horizontalOffset1 * horizontalOffset1 + verticalOffset1 * verticalOffset1 - verticalOffset2 * verticalOffset2));
var dx = (isPositive ? +horizontalOffset2 : -horizontalOffset2) || horizontalOffset1;
return {
x: center.x + (isPositive ? dx : dx - bBox.width),
y: bBox.y + dy
}
};
export function mergeMarginOptions(opt1, opt2) {
return {
checkInterval: opt1.checkInterval || opt2.checkInterval,
size: _max(opt1.size || 0, opt2.size || 0),
percentStick: opt1.percentStick || opt2.percentStick,
sizePointNormalState: _max(opt1.sizePointNormalState || 0, opt2.sizePointNormalState || 0)
}
}
export function getVizRangeObject(value) {
if (Array.isArray(value)) {
return {
startValue: value[0],
endValue: value[1]
}
} else {
return value || {}
}
}
export function convertVisualRangeObject(visualRange, convertToVisualRange) {
if (convertToVisualRange) {
return visualRange
}
return [visualRange.startValue, visualRange.endValue]
}
export function getAddFunction(range, correctZeroLevel) {
if ("datetime" === range.dataType) {
return function(rangeValue, marginValue) {
var sign = arguments.length > 2 && void 0 !== arguments[2] ? arguments[2] : 1;
return new Date(rangeValue.getTime() + sign * marginValue)
}
}
if ("logarithmic" === range.axisType) {
return function(rangeValue, marginValue) {
var sign = arguments.length > 2 && void 0 !== arguments[2] ? arguments[2] : 1;
var log = getLogExt(rangeValue, range.base) + sign * marginValue;
return raiseToExt(log, range.base)
}
}
return function(rangeValue, marginValue) {
var sign = arguments.length > 2 && void 0 !== arguments[2] ? arguments[2] : 1;
var newValue = rangeValue + sign * marginValue;
return correctZeroLevel && newValue * rangeValue <= 0 ? 0 : newValue
}
}
export function adjustVisualRange(options, visualRange, wholeRange, dataRange) {
var minDefined = isDefined(visualRange.startValue);
var maxDefined = isDefined(visualRange.endValue);
var nonDiscrete = "discrete" !== options.axisType;
dataRange = dataRange || wholeRange;
var add = getAddFunction(options, false);
var min = minDefined ? visualRange.startValue : dataRange.min;
var max = maxDefined ? visualRange.endValue : dataRange.max;
var rangeLength = visualRange.length;
var categories = dataRange.categories;
if (nonDiscrete && !isDefined(min) && !isDefined(max)) {
return {
startValue: min,
endValue: max
}
}
if (isDefined(rangeLength)) {
if (nonDiscrete) {
if ("datetime" === options.dataType && !isNumeric(rangeLength)) {
rangeLength = dateToMilliseconds(rangeLength)
}
if (maxDefined && !minDefined || !maxDefined && !minDefined) {
isDefined(wholeRange.max) && (max = max > wholeRange.max ? wholeRange.max : max);
min = add(max, rangeLength, -1)
} else if (minDefined && !maxDefined) {
isDefined(wholeRange.min) && (min = min < wholeRange.min ? wholeRange.min : min);
max = add(min, rangeLength)
}
} else {
rangeLength = parseInt(rangeLength);
if (!isNaN(rangeLength) && isFinite(rangeLength)) {
rangeLength--;
if (!maxDefined && !minDefined) {
max = categories[categories.length - 1];
min = categories[categories.length - 1 - rangeLength]
} else if (minDefined && !maxDefined) {
var categoriesInfo = getCategoriesInfo(categories, min, void 0);
max = categoriesInfo.categories[rangeLength]
} else if (!minDefined && maxDefined) {
var _categoriesInfo = getCategoriesInfo(categories, void 0, max);
min = _categoriesInfo.categories[_categoriesInfo.categories.length - 1 - rangeLength]
}
}
}
}
if (nonDiscrete) {
if (isDefined(wholeRange.max) && max > wholeRange.max) {
max = wholeRange.max
}
if (isDefined(wholeRange.min) && min < wholeRange.min) {
min = wholeRange.min
}
}
return {
startValue: min,
endValue: max
}
}
export function getLogExt(value, base) {
var allowNegatives = arguments.length > 2 && void 0 !== arguments[2] ? arguments[2] : false;
var linearThreshold = arguments.length > 3 ? arguments[3] : void 0;
if (!allowNegatives) {
return getLog(value, base)
}
if (0 === value) {
return 0
}
var transformValue = getLog(abs(value), base) - (linearThreshold - 1);
if (transformValue < 0) {
return 0
}
return adjust(sign(value) * transformValue, Number(pow(base, linearThreshold - 1).toFixed(abs(linearThreshold))))
}
export function raiseToExt(value, base) {
var allowNegatives = arguments.length > 2 && void 0 !== arguments[2] ? arguments[2] : false;
var linearThreshold = arguments.length > 3 ? arguments[3] : void 0;
if (!allowNegatives) {
return raiseTo(value, base)
}
if (0 === value) {
return 0
}
var transformValue = raiseTo(abs(value) + (linearThreshold - 1), base);
if (transformValue < 0) {
return 0
}
return adjust(sign(value) * transformValue, Number(pow(base, linearThreshold).toFixed(abs(linearThreshold))))
}
export function rangesAreEqual(range, rangeFromOptions) {
if (Array.isArray(rangeFromOptions)) {
return range.length === rangeFromOptions.length && range.every((item, i) => valueOf(item) === valueOf(rangeFromOptions[i]))
} else {
return valueOf(range.startValue) === valueOf(rangeFromOptions.startValue) && valueOf(range.endValue) === valueOf(rangeFromOptions.endValue)
}
}
export function valueOf(value) {
return value && value.valueOf()
}
export function pointInCanvas(canvas, x, y) {
return x >= canvas.left && x <= canvas.right && y >= canvas.top && y <= canvas.bottom
}