scichart 2.0.2195 → 2.1.2261

package/Charting/Visuals/Axis/AxisBase2D.js

@@ -100,7 +100,7 @@ var AxisBase2D = /** @class */ (function (_super) {
      * @param options Optional parameters of type {@link IAxisBase2dOptions} used to configure the axis at instantiation time
      */
     function AxisBase2D(webAssemblyContext, options) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         var _this = _super.call(this, options) || this;
         /**
          * Gets the {@link AxisLayoutState} class which manages layout
@@ -149,6 +149,7 @@ var AxisBase2D = /** @class */ (function (_super) {
         _this.labelStyle = __assign(__assign({}, _this.labelStyle), options === null || options === void 0 ? void 0 : options.labelStyle);
         _this.axisBorder = __assign(__assign({}, _this.axisBorder), options === null || options === void 0 ? void 0 : options.axisBorder);
         _this.isInnerAxis = (_g = options === null || options === void 0 ? void 0 : options.isInnerAxis) !== null && _g !== void 0 ? _g : _this.isInnerAxis;
+        _this.stackedAxisLength = (_h = options === null || options === void 0 ? void 0 : options.stackedAxisLength) !== null && _h !== void 0 ? _h : _this.stackedAxisLength;
         _this.solidBrushCacheBorder = new SolidBrushCache_1.SolidBrushCache(webAssemblyContext);
         if (options === null || options === void 0 ? void 0 : options.labelProvider) {
             if (!("getLabels" in (options === null || options === void 0 ? void 0 : options.labelProvider))) {
@@ -232,8 +233,10 @@ var AxisBase2D = /** @class */ (function (_super) {
          * SciChart also supports XAxis on the left and YAxis on the top to rotate / create vertical charts.
          */
         set: function (axisAlignment) {
-            this.axisAlignmentProperty = axisAlignment;
-            this.notifyPropertyChanged(constants_1.PROPERTY.AXIS_ALIGNMENT);
+            if (this.axisAlignmentProperty !== axisAlignment) {
+                this.axisAlignmentProperty = axisAlignment;
+                this.notifyPropertyChanged(constants_1.PROPERTY.AXIS_ALIGNMENT);
+            }
         },
         enumerable: false,
         configurable: true
@@ -249,8 +252,10 @@ var AxisBase2D = /** @class */ (function (_super) {
          * Gets or sets a property which limits {@link AxisCore.visibleRange}, meaning the chart cannot autorange outside that range
          */
         set: function (visibleRangeLimit) {
-            this.visibleRangeLimitProperty = visibleRangeLimit;
-            this.notifyPropertyChanged(constants_1.PROPERTY.VISIBLE_RANGE_LIMIT);
+            if (!NumberRange_1.NumberRange.areEqual(this.visibleRangeLimitProperty, visibleRangeLimit)) {
+                this.visibleRangeLimitProperty = visibleRangeLimit;
+                this.notifyPropertyChanged(constants_1.PROPERTY.VISIBLE_RANGE_LIMIT);
+            }
         },
         enumerable: false,
         configurable: true
@@ -266,8 +271,10 @@ var AxisBase2D = /** @class */ (function (_super) {
          * Gets or sets a property which, if it is set, will be used as the range when zooming extents, rather than the data max range
          */
         set: function (zoomExtentsRange) {
-            this.zoomExtentsRangeProperty = zoomExtentsRange;
-            this.notifyPropertyChanged(constants_1.PROPERTY.ZOOMEXTENTS_RANGE);
+            if (!NumberRange_1.NumberRange.areEqual(this.zoomExtentsRangeProperty, zoomExtentsRange)) {
+                this.zoomExtentsRangeProperty = zoomExtentsRange;
+                this.notifyPropertyChanged(constants_1.PROPERTY.ZOOMEXTENTS_RANGE);
+            }
         },
         enumerable: false,
         configurable: true
@@ -285,8 +292,10 @@ var AxisBase2D = /** @class */ (function (_super) {
          * @remarks Center axis uses inner layout strategy
          */
         set: function (value) {
-            this.isInnerAxisProperty = value;
-            this.notifyPropertyChanged(constants_1.PROPERTY.IS_INNER_AXIS);
+            if (this.isInnerAxisProperty !== value) {
+                this.isInnerAxisProperty = value;
+                this.notifyPropertyChanged(constants_1.PROPERTY.IS_INNER_AXIS);
+            }
         },
         enumerable: false,
         configurable: true
@@ -307,15 +316,17 @@ var AxisBase2D = /** @class */ (function (_super) {
          */
         set: function (value) {
             var _this = this;
-            this.isPrimaryAxisProperty = value;
-            this.notifyPropertyChanged(constants_1.PROPERTY.IS_PRIMARY_AXIS);
-            if (value && !this.isStackedAxis) {
-                var axes = this.isXAxis ? this.parentSurface.xAxes : this.parentSurface.yAxes;
-                axes.asArray().forEach(function (a) {
-                    if (a !== _this && !a.isStackedAxis) {
-                        a.isPrimaryAxis = false;
-                    }
-                });
+            if (this.isPrimaryAxisProperty !== value) {
+                this.isPrimaryAxisProperty = value;
+                this.notifyPropertyChanged(constants_1.PROPERTY.IS_PRIMARY_AXIS);
+                if (value && !this.isStackedAxis) {
+                    var axes = this.isXAxis ? this.parentSurface.xAxes : this.parentSurface.yAxes;
+                    axes.asArray().forEach(function (a) {
+                        if (a !== _this && !a.isStackedAxis) {
+                            a.isPrimaryAxis = false;
+                        }
+                    });
+                }
             }
         },
         enumerable: false,
@@ -337,6 +348,31 @@ var AxisBase2D = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(AxisBase2D.prototype, "stackedAxisLength", {
+        /** Gets or sets the length of a stacked axis as an absolute number or percentage, e.g. 100, or "30%".
+         * A plain number will be interpreted as a number of pixels.
+         * A number with % will take that percentage of the total length.
+         * Stacked axes without a defined length will have the remaining unreserved spaced split between them.
+         * @remarks The axis length doesn't include border sizes
+         */
+        get: function () {
+            return this.stackedAxisLengthProperty;
+        },
+        /** Gets or sets the length of a stacked axis as an absolute number or percentage, e.g. 100, or "30%".
+         * A plain number will be interpreted as a number of pixels.
+         * A number with % will take that percentage of the total length.
+         * Stacked axes without a defined length will have the remaining unreserved spaced split between them.
+         * @remarks The axis length doesn't include border sizes
+         */
+        set: function (value) {
+            if (this.stackedAxisLengthProperty !== value) {
+                this.stackedAxisLengthProperty = value;
+                this.notifyPropertyChanged(constants_1.PROPERTY.AXIS_LENGTH);
+            }
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(AxisBase2D.prototype, "axisLength", {
         /**
          * Called internally - Gets or sets the length the current Axis. E.g. width of horizontal axis or height of vertical axis.
@@ -351,8 +387,10 @@ var AxisBase2D = /** @class */ (function (_super) {
             return (_b = this.axisLengthProperty) !== null && _b !== void 0 ? _b : defaultAxisLength;
         },
         set: function (value) {
-            this.axisLengthProperty = value;
-            this.notifyPropertyChanged(constants_1.PROPERTY.AXIS_LENGTH);
+            if (this.axisLengthProperty !== value) {
+                this.axisLengthProperty = value;
+                this.notifyPropertyChanged(constants_1.PROPERTY.AXIS_LENGTH);
+            }
         },
         enumerable: false,
         configurable: true
@@ -369,8 +407,10 @@ var AxisBase2D = /** @class */ (function (_super) {
          * Gets or sets the offset of the axis position
          */
         set: function (value) {
-            this.offsetProperty = value;
-            this.notifyPropertyChanged(constants_1.PROPERTY.OFFSET);
+            if (this.offsetProperty !== value) {
+                this.offsetProperty = value;
+                this.notifyPropertyChanged(constants_1.PROPERTY.OFFSET);
+            }
         },
         enumerable: false,
         configurable: true
@@ -676,8 +716,15 @@ var AxisBase2D = /** @class */ (function (_super) {
         }
         var translatedRange = this.getCurrentCoordinateCalculator().translateBy(pixelsToScroll, startVisibleRange);
         if (this.visibleRangeLimit) {
-            if (translatedRange.min < this.visibleRangeLimit.min || translatedRange.max > this.visibleRangeLimit.max) {
-                return false;
+            var limitDelta = 0;
+            if (translatedRange.min < this.visibleRangeLimit.min) {
+                limitDelta = this.visibleRangeLimit.min - translatedRange.min;
+            }
+            else if (this.visibleRangeLimit.max < translatedRange.max) {
+                limitDelta = this.visibleRangeLimit.max - translatedRange.max;
+            }
+            if (limitDelta) {
+                translatedRange = new NumberRange_1.NumberRange(translatedRange.min + limitDelta, translatedRange.max + limitDelta);
             }
         }
         this.visibleRange = translatedRange;

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
@@ -367,22 +367,49 @@ var AxisRenderer = /** @class */ (function () {
             return undefined;
         var nativeContext = renderContext.getNativeContext();
         var _a = this.textureManager.createSimpleTextTexture(displayValue, __assign(__assign({}, textStyle), { padding: new Thickness_1.Thickness(2, 2, 2, 2) }), fill), bitmapTexture = _a.bitmapTexture, textureHeight = _a.textureHeight, textureWidth = _a.textureWidth;
+        var canvas = {
+            height: this.parentAxis.parentSurface.domCanvas2D.height,
+            width: this.parentAxis.parentSurface.domCanvas2D.width
+        };
+        var getPosition = function (viewRectSize, coord, canvasSize, textureSize$) {
+            if (viewRectSize + coord < textureSize$ / 2) {
+                return 0;
+            }
+            else if (viewRectSize + coord > canvasSize - textureSize$ / 2) {
+                return canvasSize - textureSize$;
+            }
+            else {
+                return viewRectSize + coord - textureSize$ / 2;
+            }
+        };
         var xPosition, yPosition;
         if (axisAlignment === AxisAlignment_1.EAxisAlignment.Bottom) {
-            xPosition = this.viewRect.x + coord - textureWidth / 2;
+            xPosition = getPosition(this.viewRect.x, coord, canvas.width, textureWidth);
             yPosition = this.viewRect.y;
+            if (canvas.height - yPosition < textureHeight) {
+                yPosition = canvas.height - textureHeight;
+            }
         }
         else if (axisAlignment === AxisAlignment_1.EAxisAlignment.Top) {
-            xPosition = this.viewRect.x + coord - textureWidth / 2;
+            xPosition = getPosition(this.viewRect.x, coord, canvas.width, textureWidth);
             yPosition = this.viewRect.y + this.viewRect.height - textureHeight;
+            if (this.parentAxis.axisLayoutState.axisSize < textureHeight) {
+                yPosition = 0;
+            }
         }
         else if (axisAlignment === AxisAlignment_1.EAxisAlignment.Left) {
             xPosition = this.viewRect.x + this.viewRect.width - textureWidth;
-            yPosition = this.viewRect.y + coord - textureHeight / 2;
+            yPosition = getPosition(this.viewRect.y, coord, canvas.height, textureHeight);
+            if (this.parentAxis.axisLayoutState.axisSize < textureWidth) {
+                xPosition = 0;
+            }
         }
         else if (axisAlignment === AxisAlignment_1.EAxisAlignment.Right) {
             xPosition = this.viewRect.x;
-            yPosition = this.viewRect.y + coord - textureHeight / 2;
+            yPosition = getPosition(this.viewRect.y, coord, canvas.height, textureHeight);
+            if (canvas.width - xPosition < textureWidth) {
+                xPosition = canvas.width - textureWidth;
+            }
         }
         nativeContext.DrawTexture(bitmapTexture, Math.round(xPosition), Math.round(yPosition), textureWidth, textureHeight);
         bitmapTexture.delete();

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
      */

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);
@@ -128,6 +178,21 @@ var CategoryAxisBase = /** @class */ (function (_super) {
         return Math.min(Math.max(1, this.maxAutoTicks), coordCalc.baseXValues.size());
     };
     CategoryAxisBase.prototype.setBaseXValues = function (coordCalc, renderableSeries) {
+        var _this = this;
+        if (!(renderableSeries === null || renderableSeries === void 0 ? void 0 : renderableSeries.dataSeries)) {
+            if (!coordCalc.baseXValues) {
+                var defaultBaseXValues = new this.webAssemblyContext2D.SCRTDoubleVector();
+                if (this.defaultXValues && this.defaultXValues.length > 0) {
+                    (0, appendDoubleVectorFromJsArray_1.appendDoubleVectorFromJsArray)(this.webAssemblyContext2D, defaultBaseXValues, this.defaultXValues);
+                }
+                else {
+                    var xValues = Array.from(Array(this.visibleRange.diff), function (_, i) { return _this.defaultXStart + i * _this.defaultXStep; });
+                    (0, appendDoubleVectorFromJsArray_1.appendDoubleVectorFromJsArray)(this.webAssemblyContext2D, defaultBaseXValues, xValues);
+                }
+                coordCalc.baseXValues = defaultBaseXValues;
+            }
+            return;
+        }
         if (renderableSeries.type === SeriesType_1.ESeriesType.UniformHeatmapSeries) {
             throw Error("Category Axis is not supported for UniformHeatmapRenderableSeries");
         }

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

@@ -5,6 +5,11 @@ import { TGridLineStyle, TTextStyle, TTickLineStyle } from "./AxisCore";
  * Optional parameters passed to {@link AxisCore} constructor to set defaults at construction time
  */
 export interface IAxisCoreOptions {
+    /**
+     * When true, 32-bit faster paths for coordinate calculation maths are used. This improves performance in
+     * edge-cases where every CPU cycle counts.
+     */
+    allowFastMath?: boolean;
     /**
      * The VisibleRange is the range of the Axis (min to max).
      * @description

package/Charting/Visuals/Axis/LabelProvider/LabelCache.js

@@ -72,7 +72,7 @@ var clearCacheByStyle = function (styleId) {
         }
     }
 };
-var maxSize = 100;
+var maxSize = 200;
 var minAge = 1000 * 60;
 var lastUsed = 0;
 var getMaxSize = function () { return maxSize; };
@@ -88,7 +88,7 @@ var pruneCache = function () {
     if (labelCacheByTextAndStyle.size > maxSize && lastUsed < latest) {
         try {
             // remove more than we need so we do this less.
-            var toRemove = (labelCacheByTextAndStyle.size - maxSize) * 2;
+            var toRemove = Math.min(Math.floor(labelCacheByTextAndStyle.size / 2), (labelCacheByTextAndStyle.size - maxSize) * 2);
             // Sort the items by LastUsed ascending
             var labels = Array.from(labelCacheByTextAndStyle.entries());
             labels.sort(function (a, b) { return a[1].lastUsed - b[1].lastUsed; });