/** * @license Highcharts JS v11.4.1 (2024-04-04) * * 3D features for Highcharts JS * * License: www.highcharts.com/license */ (function (factory) { if (typeof module === 'object' && module.exports) { factory['default'] = factory; module.exports = factory; } else if (typeof define === 'function' && define.amd) { define('highcharts/highcharts-3d', ['highcharts'], function (Highcharts) { factory(Highcharts); factory.Highcharts = Highcharts; return factory; }); } else { factory(typeof Highcharts !== 'undefined' ? Highcharts : undefined); } }(function (Highcharts) { 'use strict'; var _modules = Highcharts ? Highcharts._modules : {}; function _registerModule(obj, path, args, fn) { if (!obj.hasOwnProperty(path)) { obj[path] = fn.apply(null, args); if (typeof CustomEvent === 'function') { window.dispatchEvent(new CustomEvent( 'HighchartsModuleLoaded', { detail: { path: path, module: obj[path] } } )); } } } _registerModule(_modules, 'Core/Math3D.js', [_modules['Core/Globals.js'], _modules['Core/Utilities.js']], function (H, U) { /* * * * (c) 2010-2024 Torstein Honsi * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { deg2rad } = H; const { pick } = U; /* * * * Functions * * */ /* eslint-disable max-len */ /** * Apply 3-D rotation * Euler Angles (XYZ): * cosA = cos(Alfa|Roll) * cosB = cos(Beta|Pitch) * cosG = cos(Gamma|Yaw) * * Composite rotation: * | cosB * cosG | cosB * sinG | -sinB | * | sinA * sinB * cosG - cosA * sinG | sinA * sinB * sinG + cosA * cosG | sinA * cosB | * | cosA * sinB * cosG + sinA * sinG | cosA * sinB * sinG - sinA * cosG | cosA * cosB | * * Now, Gamma/Yaw is not used (angle=0), so we assume cosG = 1 and sinG = 0, so * we get: * | cosB | 0 | - sinB | * | sinA * sinB | cosA | sinA * cosB | * | cosA * sinB | - sinA | cosA * cosB | * * But in browsers, y is reversed, so we get sinA => -sinA. The general result * is: * | cosB | 0 | - sinB | | x | | px | * | - sinA * sinB | cosA | - sinA * cosB | x | y | = | py | * | cosA * sinB | sinA | cosA * cosB | | z | | pz | * * @private * @function rotate3D */ /* eslint-enable max-len */ /** * Rotates the position as defined in angles. * @private * @param {number} x * X coordinate * @param {number} y * Y coordinate * @param {number} z * Z coordinate * @param {Highcharts.Rotation3DObject} angles * Rotation angles * @return {Highcharts.Position3DObject} * Rotated position */ function rotate3D(x, y, z, angles) { return { x: angles.cosB * x - angles.sinB * z, y: -angles.sinA * angles.sinB * x + angles.cosA * y - angles.cosB * angles.sinA * z, z: angles.cosA * angles.sinB * x + angles.sinA * y + angles.cosA * angles.cosB * z }; } /** * Transforms a given array of points according to the angles in chart.options. * * @private * @function Highcharts.perspective * * @param {Array} points * The array of points * * @param {Highcharts.Chart} chart * The chart * * @param {boolean} [insidePlotArea] * Whether to verify that the points are inside the plotArea * * @param {boolean} [useInvertedPersp] * Whether to use inverted perspective in calculations * * @return {Array} * An array of transformed points * * @requires highcharts-3d */ function perspective(points, chart, insidePlotArea, useInvertedPersp) { const options3d = chart.options.chart.options3d, /* The useInvertedPersp argument is used for inverted charts with * already inverted elements, such as dataLabels or tooltip positions. */ inverted = pick(useInvertedPersp, insidePlotArea ? chart.inverted : false), origin = { x: chart.plotWidth / 2, y: chart.plotHeight / 2, z: options3d.depth / 2, vd: pick(options3d.depth, 1) * pick(options3d.viewDistance, 0) }, scale = chart.scale3d || 1, beta = deg2rad * options3d.beta * (inverted ? -1 : 1), alpha = deg2rad * options3d.alpha * (inverted ? -1 : 1), angles = { cosA: Math.cos(alpha), cosB: Math.cos(-beta), sinA: Math.sin(alpha), sinB: Math.sin(-beta) }; if (!insidePlotArea) { origin.x += chart.plotLeft; origin.y += chart.plotTop; } // Transform each point return points.map(function (point) { const rotated = rotate3D((inverted ? point.y : point.x) - origin.x, (inverted ? point.x : point.y) - origin.y, (point.z || 0) - origin.z, angles), // Apply perspective coordinate = perspective3D(rotated, origin, origin.vd); // Apply translation coordinate.x = coordinate.x * scale + origin.x; coordinate.y = coordinate.y * scale + origin.y; coordinate.z = rotated.z * scale + origin.z; return { x: (inverted ? coordinate.y : coordinate.x), y: (inverted ? coordinate.x : coordinate.y), z: coordinate.z }; }); } /** * Perspective3D function is available in global Highcharts scope because is * needed also outside of perspective() function (#8042). * @private * @function Highcharts.perspective3D * * @param {Highcharts.Position3DObject} coordinate * 3D position * * @param {Highcharts.Position3DObject} origin * 3D root position * * @param {number} distance * Perspective distance * * @return {Highcharts.PositionObject} * Perspective 3D Position * * @requires highcharts-3d */ function perspective3D(coordinate, origin, distance) { const projection = ((distance > 0) && (distance < Number.POSITIVE_INFINITY)) ? distance / (coordinate.z + origin.z + distance) : 1; return { x: coordinate.x * projection, y: coordinate.y * projection }; } /** * Calculate a distance from camera to points - made for calculating zIndex of * scatter points. * * @private * @function Highcharts.pointCameraDistance * * @param {Highcharts.Dictionary} coordinates * Coordinates of the specific point * * @param {Highcharts.Chart} chart * Related chart * * @return {number} * Distance from camera to point * * @requires highcharts-3d */ function pointCameraDistance(coordinates, chart) { const options3d = chart.options.chart.options3d, cameraPosition = { x: chart.plotWidth / 2, y: chart.plotHeight / 2, z: pick(options3d.depth, 1) * pick(options3d.viewDistance, 0) + options3d.depth }, // Added support for objects with plotX or x coordinates. distance = Math.sqrt(Math.pow(cameraPosition.x - pick(coordinates.plotX, coordinates.x), 2) + Math.pow(cameraPosition.y - pick(coordinates.plotY, coordinates.y), 2) + Math.pow(cameraPosition.z - pick(coordinates.plotZ, coordinates.z), 2)); return distance; } /** * Calculate area of a 2D polygon using Shoelace algorithm * https://en.wikipedia.org/wiki/Shoelace_formula * * @private * @function Highcharts.shapeArea * * @param {Array} vertexes * 2D Polygon * * @return {number} * Calculated area * * @requires highcharts-3d */ function shapeArea(vertexes) { let area = 0, i, j; for (i = 0; i < vertexes.length; i++) { j = (i + 1) % vertexes.length; area += vertexes[i].x * vertexes[j].y - vertexes[j].x * vertexes[i].y; } return area / 2; } /** * Calculate area of a 3D polygon after perspective projection * * @private * @function Highcharts.shapeArea3d * * @param {Array} vertexes * 3D Polygon * * @param {Highcharts.Chart} chart * Related chart * * @param {boolean} [insidePlotArea] * Whether to verify that the points are inside the plotArea * * @return {number} * Calculated area * * @requires highcharts-3d */ function shapeArea3D(vertexes, chart, insidePlotArea) { return shapeArea(perspective(vertexes, chart, insidePlotArea)); } /* * * * Default Export * * */ const Math3D = { perspective, perspective3D, pointCameraDistance, shapeArea, shapeArea3D }; return Math3D; }); _registerModule(_modules, 'Core/Chart/Chart3D.js', [_modules['Core/Color/Color.js'], _modules['Core/Defaults.js'], _modules['Core/Math3D.js'], _modules['Core/Utilities.js']], function (Color, D, Math3D, U) { /* * * * (c) 2010-2024 Torstein Honsi * * Extension for 3D charts * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { parse: color } = Color; const { defaultOptions: genericDefaultOptions } = D; const { perspective, shapeArea3D } = Math3D; const { addEvent, isArray, merge, pick, wrap } = U; /* * * * Composition * * */ var Chart3D; (function (Chart3D) { /* * * * Declarations * * */ /* * * * Constants * * */ /** * @optionparent * @private */ Chart3D.defaultOptions = { chart: { /** * Options to render charts in 3 dimensions. This feature requires * `highcharts-3d.js`, found in the download package or online at * [code.highcharts.com/highcharts-3d.js](https://code.highcharts.com/highcharts-3d.js). * * @since 4.0 * @product highcharts * @requires highcharts-3d */ options3d: { /** * Whether to render the chart using the 3D functionality. * * @since 4.0 * @product highcharts */ enabled: false, /** * One of the two rotation angles for the chart. * * @since 4.0 * @product highcharts */ alpha: 0, /** * One of the two rotation angles for the chart. * * @since 4.0 * @product highcharts */ beta: 0, /** * The total depth of the chart. * * @since 4.0 * @product highcharts */ depth: 100, /** * Whether the 3d box should automatically adjust to the chart * plot area. * * @since 4.2.4 * @product highcharts */ fitToPlot: true, /** * Defines the distance the viewer is standing in front of the * chart, this setting is important to calculate the perspective * effect in column and scatter charts. It is not used for 3D * pie charts. * * @since 4.0 * @product highcharts */ viewDistance: 25, /** * Set it to `"auto"` to automatically move the labels to the * best edge. * * @type {"auto"|null} * @since 5.0.12 * @product highcharts */ axisLabelPosition: null, /** * Provides the option to draw a frame around the charts by * defining a bottom, front and back panel. * * @since 4.0 * @product highcharts * @requires highcharts-3d */ frame: { /** * Whether the frames are visible. */ visible: 'default', /** * General pixel thickness for the frame faces. */ size: 1, /** * The bottom of the frame around a 3D chart. * * @since 4.0 * @product highcharts * @requires highcharts-3d */ /** * The color of the panel. * * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject} * @default transparent * @since 4.0 * @product highcharts * @apioption chart.options3d.frame.bottom.color */ /** * The thickness of the panel. * * @type {number} * @default 1 * @since 4.0 * @product highcharts * @apioption chart.options3d.frame.bottom.size */ /** * Whether to display the frame. Possible values are `true`, * `false`, `"auto"` to display only the frames behind the * data, and `"default"` to display faces behind the data * based on the axis layout, ignoring the point of view. * * @sample {highcharts} highcharts/3d/scatter-frame/ * Auto frames * * @type {boolean|"default"|"auto"} * @default default * @since 5.0.12 * @product highcharts * @apioption chart.options3d.frame.bottom.visible */ /** * The bottom of the frame around a 3D chart. */ bottom: {}, /** * The top of the frame around a 3D chart. * * @extends chart.options3d.frame.bottom */ top: {}, /** * The left side of the frame around a 3D chart. * * @extends chart.options3d.frame.bottom */ left: {}, /** * The right of the frame around a 3D chart. * * @extends chart.options3d.frame.bottom */ right: {}, /** * The back side of the frame around a 3D chart. * * @extends chart.options3d.frame.bottom */ back: {}, /** * The front of the frame around a 3D chart. * * @extends chart.options3d.frame.bottom */ front: {} } } } }; /* * * * Functions * * */ /** * @private */ function compose(ChartClass, FxClass) { const chartProto = ChartClass.prototype; const fxProto = FxClass.prototype; /** * Shorthand to check the is3d flag. * @private * @return {boolean} * Whether it is a 3D chart. */ chartProto.is3d = function () { return !!this.options.chart.options3d?.enabled; }; chartProto.propsRequireDirtyBox.push('chart.options3d'); chartProto.propsRequireUpdateSeries.push('chart.options3d'); /** * Animation setter for matrix property. * @private */ fxProto.matrixSetter = function () { let interpolated; if (this.pos < 1 && (isArray(this.start) || isArray(this.end))) { const start = (this.start || [1, 0, 0, 1, 0, 0]), end = this.end || [1, 0, 0, 1, 0, 0]; interpolated = []; for (let i = 0; i < 6; i++) { interpolated.push(this.pos * end[i] + (1 - this.pos) * start[i]); } } else { interpolated = this.end; } this.elem.attr(this.prop, interpolated, null, true); }; merge(true, genericDefaultOptions, Chart3D.defaultOptions); addEvent(ChartClass, 'init', onInit); addEvent(ChartClass, 'addSeries', onAddSeries); addEvent(ChartClass, 'afterDrawChartBox', onAfterDrawChartBox); addEvent(ChartClass, 'afterGetContainer', onAfterGetContainer); addEvent(ChartClass, 'afterInit', onAfterInit); addEvent(ChartClass, 'afterSetChartSize', onAfterSetChartSize); addEvent(ChartClass, 'beforeRedraw', onBeforeRedraw); addEvent(ChartClass, 'beforeRender', onBeforeRender); wrap(chartProto, 'isInsidePlot', wrapIsInsidePlot); wrap(chartProto, 'renderSeries', wrapRenderSeries); wrap(chartProto, 'setClassName', wrapSetClassName); } Chart3D.compose = compose; /** * Legacy support for HC < 6 to make 'scatter' series in a 3D chart route to * the real 'scatter3d' series type. (#8407) * @private */ function onAddSeries(e) { if (this.is3d()) { if (e.options.type === 'scatter') { e.options.type = 'scatter3d'; } } } /** * @private */ function onAfterDrawChartBox() { if (this.chart3d && this.is3d()) { const chart = this, renderer = chart.renderer, options3d = chart.options.chart.options3d, frame = chart.chart3d.get3dFrame(), xm = chart.plotLeft, xp = chart.plotLeft + chart.plotWidth, ym = chart.plotTop, yp = chart.plotTop + chart.plotHeight, zm = 0, zp = options3d.depth, xmm = xm - (frame.left.visible ? frame.left.size : 0), xpp = xp + (frame.right.visible ? frame.right.size : 0), ymm = ym - (frame.top.visible ? frame.top.size : 0), ypp = yp + (frame.bottom.visible ? frame.bottom.size : 0), zmm = zm - (frame.front.visible ? frame.front.size : 0), zpp = zp + (frame.back.visible ? frame.back.size : 0), verb = chart.hasRendered ? 'animate' : 'attr'; chart.chart3d.frame3d = frame; if (!chart.frameShapes) { chart.frameShapes = { bottom: renderer.polyhedron().add(), top: renderer.polyhedron().add(), left: renderer.polyhedron().add(), right: renderer.polyhedron().add(), back: renderer.polyhedron().add(), front: renderer.polyhedron().add() }; } chart.frameShapes.bottom[verb]({ 'class': 'highcharts-3d-frame highcharts-3d-frame-bottom', zIndex: frame.bottom.frontFacing ? -1000 : 1000, faces: [{ fill: color(frame.bottom.color).brighten(0.1).get(), vertexes: [{ x: xmm, y: ypp, z: zmm }, { x: xpp, y: ypp, z: zmm }, { x: xpp, y: ypp, z: zpp }, { x: xmm, y: ypp, z: zpp }], enabled: frame.bottom.visible }, { fill: color(frame.bottom.color).brighten(0.1).get(), vertexes: [{ x: xm, y: yp, z: zp }, { x: xp, y: yp, z: zp }, { x: xp, y: yp, z: zm }, { x: xm, y: yp, z: zm }], enabled: frame.bottom.visible }, { fill: color(frame.bottom.color).brighten(-0.1).get(), vertexes: [{ x: xmm, y: ypp, z: zmm }, { x: xmm, y: ypp, z: zpp }, { x: xm, y: yp, z: zp }, { x: xm, y: yp, z: zm }], enabled: frame.bottom.visible && !frame.left.visible }, { fill: color(frame.bottom.color).brighten(-0.1).get(), vertexes: [{ x: xpp, y: ypp, z: zpp }, { x: xpp, y: ypp, z: zmm }, { x: xp, y: yp, z: zm }, { x: xp, y: yp, z: zp }], enabled: frame.bottom.visible && !frame.right.visible }, { fill: color(frame.bottom.color).get(), vertexes: [{ x: xpp, y: ypp, z: zmm }, { x: xmm, y: ypp, z: zmm }, { x: xm, y: yp, z: zm }, { x: xp, y: yp, z: zm }], enabled: frame.bottom.visible && !frame.front.visible }, { fill: color(frame.bottom.color).get(), vertexes: [{ x: xmm, y: ypp, z: zpp }, { x: xpp, y: ypp, z: zpp }, { x: xp, y: yp, z: zp }, { x: xm, y: yp, z: zp }], enabled: frame.bottom.visible && !frame.back.visible }] }); chart.frameShapes.top[verb]({ 'class': 'highcharts-3d-frame highcharts-3d-frame-top', zIndex: frame.top.frontFacing ? -1000 : 1000, faces: [{ fill: color(frame.top.color).brighten(0.1).get(), vertexes: [{ x: xmm, y: ymm, z: zpp }, { x: xpp, y: ymm, z: zpp }, { x: xpp, y: ymm, z: zmm }, { x: xmm, y: ymm, z: zmm }], enabled: frame.top.visible }, { fill: color(frame.top.color).brighten(0.1).get(), vertexes: [{ x: xm, y: ym, z: zm }, { x: xp, y: ym, z: zm }, { x: xp, y: ym, z: zp }, { x: xm, y: ym, z: zp }], enabled: frame.top.visible }, { fill: color(frame.top.color).brighten(-0.1).get(), vertexes: [{ x: xmm, y: ymm, z: zpp }, { x: xmm, y: ymm, z: zmm }, { x: xm, y: ym, z: zm }, { x: xm, y: ym, z: zp }], enabled: frame.top.visible && !frame.left.visible }, { fill: color(frame.top.color).brighten(-0.1).get(), vertexes: [{ x: xpp, y: ymm, z: zmm }, { x: xpp, y: ymm, z: zpp }, { x: xp, y: ym, z: zp }, { x: xp, y: ym, z: zm }], enabled: frame.top.visible && !frame.right.visible }, { fill: color(frame.top.color).get(), vertexes: [{ x: xmm, y: ymm, z: zmm }, { x: xpp, y: ymm, z: zmm }, { x: xp, y: ym, z: zm }, { x: xm, y: ym, z: zm }], enabled: frame.top.visible && !frame.front.visible }, { fill: color(frame.top.color).get(), vertexes: [{ x: xpp, y: ymm, z: zpp }, { x: xmm, y: ymm, z: zpp }, { x: xm, y: ym, z: zp }, { x: xp, y: ym, z: zp }], enabled: frame.top.visible && !frame.back.visible }] }); chart.frameShapes.left[verb]({ 'class': 'highcharts-3d-frame highcharts-3d-frame-left', zIndex: frame.left.frontFacing ? -1000 : 1000, faces: [{ fill: color(frame.left.color).brighten(0.1).get(), vertexes: [{ x: xmm, y: ypp, z: zmm }, { x: xm, y: yp, z: zm }, { x: xm, y: yp, z: zp }, { x: xmm, y: ypp, z: zpp }], enabled: frame.left.visible && !frame.bottom.visible }, { fill: color(frame.left.color).brighten(0.1).get(), vertexes: [{ x: xmm, y: ymm, z: zpp }, { x: xm, y: ym, z: zp }, { x: xm, y: ym, z: zm }, { x: xmm, y: ymm, z: zmm }], enabled: frame.left.visible && !frame.top.visible }, { fill: color(frame.left.color).brighten(-0.1).get(), vertexes: [{ x: xmm, y: ypp, z: zpp }, { x: xmm, y: ymm, z: zpp }, { x: xmm, y: ymm, z: zmm }, { x: xmm, y: ypp, z: zmm }], enabled: frame.left.visible }, { fill: color(frame.left.color).brighten(-0.1).get(), vertexes: [{ x: xm, y: ym, z: zp }, { x: xm, y: yp, z: zp }, { x: xm, y: yp, z: zm }, { x: xm, y: ym, z: zm }], enabled: frame.left.visible }, { fill: color(frame.left.color).get(), vertexes: [{ x: xmm, y: ypp, z: zmm }, { x: xmm, y: ymm, z: zmm }, { x: xm, y: ym, z: zm }, { x: xm, y: yp, z: zm }], enabled: frame.left.visible && !frame.front.visible }, { fill: color(frame.left.color).get(), vertexes: [{ x: xmm, y: ymm, z: zpp }, { x: xmm, y: ypp, z: zpp }, { x: xm, y: yp, z: zp }, { x: xm, y: ym, z: zp }], enabled: frame.left.visible && !frame.back.visible }] }); chart.frameShapes.right[verb]({ 'class': 'highcharts-3d-frame highcharts-3d-frame-right', zIndex: frame.right.frontFacing ? -1000 : 1000, faces: [{ fill: color(frame.right.color).brighten(0.1).get(), vertexes: [{ x: xpp, y: ypp, z: zpp }, { x: xp, y: yp, z: zp }, { x: xp, y: yp, z: zm }, { x: xpp, y: ypp, z: zmm }], enabled: frame.right.visible && !frame.bottom.visible }, { fill: color(frame.right.color).brighten(0.1).get(), vertexes: [{ x: xpp, y: ymm, z: zmm }, { x: xp, y: ym, z: zm }, { x: xp, y: ym, z: zp }, { x: xpp, y: ymm, z: zpp }], enabled: frame.right.visible && !frame.top.visible }, { fill: color(frame.right.color).brighten(-0.1).get(), vertexes: [{ x: xp, y: ym, z: zm }, { x: xp, y: yp, z: zm }, { x: xp, y: yp, z: zp }, { x: xp, y: ym, z: zp }], enabled: frame.right.visible }, { fill: color(frame.right.color).brighten(-0.1).get(), vertexes: [{ x: xpp, y: ypp, z: zmm }, { x: xpp, y: ymm, z: zmm }, { x: xpp, y: ymm, z: zpp }, { x: xpp, y: ypp, z: zpp }], enabled: frame.right.visible }, { fill: color(frame.right.color).get(), vertexes: [{ x: xpp, y: ymm, z: zmm }, { x: xpp, y: ypp, z: zmm }, { x: xp, y: yp, z: zm }, { x: xp, y: ym, z: zm }], enabled: frame.right.visible && !frame.front.visible }, { fill: color(frame.right.color).get(), vertexes: [{ x: xpp, y: ypp, z: zpp }, { x: xpp, y: ymm, z: zpp }, { x: xp, y: ym, z: zp }, { x: xp, y: yp, z: zp }], enabled: frame.right.visible && !frame.back.visible }] }); chart.frameShapes.back[verb]({ 'class': 'highcharts-3d-frame highcharts-3d-frame-back', zIndex: frame.back.frontFacing ? -1000 : 1000, faces: [{ fill: color(frame.back.color).brighten(0.1).get(), vertexes: [{ x: xpp, y: ypp, z: zpp }, { x: xmm, y: ypp, z: zpp }, { x: xm, y: yp, z: zp }, { x: xp, y: yp, z: zp }], enabled: frame.back.visible && !frame.bottom.visible }, { fill: color(frame.back.color).brighten(0.1).get(), vertexes: [{ x: xmm, y: ymm, z: zpp }, { x: xpp, y: ymm, z: zpp }, { x: xp, y: ym, z: zp }, { x: xm, y: ym, z: zp }], enabled: frame.back.visible && !frame.top.visible }, { fill: color(frame.back.color).brighten(-0.1).get(), vertexes: [{ x: xmm, y: ypp, z: zpp }, { x: xmm, y: ymm, z: zpp }, { x: xm, y: ym, z: zp }, { x: xm, y: yp, z: zp }], enabled: frame.back.visible && !frame.left.visible }, { fill: color(frame.back.color).brighten(-0.1).get(), vertexes: [{ x: xpp, y: ymm, z: zpp }, { x: xpp, y: ypp, z: zpp }, { x: xp, y: yp, z: zp }, { x: xp, y: ym, z: zp }], enabled: frame.back.visible && !frame.right.visible }, { fill: color(frame.back.color).get(), vertexes: [{ x: xm, y: ym, z: zp }, { x: xp, y: ym, z: zp }, { x: xp, y: yp, z: zp }, { x: xm, y: yp, z: zp }], enabled: frame.back.visible }, { fill: color(frame.back.color).get(), vertexes: [{ x: xmm, y: ypp, z: zpp }, { x: xpp, y: ypp, z: zpp }, { x: xpp, y: ymm, z: zpp }, { x: xmm, y: ymm, z: zpp }], enabled: frame.back.visible }] }); chart.frameShapes.front[verb]({ 'class': 'highcharts-3d-frame highcharts-3d-frame-front', zIndex: frame.front.frontFacing ? -1000 : 1000, faces: [{ fill: color(frame.front.color).brighten(0.1).get(), vertexes: [{ x: xmm, y: ypp, z: zmm }, { x: xpp, y: ypp, z: zmm }, { x: xp, y: yp, z: zm }, { x: xm, y: yp, z: zm }], enabled: frame.front.visible && !frame.bottom.visible }, { fill: color(frame.front.color).brighten(0.1).get(), vertexes: [{ x: xpp, y: ymm, z: zmm }, { x: xmm, y: ymm, z: zmm }, { x: xm, y: ym, z: zm }, { x: xp, y: ym, z: zm }], enabled: frame.front.visible && !frame.top.visible }, { fill: color(frame.front.color).brighten(-0.1).get(), vertexes: [{ x: xmm, y: ymm, z: zmm }, { x: xmm, y: ypp, z: zmm }, { x: xm, y: yp, z: zm }, { x: xm, y: ym, z: zm }], enabled: frame.front.visible && !frame.left.visible }, { fill: color(frame.front.color).brighten(-0.1).get(), vertexes: [{ x: xpp, y: ypp, z: zmm }, { x: xpp, y: ymm, z: zmm }, { x: xp, y: ym, z: zm }, { x: xp, y: yp, z: zm }], enabled: frame.front.visible && !frame.right.visible }, { fill: color(frame.front.color).get(), vertexes: [{ x: xp, y: ym, z: zm }, { x: xm, y: ym, z: zm }, { x: xm, y: yp, z: zm }, { x: xp, y: yp, z: zm }], enabled: frame.front.visible }, { fill: color(frame.front.color).get(), vertexes: [{ x: xpp, y: ypp, z: zmm }, { x: xmm, y: ypp, z: zmm }, { x: xmm, y: ymm, z: zmm }, { x: xpp, y: ymm, z: zmm }], enabled: frame.front.visible }] }); } } /** * Add the required CSS classes for column sides (#6018) * @private */ function onAfterGetContainer() { if (this.styledMode) { // Add definitions used by brighter and darker faces of the cuboids. [{ name: 'darker', slope: 0.6 }, { name: 'brighter', slope: 1.4 }].forEach(function (cfg) { this.renderer.definition({ tagName: 'filter', attributes: { id: 'highcharts-' + cfg.name }, children: [{ tagName: 'feComponentTransfer', children: [{ tagName: 'feFuncR', attributes: { type: 'linear', slope: cfg.slope } }, { tagName: 'feFuncG', attributes: { type: 'linear', slope: cfg.slope } }, { tagName: 'feFuncB', attributes: { type: 'linear', slope: cfg.slope } }] }] }); }, this); } } /** * Legacy support for HC < 6 to make 'scatter' series in a 3D chart route to * the real 'scatter3d' series type. (#8407) * @private */ function onAfterInit() { const options = this.options; if (this.is3d()) { (options.series || []).forEach(function (s) { const type = (s.type || options.chart.type || options.chart.defaultSeriesType); if (type === 'scatter') { s.type = 'scatter3d'; } }); } } /** * @private */ function onAfterSetChartSize() { const chart = this, options3d = chart.options.chart.options3d; if (chart.chart3d && chart.is3d()) { // Add a 0-360 normalisation for alfa and beta angles in 3d graph if (options3d) { options3d.alpha = options3d.alpha % 360 + (options3d.alpha >= 0 ? 0 : 360); options3d.beta = options3d.beta % 360 + (options3d.beta >= 0 ? 0 : 360); } const inverted = chart.inverted, clipBox = chart.clipBox, margin = chart.margin, x = inverted ? 'y' : 'x', y = inverted ? 'x' : 'y', w = inverted ? 'height' : 'width', h = inverted ? 'width' : 'height'; clipBox[x] = -(margin[3] || 0); clipBox[y] = -(margin[0] || 0); clipBox[w] = (chart.chartWidth + (margin[3] || 0) + (margin[1] || 0)); clipBox[h] = (chart.chartHeight + (margin[0] || 0) + (margin[2] || 0)); // Set scale, used later in perspective method(): // getScale uses perspective, so scale3d has to be reset. chart.scale3d = 1; if (options3d.fitToPlot === true) { chart.scale3d = chart.chart3d.getScale(options3d.depth); } // Recalculate the 3d frame with every call of setChartSize, // instead of doing it after every redraw(). It avoids ticks // and axis title outside of chart. chart.chart3d.frame3d = chart.chart3d.get3dFrame(); // #7942 } } /** * @private */ function onBeforeRedraw() { if (this.is3d()) { // Set to force a redraw of all elements this.isDirtyBox = true; } } /** * @private */ function onBeforeRender() { if (this.chart3d && this.is3d()) { this.chart3d.frame3d = this.chart3d.get3dFrame(); } } /** * @private */ function onInit() { if (!this.chart3d) { this.chart3d = new Additions(this); } } /** * @private */ function wrapIsInsidePlot(proceed) { return this.is3d() || proceed.apply(this, [].slice.call(arguments, 1)); } /** * Draw the series in the reverse order (#3803, #3917) * @private */ function wrapRenderSeries(proceed) { let series, i = this.series.length; if (this.is3d()) { while (i--) { series = this.series[i]; series.translate(); series.render(); } } else { proceed.call(this); } } /** * @private */ function wrapSetClassName(proceed) { proceed.apply(this, [].slice.call(arguments, 1)); if (this.is3d()) { this.container.className += ' highcharts-3d-chart'; } } /* * * * Class * * */ class Additions { /* * * * Constructors * * */ constructor(chart) { this.chart = chart; } /* * * * Functions * * */ get3dFrame() { const chart = this.chart, options3d = chart.options.chart.options3d, frameOptions = options3d.frame, xm = chart.plotLeft, xp = chart.plotLeft + chart.plotWidth, ym = chart.plotTop, yp = chart.plotTop + chart.plotHeight, zm = 0, zp = options3d.depth, faceOrientation = function (vertexes) { const area = shapeArea3D(vertexes, chart); // Give it 0.5 squared-pixel as a margin for rounding errors if (area > 0.5) { return 1; } if (area < -0.5) { return -1; } return 0; }, bottomOrientation = faceOrientation([ { x: xm, y: yp, z: zp }, { x: xp, y: yp, z: zp }, { x: xp, y: yp, z: zm }, { x: xm, y: yp, z: zm } ]), topOrientation = faceOrientation([ { x: xm, y: ym, z: zm }, { x: xp, y: ym, z: zm }, { x: xp, y: ym, z: zp }, { x: xm, y: ym, z: zp } ]), leftOrientation = faceOrientation([ { x: xm, y: ym, z: zm }, { x: xm, y: ym, z: zp }, { x: xm, y: yp, z: zp }, { x: xm, y: yp, z: zm } ]), rightOrientation = faceOrientation([ { x: xp, y: ym, z: zp }, { x: xp, y: ym, z: zm }, { x: xp, y: yp, z: zm }, { x: xp, y: yp, z: zp } ]), frontOrientation = faceOrientation([ { x: xm, y: yp, z: zm }, { x: xp, y: yp, z: zm }, { x: xp, y: ym, z: zm }, { x: xm, y: ym, z: zm } ]), backOrientation = faceOrientation([ { x: xm, y: ym, z: zp }, { x: xp, y: ym, z: zp }, { x: xp, y: yp, z: zp }, { x: xm, y: yp, z: zp } ]), defaultShowFront = false, defaultShowBack = true; let defaultShowBottom = false, defaultShowTop = false, defaultShowLeft = false, defaultShowRight = false; // The 'default' criteria to visible faces of the frame is looking // up every axis to decide whenever the left/right//top/bottom sides // of the frame will be shown [] .concat(chart.xAxis, chart.yAxis, chart.zAxis) .forEach(function (axis) { if (axis) { if (axis.horiz) { if (axis.opposite) { defaultShowTop = true; } else { defaultShowBottom = true; } } else { if (axis.opposite) { defaultShowRight = true; } else { defaultShowLeft = true; } } } }); const getFaceOptions = function (sources, faceOrientation, defaultVisible) { const faceAttrs = ['size', 'color', 'visible'], options = {}; for (let i = 0; i < faceAttrs.length; i++) { const attr = faceAttrs[i]; for (let j = 0; j < sources.length; j++) { if (typeof sources[j] === 'object') { const val = sources[j][attr]; if (typeof val !== 'undefined' && val !== null) { options[attr] = val; break; } } } } let isVisible = defaultVisible; if (options.visible === true || options.visible === false) { isVisible = options.visible; } else if (options.visible === 'auto') { isVisible = faceOrientation > 0; } return { size: pick(options.size, 1), color: pick(options.color, 'none'), frontFacing: faceOrientation > 0, visible: isVisible }; }; // Docs @TODO: Add all frame options (left, right, top, bottom, // front, back) to apioptions JSDoc once the new system is up. const ret = { axes: {}, // FIXME: Previously, left/right, top/bottom and front/back // pairs shared size and color. // For compatibility and consistency sake, when one face have // size/color/visibility set, the opposite face will default to // the same values. Also, left/right used to be called 'side', // so that's also added as a fallback. bottom: getFaceOptions([frameOptions.bottom, frameOptions.top, frameOptions], bottomOrientation, defaultShowBottom), top: getFaceOptions([frameOptions.top, frameOptions.bottom, frameOptions], topOrientation, defaultShowTop), left: getFaceOptions([ frameOptions.left, frameOptions.right, frameOptions.side, frameOptions ], leftOrientation, defaultShowLeft), right: getFaceOptions([ frameOptions.right, frameOptions.left, frameOptions.side, frameOptions ], rightOrientation, defaultShowRight), back: getFaceOptions([frameOptions.back, frameOptions.front, frameOptions], backOrientation, defaultShowBack), front: getFaceOptions([frameOptions.front, frameOptions.back, frameOptions], frontOrientation, defaultShowFront) }; // Decide the bast place to put axis title/labels based on the // visible faces. Ideally, The labels can only be on the edge // between a visible face and an invisible one. Also, the Y label // should be one the left-most edge (right-most if opposite). if (options3d.axisLabelPosition === 'auto') { const isValidEdge = function (face1, face2) { return ((face1.visible !== face2.visible) || (face1.visible && face2.visible && (face1.frontFacing !== face2.frontFacing))); }; const yEdges = []; if (isValidEdge(ret.left, ret.front)) { yEdges.push({ y: (ym + yp) / 2, x: xm, z: zm, xDir: { x: 1, y: 0, z: 0 } }); } if (isValidEdge(ret.left, ret.back)) { yEdges.push({ y: (ym + yp) / 2, x: xm, z: zp, xDir: { x: 0, y: 0, z: -1 } }); } if (isValidEdge(ret.right, ret.front)) { yEdges.push({ y: (ym + yp) / 2, x: xp, z: zm, xDir: { x: 0, y: 0, z: 1 } }); } if (isValidEdge(ret.right, ret.back)) { yEdges.push({ y: (ym + yp) / 2, x: xp, z: zp, xDir: { x: -1, y: 0, z: 0 } }); } const xBottomEdges = []; if (isValidEdge(ret.bottom, ret.front)) { xBottomEdges.push({ x: (xm + xp) / 2, y: yp, z: zm, xDir: { x: 1, y: 0, z: 0 } }); } if (isValidEdge(ret.bottom, ret.back)) { xBottomEdges.push({ x: (xm + xp) / 2, y: yp, z: zp, xDir: { x: -1, y: 0, z: 0 } }); } const xTopEdges = []; if (isValidEdge(ret.top, ret.front)) { xTopEdges.push({ x: (xm + xp) / 2, y: ym, z: zm, xDir: { x: 1, y: 0, z: 0 } }); } if (isValidEdge(ret.top, ret.back)) { xTopEdges.push({ x: (xm + xp) / 2, y: ym, z: zp, xDir: { x: -1, y: 0, z: 0 } }); } const zBottomEdges = []; if (isValidEdge(ret.bottom, ret.left)) { zBottomEdges.push({ z: (zm + zp) / 2, y: yp, x: xm, xDir: { x: 0, y: 0, z: -1 } }); } if (isValidEdge(ret.bottom, ret.right)) { zBottomEdges.push({ z: (zm + zp) / 2, y: yp, x: xp, xDir: { x: 0, y: 0, z: 1 } }); } const zTopEdges = []; if (isValidEdge(ret.top, ret.left)) { zTopEdges.push({ z: (zm + zp) / 2, y: ym, x: xm, xDir: { x: 0, y: 0, z: -1 } }); } if (isValidEdge(ret.top, ret.right)) { zTopEdges.push({ z: (zm + zp) / 2, y: ym, x: xp, xDir: { x: 0, y: 0, z: 1 } }); } const pickEdge = function (edges, axis, mult) { if (edges.length === 0) { return null; } if (edges.length === 1) { return edges[0]; } const projections = perspective(edges, chart, false); let best = 0; for (let i = 1; i < projections.length; i++) { if (mult * projections[i][axis] > mult * projections[best][axis]) { best = i; } else if ((mult * projections[i][axis] === mult * projections[best][axis]) && (projections[i].z < projections[best].z)) { best = i; } } return edges[best]; }; ret.axes = { y: { 'left': pickEdge(yEdges, 'x', -1), 'right': pickEdge(yEdges, 'x', +1) }, x: { 'top': pickEdge(xTopEdges, 'y', -1), 'bottom': pickEdge(xBottomEdges, 'y', +1) }, z: { 'top': pickEdge(zTopEdges, 'y', -1), 'bottom': pickEdge(zBottomEdges, 'y', +1) } }; } else { ret.axes = { y: { 'left': { x: xm, z: zm, xDir: { x: 1, y: 0, z: 0 } }, 'right': { x: xp, z: zm, xDir: { x: 0, y: 0, z: 1 } } }, x: { 'top': { y: ym, z: zm, xDir: { x: 1, y: 0, z: 0 } }, 'bottom': { y: yp, z: zm, xDir: { x: 1, y: 0, z: 0 } } }, z: { 'top': { x: defaultShowLeft ? xp : xm, y: ym, xDir: defaultShowLeft ? { x: 0, y: 0, z: 1 } : { x: 0, y: 0, z: -1 } }, 'bottom': { x: defaultShowLeft ? xp : xm, y: yp, xDir: defaultShowLeft ? { x: 0, y: 0, z: 1 } : { x: 0, y: 0, z: -1 } } } }; } return ret; } /** * Calculate scale of the 3D view. That is required to fit chart's 3D * projection into the actual plotting area. Reported as #4933. * * **Note:** * This function should ideally take the plot values instead of a chart * object, but since the chart object is needed for perspective it is * not practical. Possible to make both getScale and perspective more * logical and also immutable. * * @private * @function getScale * * @param {number} depth * The depth of the chart * * @return {number} * The scale to fit the 3D chart into the plotting area. * * @requires highcharts-3d */ getScale(depth) { const chart = this.chart, plotLeft = chart.plotLeft, plotRight = chart.plotWidth + plotLeft, plotTop = chart.plotTop, plotBottom = chart.plotHeight + plotTop, originX = plotLeft + chart.plotWidth / 2, originY = plotTop + chart.plotHeight / 2, bbox3d = { minX: Number.MAX_VALUE, maxX: -Number.MAX_VALUE, minY: Number.MAX_VALUE, maxY: -Number.MAX_VALUE }; let corners, scale = 1; // Top left corners: corners = [{ x: plotLeft, y: plotTop, z: 0 }, { x: plotLeft, y: plotTop, z: depth }]; // Top right corners: [0, 1].forEach(function (i) { corners.push({ x: plotRight, y: corners[i].y, z: corners[i].z }); }); // All bottom corners: [0, 1, 2, 3].forEach(function (i) { corners.push({ x: corners[i].x, y: plotBottom, z: corners[i].z }); }); // Calculate 3D corners: corners = perspective(corners, chart, false); // Get bounding box of 3D element: corners.forEach(function (corner) { bbox3d.minX = Math.min(bbox3d.minX, corner.x); bbox3d.maxX = Math.max(bbox3d.maxX, corner.x); bbox3d.minY = Math.min(bbox3d.minY, corner.y); bbox3d.maxY = Math.max(bbox3d.maxY, corner.y); }); // Left edge: if (plotLeft > bbox3d.minX) { scale = Math.min(scale, 1 - Math.abs((plotLeft + originX) / (bbox3d.minX + originX)) % 1); } // Right edge: if (plotRight < bbox3d.maxX) { scale = Math.min(scale, (plotRight - originX) / (bbox3d.maxX - originX)); } // Top edge: if (plotTop > bbox3d.minY) { if (bbox3d.minY < 0) { scale = Math.min(scale, (plotTop + originY) / (-bbox3d.minY + plotTop + originY)); } else { scale = Math.min(scale, 1 - (plotTop + originY) / (bbox3d.minY + originY) % 1); } } // Bottom edge: if (plotBottom < bbox3d.maxY) { scale = Math.min(scale, Math.abs((plotBottom - originY) / (bbox3d.maxY - originY))); } return scale; } } Chart3D.Additions = Additions; })(Chart3D || (Chart3D = {})); /* * * * Default Export * * */ /* * * * API Declarations * * */ /** * Note: As of v5.0.12, `frame.left` or `frame.right` should be used instead. * * The side for the frame around a 3D chart. * * @deprecated * @since 4.0 * @product highcharts * @requires highcharts-3d * @apioption chart.options3d.frame.side */ /** * The color of the panel. * * @deprecated * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject} * @default transparent * @since 4.0 * @product highcharts * @apioption chart.options3d.frame.side.color */ /** * The thickness of the panel. * * @deprecated * @type {number} * @default 1 * @since 4.0 * @product highcharts * @apioption chart.options3d.frame.side.size */ ''; // Keeps doclets above in JS file return Chart3D; }); _registerModule(_modules, 'Series/Area3D/Area3DSeries.js', [_modules['Core/Globals.js'], _modules['Core/Math3D.js'], _modules['Core/Series/SeriesRegistry.js'], _modules['Core/Utilities.js']], function (H, Math3D, SeriesRegistry, U) { /* * * * (c) 2010-2024 Grzegorz Blachliński * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { composed } = H; const { perspective } = Math3D; const { line: { prototype: lineProto } } = SeriesRegistry.seriesTypes; const { pushUnique, wrap } = U; /* * * * Functions * * */ /** * */ function compose(AreaSeriesClass) { if (pushUnique(composed, 'Area3DSeries')) { wrap(AreaSeriesClass.prototype, 'getGraphPath', wrapAreaSeriesGetGraphPath); } } /** * */ function wrapAreaSeriesGetGraphPath(proceed) { const series = this, svgPath = proceed.apply(series, [].slice.call(arguments, 1)); // Do not do this if the chart is not 3D if (!series.chart.is3d()) { return svgPath; } const getGraphPath = lineProto.getGraphPath, options = series.options, translatedThreshold = Math.round(// #10909 series.yAxis.getThreshold(options.threshold)); let bottomPoints = []; if (series.rawPointsX) { for (let i = 0; i < series.points.length; i++) { bottomPoints.push({ x: series.rawPointsX[i], y: options.stacking ? series.points[i].yBottom : translatedThreshold, z: series.zPadding }); } } const options3d = series.chart.options.chart.options3d; bottomPoints = perspective(bottomPoints, series.chart, true).map((point) => ({ plotX: point.x, plotY: point.y, plotZ: point.z })); if (series.group && options3d && options3d.depth && options3d.beta) { // Markers should take the global zIndex of series group. if (series.markerGroup) { series.markerGroup.add(series.group); series.markerGroup.attr({ translateX: 0, translateY: 0 }); } series.group.attr({ zIndex: Math.max(1, (options3d.beta > 270 || options3d.beta < 90) ? options3d.depth - Math.round(series.zPadding || 0) : Math.round(series.zPadding || 0)) }); } bottomPoints.reversed = true; const bottomPath = getGraphPath.call(series, bottomPoints, true, true); if (bottomPath[0] && bottomPath[0][0] === 'M') { bottomPath[0] = ['L', bottomPath[0][1], bottomPath[0][2]]; } if (series.areaPath) { // Remove previously used bottomPath and add the new one. const areaPath = series.areaPath.splice(0, series.areaPath.length / 2).concat(bottomPath); // Use old xMap in the new areaPath areaPath.xMap = series.areaPath.xMap; series.areaPath = areaPath; } series.graphPath = svgPath; return svgPath; } /* * * * Default Export * * */ const Area3DSeries = { compose }; return Area3DSeries; }); _registerModule(_modules, 'Core/Axis/Axis3DDefaults.js', [], function () { /* * * * (c) 2010-2024 Torstein Honsi * * Extension for 3d axes * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ /* * * * Constants * * */ /** * @optionparent xAxis */ const Axis3DDefaults = { labels: { /** * Defines how the labels are be repositioned according to the 3D * chart orientation. * * - `'offset'`: Maintain a fixed horizontal/vertical distance from * the tick marks, despite the chart orientation. This is the * backwards compatible behavior, and causes skewing of X and Z * axes. * * - `'chart'`: Preserve 3D position relative to the chart. This * looks nice, but hard to read if the text isn't forward-facing. * * - `'flap'`: Rotated text along the axis to compensate for the * chart orientation. This tries to maintain text as legible as * possible on all orientations. * * - `'ortho'`: Rotated text along the axis direction so that the * labels are orthogonal to the axis. This is very similar to * `'flap'`, but prevents skewing the labels (X and Y scaling are * still present). * * @sample highcharts/3d/skewed-labels/ * Skewed labels * * @since 5.0.15 * @validvalue ['offset', 'chart', 'flap', 'ortho'] * @product highcharts * @requires highcharts-3d */ position3d: 'offset', /** * If enabled, the axis labels will skewed to follow the * perspective. * * This will fix overlapping labels and titles, but texts become * less legible due to the distortion. * * The final appearance depends heavily on `labels.position3d`. * * @sample highcharts/3d/skewed-labels/ * Skewed labels * * @since 5.0.15 * @product highcharts * @requires highcharts-3d */ skew3d: false }, title: { /** * Defines how the title is repositioned according to the 3D chart * orientation. * * - `'offset'`: Maintain a fixed horizontal/vertical distance from * the tick marks, despite the chart orientation. This is the * backwards compatible behavior, and causes skewing of X and Z * axes. * * - `'chart'`: Preserve 3D position relative to the chart. This * looks nice, but hard to read if the text isn't forward-facing. * * - `'flap'`: Rotated text along the axis to compensate for the * chart orientation. This tries to maintain text as legible as * possible on all orientations. * * - `'ortho'`: Rotated text along the axis direction so that the * labels are orthogonal to the axis. This is very similar to * `'flap'`, but prevents skewing the labels (X and Y scaling are * still present). * * - `undefined`: Will use the config from `labels.position3d` * * @sample highcharts/3d/skewed-labels/ * Skewed labels * * @type {"offset"|"chart"|"flap"|"ortho"|null} * @since 5.0.15 * @product highcharts * @requires highcharts-3d */ position3d: null, /** * If enabled, the axis title will skewed to follow the perspective. * * This will fix overlapping labels and titles, but texts become * less legible due to the distortion. * * The final appearance depends heavily on `title.position3d`. * * A `null` value will use the config from `labels.skew3d`. * * @sample highcharts/3d/skewed-labels/ * Skewed labels * * @type {boolean|null} * @since 5.0.15 * @product highcharts * @requires highcharts-3d */ skew3d: null } }; /* * * * Default Export * * */ return Axis3DDefaults; }); _registerModule(_modules, 'Core/Axis/Tick3DComposition.js', [_modules['Core/Globals.js'], _modules['Core/Utilities.js']], function (H, U) { /* * * * (c) 2010-2024 Torstein Honsi * * Extension for 3d axes * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { composed } = H; const { addEvent, extend, pushUnique, wrap } = U; /* * * * Functions * * */ /** * @private */ function compose(TickClass) { if (pushUnique(composed, 'Axis.Tick3D')) { addEvent(TickClass, 'afterGetLabelPosition', onTickAfterGetLabelPosition); wrap(TickClass.prototype, 'getMarkPath', wrapTickGetMarkPath); } } /** * @private */ function onTickAfterGetLabelPosition(e) { const axis3D = this.axis.axis3D; if (axis3D) { extend(e.pos, axis3D.fix3dPosition(e.pos)); } } /** * @private */ function wrapTickGetMarkPath(proceed) { const axis3D = this.axis.axis3D, path = proceed.apply(this, [].slice.call(arguments, 1)); if (axis3D) { const start = path[0]; const end = path[1]; if (start[0] === 'M' && end[0] === 'L') { const pArr = [ axis3D.fix3dPosition({ x: start[1], y: start[2], z: 0 }), axis3D.fix3dPosition({ x: end[1], y: end[2], z: 0 }) ]; return this.axis.chart.renderer.toLineSegments(pArr); } } return path; } /* * * * Default Export * * */ const Tick3DAdditions = { compose }; return Tick3DAdditions; }); _registerModule(_modules, 'Core/Axis/Axis3DComposition.js', [_modules['Core/Axis/Axis3DDefaults.js'], _modules['Core/Defaults.js'], _modules['Core/Globals.js'], _modules['Core/Math3D.js'], _modules['Core/Axis/Tick3DComposition.js'], _modules['Core/Utilities.js']], function (Axis3DDefaults, D, H, Math3D, Tick3D, U) { /* * * * (c) 2010-2024 Torstein Honsi * * Extension for 3d axes * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { defaultOptions } = D; const { deg2rad } = H; const { perspective, perspective3D, shapeArea } = Math3D; const { addEvent, merge, pick, wrap } = U; /* * * * Functions * * */ /** * @private */ function onAxisAfterSetOptions() { const axis = this, chart = axis.chart, options = axis.options; if (chart.is3d && chart.is3d() && axis.coll !== 'colorAxis') { options.tickWidth = pick(options.tickWidth, 0); options.gridLineWidth = pick(options.gridLineWidth, 1); } } /** * @private */ function onAxisDrawCrosshair(e) { const axis = this; if (axis.chart.is3d() && axis.coll !== 'colorAxis') { if (e.point) { e.point.crosshairPos = axis.isXAxis ? e.point.axisXpos : axis.len - e.point.axisYpos; } } } /** * @private */ function onAxisInit() { const axis = this; if (!axis.axis3D) { axis.axis3D = new Axis3DAdditions(axis); } } /** * Do not draw axislines in 3D. * @private */ function wrapAxisGetLinePath(proceed) { const axis = this; // Do not do this if the chart is not 3D if (!axis.chart.is3d() || axis.coll === 'colorAxis') { return proceed.apply(axis, [].slice.call(arguments, 1)); } return []; } /** * @private */ function wrapAxisGetPlotBandPath(proceed) { // Do not do this if the chart is not 3D if (!this.chart.is3d() || this.coll === 'colorAxis') { return proceed.apply(this, [].slice.call(arguments, 1)); } const args = arguments, from = args[1], to = args[2], path = [], fromPath = this.getPlotLinePath({ value: from }), toPath = this.getPlotLinePath({ value: to }); if (fromPath && toPath) { for (let i = 0; i < fromPath.length; i += 2) { const fromStartSeg = fromPath[i], fromEndSeg = fromPath[i + 1], toStartSeg = toPath[i], toEndSeg = toPath[i + 1]; if (fromStartSeg[0] === 'M' && fromEndSeg[0] === 'L' && toStartSeg[0] === 'M' && toEndSeg[0] === 'L') { path.push(fromStartSeg, fromEndSeg, toEndSeg, // `lineTo` instead of `moveTo` ['L', toStartSeg[1], toStartSeg[2]], ['Z']); } } } return path; } /** * @private */ function wrapAxisGetPlotLinePath(proceed) { const axis = this, axis3D = axis.axis3D, chart = axis.chart, path = proceed.apply(axis, [].slice.call(arguments, 1)); // Do not do this if the chart is not 3D if (axis.coll === 'colorAxis' || !chart.chart3d || !chart.is3d()) { return path; } if (path === null) { return path; } const options3d = chart.options.chart.options3d, d = axis.isZAxis ? chart.plotWidth : options3d.depth, frame = chart.chart3d.frame3d, startSegment = path[0], endSegment = path[1]; let pArr, pathSegments = []; if (startSegment[0] === 'M' && endSegment[0] === 'L') { pArr = [ axis3D.swapZ({ x: startSegment[1], y: startSegment[2], z: 0 }), axis3D.swapZ({ x: startSegment[1], y: startSegment[2], z: d }), axis3D.swapZ({ x: endSegment[1], y: endSegment[2], z: 0 }), axis3D.swapZ({ x: endSegment[1], y: endSegment[2], z: d }) ]; if (!this.horiz) { // Y-Axis if (frame.front.visible) { pathSegments.push(pArr[0], pArr[2]); } if (frame.back.visible) { pathSegments.push(pArr[1], pArr[3]); } if (frame.left.visible) { pathSegments.push(pArr[0], pArr[1]); } if (frame.right.visible) { pathSegments.push(pArr[2], pArr[3]); } } else if (this.isZAxis) { // Z-Axis if (frame.left.visible) { pathSegments.push(pArr[0], pArr[2]); } if (frame.right.visible) { pathSegments.push(pArr[1], pArr[3]); } if (frame.top.visible) { pathSegments.push(pArr[0], pArr[1]); } if (frame.bottom.visible) { pathSegments.push(pArr[2], pArr[3]); } } else { // X-Axis if (frame.front.visible) { pathSegments.push(pArr[0], pArr[2]); } if (frame.back.visible) { pathSegments.push(pArr[1], pArr[3]); } if (frame.top.visible) { pathSegments.push(pArr[0], pArr[1]); } if (frame.bottom.visible) { pathSegments.push(pArr[2], pArr[3]); } } pathSegments = perspective(pathSegments, this.chart, false); } return chart.renderer.toLineSegments(pathSegments); } /** * Wrap getSlotWidth function to calculate individual width value for each * slot (#8042). * @private */ function wrapAxisGetSlotWidth(proceed, tick) { const axis = this, { chart, gridGroup, tickPositions, ticks } = axis; if (axis.categories && chart.frameShapes && chart.is3d() && gridGroup && tick && tick.label) { const firstGridLine = (gridGroup.element.childNodes[0].getBBox()), frame3DLeft = chart.frameShapes.left.getBBox(), options3d = chart.options.chart.options3d, origin = { x: chart.plotWidth / 2, y: chart.plotHeight / 2, z: options3d.depth / 2, vd: (pick(options3d.depth, 1) * pick(options3d.viewDistance, 0)) }, index = tickPositions.indexOf(tick.pos), prevTick = ticks[tickPositions[index - 1]], nextTick = ticks[tickPositions[index + 1]]; let labelPos, prevLabelPos, nextLabelPos; // Check whether the tick is not the first one and previous tick // exists, then calculate position of previous label. if (prevTick?.label?.xy) { prevLabelPos = perspective3D({ x: prevTick.label.xy.x, y: prevTick.label.xy.y, z: null }, origin, origin.vd); } // If next label position is defined, then recalculate its position // basing on the perspective. if (nextTick && nextTick.label && nextTick.label.xy) { nextLabelPos = perspective3D({ x: nextTick.label.xy.x, y: nextTick.label.xy.y, z: null }, origin, origin.vd); } labelPos = { x: tick.label.xy.x, y: tick.label.xy.y, z: null }; labelPos = perspective3D(labelPos, origin, origin.vd); // If tick is first one, check whether next label position is // already calculated, then return difference between the first and // the second label. If there is no next label position calculated, // return the difference between the first grid line and left 3d // frame. return Math.abs(prevLabelPos ? labelPos.x - prevLabelPos.x : nextLabelPos ? nextLabelPos.x - labelPos.x : firstGridLine.x - frame3DLeft.x); } return proceed.apply(axis, [].slice.call(arguments, 1)); } /** * @private */ function wrapAxisGetTitlePosition(proceed) { const pos = proceed.apply(this, [].slice.call(arguments, 1)); return this.axis3D ? this.axis3D.fix3dPosition(pos, true) : pos; } /* * * * Class * * */ /** * Adds 3D support to axes. * @private * @class */ class Axis3DAdditions { /* * * * Functions * * */ /** * Extends axis class with 3D support. * @private */ static compose(AxisClass, TickClass) { Tick3D.compose(TickClass); if (!AxisClass.keepProps.includes('axis3D')) { merge(true, defaultOptions.xAxis, Axis3DDefaults); AxisClass.keepProps.push('axis3D'); addEvent(AxisClass, 'init', onAxisInit); addEvent(AxisClass, 'afterSetOptions', onAxisAfterSetOptions); addEvent(AxisClass, 'drawCrosshair', onAxisDrawCrosshair); const axisProto = AxisClass.prototype; wrap(axisProto, 'getLinePath', wrapAxisGetLinePath); wrap(axisProto, 'getPlotBandPath', wrapAxisGetPlotBandPath); wrap(axisProto, 'getPlotLinePath', wrapAxisGetPlotLinePath); wrap(axisProto, 'getSlotWidth', wrapAxisGetSlotWidth); wrap(axisProto, 'getTitlePosition', wrapAxisGetTitlePosition); } } /* * * * Constructors * * */ /** * @private */ constructor(axis) { this.axis = axis; } /* * * * Functions * * */ /** * @private * @param {Highcharts.Axis} axis * Related axis. * @param {Highcharts.Position3DObject} pos * Position to fix. * @param {boolean} [isTitle] * Whether this is a title position. * @return {Highcharts.Position3DObject} * Fixed position. */ fix3dPosition(pos, isTitle) { const axis3D = this; const axis = axis3D.axis; const chart = axis.chart; // Do not do this if the chart is not 3D if (axis.coll === 'colorAxis' || !chart.chart3d || !chart.is3d()) { return pos; } const alpha = deg2rad * chart.options.chart.options3d.alpha, beta = deg2rad * chart.options.chart.options3d.beta, positionMode = pick(isTitle && axis.options.title.position3d, axis.options.labels.position3d), skew = pick(isTitle && axis.options.title.skew3d, axis.options.labels.skew3d), frame = chart.chart3d.frame3d, plotLeft = chart.plotLeft, plotRight = chart.plotWidth + plotLeft, plotTop = chart.plotTop, plotBottom = chart.plotHeight + plotTop; let offsetX = 0, offsetY = 0, vecX, vecY = { x: 0, y: 1, z: 0 }, // Indicates that we are labelling an X or Z axis on the "back" of // the chart reverseFlap = false; pos = axis.axis3D.swapZ({ x: pos.x, y: pos.y, z: 0 }); if (axis.isZAxis) { // Z Axis if (axis.opposite) { if (frame.axes.z.top === null) { return {}; } offsetY = pos.y - plotTop; pos.x = frame.axes.z.top.x; pos.y = frame.axes.z.top.y; vecX = frame.axes.z.top.xDir; reverseFlap = !frame.top.frontFacing; } else { if (frame.axes.z.bottom === null) { return {}; } offsetY = pos.y - plotBottom; pos.x = frame.axes.z.bottom.x; pos.y = frame.axes.z.bottom.y; vecX = frame.axes.z.bottom.xDir; reverseFlap = !frame.bottom.frontFacing; } } else if (axis.horiz) { // X Axis if (axis.opposite) { if (frame.axes.x.top === null) { return {}; } offsetY = pos.y - plotTop; pos.y = frame.axes.x.top.y; pos.z = frame.axes.x.top.z; vecX = frame.axes.x.top.xDir; reverseFlap = !frame.top.frontFacing; } else { if (frame.axes.x.bottom === null) { return {}; } offsetY = pos.y - plotBottom; pos.y = frame.axes.x.bottom.y; pos.z = frame.axes.x.bottom.z; vecX = frame.axes.x.bottom.xDir; reverseFlap = !frame.bottom.frontFacing; } } else { // Y Axis if (axis.opposite) { if (frame.axes.y.right === null) { return {}; } offsetX = pos.x - plotRight; pos.x = frame.axes.y.right.x; pos.z = frame.axes.y.right.z; vecX = frame.axes.y.right.xDir; // Rotate 90º on opposite edge vecX = { x: vecX.z, y: vecX.y, z: -vecX.x }; } else { if (frame.axes.y.left === null) { return {}; } offsetX = pos.x - plotLeft; pos.x = frame.axes.y.left.x; pos.z = frame.axes.y.left.z; vecX = frame.axes.y.left.xDir; } } if (positionMode === 'chart') { // Labels preserve their direction relative to the chart // nothing to do } else if (positionMode === 'flap') { // Labels are rotated around the axis direction to face the screen if (!axis.horiz) { // Y Axis vecX = { x: Math.cos(beta), y: 0, z: Math.sin(beta) }; } else { // X and Z Axis let sin = Math.sin(alpha); const cos = Math.cos(alpha); if (axis.opposite) { sin = -sin; } if (reverseFlap) { sin = -sin; } vecY = { x: vecX.z * sin, y: cos, z: -vecX.x * sin }; } } else if (positionMode === 'ortho') { // Labels will be rotated to be orthogonal to the axis if (!axis.horiz) { // Y Axis vecX = { x: Math.cos(beta), y: 0, z: Math.sin(beta) }; } else { // X and Z Axis const sina = Math.sin(alpha); const cosa = Math.cos(alpha); const sinb = Math.sin(beta); const cosb = Math.cos(beta); const vecZ = { x: sinb * cosa, y: -sina, z: -cosa * cosb }; vecY = { x: vecX.y * vecZ.z - vecX.z * vecZ.y, y: vecX.z * vecZ.x - vecX.x * vecZ.z, z: vecX.x * vecZ.y - vecX.y * vecZ.x }; let scale = 1 / Math.sqrt(vecY.x * vecY.x + vecY.y * vecY.y + vecY.z * vecY.z); if (reverseFlap) { scale = -scale; } vecY = { x: scale * vecY.x, y: scale * vecY.y, z: scale * vecY.z }; } } else { // Position mode == 'offset' // Labels will be skewd to maintain vertical / horizontal offsets // from axis if (!axis.horiz) { // Y Axis vecX = { x: Math.cos(beta), y: 0, z: Math.sin(beta) }; } else { // X and Z Axis vecY = { x: Math.sin(beta) * Math.sin(alpha), y: Math.cos(alpha), z: -Math.cos(beta) * Math.sin(alpha) }; } } pos.x += offsetX * vecX.x + offsetY * vecY.x; pos.y += offsetX * vecX.y + offsetY * vecY.y; pos.z += offsetX * vecX.z + offsetY * vecY.z; const projected = perspective([pos], axis.chart)[0]; if (skew) { // Check if the label text would be mirrored const isMirrored = shapeArea(perspective([ pos, { x: pos.x + vecX.x, y: pos.y + vecX.y, z: pos.z + vecX.z }, { x: pos.x + vecY.x, y: pos.y + vecY.y, z: pos.z + vecY.z } ], axis.chart)) < 0; if (isMirrored) { vecX = { x: -vecX.x, y: -vecX.y, z: -vecX.z }; } const pointsProjected = perspective([ { x: pos.x, y: pos.y, z: pos.z }, { x: pos.x + vecX.x, y: pos.y + vecX.y, z: pos.z + vecX.z }, { x: pos.x + vecY.x, y: pos.y + vecY.y, z: pos.z + vecY.z } ], axis.chart); projected.matrix = [ pointsProjected[1].x - pointsProjected[0].x, pointsProjected[1].y - pointsProjected[0].y, pointsProjected[2].x - pointsProjected[0].x, pointsProjected[2].y - pointsProjected[0].y, projected.x, projected.y ]; projected.matrix[4] -= projected.x * projected.matrix[0] + projected.y * projected.matrix[2]; projected.matrix[5] -= projected.x * projected.matrix[1] + projected.y * projected.matrix[3]; } return projected; } /** * @private */ swapZ(p, insidePlotArea) { const axis = this.axis; if (axis.isZAxis) { const plotLeft = insidePlotArea ? 0 : axis.chart.plotLeft; return { x: plotLeft + p.z, y: p.y, z: p.x - plotLeft }; } return p; } } /* * * * Default Export * * */ return Axis3DAdditions; }); _registerModule(_modules, 'Core/Series/Series3D.js', [_modules['Core/Globals.js'], _modules['Core/Math3D.js'], _modules['Core/Series/Series.js'], _modules['Core/Utilities.js']], function (H, Math3D, Series, U) { /* * * * (c) 2010-2024 Torstein Honsi * * Extension to the Series object in 3D charts. * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { composed } = H; const { perspective } = Math3D; const { addEvent, extend, isNumber, merge, pick, pushUnique } = U; /* * * * Class * * */ class Series3D extends Series { /* * * * Static Functions * * */ static compose(SeriesClass) { if (pushUnique(composed, 'Core.Series3D')) { addEvent(SeriesClass, 'afterTranslate', function () { if (this.chart.is3d()) { this.translate3dPoints(); } }); extend(SeriesClass.prototype, { translate3dPoints: Series3D.prototype.translate3dPoints }); } } /* * * * Functions * * */ /** * Translate the plotX, plotY properties and add plotZ. * @private */ translate3dPoints() { const series = this, seriesOptions = series.options, chart = series.chart, zAxis = pick(series.zAxis, chart.options.zAxis[0]), rawPoints = [], rawPointsX = [], stack = seriesOptions.stacking ? (isNumber(seriesOptions.stack) ? seriesOptions.stack : 0) : series.index || 0; let projectedPoint, zValue; series.zPadding = stack * (seriesOptions.depth || 0 + (seriesOptions.groupZPadding || 1)); series.data.forEach((rawPoint) => { if (zAxis && zAxis.translate) { zValue = zAxis.logarithmic && zAxis.val2lin ? zAxis.val2lin(rawPoint.z) : rawPoint.z; // #4562 rawPoint.plotZ = zAxis.translate(zValue); rawPoint.isInside = rawPoint.isInside ? (zValue >= zAxis.min && zValue <= zAxis.max) : false; } else { rawPoint.plotZ = series.zPadding; } rawPoint.axisXpos = rawPoint.plotX; rawPoint.axisYpos = rawPoint.plotY; rawPoint.axisZpos = rawPoint.plotZ; rawPoints.push({ x: rawPoint.plotX, y: rawPoint.plotY, z: rawPoint.plotZ }); rawPointsX.push(rawPoint.plotX || 0); }); series.rawPointsX = rawPointsX; const projectedPoints = perspective(rawPoints, chart, true); series.data.forEach((rawPoint, i) => { projectedPoint = projectedPoints[i]; rawPoint.plotX = projectedPoint.x; rawPoint.plotY = projectedPoint.y; rawPoint.plotZ = projectedPoint.z; }); } } /* * * * Static Properties * * */ Series3D.defaultOptions = merge(Series.defaultOptions); /* * * * Default Export * * */ return Series3D; }); _registerModule(_modules, 'Core/Renderer/SVG/SVGElement3D.js', [_modules['Core/Color/Color.js'], _modules['Core/Renderer/RendererRegistry.js'], _modules['Core/Utilities.js']], function (Color, RendererRegistry, U) { /* * * * (c) 2010-2024 Torstein Honsi * * Extensions to the SVGRenderer class to enable 3D shapes * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { parse: color } = Color; const { Element: SVGElement } = RendererRegistry.getRendererType().prototype; const { defined, pick } = U; /* * * * Class * * */ class SVGElement3D extends SVGElement { constructor() { /* * * * Static Properties * * */ super(...arguments); /* * * * Properties * * */ this.parts = ['front', 'top', 'side']; this.pathType = 'cuboid'; } /* * * * Functions * * */ /** * The init is used by base - renderer.Element * @private */ initArgs(args) { const elem3d = this, renderer = elem3d.renderer, paths = renderer[elem3d.pathType + 'Path'](args), zIndexes = paths.zIndexes; // Build parts for (const part of elem3d.parts) { const attribs = { 'class': 'highcharts-3d-' + part, zIndex: zIndexes[part] || 0 }; if (renderer.styledMode) { if (part === 'top') { attribs.filter = 'url(#highcharts-brighter)'; } else if (part === 'side') { attribs.filter = 'url(#highcharts-darker)'; } } elem3d[part] = renderer.path(paths[part]) .attr(attribs) .add(elem3d); } elem3d.attr({ 'stroke-linejoin': 'round', zIndex: zIndexes.group }); // Store information if any side of element was rendered by force. elem3d.forcedSides = paths.forcedSides; } /** * Single property setter that applies options to each part * @private */ singleSetterForParts(prop, val, values, verb, duration, complete) { const elem3d = this, newAttr = {}, optionsToApply = [null, null, (verb || 'attr'), duration, complete], hasZIndexes = values && values.zIndexes; if (!values) { newAttr[prop] = val; optionsToApply[0] = newAttr; } else { // It is needed to deal with the whole group zIndexing // in case of graph rotation if (hasZIndexes && hasZIndexes.group) { elem3d.attr({ zIndex: hasZIndexes.group }); } for (const part of Object.keys(values)) { newAttr[part] = {}; newAttr[part][prop] = values[part]; // Include zIndexes if provided if (hasZIndexes) { newAttr[part].zIndex = values.zIndexes[part] || 0; } } optionsToApply[1] = newAttr; } return this.processParts.apply(elem3d, optionsToApply); } /** * Calls function for each part. Used for attr, animate and destroy. * @private */ processParts(props, partsProps, verb, duration, complete) { const elem3d = this; for (const part of elem3d.parts) { // If different props for different parts if (partsProps) { props = pick(partsProps[part], false); } // Only if something to set, but allow undefined if (props !== false) { elem3d[part][verb](props, duration, complete); } } return elem3d; } /** * Destroy all parts * @private */ destroy() { this.processParts(null, null, 'destroy'); return super.destroy(); } // Following functions are SVGElement3DCuboid (= base) attr(args, val, complete, continueAnimation) { // Resolve setting attributes by string name if (typeof args === 'string' && typeof val !== 'undefined') { const key = args; args = {}; args[key] = val; } if (args.shapeArgs || defined(args.x)) { return this.singleSetterForParts('d', null, this.renderer[this.pathType + 'Path'](args.shapeArgs || args)); } return super.attr(args, void 0, complete, continueAnimation); } animate(args, duration, complete) { if (defined(args.x) && defined(args.y)) { const paths = this.renderer[this.pathType + 'Path'](args), forcedSides = paths.forcedSides; this.singleSetterForParts('d', null, paths, 'animate', duration, complete); this.attr({ zIndex: paths.zIndexes.group }); // If sides that are forced to render changed, recalculate colors. if (forcedSides !== this.forcedSides) { this.forcedSides = forcedSides; if (!this.renderer.styledMode) { this.fillSetter(this.fill); } } } else { super.animate(args, duration, complete); } return this; } fillSetter(fill) { const elem3d = this; elem3d.forcedSides = elem3d.forcedSides || []; elem3d.singleSetterForParts('fill', null, { front: fill, // Do not change color if side was forced to render. top: color(fill).brighten(elem3d.forcedSides.indexOf('top') >= 0 ? 0 : 0.1).get(), side: color(fill).brighten(elem3d.forcedSides.indexOf('side') >= 0 ? 0 : -0.1).get() }); // Fill for animation getter (#6776) elem3d.color = elem3d.fill = fill; return elem3d; } } SVGElement3D.types = { base: SVGElement3D, cuboid: SVGElement3D }; /* * * * Default Export * * */ return SVGElement3D; }); _registerModule(_modules, 'Core/Renderer/SVG/SVGRenderer3D.js', [_modules['Core/Animation/AnimationUtilities.js'], _modules['Core/Color/Color.js'], _modules['Core/Globals.js'], _modules['Core/Math3D.js'], _modules['Core/Renderer/SVG/SVGElement3D.js'], _modules['Core/Utilities.js']], function (A, Color, H, Math3D, SVGElement3D, U) { /* * * * (c) 2010-2024 Torstein Honsi * * Extensions to the SVGRenderer class to enable 3D shapes * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { animObject } = A; const { parse: color } = Color; const { charts, deg2rad } = H; const { perspective, shapeArea } = Math3D; const { defined, extend, merge, pick } = U; /* * * * Constants * * */ const cos = Math.cos, sin = Math.sin, PI = Math.PI, dFactor = (4 * (Math.sqrt(2) - 1) / 3) / (PI / 2); /* * * * Functions * * */ /** * Method to construct a curved path. Can 'wrap' around more then 180 * degrees. * @private */ function curveTo(cx, cy, rx, ry, start, end, dx, dy) { const arcAngle = end - start; let result = []; if ((end > start) && (end - start > Math.PI / 2 + 0.0001)) { result = result.concat(curveTo(cx, cy, rx, ry, start, start + (Math.PI / 2), dx, dy)); result = result.concat(curveTo(cx, cy, rx, ry, start + (Math.PI / 2), end, dx, dy)); return result; } if ((end < start) && (start - end > Math.PI / 2 + 0.0001)) { result = result.concat(curveTo(cx, cy, rx, ry, start, start - (Math.PI / 2), dx, dy)); result = result.concat(curveTo(cx, cy, rx, ry, start - (Math.PI / 2), end, dx, dy)); return result; } return [[ 'C', cx + (rx * Math.cos(start)) - ((rx * dFactor * arcAngle) * Math.sin(start)) + dx, cy + (ry * Math.sin(start)) + ((ry * dFactor * arcAngle) * Math.cos(start)) + dy, cx + (rx * Math.cos(end)) + ((rx * dFactor * arcAngle) * Math.sin(end)) + dx, cy + (ry * Math.sin(end)) - ((ry * dFactor * arcAngle) * Math.cos(end)) + dy, cx + (rx * Math.cos(end)) + dx, cy + (ry * Math.sin(end)) + dy ]]; } /* * * * Composition * * */ var SVGRenderer3D; (function (SVGRenderer3D) { /* * * * Declarations * * */ /* * * * Functions * * */ /** @private */ function compose(SVGRendererClass) { const rendererProto = SVGRendererClass.prototype; if (!rendererProto.element3d) { extend(rendererProto, { Element3D: SVGElement3D, arc3d, arc3dPath, cuboid, cuboidPath, element3d, face3d, polyhedron, toLinePath, toLineSegments }); } } SVGRenderer3D.compose = compose; /* * * * Functions * * */ /** @private */ function toLinePath(points, closed) { const result = []; // Put "L x y" for each point for (const point of points) { result.push(['L', point.x, point.y]); } if (points.length) { // Set the first element to M result[0][0] = 'M'; // If it is a closed line, add Z if (closed) { result.push(['Z']); } } return result; } /** @private */ function toLineSegments(points) { const result = []; let m = true; for (const point of points) { result.push(m ? ['M', point.x, point.y] : ['L', point.x, point.y]); m = !m; } return result; } /** * A 3-D Face is defined by it's 3D vertexes, and is only visible if it's * vertexes are counter-clockwise (Back-face culling). It is used as a * polyhedron Element. * @private */ function face3d(args) { const renderer = this, elementProto = renderer.Element.prototype, ret = renderer.createElement('path'); ret.vertexes = []; ret.insidePlotArea = false; ret.enabled = true; /* eslint-disable no-invalid-this */ ret.attr = function (hash) { if (typeof hash === 'object' && (defined(hash.enabled) || defined(hash.vertexes) || defined(hash.insidePlotArea))) { this.enabled = pick(hash.enabled, this.enabled); this.vertexes = pick(hash.vertexes, this.vertexes); this.insidePlotArea = pick(hash.insidePlotArea, this.insidePlotArea); delete hash.enabled; delete hash.vertexes; delete hash.insidePlotArea; const chart = charts[renderer.chartIndex], vertexes2d = perspective(this.vertexes, chart, this.insidePlotArea), path = renderer.toLinePath(vertexes2d, true), area = shapeArea(vertexes2d); hash.d = path; hash.visibility = (this.enabled && area > 0) ? 'inherit' : 'hidden'; } return elementProto.attr.apply(this, arguments); }; ret.animate = function (params) { if (typeof params === 'object' && (defined(params.enabled) || defined(params.vertexes) || defined(params.insidePlotArea))) { this.enabled = pick(params.enabled, this.enabled); this.vertexes = pick(params.vertexes, this.vertexes); this.insidePlotArea = pick(params.insidePlotArea, this.insidePlotArea); delete params.enabled; delete params.vertexes; delete params.insidePlotArea; const chart = charts[renderer.chartIndex], vertexes2d = perspective(this.vertexes, chart, this.insidePlotArea), path = renderer.toLinePath(vertexes2d, true), area = shapeArea(vertexes2d), visibility = (this.enabled && area > 0) ? 'visible' : 'hidden'; params.d = path; this.attr('visibility', visibility); } return elementProto.animate.apply(this, arguments); }; /* eslint-enable no-invalid-this */ return ret.attr(args); } /** * A Polyhedron is a handy way of defining a group of 3-D faces. It's only * attribute is `faces`, an array of attributes of each one of it's Face3D * instances. * @private */ function polyhedron(args) { const renderer = this, elementProto = renderer.Element.prototype, result = renderer.g(), destroy = result.destroy; if (!this.styledMode) { result.attr({ 'stroke-linejoin': 'round' }); } result.faces = []; // Destroy all children result.destroy = function () { for (let i = 0; i < result.faces.length; i++) { result.faces[i].destroy(); } return destroy.call(this); }; result.attr = function (hash, val, complete, continueAnimation) { if (typeof hash === 'object' && defined(hash.faces)) { while (result.faces.length > hash.faces.length) { result.faces.pop().destroy(); } while (result.faces.length < hash.faces.length) { result.faces.push(renderer.face3d().add(result)); } for (let i = 0; i < hash.faces.length; i++) { if (renderer.styledMode) { delete hash.faces[i].fill; } result.faces[i].attr(hash.faces[i], null, complete, continueAnimation); } delete hash.faces; } return elementProto.attr.apply(this, arguments); }; result.animate = function (params, duration, complete) { if (params && params.faces) { while (result.faces.length > params.faces.length) { result.faces.pop().destroy(); } while (result.faces.length < params.faces.length) { result.faces.push(renderer.face3d().add(result)); } for (let i = 0; i < params.faces.length; i++) { result.faces[i].animate(params.faces[i], duration, complete); } delete params.faces; } return elementProto.animate.apply(this, arguments); }; return result.attr(args); } /** * Return result, generalization * @private * @requires highcharts-3d */ function element3d(type, shapeArgs) { const elem3d = new SVGElement3D.types[type](this, 'g'); elem3d.initArgs(shapeArgs); return elem3d; } /** * Generalized, so now use simply * @private */ function cuboid(shapeArgs) { return this.element3d('cuboid', shapeArgs); } /** * Generates a cuboid path and zIndexes * @private */ function cuboidPath(shapeArgs) { const x = shapeArgs.x || 0, y = shapeArgs.y || 0, z = shapeArgs.z || 0, // For side calculation (right/left) // there is a need for height (and other shapeArgs arguments) // to be at least 1px h = shapeArgs.height || 0, w = shapeArgs.width || 0, d = shapeArgs.depth || 0, chart = charts[this.chartIndex], options3d = chart.options.chart.options3d, alpha = options3d.alpha, // Priority for x axis is the biggest, // because of x direction has biggest influence on zIndex incrementX = 1000000, // Y axis has the smallest priority in case of our charts // (needs to be set because of stacking) incrementY = 10, incrementZ = 100, forcedSides = []; let shape, zIndex = 0, // The 8 corners of the cube pArr = [{ x: x, y: y, z: z }, { x: x + w, y: y, z: z }, { x: x + w, y: y + h, z: z }, { x: x, y: y + h, z: z }, { x: x, y: y + h, z: z + d }, { x: x + w, y: y + h, z: z + d }, { x: x + w, y: y, z: z + d }, { x: x, y: y, z: z + d }]; // Apply perspective pArr = perspective(pArr, chart, shapeArgs.insidePlotArea); /** * Helper method to decide which side is visible * @private */ const mapSidePath = (i) => { // Added support for 0 value in columns, where height is 0 // but the shape is rendered. // Height is used from 1st to 6th element of pArr if (h === 0 && i > 1 && i < 6) { // [2, 3, 4, 5] return { x: pArr[i].x, // When height is 0 instead of cuboid we render plane // so it is needed to add fake 10 height to imitate // cuboid for side calculation y: pArr[i].y + 10, z: pArr[i].z }; } // It is needed to calculate dummy sides (front/back) for // breaking points in case of x and depth values. If column has // side, it means that x values of front and back side are // different. if (pArr[0].x === pArr[7].x && i >= 4) { // [4, 5, 6, 7] return { x: pArr[i].x + 10, // When height is 0 instead of cuboid we render plane // so it is needed to add fake 10 height to imitate // cuboid for side calculation y: pArr[i].y, z: pArr[i].z }; } // Added dummy depth if (d === 0 && i < 2 || i > 5) { // [0, 1, 6, 7] return { x: pArr[i].x, // When height is 0 instead of cuboid we render plane // so it is needed to add fake 10 height to imitate // cuboid for side calculation y: pArr[i].y, z: pArr[i].z + 10 }; } return pArr[i]; }, /** * Method creating the final side * @private */ mapPath = (i) => (pArr[i]), /** * First value - path with specific face * Second value - added info about side for later calculations. * Possible second values are 0 for path1, 1 for * path2 and -1 for no path chosen. * Third value - string containing information about current side of * cuboid for forcing side rendering. * @private */ pickShape = (verticesIndex1, verticesIndex2, side) => { const // An array of vertices for cuboid face face1 = verticesIndex1.map(mapPath), face2 = verticesIndex2.map(mapPath), // Dummy face is calculated the same way as standard face, // but if cuboid height is 0 additional height is added so // it is possible to use this vertices array for visible // face calculation dummyFace1 = verticesIndex1.map(mapSidePath), dummyFace2 = verticesIndex2.map(mapSidePath); let ret = [[], -1]; if (shapeArea(face1) < 0) { ret = [face1, 0]; } else if (shapeArea(face2) < 0) { ret = [face2, 1]; } else if (side) { forcedSides.push(side); if (shapeArea(dummyFace1) < 0) { ret = [face1, 0]; } else if (shapeArea(dummyFace2) < 0) { ret = [face2, 1]; } else { ret = [face1, 0]; // Force side calculation. } } return ret; }; // Front or back const front = [3, 2, 1, 0], back = [7, 6, 5, 4]; shape = pickShape(front, back, 'front'); const path1 = shape[0], isFront = shape[1]; // Top or bottom const top = [1, 6, 7, 0], bottom = [4, 5, 2, 3]; shape = pickShape(top, bottom, 'top'); const path2 = shape[0], isTop = shape[1]; // Side const right = [1, 2, 5, 6], left = [0, 7, 4, 3]; shape = pickShape(right, left, 'side'); const path3 = shape[0], isRight = shape[1]; /* New block used for calculating zIndex. It is basing on X, Y and Z position of specific columns. All zIndexes (for X, Y and Z values) are added to the final zIndex, where every value has different priority. The biggest priority is in X and Z directions, the lowest index is for stacked columns (Y direction and the same X and Z positions). Big differences between priorities is made because we need to ensure that even for big changes in Y and Z parameters all columns will be drawn correctly. */ if (isRight === 1) { // It is needed to connect value with current chart width // for big chart size. zIndex += incrementX * (chart.plotWidth - x); } else if (!isRight) { zIndex += incrementX * x; } zIndex += incrementY * (!isTop || // Numbers checked empirically (alpha >= 0 && alpha <= 180 || alpha < 360 && alpha > 357.5) ? chart.plotHeight - y : 10 + y); if (isFront === 1) { zIndex += incrementZ * (z); } else if (!isFront) { zIndex += incrementZ * (1000 - z); } return { front: this.toLinePath(path1, true), top: this.toLinePath(path2, true), side: this.toLinePath(path3, true), zIndexes: { group: Math.round(zIndex) }, forcedSides: forcedSides, // Additional info about zIndexes isFront: isFront, isTop: isTop }; // #4774 } /** @private */ function arc3d(attribs) { const renderer = this, wrapper = renderer.g(), elementProto = renderer.Element.prototype, customAttribs = ['x', 'y', 'r', 'innerR', 'start', 'end', 'depth']; /** * Get custom attributes. Don't mutate the original object and return an * object with only custom attr. * @private */ function suckOutCustom(params) { const ca = {}; let hasCA = false, key; params = merge(params); // Don't mutate the original object for (key in params) { if (customAttribs.indexOf(key) !== -1) { ca[key] = params[key]; delete params[key]; hasCA = true; } } return hasCA ? [ca, params] : false; } attribs = merge(attribs); attribs.alpha = (attribs.alpha || 0) * deg2rad; attribs.beta = (attribs.beta || 0) * deg2rad; // Create the different sub sections of the shape wrapper.top = renderer.path(); wrapper.side1 = renderer.path(); wrapper.side2 = renderer.path(); wrapper.inn = renderer.path(); wrapper.out = renderer.path(); /* eslint-disable no-invalid-this */ // Add all faces wrapper.onAdd = function () { const parent = wrapper.parentGroup, className = wrapper.attr('class'); wrapper.top.add(wrapper); // These faces are added outside the wrapper group because the // z-index relates to neighbour elements as well for (const face of ['out', 'inn', 'side1', 'side2']) { wrapper[face] .attr({ 'class': className + ' highcharts-3d-side' }) .add(parent); } }; // Cascade to faces for (const fn of ['addClass', 'removeClass']) { wrapper[fn] = function () { const args = arguments; for (const face of ['top', 'out', 'inn', 'side1', 'side2']) { wrapper[face][fn].apply(wrapper[face], args); } }; } /** * Compute the transformed paths and set them to the composite shapes * @private */ wrapper.setPaths = function (attribs) { const paths = wrapper.renderer.arc3dPath(attribs), zIndex = paths.zTop * 100; wrapper.attribs = attribs; wrapper.top.attr({ d: paths.top, zIndex: paths.zTop }); wrapper.inn.attr({ d: paths.inn, zIndex: paths.zInn }); wrapper.out.attr({ d: paths.out, zIndex: paths.zOut }); wrapper.side1.attr({ d: paths.side1, zIndex: paths.zSide1 }); wrapper.side2.attr({ d: paths.side2, zIndex: paths.zSide2 }); // Show all children wrapper.zIndex = zIndex; wrapper.attr({ zIndex: zIndex }); // Set the radial gradient center the first time if (attribs.center) { wrapper.top.setRadialReference(attribs.center); delete attribs.center; } }; wrapper.setPaths(attribs); /** * Apply the fill to the top and a darker shade to the sides * @private */ wrapper.fillSetter = function (value) { const darker = color(value).brighten(-0.1).get(); this.fill = value; this.side1.attr({ fill: darker }); this.side2.attr({ fill: darker }); this.inn.attr({ fill: darker }); this.out.attr({ fill: darker }); this.top.attr({ fill: value }); return this; }; // Apply the same value to all. These properties cascade down to the // children when set to the composite arc3d. for (const setter of ['opacity', 'translateX', 'translateY', 'visibility']) { wrapper[setter + 'Setter'] = function (value, key) { wrapper[key] = value; for (const el of ['out', 'inn', 'side1', 'side2', 'top']) { wrapper[el].attr(key, value); } }; } // Override attr to remove shape attributes and use those to set child // paths wrapper.attr = function (params) { let ca, paramArr; if (typeof params === 'object') { paramArr = suckOutCustom(params); if (paramArr) { ca = paramArr[0]; arguments[0] = paramArr[1]; extend(wrapper.attribs, ca); wrapper.setPaths(wrapper.attribs); } } return elementProto.attr.apply(wrapper, arguments); }; // Override the animate function by sucking out custom parameters // related to the shapes directly, and update the shapes from the // animation step. wrapper.animate = function (params, animation, complete) { const from = this.attribs, randomProp = ('data-' + Math.random().toString(26).substring(2, 9)); let paramArr, to; // Attribute-line properties connected to 3D. These shouldn't have // been in the attribs collection in the first place. delete params.center; delete params.z; delete params.alpha; delete params.beta; const anim = animObject(pick(animation, this.renderer.globalAnimation)); if (anim.duration) { paramArr = suckOutCustom(params); // Params need to have a property in order for the step to run // (#5765, #7097, #7437) wrapper[randomProp] = 0; params[randomProp] = 1; wrapper[randomProp + 'Setter'] = H.noop; if (paramArr) { to = paramArr[0]; // Custom attr anim.step = function (a, fx) { const interpolate = (key) => (from[key] + (pick(to[key], from[key]) - from[key]) * fx.pos); if (fx.prop === randomProp) { fx.elem.setPaths(merge(from, { x: interpolate('x'), y: interpolate('y'), r: interpolate('r'), innerR: interpolate('innerR'), start: interpolate('start'), end: interpolate('end'), depth: interpolate('depth') })); } }; } animation = anim; // Only when duration (#5572) } return elementProto.animate.call(this, params, animation, complete); }; // Destroy all children wrapper.destroy = function () { this.top.destroy(); this.out.destroy(); this.inn.destroy(); this.side1.destroy(); this.side2.destroy(); return elementProto.destroy.call(this); }; // Hide all children wrapper.hide = function () { this.top.hide(); this.out.hide(); this.inn.hide(); this.side1.hide(); this.side2.hide(); }; wrapper.show = function (inherit) { this.top.show(inherit); this.out.show(inherit); this.inn.show(inherit); this.side1.show(inherit); this.side2.show(inherit); }; /* eslint-enable no-invalid-this */ return wrapper; } /** * Generate the paths required to draw a 3D arc. * @private */ function arc3dPath(shapeArgs) { const cx = shapeArgs.x || 0, // X coordinate of the center cy = shapeArgs.y || 0, // Y coordinate of the center start = shapeArgs.start || 0, // Start angle end = (shapeArgs.end || 0) - 0.00001, // End angle r = shapeArgs.r || 0, // Radius ir = shapeArgs.innerR || 0, // Inner radius d = shapeArgs.depth || 0, // Depth alpha = shapeArgs.alpha || 0, // Alpha rotation of the chart beta = shapeArgs.beta || 0; // Beta rotation of the chart // Derived Variables const cs = Math.cos(start), // Cosinus of the start angle ss = Math.sin(start), // Sinus of the start angle ce = Math.cos(end), // Cosinus of the end angle se = Math.sin(end), // Sinus of the end angle rx = r * Math.cos(beta), // X-radius ry = r * Math.cos(alpha), // Y-radius irx = ir * Math.cos(beta), // X-radius (inner) iry = ir * Math.cos(alpha), // Y-radius (inner) dx = d * Math.sin(beta), // Distance between top and bottom in x dy = d * Math.sin(alpha); // Distance between top and bottom in y // TOP let top = [ ['M', cx + (rx * cs), cy + (ry * ss)] ]; top = top.concat(curveTo(cx, cy, rx, ry, start, end, 0, 0)); top.push([ 'L', cx + (irx * ce), cy + (iry * se) ]); top = top.concat(curveTo(cx, cy, irx, iry, end, start, 0, 0)); top.push(['Z']); // OUTSIDE const b = (beta > 0 ? Math.PI / 2 : 0), a = (alpha > 0 ? 0 : Math.PI / 2); const start2 = start > -b ? start : (end > -b ? -b : start), end2 = end < PI - a ? end : (start < PI - a ? PI - a : end), midEnd = 2 * PI - a; // When slice goes over bottom middle, need to add both, left and right // outer side. Additionally, when we cross right hand edge, create sharp // edge. Outer shape/wall: // // ------- // / ^ \ // 4) / / \ \ 1) // / / \ \ // / / \ \ // (c)=> ==== ==== <=(d) // \ \ / / // \ \<=(a)/ / // \ \ / / <=(b) // 3) \ v / 2) // ------- // // (a) - inner side // (b) - outer side // (c) - left edge (sharp) // (d) - right edge (sharp) // 1..n - rendering order for startAngle = 0, when set to e.g 90, order // changes clockwise (1->2, 2->3, n->1) and counterclockwise for // negative startAngle let out = [ ['M', cx + (rx * cos(start2)), cy + (ry * sin(start2))] ]; out = out.concat(curveTo(cx, cy, rx, ry, start2, end2, 0, 0)); // When shape is wide, it can cross both, (c) and (d) edges, when using // startAngle if (end > midEnd && start < midEnd) { // Go to outer side out.push([ 'L', cx + (rx * cos(end2)) + dx, cy + (ry * sin(end2)) + dy ]); // Curve to the right edge of the slice (d) out = out.concat(curveTo(cx, cy, rx, ry, end2, midEnd, dx, dy)); // Go to the inner side out.push([ 'L', cx + (rx * cos(midEnd)), cy + (ry * sin(midEnd)) ]); // Curve to the true end of the slice out = out.concat(curveTo(cx, cy, rx, ry, midEnd, end, 0, 0)); // Go to the outer side out.push([ 'L', cx + (rx * cos(end)) + dx, cy + (ry * sin(end)) + dy ]); // Go back to middle (d) out = out.concat(curveTo(cx, cy, rx, ry, end, midEnd, dx, dy)); out.push([ 'L', cx + (rx * cos(midEnd)), cy + (ry * sin(midEnd)) ]); // Go back to the left edge out = out.concat(curveTo(cx, cy, rx, ry, midEnd, end2, 0, 0)); // But shape can cross also only (c) edge: } else if (end > PI - a && start < PI - a) { // Go to outer side out.push([ 'L', cx + (rx * Math.cos(end2)) + dx, cy + (ry * Math.sin(end2)) + dy ]); // Curve to the true end of the slice out = out.concat(curveTo(cx, cy, rx, ry, end2, end, dx, dy)); // Go to the inner side out.push([ 'L', cx + (rx * Math.cos(end)), cy + (ry * Math.sin(end)) ]); // Go back to the artificial end2 out = out.concat(curveTo(cx, cy, rx, ry, end, end2, 0, 0)); } out.push([ 'L', cx + (rx * Math.cos(end2)) + dx, cy + (ry * Math.sin(end2)) + dy ]); out = out.concat(curveTo(cx, cy, rx, ry, end2, start2, dx, dy)); out.push(['Z']); // INSIDE let inn = [ ['M', cx + (irx * cs), cy + (iry * ss)] ]; inn = inn.concat(curveTo(cx, cy, irx, iry, start, end, 0, 0)); inn.push([ 'L', cx + (irx * Math.cos(end)) + dx, cy + (iry * Math.sin(end)) + dy ]); inn = inn.concat(curveTo(cx, cy, irx, iry, end, start, dx, dy)); inn.push(['Z']); // SIDES const side1 = [ ['M', cx + (rx * cs), cy + (ry * ss)], ['L', cx + (rx * cs) + dx, cy + (ry * ss) + dy], ['L', cx + (irx * cs) + dx, cy + (iry * ss) + dy], ['L', cx + (irx * cs), cy + (iry * ss)], ['Z'] ]; const side2 = [ ['M', cx + (rx * ce), cy + (ry * se)], ['L', cx + (rx * ce) + dx, cy + (ry * se) + dy], ['L', cx + (irx * ce) + dx, cy + (iry * se) + dy], ['L', cx + (irx * ce), cy + (iry * se)], ['Z'] ]; // Correction for changed position of vanishing point caused by alpha // and beta rotations const angleCorr = Math.atan2(dy, -dx); let angleEnd = Math.abs(end + angleCorr), angleStart = Math.abs(start + angleCorr), angleMid = Math.abs((start + end) / 2 + angleCorr); /** * Set to 0-PI range * @private */ function toZeroPIRange(angle) { angle = angle % (2 * Math.PI); if (angle > Math.PI) { angle = 2 * Math.PI - angle; } return angle; } angleEnd = toZeroPIRange(angleEnd); angleStart = toZeroPIRange(angleStart); angleMid = toZeroPIRange(angleMid); // *1e5 is to compensate pInt in zIndexSetter const incPrecision = 1e5, a1 = angleMid * incPrecision, a2 = angleStart * incPrecision, a3 = angleEnd * incPrecision; return { top: top, // Max angle is PI, so this is always higher zTop: Math.PI * incPrecision + 1, out: out, zOut: Math.max(a1, a2, a3), inn: inn, zInn: Math.max(a1, a2, a3), side1: side1, // To keep below zOut and zInn in case of same values zSide1: a3 * 0.99, side2: side2, zSide2: a2 * 0.99 }; } })(SVGRenderer3D || (SVGRenderer3D = {})); /* * * * Default Export * * */ return SVGRenderer3D; }); _registerModule(_modules, 'Core/Axis/ZAxis.js', [_modules['Core/Axis/Axis.js'], _modules['Core/Defaults.js'], _modules['Core/Utilities.js']], function (Axis, D, U) { /* * * * (c) 2010-2024 Torstein Honsi * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { defaultOptions } = D; const { addEvent, merge, pick, splat } = U; /* * * * Functions * * */ /** * @private */ function chartAddZAxis(options) { return new ZAxis(this, options); } /** * Get the Z axis in addition to the default X and Y. * @private */ function onChartAfterGetAxes() { const zAxisOptions = this.options.zAxis = splat(this.options.zAxis || {}); if (!this.is3d()) { return; } this.zAxis = []; zAxisOptions.forEach((axisOptions) => { this.addZAxis(axisOptions).setScale(); }); } /* * * * Class * * */ /** * 3D axis for z coordinates. * @private */ class ZAxis extends Axis { constructor() { /* * * * Static Properties * * */ super(...arguments); this.isZAxis = true; } static compose(ChartClass) { const chartProto = ChartClass.prototype; if (!chartProto.addZAxis) { defaultOptions.zAxis = merge(defaultOptions.xAxis, { offset: 0, lineWidth: 0 }); chartProto.addZAxis = chartAddZAxis; chartProto.collectionsWithInit.zAxis = [chartProto.addZAxis]; chartProto.collectionsWithUpdate.push('zAxis'); addEvent(ChartClass, 'afterGetAxes', onChartAfterGetAxes); } } /* * * * Constructor * * */ init(chart, userOptions) { // #14793, this used to be set on the prototype this.isZAxis = true; super.init(chart, userOptions, 'zAxis'); } /* * * * Functions * * */ getSeriesExtremes() { this.hasVisibleSeries = false; // Reset properties in case we're redrawing (#3353) this.dataMin = this.dataMax = this.ignoreMinPadding = (this.ignoreMaxPadding = void 0); if (this.stacking) { this.stacking.buildStacks(); } // Loop through this axis' series this.series.forEach((series) => { if (series.reserveSpace()) { let threshold = series.options.threshold; this.hasVisibleSeries = true; // Validate threshold in logarithmic axes if (this.positiveValuesOnly && threshold <= 0) { threshold = void 0; } const zData = series.zData; if (zData.length) { this.dataMin = Math.min(pick(this.dataMin, zData[0]), Math.min.apply(null, zData)); this.dataMax = Math.max(pick(this.dataMax, zData[0]), Math.max.apply(null, zData)); } } }); } /** * @private */ setAxisSize() { const chart = this.chart; super.setAxisSize(); this.width = this.len = (chart.options.chart.options3d && chart.options.chart.options3d.depth) || 0; this.right = chart.chartWidth - this.width - this.left; } } /* * * * Default Export * * */ return ZAxis; }); _registerModule(_modules, 'Series/Column3D/Column3DComposition.js', [_modules['Core/Globals.js'], _modules['Core/Math3D.js'], _modules['Core/Utilities.js']], function (H, Math3D, U) { /* * * * (c) 2010-2024 Torstein Honsi * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { composed } = H; const { perspective } = Math3D; const { addEvent, extend, pick, pushUnique, wrap } = U; /* * * * Functions * * */ /** @private */ function columnSeriesTranslate3dShapes() { const series = this, chart = series.chart, seriesOptions = series.options, depth = seriesOptions.depth, stack = seriesOptions.stacking ? (seriesOptions.stack || 0) : series.index; // #4743 let z = stack * (depth + (seriesOptions.groupZPadding || 1)), borderCrisp = series.borderWidth % 2 ? 0.5 : 0, point2dPos; // Position of point in 2D, used for 3D position calculation if (chart.inverted && !series.yAxis.reversed) { borderCrisp *= -1; } if (seriesOptions.grouping !== false) { z = 0; } z += (seriesOptions.groupZPadding || 1); for (const point of series.points) { // #7103 Reset outside3dPlot flag point.outside3dPlot = null; if (point.y !== null) { const shapeArgs = extend({ x: 0, y: 0, width: 0, height: 0 }, point.shapeArgs || {}), // Array for final shapeArgs calculation. // We are checking two dimensions (x and y). dimensions = [['x', 'width'], ['y', 'height']], tooltipPos = point.tooltipPos; let borderlessBase; // Crisped rects can have +/- 0.5 pixels offset. // #3131 We need to check if column is inside plotArea. for (const d of dimensions) { borderlessBase = shapeArgs[d[0]] - borderCrisp; if (borderlessBase < 0) { // If borderLessBase is smaller than 0, it is needed to set // its value to 0 or 0.5 depending on borderWidth // borderWidth may be even or odd. shapeArgs[d[1]] += shapeArgs[d[0]] + borderCrisp; shapeArgs[d[0]] = -borderCrisp; borderlessBase = 0; } if ((borderlessBase + shapeArgs[d[1]] > series[d[0] + 'Axis'].len) && // Do not change height/width of column if 0 (#6708) shapeArgs[d[1]] !== 0) { shapeArgs[d[1]] = series[d[0] + 'Axis'].len - shapeArgs[d[0]]; } if ( // Do not remove columns with zero height/width. shapeArgs[d[1]] !== 0 && (shapeArgs[d[0]] >= series[d[0] + 'Axis'].len || shapeArgs[d[0]] + shapeArgs[d[1]] <= borderCrisp)) { // Set args to 0 if column is outside the chart. for (const key in shapeArgs) { // eslint-disable-line guard-for-in // #13840 shapeArgs[key] = key === 'y' ? -9999 : 0; } // #7103 outside3dPlot flag is set on Points which are // currently outside of plot. point.outside3dPlot = true; } } // Change from 2d to 3d if (point.shapeType === 'roundedRect') { point.shapeType = 'cuboid'; } point.shapeArgs = extend(shapeArgs, { z, depth, insidePlotArea: true }); // Point's position in 2D point2dPos = { x: shapeArgs.x + shapeArgs.width / 2, y: shapeArgs.y, z: z + depth / 2 // The center of column in Z dimension }; // Recalculate point positions for inverted graphs if (chart.inverted) { point2dPos.x = shapeArgs.height; point2dPos.y = point.clientX || 0; } // Crosshair positions point.axisXpos = point2dPos.x; point.axisYpos = point2dPos.y; point.axisZpos = point2dPos.z; // Calculate and store point's position in 3D, // using perspective method. point.plot3d = perspective([point2dPos], chart, true, false)[0]; // Translate the tooltip position in 3d space if (tooltipPos) { const translatedTTPos = perspective([{ x: tooltipPos[0], y: tooltipPos[1], z: z + depth / 2 // The center of column in Z dimension }], chart, true, false)[0]; point.tooltipPos = [translatedTTPos.x, translatedTTPos.y]; } } } // Store for later use #4067 series.z = z; } /** @private */ function compose(SeriesClass, StackItemClass) { if (pushUnique(composed, 'Column3D')) { const seriesProto = SeriesClass.prototype, stackItemProto = StackItemClass.prototype, { column: ColumnSeriesClass, columnRange: ColumnRangeSeriesClass } = SeriesClass.types; wrap(seriesProto, 'alignDataLabel', wrapSeriesAlignDataLabel); wrap(seriesProto, 'justifyDataLabel', wrapSeriesJustifyDataLabel); wrap(stackItemProto, 'getStackBox', wrapStackItemGetStackBox); if (ColumnSeriesClass) { const columnSeriesProto = ColumnSeriesClass.prototype, columnPointProto = columnSeriesProto.pointClass.prototype; columnSeriesProto.translate3dPoints = () => void 0; columnSeriesProto.translate3dShapes = columnSeriesTranslate3dShapes; addEvent(columnSeriesProto, 'afterInit', onColumnSeriesAfterInit); wrap(columnPointProto, 'hasNewShapeType', wrapColumnPointHasNewShapeType); wrap(columnSeriesProto, 'animate', wrapColumnSeriesAnimate); wrap(columnSeriesProto, 'plotGroup', wrapColumnSeriesPlotGroup); wrap(columnSeriesProto, 'pointAttribs', wrapColumnSeriesPointAttribs); wrap(columnSeriesProto, 'setState', wrapColumnSeriesSetState); wrap(columnSeriesProto, 'setVisible', wrapColumnSeriesSetVisible); wrap(columnSeriesProto, 'translate', wrapColumnSeriesTranslate); } if (ColumnRangeSeriesClass) { const columnRangeSeriesProto = ColumnRangeSeriesClass.prototype, columnRangePointProto = columnRangeSeriesProto.pointClass.prototype; wrap(columnRangePointProto, 'hasNewShapeType', wrapColumnPointHasNewShapeType); wrap(columnRangeSeriesProto, 'plotGroup', wrapColumnSeriesPlotGroup); wrap(columnRangeSeriesProto, 'pointAttribs', wrapColumnSeriesPointAttribs); wrap(columnRangeSeriesProto, 'setState', wrapColumnSeriesSetState); wrap(columnRangeSeriesProto, 'setVisible', wrapColumnSeriesSetVisible); } } } /** * @private * @param {Highcharts.Chart} chart * Chart with stacks * @param {string} stacking * Stacking option */ function retrieveStacks(chart, stacking) { const series = chart.series, stacks = { totalStacks: 0 }; let stackNumber, i = 1; series.forEach(function (s) { stackNumber = pick(s.options.stack, (stacking ? 0 : series.length - 1 - s.index)); // #3841, #4532 if (!stacks[stackNumber]) { stacks[stackNumber] = { series: [s], position: i }; i++; } else { stacks[stackNumber].series.push(s); } }); stacks.totalStacks = i + 1; return stacks; } /** @private */ function onColumnSeriesAfterInit() { if (this.chart.is3d()) { const series = this, seriesOptions = series.options, grouping = seriesOptions.grouping, stacking = seriesOptions.stacking, reversedStacks = series.yAxis.options.reversedStacks; let z = 0; // @todo grouping === true ? if (!(typeof grouping !== 'undefined' && !grouping)) { const stacks = retrieveStacks(this.chart, stacking), stack = seriesOptions.stack || 0; let i; // Position within the stack for (i = 0; i < stacks[stack].series.length; i++) { if (stacks[stack].series[i] === this) { break; } } z = (10 * (stacks.totalStacks - stacks[stack].position)) + (reversedStacks ? i : -i); // #4369 // In case when axis is reversed, columns are also reversed inside // the group (#3737) if (!this.xAxis.reversed) { z = (stacks.totalStacks * 10) - z; } } seriesOptions.depth = seriesOptions.depth || 25; series.z = series.z || 0; seriesOptions.zIndex = z; } } /** * In 3D mode, simple checking for a new shape to animate is not enough. * Additionally check if graphic is a group of elements * @private */ function wrapColumnPointHasNewShapeType(proceed, ...args) { return this.series.chart.is3d() ? this.graphic && this.graphic.element.nodeName !== 'g' : proceed.apply(this, args); } /** @private */ function wrapColumnSeriesAnimate(proceed) { if (!this.chart.is3d()) { proceed.apply(this, [].slice.call(arguments, 1)); } else { const args = arguments, init = args[1], yAxis = this.yAxis, series = this, reversed = this.yAxis.reversed; if (init) { for (const point of series.points) { if (point.y !== null) { point.height = point.shapeArgs.height; point.shapey = point.shapeArgs.y; // #2968 point.shapeArgs.height = 1; if (!reversed) { if (point.stackY) { point.shapeArgs.y = point.plotY + yAxis.translate(point.stackY); } else { point.shapeArgs.y = point.plotY + (point.negative ? -point.height : point.height); } } } } } else { // Run the animation for (const point of series.points) { if (point.y !== null) { point.shapeArgs.height = point.height; point.shapeArgs.y = point.shapey; // #2968 // null value do not have a graphic if (point.graphic) { point.graphic[point.outside3dPlot ? 'attr' : 'animate'](point.shapeArgs, series.options.animation); } } } // Redraw datalabels to the correct position this.drawDataLabels(); } } } /** * In case of 3d columns there is no sense to add these columns to a specific * series group. If a series is added to a group all columns will have the same * zIndex in comparison to another series. * @private */ function wrapColumnSeriesPlotGroup(proceed, prop, _name, _visibility, _zIndex, parent) { if (prop !== 'dataLabelsGroup' && prop !== 'markerGroup') { if (this.chart.is3d()) { if (this[prop]) { delete this[prop]; } if (parent) { if (!this.chart.columnGroup) { this.chart.columnGroup = this.chart.renderer.g('columnGroup').add(parent); } this[prop] = this.chart.columnGroup; this.chart.columnGroup.attr(this.getPlotBox()); this[prop].survive = true; if (prop === 'group') { arguments[3] = 'visible'; // For 3D column group and markerGroup should be visible } } } } return proceed.apply(this, Array.prototype.slice.call(arguments, 1)); } /** @private */ function wrapColumnSeriesPointAttribs(proceed) { const attr = proceed.apply(this, [].slice.call(arguments, 1)); if (this.chart.is3d && this.chart.is3d()) { // Set the fill color to the fill color to provide a smooth edge attr.stroke = this.options.edgeColor || attr.fill; attr['stroke-width'] = pick(this.options.edgeWidth, 1); // #4055 } return attr; } /** * In 3D mode, all column-series are rendered in one main group. Because of that * we need to apply inactive state on all points. * @private */ function wrapColumnSeriesSetState(proceed, state, inherit) { const is3d = this.chart.is3d && this.chart.is3d(); if (is3d) { this.options.inactiveOtherPoints = true; } proceed.call(this, state, inherit); if (is3d) { this.options.inactiveOtherPoints = false; } } /** * When series is not added to group it is needed to change setVisible method to * allow correct Legend funcionality. This wrap is basing on pie chart series. * @private */ function wrapColumnSeriesSetVisible(proceed, vis) { const series = this; if (series.chart.is3d()) { for (const point of series.points) { point.visible = point.options.visible = vis = typeof vis === 'undefined' ? !pick(series.visible, point.visible) : vis; series.options.data[series.data.indexOf(point)] = point.options; if (point.graphic) { point.graphic.attr({ visibility: vis ? 'visible' : 'hidden' }); } } } proceed.apply(this, Array.prototype.slice.call(arguments, 1)); } /** @private */ function wrapColumnSeriesTranslate(proceed) { proceed.apply(this, [].slice.call(arguments, 1)); // Do not do this if the chart is not 3D if (this.chart.is3d()) { this.translate3dShapes(); } } /** @private */ function wrapSeriesAlignDataLabel(proceed, point, _dataLabel, options, alignTo) { const chart = this.chart; // In 3D we need to pass point.outsidePlot option to the justifyDataLabel // method for disabling justifying dataLabels in columns outside plot options.outside3dPlot = point.outside3dPlot; // Only do this for 3D columns and it's derived series if (chart.is3d() && this.is('column')) { const series = this, seriesOptions = series.options, inside = pick(options.inside, !!series.options.stacking), options3d = chart.options.chart.options3d, xOffset = point.pointWidth / 2 || 0; let dLPosition = { x: alignTo.x + xOffset, y: alignTo.y, z: series.z + seriesOptions.depth / 2 }; if (chart.inverted) { // Inside dataLabels are positioned according to above // logic and there is no need to position them using // non-3D algorighm (that use alignTo.width) if (inside) { alignTo.width = 0; dLPosition.x += point.shapeArgs.height / 2; } // When chart is upside down // (alpha angle between 180 and 360 degrees) // it is needed to add column width to calculated value. if (options3d.alpha >= 90 && options3d.alpha <= 270) { dLPosition.y += point.shapeArgs.width; } } // `dLPosition` is recalculated for 3D graphs dLPosition = perspective([dLPosition], chart, true, false)[0]; alignTo.x = dLPosition.x - xOffset; // #7103 If point is outside of plotArea, hide data label. alignTo.y = point.outside3dPlot ? -9e9 : dLPosition.y; } proceed.apply(this, [].slice.call(arguments, 1)); } /** * Don't use justifyDataLabel when point is outsidePlot. * @private */ function wrapSeriesJustifyDataLabel(proceed) { return (!(arguments[2].outside3dPlot) ? proceed.apply(this, [].slice.call(arguments, 1)) : false); } /** * Added stackLabels position calculation for 3D charts. * @private */ function wrapStackItemGetStackBox(proceed, stackBoxProps) { const stackBox = proceed.apply(this, [].slice.call(arguments, 1)); // Only do this for 3D graph const stackItem = this, chart = this.axis.chart, { width: xWidth } = stackBoxProps; if (chart.is3d() && stackItem.base) { // First element of stackItem.base is an index of base series. const baseSeriesInd = +(stackItem.base).split(',')[0]; const columnSeries = chart.series[baseSeriesInd]; const options3d = chart.options.chart.options3d; // Only do this if base series is a column or inherited type, // use its barW, z and depth parameters // for correct stackLabels position calculation if (columnSeries && columnSeries.type === 'column') { let dLPosition = { x: stackBox.x + (chart.inverted ? stackBox.height : xWidth / 2), y: stackBox.y, z: columnSeries.options.depth / 2 }; if (chart.inverted) { // Do not use default offset calculation logic // for 3D inverted stackLabels. stackBox.width = 0; // When chart is upside down // (alpha angle between 180 and 360 degrees) // it is needed to add column width to calculated value. if (options3d.alpha >= 90 && options3d.alpha <= 270) { dLPosition.y += xWidth; } } dLPosition = perspective([dLPosition], chart, true, false)[0]; stackBox.x = dLPosition.x - xWidth / 2; stackBox.y = dLPosition.y; } } return stackBox; } /* * * * Default Export * * */ const Column3DComposition = { compose }; /* * * * API Options * * */ /** * Depth of the columns in a 3D column chart. * * @type {number} * @default 25 * @since 4.0 * @product highcharts * @requires highcharts-3d * @apioption plotOptions.column.depth */ /** * 3D columns only. The color of the edges. Similar to `borderColor`, except it * defaults to the same color as the column. * * @type {Highcharts.ColorString} * @product highcharts * @requires highcharts-3d * @apioption plotOptions.column.edgeColor */ /** * 3D columns only. The width of the colored edges. * * @type {number} * @default 1 * @product highcharts * @requires highcharts-3d * @apioption plotOptions.column.edgeWidth */ /** * The spacing between columns on the Z Axis in a 3D chart. * * @type {number} * @default 1 * @since 4.0 * @product highcharts * @requires highcharts-3d * @apioption plotOptions.column.groupZPadding */ ''; // Keeps doclets above in transpiled file return Column3DComposition; }); _registerModule(_modules, 'Series/Pie3D/Pie3DPoint.js', [_modules['Core/Series/SeriesRegistry.js']], function (SeriesRegistry) { /* * * * (c) 2010-2024 Torstein Honsi * * 3D pie series * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { pie: { prototype: { pointClass: PiePoint } } } = SeriesRegistry.seriesTypes; /* * * * Class * * */ class Pie3DPoint extends PiePoint { /* * * * Functions * * */ /** * @private */ haloPath() { return this.series?.chart.is3d() ? [] : super.haloPath.apply(this, arguments); } } /* * * * Default Export * * */ return Pie3DPoint; }); _registerModule(_modules, 'Series/Pie3D/Pie3DSeries.js', [_modules['Core/Globals.js'], _modules['Series/Pie3D/Pie3DPoint.js'], _modules['Core/Series/SeriesRegistry.js'], _modules['Core/Utilities.js']], function (H, Pie3DPoint, SeriesRegistry, U) { /* * * * (c) 2010-2024 Torstein Honsi * * 3D pie series * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { composed, deg2rad } = H; const { pie: PieSeries } = SeriesRegistry.seriesTypes; const { extend, pick, pushUnique } = U; /* * * * Class * * */ class Pie3DSeries extends PieSeries { /* * * * Static Functions * * */ static compose(SeriesClass) { if (pushUnique(composed, 'Pie3D')) { SeriesClass.types.pie = Pie3DSeries; } } /* * * * Functions * * */ /** * @private */ addPoint() { super.addPoint.apply(this, arguments); if (this.chart.is3d()) { // Destroy (and rebuild) everything!!! this.update(this.userOptions, true); // #3845 pass the old options } } /** * @private */ animate(init) { if (!this.chart.is3d()) { super.animate.apply(this, arguments); } else { const center = this.center, group = this.group, markerGroup = this.markerGroup; let animation = this.options.animation, attribs; if (animation === true) { animation = {}; } // Initialize the animation if (init) { // Scale down the group and place it in the center group.oldtranslateX = pick(group.oldtranslateX, group.translateX); group.oldtranslateY = pick(group.oldtranslateY, group.translateY); attribs = { translateX: center[0], translateY: center[1], scaleX: 0.001, scaleY: 0.001 }; group.attr(attribs); if (markerGroup) { markerGroup.attrSetters = group.attrSetters; markerGroup.attr(attribs); } // Run the animation } else { attribs = { translateX: group.oldtranslateX, translateY: group.oldtranslateY, scaleX: 1, scaleY: 1 }; group.animate(attribs, animation); if (markerGroup) { markerGroup.animate(attribs, animation); } } } } /** * @private */ getDataLabelPosition(point, distance) { const labelPosition = super.getDataLabelPosition(point, distance); if (this.chart.is3d()) { const options3d = this.chart.options.chart.options3d, shapeArgs = point.shapeArgs, r = shapeArgs.r, // #3240 issue with datalabels for 0 and null values a1 = ((shapeArgs.alpha || options3d?.alpha) * deg2rad), b1 = ((shapeArgs.beta || options3d?.beta) * deg2rad), a2 = (shapeArgs.start + shapeArgs.end) / 2, connectorPosition = labelPosition.connectorPosition, yOffset = (-r * (1 - Math.cos(a1)) * Math.sin(a2)), xOffset = r * (Math.cos(b1) - 1) * Math.cos(a2); // Apply perspective on label positions for (const coordinates of [ labelPosition?.natural, connectorPosition.breakAt, connectorPosition.touchingSliceAt ]) { coordinates.x += xOffset; coordinates.y += yOffset; } } return labelPosition; } /** * @private */ pointAttribs(point) { const attr = super.pointAttribs.apply(this, arguments), options = this.options; if (this.chart.is3d() && !this.chart.styledMode) { attr.stroke = options.edgeColor || point.color || this.color; attr['stroke-width'] = pick(options.edgeWidth, 1); } return attr; } /** * @private */ translate() { super.translate.apply(this, arguments); // Do not do this if the chart is not 3D if (!this.chart.is3d()) { return; } const series = this, seriesOptions = series.options, depth = seriesOptions.depth || 0, options3d = series.chart.options.chart.options3d, alpha = options3d.alpha, beta = options3d.beta; let z = seriesOptions.stacking ? (seriesOptions.stack || 0) * depth : series._i * depth; z += depth / 2; if (seriesOptions.grouping !== false) { z = 0; } for (const point of series.points) { const shapeArgs = point.shapeArgs; point.shapeType = 'arc3d'; shapeArgs.z = z; shapeArgs.depth = depth * 0.75; shapeArgs.alpha = alpha; shapeArgs.beta = beta; shapeArgs.center = series.center; const angle = (shapeArgs.end + shapeArgs.start) / 2; point.slicedTranslation = { translateX: Math.round(Math.cos(angle) * seriesOptions.slicedOffset * Math.cos(alpha * deg2rad)), translateY: Math.round(Math.sin(angle) * seriesOptions.slicedOffset * Math.cos(alpha * deg2rad)) }; } } /** * @private */ drawTracker() { super.drawTracker.apply(this, arguments); // Do not do this if the chart is not 3D if (!this.chart.is3d()) { return; } for (const point of this.points) { if (point.graphic) { for (const face of ['out', 'inn', 'side1', 'side2']) { if (point.graphic) { point.graphic[face].element.point = point; } } } } } } extend(Pie3DSeries.prototype, { pointClass: Pie3DPoint }); /* * * * Default Export * * */ /* * * * API Options * * */ /** * The thickness of a 3D pie. * * @type {number} * @default 0 * @since 4.0 * @product highcharts * @requires highcharts-3d * @apioption plotOptions.pie.depth */ ''; // Keeps doclets above after transpiledion return Pie3DSeries; }); _registerModule(_modules, 'Series/Scatter3D/Scatter3DPoint.js', [_modules['Series/Scatter/ScatterSeries.js'], _modules['Core/Utilities.js']], function (ScatterSeries, U) { /* * * * (c) 2010-2024 Torstein Honsi * * Scatter 3D series. * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { pointClass: ScatterPoint } = ScatterSeries.prototype; const { defined } = U; /* * * * Class * * */ class Scatter3DPoint extends ScatterPoint { /* * * * Functions * * */ applyOptions() { super.applyOptions.apply(this, arguments); if (!defined(this.z)) { this.z = 0; } return this; } } /* * * * Default Export * * */ return Scatter3DPoint; }); _registerModule(_modules, 'Series/Scatter3D/Scatter3DSeriesDefaults.js', [], function () { /* * * * (c) 2010-2024 Torstein Honsi * * Scatter 3D series. * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ /* * * * API Options * * */ /** * A 3D scatter plot uses x, y and z coordinates to display values for three * variables for a set of data. * * @sample {highcharts} highcharts/3d/scatter/ * Simple 3D scatter * @sample {highcharts} highcharts/demo/3d-scatter-draggable * Draggable 3d scatter * * @extends plotOptions.scatter * @excluding dragDrop, cluster, boostThreshold, boostBlending * @product highcharts * @requires highcharts-3d * @optionparent plotOptions.scatter3d */ const Scatter3DSeriesDefaults = { tooltip: { pointFormat: 'x: {point.x}
y: {point.y}
z: {point.z}
' } }; /** * A `scatter3d` series. If the [type](#series.scatter3d.type) option is * not specified, it is inherited from [chart.type](#chart.type). * * scatter3d](#plotOptions.scatter3d). * * @extends series,plotOptions.scatter3d * @excluding boostThreshold, boostBlending * @product highcharts * @requires highcharts-3d * @apioption series.scatter3d */ /** * An array of data points for the series. For the `scatter3d` series * type, points can be given in the following ways: * * 1. An array of arrays with 3 values. In this case, the values correspond * to `x,y,z`. If the first value is a string, it is applied as the name * of the point, and the `x` value is inferred. * * ```js * data: [ * [0, 0, 1], * [1, 8, 7], * [2, 9, 2] * ] * ``` * * 3. An array of objects with named values. The following snippet shows only a * few settings, see the complete options set below. If the total number of data * points exceeds the series' * [turboThreshold](#series.scatter3d.turboThreshold), this option is not * available. * * ```js * data: [{ * x: 1, * y: 2, * z: 24, * name: "Point2", * color: "#00FF00" * }, { * x: 1, * y: 4, * z: 12, * name: "Point1", * color: "#FF00FF" * }] * ``` * * @sample {highcharts} highcharts/chart/reflow-true/ * Numerical values * @sample {highcharts} highcharts/series/data-array-of-arrays/ * Arrays of numeric x and y * @sample {highcharts} highcharts/series/data-array-of-arrays-datetime/ * Arrays of datetime x and y * @sample {highcharts} highcharts/series/data-array-of-name-value/ * Arrays of point.name and y * @sample {highcharts} highcharts/series/data-array-of-objects/ * Config objects * * @type {Array|*>} * @extends series.scatter.data * @product highcharts * @apioption series.scatter3d.data */ /** * The z value for each data point. * * @type {number} * @product highcharts * @apioption series.scatter3d.data.z */ ''; // Detachs doclets above /* * * * Default Export * * */ return Scatter3DSeriesDefaults; }); _registerModule(_modules, 'Series/Scatter3D/Scatter3DSeries.js', [_modules['Core/Math3D.js'], _modules['Series/Scatter3D/Scatter3DPoint.js'], _modules['Series/Scatter3D/Scatter3DSeriesDefaults.js'], _modules['Series/Scatter/ScatterSeries.js'], _modules['Core/Series/SeriesRegistry.js'], _modules['Core/Utilities.js']], function (Math3D, Scatter3DPoint, Scatter3DSeriesDefaults, ScatterSeries, SeriesRegistry, U) { /* * * * (c) 2010-2024 Torstein Honsi * * Scatter 3D series. * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ const { pointCameraDistance } = Math3D; const { extend, merge } = U; /* * * * Class * * */ /** * @private * @class * @name Highcharts.seriesTypes.scatter3d * * @augments Highcharts.Series */ class Scatter3DSeries extends ScatterSeries { /* * * * Functions * * */ pointAttribs(point) { const attribs = super.pointAttribs.apply(this, arguments); if (this.chart.is3d() && point) { attribs.zIndex = pointCameraDistance(point, this.chart); } return attribs; } } /* * * * Static Properties * * */ Scatter3DSeries.defaultOptions = merge(ScatterSeries.defaultOptions, Scatter3DSeriesDefaults); extend(Scatter3DSeries.prototype, { axisTypes: ['xAxis', 'yAxis', 'zAxis'], // Require direct touch rather than using the k-d-tree, because the // k-d-tree currently doesn't take the xyz coordinate system into // account (#4552) directTouch: true, parallelArrays: ['x', 'y', 'z'], pointArrayMap: ['x', 'y', 'z'], pointClass: Scatter3DPoint }); SeriesRegistry.registerSeriesType('scatter3d', Scatter3DSeries); /* * * * Default Export * * */ return Scatter3DSeries; }); _registerModule(_modules, 'masters/highcharts-3d.src.js', [_modules['Core/Globals.js'], _modules['Core/Chart/Chart3D.js'], _modules['Series/Area3D/Area3DSeries.js'], _modules['Core/Axis/Axis3DComposition.js'], _modules['Core/Renderer/RendererRegistry.js'], _modules['Core/Series/Series3D.js'], _modules['Core/Axis/Stacking/StackItem.js'], _modules['Core/Renderer/SVG/SVGRenderer3D.js'], _modules['Core/Axis/ZAxis.js'], _modules['Series/Column3D/Column3DComposition.js'], _modules['Series/Pie3D/Pie3DSeries.js']], function (Highcharts, Chart3D, Area3DSeries, Axis3DComposition, RendererRegistry, Series3D, StackItem, SVGRenderer3D, ZAxis, Column3DComposition, Pie3DSeries) { const G = Highcharts; // Compositions Area3DSeries.compose(G.seriesTypes.area); Axis3DComposition.compose(G.Axis, G.Tick); Chart3D.compose(G.Chart, G.Fx); Column3DComposition.compose(G.Series, StackItem); Pie3DSeries.compose(G.Series); Series3D.compose(G.Series); SVGRenderer3D.compose(RendererRegistry.getRendererType()); ZAxis.compose(G.Chart); return G; }); }));