scichart 3.1.348 → 3.2.0-beta

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

@@ -1,23 +1,17 @@
 import { INotifyOnDpiChanged, TDpiChangedEventArgs } from "../../../Charting/Visuals/TextureManager/DpiHelper";
+import { DeletableEntity } from "../../../Core/DeletableEntity";
 import { IDeletable } from "../../../Core/IDeletable";
 import { ObservableArray } from "../../../Core/ObservableArray";
 import { ESceneEntityType } from "../../../types/SceneEntityType";
 import { SCRTSceneEntity, TSciChart3D } from "../../../types/TSciChart3D";
 import { RootSceneEntity } from "../RootSceneEntity";
+import { IEntityIdProvider } from "./EntityIdProvider";
 import { RenderPassInfo3D } from "./RenderPassInfo3D";
 /**
  * @summary Defines the interface to a {@link BaseSceneEntity3D}, which provides a base class for entities, or 3D objects in the 3D scene within
  * SciChart's High Performance {@link https://www.scichart.com/javascript-chart-features | JavaScript 3D Charts}
  */
 export interface IBaseSceneEntity extends IDeletable, INotifyOnDpiChanged {
-    /**
-     * A unique Id for the {@link IBaseSceneEntity}
-     */
-    readonly id: string;
-    /**
-     * Gets the type of Scene Entity. See {@link ESceneEntityType} for a list of values
-     */
-    readonly type: ESceneEntityType;
     /**
      * @summary Gets the collection of {@link IBaseSceneEntity} - child entities or 3D Objects which belong to this entity.
      * @description A {@link SciChart3DSurface} has a {@link SciChart3DSurface.rootEntity} property. You can add {@link BaseSceneEntity3D}
@@ -29,36 +23,43 @@ export interface IBaseSceneEntity extends IDeletable, INotifyOnDpiChanged {
      */
     readonly children: ObservableArray<IBaseSceneEntity>;
     /**
-     * A unique integer ID for the entity. This will be auto-generated and used to identify the entity later when tooltips are used
+     * A unique Id for the {@link IBaseSceneEntity}
      */
-    entityId: number;
+    readonly id: string;
     /**
      * When true, the entity and it's children are visible in the 3D Scene
      */
     isVisible: boolean;
+    /**
+     * Gets the native {@link SCRTSceneEntity} - a WebAssembly 3D Scene Entity type which is
+     * passed to our WebGL WebAssembly 3D Engine
+     */
+    nativeEntity: SCRTSceneEntity;
     /**
      * Gets the parent {@link IBaseSceneEntity}
      */
     parent: IBaseSceneEntity;
     /**
-     * Gets the native {@link SCRTSceneEntity} - a WebAssembly 3D Scene Entity type which is
-     * passed to our WebGL WebAssembly 3D Engine
+     * Gets the type of Scene Entity. See {@link ESceneEntityType} for a list of values
      */
-    nativeEntity: SCRTSceneEntity;
+    readonly type: ESceneEntityType;
     /**
-     * Gets the root entity in the 3D Scene
+     * Gets or sets the {@link IEntityIdProvider} which generates unique mesh Ids for {@link IBaseSceneEntity
      */
-    getRoot(): RootSceneEntity;
+    entityIdProvider: IEntityIdProvider;
     /**
-     * Visitor function to perform on this entity and all it's children
-     * @param operation The function to perform
+     * Gets or sets a unique Id for the {@link IBaseSceneEntity}. The SciChart3D engine requires Ids fit into UInt32 (4 billion)
      */
-    visitEntities(operation: (e: IBaseSceneEntity) => void): void;
+    entityId: number;
     /**
-     * Sets the {@link RenderPassInfo3D} - render pass info, properties and data for the current rendering pass
-     * @param rpd
+     * Gets the first child {@link IBaseSceneEntity} of type specified by {@link ESceneEntityType}
+     * @param type
      */
-    setRenderPassData(rpd: RenderPassInfo3D): void;
+    getEntity(type: ESceneEntityType): IBaseSceneEntity;
+    /**
+     * Gets the root entity in the 3D Scene
+     */
+    getRoot(): RootSceneEntity;
     /**
      * Called when the {@link IBaseSceneEntity} is attached to the parent scene
      */
@@ -72,10 +73,15 @@ export interface IBaseSceneEntity extends IDeletable, INotifyOnDpiChanged {
      */
     onEngineRestart(): void;
     /**
-     * Gets the first child {@link IBaseSceneEntity} of type specified by {@link ESceneEntityType}
-     * @param type
+     * Sets the {@link RenderPassInfo3D} - render pass info, properties and data for the current rendering pass
+     * @param rpd
      */
-    getEntity(type: ESceneEntityType): IBaseSceneEntity;
+    setRenderPassData(rpd: RenderPassInfo3D): void;
+    /**
+     * Visitor function to perform on this entity and all it's children
+     * @param operation The function to perform
+     */
+    visitEntities(operation: (e: IBaseSceneEntity) => void): void;
 }
 /**
  * The {@link BaseSceneEntity3D} provides a base class for entities, or 3D objects in the 3D scene within
@@ -84,7 +90,7 @@ export interface IBaseSceneEntity extends IDeletable, INotifyOnDpiChanged {
  * the {@link nativeEntity} property. This is passed to SciChart's 3D engine and inserted into the scene when added
  * to the {@link SciChart3DSurface.rootEntity} collection.
  */
-export declare abstract class BaseSceneEntity3D<TNativeEntity extends SCRTSceneEntity> implements IBaseSceneEntity {
+export declare abstract class BaseSceneEntity3D<TNativeEntity extends SCRTSceneEntity> extends DeletableEntity implements IBaseSceneEntity {
     /** @inheritDoc */
     readonly id: string;
     /** @inheritDoc */
@@ -105,13 +111,14 @@ export declare abstract class BaseSceneEntity3D<TNativeEntity extends SCRTSceneE
      * The {@link TSciChart3D | SciChart 3D WebAssembly Context} containing native methods and
      * access to our WebGL2 Engine and WebAssembly numerical methods
      */
-    protected readonly webAssemblyContext: TSciChart3D;
+    protected webAssemblyContext: TSciChart3D;
     /**
      * The {@link RenderPassInfo3D} containing data about the current rendering pass
      * @protected
      */
     protected currentRenderPassData: RenderPassInfo3D;
     private nativeEntityProperty;
+    private entityIdProviderProperty;
     private entityIdProperty;
     /**
      * Creates an instance of the {@link BaseSceneEntity3D}
@@ -121,6 +128,14 @@ export declare abstract class BaseSceneEntity3D<TNativeEntity extends SCRTSceneE
      */
     protected constructor(webAssemblyContext: TSciChart3D);
     /** @inheritDoc */
+    get entityIdProvider(): IEntityIdProvider;
+    /** @inheritDoc */
+    set entityIdProvider(value: IEntityIdProvider);
+    /** @inheritDoc */
+    get entityId(): number;
+    /** @inheritDoc */
+    set entityId(value: number);
+    /** @inheritDoc */
     getRoot(): RootSceneEntity;
     /** @inheritDoc */
     delete(): void;
@@ -142,10 +157,6 @@ export declare abstract class BaseSceneEntity3D<TNativeEntity extends SCRTSceneE
     /** @inheritDoc */
     onDpiChanged(args: TDpiChangedEventArgs): void;
     /** @inheritDoc */
-    get entityId(): number;
-    /** @inheritDoc */
-    set entityId(value: number);
-    /** @inheritDoc */
     setRenderPassData(rpd: RenderPassInfo3D): void;
     /** @inheritDoc */
     getEntity(type: ESceneEntityType): IBaseSceneEntity;

package/Charting3D/Visuals/Primitives/BaseSceneEntity3D.js

@@ -1,7 +1,24 @@
 "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.BaseSceneEntity3D = void 0;
+var DeletableEntity_1 = require("../../../Core/DeletableEntity");
 var Deleter_1 = require("../../../Core/Deleter");
+var Guard_1 = require("../../../Core/Guard");
 var ObservableArray_1 = require("../../../Core/ObservableArray");
 var SceneEntityType_1 = require("../../../types/SceneEntityType");
 var guid_1 = require("../../../utils/guid");
@@ -12,7 +29,8 @@ var guid_1 = require("../../../utils/guid");
  * the {@link nativeEntity} property. This is passed to SciChart's 3D engine and inserted into the scene when added
  * to the {@link SciChart3DSurface.rootEntity} collection.
  */
-var BaseSceneEntity3D = /** @class */ (function () {
+var BaseSceneEntity3D = /** @class */ (function (_super) {
+    __extends(BaseSceneEntity3D, _super);
     /**
      * Creates an instance of the {@link BaseSceneEntity3D}
      * @param webAssemblyContext The {@link TSciChart3D | SciChart 3D WebAssembly Context} containing native methods and
@@ -20,25 +38,65 @@ var BaseSceneEntity3D = /** @class */ (function () {
      * @protected
      */
     function BaseSceneEntity3D(webAssemblyContext) {
-        var _this = this;
+        var _this = _super.call(this) || this;
         /** @inheritDoc */
-        this.id = (0, guid_1.generateGuid)();
+        _this.id = (0, guid_1.generateGuid)();
         /**
          * When true, the entity and all its children are visible
          */
-        this.isVisible = true;
-        this.webAssemblyContext = webAssemblyContext;
-        this.entityId = 11111;
-        this.detachChild = this.detachChild.bind(this);
-        this.attachChild = this.attachChild.bind(this);
-        this.children = new ObservableArray_1.ObservableArray();
-        this.children.collectionChanged.subscribe(function (args) {
+        _this.isVisible = true;
+        _this.entityIdProperty = undefined;
+        Guard_1.Guard.notNull(webAssemblyContext, "webAssemblyContext");
+        _this.webAssemblyContext = webAssemblyContext;
+        _this.detachChild = _this.detachChild.bind(_this);
+        _this.attachChild = _this.attachChild.bind(_this);
+        _this.children = new ObservableArray_1.ObservableArray();
+        _this.children.collectionChanged.subscribe(function (args) {
             var _a, _b;
             (_a = args.getOldItems()) === null || _a === void 0 ? void 0 : _a.forEach(_this.detachChild);
             (_b = args.getNewItems()) === null || _b === void 0 ? void 0 : _b.forEach(_this.attachChild);
         });
-        this.onDpiChanged = this.onDpiChanged.bind(this);
+        _this.onDpiChanged = _this.onDpiChanged.bind(_this);
+        return _this;
     }
+    Object.defineProperty(BaseSceneEntity3D.prototype, "entityIdProvider", {
+        /** @inheritDoc */
+        get: function () {
+            return this.entityIdProviderProperty;
+        },
+        /** @inheritDoc */
+        set: function (value) {
+            var _this = this;
+            this.entityIdProviderProperty = value;
+            // Assign an entity Id to this entity
+            if (!this.entityId && this.entityIdProviderProperty) {
+                this.entityId = this.entityIdProviderProperty.getNextEntityId();
+            }
+            // Pass entityIdProvider down to child entities except this
+            this.visitEntities(function (e) {
+                if (e !== _this) {
+                    e.entityIdProvider = value;
+                }
+            });
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(BaseSceneEntity3D.prototype, "entityId", {
+        /** @inheritDoc */
+        get: function () {
+            return this.entityIdProperty;
+        },
+        /** @inheritDoc */
+        set: function (value) {
+            var _a;
+            this.entityIdProperty = value;
+            (_a = this.nativeEntityProperty) === null || _a === void 0 ? void 0 : _a.SetEntityId(value);
+            this.invalidateScene();
+        },
+        enumerable: false,
+        configurable: true
+    });
     /** @inheritDoc */
     BaseSceneEntity3D.prototype.getRoot = function () {
         if (this.type === SceneEntityType_1.ESceneEntityType.RootSceneEntity) {
@@ -55,11 +113,14 @@ var BaseSceneEntity3D = /** @class */ (function () {
     };
     /** @inheritDoc */
     BaseSceneEntity3D.prototype.delete = function () {
+        var _a;
         this.children.asArray().forEach(function (el) { return el.delete(); });
+        (_a = this.entityIdProvider) === null || _a === void 0 ? void 0 : _a.releaseEntityId(this.entityId);
         if (this.nativeEntity) {
             this.world.RemoveEntity(this.nativeEntity);
         }
         this.nativeEntityProperty = (0, Deleter_1.deleteSafe)(this.nativeEntityProperty);
+        this.webAssemblyContext = undefined;
     };
     /**
      * Update method called from WebAssembly engine. Use this to update meshes, properties, geometry before draw.
@@ -103,19 +164,6 @@ var BaseSceneEntity3D = /** @class */ (function () {
     };
     /** @inheritDoc */
     BaseSceneEntity3D.prototype.onDpiChanged = function (args) { };
-    Object.defineProperty(BaseSceneEntity3D.prototype, "entityId", {
-        /** @inheritDoc */
-        get: function () {
-            return this.entityIdProperty;
-        },
-        /** @inheritDoc */
-        set: function (value) {
-            this.entityIdProperty = value;
-            // TODO: this.nativeEntity.SetEntityId(value)
-        },
-        enumerable: false,
-        configurable: true
-    });
     /** @inheritDoc */
     BaseSceneEntity3D.prototype.setRenderPassData = function (rpd) {
         this.currentRenderPassData = rpd;
@@ -173,10 +221,10 @@ var BaseSceneEntity3D = /** @class */ (function () {
      */
     BaseSceneEntity3D.prototype.attachChild = function (childEntity) {
         var _a;
-        // TODO: entity.EntityIdProvider = this.EntityIdProvider;
         var parentEntity = this;
         (_a = parentEntity.nativeEntity) === null || _a === void 0 ? void 0 : _a.AddChildEntityInternal(childEntity.nativeEntity);
         childEntity.parent = parentEntity;
+        childEntity.entityIdProvider = this.entityIdProvider;
         childEntity.onAttached();
     };
     /**
@@ -197,7 +245,11 @@ var BaseSceneEntity3D = /** @class */ (function () {
      * @protected
      */
     BaseSceneEntity3D.prototype.setNativeEntity = function (entity) {
+        var _a;
         this.nativeEntityProperty = entity;
+        if (this.entityId) {
+            (_a = this.nativeEntityProperty) === null || _a === void 0 ? void 0 : _a.SetEntityId(this.entityId);
+        }
     };
     Object.defineProperty(BaseSceneEntity3D.prototype, "world", {
         /**
@@ -211,5 +263,5 @@ var BaseSceneEntity3D = /** @class */ (function () {
         configurable: true
     });
     return BaseSceneEntity3D;
-}());
+}(DeletableEntity_1.DeletableEntity));
 exports.BaseSceneEntity3D = BaseSceneEntity3D;

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

@@ -0,0 +1,47 @@
+import { ESceneEntityType } from "../../../types/SceneEntityType";
+import { SCRTSceneEntity } from "../../../types/TSciChart3D";
+import { Vector3 } from "../../Vector3";
+import { TSciChart3D } from "../SciChart3DSurface";
+import { BaseSceneEntity3D } from "./BaseSceneEntity3D";
+/**
+ * Draws a crosshair from the {@link location} to the walls of the bounding box (defined by {@link worldDimensions}).
+ * Properties {@link stroke}, {@link strokeThickness} and {@link antiAliased} can be used to customize the appearance of the line.
+ * The {@link CrosshairLinesSceneEntity} inherits {@link BaseSceneEntity3D} and can be added to the {@link SciChart3DSurface}
+ * via the {@link SciChart3DSurface.rootEntity} property.
+ */
+export declare class CrosshairLinesSceneEntity extends BaseSceneEntity3D<SCRTSceneEntity> {
+    /** @inheritDoc */
+    readonly type = ESceneEntityType.Custom;
+    /**
+     * The location of the crosshair in 3D space
+     */
+    location: Vector3;
+    /**
+     * The world dimensions of the bounding box, which should match {@link SciChart3DSurface.worldDimensions}
+     */
+    worldDimensions: Vector3;
+    /**
+     * The camera position in 3D space, which is used to compute vectors
+     */
+    cameraPosition: Vector3;
+    /**
+     * The strokethickness of crosshair lines
+     */
+    strokeThickness: number;
+    /**
+     * The stroke of crosshair lines
+     */
+    stroke: string;
+    /**
+     * Whether crosshair lines are antialiased or not
+     */
+    antiAliased: boolean;
+    private linesMesh;
+    constructor(webAssemblyContext: TSciChart3D);
+    /** @inheritDoc */
+    delete(): void;
+    /** @inheritDoc */
+    Render(): void;
+    private inInWorldDimensions;
+    private getWallVector;
+}

package/Charting3D/Visuals/Primitives/CrosshairLinesSceneEntity.js

@@ -0,0 +1,106 @@
+"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.CrosshairLinesSceneEntity = void 0;
+var Deleter_1 = require("../../../Core/Deleter");
+var SceneEntityType_1 = require("../../../types/SceneEntityType");
+var parseColor_1 = require("../../../utils/parseColor");
+var Vector3_1 = require("../../Vector3");
+var BaseSceneEntity3D_1 = require("./BaseSceneEntity3D");
+/**
+ * Draws a crosshair from the {@link location} to the walls of the bounding box (defined by {@link worldDimensions}).
+ * Properties {@link stroke}, {@link strokeThickness} and {@link antiAliased} can be used to customize the appearance of the line.
+ * The {@link CrosshairLinesSceneEntity} inherits {@link BaseSceneEntity3D} and can be added to the {@link SciChart3DSurface}
+ * via the {@link SciChart3DSurface.rootEntity} property.
+ */
+var CrosshairLinesSceneEntity = /** @class */ (function (_super) {
+    __extends(CrosshairLinesSceneEntity, _super);
+    function CrosshairLinesSceneEntity(webAssemblyContext) {
+        var _this = _super.call(this, webAssemblyContext) || this;
+        /** @inheritDoc */
+        _this.type = SceneEntityType_1.ESceneEntityType.Custom;
+        /**
+         * The strokethickness of crosshair lines
+         */
+        _this.strokeThickness = 2;
+        /**
+         * The stroke of crosshair lines
+         */
+        _this.stroke = "#FF6600";
+        /**
+         * Whether crosshair lines are antialiased or not
+         */
+        _this.antiAliased = true;
+        // Required to get callbacks on Update() and Render() from Wasm to JS
+        _this.setNativeEntity(webAssemblyContext.SCRTSceneEntity.implement(_this));
+        return _this;
+    }
+    /** @inheritDoc */
+    CrosshairLinesSceneEntity.prototype.delete = function () {
+        _super.prototype.delete.call(this);
+        this.linesMesh = (0, Deleter_1.deleteSafe)(this.linesMesh);
+    };
+    /** @inheritDoc */
+    CrosshairLinesSceneEntity.prototype.Render = function () {
+        if (!this.isVisible || !this.worldDimensions || !this.cameraPosition || !this.location)
+            return;
+        var wallVector = this.getWallVector();
+        this.linesMesh = (0, Deleter_1.deleteSafe)(this.linesMesh);
+        // Linesmesh with isStrips=false means eacn x0y0 x1y1 pair is a separate line segment
+        var linesMesh = new this.webAssemblyContext.SCRTLinesMesh(this.strokeThickness, false, this.antiAliased);
+        linesMesh.SetVertexColor((0, parseColor_1.parseColorToUIntArgb)(this.stroke));
+        // Draw a line to XY wall from the cursor spot, if in bounds
+        if (this.inInWorldDimensions(this.location.x, this.location.y, 0, this.worldDimensions)) {
+            linesMesh.SetVertex3(this.location.x, this.location.y, this.location.z);
+            linesMesh.SetVertex3(this.location.x, this.location.y, wallVector.z);
+        }
+        // Draw a line to XZ wall from the cursor spot, if in bounds
+        if (this.inInWorldDimensions(this.location.x, 0, this.location.z, this.worldDimensions)) {
+            linesMesh.SetVertex3(this.location.x, this.location.y, this.location.z);
+            linesMesh.SetVertex3(this.location.x, wallVector.y, this.location.z);
+        }
+        // Draw a line to the YZ wall from the cursor spot, if in bounds
+        if (this.inInWorldDimensions(0, this.location.y, 0, this.worldDimensions)) {
+            linesMesh.SetVertex3(this.location.x, this.location.y, this.location.z);
+            linesMesh.SetVertex3(wallVector.x, this.location.y, this.location.z);
+        }
+        // No further changes possible
+        linesMesh.Freeze();
+        // Draw
+        linesMesh.Render();
+    };
+    CrosshairLinesSceneEntity.prototype.inInWorldDimensions = function (x, y, z, worldDimensions) {
+        return (y >= 0 &&
+            y <= worldDimensions.y &&
+            z >= -worldDimensions.z / 2 &&
+            z <= worldDimensions.z / 2 &&
+            x >= -worldDimensions.x / 2 &&
+            x <= worldDimensions.x / 2);
+    };
+    CrosshairLinesSceneEntity.prototype.getWallVector = function () {
+        var x = this.cameraPosition.dotProduct(new Vector3_1.Vector3(1, 0, 0)) > 0
+            ? -this.worldDimensions.x * 0.5
+            : this.worldDimensions.x * 0.5;
+        var y = this.cameraPosition.dotProduct(new Vector3_1.Vector3(0, 1, 0)) > 0 ? 0 : this.worldDimensions.y;
+        var z = this.cameraPosition.dotProduct(new Vector3_1.Vector3(0, 0, 1)) > 0
+            ? -this.worldDimensions.z * 0.5
+            : this.worldDimensions.z * 0.5;
+        return new Vector3_1.Vector3(x, y, z);
+    };
+    return CrosshairLinesSceneEntity;
+}(BaseSceneEntity3D_1.BaseSceneEntity3D));
+exports.CrosshairLinesSceneEntity = CrosshairLinesSceneEntity;

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

@@ -0,0 +1,29 @@
+/**
+ * An EntityIdProvider generates integer Ids (must fit into UInt32) for meshs in the SciChart3D engine
+ * There is a maximum of 4 billion vertices or meshes in the scene in any combination.
+ * Users can override and implement their own IdProvider to recycle Ids if they wish
+ */
+export interface IEntityIdProvider {
+    /**
+     * Gets the next available EntityId (max value UInt32 is 4 billion)
+     */
+    getNextEntityId(): number;
+    /**
+     * Optional: releases an Id when an entity is removed fro the scene in the case where max mesh ID is hit
+     * @param id
+     */
+    releaseEntityId(id: number): void;
+}
+/**
+ * Default implementation of {@link IEntityIdProvider}. This implementation generates Ids from 0 to 4 billion
+ * and does not recycle Ids. If you encounter the error "The max Mesh ID has been exceeded", you can override
+ * releaseEntityId to create a more sophisticated IdProvider to recycle Ids.
+ */
+export declare class DefaultEntityIdProvider implements IEntityIdProvider {
+    private currentId;
+    private maxId;
+    /** @inheritdoc */
+    getNextEntityId(): number;
+    /** @inheritdoc */
+    releaseEntityId(id: number): void;
+}

package/Charting3D/Visuals/Primitives/EntityIdProvider.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultEntityIdProvider = void 0;
+/**
+ * Default implementation of {@link IEntityIdProvider}. This implementation generates Ids from 0 to 4 billion
+ * and does not recycle Ids. If you encounter the error "The max Mesh ID has been exceeded", you can override
+ * releaseEntityId to create a more sophisticated IdProvider to recycle Ids.
+ */
+var DefaultEntityIdProvider = /** @class */ (function () {
+    function DefaultEntityIdProvider() {
+        this.currentId = -1;
+        this.maxId = 4294967295; // UInt32.MaxValue
+    }
+    /** @inheritdoc */
+    DefaultEntityIdProvider.prototype.getNextEntityId = function () {
+        var id = ++this.currentId;
+        if (id >= this.maxId) {
+            throw new Error("The max Mesh ID has been exceeded.  Please see https://www.scichart.com/questions/wpf/maximum-mesh-id");
+        }
+        return id;
+    };
+    /** @inheritdoc */
+    DefaultEntityIdProvider.prototype.releaseEntityId = function (id) {
+        // placeholder for users to override and recycle Ids
+    };
+    return DefaultEntityIdProvider;
+}());
+exports.DefaultEntityIdProvider = DefaultEntityIdProvider;

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

@@ -0,0 +1,51 @@
+import { Point } from "../../../Core/Point";
+import { ESceneEntityType } from "../../../types/SceneEntityType";
+import { SCRTPointLine3DSceneEntity, TSciChart3D } from "../../../types/TSciChart3D";
+import { HitTestInfo3D } from "../RenderableSeries/HitTestInfo3D";
+import { PointLineRenderableSeries3D } from "../RenderableSeries/PointLineRenderableSeries3D";
+import { RenderableSeriesSceneEntity } from "./RenderableSeriesSceneEntity";
+import { RenderableSeriesSceneEntityState } from "./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
+ */
+export declare class PointLine3DSceneEntity extends RenderableSeriesSceneEntity<PointLineRenderableSeries3D, RenderableSeriesSceneEntityState, SCRTPointLine3DSceneEntity> {
+    /**
+     * @inheritDoc
+     */
+    readonly type: ESceneEntityType;
+    private pointColors;
+    private pointScales;
+    /**
+     * 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
+     */
+    constructor(webAssemblyContext: TSciChart3D, parentSeries: PointLineRenderableSeries3D);
+    /**
+     * @inheritDoc
+     */
+    delete(): void;
+    /**
+     * @inheritDoc
+     */
+    Render(): void;
+    /**
+     * @inheritDoc
+     * @param propertyName
+     */
+    notifySeriesPropertyChanged(propertyName: string): void;
+    /**
+     * @inheritDoc
+     */
+    hitTest(screenPoint: Point): HitTestInfo3D;
+    /**
+     * @inheritDoc
+     */
+    protected updateSeries(): void;
+    private updatePointMarker;
+    private rebuildPointMetadata;
+}