scichart 3.0.317 → 3.1.333

package/Charting/Visuals/Axis/AxisTitleRenderer.js

@@ -1,61 +1,70 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
     };
-    return __assign.apply(this, arguments);
-};
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AxisTitleRenderer = void 0;
-var Rect_1 = require("../../../Core/Rect");
-var Thickness_1 = require("../../../Core/Thickness");
-var AxisAlignment_1 = require("../../../types/AxisAlignment");
-var parseColor_1 = require("../../../utils/parseColor");
-var WebGlPen_1 = require("../../Drawing/WebGlPen");
-var TextureManager_1 = require("../TextureManager/TextureManager");
-/** @ignore */
-var PADDING = {
-    // TOP: 13,
-    // BOTTOM: 8,
-    NO_TITLE: 0
-};
+var LabelAlignment_1 = require("../../../types/LabelAlignment");
+var TextStyle_1 = require("../../../types/TextStyle");
+var TitleRenderer_1 = require("../../Services/TitleRenderer");
 /**
  * Draws an axis title using our WebGL Rendering engine
  */
-var AxisTitleRenderer = /** @class */ (function () {
-    function AxisTitleRenderer(webAssemblyContext) {
-        this.viewRect = Rect_1.Rect.createZero();
-        this.text = "";
-        this.lineSpacing = 1.1;
-        this.desiredHeightProperty = 0;
-        this.desiredWidthProperty = 0;
-        this.webAssemblyContext = webAssemblyContext;
-        this.textureManager = new TextureManager_1.TextureManager(webAssemblyContext);
+var AxisTitleRenderer = /** @class */ (function (_super) {
+    __extends(AxisTitleRenderer, _super);
+    function AxisTitleRenderer() {
+        var _this = _super !== null && _super.apply(this, arguments) || this;
+        _this.lineSpacing = 1.1;
+        return _this;
     }
-    AxisTitleRenderer.prototype.measure = function (textStyle, isHorizontal) {
-        var _a, _b, _c, _d;
-        var lines = Array.isArray(this.text) ? this.text.length : 1;
-        var lineWithSpacing = lines > 1 ? 1 + this.lineSpacing * (lines - 1) : lines;
-        if (isHorizontal) {
-            this.desiredHeightProperty = this.text
-                ? lineWithSpacing * (0, TextureManager_1.measureTextHeight)(textStyle.fontSize) +
-                    ((_a = textStyle === null || textStyle === void 0 ? void 0 : textStyle.padding) === null || _a === void 0 ? void 0 : _a.bottom) +
-                    ((_b = textStyle === null || textStyle === void 0 ? void 0 : textStyle.padding) === null || _b === void 0 ? void 0 : _b.top)
-                : PADDING.NO_TITLE;
-        }
-        else {
-            this.desiredWidthProperty = this.text
-                ? lineWithSpacing * (0, TextureManager_1.measureTextHeight)(textStyle.fontSize) +
-                    ((_c = textStyle === null || textStyle === void 0 ? void 0 : textStyle.padding) === null || _c === void 0 ? void 0 : _c.left) +
-                    ((_d = textStyle === null || textStyle === void 0 ? void 0 : textStyle.padding) === null || _d === void 0 ? void 0 : _d.right)
-                : PADDING.NO_TITLE;
+    AxisTitleRenderer.prototype.measure = function (text, textStyle, axisAlignment) {
+        if (text === void 0) { text = ""; }
+        this.text = text;
+        var shouldUpdateTextSize = !this.useCache ||
+            (!this.texture && !this.useNativeText) ||
+            this.text !== this.previousText ||
+            this.lineSpacing !== this.previousLineSpacing ||
+            axisAlignment !== this.previousAxisAlignment ||
+            this.previousNativeTextMode !== this.useNativeText ||
+            !checkAreEqualTextStyles(textStyle, this.textStyle);
+        if (shouldUpdateTextSize) {
+            this.invalidateCache();
+            this.previousLineSpacing = this.lineSpacing;
+            this.previousNativeTextMode = this.useNativeText;
+            this.previousAxisAlignment = axisAlignment;
+            this.previousText = text;
+            this.textStyle = textStyle;
+            this.titlePosition = TextStyle_1.ETitlePosition[axisAlignment];
+            this.textStyle = textStyle;
+            // @ts-ignore mismatch with TTextStyle
+            this.textStyle.lineSpacing = this.lineSpacing;
+            var renderContext = this.parentSurface.currentWebGlRenderContext;
+            // @ts-ignore mismatch with TTextStyle
+            this.getTextSize(text, this.textStyle, renderContext);
         }
     };
+    Object.defineProperty(AxisTitleRenderer.prototype, "useNativeText", {
+        get: function () {
+            return this.useNativeTextProperty;
+        },
+        set: function (value) {
+            this.useNativeTextProperty = value;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(AxisTitleRenderer.prototype, "desiredHeight", {
         get: function () {
             return this.desiredHeightProperty;
@@ -77,52 +86,55 @@ var AxisTitleRenderer = /** @class */ (function () {
         configurable: true
     });
     AxisTitleRenderer.prototype.layout = function (rect) {
-        this.viewRect = rect;
-    };
-    AxisTitleRenderer.prototype.getTitleTexture = function (text, textStyle, textureManager) {
-        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);
-    };
-    AxisTitleRenderer.prototype.draw = function (renderContext, textStyle, axisAlignment, debugRendering) {
-        if (!this.text)
+        if (!this.text) {
+            this.viewRectProperty = rect;
             return;
-        var nativeContext = renderContext.getNativeContext();
-        var _a = this.getTitleTexture(this.text, textStyle, this.textureManager), bitmapTexture = _a.bitmapTexture, textureHeight = _a.textureHeight, textureWidth = _a.textureWidth;
-        var padding = textStyle.padding;
-        if (axisAlignment === AxisAlignment_1.EAxisAlignment.Top || axisAlignment === AxisAlignment_1.EAxisAlignment.Bottom) {
-            var deltaToCenter = (this.viewRect.width - textureWidth) / 2;
-            var xPositionCenter = this.viewRect.x + deltaToCenter;
-            var yPosition = this.viewRect.y + (padding === null || padding === void 0 ? void 0 : padding.top);
-            // (axisAlignment === EAxisAlignment.Bottom ? padding?.top : padding?.bottom);
-            nativeContext.DrawTexture(bitmapTexture, Math.round(xPositionCenter), Math.round(yPosition), textureWidth, textureHeight);
-            // for debugging width and height measure
-            if (debugRendering) {
-                var pen = new WebGlPen_1.WebGlPen(new this.webAssemblyContext.SCRTPen((0, parseColor_1.parseColorToUIntArgb)("Red"), 1, true));
-                renderContext.drawRect(new Rect_1.Rect(xPositionCenter, yPosition, textureWidth, textureHeight), Rect_1.Rect.create(0, 0, 999, 999), pen);
-                pen.delete();
-            }
-            // End debug
         }
-        if (axisAlignment === AxisAlignment_1.EAxisAlignment.Left) {
-            nativeContext.PushMatrix();
-            nativeContext.Rotate(-90);
-            var deltaToCenter = (this.viewRect.height - textureWidth) / 2;
-            var xPositionCenter = -(this.viewRect.y + this.viewRect.height) + deltaToCenter;
-            nativeContext.Translate(Math.round(xPositionCenter), Math.round(this.viewRect.x + (padding === null || padding === void 0 ? void 0 : padding.left)));
-            nativeContext.DrawTexture(bitmapTexture, 0, 0, textureWidth, textureHeight);
-            nativeContext.PopMatrix();
+        var alignment = convertLabelAlignmentToTextAlignment(this.textStyle.alignment);
+        this.viewRectProperty = this.getViewRect(this.text, rect, this.titlePosition, alignment);
+    };
+    AxisTitleRenderer.prototype.getTitleTexture = function () {
+        var position = this.titlePosition;
+        var adjRotation = 0;
+        // let adjRotation = this.textStyle.rotation;
+        if (position === TextStyle_1.ETitlePosition.Left) {
+            adjRotation += -90;
         }
-        if (axisAlignment === AxisAlignment_1.EAxisAlignment.Right) {
-            nativeContext.PushMatrix();
-            nativeContext.Rotate(90);
-            var deltaToCenter = (this.viewRect.height - textureWidth) / 2;
-            var xPositionCenter = this.viewRect.y + deltaToCenter;
-            nativeContext.Translate(Math.round(xPositionCenter), Math.round(-(this.viewRect.x + this.viewRect.width) + (padding === null || padding === void 0 ? void 0 : padding.right)));
-            nativeContext.DrawTexture(bitmapTexture, 0, 0, textureWidth, textureHeight);
-            nativeContext.PopMatrix();
+        else if (position === TextStyle_1.ETitlePosition.Right) {
+            adjRotation += 90;
         }
-        bitmapTexture.delete();
+        var titleText = Array.isArray(this.text) ? this.text : this.text.split("\n");
+        var texture = this.textureManager.createTextTexture(titleText, 
+        // @ts-ignore mismatch with TTextStyle
+        this.textStyle, 
+        // { ...this.textStyle, padding: new Thickness(0, 0, 0, 0) },
+        adjRotation, this.lineSpacing);
+        return texture;
+    };
+    AxisTitleRenderer.prototype.draw = function (renderContext) {
+        return this.drawInternal(renderContext, this.useNativeText, this.titlePosition);
     };
     return AxisTitleRenderer;
-}());
+}(TitleRenderer_1.TitleRendererBase));
 exports.AxisTitleRenderer = AxisTitleRenderer;
+var checkAreEqualTextStyles = function (style1, style2) {
+    if (!style1 || !style2) {
+        return false;
+    }
+    return (style1.color === style2.color &&
+        style1.fontFamily === style2.fontFamily &&
+        style1.fontSize === style2.fontSize &&
+        style1.fontStyle === style2.fontStyle &&
+        style1.fontWeight === style2.fontWeight &&
+        style1.alignment === style2.alignment &&
+        style1.multilineAlignment === style2.multilineAlignment &&
+        ((style1.padding === undefined && style2.padding === undefined) || style1.padding.equals(style2.padding)));
+};
+// TODO consider refactoring
+// helper function used to unify title renderer types & interfaces
+var convertLabelAlignmentToTextAlignment = function (alignment) {
+    if (alignment === LabelAlignment_1.ELabelAlignment.Auto) {
+        return TextStyle_1.ETextAlignment.Center;
+    }
+    return TextStyle_1.ETextAlignment[alignment];
+};

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

@@ -113,6 +113,7 @@ var pruneCache = function () {
 };
 var checkTextStyleEqual = function (style1, style2) {
     return (style1.alignment === style2.alignment &&
+        style1.multilineAlignment === style2.multilineAlignment &&
         style1.color === style2.color &&
         style1.fontFamily === style2.fontFamily &&
         style1.fontSize === style2.fontSize &&

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