scichart 3.1.348 → 3.2.434

package/Charting3D/Visuals/Primitives/PointLine3DSceneEntity.js

@@ -0,0 +1,190 @@
+"use strict";
+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 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.PointLine3DSceneEntity = void 0;
+var Deleter_1 = require("../../../Core/Deleter");
+var SceneEntityType_1 = require("../../../types/SceneEntityType");
+var parseColor_1 = require("../../../utils/parseColor");
+var BaseDataSeries3D_1 = require("../../Model/DataSeries/BaseDataSeries3D");
+var Constants_1 = require("../RenderableSeries/Constants");
+var BasePointMarker3D_1 = require("../PointMarkers/BasePointMarker3D");
+var RenderableSeriesSceneEntity_1 = require("./RenderableSeriesSceneEntity");
+var RenderableSeriesSceneEntityState_1 = require("./RenderableSeriesSceneEntityState");
+/**
+ * @summary {@link BaseSceneEntity3D} type for drawing 3D Scatter or Bubble series in SciChart's High Performance
+ * {@link https://www.scichart.com/javascript-chart-features | JavaScript 3D Charts}
+ * @remarks See related type {@link ScatterRenderableSeries3D} which should be added to {@link SciChart3DSurface.renderableSeries}
+ * along with data from an {@link XyzDataSeries3D} to create a 3D Scatter or Bubble chart
+ */
+var PointLine3DSceneEntity = /** @class */ (function (_super) {
+    __extends(PointLine3DSceneEntity, _super);
+    /**
+     * Creates an instance of {@link ScatterPointsSceneEntity}
+     * @param webAssemblyContext The {@link TSciChart3D | SciChart 3D WebAssembly Context} containing native methods and
+     * access to our WebGL2 Engine and WebAssembly numerical methods
+     * @param parentSeries The parent {@link BaseRenderableSeries3D} which this entity maps to
+     */
+    function PointLine3DSceneEntity(webAssemblyContext, parentSeries) {
+        var _this = _super.call(this, webAssemblyContext, parentSeries, new RenderableSeriesSceneEntityState_1.RenderableSeriesSceneEntityState()) || this;
+        /**
+         * @inheritDoc
+         */
+        _this.type = SceneEntityType_1.ESceneEntityType.PointLine3DSceneEntity;
+        _this.setNativeEntity(webAssemblyContext.SCRTPointLine3DSceneEntity.implement(_this));
+        return _this;
+    }
+    /**
+     * @inheritDoc
+     */
+    PointLine3DSceneEntity.prototype.delete = function () {
+        this.pointColors = (0, Deleter_1.deleteSafe)(this.pointColors);
+        this.pointScales = (0, Deleter_1.deleteSafe)(this.pointScales);
+        _super.prototype.delete.call(this);
+    };
+    /**
+     * @inheritDoc
+     */
+    PointLine3DSceneEntity.prototype.Render = function () {
+        this.nativeEntity.SetOpacity(this.parentSeries.opacity);
+        _super.prototype.Render.call(this);
+    };
+    /**
+     * @inheritDoc
+     * @param propertyName
+     */
+    PointLine3DSceneEntity.prototype.notifySeriesPropertyChanged = function (propertyName) {
+        // Pass flags down to child entities
+        if (propertyName === Constants_1.PROPERTY.STROKE_THICKNESS) {
+            this.nativeEntity.SetLineStrokeThickness(this.parentSeries.strokeThickness);
+        }
+        if (propertyName === Constants_1.PROPERTY.STROKE) {
+            this.nativeEntity.SetStrokeColor((0, parseColor_1.parseColorToUIntArgb)(this.parentSeries.stroke));
+        }
+        if (propertyName === Constants_1.PROPERTY.POINT_MARKER3D) {
+            this.updateSeries();
+        }
+        _super.prototype.notifySeriesPropertyChanged.call(this, propertyName);
+    };
+    /**
+     * @inheritDoc
+     */
+    PointLine3DSceneEntity.prototype.hitTest = function (screenPoint) {
+        return _super.prototype.hitTestXyz.call(this, screenPoint);
+    };
+    /**
+     * @inheritDoc
+     */
+    PointLine3DSceneEntity.prototype.updateSeries = function () {
+        var dataSeries = this.parentSeries.dataSeries;
+        if (!dataSeries) {
+            return;
+        }
+        if (dataSeries.type !== BaseDataSeries3D_1.EDataSeriesType3D.Xyz3D) {
+            throw new Error("DataSeries type for a PointLineRenderableSeries3D must be XyzDataSeries3D");
+        }
+        var strokeArgb = (0, parseColor_1.parseColorToUIntArgb)(this.parentSeries.stroke);
+        this.nativeEntity.SetLineStrokeThickness(this.parentSeries.strokeThickness);
+        this.nativeEntity.SetIsLineStrips(this.parentSeries.isLineStrip);
+        this.nativeEntity.SetIsLineAntialiased(this.parentSeries.isAntiAliased);
+        this.nativeEntity.SetStrokeColor(strokeArgb);
+        this.updatePointMarker(this.parentSeries.pointMarker);
+        var xValues = dataSeries.getNativeXValues();
+        var yValues = dataSeries.getNativeYValues();
+        var zValues = dataSeries.getNativeZValues();
+        var meta = dataSeries.getMetadataValues();
+        var count = dataSeries.count();
+        var _a = this.rebuildPointMetadata(meta, count, strokeArgb), lineColors = _a.lineColors, pointColors = _a.pointColors, scales = _a.scales, hasDefaultColors = _a.hasDefaultColors, hasDefaultScales = _a.hasDefaultScales;
+        var args;
+        try {
+            args = new this.webAssemblyContext.SCRTPointLines3DSceneEntityParams();
+            args.useDefaultColors = hasDefaultColors;
+            args.useDefaultScale = hasDefaultScales;
+            args.SetCoordinateCalculators(this.currentRenderPassData.xCalc.nativeCalculator, this.currentRenderPassData.yCalc.nativeCalculator, this.currentRenderPassData.zCalc.nativeCalculator);
+            this.nativeEntity.UpdateMeshesVec(xValues, yValues, zValues, pointColors, lineColors, scales, args);
+        }
+        finally {
+            (0, Deleter_1.deleteSafe)(args);
+        }
+    };
+    PointLine3DSceneEntity.prototype.updatePointMarker = function (pointMarker) {
+        var eSCRTPointMarkerType = this.webAssemblyContext.eSCRT_POINT_MARKER_TYPE;
+        if (pointMarker === undefined || pointMarker.markerType === BasePointMarker3D_1.EMarkerType.Pixel) {
+            this.nativeEntity.SetPointMarkerType(eSCRTPointMarkerType.SCRT_POINT_MARKER_TYPE_PIXEL);
+            this.nativeEntity.SetPointSize(0);
+        }
+        else if (pointMarker.markerType === BasePointMarker3D_1.EMarkerType.InstancedMesh) {
+            var meshMarker = pointMarker;
+            if (!meshMarker.pointsMesh) {
+                throw new Error("Expected a BaseMeshPointMarker3D.pointsMesh on 3D pointmarker of type InstancedMesh");
+            }
+            this.nativeEntity.SetPointMarkerType(eSCRTPointMarkerType.SCRT_POINT_MARKER_TYPE_INSTANCED_MESH);
+            this.nativeEntity.SetPointSize(pointMarker.size);
+            this.nativeEntity.SetPointMarkerMesh(meshMarker.pointsMesh);
+        }
+        else if (pointMarker.markerType === BasePointMarker3D_1.EMarkerType.TexturedQuad) {
+            var textureMarker = pointMarker;
+            if (!textureMarker.pointsTexture) {
+                throw new Error("Expected a BaseTexturePointMarker3D.pointsTexture on 3D pointmarker of type TexturedQuad");
+            }
+            this.nativeEntity.SetPointMarkerType(eSCRTPointMarkerType.SCRT_POINT_MARKER_TYPE_TEXTURED_QUAD);
+            this.nativeEntity.SetPointSize(pointMarker.size);
+            this.nativeEntity.SetPointMarkerTexture(textureMarker.pointsTexture);
+        }
+        else {
+            throw new Error("PointLine3DSceneEntity: Unknown pointMarker.markerType " + pointMarker.markerType);
+        }
+    };
+    PointLine3DSceneEntity.prototype.rebuildPointMetadata = function (metadata, count, defaultColor) {
+        var _this = this;
+        if (!this.pointColors) {
+            this.pointColors = new this.webAssemblyContext.UIntVector();
+        }
+        if (!this.pointScales) {
+            this.pointScales = new this.webAssemblyContext.FloatVector();
+        }
+        // Default color, size
+        this.pointColors.resize(count, defaultColor);
+        this.pointScales.resize(count, 1.0);
+        var hasDefaultScales = true;
+        var hasDefaultColors = true;
+        // metadata will always be non-null but individual metadata items may be undefined
+        // as its implemented as a non-sparse array
+        metadata.forEach(function (meta, index) {
+            var _a;
+            if (meta) {
+                var vertexColor = (_a = meta.vertexColorAbgr) !== null && _a !== void 0 ? _a : meta.vertexColor;
+                if (vertexColor) {
+                    hasDefaultColors = false;
+                    _this.pointColors.set(index, vertexColor);
+                }
+                if (meta.pointScale) {
+                    hasDefaultScales = false;
+                    _this.pointScales.set(index, meta.pointScale);
+                }
+            }
+        });
+        return {
+            lineColors: this.pointColors,
+            pointColors: this.pointColors,
+            scales: this.pointScales,
+            hasDefaultScales: hasDefaultScales,
+            hasDefaultColors: hasDefaultColors
+        };
+    };
+    return PointLine3DSceneEntity;
+}(RenderableSeriesSceneEntity_1.RenderableSeriesSceneEntity));
+exports.PointLine3DSceneEntity = PointLine3DSceneEntity;

package/Charting3D/Visuals/Primitives/RenderableSeriesSceneEntity.d.ts

@@ -1,5 +1,7 @@
+import { Point } from "../../../Core/Point";
 import { SCRTSceneEntity, TSciChart3D } from "../../../types/TSciChart3D";
 import { BaseRenderableSeries3D } from "../RenderableSeries/BaseRenderableSeries3D";
+import { HitTestInfo3D } from "../RenderableSeries/HitTestInfo3D";
 import { BaseSceneEntity3D, IBaseSceneEntity } from "./BaseSceneEntity3D";
 import { RenderableSeriesSceneEntityState } from "./RenderableSeriesSceneEntityState";
 /**
@@ -12,6 +14,13 @@ export interface IRenderableSeriesSceneEntity extends IBaseSceneEntity {
      * @param propertyName the property name
      */
     notifySeriesPropertyChanged(propertyName: string): void;
+    /**
+     * Performs a HitTest operation on the entity, returning the {@link HitTestInfo3D} containing the result.
+     * This contains information about the hit-test operation such as the index of the data-point under the mouse, and
+     * may be used for tooltips, selection or inspection of the 3d scene through mouse-clicks
+     * @param screenPoint The screen point (X,Y pixel coordinate in 2D space)
+     */
+    hitTest(screenPoint: Point): HitTestInfo3D;
 }
 /**
  * @summary Defines a special {@link BaseSceneEntity3D} type which hosts the entity for a {@link BaseRenderableSeries3D | RenderableSeries},
@@ -44,9 +53,12 @@ export declare abstract class RenderableSeriesSceneEntity<TRenderableSeries exte
      * @param propertyName
      */
     notifySeriesPropertyChanged(propertyName: string): void;
+    /** @inheritDoc */
+    abstract hitTest(screenPoint: Point): HitTestInfo3D;
     /**
      * When overriden in derived classes, this method is called when the series entity must be updated before drawing.
      * @protected
      */
     protected abstract updateSeries(): void;
+    protected hitTestXyz(screenPoint: Point): HitTestInfo3D;
 }

package/Charting3D/Visuals/Primitives/RenderableSeriesSceneEntity.js

@@ -16,6 +16,7 @@ var __extends = (this && this.__extends) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RenderableSeriesSceneEntity = void 0;
+var HitTestInfo3D_1 = require("../RenderableSeries/HitTestInfo3D");
 var BaseSceneEntity3D_1 = require("./BaseSceneEntity3D");
 /**
  * @summary Defines a special {@link BaseSceneEntity3D} type which hosts the entity for a {@link BaseRenderableSeries3D | RenderableSeries},
@@ -35,6 +36,7 @@ var RenderableSeriesSceneEntity = /** @class */ (function (_super) {
         _this.parentSeries = parentSeries;
         _this.state = state;
         _this.state.setInitialState();
+        _this.hitTest = _this.hitTest.bind(_this);
         return _this;
     }
     /**
@@ -69,6 +71,18 @@ var RenderableSeriesSceneEntity = /** @class */ (function (_super) {
         // Set Renderable Series Property Changed
         this.state.setRenderableSeriesPropertyChanged();
     };
+    RenderableSeriesSceneEntity.prototype.hitTestXyz = function (screenPoint) {
+        var _a;
+        var x = Math.round(screenPoint.x);
+        var y = Math.round(screenPoint.y);
+        var selectionInfo = this.webAssemblyContext.SCRTGetSelectionInfo(x, y);
+        var result = new HitTestInfo3D_1.HitTestInfo3D(this.parentSeries, false);
+        result.isHit =
+            selectionInfo.m_uiSelectionIndex > 0 && ((_a = selectionInfo.GetEntity()) === null || _a === void 0 ? void 0 : _a.GetEntityId()) === this.entityId;
+        result.selectionIndex = result.isHit ? selectionInfo.m_uiSelectionIndex : -1;
+        result.hitTestPoint = screenPoint;
+        return result;
+    };
     return RenderableSeriesSceneEntity;
 }(BaseSceneEntity3D_1.BaseSceneEntity3D));
 exports.RenderableSeriesSceneEntity = RenderableSeriesSceneEntity;

package/Charting3D/Visuals/Primitives/ScatterPointsSceneEntity.d.ts

@@ -1,5 +1,7 @@
+import { Point } from "../../../Core/Point";
 import { ESceneEntityType } from "../../../types/SceneEntityType";
 import { SCRTPoint3DSceneEntity, TSciChart3D } from "../../../types/TSciChart3D";
+import { HitTestInfo3D } from "../RenderableSeries/HitTestInfo3D";
 import { ScatterRenderableSeries3D } from "../RenderableSeries/ScatterRenderableSeries3D";
 import { RenderableSeriesSceneEntity } from "./RenderableSeriesSceneEntity";
 import { RenderableSeriesSceneEntityState } from "./RenderableSeriesSceneEntityState";
@@ -31,6 +33,15 @@ export declare class ScatterPointsSceneEntity extends RenderableSeriesSceneEntit
      * @inheritDoc
      */
     Render(): void;
+    /**
+     * @inheritDoc
+     * @param propertyName
+     */
+    notifySeriesPropertyChanged(propertyName: string): void;
+    /**
+     * @inheritDoc
+     */
+    hitTest(screenPoint: Point): HitTestInfo3D;
     /**
      * @inheritDoc
      */

package/Charting3D/Visuals/Primitives/ScatterPointsSceneEntity.js

@@ -21,6 +21,7 @@ var SceneEntityType_1 = require("../../../types/SceneEntityType");
 var parseColor_1 = require("../../../utils/parseColor");
 var BaseDataSeries3D_1 = require("../../Model/DataSeries/BaseDataSeries3D");
 var BasePointMarker3D_1 = require("../PointMarkers/BasePointMarker3D");
+var Constants_1 = require("../RenderableSeries/Constants");
 var RenderableSeriesSceneEntity_1 = require("./RenderableSeriesSceneEntity");
 var RenderableSeriesSceneEntityState_1 = require("./RenderableSeriesSceneEntityState");
 /**
@@ -61,6 +62,23 @@ var ScatterPointsSceneEntity = /** @class */ (function (_super) {
         this.nativeEntity.SetOpacity(this.parentSeries.opacity);
         _super.prototype.Render.call(this);
     };
+    /**
+     * @inheritDoc
+     * @param propertyName
+     */
+    ScatterPointsSceneEntity.prototype.notifySeriesPropertyChanged = function (propertyName) {
+        // Pass flags down to child entities
+        if (propertyName === Constants_1.PROPERTY.POINT_MARKER3D) {
+            this.updateSeries();
+        }
+        _super.prototype.notifySeriesPropertyChanged.call(this, propertyName);
+    };
+    /**
+     * @inheritDoc
+     */
+    ScatterPointsSceneEntity.prototype.hitTest = function (screenPoint) {
+        return _super.prototype.hitTestXyz.call(this, screenPoint);
+    };
     /**
      * @inheritDoc
      */
@@ -139,9 +157,12 @@ var ScatterPointsSceneEntity = /** @class */ (function (_super) {
         // metadata will always be non-null but individual metadata items may be undefined
         // as its implemented as a non-sparse array
         metadata.forEach(function (meta, index) {
+            var _a;
             if (meta) {
-                if (meta.vertexColorAbgr) {
-                    _this.pointColors.set(index, meta.vertexColorAbgr);
+                // [SCJS-1566] Renamed vertexColorAbgr to vertexColor. Preserved backward compatibility
+                var vertexColor = (_a = meta.vertexColorAbgr) !== null && _a !== void 0 ? _a : meta.vertexColor;
+                if (vertexColor) {
+                    _this.pointColors.set(index, vertexColor);
                 }
                 if (meta.pointScale) {
                     _this.pointScales.set(index, meta.pointScale);

package/Charting3D/Visuals/Primitives/SurfaceMeshSceneEntity.d.ts

@@ -1,6 +1,8 @@
+import { Point } from "../../../Core/Point";
 import { ESceneEntityType } from "../../../types/SceneEntityType";
 import { SCRTGridMeshEntity, TSciChart3D } from "../../../types/TSciChart3D";
 import { IRenderableSeries3D } from "../RenderableSeries/BaseRenderableSeries3D";
+import { HitTestInfo3D } from "../RenderableSeries/HitTestInfo3D";
 import { SurfaceMeshRenderableSeries3D } from "../RenderableSeries/SurfaceMesh/SurfaceMeshRenderableSeries3D";
 import { RenderableSeriesSceneEntity } from "./RenderableSeriesSceneEntity";
 import { RenderableSeriesSceneEntityState } from "./RenderableSeriesSceneEntityState";
@@ -54,6 +56,7 @@ export declare class SurfaceMeshSceneEntity extends RenderableSeriesSceneEntity<
      * @inheritDoc
      */
     delete(): void;
+    hitTest(screenPoint: Point): HitTestInfo3D;
     /**
      * @inheritDoc
      */

package/Charting3D/Visuals/Primitives/SurfaceMeshSceneEntity.js

@@ -19,11 +19,13 @@ exports.SurfaceMeshSceneEntity = exports.SurfaceMeshSceneEntityState = void 0;
 var Deleter_1 = require("../../../Core/Deleter");
 var Guard_1 = require("../../../Core/Guard");
 var NumberRange_1 = require("../../../Core/NumberRange");
+var Point_1 = require("../../../Core/Point");
 var SceneEntityType_1 = require("../../../types/SceneEntityType");
 var parseColor_1 = require("../../../utils/parseColor");
 var tsrExtensions_1 = require("../../../utils/tsrExtensions");
 var BaseDataSeries3D_1 = require("../../Model/DataSeries/BaseDataSeries3D");
 var Constants_1 = require("../RenderableSeries/Constants");
+var HitTestInfo3D_1 = require("../RenderableSeries/HitTestInfo3D");
 var SurfaceMeshRenderableSeries3D_1 = require("../RenderableSeries/SurfaceMesh/SurfaceMeshRenderableSeries3D");
 var RenderableSeriesSceneEntity_1 = require("./RenderableSeriesSceneEntity");
 var RenderableSeriesSceneEntityState_1 = require("./RenderableSeriesSceneEntityState");
@@ -147,6 +149,19 @@ var SurfaceMeshSceneEntity = /** @class */ (function (_super) {
         _super.prototype.delete.call(this);
         this.colorMapTexture = (0, Deleter_1.deleteSafe)(this.colorMapTexture);
     };
+    SurfaceMeshSceneEntity.prototype.hitTest = function (screenPoint) {
+        var _a;
+        var x = Math.round(screenPoint.x);
+        var y = Math.round(screenPoint.y);
+        var selectionInfo = this.webAssemblyContext.SCRTGetSelectionInfo(x, y);
+        var result = new HitTestInfo3D_1.HitTestInfo3D(this.parentSeries, false);
+        result.isHit = ((_a = selectionInfo.GetEntity()) === null || _a === void 0 ? void 0 : _a.GetEntityId()) === this.entityId;
+        result.selectionIjIndices = result.isHit
+            ? new Point_1.Point(selectionInfo.m_uiHeightMapIndexI, selectionInfo.m_uiHeightMapIndexJ)
+            : undefined;
+        result.hitTestPoint = screenPoint;
+        return result;
+    };
     /**
      * @inheritDoc
      */
@@ -285,7 +300,8 @@ var SurfaceMeshSceneEntity = /** @class */ (function (_super) {
             var gridWidth = gridDataSeries.xSize;
             var gridHeight = gridDataSeries.zSize;
             Guard_1.Guard.notNull(this.currentRenderPassData, "SurfaceMeshSceneEntity.currentRenderPassData");
-            if (this.state.setColorMapTextureInvalid) {
+            // SCJS-1562 2 DAYS to find the source of the crash! Don't recreate every frame.
+            if (this.state.isColorMapTextureInvalid) {
                 this.colorMapTexture = (0, Deleter_1.deleteSafe)(this.colorMapTexture);
                 this.colorMapTexture = (_a = this.parentSeries.meshColorPalette) === null || _a === void 0 ? void 0 : _a.getTexture(this.parentSeries.colorMapTextureSize);
             }

package/Charting3D/Visuals/RenderableSeries/BaseRenderableSeries3D.d.ts

@@ -1,7 +1,9 @@
 import { IThemeable } from "../../../Charting/Themes/IThemeable";
 import { IThemeProvider } from "../../../Charting/Themes/IThemeProvider";
 import { INotifyOnDpiChanged, TDpiChangedEventArgs } from "../../../Charting/Visuals/TextureManager/DpiHelper";
+import { DeletableEntity } from "../../../Core/DeletableEntity";
 import { IDeletable } from "../../../Core/IDeletable";
+import { Point } from "../../../Core/Point";
 import { TSciChart3D } from "../../../types/TSciChart3D";
 import { BaseDataSeries3D } from "../../Model/DataSeries/BaseDataSeries3D";
 import { IPaletteProvider3D } from "../../Model/DataSeries/IPaletteProvider3D";
@@ -10,6 +12,8 @@ import { IBaseSceneEntity } from "../Primitives/BaseSceneEntity3D";
 import { IRenderableSeriesSceneEntity } from "../Primitives/RenderableSeriesSceneEntity";
 import { SciChart3DSurface } from "../SciChart3DSurface";
 import { ESeriesType3D } from "./ESeriesType";
+import { HitTestInfo3D } from "./HitTestInfo3D";
+import { SeriesInfo3D } from "./SeriesInfo3D";
 /**
  * @summary Defines the interface to a 3D Renderable Series (or 3D Chart Type) in SciChart's High Performance Real-time
  * {@link https://www.scichart.com/javascript-chart-features | JavaScript 3D Charts}
@@ -81,6 +85,14 @@ export interface IRenderableSeries3D extends IDeletable, IThemeable, INotifyOnDp
      * Called when the {@link IRenderableSeries3D} is detached from a {@link SciChart3DSurface}
      */
     onDetach(): void;
+    /**
+     * Performs a HitTest operation on the series, returning the {@link SeriesInfo3D} containing the enriched Hit-Test result.
+     * This contains information about the hit-test operation such as the values of the data under the mouse and
+     * location of the data under the mouse in 3D world coordinates. This may be used for tooltips,
+     * selection or inspection of the 3d scene through mouse-clicks
+     * @param screenPoint The screen point (X,Y pixel coordinate in 2D space)
+     */
+    hitTest(screenPoint: Point): SeriesInfo3D;
 }
 /**
  * Options to pass to the {@link BaseRenderableSeries3D} constructor
@@ -127,7 +139,7 @@ export interface IBaseRenderableSeries3DOptions {
  * See derived types of {@link BaseDataSeries3D} to find out what data-series are available.
  * See derived types of {@link IRenderableSeries3D} to find out what 3D JavaScript Chart types are available.
  */
-export declare abstract class BaseRenderableSeries3D implements IRenderableSeries3D {
+export declare abstract class BaseRenderableSeries3D extends DeletableEntity implements IRenderableSeries3D {
     /** @inheritDoc */
     readonly id: string;
     /** @inheritDoc */
@@ -201,6 +213,14 @@ export declare abstract class BaseRenderableSeries3D implements IRenderableSerie
     delete(): void;
     /** @inheritDoc */
     onDpiChanged(args: TDpiChangedEventArgs): void;
+    /** @inheritDoc */
+    hitTest(screenPoint: Point): SeriesInfo3D;
+    /**
+     * Is being called when the data for the underlying DataSeries changes
+     * @protected
+     */
+    protected dataSeriesDataChanged(): void;
+    protected enrichHitTest(hitTestInfo: HitTestInfo3D): SeriesInfo3D;
     /**
      * Used internally - sets the {@link IRenderableSeriesSceneEntity | 3D Scene Entity}
      * @param sceneEntity

package/Charting3D/Visuals/RenderableSeries/BaseRenderableSeries3D.js

@@ -1,9 +1,29 @@
 "use strict";
+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 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.BaseRenderableSeries3D = void 0;
+var DeletableEntity_1 = require("../../../Core/DeletableEntity");
 var Deleter_1 = require("../../../Core/Deleter");
 var guid_1 = require("../../../utils/guid");
+var BaseDataSeries3D_1 = require("../../Model/DataSeries/BaseDataSeries3D");
 var Constants_1 = require("./Constants");
+var SeriesInfo3D_1 = require("./SeriesInfo3D");
+var SurfaceMeshSeriesInfo3D_1 = require("./SurfaceMeshSeriesInfo3D");
+var XyzSeriesInfo3D_1 = require("./XyzSeriesInfo3D");
 /**
  * @summary Defines the base class to a 3D Render Series (or 3D Chart Type) in SciChart's High Performance Real-time
  * {@link https://www.scichart.com/javascript-chart-features | JavaScript 3D Charts}
@@ -14,7 +34,8 @@ var Constants_1 = require("./Constants");
  * See derived types of {@link BaseDataSeries3D} to find out what data-series are available.
  * See derived types of {@link IRenderableSeries3D} to find out what 3D JavaScript Chart types are available.
  */
-var BaseRenderableSeries3D = /** @class */ (function () {
+var BaseRenderableSeries3D = /** @class */ (function (_super) {
+    __extends(BaseRenderableSeries3D, _super);
     /**
      * Creates an instance of the {@link BaseRenderableSeries3D}
      * @param webAssemblyContext The {@link TSciChart3D | SciChart 3D WebAssembly Context} containing
@@ -23,17 +44,23 @@ var BaseRenderableSeries3D = /** @class */ (function () {
      * @protected
      */
     function BaseRenderableSeries3D(webAssemblyContext, options) {
+        var _this = this;
         var _a, _b;
-        this.id = (_a = options === null || options === void 0 ? void 0 : options.id) !== null && _a !== void 0 ? _a : (0, guid_1.generateGuid)();
-        this.webAssemblyContext = webAssemblyContext;
-        this.dataSeriesProperty = (options === null || options === void 0 ? void 0 : options.dataSeries) || undefined;
-        this.isVisibleProperty = (options === null || options === void 0 ? void 0 : options.isVisible) !== undefined ? options === null || options === void 0 ? void 0 : options.isVisible : true;
-        this.pointMarkerProperty = (options === null || options === void 0 ? void 0 : options.pointMarker) || undefined;
-        this.strokeProperty = (options === null || options === void 0 ? void 0 : options.stroke) || "#FFFFFF";
-        this.shininessProperty = (options === null || options === void 0 ? void 0 : options.shininess) === undefined ? 64 : options.shininess;
-        this.opacityProperty = (_b = options === null || options === void 0 ? void 0 : options.opacity) !== null && _b !== void 0 ? _b : 1;
-        this.pointMarkerPropertyChanged = this.pointMarkerPropertyChanged.bind(this);
-        this.onDpiChanged = this.onDpiChanged.bind(this);
+        _this = _super.call(this) || this;
+        _this.id = (_a = options === null || options === void 0 ? void 0 : options.id) !== null && _a !== void 0 ? _a : (0, guid_1.generateGuid)();
+        _this.webAssemblyContext = webAssemblyContext;
+        _this.dataSeriesDataChanged = _this.dataSeriesDataChanged.bind(_this);
+        _this.pointMarkerPropertyChanged = _this.pointMarkerPropertyChanged.bind(_this);
+        _this.onDpiChanged = _this.onDpiChanged.bind(_this);
+        _this.hitTest = _this.hitTest.bind(_this);
+        _this.enrichHitTest = _this.enrichHitTest.bind(_this);
+        _this.dataSeries = (options === null || options === void 0 ? void 0 : options.dataSeries) || undefined;
+        _this.isVisibleProperty = (options === null || options === void 0 ? void 0 : options.isVisible) !== undefined ? options === null || options === void 0 ? void 0 : options.isVisible : true;
+        _this.pointMarkerProperty = (options === null || options === void 0 ? void 0 : options.pointMarker) || undefined;
+        _this.strokeProperty = (options === null || options === void 0 ? void 0 : options.stroke) || "#FFFFFF";
+        _this.shininessProperty = (options === null || options === void 0 ? void 0 : options.shininess) === undefined ? 64 : options.shininess;
+        _this.opacityProperty = (_b = options === null || options === void 0 ? void 0 : options.opacity) !== null && _b !== void 0 ? _b : 1;
+        return _this;
     }
     /** @inheritDoc */
     BaseRenderableSeries3D.prototype.applyTheme = function (themeProvider) {
@@ -106,7 +133,11 @@ var BaseRenderableSeries3D = /** @class */ (function () {
         },
         /** @inheritDoc */
         set: function (dataSeries) {
+            var _a, _b;
+            this.dataSeriesProperty = dataSeries;
+            (_a = this.dataSeriesProperty) === null || _a === void 0 ? void 0 : _a.dataChanged.unsubscribe(this.dataSeriesDataChanged);
             this.dataSeriesProperty = dataSeries;
+            (_b = this.dataSeriesProperty) === null || _b === void 0 ? void 0 : _b.dataChanged.subscribe(this.dataSeriesDataChanged);
             this.notifyPropertyChanged(Constants_1.PROPERTY.DATA_SERIES);
         },
         enumerable: false,
@@ -179,6 +210,41 @@ var BaseRenderableSeries3D = /** @class */ (function () {
         var _a;
         (_a = this.sceneEntityProperty) === null || _a === void 0 ? void 0 : _a.onDpiChanged(args);
     };
+    /** @inheritDoc */
+    BaseRenderableSeries3D.prototype.hitTest = function (screenPoint) {
+        if (this.parentSurface && !this.parentSurface.isHitTestEnabled) {
+            throw new Error("Enable hit-test functions by setting SciChart3DSurface.isHitTestEnabled = true");
+        }
+        var hitTestFunc = this.sceneEntity.hitTest;
+        if (hitTestFunc) {
+            return this.enrichHitTest(hitTestFunc(screenPoint));
+        }
+        return SeriesInfo3D_1.SeriesInfo3D.empty();
+    };
+    /**
+     * Is being called when the data for the underlying DataSeries changes
+     * @protected
+     */
+    BaseRenderableSeries3D.prototype.dataSeriesDataChanged = function () {
+        if (this.invalidateParentCallback) {
+            this.invalidateParentCallback();
+        }
+    };
+    BaseRenderableSeries3D.prototype.enrichHitTest = function (hitTestInfo) {
+        var _a;
+        var hitDataSeries = (_a = hitTestInfo.associatedSeries) === null || _a === void 0 ? void 0 : _a.dataSeries;
+        if (!hitDataSeries) {
+            return SeriesInfo3D_1.SeriesInfo3D.empty();
+        }
+        switch (hitDataSeries.type) {
+            case BaseDataSeries3D_1.EDataSeriesType3D.Xyz3D:
+                return new XyzSeriesInfo3D_1.XyzSeriesInfo3D(this, hitTestInfo);
+            case BaseDataSeries3D_1.EDataSeriesType3D.UniformGrid3D:
+                return new SurfaceMeshSeriesInfo3D_1.SurfaceMeshSeriesInfo3D(this, hitTestInfo);
+            default:
+                throw new Error("Unknown data series type " + hitDataSeries.type);
+        }
+    };
     /**
      * Used internally - sets the {@link IRenderableSeriesSceneEntity | 3D Scene Entity}
      * @param sceneEntity
@@ -217,5 +283,5 @@ var BaseRenderableSeries3D = /** @class */ (function () {
         this.notifyPropertyChanged("pointMarker." + args.propertyName);
     };
     return BaseRenderableSeries3D;
-}());
+}(DeletableEntity_1.DeletableEntity));
 exports.BaseRenderableSeries3D = BaseRenderableSeries3D;

package/Charting3D/Visuals/RenderableSeries/Constants.d.ts

@@ -12,6 +12,8 @@ export declare enum PROPERTY {
     GRADIENT_STOPS = "GRADIENT_STOPS",
     HEIGHT_SCALE_FACTOR = "HEIGHT_SCALE_FACTOR",
     HIGHLIGHT = "HIGHLIGHT",
+    IS_ANTIALIASED = "IS_ANTIALIASED",
+    IS_LINE_STRIP = "IS_LINE_STRIP",
     IS_VISIBLE = "IS_VISIBLE",
     LIGHTING_FACTOR = "LIGHTING_FACTOR",
     MAXIMUM = "MAXIMUM",

package/Charting3D/Visuals/RenderableSeries/Constants.js

@@ -16,6 +16,8 @@ var PROPERTY;
     PROPERTY["GRADIENT_STOPS"] = "GRADIENT_STOPS";
     PROPERTY["HEIGHT_SCALE_FACTOR"] = "HEIGHT_SCALE_FACTOR";
     PROPERTY["HIGHLIGHT"] = "HIGHLIGHT";
+    PROPERTY["IS_ANTIALIASED"] = "IS_ANTIALIASED";
+    PROPERTY["IS_LINE_STRIP"] = "IS_LINE_STRIP";
     PROPERTY["IS_VISIBLE"] = "IS_VISIBLE";
     PROPERTY["LIGHTING_FACTOR"] = "LIGHTING_FACTOR";
     PROPERTY["MAXIMUM"] = "MAXIMUM";

package/Charting3D/Visuals/RenderableSeries/ESeriesType.d.ts

@@ -3,5 +3,6 @@
  */
 export declare enum ESeriesType3D {
     ScatterRenderableSeries3D = "ScatterRenderableSeries3D",
-    SurfaceMeshRenderableSeries3D = "SurfaceMeshRenderableSeries3D"
+    SurfaceMeshRenderableSeries3D = "SurfaceMeshRenderableSeries3D",
+    PointLineRenderableSeries3D = "PointLineRenderableSeries3D"
 }

package/Charting3D/Visuals/RenderableSeries/ESeriesType.js

@@ -8,4 +8,5 @@ var ESeriesType3D;
 (function (ESeriesType3D) {
     ESeriesType3D["ScatterRenderableSeries3D"] = "ScatterRenderableSeries3D";
     ESeriesType3D["SurfaceMeshRenderableSeries3D"] = "SurfaceMeshRenderableSeries3D";
+    ESeriesType3D["PointLineRenderableSeries3D"] = "PointLineRenderableSeries3D";
 })(ESeriesType3D = exports.ESeriesType3D || (exports.ESeriesType3D = {}));