@babylonjs/core 8.11.0 → 8.12.0

package/Particles/Node/nodeParticleBlockConnectionPoint.js

@@ -0,0 +1,337 @@
+import { Observable } from "../../Misc/observable.js";
+import { NodeParticleBlockConnectionPointTypes } from "./Enums/nodeParticleBlockConnectionPointTypes.js";
+/**
+ * Enum used to define the compatibility state between two connection points
+ */
+export var NodeParticleConnectionPointCompatibilityStates;
+(function (NodeParticleConnectionPointCompatibilityStates) {
+    /** Points are compatibles */
+    NodeParticleConnectionPointCompatibilityStates[NodeParticleConnectionPointCompatibilityStates["Compatible"] = 0] = "Compatible";
+    /** Points are incompatible because of their types */
+    NodeParticleConnectionPointCompatibilityStates[NodeParticleConnectionPointCompatibilityStates["TypeIncompatible"] = 1] = "TypeIncompatible";
+    /** Points are incompatible because they are in the same hierarchy **/
+    NodeParticleConnectionPointCompatibilityStates[NodeParticleConnectionPointCompatibilityStates["HierarchyIssue"] = 2] = "HierarchyIssue";
+})(NodeParticleConnectionPointCompatibilityStates || (NodeParticleConnectionPointCompatibilityStates = {}));
+/**
+ * Defines the direction of a connection point
+ */
+export var NodeParticleConnectionPointDirection;
+(function (NodeParticleConnectionPointDirection) {
+    /** Input */
+    NodeParticleConnectionPointDirection[NodeParticleConnectionPointDirection["Input"] = 0] = "Input";
+    /** Output */
+    NodeParticleConnectionPointDirection[NodeParticleConnectionPointDirection["Output"] = 1] = "Output";
+})(NodeParticleConnectionPointDirection || (NodeParticleConnectionPointDirection = {}));
+/**
+ * Defines a connection point for a block
+ */
+export class NodeParticleConnectionPoint {
+    /** Gets the direction of the point */
+    get direction() {
+        return this._direction;
+    }
+    /**
+     * Gets or sets the connection point type (default is float)
+     */
+    get type() {
+        if (this._type === NodeParticleBlockConnectionPointTypes.AutoDetect) {
+            if (this._ownerBlock.isInput) {
+                return this._ownerBlock.type;
+            }
+            if (this._connectedPoint) {
+                return this._connectedPoint.type;
+            }
+            if (this._linkedConnectionSource) {
+                if (this._linkedConnectionSource.isConnected) {
+                    return this._linkedConnectionSource.type;
+                }
+                if (this._linkedConnectionSource._defaultConnectionPointType) {
+                    return this._linkedConnectionSource._defaultConnectionPointType;
+                }
+            }
+            if (this._defaultConnectionPointType) {
+                return this._defaultConnectionPointType;
+            }
+        }
+        if (this._type === NodeParticleBlockConnectionPointTypes.BasedOnInput) {
+            if (this._typeConnectionSource) {
+                if (!this._typeConnectionSource.isConnected && this._defaultConnectionPointType) {
+                    return this._defaultConnectionPointType;
+                }
+                if (this._typeConnectionSourceTranslation) {
+                    return this._typeConnectionSourceTranslation(this._typeConnectionSource.type);
+                }
+                return this._typeConnectionSource.type;
+            }
+            else if (this._defaultConnectionPointType) {
+                return this._defaultConnectionPointType;
+            }
+        }
+        return this._type;
+    }
+    set type(value) {
+        this._type = value;
+    }
+    /**
+     * Gets a boolean indicating that the current point is connected to another NodeMaterialBlock
+     */
+    get isConnected() {
+        return this.connectedPoint !== null || this.hasEndpoints;
+    }
+    /** Get the other side of the connection (if any) */
+    get connectedPoint() {
+        return this._connectedPoint;
+    }
+    /** Get the block that owns this connection point */
+    get ownerBlock() {
+        return this._ownerBlock;
+    }
+    /** Get the block connected on the other side of this connection (if any) */
+    get sourceBlock() {
+        if (!this._connectedPoint) {
+            return null;
+        }
+        return this._connectedPoint.ownerBlock;
+    }
+    /** Get the block connected on the endpoints of this connection (if any) */
+    get connectedBlocks() {
+        if (this._endpoints.length === 0) {
+            return [];
+        }
+        return this._endpoints.map((e) => e.ownerBlock);
+    }
+    /** Gets the list of connected endpoints */
+    get endpoints() {
+        return this._endpoints;
+    }
+    /** Gets a boolean indicating if that output point is connected to at least one input */
+    get hasEndpoints() {
+        return this._endpoints && this._endpoints.length > 0;
+    }
+    /** Get the inner type (ie AutoDetect for instance instead of the inferred one) */
+    get innerType() {
+        if (this._linkedConnectionSource && !this._isMainLinkSource && this._linkedConnectionSource.isConnected) {
+            return this.type;
+        }
+        return this._type;
+    }
+    /**
+     * Creates a new connection point
+     * @param name defines the connection point name
+     * @param ownerBlock defines the block hosting this connection point
+     * @param direction defines the direction of the connection point
+     */
+    constructor(name, ownerBlock, direction) {
+        /** @internal */
+        this._connectedPoint = null;
+        /** @internal */
+        this._storedValue = null;
+        /** @internal */
+        this._storedFunction = null;
+        /** @internal */
+        this._acceptedConnectionPointType = null;
+        this._endpoints = new Array();
+        this._type = NodeParticleBlockConnectionPointTypes.Particle;
+        /** @internal */
+        this._linkedConnectionSource = null;
+        /** @internal */
+        this._typeConnectionSource = null;
+        /** @internal */
+        this._typeConnectionSourceTranslation = null;
+        /** @internal */
+        this._defaultConnectionPointType = null;
+        /** @internal */
+        this._isMainLinkSource = false;
+        /**
+         * Gets or sets the additional types supported by this connection point
+         */
+        this.acceptedConnectionPointTypes = [];
+        /**
+         * Gets or sets the additional types excluded by this connection point
+         */
+        this.excludedConnectionPointTypes = [];
+        /**
+         * Observable triggered when this point is connected
+         */
+        this.onConnectionObservable = new Observable();
+        /**
+         * Observable triggered when this point is disconnected
+         */
+        this.onDisconnectionObservable = new Observable();
+        /**
+         * Gets or sets a boolean indicating that this connection point is exposed on a frame
+         */
+        this.isExposedOnFrame = false;
+        /**
+         * Gets or sets number indicating the position that the port is exposed to on a frame
+         */
+        this.exposedPortPosition = -1;
+        /**
+         * Gets the default value used for this point at creation time
+         */
+        this.defaultValue = null;
+        /**
+         * Gets or sets the default value used for this point if nothing is connected
+         */
+        this.value = null;
+        /**
+         * Gets or sets the min value accepted for this point if nothing is connected
+         */
+        this.valueMin = null;
+        /**
+         * Gets or sets the max value accepted for this point if nothing is connected
+         */
+        this.valueMax = null;
+        this._ownerBlock = ownerBlock;
+        this.name = name;
+        this._direction = direction;
+    }
+    /**
+     * Gets the current class name e.g. "NodeMaterialConnectionPoint"
+     * @returns the class name
+     */
+    getClassName() {
+        return "NodeParticleConnectionPoint";
+    }
+    /**
+     * Gets the value represented by this connection point
+     * @param state current evaluation state
+     * @returns the connected value or the value if nothing is connected
+     */
+    getConnectedValue(state) {
+        if (this.isConnected) {
+            if (this._connectedPoint?._storedFunction) {
+                return this._connectedPoint._storedFunction(state);
+            }
+            return this._connectedPoint._storedValue;
+        }
+        return this.value;
+    }
+    /**
+     * Gets a boolean indicating if the current point can be connected to another point
+     * @param connectionPoint defines the other connection point
+     * @returns a boolean
+     */
+    canConnectTo(connectionPoint) {
+        return this.checkCompatibilityState(connectionPoint) === 0 /* NodeParticleConnectionPointCompatibilityStates.Compatible */;
+    }
+    /**
+     * Gets a number indicating if the current point can be connected to another point
+     * @param connectionPoint defines the other connection point
+     * @returns a number defining the compatibility state
+     */
+    checkCompatibilityState(connectionPoint) {
+        const ownerBlock = this._ownerBlock;
+        const otherBlock = connectionPoint.ownerBlock;
+        if (this.type !== connectionPoint.type && connectionPoint.innerType !== NodeParticleBlockConnectionPointTypes.AutoDetect) {
+            // Accepted types
+            if (connectionPoint.acceptedConnectionPointTypes && connectionPoint.acceptedConnectionPointTypes.indexOf(this.type) !== -1) {
+                return 0 /* NodeParticleConnectionPointCompatibilityStates.Compatible */;
+            }
+            else {
+                return 1 /* NodeParticleConnectionPointCompatibilityStates.TypeIncompatible */;
+            }
+        }
+        // Excluded
+        if (connectionPoint.excludedConnectionPointTypes && connectionPoint.excludedConnectionPointTypes.indexOf(this.type) !== -1) {
+            return 1 /* NodeParticleConnectionPointCompatibilityStates.TypeIncompatible */;
+        }
+        // Check hierarchy
+        let targetBlock = otherBlock;
+        let sourceBlock = ownerBlock;
+        if (this.direction === 0 /* NodeParticleConnectionPointDirection.Input */) {
+            targetBlock = ownerBlock;
+            sourceBlock = otherBlock;
+        }
+        if (targetBlock.isAnAncestorOf(sourceBlock)) {
+            return 2 /* NodeParticleConnectionPointCompatibilityStates.HierarchyIssue */;
+        }
+        return 0 /* NodeParticleConnectionPointCompatibilityStates.Compatible */;
+    }
+    /**
+     * Connect this point to another connection point
+     * @param connectionPoint defines the other connection point
+     * @param ignoreConstraints defines if the system will ignore connection type constraints (default is false)
+     * @returns the current connection point
+     */
+    connectTo(connectionPoint, ignoreConstraints = false) {
+        if (!ignoreConstraints && !this.canConnectTo(connectionPoint)) {
+            // eslint-disable-next-line no-throw-literal
+            throw `Cannot connect these two connectors. source: "${this.ownerBlock.name}".${this.name}, target: "${connectionPoint.ownerBlock.name}".${connectionPoint.name}`;
+        }
+        this._endpoints.push(connectionPoint);
+        connectionPoint._connectedPoint = this;
+        this.onConnectionObservable.notifyObservers(connectionPoint);
+        connectionPoint.onConnectionObservable.notifyObservers(this);
+        return this;
+    }
+    /**
+     * Disconnect this point from one of his endpoint
+     * @param endpoint defines the other connection point
+     * @returns the current connection point
+     */
+    disconnectFrom(endpoint) {
+        const index = this._endpoints.indexOf(endpoint);
+        if (index === -1) {
+            return this;
+        }
+        this._endpoints.splice(index, 1);
+        endpoint._connectedPoint = null;
+        this.onDisconnectionObservable.notifyObservers(endpoint);
+        endpoint.onDisconnectionObservable.notifyObservers(this);
+        return this;
+    }
+    /**
+     * Fill the list of excluded connection point types with all types other than those passed in the parameter
+     * @param mask Types (ORed values of NodeMaterialBlockConnectionPointTypes) that are allowed, and thus will not be pushed to the excluded list
+     */
+    addExcludedConnectionPointFromAllowedTypes(mask) {
+        let bitmask = 1;
+        while (bitmask < NodeParticleBlockConnectionPointTypes.All) {
+            if (!(mask & bitmask)) {
+                this.excludedConnectionPointTypes.push(bitmask);
+            }
+            bitmask = bitmask << 1;
+        }
+    }
+    /**
+     * Serializes this point in a JSON representation
+     * @param isInput defines if the connection point is an input (default is true)
+     * @returns the serialized point object
+     */
+    serialize(isInput = true) {
+        const serializationObject = {};
+        serializationObject.name = this.name;
+        serializationObject.displayName = this.displayName;
+        if (this.value !== undefined && this.value !== null) {
+            if (this.value.asArray) {
+                serializationObject.valueType = "BABYLON." + this.value.getClassName();
+                serializationObject.value = this.value.asArray();
+            }
+            else {
+                serializationObject.valueType = "number";
+                serializationObject.value = this.value;
+            }
+        }
+        if (isInput && this.connectedPoint) {
+            serializationObject.inputName = this.name;
+            serializationObject.targetBlockId = this.connectedPoint.ownerBlock.uniqueId;
+            serializationObject.targetConnectionName = this.connectedPoint.name;
+            serializationObject.isExposedOnFrame = true;
+            serializationObject.exposedPortPosition = this.exposedPortPosition;
+        }
+        if (this.isExposedOnFrame || this.exposedPortPosition >= 0) {
+            serializationObject.isExposedOnFrame = true;
+            serializationObject.exposedPortPosition = this.exposedPortPosition;
+        }
+        return serializationObject;
+    }
+    /**
+     * Release resources
+     */
+    dispose() {
+        this.onConnectionObservable.clear();
+        this.onDisconnectionObservable.clear();
+    }
+}
+//# sourceMappingURL=nodeParticleBlockConnectionPoint.js.map

package/Particles/Node/nodeParticleBlockConnectionPoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeParticleBlockConnectionPoint.js","sourceRoot":"","sources":["../../../../../dev/core/src/Particles/Node/nodeParticleBlockConnectionPoint.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nullable } from \"../../types\";\r\nimport { Observable } from \"../../Misc/observable\";\r\nimport type { NodeParticleBlock } from \"./nodeParticleBlock\";\r\nimport { NodeParticleBlockConnectionPointTypes } from \"./Enums/nodeParticleBlockConnectionPointTypes\";\r\nimport type { NodeParticleBuildState } from \"./nodeParticleBuildState\";\r\nimport type { ParticleInputBlock } from \"./Blocks/particleInputBlock\";\r\n\r\n/**\r\n * Enum used to define the compatibility state between two connection points\r\n */\r\nexport const enum NodeParticleConnectionPointCompatibilityStates {\r\n    /** Points are compatibles */\r\n    Compatible,\r\n    /** Points are incompatible because of their types */\r\n    TypeIncompatible,\r\n    /** Points are incompatible because they are in the same hierarchy **/\r\n    HierarchyIssue,\r\n}\r\n\r\n/**\r\n * Defines the direction of a connection point\r\n */\r\nexport const enum NodeParticleConnectionPointDirection {\r\n    /** Input */\r\n    Input,\r\n    /** Output */\r\n    Output,\r\n}\r\n\r\n/**\r\n * Defines a connection point for a block\r\n */\r\nexport class NodeParticleConnectionPoint {\r\n    /** @internal */\r\n    public _ownerBlock: NodeParticleBlock;\r\n    /** @internal */\r\n    public _connectedPoint: Nullable<NodeParticleConnectionPoint> = null;\r\n\r\n    /** @internal */\r\n    public _storedValue: any = null;\r\n    /** @internal */\r\n    public _storedFunction: Nullable<(state: NodeParticleBuildState) => any> = null;\r\n\r\n    /** @internal */\r\n    public _acceptedConnectionPointType: Nullable<NodeParticleConnectionPoint> = null;\r\n\r\n    private _endpoints = new Array<NodeParticleConnectionPoint>();\r\n    private _direction: NodeParticleConnectionPointDirection;\r\n    private _type = NodeParticleBlockConnectionPointTypes.Particle;\r\n\r\n    /** @internal */\r\n    public _linkedConnectionSource: Nullable<NodeParticleConnectionPoint> = null;\r\n\r\n    /** @internal */\r\n    public _typeConnectionSource: Nullable<NodeParticleConnectionPoint> = null;\r\n\r\n    /** @internal */\r\n    public _typeConnectionSourceTranslation: Nullable<(source: NodeParticleBlockConnectionPointTypes) => NodeParticleBlockConnectionPointTypes> = null;\r\n\r\n    /** @internal */\r\n    public _defaultConnectionPointType: Nullable<NodeParticleBlockConnectionPointTypes> = null;\r\n\r\n    /** @internal */\r\n    public _isMainLinkSource = false;\r\n\r\n    /** Gets the direction of the point */\r\n    public get direction() {\r\n        return this._direction;\r\n    }\r\n\r\n    /**\r\n     * Gets or sets the additional types supported by this connection point\r\n     */\r\n    public acceptedConnectionPointTypes: NodeParticleBlockConnectionPointTypes[] = [];\r\n\r\n    /**\r\n     * Gets or sets the additional types excluded by this connection point\r\n     */\r\n    public excludedConnectionPointTypes: NodeParticleBlockConnectionPointTypes[] = [];\r\n\r\n    /**\r\n     * Observable triggered when this point is connected\r\n     */\r\n    public onConnectionObservable = new Observable<NodeParticleConnectionPoint>();\r\n\r\n    /**\r\n     * Observable triggered when this point is disconnected\r\n     */\r\n    public onDisconnectionObservable = new Observable<NodeParticleConnectionPoint>();\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating that this connection point is exposed on a frame\r\n     */\r\n    public isExposedOnFrame: boolean = false;\r\n\r\n    /**\r\n     * Gets or sets number indicating the position that the port is exposed to on a frame\r\n     */\r\n    public exposedPortPosition: number = -1;\r\n\r\n    /**\r\n     * Gets the default value used for this point at creation time\r\n     */\r\n    public defaultValue: Nullable<any> = null;\r\n\r\n    /**\r\n     * Gets or sets the default value used for this point if nothing is connected\r\n     */\r\n    public value: Nullable<any> = null;\r\n\r\n    /**\r\n     * Gets or sets the min value accepted for this point if nothing is connected\r\n     */\r\n    public valueMin: Nullable<any> = null;\r\n\r\n    /**\r\n     * Gets or sets the max value accepted for this point if nothing is connected\r\n     */\r\n    public valueMax: Nullable<any> = null;\r\n\r\n    /**\r\n     * Gets or sets the connection point type (default is float)\r\n     */\r\n    public get type(): NodeParticleBlockConnectionPointTypes {\r\n        if (this._type === NodeParticleBlockConnectionPointTypes.AutoDetect) {\r\n            if (this._ownerBlock.isInput) {\r\n                return (this._ownerBlock as ParticleInputBlock).type;\r\n            }\r\n\r\n            if (this._connectedPoint) {\r\n                return this._connectedPoint.type;\r\n            }\r\n\r\n            if (this._linkedConnectionSource) {\r\n                if (this._linkedConnectionSource.isConnected) {\r\n                    return this._linkedConnectionSource.type;\r\n                }\r\n                if (this._linkedConnectionSource._defaultConnectionPointType) {\r\n                    return this._linkedConnectionSource._defaultConnectionPointType;\r\n                }\r\n            }\r\n\r\n            if (this._defaultConnectionPointType) {\r\n                return this._defaultConnectionPointType;\r\n            }\r\n        }\r\n\r\n        if (this._type === NodeParticleBlockConnectionPointTypes.BasedOnInput) {\r\n            if (this._typeConnectionSource) {\r\n                if (!this._typeConnectionSource.isConnected && this._defaultConnectionPointType) {\r\n                    return this._defaultConnectionPointType;\r\n                }\r\n                if (this._typeConnectionSourceTranslation) {\r\n                    return this._typeConnectionSourceTranslation(this._typeConnectionSource.type);\r\n                }\r\n                return this._typeConnectionSource.type;\r\n            } else if (this._defaultConnectionPointType) {\r\n                return this._defaultConnectionPointType;\r\n            }\r\n        }\r\n\r\n        return this._type;\r\n    }\r\n\r\n    public set type(value: NodeParticleBlockConnectionPointTypes) {\r\n        this._type = value;\r\n    }\r\n\r\n    /**\r\n     * Gets or sets the connection point name\r\n     */\r\n    public name: string;\r\n\r\n    /**\r\n     * Gets or sets the connection point display name\r\n     */\r\n    public displayName: string;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating that this connection point can be omitted\r\n     */\r\n    public isOptional: boolean;\r\n\r\n    /**\r\n     * Gets a boolean indicating that the current point is connected to another NodeMaterialBlock\r\n     */\r\n    public get isConnected(): boolean {\r\n        return this.connectedPoint !== null || this.hasEndpoints;\r\n    }\r\n\r\n    /** Get the other side of the connection (if any) */\r\n    public get connectedPoint(): Nullable<NodeParticleConnectionPoint> {\r\n        return this._connectedPoint;\r\n    }\r\n\r\n    /** Get the block that owns this connection point */\r\n    public get ownerBlock(): NodeParticleBlock {\r\n        return this._ownerBlock;\r\n    }\r\n\r\n    /** Get the block connected on the other side of this connection (if any) */\r\n    public get sourceBlock(): Nullable<NodeParticleBlock> {\r\n        if (!this._connectedPoint) {\r\n            return null;\r\n        }\r\n\r\n        return this._connectedPoint.ownerBlock;\r\n    }\r\n\r\n    /** Get the block connected on the endpoints of this connection (if any) */\r\n    public get connectedBlocks(): Array<NodeParticleBlock> {\r\n        if (this._endpoints.length === 0) {\r\n            return [];\r\n        }\r\n\r\n        return this._endpoints.map((e) => e.ownerBlock);\r\n    }\r\n\r\n    /** Gets the list of connected endpoints */\r\n    public get endpoints() {\r\n        return this._endpoints;\r\n    }\r\n\r\n    /** Gets a boolean indicating if that output point is connected to at least one input */\r\n    public get hasEndpoints(): boolean {\r\n        return this._endpoints && this._endpoints.length > 0;\r\n    }\r\n\r\n    /** Get the inner type (ie AutoDetect for instance instead of the inferred one) */\r\n    public get innerType() {\r\n        if (this._linkedConnectionSource && !this._isMainLinkSource && this._linkedConnectionSource.isConnected) {\r\n            return this.type;\r\n        }\r\n        return this._type;\r\n    }\r\n\r\n    /**\r\n     * Creates a new connection point\r\n     * @param name defines the connection point name\r\n     * @param ownerBlock defines the block hosting this connection point\r\n     * @param direction defines the direction of the connection point\r\n     */\r\n    public constructor(name: string, ownerBlock: NodeParticleBlock, direction: NodeParticleConnectionPointDirection) {\r\n        this._ownerBlock = ownerBlock;\r\n        this.name = name;\r\n        this._direction = direction;\r\n    }\r\n\r\n    /**\r\n     * Gets the current class name e.g. \"NodeMaterialConnectionPoint\"\r\n     * @returns the class name\r\n     */\r\n    public getClassName(): string {\r\n        return \"NodeParticleConnectionPoint\";\r\n    }\r\n\r\n    /**\r\n     * Gets the value represented by this connection point\r\n     * @param state current evaluation state\r\n     * @returns the connected value or the value if nothing is connected\r\n     */\r\n    public getConnectedValue(state: NodeParticleBuildState) {\r\n        if (this.isConnected) {\r\n            if (this._connectedPoint?._storedFunction) {\r\n                return this._connectedPoint._storedFunction(state);\r\n            }\r\n            return this._connectedPoint!._storedValue;\r\n        }\r\n        return this.value;\r\n    }\r\n\r\n    /**\r\n     * Gets a boolean indicating if the current point can be connected to another point\r\n     * @param connectionPoint defines the other connection point\r\n     * @returns a boolean\r\n     */\r\n    public canConnectTo(connectionPoint: NodeParticleConnectionPoint) {\r\n        return this.checkCompatibilityState(connectionPoint) === NodeParticleConnectionPointCompatibilityStates.Compatible;\r\n    }\r\n\r\n    /**\r\n     * Gets a number indicating if the current point can be connected to another point\r\n     * @param connectionPoint defines the other connection point\r\n     * @returns a number defining the compatibility state\r\n     */\r\n    public checkCompatibilityState(connectionPoint: NodeParticleConnectionPoint): NodeParticleConnectionPointCompatibilityStates {\r\n        const ownerBlock = this._ownerBlock;\r\n        const otherBlock = connectionPoint.ownerBlock;\r\n\r\n        if (this.type !== connectionPoint.type && connectionPoint.innerType !== NodeParticleBlockConnectionPointTypes.AutoDetect) {\r\n            // Accepted types\r\n            if (connectionPoint.acceptedConnectionPointTypes && connectionPoint.acceptedConnectionPointTypes.indexOf(this.type) !== -1) {\r\n                return NodeParticleConnectionPointCompatibilityStates.Compatible;\r\n            } else {\r\n                return NodeParticleConnectionPointCompatibilityStates.TypeIncompatible;\r\n            }\r\n        }\r\n\r\n        // Excluded\r\n        if (connectionPoint.excludedConnectionPointTypes && connectionPoint.excludedConnectionPointTypes.indexOf(this.type) !== -1) {\r\n            return NodeParticleConnectionPointCompatibilityStates.TypeIncompatible;\r\n        }\r\n\r\n        // Check hierarchy\r\n        let targetBlock = otherBlock;\r\n        let sourceBlock = ownerBlock;\r\n        if (this.direction === NodeParticleConnectionPointDirection.Input) {\r\n            targetBlock = ownerBlock;\r\n            sourceBlock = otherBlock;\r\n        }\r\n\r\n        if (targetBlock.isAnAncestorOf(sourceBlock)) {\r\n            return NodeParticleConnectionPointCompatibilityStates.HierarchyIssue;\r\n        }\r\n\r\n        return NodeParticleConnectionPointCompatibilityStates.Compatible;\r\n    }\r\n\r\n    /**\r\n     * Connect this point to another connection point\r\n     * @param connectionPoint defines the other connection point\r\n     * @param ignoreConstraints defines if the system will ignore connection type constraints (default is false)\r\n     * @returns the current connection point\r\n     */\r\n    public connectTo(connectionPoint: NodeParticleConnectionPoint, ignoreConstraints = false): NodeParticleConnectionPoint {\r\n        if (!ignoreConstraints && !this.canConnectTo(connectionPoint)) {\r\n            // eslint-disable-next-line no-throw-literal\r\n            throw `Cannot connect these two connectors. source: \"${this.ownerBlock.name}\".${this.name}, target: \"${connectionPoint.ownerBlock.name}\".${connectionPoint.name}`;\r\n        }\r\n\r\n        this._endpoints.push(connectionPoint);\r\n        connectionPoint._connectedPoint = this;\r\n\r\n        this.onConnectionObservable.notifyObservers(connectionPoint);\r\n        connectionPoint.onConnectionObservable.notifyObservers(this);\r\n\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Disconnect this point from one of his endpoint\r\n     * @param endpoint defines the other connection point\r\n     * @returns the current connection point\r\n     */\r\n    public disconnectFrom(endpoint: NodeParticleConnectionPoint): NodeParticleConnectionPoint {\r\n        const index = this._endpoints.indexOf(endpoint);\r\n\r\n        if (index === -1) {\r\n            return this;\r\n        }\r\n\r\n        this._endpoints.splice(index, 1);\r\n        endpoint._connectedPoint = null;\r\n\r\n        this.onDisconnectionObservable.notifyObservers(endpoint);\r\n        endpoint.onDisconnectionObservable.notifyObservers(this);\r\n\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Fill the list of excluded connection point types with all types other than those passed in the parameter\r\n     * @param mask Types (ORed values of NodeMaterialBlockConnectionPointTypes) that are allowed, and thus will not be pushed to the excluded list\r\n     */\r\n    public addExcludedConnectionPointFromAllowedTypes(mask: number): void {\r\n        let bitmask = 1;\r\n        while (bitmask < NodeParticleBlockConnectionPointTypes.All) {\r\n            if (!(mask & bitmask)) {\r\n                this.excludedConnectionPointTypes.push(bitmask);\r\n            }\r\n            bitmask = bitmask << 1;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Serializes this point in a JSON representation\r\n     * @param isInput defines if the connection point is an input (default is true)\r\n     * @returns the serialized point object\r\n     */\r\n    public serialize(isInput = true): any {\r\n        const serializationObject: any = {};\r\n\r\n        serializationObject.name = this.name;\r\n        serializationObject.displayName = this.displayName;\r\n        if (this.value !== undefined && this.value !== null) {\r\n            if (this.value.asArray) {\r\n                serializationObject.valueType = \"BABYLON.\" + this.value.getClassName();\r\n                serializationObject.value = this.value.asArray();\r\n            } else {\r\n                serializationObject.valueType = \"number\";\r\n                serializationObject.value = this.value;\r\n            }\r\n        }\r\n\r\n        if (isInput && this.connectedPoint) {\r\n            serializationObject.inputName = this.name;\r\n            serializationObject.targetBlockId = this.connectedPoint.ownerBlock.uniqueId;\r\n            serializationObject.targetConnectionName = this.connectedPoint.name;\r\n            serializationObject.isExposedOnFrame = true;\r\n            serializationObject.exposedPortPosition = this.exposedPortPosition;\r\n        }\r\n\r\n        if (this.isExposedOnFrame || this.exposedPortPosition >= 0) {\r\n            serializationObject.isExposedOnFrame = true;\r\n            serializationObject.exposedPortPosition = this.exposedPortPosition;\r\n        }\r\n\r\n        return serializationObject;\r\n    }\r\n\r\n    /**\r\n     * Release resources\r\n     */\r\n    public dispose() {\r\n        this.onConnectionObservable.clear();\r\n        this.onDisconnectionObservable.clear();\r\n    }\r\n}\r\n"]}

package/Particles/Node/nodeParticleBuildState.d.ts

@@ -0,0 +1,89 @@
+import type { Scene } from "../../scene.js";
+import type { NodeParticleConnectionPoint } from "./nodeParticleBlockConnectionPoint.js";
+import { NodeParticleContextualSources } from "./Enums/nodeParticleContextualSources.js";
+import type { Particle } from "../particle.js";
+import type { Nullable } from "../../types.js";
+import { NodeParticleBlockConnectionPointTypes } from "./Enums/nodeParticleBlockConnectionPointTypes.js";
+import { Vector2, Vector3 } from "../../Maths/math.vector.js";
+import type { ThinParticleSystem } from "../thinParticleSystem.js";
+import { Color4 } from "../../Maths/math.color.js";
+import { NodeParticleSystemSources } from "./Enums/nodeParticleSystemSources.js";
+import type { AbstractMesh } from "../../Meshes/abstractMesh.js";
+/**
+ * Class used to store node based geometry build state
+ */
+export declare class NodeParticleBuildState {
+    /**
+     * Gets the capactity of the particle system to build
+     */
+    capacity: number;
+    /**
+     * Gets the scene where the particle system is built
+     */
+    scene: Scene;
+    /** Gets or sets the build identifier */
+    buildId: number;
+    /** Gets or sets the list of non connected mandatory inputs */
+    notConnectedNonOptionalInputs: NodeParticleConnectionPoint[];
+    /** Gets or sets a boolean indicating that verbose mode is on */
+    verbose: boolean;
+    /**
+     * Gets or sets the particle context for contextual data
+     */
+    particleContext: Nullable<Particle>;
+    /**
+     * Gets or sets the system context for contextual data
+     */
+    systemContext: Nullable<ThinParticleSystem>;
+    /**
+     * Gets or sets the index of the gradient to use
+     */
+    gradientIndex: number;
+    /**
+     * Gets or sets next gradient in line
+     */
+    nextGradientIndex: number;
+    /**
+     * Gets or sets the next gradient value
+     */
+    nextGradientValue: any;
+    /**
+     * Emits errors if any
+     */
+    emitErrors(): void;
+    /**
+     * Adapt a value to a target type
+     * @param source defines the value to adapt
+     * @param targetType defines the target type
+     * @returns the adapted value
+     */
+    adapt(source: NodeParticleConnectionPoint, targetType: NodeParticleBlockConnectionPointTypes): any;
+    /**
+     * Gets the value associated with a contextual source
+     * @param source Source of the contextual value
+     * @returns the value associated with the source
+     */
+    getContextualValue(source: NodeParticleContextualSources): number | Vector3 | Color4 | Vector2 | null;
+    /**
+     * Gets a boolean indicating if the emitter is a transform node (or a simple vector3)
+     */
+    get isEmitterTransformNode(): boolean;
+    /**
+     * Gets the emitter world matrix
+     */
+    get emitterWorldMatrix(): import("../../Maths/math.vector.js").Matrix | null;
+    /**
+     * Gets the emitter inverse world matrix
+     */
+    get emitterInverseWorldMatrix(): import("../../Maths/math.vector.js").Matrix | null;
+    /**
+     * Gets the emitter position
+     */
+    get emitterPosition(): Vector3 | null;
+    /**
+     * Gets the value associated with a system source
+     * @param source Source of the system value
+     * @returns the value associated with the source
+     */
+    getSystemValue(source: NodeParticleSystemSources): number | Nullable<Vector3 | AbstractMesh>;
+}

package/Particles/Node/nodeParticleBuildState.js

@@ -0,0 +1,170 @@
+import { NodeParticleContextualSources } from "./Enums/nodeParticleContextualSources.js";
+import { NodeParticleBlockConnectionPointTypes } from "./Enums/nodeParticleBlockConnectionPointTypes.js";
+import { Vector2, Vector3 } from "../../Maths/math.vector.js";
+import { Color4 } from "../../Maths/math.color.js";
+import { NodeParticleSystemSources } from "./Enums/nodeParticleSystemSources.js";
+/**
+ * Class used to store node based geometry build state
+ */
+export class NodeParticleBuildState {
+    constructor() {
+        /** Gets or sets the list of non connected mandatory inputs */
+        this.notConnectedNonOptionalInputs = [];
+        /**
+         * Gets or sets the particle context for contextual data
+         */
+        this.particleContext = null;
+        /**
+         * Gets or sets the system context for contextual data
+         */
+        this.systemContext = null;
+        /**
+         * Gets or sets the index of the gradient to use
+         */
+        this.gradientIndex = 0;
+        /**
+         * Gets or sets next gradient in line
+         */
+        this.nextGradientIndex = 0;
+    }
+    /**
+     * Emits errors if any
+     */
+    emitErrors() {
+        let errorMessage = "";
+        for (const notConnectedInput of this.notConnectedNonOptionalInputs) {
+            errorMessage += `input ${notConnectedInput.name} from block ${notConnectedInput.ownerBlock.name}[${notConnectedInput.ownerBlock.getClassName()}] is not connected and is not optional.\n`;
+        }
+        if (errorMessage) {
+            // eslint-disable-next-line no-throw-literal
+            throw "Build of Node Particle System Set failed:\n" + errorMessage;
+        }
+    }
+    /**
+     * Adapt a value to a target type
+     * @param source defines the value to adapt
+     * @param targetType defines the target type
+     * @returns the adapted value
+     */
+    adapt(source, targetType) {
+        const value = source.getConnectedValue(this) || 0;
+        if (source.type === targetType) {
+            return value;
+        }
+        switch (targetType) {
+            case NodeParticleBlockConnectionPointTypes.Vector2:
+                return new Vector2(value, value);
+            case NodeParticleBlockConnectionPointTypes.Vector3:
+                return new Vector3(value, value, value);
+            case NodeParticleBlockConnectionPointTypes.Color4:
+                return new Color4(value, value, value, value);
+        }
+        return null;
+    }
+    /**
+     * Gets the value associated with a contextual source
+     * @param source Source of the contextual value
+     * @returns the value associated with the source
+     */
+    getContextualValue(source) {
+        if (!this.particleContext || !this.systemContext) {
+            return null;
+        }
+        switch (source) {
+            case NodeParticleContextualSources.Position:
+                return this.particleContext.position;
+            case NodeParticleContextualSources.Direction:
+                return this.particleContext.direction;
+            case NodeParticleContextualSources.ScaledDirection:
+                this.particleContext.direction.scaleToRef(this.systemContext._directionScale, this.systemContext._scaledDirection);
+                return this.systemContext._scaledDirection;
+            case NodeParticleContextualSources.Color:
+                return this.particleContext.color;
+            case NodeParticleContextualSources.Age:
+                return this.particleContext.age;
+            case NodeParticleContextualSources.Lifetime:
+                return this.particleContext.lifeTime;
+            case NodeParticleContextualSources.Angle:
+                return this.particleContext.angle;
+            case NodeParticleContextualSources.Scale:
+                return this.particleContext.scale;
+            case NodeParticleContextualSources.AgeGradient:
+                return this.particleContext.age / this.particleContext.lifeTime;
+            case NodeParticleContextualSources.SpriteCellEnd:
+                return this.systemContext.endSpriteCellID;
+            case NodeParticleContextualSources.SpriteCellIndex:
+                return this.particleContext.cellIndex;
+            case NodeParticleContextualSources.SpriteCellStart:
+                return this.systemContext.startSpriteCellID;
+        }
+        return null;
+    }
+    /**
+     * Gets a boolean indicating if the emitter is a transform node (or a simple vector3)
+     */
+    get isEmitterTransformNode() {
+        if (!this.systemContext) {
+            return false;
+        }
+        if (this.systemContext.emitter.position) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Gets the emitter world matrix
+     */
+    get emitterWorldMatrix() {
+        if (!this.systemContext) {
+            return null;
+        }
+        return this.systemContext._emitterWorldMatrix;
+    }
+    /**
+     * Gets the emitter inverse world matrix
+     */
+    get emitterInverseWorldMatrix() {
+        if (!this.systemContext) {
+            return null;
+        }
+        return this.systemContext._emitterInverseWorldMatrix;
+    }
+    /**
+     * Gets the emitter position
+     */
+    get emitterPosition() {
+        if (!this.systemContext) {
+            return null;
+        }
+        if (this.isEmitterTransformNode) {
+            return this.systemContext.emitter.absolutePosition;
+        }
+        return this.systemContext.emitter;
+    }
+    /**
+     * Gets the value associated with a system source
+     * @param source Source of the system value
+     * @returns the value associated with the source
+     */
+    getSystemValue(source) {
+        if (!this.particleContext || !this.systemContext) {
+            return null;
+        }
+        switch (source) {
+            case NodeParticleSystemSources.Time:
+                return this.systemContext._actualFrame;
+            case NodeParticleSystemSources.Delta:
+                return this.systemContext._scaledUpdateSpeed;
+            case NodeParticleSystemSources.Emitter:
+                if (this.isEmitterTransformNode) {
+                    const emitterMesh = this.systemContext.emitter;
+                    return emitterMesh.absolutePosition;
+                }
+                else {
+                    return this.systemContext.emitter;
+                }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=nodeParticleBuildState.js.map