tupali/librerias/gantt/code/es-modules/parts-more/Polar.js

724 lines
29 KiB
JavaScript
Raw Permalink Normal View History

2020-05-23 20:45:54 +00:00
/* *
*
* (c) 2010-2020 Torstein Honsi
*
* License: www.highcharts.com/license
*
* !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
*
* */
'use strict';
import H from '../parts/Globals.js';
import U from '../parts/Utilities.js';
var addEvent = U.addEvent, animObject = U.animObject, defined = U.defined, find = U.find, isNumber = U.isNumber, pick = U.pick, splat = U.splat, uniqueKey = U.uniqueKey, wrap = U.wrap;
import Pane from '../parts-more/Pane.js';
import '../parts/Pointer.js';
import '../parts/Series.js';
import '../parts/Pointer.js';
// Extensions for polar charts. Additionally, much of the geometry required for
// polar charts is gathered in RadialAxes.js.
var Pointer = H.Pointer, Series = H.Series, seriesTypes = H.seriesTypes, seriesProto = Series.prototype, pointerProto = Pointer.prototype, colProto, arearangeProto;
/* eslint-disable no-invalid-this, valid-jsdoc */
/**
* Search a k-d tree by the point angle, used for shared tooltips in polar
* charts
* @private
*/
seriesProto.searchPointByAngle = function (e) {
var series = this, chart = series.chart, xAxis = series.xAxis, center = xAxis.pane.center, plotX = e.chartX - center[0] - chart.plotLeft, plotY = e.chartY - center[1] - chart.plotTop;
return this.searchKDTree({
clientX: 180 + (Math.atan2(plotX, plotY) * (-180 / Math.PI))
});
};
/**
* #6212 Calculate connectors for spline series in polar chart.
* @private
* @param {boolean} calculateNeighbours
* Check if connectors should be calculated for neighbour points as
* well allows short recurence
*/
seriesProto.getConnectors = function (segment, index, calculateNeighbours, connectEnds) {
var i, prevPointInd, nextPointInd, previousPoint, nextPoint, previousX, previousY, nextX, nextY, plotX, plotY, ret,
// 1 means control points midway between points, 2 means 1/3 from
// the point, 3 is 1/4 etc;
smoothing = 1.5, denom = smoothing + 1, leftContX, leftContY, rightContX, rightContY, dLControlPoint, // distance left control point
dRControlPoint, leftContAngle, rightContAngle, jointAngle, addedNumber = connectEnds ? 1 : 0;
// Calculate final index of points depending on the initial index value.
// Because of calculating neighbours, index may be outisde segment
// array.
if (index >= 0 && index <= segment.length - 1) {
i = index;
}
else if (index < 0) {
i = segment.length - 1 + index;
}
else {
i = 0;
}
prevPointInd = (i - 1 < 0) ? segment.length - (1 + addedNumber) : i - 1;
nextPointInd = (i + 1 > segment.length - 1) ? addedNumber : i + 1;
previousPoint = segment[prevPointInd];
nextPoint = segment[nextPointInd];
previousX = previousPoint.plotX;
previousY = previousPoint.plotY;
nextX = nextPoint.plotX;
nextY = nextPoint.plotY;
plotX = segment[i].plotX; // actual point
plotY = segment[i].plotY;
leftContX = (smoothing * plotX + previousX) / denom;
leftContY = (smoothing * plotY + previousY) / denom;
rightContX = (smoothing * plotX + nextX) / denom;
rightContY = (smoothing * plotY + nextY) / denom;
dLControlPoint = Math.sqrt(Math.pow(leftContX - plotX, 2) + Math.pow(leftContY - plotY, 2));
dRControlPoint = Math.sqrt(Math.pow(rightContX - plotX, 2) + Math.pow(rightContY - plotY, 2));
leftContAngle = Math.atan2(leftContY - plotY, leftContX - plotX);
rightContAngle = Math.atan2(rightContY - plotY, rightContX - plotX);
jointAngle = (Math.PI / 2) + ((leftContAngle + rightContAngle) / 2);
// Ensure the right direction, jointAngle should be in the same quadrant
// as leftContAngle
if (Math.abs(leftContAngle - jointAngle) > Math.PI / 2) {
jointAngle -= Math.PI;
}
// Find the corrected control points for a spline straight through the
// point
leftContX = plotX + Math.cos(jointAngle) * dLControlPoint;
leftContY = plotY + Math.sin(jointAngle) * dLControlPoint;
rightContX = plotX + Math.cos(Math.PI + jointAngle) * dRControlPoint;
rightContY = plotY + Math.sin(Math.PI + jointAngle) * dRControlPoint;
// push current point's connectors into returned object
ret = {
rightContX: rightContX,
rightContY: rightContY,
leftContX: leftContX,
leftContY: leftContY,
plotX: plotX,
plotY: plotY
};
// calculate connectors for previous and next point and push them inside
// returned object
if (calculateNeighbours) {
ret.prevPointCont = this.getConnectors(segment, prevPointInd, false, connectEnds);
}
return ret;
};
/**
* Translate a point's plotX and plotY from the internal angle and radius
* measures to true plotX, plotY coordinates
* @private
*/
seriesProto.toXY = function (point) {
var xy, chart = this.chart, xAxis = this.xAxis, yAxis = this.yAxis, plotX = point.plotX, plotY = point.plotY, series = point.series, inverted = chart.inverted, pointY = point.y, radius = inverted ? plotX : yAxis.len - plotY, clientX;
// Corrected y position of inverted series other than column
if (inverted && series && !series.isRadialBar) {
point.plotY = plotY =
typeof pointY === 'number' ? (yAxis.translate(pointY) || 0) : 0;
}
// Save rectangular plotX, plotY for later computation
point.rectPlotX = plotX;
point.rectPlotY = plotY;
if (yAxis.center) {
radius += yAxis.center[3] / 2;
}
// Find the polar plotX and plotY
xy = inverted ? yAxis.postTranslate(plotY, radius) :
xAxis.postTranslate(plotX, radius);
point.plotX = point.polarPlotX = xy.x - chart.plotLeft;
point.plotY = point.polarPlotY = xy.y - chart.plotTop;
// If shared tooltip, record the angle in degrees in order to align X
// points. Otherwise, use a standard k-d tree to get the nearest point
// in two dimensions.
if (this.kdByAngle) {
clientX = ((plotX / Math.PI * 180) +
xAxis.pane.options.startAngle) % 360;
if (clientX < 0) { // #2665
clientX += 360;
}
point.clientX = clientX;
}
else {
point.clientX = point.plotX;
}
};
if (seriesTypes.spline) {
/**
* Overridden method for calculating a spline from one point to the next
* @private
*/
wrap(seriesTypes.spline.prototype, 'getPointSpline', function (proceed, segment, point, i) {
var ret, connectors;
if (this.chart.polar) {
// moveTo or lineTo
if (!i) {
ret = ['M', point.plotX, point.plotY];
}
else { // curve from last point to this
connectors = this.getConnectors(segment, i, true, this.connectEnds);
ret = [
'C',
connectors.prevPointCont.rightContX,
connectors.prevPointCont.rightContY,
connectors.leftContX,
connectors.leftContY,
connectors.plotX,
connectors.plotY
];
}
}
else {
ret = proceed.call(this, segment, point, i);
}
return ret;
});
// #6430 Areasplinerange series use unwrapped getPointSpline method, so
// we need to set this method again.
if (seriesTypes.areasplinerange) {
seriesTypes.areasplinerange.prototype.getPointSpline =
seriesTypes.spline.prototype.getPointSpline;
}
}
/**
* Extend translate. The plotX and plotY values are computed as if the polar
* chart were a cartesian plane, where plotX denotes the angle in radians
* and (yAxis.len - plotY) is the pixel distance from center.
* @private
*/
addEvent(Series, 'afterTranslate', function () {
var series = this;
var chart = series.chart;
if (chart.polar && series.xAxis) {
// Prepare k-d-tree handling. It searches by angle (clientX) in
// case of shared tooltip, and by two dimensional distance in case
// of non-shared.
series.kdByAngle = chart.tooltip && chart.tooltip.shared;
if (series.kdByAngle) {
series.searchPoint = series.searchPointByAngle;
}
else {
series.options.findNearestPointBy = 'xy';
}
// Postprocess plot coordinates
if (!series.preventPostTranslate) {
var points = series.points;
var i = points.length;
while (i--) {
// Translate plotX, plotY from angle and radius to true plot
// coordinates
series.toXY(points[i]);
// Treat points below Y axis min as null (#10082)
if (!chart.hasParallelCoordinates &&
!series.yAxis.reversed &&
points[i].y < series.yAxis.min) {
points[i].isNull = true;
}
}
}
// Perform clip after render
if (!this.hasClipCircleSetter) {
this.hasClipCircleSetter = !!series.eventsToUnbind.push(addEvent(series, 'afterRender', function () {
var circ;
if (chart.polar) {
// For clipping purposes there is a need for
// coordinates from the absolute center
circ = this.yAxis.pane.center;
if (!this.clipCircle) {
this.clipCircle = chart.renderer.clipCircle(circ[0], circ[1], circ[2] / 2, circ[3] / 2);
}
else {
this.clipCircle.animate({
x: circ[0],
y: circ[1],
r: circ[2] / 2,
innerR: circ[3] / 2
});
}
this.group.clip(this.clipCircle);
this.setClip = H.noop;
}
}));
}
}
}, { order: 2 }); // Run after translation of ||-coords
/**
* Extend getSegmentPath to allow connecting ends across 0 to provide a
* closed circle in line-like series.
* @private
*/
wrap(seriesProto, 'getGraphPath', function (proceed, points) {
var series = this, i, firstValid, popLastPoint;
// Connect the path
if (this.chart.polar) {
points = points || this.points;
// Append first valid point in order to connect the ends
for (i = 0; i < points.length; i++) {
if (!points[i].isNull) {
firstValid = i;
break;
}
}
/**
* Polar charts only. Whether to connect the ends of a line series
* plot across the extremes.
*
* @sample {highcharts} highcharts/plotoptions/line-connectends-false/
* Do not connect
*
* @type {boolean}
* @since 2.3.0
* @product highcharts
* @apioption plotOptions.series.connectEnds
*/
if (this.options.connectEnds !== false &&
typeof firstValid !== 'undefined') {
this.connectEnds = true; // re-used in splines
points.splice(points.length, 0, points[firstValid]);
popLastPoint = true;
}
// For area charts, pseudo points are added to the graph, now we
// need to translate these
points.forEach(function (point) {
if (typeof point.polarPlotY === 'undefined') {
series.toXY(point);
}
});
}
// Run uber method
var ret = proceed.apply(this, [].slice.call(arguments, 1));
// #6212 points.splice method is adding points to an array. In case of
// areaspline getGraphPath method is used two times and in both times
// points are added to an array. That is why points.pop is used, to get
// unmodified points.
if (popLastPoint) {
points.pop();
}
return ret;
});
var polarAnimate = function (proceed, init) {
var series = this, chart = this.chart, animation = this.options.animation, group = this.group, markerGroup = this.markerGroup, center = this.xAxis.center, plotLeft = chart.plotLeft, plotTop = chart.plotTop, attribs, paneInnerR, graphic, shapeArgs, r, innerR;
// Specific animation for polar charts
if (chart.polar) {
if (series.isRadialBar) {
if (!init) {
// Run the pie animation for radial bars
series.startAngleRad = pick(series.translatedThreshold, series.xAxis.startAngleRad);
H.seriesTypes.pie.prototype.animate.call(series, init);
}
}
else {
// Enable animation on polar charts only in SVG. In VML, the scaling
// is different, plus animation would be so slow it would't matter.
if (chart.renderer.isSVG) {
animation = animObject(animation);
// A different animation needed for column like series
if (series.is('column')) {
if (!init) {
paneInnerR = center[3] / 2;
series.points.forEach(function (point) {
graphic = point.graphic;
shapeArgs = point.shapeArgs;
r = shapeArgs && shapeArgs.r;
innerR = shapeArgs && shapeArgs.innerR;
if (graphic && shapeArgs) {
// start values
graphic.attr({
r: paneInnerR,
innerR: paneInnerR
});
// animate
graphic.animate({
r: r,
innerR: innerR
}, series.options.animation);
}
});
}
}
else {
// Initialize the animation
if (init) {
// Scale down the group and place it in the center
attribs = {
translateX: center[0] + plotLeft,
translateY: center[1] + plotTop,
scaleX: 0.001,
scaleY: 0.001
};
group.attr(attribs);
if (markerGroup) {
markerGroup.attr(attribs);
}
// Run the animation
}
else {
attribs = {
translateX: plotLeft,
translateY: plotTop,
scaleX: 1,
scaleY: 1
};
group.animate(attribs, animation);
if (markerGroup) {
markerGroup.animate(attribs, animation);
}
}
}
}
}
// For non-polar charts, revert to the basic animation
}
else {
proceed.call(this, init);
}
};
// Define the animate method for regular series
wrap(seriesProto, 'animate', polarAnimate);
if (seriesTypes.column) {
arearangeProto = seriesTypes.arearange.prototype;
colProto = seriesTypes.column.prototype;
colProto.polarArc = function (low, high, start, end) {
var center = this.xAxis.center, len = this.yAxis.len, paneInnerR = center[3] / 2, r = len - high + paneInnerR, innerR = len - pick(low, len) + paneInnerR;
// Prevent columns from shooting through the pane's center
if (this.yAxis.reversed) {
if (r < 0) {
r = paneInnerR;
}
if (innerR < 0) {
innerR = paneInnerR;
}
}
// Return a new shapeArgs
return {
x: center[0],
y: center[1],
r: r,
innerR: innerR,
start: start,
end: end
};
};
/**
* Define the animate method for columnseries
* @private
*/
wrap(colProto, 'animate', polarAnimate);
/**
* Extend the column prototype's translate method
* @private
*/
wrap(colProto, 'translate', function (proceed) {
var series = this, options = series.options, threshold = options.threshold, stacking = options.stacking, chart = series.chart, xAxis = series.xAxis, yAxis = series.yAxis, reversed = yAxis.reversed, center = yAxis.center, startAngleRad = xAxis.startAngleRad, endAngleRad = xAxis.endAngleRad, visibleRange = endAngleRad - startAngleRad, thresholdAngleRad, points, point, i, yMin, yMax, start, end, tooltipPos, pointX, pointY, stackValues, stack, barX, innerR, r;
series.preventPostTranslate = true;
// Run uber method
proceed.call(series);
// Postprocess plot coordinates
if (xAxis.isRadial) {
points = series.points;
i = points.length;
yMin = yAxis.translate(yAxis.min);
yMax = yAxis.translate(yAxis.max);
threshold = options.threshold || 0;
if (chart.inverted) {
// Finding a correct threshold
if (isNumber(threshold)) {
thresholdAngleRad = yAxis.translate(threshold);
// Checks if threshold is outside the visible range
if (defined(thresholdAngleRad)) {
if (thresholdAngleRad < 0) {
thresholdAngleRad = 0;
}
else if (thresholdAngleRad > visibleRange) {
thresholdAngleRad = visibleRange;
}
// Adding start angle offset
series.translatedThreshold =
thresholdAngleRad + startAngleRad;
}
}
}
while (i--) {
point = points[i];
barX = point.barX;
pointX = point.x;
pointY = point.y;
point.shapeType = 'arc';
if (chart.inverted) {
point.plotY = yAxis.translate(pointY);
if (stacking && yAxis.stacking) {
stack = yAxis.stacking.stacks[(pointY < 0 ? '-' : '') +
series.stackKey];
if (series.visible && stack && stack[pointX]) {
if (!point.isNull) {
stackValues = stack[pointX].points[series.getStackIndicator(void 0, pointX, series.index).key];
// Translating to radial values
start = yAxis.translate(stackValues[0]);
end = yAxis.translate(stackValues[1]);
// If starting point is beyond the
// range, set it to 0
if (defined(start)) {
start = U.clamp(start, 0, visibleRange);
}
}
}
}
else {
// Initial start and end angles for radial bar
start = thresholdAngleRad;
end = point.plotY;
}
if (start > end) {
// Swapping start and end
end = [start, start = end][0];
}
// Prevent from rendering point outside the
// acceptable circular range
if (!reversed) {
if (start < yMin) {
start = yMin;
}
else if (end > yMax) {
end = yMax;
}
else if (end < yMin || start > yMax) {
start = end = 0;
}
}
else {
if (end > yMin) {
end = yMin;
}
else if (start < yMax) {
start = yMax;
}
else if (start > yMin || end < yMax) {
start = end = visibleRange;
}
}
if (yAxis.min > yAxis.max) {
start = end = reversed ? visibleRange : 0;
}
start += startAngleRad;
end += startAngleRad;
if (center) {
point.barX = barX += center[3] / 2;
}
// In case when radius, inner radius or both are
// negative, a point is rendered but partially or as
// a center point
innerR = Math.max(barX, 0);
r = Math.max(barX + point.pointWidth, 0);
point.shapeArgs = {
x: center && center[0],
y: center && center[1],
r: r,
innerR: innerR,
start: start,
end: end
};
// Fade out the points if not inside the polar "plot area"
point.opacity = start === end ? 0 : void 0;
// A correct value for stacked or not fully visible
// point
point.plotY = (defined(series.translatedThreshold) &&
(start < series.translatedThreshold ? start : end)) -
startAngleRad;
}
else {
start = barX + startAngleRad;
// Changed the way polar columns are drawn in order to make
// it more consistent with the drawing of inverted columns
// (they are using the same function now). Also, it was
// essential to make the animation work correctly (the
// scaling of the group) is replaced by animating each
// element separately.
point.shapeArgs = series.polarArc(point.yBottom, point.plotY, start, start + point.pointWidth);
}
// Provided a correct coordinates for the tooltip
series.toXY(point);
if (chart.inverted) {
tooltipPos = yAxis.postTranslate(point.rectPlotY, barX + point.pointWidth / 2);
point.tooltipPos = [
tooltipPos.x - chart.plotLeft,
tooltipPos.y - chart.plotTop
];
}
else {
point.tooltipPos = [point.plotX, point.plotY];
}
if (center) {
point.ttBelow = point.plotY > center[1];
}
}
}
});
/**
* Find correct align and vertical align based on an angle in polar chart
* @private
*/
colProto.findAlignments = function (angle, options) {
var align, verticalAlign;
if (options.align === null) {
if (angle > 20 && angle < 160) {
align = 'left'; // right hemisphere
}
else if (angle > 200 && angle < 340) {
align = 'right'; // left hemisphere
}
else {
align = 'center'; // top or bottom
}
options.align = align;
}
if (options.verticalAlign === null) {
if (angle < 45 || angle > 315) {
verticalAlign = 'bottom'; // top part
}
else if (angle > 135 && angle < 225) {
verticalAlign = 'top'; // bottom part
}
else {
verticalAlign = 'middle'; // left or right
}
options.verticalAlign = verticalAlign;
}
return options;
};
if (arearangeProto) {
arearangeProto.findAlignments = colProto.findAlignments;
}
/**
* Align column data labels outside the columns. #1199.
* @private
*/
wrap(colProto, 'alignDataLabel', function (proceed, point, dataLabel, options, alignTo, isNew) {
var chart = this.chart, inside = pick(options.inside, !!this.options.stacking), angle, shapeArgs, labelPos;
if (chart.polar) {
angle = point.rectPlotX / Math.PI * 180;
if (!chart.inverted) {
// Align nicely outside the perimeter of the columns
if (this.findAlignments) {
options = this.findAlignments(angle, options);
}
}
else { // Required corrections for data labels of inverted bars
// The plotX and plotY are correctly set therefore they
// don't need to be swapped (inverted argument is false)
this.forceDL = chart.isInsidePlot(point.plotX, Math.round(point.plotY), false);
// Checks if labels should be positioned inside
if (inside && point.shapeArgs) {
shapeArgs = point.shapeArgs;
// Calculates pixel positions for a data label to be
// inside
labelPos =
this.yAxis.postTranslate(
// angle
(shapeArgs.start + shapeArgs.end) / 2 -
this
.xAxis.startAngleRad,
// radius
point.barX +
point.pointWidth / 2);
alignTo = {
x: labelPos.x - chart.plotLeft,
y: labelPos.y - chart.plotTop
};
}
else if (point.tooltipPos) {
alignTo = {
x: point.tooltipPos[0],
y: point.tooltipPos[1]
};
}
options.align = pick(options.align, 'center');
options.verticalAlign =
pick(options.verticalAlign, 'middle');
}
seriesProto.alignDataLabel.call(this, point, dataLabel, options, alignTo, isNew);
// Hide label of a point (only inverted) that is outside the
// visible y range
if (this.isRadialBar && point.shapeArgs &&
point.shapeArgs.start === point.shapeArgs.end) {
dataLabel.hide(true);
}
}
else {
proceed.call(this, point, dataLabel, options, alignTo, isNew);
}
});
}
/**
* Extend getCoordinates to prepare for polar axis values
* @private
*/
wrap(pointerProto, 'getCoordinates', function (proceed, e) {
var chart = this.chart, ret = {
xAxis: [],
yAxis: []
};
if (chart.polar) {
chart.axes.forEach(function (axis) {
var isXAxis = axis.isXAxis, center = axis.center, x, y;
// Skip colorAxis
if (axis.coll === 'colorAxis') {
return;
}
x = e.chartX - center[0] - chart.plotLeft;
y = e.chartY - center[1] - chart.plotTop;
ret[isXAxis ? 'xAxis' : 'yAxis'].push({
axis: axis,
value: axis.translate(isXAxis ?
Math.PI - Math.atan2(x, y) : // angle
// distance from center
Math.sqrt(Math.pow(x, 2) + Math.pow(y, 2)), true)
});
});
}
else {
ret = proceed.call(this, e);
}
return ret;
});
H.SVGRenderer.prototype.clipCircle = function (x, y, r, innerR) {
var wrapper, id = uniqueKey(), clipPath = this.createElement('clipPath').attr({
id: id
}).add(this.defs);
wrapper = innerR ?
this.arc(x, y, r, innerR, 0, 2 * Math.PI).add(clipPath) :
this.circle(x, y, r).add(clipPath);
wrapper.id = id;
wrapper.clipPath = clipPath;
return wrapper;
};
addEvent(H.Chart, 'getAxes', function () {
if (!this.pane) {
this.pane = [];
}
splat(this.options.pane).forEach(function (paneOptions) {
new Pane(// eslint-disable-line no-new
paneOptions, this);
}, this);
});
addEvent(H.Chart, 'afterDrawChartBox', function () {
this.pane.forEach(function (pane) {
pane.render();
});
});
addEvent(H.Series, 'afterInit', function () {
var chart = this.chart;
// Add flags that identifies radial inverted series
if (chart.inverted && chart.polar) {
this.isRadialSeries = true;
if (this.is('column')) {
this.isRadialBar = true;
}
}
});
/**
* Extend chart.get to also search in panes. Used internally in
* responsiveness and chart.update.
* @private
*/
wrap(H.Chart.prototype, 'get', function (proceed, id) {
return find(this.pane, function (pane) {
return pane.options.id === id;
}) || proceed.call(this, id);
});