scichart 3.0.317 → 3.1.329

package/Charting/Themes/IThemeProvider.d.ts

@@ -234,6 +234,11 @@ export interface IThemeProvider {
      * @remarks Acceptable values include RGB format e.g. ```#FF0000```, RGBA format e.g. ```#FF000077`` and RGBA format e.g. ```rgba(255,0,0,0.5)```
      */
     axisTitleColor: string;
+    /**
+     * The default Chart Title color applied as an HTML color code
+     * @remarks Acceptable values include RGB format e.g. ```#FF0000```, RGBA format e.g. ```#FF000077`` and RGBA format e.g. ```rgba(255,0,0,0.5)```
+     */
+    chartTitleColor: string;
     /**
      * The default shadow effect color applied to drop-shadows
      * @remarks Acceptable values include RGB format e.g. ```#FF0000```, RGBA format e.g. ```#FF000077`` and RGBA format e.g. ```rgba(255,0,0,0.5)```
@@ -468,6 +473,11 @@ export interface IThemePartial {
      * @remarks Acceptable values include RGB format e.g. ```#FF0000```, RGBA format e.g. ```#FF000077`` and RGBA format e.g. ```rgba(255,0,0,0.5)```
      */
     axisTitleColor?: string;
+    /**
+     * The default Chart Title color applied as an HTML color code
+     * @remarks Acceptable values include RGB format e.g. ```#FF0000```, RGBA format e.g. ```#FF000077`` and RGBA format e.g. ```rgba(255,0,0,0.5)```
+     */
+    chartTitleColor?: string;
     /**
      * The default shadow effect color applied to drop-shadows
      * @remarks Acceptable values include RGB format e.g. ```#FF0000```, RGBA format e.g. ```#FF000077`` and RGBA format e.g. ```rgba(255,0,0,0.5)```
@@ -536,6 +546,7 @@ export declare abstract class ThemeProvider implements IThemeProvider {
     abstract impulseFillBrush: string;
     abstract defaultColorMapBrush: TGradientStop[];
     abstract axisTitleColor: string;
+    abstract chartTitleColor: string;
     abstract shadowEffectColor: string;
     abstract planeBorderColor: string;
     abstract axisPlaneBackgroundFill: string;
@@ -745,6 +756,11 @@ export declare abstract class ThemeProvider implements IThemeProvider {
          * @remarks Acceptable values include RGB format e.g. ```#FF0000```, RGBA format e.g. ```#FF000077`` and RGBA format e.g. ```rgba(255,0,0,0.5)```
          */
         axisTitleColor?: string;
+        /**
+         * The default Chart Title color applied as an HTML color code
+         * @remarks Acceptable values include RGB format e.g. ```#FF0000```, RGBA format e.g. ```#FF000077`` and RGBA format e.g. ```rgba(255,0,0,0.5)```
+         */
+        chartTitleColor?: string;
         /**
          * The default shadow effect color applied to drop-shadows
          * @remarks Acceptable values include RGB format e.g. ```#FF0000```, RGBA format e.g. ```#FF000077`` and RGBA format e.g. ```rgba(255,0,0,0.5)```

package/Charting/Themes/SciChartJSDarkTheme.d.ts

@@ -122,6 +122,8 @@ export declare class SciChartJSDarkTheme extends ThemeProvider {
     /** @inheritDoc */
     axisTitleColor: string;
     /** @inheritDoc */
+    chartTitleColor: string;
+    /** @inheritDoc */
     shadowEffectColor: string;
     /** @inheritDoc */
     planeBorderColor: string;

package/Charting/Themes/SciChartJSDarkTheme.js

@@ -144,6 +144,8 @@ var SciChartJSDarkTheme = /** @class */ (function (_super) {
         /** @inheritDoc */
         _this.axisTitleColor = "#C8C7C3FF";
         /** @inheritDoc */
+        _this.chartTitleColor = "#C8C7C3FF";
+        /** @inheritDoc */
         _this.shadowEffectColor = "#000000FF";
         /** @inheritDoc */
         _this.planeBorderColor = "#333333FF";

package/Charting/Themes/SciChartJSLightTheme.d.ts

@@ -126,6 +126,8 @@ export declare class SciChartJSLightTheme extends ThemeProvider {
     /** @inheritDoc */
     axisTitleColor: string;
     /** @inheritDoc */
+    chartTitleColor: string;
+    /** @inheritDoc */
     shadowEffectColor: string;
     /** @inheritDoc */
     planeBorderColor: string;

package/Charting/Themes/SciChartJSLightTheme.js

@@ -148,6 +148,8 @@ var SciChartJSLightTheme = /** @class */ (function (_super) {
         /** @inheritDoc */
         _this.axisTitleColor = "#777777FF";
         /** @inheritDoc */
+        _this.chartTitleColor = "#777777FF";
+        /** @inheritDoc */
         _this.shadowEffectColor = "#A0AABAFA";
         /** @inheritDoc */
         _this.planeBorderColor = "#EEEEEEFF";

package/Charting/Visuals/Annotations/NativeTextAnnotation.js

@@ -360,11 +360,7 @@ var NativeTextAnnotation = /** @class */ (function (_super) {
             x1 -= textBounds.m_fWidth;
         }
         if (this.verticalAnchorPointProperty === AnchorPoint_1.EVerticalAnchorPoint.Center) {
-            y1 += textBounds.GetLineBounds(0).m_fHeight / 2;
-            y1 -=
-                ((textBounds.GetLineBounds(0).m_fHeight - textBounds.GetLineBounds(0).m_fOffsetY) *
-                    (textBounds.GetLinesCount() - 1)) /
-                    2;
+            y1 -= textBounds.m_fHeight / 2 - textBounds.GetLineBounds(0).m_fHeight;
         }
         else if (this.verticalAnchorPointProperty === AnchorPoint_1.EVerticalAnchorPoint.Top) {
             y1 += textBounds.GetLineBounds(0).m_fHeight;

package/Charting/Visuals/Annotations/SvgAnnotationBase.js

@@ -297,7 +297,8 @@ var SvgAnnotationBase = /** @class */ (function (_super) {
             return;
         var borderX1 = this.getX1Coordinate(xCalc, yCalc) + this.xCoordShift;
         var borderY1 = this.getY1Coordinate(xCalc, yCalc) + this.yCoordShift;
-        this.svgDOMRect = this.svg.getBoundingClientRect();
+        // @ts-ignore
+        this.svgDOMRect = this.svg.getBBox();
         var borderX2 = borderX1 + this.svgDOMRect.width;
         var borderY2 = borderY1 + this.svgDOMRect.height;
         if (this.verticalAnchorPoint === AnchorPoint_1.EVerticalAnchorPoint.Bottom) {

package/Charting/Visuals/Axis/AxisBase2D.js

@@ -114,7 +114,7 @@ var AxisBase2D = /** @class */ (function (_super) {
             color: SciChartSurfaceBase_1.SciChartSurfaceBase.DEFAULT_THEME.tickTextBrush,
             fontWeight: "normal",
             fontStyle: "normal",
-            padding: Thickness_1.Thickness.fromString("2 4 0 4"),
+            padding: Thickness_1.Thickness.fromString("2 4 2 4"),
             alignment: LabelAlignment_1.ELabelAlignment.Auto
         };
         _this.isInnerAxisProperty = false;
@@ -1226,5 +1226,5 @@ var AxisBase2D = /** @class */ (function (_super) {
 exports.AxisBase2D = AxisBase2D;
 /** @ignore */
 var getPenForLines = function (penCache, stroke, strokeThickness, strokeDashArray) {
-    return (0, Pen2DCache_1.createPenInCache)(penCache, stroke, strokeThickness, 1, strokeDashArray);
+    return (0, Pen2DCache_1.createPenInCache)(penCache, stroke, strokeThickness, 1, strokeDashArray, false);
 };

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

@@ -7,6 +7,7 @@ import { Thickness } from "../../../Core/Thickness";
 import { EAutoRange } from "../../../types/AutoRange";
 import { EAxisType } from "../../../types/AxisType";
 import { ELabelAlignment } from "../../../types/LabelAlignment";
+import { EMultiLineAlignment } from "../../../types/TextPosition";
 import { CoordinateCalculatorBase } from "../../Numerics/CoordinateCalculators/CoordinateCalculatorBase";
 import { TickCoordinatesProvider } from "../../Numerics/TickCoordinateProviders/TickCoordinatesProvider";
 import { TickProvider } from "../../Numerics/TickProviders/TickProvider";
@@ -58,8 +59,15 @@ export declare type TTextStyle = {
      * If you are using text labels rather than just numbers, or when using native text, you may want to increase the bottom padding.
      */
     padding?: Thickness;
-    /** Horizontal label alignment for vertical axes.  Default Auto */
+    /**
+     * Horizontal label alignment for vertical axes. Default Auto.
+     * @privateRemarks This property should only be used for axis labels.
+     * So the current type definition should be changed in future versions, specifically this property may be renamed or removed.
+     * In other cases, e.g. for multiline text alignment use TTextStyle.multilineAlignment
+     */
     alignment?: ELabelAlignment;
+    /** Horizontal text alignment for multiline text. */
+    multilineAlignment?: EMultiLineAlignment;
 };
 /**
  * Interface to minimal set of parameters which define an {@link AxisCore | Axis} in SciChart

package/Charting/Visuals/Axis/AxisRenderer.js

@@ -262,7 +262,7 @@ var AxisRenderer = /** @class */ (function () {
                 try {
                     if (nativeFont) {
                         var tx = xCoord + viewRect.left + padding.left;
-                        var ty = yCoord + viewRect.top + lineHeight - padding.bottom;
+                        var ty = yCoord + viewRect.top + lineHeight + padding.top;
                         var rx = tx;
                         var ry = ty - lineHeight;
                         if (rotationRad !== 0) {
@@ -323,7 +323,7 @@ var AxisRenderer = /** @class */ (function () {
                 try {
                     if (nativeFont) {
                         var tx = xCoord + viewRect.left + padding.left;
-                        var ty = yCoord + viewRect.top + lineHeight - padding.bottom;
+                        var ty = yCoord + viewRect.top + lineHeight + padding.top;
                         nativeFont.DrawStringAdvanced(labelText !== null && labelText !== void 0 ? labelText : "", textColor, Math.round(tx), Math.round(ty), (0, NativeObject_1.getVector4)(this.webAssemblyContext, tx, ty, rotationRad, 0), multiLineAlignment, nativeLineSpacing);
                     }
                     else {

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

@@ -2,15 +2,20 @@ import { Rect } from "../../../Core/Rect";
 import { EAxisAlignment } from "../../../types/AxisAlignment";
 import { TSciChart } from "../../../types/TSciChart";
 import { WebGlRenderContext2D } from "../../Drawing/WebGlRenderContext2D";
-import { TextureManager } from "../TextureManager/TextureManager";
+import { TextureManager, TTextureObject } from "../TextureManager/TextureManager";
 import { TTextStyle } from "./AxisCore";
 /**
  * Draws an axis title using our WebGL Rendering engine
  */
 export declare class AxisTitleRenderer {
+    useCache: boolean;
     viewRect: Rect;
     text: string | string[];
     lineSpacing: number;
+    private previousText;
+    private textStyle;
+    private previousLineSpacing;
+    private texture;
     private webAssemblyContext;
     private desiredHeightProperty;
     private desiredWidthProperty;
@@ -22,6 +27,6 @@ export declare class AxisTitleRenderer {
     get desiredWidth(): number;
     set desiredWidth(value: number);
     layout(rect: Rect): void;
-    getTitleTexture(text: string | string[], textStyle: TTextStyle, textureManager: TextureManager): import("../TextureManager/TextureManager").TTextureObject;
+    getTitleTexture(text: string | string[], textStyle: TTextStyle, textureManager: TextureManager): TTextureObject;
     draw(renderContext: WebGlRenderContext2D, textStyle: TTextStyle, axisAlignment: EAxisAlignment, debugRendering: boolean): void;
 }

package/Charting/Visuals/Axis/AxisTitleRenderer.js

@@ -12,6 +12,7 @@ var __assign = (this && this.__assign) || function () {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AxisTitleRenderer = void 0;
+var Deleter_1 = require("../../../Core/Deleter");
 var Rect_1 = require("../../../Core/Rect");
 var Thickness_1 = require("../../../Core/Thickness");
 var AxisAlignment_1 = require("../../../types/AxisAlignment");
@@ -29,6 +30,7 @@ var PADDING = {
  */
 var AxisTitleRenderer = /** @class */ (function () {
     function AxisTitleRenderer(webAssemblyContext) {
+        this.useCache = true;
         this.viewRect = Rect_1.Rect.createZero();
         this.text = "";
         this.lineSpacing = 1.1;
@@ -80,8 +82,20 @@ var AxisTitleRenderer = /** @class */ (function () {
         this.viewRect = rect;
     };
     AxisTitleRenderer.prototype.getTitleTexture = function (text, textStyle, textureManager) {
+        if (this.useCache &&
+            this.texture &&
+            text === this.previousText &&
+            this.lineSpacing === this.previousLineSpacing &&
+            checkAreEqualTextStyles(textStyle, this.textStyle)) {
+            return this.texture;
+        }
+        this.previousLineSpacing = this.lineSpacing;
+        this.previousText = text;
+        this.textStyle = textStyle;
         var lines = Array.isArray(text) ? text : [text];
-        return textureManager.createTextTexture(lines, __assign(__assign({}, textStyle), { padding: new Thickness_1.Thickness(0, 0, 0, 0) }), 0, this.lineSpacing);
+        var texture = textureManager.createTextTexture(lines, __assign(__assign({}, textStyle), { padding: new Thickness_1.Thickness(0, 0, 0, 0) }), 0, this.lineSpacing);
+        this.texture = texture;
+        return texture;
     };
     AxisTitleRenderer.prototype.draw = function (renderContext, textStyle, axisAlignment, debugRendering) {
         if (!this.text)
@@ -121,8 +135,20 @@ var AxisTitleRenderer = /** @class */ (function () {
             nativeContext.DrawTexture(bitmapTexture, 0, 0, textureWidth, textureHeight);
             nativeContext.PopMatrix();
         }
-        bitmapTexture.delete();
+        if (!this.useCache) {
+            (0, Deleter_1.deleteSafe)(bitmapTexture);
+            this.texture = undefined;
+        }
     };
     return AxisTitleRenderer;
 }());
 exports.AxisTitleRenderer = AxisTitleRenderer;
+var checkAreEqualTextStyles = function (style1, style2) {
+    return (style1.color === style2.color &&
+        style1.fontFamily === style2.fontFamily &&
+        style1.fontSize === style2.fontSize &&
+        style1.fontStyle === style2.fontStyle &&
+        style1.fontWeight === style2.fontWeight &&
+        style1.multilineAlignment === style2.multilineAlignment &&
+        ((style1.padding === undefined && style2.padding === undefined) || style1.padding.equals(style2.padding)));
+};

package/Charting/Visuals/Axis/LabelProvider/LabelProviderBase2D.d.ts

@@ -13,17 +13,12 @@ export declare class LabelInfo {
     textureHeight: number;
     textureWidth: number;
     lastUsed: number;
-    private subs;
     constructor(tick: number, text: string, bitmapTexture: TSRTexture, textureHeight: number, textureWidth: number);
-    registerNotifier(callback: () => void): void;
-    textureUpdated(): void;
 }
 export interface ILabel2DOptions extends ILabelOptions {
     rotation?: number;
     /**
-     * Experimental - set true to enable async label texture creation
-     * Can be set globally using SciChartDefaults.asyncLabels = true;
-     * When false getLabelTexture is used.  When true, getLabelTextureAsync is used.
+     * @deprecated This functionality has been removed. useNativeText: true provides much greater performance benefit.
      */
     asyncLabels?: boolean;
     /**
@@ -53,8 +48,7 @@ export declare abstract class LabelProviderBase2D extends LabelProvider implemen
      */
     useSharedCache: boolean;
     /**
-     * Experimental - set true to enable async label texture creation
-     * Can be set globally using SciChartDefaults.  Currently default false.
+     * @deprecated This functionality has been removed. useNativeText: true provides much greater performance benefit.
      */
     asyncLabels: boolean;
     /**
@@ -132,13 +126,12 @@ export declare abstract class LabelProviderBase2D extends LabelProvider implemen
      */
     getCachedLabelTexture(labelText: string, textureManager: TextureManager, labelStyle: TTextStyle): TTextureObject;
     /**
-     * Create a texture for the given label text asynchronously. This method is called if asyncLabels is true, otherwise getLabelTexture is used.
-     * If overriding this method with useSharedCache = true, consider setting it false for this LabelProvider,
-     * otherwise other axes using the same style and text may see your custom texture. Alternatively you can override getCachedStyle or set styleId directly
+     * @deprecated AsyncLabels have been removed. useNativeText: true provides much greater performance benefit.
+     * If using texture labels override getLabelTexture instead
      */
     getLabelTextureAsync(labelText: string, textureManager: TextureManager, labelStyle: TTextStyle): Promise<TTextureObject>;
     /**
-     * Create a texture for the given label text. This method is called if asyncLabels is false, otherwise getLabelTextureAsync is used.
+     * Create a texture for the given label text. This method is called if useNativeText is false.
      * If overriding this method with useSharedCache = true, consider setting it false for this LabelProvider,
      * otherwise other axes using the same style and text may see your custom texture. Alternatively you can override getCachedStyle or set styleId directly
      */

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

@@ -65,7 +65,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LabelProviderBase2D = exports.LabelInfo = void 0;
 var app_1 = require("../../../../constants/app");
 var guid_1 = require("../../../../utils/guid");
-var TextureWorker_1 = require("../../../Services/Workers/TextureWorker");
 var NativeObject_1 = require("../../Helpers/NativeObject");
 var SciChartDefaults_1 = require("../../SciChartDefaults");
 var TextureManager_1 = require("../../TextureManager/TextureManager");
@@ -73,7 +72,6 @@ var LabelCache_1 = require("./LabelCache");
 var LabelProvider_1 = require("./LabelProvider");
 var LabelInfo = /** @class */ (function () {
     function LabelInfo(tick, text, bitmapTexture, textureHeight, textureWidth) {
-        this.subs = [];
         this.tick = tick;
         this.text = text;
         this.bitmapTexture = bitmapTexture;
@@ -81,13 +79,6 @@ var LabelInfo = /** @class */ (function () {
         this.textureWidth = textureWidth;
         this.lastUsed = Date.now();
     }
-    LabelInfo.prototype.registerNotifier = function (callback) {
-        this.subs.push(callback);
-    };
-    LabelInfo.prototype.textureUpdated = function () {
-        this.subs.forEach(function (notifier) { return notifier(); });
-        this.subs = [];
-    };
     return LabelInfo;
 }());
 exports.LabelInfo = LabelInfo;
@@ -99,7 +90,7 @@ var LabelProviderBase2D = /** @class */ (function (_super) {
     __extends(LabelProviderBase2D, _super);
     function LabelProviderBase2D(options) {
         var _this = this;
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d;
         _this = _super.call(this, options) || this;
         _this.useCache = !app_1.IS_TEST_ENV;
         /**
@@ -114,9 +105,8 @@ var LabelProviderBase2D = /** @class */ (function (_super) {
         _this.providerId = (0, guid_1.generateGuid)();
         _this.rotationProperty = (_a = options === null || options === void 0 ? void 0 : options.rotation) !== null && _a !== void 0 ? _a : _this.rotationProperty;
         _this.lineSpacing = (_b = options === null || options === void 0 ? void 0 : options.lineSpacing) !== null && _b !== void 0 ? _b : _this.lineSpacing;
-        _this.asyncLabels = (_c = options === null || options === void 0 ? void 0 : options.asyncLabels) !== null && _c !== void 0 ? _c : SciChartDefaults_1.SciChartDefaults.asyncLabels;
-        _this.useSharedCache = (_d = options === null || options === void 0 ? void 0 : options.useSharedCache) !== null && _d !== void 0 ? _d : SciChartDefaults_1.SciChartDefaults.useSharedCache;
-        _this.useNativeText = (_e = options === null || options === void 0 ? void 0 : options.useNativeText) !== null && _e !== void 0 ? _e : SciChartDefaults_1.SciChartDefaults.useNativeText;
+        _this.useSharedCache = (_c = options === null || options === void 0 ? void 0 : options.useSharedCache) !== null && _c !== void 0 ? _c : SciChartDefaults_1.SciChartDefaults.useSharedCache;
+        _this.useNativeText = (_d = options === null || options === void 0 ? void 0 : options.useNativeText) !== null && _d !== void 0 ? _d : SciChartDefaults_1.SciChartDefaults.useNativeText;
         return _this;
     }
     Object.defineProperty(LabelProviderBase2D.prototype, "rotation", {
@@ -337,69 +327,32 @@ var LabelProviderBase2D = /** @class */ (function (_super) {
      * @returns A TTextureObject containing the bitmapTexture and the size
      */
     LabelProviderBase2D.prototype.getCachedLabelTexture = function (labelText, textureManager, labelStyle) {
-        var _this = this;
         var _a;
         var cachedLabel = LabelCache_1.labelCache.getLabel(labelText, this.styleId);
         if (cachedLabel) {
-            if (cachedLabel.textureWidth === undefined) {
-                // Log when this texture request was made. Kill and restart if too old
-                // Make sure this chart redraws if it is waiting on a label that was requested by a different chart
-                cachedLabel.registerNotifier(function () { return _super.prototype.invalidateParent.call(_this); });
-            }
             return {
                 textureWidth: (_a = cachedLabel.textureWidth) !== null && _a !== void 0 ? _a : null,
                 textureHeight: cachedLabel.textureHeight,
                 bitmapTexture: cachedLabel.bitmapTexture
             };
         }
-        else if (this.asyncLabels) {
-            // Capture the styleId as it might have changed by the time the result comes in.
-            var callBackStyleId_1 = this.styleId;
-            this.getLabelTextureAsync(labelText, textureManager, labelStyle).then(function (result) {
-                var cached = LabelCache_1.labelCache.getLabel(labelText, callBackStyleId_1);
-                // This may not exist if the target chart has been deleted already.
-                if (cached) {
-                    cached.textureHeight = result.textureHeight;
-                    cached.textureWidth = result.textureWidth;
-                    cached.bitmapTexture = result.bitmapTexture;
-                    cached.textureUpdated();
-                    // this.invalidateParent also clears cache, which we don't want here.
-                    _super.prototype.invalidateParent.call(_this);
-                }
-            });
-            return {
-                textureWidth: undefined,
-                textureHeight: undefined,
-                bitmapTexture: undefined
-            };
-        }
         else {
             return this.getLabelTexture(labelText, textureManager, labelStyle);
         }
     };
     /**
-     * Create a texture for the given label text asynchronously. This method is called if asyncLabels is true, otherwise getLabelTexture is used.
-     * If overriding this method with useSharedCache = true, consider setting it false for this LabelProvider,
-     * otherwise other axes using the same style and text may see your custom texture. Alternatively you can override getCachedStyle or set styleId directly
+     * @deprecated AsyncLabels have been removed. useNativeText: true provides much greater performance benefit.
+     * If using texture labels override getLabelTexture instead
      */
     LabelProviderBase2D.prototype.getLabelTextureAsync = function (labelText, textureManager, labelStyle) {
         return __awaiter(this, void 0, void 0, function () {
-            var image;
             return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (!TextureWorker_1.textureWorker.isActive) return [3 /*break*/, 2];
-                        return [4 /*yield*/, TextureWorker_1.textureWorker.measureAndGetImageData([labelText], labelStyle, this.rotationProperty)];
-                    case 1:
-                        image = _a.sent();
-                        return [2 /*return*/, textureManager.createTextureFromImageData(image.imageData, image.textureWidth, image.textureHeight)];
-                    case 2: return [2 /*return*/, this.getLabelTexture(labelText, textureManager, labelStyle)];
-                }
+                return [2 /*return*/, this.getLabelTexture(labelText, textureManager, labelStyle)];
             });
         });
     };
     /**
-     * Create a texture for the given label text. This method is called if asyncLabels is false, otherwise getLabelTextureAsync is used.
+     * Create a texture for the given label text. This method is called if useNativeText is false.
      * If overriding this method with useSharedCache = true, consider setting it false for this LabelProvider,
      * otherwise other axes using the same style and text may see your custom texture. Alternatively you can override getCachedStyle or set styleId directly
      */
@@ -421,7 +374,7 @@ var LabelProviderBase2D = /** @class */ (function (_super) {
         var options = {
             rotation: this.rotation,
             lineSpacing: this.lineSpacing,
-            asyncLabels: this.asyncLabels,
+            asyncLabels: false,
             useSharedCache: this.useSharedCache,
             useNativeText: this.useNativeText
         };

package/Charting/Visuals/Axis/LabelProvider/TextLabelProvider.d.ts

@@ -49,7 +49,6 @@ export declare class TextLabelProvider extends LabelProviderBase2D {
     set maxLength(value: number);
     onBeginAxisDraw(): void;
     getLabelWidth(ctx: CanvasRenderingContext2D, labelText: string, labelStyle?: TTextStyle): number;
-    getLabelTextureAsync(labelText: string, textureManager: TextureManager, labelStyle: TTextStyle): Promise<import("../../TextureManager/TextureManager").TTextureObject>;
     getLabelTexture(labelText: string, textureManager: TextureManager, labelStyle: TTextStyle): import("../../TextureManager/TextureManager").TTextureObject;
     /**
      * Wraps the label text and returns it as a string with newlines

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

@@ -25,46 +25,9 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (_) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.wrapText = exports.TextLabelProvider = void 0;
 var LabelProviderType_1 = require("../../../../types/LabelProviderType");
-var TextureWorker_1 = require("../../../Services/Workers/TextureWorker");
 var TextureManager_1 = require("../../TextureManager/TextureManager");
 var LabelCache_1 = require("./LabelCache");
 var LabelProviderBase2D_1 = require("./LabelProviderBase2D");
@@ -150,29 +113,6 @@ var TextLabelProvider = /** @class */ (function (_super) {
                 labelStyle.padding.right);
         }
     };
-    TextLabelProvider.prototype.getLabelTextureAsync = function (labelText, textureManager, labelStyle) {
-        return __awaiter(this, void 0, void 0, function () {
-            var image;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (!TextureWorker_1.textureWorker.isActive) return [3 /*break*/, 5];
-                        image = void 0;
-                        if (!Array.isArray(labelText)) return [3 /*break*/, 2];
-                        return [4 /*yield*/, TextureWorker_1.textureWorker.measureAndGetImageData(labelText, labelStyle, this.rotation, this.lineSpacing)];
-                    case 1:
-                        image = _a.sent();
-                        return [3 /*break*/, 4];
-                    case 2: return [4 /*yield*/, TextureWorker_1.textureWorker.measureAndGetImageData([labelText], labelStyle, this.rotation, this.lineSpacing)];
-                    case 3:
-                        image = _a.sent();
-                        _a.label = 4;
-                    case 4: return [2 /*return*/, textureManager.createTextureFromImageData(image.imageData, image.textureWidth, image.textureHeight)];
-                    case 5: return [2 /*return*/, this.getLabelTexture(labelText, textureManager, labelStyle)];
-                }
-            });
-        });
-    };
     TextLabelProvider.prototype.getLabelTexture = function (labelText, textureManager, labelStyle) {
         var lines = labelText.split("\n");
         return textureManager.createTextTexture(lines, labelStyle, this.rotation, this.lineSpacing);

package/Charting/Visuals/I2DSurfaceOptions.d.ts

@@ -3,6 +3,7 @@ import { Rect } from "../../Core/Rect";
 import { Thickness } from "../../Core/Thickness";
 import { EAutoColorMode } from "../../types/AutoColorMode";
 import { TBorder } from "../../types/TBorder";
+import { TChartTitleStyle } from "../../types/TextStyle";
 import { ECoordinateMode } from "./Annotations/AnnotationBase";
 import { ISurfaceOptionsBase } from "./SciChartSurfaceBase";
 /**
@@ -45,6 +46,14 @@ export interface I2DSurfaceOptions extends ISurfaceOptionsBase {
      * Optional - An {@link EAutoColorMode} which controls how often series colours set to AUTO_COLOR will be resolved.  Default OnAddRemoveSeries
      */
     autoColorMode?: EAutoColorMode;
+    /**
+     * Optional a title for the SciChartSurface
+     */
+    title?: string | string[];
+    /**
+     * The title text style and placement for the SciChartSurface as {@link TChartTitleStyle}
+     */
+    titleStyle?: TChartTitleStyle;
 }
 export interface I2DSubSurfaceOptions extends I2DSurfaceOptions {
     /**

package/Charting/Visuals/RenderableSeries/FastColumnRenderableSeries.d.ts

@@ -92,11 +92,11 @@ export declare class FastColumnRenderableSeries extends BaseRenderableSeries {
      */
     set zeroLineY(zeroLineY: number);
     /**
-     * Gets or sets the width of candles as a fraction of available space. Valid values range from 0.0 - 1.0
+     * Gets or sets the width of columns as a fraction of available space. Valid values range from 0.0 - 1.0
      */
     get dataPointWidth(): number;
     /**
-     * Gets or sets the width of candles as a fraction of available space. Valid values range from 0.0 - 1.0
+     * Gets or sets the width of columns as a fraction of available space. Valid values range from 0.0 - 1.0
      */
     set dataPointWidth(dataPointWidth: number);
     /**

package/Charting/Visuals/RenderableSeries/FastColumnRenderableSeries.js

@@ -145,13 +145,13 @@ var FastColumnRenderableSeries = /** @class */ (function (_super) {
     });
     Object.defineProperty(FastColumnRenderableSeries.prototype, "dataPointWidth", {
         /**
-         * Gets or sets the width of candles as a fraction of available space. Valid values range from 0.0 - 1.0
+         * Gets or sets the width of columns as a fraction of available space. Valid values range from 0.0 - 1.0
          */
         get: function () {
             return this.dataPointWidthProperty;
         },
         /**
-         * Gets or sets the width of candles as a fraction of available space. Valid values range from 0.0 - 1.0
+         * Gets or sets the width of columns as a fraction of available space. Valid values range from 0.0 - 1.0
          */
         set: function (dataPointWidth) {
             this.dataPointWidthProperty = dataPointWidth;

package/Charting/Visuals/SciChartDefaults.d.ts

@@ -1,8 +1,7 @@
 import { EWatermarkPosition } from "../../types/WatermarkPosition";
 export declare class SciChartDefaults {
     /**
-     * Experimental - set true to enable async label texture creation
-     * Can also be set on individual labelProviders.
+     * @deprecated This functionality has been removed. useNativeText: true provides much greater performance benefit.
      */
     static asyncLabels: boolean;
     /**
@@ -18,7 +17,7 @@ export declare class SciChartDefaults {
      */
     static performanceWarnings: boolean;
     /**
-     * Experimental - set true to use native text for axes.  Not all text features currently supported
+     * Experimental - set true to use native text for axes and titles.  Not all text features currently supported
      */
     static useNativeText: boolean;
     /**

package/Charting/Visuals/SciChartDefaults.js

@@ -6,8 +6,7 @@ var SciChartDefaults = /** @class */ (function () {
     function SciChartDefaults() {
     }
     /**
-     * Experimental - set true to enable async label texture creation
-     * Can also be set on individual labelProviders.
+     * @deprecated This functionality has been removed. useNativeText: true provides much greater performance benefit.
      */
     SciChartDefaults.asyncLabels = false;
     /**
@@ -23,7 +22,7 @@ var SciChartDefaults = /** @class */ (function () {
      */
     SciChartDefaults.performanceWarnings = true;
     /**
-     * Experimental - set true to use native text for axes.  Not all text features currently supported
+     * Experimental - set true to use native text for axes and titles.  Not all text features currently supported
      */
     SciChartDefaults.useNativeText = false;
     /**