scichart 2.0.2228 → 2.1.2273

package/Charting/Services/SciChartRenderer.js

@@ -11,15 +11,17 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SciChartRenderer = void 0;
 var Dictionary_1 = require("../../Core/Dictionary");
-var NumberRange_1 = require("../../Core/NumberRange");
 var Rect_1 = require("../../Core/Rect");
 var AutoRange_1 = require("../../types/AutoRange");
 var AxisAlignment_1 = require("../../types/AxisAlignment");
 var RenderLayer_1 = require("../../types/RenderLayer");
+var hash_1 = require("../../utils/hash");
+var ResamplingParams_1 = require("../Numerics/Resamplers/ResamplingParams");
 var IAnnotation_1 = require("../Visuals/Annotations/IAnnotation");
 var SciChartSurfaceBase_1 = require("../Visuals/SciChartSurfaceBase");
 var DpiHelper_1 = require("../Visuals/TextureManager/DpiHelper");
 var RenderPassData_1 = require("./RenderPassData");
+var RenderPassInfo_1 = require("./RenderPassInfo");
 /**
  * A class used internally in SciChart to perform layout, arrangement, data-preparation and rendering on the Cartesian 2D {@link SciChartSurface}
  */
@@ -31,6 +33,66 @@ var SciChartRenderer = /** @class */ (function () {
     function SciChartRenderer(sciChartSurface) {
         this.sciChartSurface = sciChartSurface;
     }
+    /**
+     * Used internally
+     * @param xAxis
+     * @param rs
+     * @param seriesViewRect
+     */
+    SciChartRenderer.resampleSeries = function (xAxis, rs, seriesViewRect) {
+        /**
+         * Stacked series and Heatmap do not support resampling
+         * If a series does not support resampling, the pointSeries is not used in the drawing provider.
+         * For example, UniformHeatmapDrawingProvider does not use renderPassData.pointSeries,
+         * but LineSeriesDrawingProvider use renderPassData.pointSeries in the draw() method!
+         */
+        if (!rs.supportsResampling)
+            return {
+                pointSeries: rs.toPointSeries(),
+                renderableSeries: rs,
+                indicesRange: undefined,
+                resamplingHash: undefined
+            };
+        var rp = new ResamplingParams_1.ResamplingParams(seriesViewRect, rs, xAxis);
+        if (!rs.needsResampling(rp))
+            return {
+                pointSeries: rs.toPointSeries(),
+                renderableSeries: rs,
+                indicesRange: undefined,
+                resamplingHash: undefined
+            };
+        var resamplingHash = SciChartRenderer.calculateResamplingHash(rs, rp);
+        var prevRPD = rs.getCurrentRenderPassData();
+        var useFromCache = Boolean(prevRPD && prevRPD.resamplingHash === resamplingHash);
+        // console.log("resampling ...");
+        // console.log("useFromCache", useFromCache);
+        var pointSeries = useFromCache ? prevRPD.pointSeries : rs.toPointSeries(rp);
+        return {
+            pointSeries: pointSeries,
+            renderableSeries: rs,
+            indicesRange: rp.indexesRange,
+            resamplingHash: resamplingHash
+        };
+    };
+    SciChartRenderer.calculateResamplingHash = function (rs, rp) {
+        var hashes = [];
+        var enableDrawingOptimizationsHash = hash_1.hashUtils.generateBooleanHash(rs.enableDrawingOptimisations);
+        hashes.push(enableDrawingOptimizationsHash);
+        var dataSeries = rs.dataSeries;
+        if (dataSeries) {
+            var dataSeriesHash = hash_1.hashUtils.generateHash(dataSeries.id);
+            hashes.push(dataSeriesHash);
+            var dataSeriesCountHash = hash_1.hashUtils.generateNumberHash(dataSeries.count());
+            hashes.push(dataSeriesCountHash);
+            var dataSeriesSortedHash = hash_1.hashUtils.generateBooleanHash(dataSeries.dataDistributionCalculator.isSortedAscending);
+            hashes.push(dataSeriesSortedHash);
+            var dataSeriesChangeCountHash = hash_1.hashUtils.generateNumberHash(dataSeries.changeCount);
+            hashes.push(dataSeriesChangeCountHash);
+        }
+        var resamplingParamsHash = hash_1.hashUtils.generateObjectHash(rp);
+        hashes.push(resamplingParamsHash);
+        return hash_1.hashUtils.generateCombinedHash(hashes);
+    };
     /**
      * Render loop for the current {@SciChartSurface}
      * @param renderContext the {@WebGLRenderContext2D} used for drawing
@@ -61,7 +123,8 @@ var SciChartRenderer = /** @class */ (function () {
         var seriesViewRect = this.sciChartSurface.layoutManager.layoutChart(renderContext.viewportSize);
         this.updateSvgCanvasSize(seriesViewRect);
         // Step 4 prepare render data
-        var xyAxesById = this.prepareRenderData();
+        var _a = this.prepareAxesRenderData(), xAxesById = _a.xAxesById, yAxesById = _a.yAxesById;
+        var renderPassInfo = this.prepareSeriesRenderData(seriesViewRect, xAxesById);
         // Draw seriesViewRect border
         this.sciChartSurface.drawBorder(renderContext);
         // Step 5 Draw X, Y axis and gridlines
@@ -81,22 +144,21 @@ var SciChartRenderer = /** @class */ (function () {
                 el.type === IAnnotation_1.EAnnotationType.RenderContextAxisMarkerAnnotation);
         });
         renderContext.enqueueLayeredDraw(function () {
-            _this.drawRenderContextAnnotations(renderContextAnnotations, xyAxesById[0], xyAxesById[1], IAnnotation_1.EAnnotationLayer.BelowChart, renderContext, seriesViewRect);
+            _this.drawRenderContextAnnotations(renderContextAnnotations, xAxesById, yAxesById, IAnnotation_1.EAnnotationLayer.BelowChart, renderContext, seriesViewRect);
         }, RenderLayer_1.ERenderLayer.Third);
-        // queue series rendering after grid lines and bands, but before the axes
-        renderContext.enqueueLayeredDraw(function () { return _this.drawSeries(_this.sciChartSurface, _this.sciChartSurface.renderableSeries.asArray(), renderContext); }, RenderLayer_1.ERenderLayer.Third);
+        // Step 7 Draw series. Queue series rendering after grid lines and bands, but before the axes
+        renderContext.enqueueLayeredDraw(function () { return _this.drawSeries(_this.sciChartSurface, renderPassInfo, renderContext); }, RenderLayer_1.ERenderLayer.Third);
         // Execute rendering of queued elements
         renderContext.drawLayers();
-        // Step 7 Draw series
         // Step 8 Draw annotations above the series
-        this.drawRenderContextAnnotations(renderContextAnnotations, xyAxesById[0], xyAxesById[1], IAnnotation_1.EAnnotationLayer.AboveChart, renderContext, seriesViewRect);
+        this.drawRenderContextAnnotations(renderContextAnnotations, xAxesById, yAxesById, IAnnotation_1.EAnnotationLayer.AboveChart, renderContext, seriesViewRect);
         // Step 9 Draw SVG or Html Overlays
         var svgAnnotations = annotations.filter(function (el) {
             return el.type === IAnnotation_1.EAnnotationType.SVG ||
                 el.type === IAnnotation_1.EAnnotationType.SVGTextAnnotation ||
                 el.type === IAnnotation_1.EAnnotationType.SVGCustomAnnotation;
         });
-        this.drawSvgAnnotations(svgAnnotations, xyAxesById[0], xyAxesById[1]);
+        this.drawSvgAnnotations(svgAnnotations, xAxesById, yAxesById);
         // Update watermark
         this.updateWatermark(renderContext, seriesViewRect);
         // Step 10 Call OnParentSurfaceRendered
@@ -175,7 +237,7 @@ var SciChartRenderer = /** @class */ (function () {
             svgRootElement.currentScale = 1;
         }
     };
-    SciChartRenderer.prototype.prepareRenderData = function () {
+    SciChartRenderer.prototype.prepareAxesRenderData = function () {
         var xAxesById = new Dictionary_1.Dictionary();
         var yAxesById = new Dictionary_1.Dictionary();
         // Prepare XAxes
@@ -188,7 +250,26 @@ var SciChartRenderer = /** @class */ (function () {
             yAxesById.add(yAxis.id, yAxis);
             yAxis.prepareRenderData();
         });
-        return [xAxesById, yAxesById];
+        return { xAxesById: xAxesById, yAxesById: yAxesById };
+    };
+    SciChartRenderer.prototype.prepareSeriesRenderData = function (seriesViewRect, xAxesById) {
+        var seriesCount = this.sciChartSurface.renderableSeries.size();
+        var renderPassInfo = new RenderPassInfo_1.RenderPassInfo(seriesCount, seriesViewRect);
+        // TODO: Calculate XRange before resample but YRange after resample for faster autorange on large datasets
+        for (var i = 0; i < this.sciChartSurface.renderableSeries.size(); i++) {
+            var series = this.sciChartSurface.renderableSeries.get(i);
+            // don't try and draw series with no data
+            if (!series.isStacked && !series.dataSeries)
+                continue;
+            // TODO: Do resampling, store result for use in drawing
+            var xAxis = xAxesById.item(series.xAxisId);
+            var seriesRenderPassInfo = SciChartRenderer.resampleSeries(xAxis, series, seriesViewRect);
+            renderPassInfo.renderableSeriesArray.push(seriesRenderPassInfo.renderableSeries);
+            renderPassInfo.pointSeriesArray.push(seriesRenderPassInfo.pointSeries);
+            renderPassInfo.indicesRanges.push(seriesRenderPassInfo.indicesRange);
+            renderPassInfo.resamplingHashes.push(seriesRenderPassInfo.resamplingHash);
+        }
+        return renderPassInfo;
     };
     SciChartRenderer.prototype.drawAxes = function (scs, renderContext) {
         scs.xAxes.asArray().forEach(function (xAxis) {
@@ -198,31 +279,30 @@ var SciChartRenderer = /** @class */ (function () {
             yAxis.draw(renderContext);
         });
     };
-    SciChartRenderer.prototype.drawSeries = function (scs, renderableSeries, renderContext) {
-        var drawSeriesImpl = function (series) {
-            var indexRange = new NumberRange_1.NumberRange(0, 0);
-            var xAxis = scs.xAxes.asArray().find(function (a) { return a.id === series.xAxisId; });
-            if (!xAxis) {
-                throw Error("Cannot find an X Axis with ID = " + series.xAxisId);
-            }
-            var yAxis = scs.yAxes.asArray().find(function (a) { return a.id === series.yAxisId; });
-            if (!yAxis) {
-                throw Error("Cannot find a Y Axis with ID = " + series.yAxisId);
-            }
-            if (xAxis.isVerticalChart && ![AxisAlignment_1.EAxisAlignment.Top, AxisAlignment_1.EAxisAlignment.Bottom].includes(yAxis.axisAlignment)) {
+    SciChartRenderer.prototype.drawSeries = function (scs, renderPassInfo, renderContext) {
+        var renderableSeriesArray = renderPassInfo.renderableSeriesArray, pointSeriesArray = renderPassInfo.pointSeriesArray, resamplingHashes = renderPassInfo.resamplingHashes, indicesRanges = renderPassInfo.indicesRanges;
+        var drawSeriesImpl = function (index) {
+            var renderableSeries = renderableSeriesArray[index];
+            var pointSeries = pointSeriesArray[index];
+            var resamplingHash = resamplingHashes[index];
+            var indexRange = indicesRanges[index];
+            var xAxis = scs.xAxes.asArray().find(function (a) { return a.id === renderableSeries.xAxisId; });
+            if (!xAxis)
+                throw Error("Cannot find an X Axis with ID = " + renderableSeries.xAxisId);
+            var yAxis = scs.yAxes.asArray().find(function (a) { return a.id === renderableSeries.yAxisId; });
+            if (!yAxis)
+                throw Error("Cannot find a Y Axis with ID = " + renderableSeries.yAxisId);
+            if (xAxis.isVerticalChart && ![AxisAlignment_1.EAxisAlignment.Top, AxisAlignment_1.EAxisAlignment.Bottom].includes(yAxis.axisAlignment))
                 throw Error("For vertical chart (chart with X Axis alignment Left or Right) Y Axis alignment should be Top or Bottom, X Axis ID = ".concat(xAxis.id));
-            }
-            if ((0, AxisAlignment_1.getIsVertical)(xAxis.axisAlignment) && (0, AxisAlignment_1.getIsVertical)(yAxis.axisAlignment)) {
+            if ((0, AxisAlignment_1.getIsVertical)(xAxis.axisAlignment) && (0, AxisAlignment_1.getIsVertical)(yAxis.axisAlignment))
                 throw Error("Both x and y axes can't have vertical alignment");
-            }
-            if ((0, AxisAlignment_1.getIsHorizontal)(xAxis.axisAlignment) && (0, AxisAlignment_1.getIsHorizontal)(yAxis.axisAlignment)) {
+            if ((0, AxisAlignment_1.getIsHorizontal)(xAxis.axisAlignment) && (0, AxisAlignment_1.getIsHorizontal)(yAxis.axisAlignment))
                 throw Error("Both x and y axes can't have horizontal alignment");
-            }
             var xCalc = xAxis.getCurrentCoordinateCalculator();
             var yCalc = yAxis.getCurrentCoordinateCalculator();
             try {
-                var renderPassData = new RenderPassData_1.RenderPassData(indexRange, xCalc, yCalc, xAxis.isVerticalChart);
-                series.draw(renderContext, renderPassData);
+                var renderPassData = new RenderPassData_1.RenderPassData(indexRange, xCalc, yCalc, xAxis.isVerticalChart, pointSeries, resamplingHash);
+                renderableSeries.draw(renderContext, renderPassData);
             }
             finally {
                 // We can not delete calculators because we use them in Hit Test
@@ -230,10 +310,24 @@ var SciChartRenderer = /** @class */ (function () {
                 // yCalc.delete();
             }
         };
+        var nativeContext = renderContext.getNativeContext();
+        var viewRect = this.sciChartSurface.seriesViewRect;
+        nativeContext.PushMatrix();
+        nativeContext.PushState();
+        nativeContext.Translate(viewRect.x, viewRect.y);
+        nativeContext.SetClipRect(viewRect.x, viewRect.y, viewRect.width, viewRect.height);
         // Draw unselected series first
-        renderableSeries.filter(function (rs) { return rs.isVisible && !rs.isSelected; }).forEach(drawSeriesImpl);
+        renderableSeriesArray.forEach(function (rs, index) {
+            if (rs.isVisible && !rs.isSelected)
+                drawSeriesImpl(index);
+        });
         // Draw selected series at higher z-index
-        renderableSeries.filter(function (rs) { return rs.isVisible && rs.isSelected; }).forEach(drawSeriesImpl);
+        renderableSeriesArray.forEach(function (rs, index) {
+            if (rs.isVisible && rs.isSelected)
+                drawSeriesImpl(index);
+        });
+        nativeContext.PopMatrix();
+        nativeContext.PopState();
     };
     SciChartRenderer.prototype.drawDebugAxes = function (scs, renderContext) {
         scs.xAxes.asArray().forEach(function (xAxis) {

package/Charting/Visuals/Axis/AxisCore.d.ts

@@ -275,6 +275,7 @@ export declare abstract class AxisCore implements IAxisParams, IDeletable {
     protected maxAutoTicksProperty: number;
     protected visibleRangeAnimationToken: IGenericAnimation;
     protected readonly defaultVisibleRange: NumberRange;
+    protected allowFastMathProperty: boolean;
     /**
      * Creates an instance of an {@link AxisCore}
      * @param options Optional parameters of type {@link IAxisCoreOptions} used to define properties at instantiation time
@@ -290,6 +291,16 @@ export declare abstract class AxisCore implements IAxisParams, IDeletable {
      * See {@link AxisBase2D.axisAlignment} if you want to set a 2D Axis alignment to the left, right, top or bottom
      */
     get isXAxis(): boolean;
+    /**
+     * When true, 32-bit faster paths for coordinate calculation maths are used. This improves performance in
+     * edge-cases where every CPU cycle counts.
+     */
+    get allowFastMath(): boolean;
+    /**
+     * When true, 32-bit faster paths for coordinate calculation maths are used. This improves performance in
+     * edge-cases where every CPU cycle counts.
+     */
+    set allowFastMath(allowFastMath: boolean);
     /**
      * When true, the axis has a valid {@link AxisCore.visibleRange} which can be drawn
      * @remarks

package/Charting/Visuals/Axis/AxisCore.js

@@ -44,7 +44,7 @@ var AxisCore = /** @class */ (function () {
      * @param options Optional parameters of type {@link IAxisCoreOptions} used to define properties at instantiation time
      */
     function AxisCore(options) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
         /**
          * An {@link EventHandler} which fires a callback when the {@link AxisCore.visibleRange} property changes.
          * @desc
@@ -161,6 +161,7 @@ var AxisCore = /** @class */ (function () {
          */
         this.maxAutoTicksProperty = 10;
         this.defaultVisibleRange = new NumberRange_1.NumberRange(0, 10);
+        this.allowFastMathProperty = false;
         this.visibleRange = (options === null || options === void 0 ? void 0 : options.visibleRange) || this.defaultVisibleRange;
         this.id = (_a = options === null || options === void 0 ? void 0 : options.id) !== null && _a !== void 0 ? _a : this.id;
         this.growBy = (_b = options === null || options === void 0 ? void 0 : options.growBy) !== null && _b !== void 0 ? _b : this.growBy;
@@ -168,23 +169,24 @@ var AxisCore = /** @class */ (function () {
         this.isVisible = (_d = options === null || options === void 0 ? void 0 : options.isVisible) !== null && _d !== void 0 ? _d : this.isVisible;
         this.axisTitle = (_e = options === null || options === void 0 ? void 0 : options.axisTitle) !== null && _e !== void 0 ? _e : this.axisTitle;
         this.axisTitleStyle = (_f = options === null || options === void 0 ? void 0 : options.axisTitleStyle) !== null && _f !== void 0 ? _f : this.axisTitleStyle;
-        this.autoTicksProperty = (_g = options === null || options === void 0 ? void 0 : options.autoTicks) !== null && _g !== void 0 ? _g : this.autoTicksProperty;
-        this.maxAutoTicksProperty = (_h = options === null || options === void 0 ? void 0 : options.maxAutoTicks) !== null && _h !== void 0 ? _h : this.maxAutoTicksProperty;
-        this.minorsPerMajorProperty = (_j = options === null || options === void 0 ? void 0 : options.minorsPerMajor) !== null && _j !== void 0 ? _j : this.minorsPerMajorProperty;
-        this.majorDeltaProperty = (_k = options === null || options === void 0 ? void 0 : options.majorDelta) !== null && _k !== void 0 ? _k : this.majorDeltaProperty;
-        this.minorDeltaProperty = (_l = options === null || options === void 0 ? void 0 : options.minorDelta) !== null && _l !== void 0 ? _l : this.minorDeltaProperty;
-        this.drawLabelsProperty = (_m = options === null || options === void 0 ? void 0 : options.drawLabels) !== null && _m !== void 0 ? _m : this.drawLabelsProperty;
-        this.drawMajorTickLinesProperty = (_o = options === null || options === void 0 ? void 0 : options.drawMajorTickLines) !== null && _o !== void 0 ? _o : this.drawMajorTickLinesProperty;
-        this.drawMinorTickLinesProperty = (_p = options === null || options === void 0 ? void 0 : options.drawMinorTickLines) !== null && _p !== void 0 ? _p : this.drawMinorTickLinesProperty;
-        this.drawMinorGridLinesProperty = (_q = options === null || options === void 0 ? void 0 : options.drawMinorGridLines) !== null && _q !== void 0 ? _q : this.drawMinorGridLinesProperty;
-        this.drawMajorGridLinesProperty = (_r = options === null || options === void 0 ? void 0 : options.drawMajorGridLines) !== null && _r !== void 0 ? _r : this.drawMajorGridLinesProperty;
-        this.majorGridLineStyleProperty = (_s = options === null || options === void 0 ? void 0 : options.majorGridLineStyle) !== null && _s !== void 0 ? _s : this.majorGridLineStyleProperty;
-        this.minorGridLineStyleProperty = (_t = options === null || options === void 0 ? void 0 : options.minorGridLineStyle) !== null && _t !== void 0 ? _t : this.minorGridLineStyleProperty;
-        this.majorTickLineStyleProperty = (_u = options === null || options === void 0 ? void 0 : options.majorTickLineStyle) !== null && _u !== void 0 ? _u : this.majorTickLineStyleProperty;
-        this.minorTickLineStyleProperty = (_v = options === null || options === void 0 ? void 0 : options.minorTickLineStyle) !== null && _v !== void 0 ? _v : this.minorTickLineStyleProperty;
-        this.drawMajorBandsProperty = (_w = options === null || options === void 0 ? void 0 : options.drawMajorBands) !== null && _w !== void 0 ? _w : this.drawMajorBandsProperty;
-        this.axisBandsFillProperty = (_x = options === null || options === void 0 ? void 0 : options.axisBandsFill) !== null && _x !== void 0 ? _x : this.axisBandsFillProperty;
-        this.flippedCoordinatesProperty = (_y = options === null || options === void 0 ? void 0 : options.flippedCoordinates) !== null && _y !== void 0 ? _y : this.flippedCoordinatesProperty;
+        this.allowFastMath = (_g = options === null || options === void 0 ? void 0 : options.allowFastMath) !== null && _g !== void 0 ? _g : this.allowFastMathProperty;
+        this.autoTicksProperty = (_h = options === null || options === void 0 ? void 0 : options.autoTicks) !== null && _h !== void 0 ? _h : this.autoTicksProperty;
+        this.maxAutoTicksProperty = (_j = options === null || options === void 0 ? void 0 : options.maxAutoTicks) !== null && _j !== void 0 ? _j : this.maxAutoTicksProperty;
+        this.minorsPerMajorProperty = (_k = options === null || options === void 0 ? void 0 : options.minorsPerMajor) !== null && _k !== void 0 ? _k : this.minorsPerMajorProperty;
+        this.majorDeltaProperty = (_l = options === null || options === void 0 ? void 0 : options.majorDelta) !== null && _l !== void 0 ? _l : this.majorDeltaProperty;
+        this.minorDeltaProperty = (_m = options === null || options === void 0 ? void 0 : options.minorDelta) !== null && _m !== void 0 ? _m : this.minorDeltaProperty;
+        this.drawLabelsProperty = (_o = options === null || options === void 0 ? void 0 : options.drawLabels) !== null && _o !== void 0 ? _o : this.drawLabelsProperty;
+        this.drawMajorTickLinesProperty = (_p = options === null || options === void 0 ? void 0 : options.drawMajorTickLines) !== null && _p !== void 0 ? _p : this.drawMajorTickLinesProperty;
+        this.drawMinorTickLinesProperty = (_q = options === null || options === void 0 ? void 0 : options.drawMinorTickLines) !== null && _q !== void 0 ? _q : this.drawMinorTickLinesProperty;
+        this.drawMinorGridLinesProperty = (_r = options === null || options === void 0 ? void 0 : options.drawMinorGridLines) !== null && _r !== void 0 ? _r : this.drawMinorGridLinesProperty;
+        this.drawMajorGridLinesProperty = (_s = options === null || options === void 0 ? void 0 : options.drawMajorGridLines) !== null && _s !== void 0 ? _s : this.drawMajorGridLinesProperty;
+        this.majorGridLineStyleProperty = (_t = options === null || options === void 0 ? void 0 : options.majorGridLineStyle) !== null && _t !== void 0 ? _t : this.majorGridLineStyleProperty;
+        this.minorGridLineStyleProperty = (_u = options === null || options === void 0 ? void 0 : options.minorGridLineStyle) !== null && _u !== void 0 ? _u : this.minorGridLineStyleProperty;
+        this.majorTickLineStyleProperty = (_v = options === null || options === void 0 ? void 0 : options.majorTickLineStyle) !== null && _v !== void 0 ? _v : this.majorTickLineStyleProperty;
+        this.minorTickLineStyleProperty = (_w = options === null || options === void 0 ? void 0 : options.minorTickLineStyle) !== null && _w !== void 0 ? _w : this.minorTickLineStyleProperty;
+        this.drawMajorBandsProperty = (_x = options === null || options === void 0 ? void 0 : options.drawMajorBands) !== null && _x !== void 0 ? _x : this.drawMajorBandsProperty;
+        this.axisBandsFillProperty = (_y = options === null || options === void 0 ? void 0 : options.axisBandsFill) !== null && _y !== void 0 ? _y : this.axisBandsFillProperty;
+        this.flippedCoordinatesProperty = (_z = options === null || options === void 0 ? void 0 : options.flippedCoordinates) !== null && _z !== void 0 ? _z : this.flippedCoordinatesProperty;
     }
     Object.defineProperty(AxisCore.prototype, "isCategoryAxis", {
         /**
@@ -208,6 +210,25 @@ var AxisCore = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(AxisCore.prototype, "allowFastMath", {
+        /**
+         * When true, 32-bit faster paths for coordinate calculation maths are used. This improves performance in
+         * edge-cases where every CPU cycle counts.
+         */
+        get: function () {
+            return this.allowFastMathProperty;
+        },
+        /**
+         * When true, 32-bit faster paths for coordinate calculation maths are used. This improves performance in
+         * edge-cases where every CPU cycle counts.
+         */
+        set: function (allowFastMath) {
+            this.allowFastMathProperty = allowFastMath;
+            this.notifyPropertyChanged(constants_1.PROPERTY.ALLOW_FAST_MATH);
+        },
+        enumerable: false,
+        configurable: true
+    });
     /**
      * When true, the axis has a valid {@link AxisCore.visibleRange} which can be drawn
      * @remarks

package/Charting/Visuals/Axis/AxisRenderer.d.ts

@@ -25,6 +25,7 @@ export declare class AxisRenderer implements IDeletable {
     private measureTextCanvas;
     private keepLabelsWithinAxisProperty;
     private hideOverlappingLabelsProperty;
+    private vertices;
     /**
      * Creates an instance of a {@link AxisRenderer}
      * @param webAssemblyContext The {@link TSciChart | SciChart 2D WebAssembly Context} containing native methods and

package/Charting/Visuals/Axis/AxisRenderer.js

@@ -45,6 +45,7 @@ var AxisRenderer = /** @class */ (function () {
         this.hideOverlappingLabelsProperty = true;
         this.webAssemblyContext = webAssemblyContext;
         this.textureManager = new TextureManager_1.TextureManager(webAssemblyContext);
+        this.vertices = new webAssemblyContext.VectorColorVertex();
         if (!app_1.IS_TEST_ENV) {
             this.measureTextCanvas = document.createElement("canvas");
             this.measureTextCanvas.width = 1;
@@ -55,6 +56,7 @@ var AxisRenderer = /** @class */ (function () {
     AxisRenderer.prototype.delete = function () {
         this.measureTextCanvas = undefined;
         this.textureManager = (0, Deleter_1.deleteSafe)(this.textureManager);
+        this.vertices = (0, Deleter_1.deleteSafe)(this.vertices);
     };
     /**
      * Called when the {@link AxisRenderer} is attached to an {@link AxisBase2D | Axis}
@@ -311,7 +313,6 @@ var AxisRenderer = /** @class */ (function () {
             return;
         var viewRect = this.viewRect;
         var tickSize = tickStyle.tickSize;
-        var vertices = new this.webAssemblyContext.VectorColorVertex();
         var isHorizontal = (0, AxisAlignment_1.getIsHorizontal)(axisAlignment);
         if (isHorizontal === undefined) {
             return;
@@ -347,17 +348,16 @@ var AxisRenderer = /** @class */ (function () {
                 }
             }
             var vertex = new _this.webAssemblyContext.SCRTColorVertex(x1, y1);
-            vertices.push_back(vertex);
+            _this.vertices.push_back(vertex);
             vertex.delete();
             var vertex2 = new _this.webAssemblyContext.SCRTColorVertex(x2, y2);
-            vertices.push_back(vertex2);
+            _this.vertices.push_back(vertex2);
             vertex2.delete();
         });
         var leftOffset = viewRect.left - (isHorizontal ? axisOffset : 0);
         var topOffset = viewRect.top - (isHorizontal ? 0 : axisOffset);
-        renderContext.drawLinesNative(vertices, pen, WebGlRenderContext2D_1.ELineDrawMode.DiscontinuousLine, leftOffset, topOffset);
-        vertices.clear();
-        vertices.delete();
+        renderContext.drawLinesNative(this.vertices, pen, WebGlRenderContext2D_1.ELineDrawMode.DiscontinuousLine, leftOffset, topOffset);
+        this.vertices.clear();
     };
     /**
      * Called internally - draws axis labels when needed, for example for line annotations

package/Charting/Visuals/Axis/CategoryAxisBase.d.ts

@@ -6,11 +6,30 @@ import { AxisBase2D, IAxisBase2dOptions } from "./AxisBase2D";
 import { ILabel2DOptions } from "./LabelProvider/LabelProviderBase2D";
 export declare type TCategoryCoordCalc = CategoryCoordinateCalculator | FlippedCategoryCoordinateCalculator;
 export interface ICategoryAxisBaseOptions extends IAxisBase2dOptions, ILabel2DOptions {
+    /**
+     * The default x values to use if no series or data is added to the chart.
+     * The tick values shown will depend on the visible range, which for category axis is by index, not by value.
+     * eg if you want default values [10, 20, 30, 40] you would need to set visibleRange: new NumberRange(0,3)
+     * By default it will start at 0 and increment by 1, up to the size of the visible range.
+     * To change the start and step set defaultXStart and defaultXStep
+     */
+    defaultXValues?: number[];
+    /**
+     * The starting value for default x values.  See defaultXValues
+     */
+    defaultXStart?: number;
+    /**
+     * The step size for default x values.  See defaultXValues
+     */
+    defaultXStep?: number;
 }
 /**
  * @summary A 2D Chart Category Axis Base type
  */
 export declare abstract class CategoryAxisBase extends AxisBase2D {
+    private defaultXValuesProperty;
+    private defaultXStartProperty;
+    private defaultXStepProperty;
     /**
      * Creates an instance of a {@link CategoryAxisBase}
      * @param webAssemblyContext The {@link TSciChart | SciChart 2D WebAssembly Context} containing native methods and
@@ -22,6 +41,38 @@ export declare abstract class CategoryAxisBase extends AxisBase2D {
      * @inheritDoc
      */
     get isCategoryAxis(): boolean;
+    /**
+     * The default x values to use if no series or data is added to the chart.
+     * The tick values shown will depend on the visible range, which for category axis is by index, not by value.
+     * eg if you want default values [10, 20, 30, 40] you would need to set visibleRange: new NumberRange(0,3)
+     * By default it will start at 0 and increment by 1, up to the size of the visible range.
+     * To change the start and step set defaultXStart and defaultXStep
+     */
+    get defaultXValues(): number[];
+    /**
+     * The default x values to use if no series or data is added to the chart.
+     * The tick values shown will depend on the visible range, which for category axis is by index, not by value.
+     * eg if you want default values [10, 20, 30, 40] you would need to set visibleRange: new NumberRange(0,3)
+     * By default it will start at 0 and increment by 1, up to the size of the visible range.
+     * To change the start and step set defaultXStart and defaultXStep
+     */
+    set defaultXValues(values: number[]);
+    /**
+     * The starting value for default x values.  See defaultXValues
+     */
+    get defaultXStart(): number;
+    /**
+     * The starting value for default x values.  See defaultXValues
+     */
+    set defaultXStart(value: number);
+    /**
+     * The step size for default x values.  See defaultXValues
+     */
+    get defaultXStep(): number;
+    /**
+     * The step size for default x values.  See defaultXValues
+     */
+    set defaultXStep(value: number);
     /**
      * @inheritDoc
      */
@@ -35,5 +86,6 @@ export declare abstract class CategoryAxisBase extends AxisBase2D {
      */
     protected getXDataRange(): NumberRange;
     protected getMaxAutoTicks(): number;
+    private generateDefaultXValuesForCategoryAxis;
     private setBaseXValues;
 }

package/Charting/Visuals/Axis/CategoryAxisBase.js

@@ -19,6 +19,7 @@ exports.CategoryAxisBase = void 0;
 var Deleter_1 = require("../../../Core/Deleter");
 var NumberRange_1 = require("../../../Core/NumberRange");
 var SeriesType_1 = require("../../../types/SeriesType");
+var appendDoubleVectorFromJsArray_1 = require("../../../utils/ccall/appendDoubleVectorFromJsArray");
 var CategoryCoordinateCalculator_1 = require("../../Numerics/CoordinateCalculators/CategoryCoordinateCalculator");
 var FlippedCategoryCoordinateCalculator_1 = require("../../Numerics/CoordinateCalculators/FlippedCategoryCoordinateCalculator");
 var NumericTickProvider_1 = require("../../Numerics/TickProviders/NumericTickProvider");
@@ -36,7 +37,14 @@ var CategoryAxisBase = /** @class */ (function (_super) {
      * @param options Optional parameters of type {@link ICategoryAxisBaseOptions} used to configure the axis at instantiation time
      */
     function CategoryAxisBase(webAssemblyContext, options) {
+        var _a, _b, _c;
         var _this = _super.call(this, webAssemblyContext, options) || this;
+        _this.defaultXValuesProperty = [];
+        _this.defaultXStartProperty = 0;
+        _this.defaultXStepProperty = 1;
+        _this.defaultXValuesProperty = (_a = options === null || options === void 0 ? void 0 : options.defaultXValues) !== null && _a !== void 0 ? _a : _this.defaultXValuesProperty;
+        _this.defaultXStartProperty = (_b = options === null || options === void 0 ? void 0 : options.defaultXStart) !== null && _b !== void 0 ? _b : _this.defaultXStartProperty;
+        _this.defaultXStepProperty = (_c = options === null || options === void 0 ? void 0 : options.defaultXStep) !== null && _c !== void 0 ? _c : _this.defaultXStepProperty;
         _this.tickProvider = new NumericTickProvider_1.NumericTickProvider(_this.webAssemblyContext2D);
         _this.deltaCalculator = new CategoryDeltaCalculator_1.CategoryDeltaCalculator(_this.webAssemblyContext2D);
         return _this;
@@ -51,6 +59,68 @@ var CategoryAxisBase = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(CategoryAxisBase.prototype, "defaultXValues", {
+        /**
+         * The default x values to use if no series or data is added to the chart.
+         * The tick values shown will depend on the visible range, which for category axis is by index, not by value.
+         * eg if you want default values [10, 20, 30, 40] you would need to set visibleRange: new NumberRange(0,3)
+         * By default it will start at 0 and increment by 1, up to the size of the visible range.
+         * To change the start and step set defaultXStart and defaultXStep
+         */
+        get: function () {
+            return this.defaultXValuesProperty;
+        },
+        /**
+         * The default x values to use if no series or data is added to the chart.
+         * The tick values shown will depend on the visible range, which for category axis is by index, not by value.
+         * eg if you want default values [10, 20, 30, 40] you would need to set visibleRange: new NumberRange(0,3)
+         * By default it will start at 0 and increment by 1, up to the size of the visible range.
+         * To change the start and step set defaultXStart and defaultXStep
+         */
+        set: function (values) {
+            this.defaultXValuesProperty = values;
+            if (this.invalidateParentCallback)
+                this.invalidateParentCallback();
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(CategoryAxisBase.prototype, "defaultXStart", {
+        /**
+         * The starting value for default x values.  See defaultXValues
+         */
+        get: function () {
+            return this.defaultXStartProperty;
+        },
+        /**
+         * The starting value for default x values.  See defaultXValues
+         */
+        set: function (value) {
+            this.defaultXStartProperty = value;
+            if (this.invalidateParentCallback)
+                this.invalidateParentCallback();
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(CategoryAxisBase.prototype, "defaultXStep", {
+        /**
+         * The step size for default x values.  See defaultXValues
+         */
+        get: function () {
+            return this.defaultXStepProperty;
+        },
+        /**
+         * The step size for default x values.  See defaultXValues
+         */
+        set: function (value) {
+            this.defaultXStepProperty = value;
+            if (this.invalidateParentCallback)
+                this.invalidateParentCallback();
+        },
+        enumerable: false,
+        configurable: true
+    });
     /**
      * @inheritDoc
      */
@@ -60,16 +130,6 @@ var CategoryAxisBase = /** @class */ (function (_super) {
         var coordCalc = this.getCurrentCoordinateCalculatorInternal();
         var scs = this.parentSurface;
         var renderableSeries = scs.renderableSeries.asArray().find(function (rs) { return rs.xAxisId === _this.id; });
-        if (!renderableSeries) {
-            throw new Error("category x axis with id=".concat(this.id, " should have renderable series"));
-        }
-        if (!renderableSeries.hasDataSeries()) {
-            throw new Error("category x axis with id=".concat(this.id, " should have data series"));
-        }
-        var dataSeriesLength = renderableSeries.getDataSeriesValuesCount();
-        if (dataSeriesLength === 0) {
-            throw new Error("category x axis with id=".concat(this.id, " should have data series count > 0"));
-        }
         this.setBaseXValues(coordCalc, renderableSeries);
         this.coordCalcCache = coordCalc;
     };
@@ -84,16 +144,6 @@ var CategoryAxisBase = /** @class */ (function (_super) {
         var shouldFlip = !(this.isXAxis !== this.flippedCoordinates);
         var scs = this.parentSurface;
         var renderableSeries = scs.renderableSeries.asArray().find(function (rs) { return rs.xAxisId === _this.id; });
-        if (!renderableSeries) {
-            throw new Error("category x axis with id=".concat(this.id, " should have renderable series"));
-        }
-        if (!renderableSeries.hasDataSeries()) {
-            throw new Error("category x axis with id=".concat(this.id, " should have data series"));
-        }
-        var dataSeriesLength = renderableSeries.getDataSeriesValuesCount();
-        if (dataSeriesLength === 0) {
-            throw new Error("category x axis with id=".concat(this.id, " should have data series count > 0"));
-        }
         var coordCalc = shouldFlip
             ? new FlippedCategoryCoordinateCalculator_1.FlippedCategoryCoordinateCalculator(this.webAssemblyContext2D, size, 0, 0, min, max, this.offset)
             : new CategoryCoordinateCalculator_1.CategoryCoordinateCalculator(this.webAssemblyContext2D, size, 0, 0, min, max, this.offset);
@@ -127,6 +177,19 @@ var CategoryAxisBase = /** @class */ (function (_super) {
         var coordCalc = this.getCurrentCoordinateCalculator();
         return Math.min(Math.max(1, this.maxAutoTicks), coordCalc.baseXValues.size());
     };
+    CategoryAxisBase.prototype.generateDefaultXValuesForCategoryAxis = function () {
+        var _this = this;
+        var defaultBaseXValues = new this.webAssemblyContext2D.SCRTDoubleVector();
+        if (this.defaultXValues && this.defaultXValues.length > 0) {
+            (0, appendDoubleVectorFromJsArray_1.appendDoubleVectorFromJsArray)(this.webAssemblyContext2D, defaultBaseXValues, this.defaultXValues);
+        }
+        else {
+            var length_1 = Math.ceil(this.visibleRange.diff);
+            var xValues = Array.from(Array(length_1), function (_, i) { return _this.defaultXStart + i * _this.defaultXStep; });
+            (0, appendDoubleVectorFromJsArray_1.appendDoubleVectorFromJsArray)(this.webAssemblyContext2D, defaultBaseXValues, xValues);
+        }
+        return defaultBaseXValues;
+    };
     CategoryAxisBase.prototype.setBaseXValues = function (coordCalc, renderableSeries) {
         if (renderableSeries.type === SeriesType_1.ESeriesType.UniformHeatmapSeries) {
             throw Error("Category Axis is not supported for UniformHeatmapRenderableSeries");
@@ -137,9 +200,20 @@ var CategoryAxisBase = /** @class */ (function (_super) {
                 throw Error("BaseStackedCollection should have at least one BaseStackedRenderableSeries");
             }
             var firstStackedRS = stackedCollection.get(0);
+            if (!(firstStackedRS === null || firstStackedRS === void 0 ? void 0 : firstStackedRS.dataSeries)) {
+                if (!coordCalc.baseXValues)
+                    coordCalc.baseXValues = this.generateDefaultXValuesForCategoryAxis();
+                return;
+            }
             coordCalc.baseXValues = firstStackedRS.dataSeries.getNativeXValues();
         }
         else {
+            // Not stacked renderable series
+            if (!(renderableSeries === null || renderableSeries === void 0 ? void 0 : renderableSeries.dataSeries)) {
+                if (!coordCalc.baseXValues)
+                    coordCalc.baseXValues = this.generateDefaultXValuesForCategoryAxis();
+                return;
+            }
             coordCalc.baseXValues = renderableSeries.dataSeries.getNativeXValues();
         }
     };