scichart 3.2.0-beta → 3.2.442

package/Charting/Visuals/SciChartSurface.js

@@ -148,11 +148,6 @@ var SciChartSurface = /** @class */ (function (_super) {
          * Used internally - the {@link RenderContext2D} for drawing
          */
         //public renderContext2D: RenderContext2D;
-        /**
-         * An event handler which notifies its subscribers when a render operation has finished. Use this
-         * to time render performance, or to update elements of the chart or your UI on redraw.
-         */
-        _this.rendered = new EventHandler_1.EventHandler();
         /**
          * An event handler which notifies its subscribers when a render operation starts. Use this
          * to update elements of the chart for the current render.  Any updates made here will not trigger a subsequent render.
@@ -639,7 +634,7 @@ var SciChartSurface = /** @class */ (function (_super) {
      * @inheritDoc
      */
     SciChartSurface.prototype.changeViewportSize = function (pixelWidth, pixelHeight) {
-        if (!pixelWidth || !pixelHeight) {
+        if (!pixelWidth || !pixelHeight || this.isDeleted) {
             return;
         }
         // Changing the viewportSize
@@ -683,6 +678,8 @@ var SciChartSurface = /** @class */ (function (_super) {
     };
     // Step_5: Get context and pass drawing to SciChartRenderer
     SciChartSurface.prototype.doDrawingLoop = function (context) {
+        if (this.isDeleted)
+            return;
         context = context !== null && context !== void 0 ? context : this.renderSurface.getRenderContext();
         this.currentWebGlRenderContextProperty = context;
         try {
@@ -717,10 +714,7 @@ var SciChartSurface = /** @class */ (function (_super) {
                 (0, NativeObject_1.freeCache)(this.webAssemblyContext2D).delete();
             }
             else if (this.domChartRoot) {
-                console.error("Error from chart in div ".concat(this.domChartRoot.id), err);
-                if (typeof err !== "string" && (err === null || err === void 0 ? void 0 : err.message)) {
-                    console.error(err === null || err === void 0 ? void 0 : err.message);
-                }
+                console.error("Error from chart in div ".concat(this.domChartRoot.id, ":"), err);
             }
             else {
                 // Surface the error for tests
@@ -734,8 +728,13 @@ var SciChartSurface = /** @class */ (function (_super) {
     SciChartSurface.prototype.delete = function (clearHtml) {
         if (clearHtml === void 0) { clearHtml = true; }
         if (this.isDeleted) {
-            if (process.env.NODE_ENV !== "production") {
-                console.warn("Trying to delete the surface with ID = \"".concat(this.id, ")\", which has already been deleted!"));
+            try {
+                if (process.env.NODE_ENV !== "production") {
+                    console.warn("Trying to delete the surface with ID = \"".concat(this.id, ")\", which has already been deleted!"));
+                }
+            }
+            catch (err) {
+                console.warn(err);
             }
             return;
         }

package/Charting/Visuals/SciChartSurfaceBase.d.ts

@@ -5,6 +5,7 @@ import { MouseManager } from "../../Core/Mouse/MouseManager";
 import { ObservableArray } from "../../Core/ObservableArray";
 import { PropertyChangedEventArgs } from "../../Core/PropertyChangedEventArgs";
 import { Rect } from "../../Core/Rect";
+import { Thickness } from "../../Core/Thickness";
 import { EThemeProviderType } from "../../types/ThemeProviderType";
 import { TSciChart } from "../../types/TSciChart";
 import { TSciChart3D } from "../../types/TSciChart3D";
@@ -105,6 +106,11 @@ export interface ISciChartSurfaceBase extends IDeletable, IThemeable {
     addDeletable(deletable: IDeletable): void;
     invalidateElement(): void;
     delete(clearHtml?: boolean): void;
+    /**
+     * An event handler which notifies its subscribers when a render operation has finished. Use this
+     * to time render performance, or to update elements of the chart or your UI on redraw.
+     */
+    rendered: EventHandler<void>;
 }
 /**
  * Enum constants to specify SciChartSurface type
@@ -143,10 +149,16 @@ export declare abstract class SciChartSurfaceBase extends DeletableEntity implem
      * chart parts are automatically anti-aliased
      */
     static AntiAliasWebGlBackbuffer: boolean;
+    /**
+     * Defines a delay of the shared wasmContext auto-dispose if {@link autoDisposeWasmContext} is enabled.
+     */
     static wasmContextDisposeTimeout: number;
+    /**
+     * Defines if the shared wasmContext ({@link TSciChart | WebAssembly Context}) should be deleted after all of the surfaces that use it are deleted.
+     */
     static autoDisposeWasmContext: boolean;
     /**
-     * Deletes a {@link TSciChart | WebAssembly Context} used by the charts instantiated with wasmContext {@link SciChartSurface.create}.
+     * Deletes the shared wasmContext ({@link TSciChart | WebAssembly Context}) used by the charts instantiated with {@link SciChartSurface.create} or {@link SciChart3DSurface.create}.
      */
     static disposeSharedWasmContext(): void;
     /**
@@ -245,6 +257,11 @@ export declare abstract class SciChartSurfaceBase extends DeletableEntity implem
      */
     readonly modifierAnnotations: ObservableArray<IAnnotation>;
     adornerLayer: AdornerLayer;
+    /**
+     * An event handler which notifies its subscribers when a render operation has finished. Use this
+     * to time render performance, or to update elements of the chart or your UI on redraw.
+     */
+    rendered: EventHandler<void>;
     protected destinations: TSciChartDestination[];
     protected themeProviderProperty: IThemeProvider;
     protected previousThemeProviderProperty: IThemeProvider;
@@ -352,6 +369,7 @@ export declare abstract class SciChartSurfaceBase extends DeletableEntity implem
      * engine will schedule a redraw a the next time the renderer is free.
      */
     abstract invalidateElement(): void;
+    abstract getSeriesViewRectPadding(scaled: boolean): Thickness;
     getMainCanvas(): HTMLCanvasElement;
     /**
      * Sets the Series View {@link Rect}, a rectangle relative to the entire size of the {@link SciChartSurfaceBase}

package/Charting/Visuals/SciChartSurfaceBase.js

@@ -68,6 +68,11 @@ var SciChartSurfaceBase = /** @class */ (function (_super) {
     function SciChartSurfaceBase(webAssemblyContext, canvases) {
         if (canvases === void 0) { canvases = {}; }
         var _this = _super.call(this) || this;
+        /**
+         * An event handler which notifies its subscribers when a render operation has finished. Use this
+         * to time render performance, or to update elements of the chart or your UI on redraw.
+         */
+        _this.rendered = new EventHandler_1.EventHandler();
         _this.themeProviderProperty = SciChartSurfaceBase.DEFAULT_THEME;
         _this.previousThemeProviderProperty = SciChartSurfaceBase.DEFAULT_THEME;
         _this.isInitializedProperty = false;
@@ -123,39 +128,50 @@ var SciChartSurfaceBase = /** @class */ (function (_super) {
         // Setup Dpi change listeners
         _this.onDpiChanged = _this.onDpiChanged.bind(_this);
         DpiHelper_1.DpiHelper.dpiChanged.subscribe(_this.onDpiChanged);
-        if (process.env.NODE_ENV !== "production") {
-            if (MemoryUsageHelper_1.MemoryUsageHelper.isMemoryUsageDebugEnabled) {
-                var rootContainer = document.body;
-                var observer_1 = new MutationObserver(function () {
-                    var isInDom = _this.domChartRoot.isConnected;
-                    if (!isInDom && !_this.isDeleted) {
-                        console.warn("The chart root element \"".concat(_this.domChartRoot.id, "\" was detached before the surface ").concat(_this.id, " was properly disposed! Make sure to call \"delete\" method on the surface when it is not longer needed."));
-                    }
-                });
-                observer_1.observe(rootContainer, { childList: true, subtree: true });
-                _this.addDeletable({
-                    delete: function () { return observer_1.disconnect(); }
-                });
+        try {
+            if (process.env.NODE_ENV !== "production") {
+                if (MemoryUsageHelper_1.MemoryUsageHelper.isMemoryUsageDebugEnabled) {
+                    var rootContainer = document.body;
+                    var observer_1 = new MutationObserver(function () {
+                        var isInDom = _this.domChartRoot.isConnected;
+                        if (!isInDom && !_this.isDeleted) {
+                            console.warn("The chart root element \"".concat(_this.domChartRoot.id, "\" was detached before the surface ").concat(_this.id, " was properly disposed! Make sure to call \"delete\" method on the surface when it is not longer needed."));
+                        }
+                    });
+                    observer_1.observe(rootContainer, { childList: true, subtree: true });
+                    _this.addDeletable({
+                        delete: function () { return observer_1.disconnect(); }
+                    });
+                }
             }
         }
+        catch (err) {
+            console.warn(err);
+        }
         return _this;
     }
     /**
-     * Deletes a {@link TSciChart | WebAssembly Context} used by the charts instantiated with wasmContext {@link SciChartSurface.create}.
+     * Deletes the shared wasmContext ({@link TSciChart | WebAssembly Context}) used by the charts instantiated with {@link SciChartSurface.create} or {@link SciChart3DSurface.create}.
      */
     SciChartSurfaceBase.disposeSharedWasmContext = function () {
         if (Globals_1.sciChart3DDestinations.length === 0 && Globals_1.sciChartDestinations.length === 0) {
-            document.body.removeChild(SciChartSurfaceBase.domMasterCanvas);
-            SciChartSurfaceBase.domMasterCanvas = undefined;
-        }
-        if (process.env.NODE_ENV !== "production") {
-            if (MemoryUsageHelper_1.MemoryUsageHelper.isMemoryUsageDebugEnabled) {
-                // @ts-ignore
-                window.gc && window.gc();
-                // TODO add warning if there are undeleted or uncollected entities instead
-                // MemoryUsageHelper.objectRegistry.log();
+            if (SciChartSurfaceBase.domMasterCanvas) {
+                document.body.removeChild(SciChartSurfaceBase.domMasterCanvas);
+                SciChartSurfaceBase.domMasterCanvas = undefined;
             }
         }
+        // try {
+        //     if (process.env.NODE_ENV !== "production") {
+        //         if (MemoryUsageHelper.isMemoryUsageDebugEnabled) {
+        //             // @ts-ignore
+        //             window.gc && window.gc();
+        //             // TODO add warning if there are undeleted or uncollected entities instead
+        //             // MemoryUsageHelper.objectRegistry.log();
+        //         }
+        //     }
+        // } catch (err) {
+        //     console.warn(err);
+        // }
     };
     /**
      * Sets the runtime license key.  Use for full licenses or trials only, not developer licenses.
@@ -570,7 +586,13 @@ var SciChartSurfaceBase = /** @class */ (function (_super) {
      * chart parts are automatically anti-aliased
      */
     SciChartSurfaceBase.AntiAliasWebGlBackbuffer = false;
+    /**
+     * Defines a delay of the shared wasmContext auto-dispose if {@link autoDisposeWasmContext} is enabled.
+     */
     SciChartSurfaceBase.wasmContextDisposeTimeout = 0;
+    /**
+     * Defines if the shared wasmContext ({@link TSciChart | WebAssembly Context}) should be deleted after all of the surfaces that use it are deleted.
+     */
     SciChartSurfaceBase.autoDisposeWasmContext = false;
     return SciChartSurfaceBase;
 }(DeletableEntity_1.DeletableEntity));

package/Charting/Visuals/createMaster.d.ts

@@ -4,6 +4,9 @@ import { TWebAssemblyChart } from "./SciChartSurface";
 /** @ignore */
 export declare const createMultichart: (divElement: string | HTMLDivElement, options?: I2DSurfaceOptions) => Promise<TWebAssemblyChart>;
 /** @ignore */
+declare const initializeChartEngine: () => Promise<void>;
+/** @ignore */
 export declare const disposeMultiChart: () => void;
 /** @ignore */
 export declare const monitorWebGL: (wasmContext: TSciChart) => void;
+export { initializeChartEngine as initializeChartEngine2D };

package/Charting/Visuals/createMaster.js

@@ -36,7 +36,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.monitorWebGL = exports.disposeMultiChart = exports.createMultichart = void 0;
+exports.initializeChartEngine2D = exports.monitorWebGL = exports.disposeMultiChart = exports.createMultichart = void 0;
 // @ts-ignore
 var WasmModule2D = require("../../_wasm/scichart2d");
 var BuildStamp_1 = require("../../Core/BuildStamp");
@@ -53,6 +53,7 @@ var DeletableEntity_1 = require("../../Core/DeletableEntity");
 var NativeObject_1 = require("./Helpers/NativeObject");
 var LabelCache_1 = require("./Axis/LabelProvider/LabelCache");
 var MemoryUsageHelper_1 = require("../../utils/MemoryUsageHelper");
+var WebGlHelper_1 = require("../../Core/WebGlHelper");
 // Global variables
 /** @ignore */
 var sciChartMaster = {
@@ -64,7 +65,7 @@ var sciChartMaster = {
 var sciChartMasterPromise;
 /** @ignore */
 var createMultichart = function (divElement, options) { return __awaiter(void 0, void 0, void 0, function () {
-    var canvases, loader, loaderDiv, master, createChildSurface, wasmContext_1, divElementId, sciChartSurface_1, err_1;
+    var canvases, loader, loaderDiv, createChildSurface, wasmContext_1, divElementId, sciChartSurface_1, err_1;
     var _a, _b, _c;
     return __generator(this, function (_d) {
         switch (_d.label) {
@@ -75,21 +76,10 @@ var createMultichart = function (divElement, options) { return __awaiter(void 0,
                 loaderDiv = loader.addChartLoader(canvases.domDivContainer, options === null || options === void 0 ? void 0 : options.theme);
                 _d.label = 1;
             case 1:
-                _d.trys.push([1, 4, , 5]);
-                if (!(!sciChartMaster.wasmContext || !sciChartMaster.createChildSurface || !sciChartMaster.getChildSurfaces)) return [3 /*break*/, 3];
-                if (!sciChartMasterPromise) {
-                    sciChartMasterPromise = createMaster();
-                }
-                return [4 /*yield*/, sciChartMasterPromise];
+                _d.trys.push([1, 3, , 4]);
+                return [4 /*yield*/, initializeChartEngine()];
             case 2:
-                master = _d.sent();
-                sciChartMaster.wasmContext = master.wasmContext;
-                (0, BuildStamp_1.checkBuildStamp)(master.wasmContext);
-                sciChartMaster.createChildSurface = master.createChildSurface;
-                sciChartMaster.getChildSurfaces = master.getChildSurfaces;
-                (0, exports.monitorWebGL)(master.wasmContext);
-                _d.label = 3;
-            case 3:
+                _d.sent();
                 createChildSurface = sciChartMaster.createChildSurface, wasmContext_1 = sciChartMaster.wasmContext;
                 divElementId = canvases.domChartRoot.id;
                 sciChartSurface_1 = createChildSurface(divElementId, canvases, options === null || options === void 0 ? void 0 : options.theme);
@@ -100,18 +90,43 @@ var createMultichart = function (divElement, options) { return __awaiter(void 0,
                             resolve({ wasmContext: wasmContext_1, sciChartSurface: sciChartSurface_1 });
                         }, 0);
                     })];
-            case 4:
+            case 3:
                 err_1 = _d.sent();
                 console.error(err_1);
                 // replace with div with error message
                 loader.removeChartLoader(canvases.domDivContainer, loaderDiv);
                 loaderDiv = undefined;
                 return [2 /*return*/, Promise.reject(err_1)];
-            case 5: return [2 /*return*/];
+            case 4: return [2 /*return*/];
         }
     });
 }); };
 exports.createMultichart = createMultichart;
+/** @ignore */
+var initializeChartEngine = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var master;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                WebGlHelper_1.WebGlHelper.initialize();
+                if (!(!sciChartMaster.wasmContext || !sciChartMaster.createChildSurface || !sciChartMaster.getChildSurfaces)) return [3 /*break*/, 2];
+                if (!sciChartMasterPromise) {
+                    sciChartMasterPromise = createMaster();
+                }
+                return [4 /*yield*/, sciChartMasterPromise];
+            case 1:
+                master = _a.sent();
+                sciChartMaster.wasmContext = master.wasmContext;
+                (0, BuildStamp_1.checkBuildStamp)(master.wasmContext);
+                sciChartMaster.createChildSurface = master.createChildSurface;
+                sciChartMaster.getChildSurfaces = master.getChildSurfaces;
+                (0, exports.monitorWebGL)(master.wasmContext);
+                _a.label = 2;
+            case 2: return [2 /*return*/];
+        }
+    });
+}); };
+exports.initializeChartEngine2D = initializeChartEngine;
 var cleanupWasmContext;
 /** @ignore */
 var disposeMultiChart = function () {
@@ -212,8 +227,18 @@ var createMaster = function () {
             var createChildSurface = function (divElementId, canvases, theme) {
                 Guard_1.Guard.notNull(theme, "theme");
                 var canvas2dId = sciChartInitCommon_1.default.getCanvas2dId(divElementId);
+                // TODO check other destinations
                 var sameIdDestinations = Globals_1.sciChartDestinations.filter(function (el) { return el.canvasElementId === canvas2dId; });
-                sameIdDestinations.forEach(function (el) { return el.sciChartSurface.delete(false); });
+                try {
+                    if (process.env.NODE_ENV !== "production") {
+                        if (MemoryUsageHelper_1.MemoryUsageHelper.isMemoryUsageDebugEnabled && sameIdDestinations.length > 0) {
+                            console.warn("Trying to create a SciChartSurface on a root element (".concat(divElementId, ") of another surface before it was deleted ! This will automatically delete the previous surface."));
+                        }
+                    }
+                }
+                catch (err) {
+                    console.warn(err);
+                }
                 var otherDestinations = Globals_1.sciChartDestinations.filter(function (el) { return el.canvasElementId !== canvas2dId; });
                 chartInitObj.ClearDestinations();
                 while (Globals_1.sciChartDestinations.length > 0) {
@@ -238,16 +263,22 @@ var createMaster = function () {
                             }
                         }
                         else {
-                            if (process.env.NODE_ENV !== "production") {
-                                if (MemoryUsageHelper_1.MemoryUsageHelper.isMemoryUsageDebugEnabled &&
-                                    sciChartSurface.otherSurfaces.length === 0) {
-                                    console.warn("SciChartSurface.autoDisposeWasmContext is disabled, thus wasmContext should be disposed explicitly using \"SciChartSurface.disposeSharedWasmContext()\".");
+                            try {
+                                if (process.env.NODE_ENV !== "production") {
+                                    if (MemoryUsageHelper_1.MemoryUsageHelper.isMemoryUsageDebugEnabled &&
+                                        sciChartSurface.otherSurfaces.length === 0) {
+                                        console.warn("SciChartSurface.autoDisposeWasmContext is disabled, thus wasmContext should be disposed explicitly using \"SciChartSurface.disposeSharedWasmContext()\".");
+                                    }
                                 }
                             }
+                            catch (err) {
+                                console.warn(err);
+                            }
                         }
                     }
                 });
                 addDestination(wasmContext, canvas2dId, sciChartSurface, canvases.domCanvas2D.width, canvases.domCanvas2D.height, chartInitObj);
+                sameIdDestinations.forEach(function (el) { return el.sciChartSurface.delete(false); });
                 licenseManager2D_1.licenseManager.applyLicense2D(wasmContext, sciChartSurface, false);
                 return sciChartSurface;
             };

package/Charting/Visuals/createSingle.js

@@ -114,10 +114,10 @@ var initDrawEngineSingleChart = function (wasmContext, canvases, resolve, theme)
             scs.renderSurface.onRenderTimeElapsed();
         },
         Update: function (deltaTime) {
-            logger_1.Logger.log("sciChartInitCommon.ts Update");
+            // Logger.debug("sciChartInitCommon.ts Update");
         },
         ShutDownChart: function () {
-            logger_1.Logger.log("sciChartInitCommon.ts ShutDownChart");
+            // Logger.debug("sciChartInitCommon.ts ShutDownChart");
         }
     };
     var chartInitObj = wasmContext.SCRTSampleChartInterface.implement(chartInitializer);

package/Charting/Visuals/licenseManager2D.js

@@ -559,11 +559,11 @@ var applyLicense = function (licenseContext, sciChartSurface) {
     debug("checkstatus: " + licensingClasses_1.LicenseCheckStatus[checkStatus]);
     if (checkStatus === licensingClasses_1.LicenseCheckStatus.NoLicense) {
         if (lt === licenseContext.SCRTLicenseType.LICENSE_TYPE_COMMUNITY && !communityNotice) {
-            console.log("Defaulting to SciChart Community Edition.  Usage constitutes acceptance of EULA at https://scichart.com/JSCommunityEULA. See https://store.scichart.com for commercial licensing options.");
+            console.log("Defaulting to SciChart Community Edition. Usage constitutes acceptance of our EULA and terms at https://www.scichart.com/community-licensing. See https://store.scichart.com for commercial licensing options.");
             var daysRemaining = licenseContext.SCRTCredentials.GetLicenseDaysRemaining();
             console.log("The community license is valid for 6 months from the date the version in use was released.  This version ".concat(BuildStamp_1.libraryVersion, " has ").concat(daysRemaining, " day").concat(daysRemaining === 1 ? "" : "s", " remaining"));
             if (!app_1.IS_TEST_ENV && ((_b = document === null || document === void 0 ? void 0 : document.location) === null || _b === void 0 ? void 0 : _b.hostname.startsWith("localhost")) && useLicenseWizard) {
-                console.log("Looking for paid developer activation from licensing wizard... To disable this call SciChartSurface.UseCommunityLicense()");
+                console.log("SciChart is looking for a paid developer activation from the scichart licensing wizard... To disable this call SciChartSurface.UseCommunityLicense()");
             }
             communityNotice = true;
         }
@@ -786,7 +786,8 @@ var getLicenseInfo = function (licenseContext) {
     var sclt = licenseContext.SCRTCredentials.GetLicenseType();
     var licenseType = convertLicenseType(sclt, licenseContext);
     var daysRemaining = licenseContext.SCRTCredentials.GetLicenseDaysRemaining();
-    if (checkStatus === licensingClasses_1.LicenseCheckStatus.LicenseOK && licenseManager2dState_1.licenseManager2dState.getLicenseType() !== licenseType) {
+    if ((checkStatus === licensingClasses_1.LicenseCheckStatus.LicenseOK || licenseType === licensingClasses_1.LicenseType.Community) &&
+        licenseManager2dState_1.licenseManager2dState.getLicenseType() !== licenseType) {
         if (licenseType === licensingClasses_1.LicenseType.Community) {
             licenseManager2dState_1.licenseManager2dState.setOrderId("Community");
         }
@@ -897,8 +898,12 @@ var updateLicenseDisplayInternal = function (licenseInfo, sciChartSurface, is2D,
         if (checkStatus !== licensingClasses_1.LicenseCheckStatus.LicenseOK) {
             if (checkStatus === licensingClasses_1.LicenseCheckStatus.FetchingFromServer)
                 chartmsg = "<br>Fetching license from server...";
-            if (checkStatus === licensingClasses_1.LicenseCheckStatus.LookingForLicenseWizard)
+            if (checkStatus === licensingClasses_1.LicenseCheckStatus.LookingForLicenseWizard) {
+                if (licenseType === licensingClasses_1.LicenseType.Community) {
+                    (0, Telemetry_1.sendTelemetry)();
+                }
                 chartmsg = "<br>Looking for Licensing Wizard...  <u>Please run it or click for download and installation instructions</u>.";
+            }
             else if (checkStatus === licensingClasses_1.LicenseCheckStatus.FailedToFindLicenseWizard)
                 if (licenseManager2dState_1.licenseManager2dState.getIsDev()) {
                     chartmsg = "<br><u>Could not connect to the Licensing Wizard.  Please run it or click for download and installation instructions, then reload this page.</u>";

package/Charting3D/ChartModifiers/ResetCamera3DModifier.d.ts

@@ -40,7 +40,7 @@ export declare type TCameraState = {
  *
  * ```ts
  * const sciChartS3Durface: SciChart3DSurface;
- * sciChart3DSurface.chartModifiers.add(new ZoomExtentsModifier3D());
+ * sciChart3DSurface.chartModifiers.add(new ResetCamera3DModifier());
  * ```
  *
  */

package/Charting3D/ChartModifiers/ResetCamera3DModifier.js

@@ -32,7 +32,7 @@ var ChartModifierBase3D_1 = require("./ChartModifierBase3D");
  *
  * ```ts
  * const sciChartS3Durface: SciChart3DSurface;
- * sciChart3DSurface.chartModifiers.add(new ZoomExtentsModifier3D());
+ * sciChart3DSurface.chartModifiers.add(new ResetCamera3DModifier());
  * ```
  *
  */
@@ -103,7 +103,6 @@ var ResetCamera3DModifier = /** @class */ (function (_super) {
         if (!camera) {
             return;
         }
-        var radius = camera.radius;
         if (camera.projectionMode === CameraController_1.ECameraProjectionMode.Perspective) {
             var animation = new GenericAnimation_1.GenericAnimation({
                 from: { radius: camera.radius, pitch: camera.orbitalPitch, yaw: camera.orbitalYaw },

package/Charting3D/ChartModifiers/TooltipModifier3D.d.ts

@@ -7,8 +7,19 @@ import { ChartModifierBase3D, IChartModifierBase3DOptions } from "./ChartModifie
  * Optional parameters passed to the constructor of {@link TooltipModifier3D} to configure it
  */
 export interface ITooltipModifier3DOptions extends IChartModifierBase3DOptions {
+    /**
+     * Gets or sets the stroke color of the crosshair as an HTML Color code
+     * @param stroke
+     */
     crosshairStroke?: string;
+    /**
+     * Gets or sets the strokethickness of the crosshair line
+     */
     crosshairStrokeThickness?: number;
+    /**
+     * When true, a crosshair line will be displayed from the hovered point location to the far axis wall
+     * @param isVisible
+     */
     isCrosshairVisible?: boolean;
     showTooltip?: boolean;
     tooltipTitle?: string;
@@ -48,11 +59,33 @@ export declare class TooltipModifier3D extends ChartModifierBase3D {
     constructor(options?: ITooltipModifier3DOptions);
     includeSeries(series: IRenderableSeries3D, isIncluded: boolean): void;
     getIncludedSeries(): IRenderableSeries3D[];
+    /**
+     * When true, a crosshair line will be displayed from the hovered point location to the far axis wall
+     * @param isVisible
+     */
     get isCrosshairVisible(): boolean;
+    /**
+     * When true, a crosshair line will be displayed from the hovered point location to the far axis wall
+     * @param isVisible
+     */
     set isCrosshairVisible(isVisible: boolean);
+    /**
+     * Gets or sets the stroke color of the crosshair as an HTML Color code
+     * @param stroke
+     */
     get crosshairStroke(): string;
+    /**
+     * Gets or sets the stroke color of the crosshair as an HTML Color code
+     * @param stroke
+     */
     set crosshairStroke(stroke: string);
+    /**
+     * Gets or sets the strokethickness of the crosshair line
+     */
     get crosshairStrokeThickness(): number;
+    /**
+     * Gets or sets the strokethickness of the crosshair line
+     */
     set crosshairStrokeThickness(strokeThickness: number);
     get tooltipSvgTemplate(): TTooltip3DSvgTemplate;
     set tooltipSvgTemplate(value: TTooltip3DSvgTemplate);
@@ -82,6 +115,8 @@ export declare class TooltipModifier3D extends ChartModifierBase3D {
     onDetach(): void;
     /** @inheritDoc */
     modifierMouseMove(args: ModifierMouseArgs): void;
+    onParentSurfaceRendered(): void;
+    protected update(): void;
 }
 /** Relocate the tooltip so that it is always within the seriesViewRect */
 export declare const adjustTooltipPosition3D: (width: number, height: number, svgAnnotation: TooltipSvgAnnotation3D) => void;

package/Charting3D/ChartModifiers/TooltipModifier3D.js

@@ -94,9 +94,17 @@ var TooltipModifier3D = /** @class */ (function (_super) {
             .filter(function (rs) { return rs.isVisible && _this.includedSeriesMap.get(rs) !== false; });
     };
     Object.defineProperty(TooltipModifier3D.prototype, "isCrosshairVisible", {
+        /**
+         * When true, a crosshair line will be displayed from the hovered point location to the far axis wall
+         * @param isVisible
+         */
         get: function () {
             return this.isCrosshairVisibleProperty;
         },
+        /**
+         * When true, a crosshair line will be displayed from the hovered point location to the far axis wall
+         * @param isVisible
+         */
         set: function (isVisible) {
             var _a;
             this.isCrosshairVisibleProperty = isVisible;
@@ -106,9 +114,17 @@ var TooltipModifier3D = /** @class */ (function (_super) {
         configurable: true
     });
     Object.defineProperty(TooltipModifier3D.prototype, "crosshairStroke", {
+        /**
+         * Gets or sets the stroke color of the crosshair as an HTML Color code
+         * @param stroke
+         */
         get: function () {
             return this.crosshairStrokeProperty;
         },
+        /**
+         * Gets or sets the stroke color of the crosshair as an HTML Color code
+         * @param stroke
+         */
         set: function (stroke) {
             var _a;
             this.crosshairStrokeProperty = stroke;
@@ -118,9 +134,15 @@ var TooltipModifier3D = /** @class */ (function (_super) {
         configurable: true
     });
     Object.defineProperty(TooltipModifier3D.prototype, "crosshairStrokeThickness", {
+        /**
+         * Gets or sets the strokethickness of the crosshair line
+         */
         get: function () {
             return this.crosshairStrokeThicknessProperty;
         },
+        /**
+         * Gets or sets the strokethickness of the crosshair line
+         */
         set: function (strokeThickness) {
             var _a;
             this.crosshairStrokeThicknessProperty = strokeThickness;
@@ -284,11 +306,23 @@ var TooltipModifier3D = /** @class */ (function (_super) {
     };
     /** @inheritDoc */
     TooltipModifier3D.prototype.modifierMouseMove = function (args) {
-        var _a, _b, _c, _d, _e;
+        this.activePointerEvents.set(args.pointerId, args);
         _super.prototype.modifierMouseMove.call(this, args);
-        var _f = args.mousePoint, x = _f.x, y = _f.y;
+        if (this.getIsActionAllowed(args)) {
+            this.update();
+        }
+    };
+    TooltipModifier3D.prototype.onParentSurfaceRendered = function () {
+        this.update();
+    };
+    TooltipModifier3D.prototype.update = function () {
+        var _this = this;
+        var _a, _b, _c, _d, _e;
+        if (!this.mousePoint)
+            return;
+        var _f = this.mousePoint, x = _f.x, y = _f.y;
         var seriesInfo = this.getIncludedSeries()
-            .map(function (rs) { return rs.hitTest(args.mousePoint); })
+            .map(function (rs) { return rs.hitTest(_this.mousePoint); })
             .find(function (result) { return result.isHit; });
         if (seriesInfo === null || seriesInfo === void 0 ? void 0 : seriesInfo.isHit) {
             // console.log(`TooltipModifier3D: HitTest at (${x}, ${y})`);
@@ -317,8 +351,10 @@ var TooltipModifier3D = /** @class */ (function (_super) {
             }
             this.tooltipAnnotation.isHidden = !this.showTooltip;
             if (this.showTooltip) {
-                this.tooltipAnnotation.x1 = x;
-                this.tooltipAnnotation.y1 = y;
+                var xt = (0, translate_1.translateToNotScaled)(x);
+                var yt = (0, translate_1.translateToNotScaled)(y);
+                this.tooltipAnnotation.x1 = xt;
+                this.tooltipAnnotation.y1 = yt;
             }
             if (this.showTooltip || this.tooltipLegendTemplate) {
                 this.tooltipAnnotation.seriesInfo = seriesInfo;

package/Charting3D/Model/DataSeries/BaseGridDataSeries3D.d.ts

@@ -116,7 +116,7 @@ export declare abstract class BaseGridDataSeries3D extends BaseDataSeries3D impl
      * @param xIndex the x-index from 0 to xSize
      * @param YValue the new Height-value
      */
-    setYValue(yIndex: number, xIndex: number, zValue: number): void;
+    setYValue(zIndex: number, xIndex: number, yValue: number): void;
     /**
      * @inheritDoc
      */

package/Charting3D/Model/DataSeries/BaseGridDataSeries3D.js

@@ -144,8 +144,8 @@ var BaseGridDataSeries3D = /** @class */ (function (_super) {
      * @param xIndex the x-index from 0 to xSize
      * @param YValue the new Height-value
      */
-    BaseGridDataSeries3D.prototype.setYValue = function (yIndex, xIndex, zValue) {
-        this.yValuesProperty[yIndex][xIndex] = zValue;
+    BaseGridDataSeries3D.prototype.setYValue = function (zIndex, xIndex, yValue) {
+        this.yValuesProperty[zIndex][xIndex] = yValue;
         this.notifyDataChanged();
     };
     /**

package/Charting3D/Model/DataSeries/IPointMetadata3D.d.ts

@@ -5,11 +5,16 @@
  */
 export interface IPointMetadata3D {
     /**
-     * Override the color for this particular point. Set=undefined for default
+     * @deprecated Property naming was wrong, we've updated it to vertexColor [SCJS-1566]
      */
     vertexColorAbgr?: number;
+    /**
+     * Override the color for this particular point. Set=undefined for default.
+     * Note: This is a 32-bit integer in ARGB format, e.g. 0xFFFF0000 is Red
+     */
+    vertexColor?: number;
     /**
      * Override the scale for this particular point. Set=1.0 for default
      */
-    pointScale: number;
+    pointScale?: number;
 }