@babylonjs/core 7.31.2 → 7.32.1

package/FrameGraph/Node/nodeRenderGraphBlockConnectionPoint.d.ts

@@ -0,0 +1,143 @@
+import type { Nullable, NodeRenderGraphBlock, NodeRenderGraphBlockConnectionPointValueType } from "../../index.js";
+import { Observable } from "../../Misc/observable";
+import { NodeRenderGraphBlockConnectionPointTypes, NodeRenderGraphConnectionPointCompatibilityStates, NodeRenderGraphConnectionPointDirection } from "./Types/nodeRenderGraphTypes";
+/**
+ * Defines a connection point for a block
+ */
+export declare class NodeRenderGraphConnectionPoint {
+    private readonly _ownerBlock;
+    private _connectedPoint;
+    /** @internal */
+    _acceptedConnectionPointType: Nullable<NodeRenderGraphConnectionPoint>;
+    private _endpoints;
+    private readonly _direction;
+    private _type;
+    /** @internal */
+    _linkedConnectionSource: Nullable<NodeRenderGraphConnectionPoint>;
+    /** @internal */
+    _typeConnectionSource: Nullable<NodeRenderGraphConnectionPoint | (() => NodeRenderGraphConnectionPoint)>;
+    /** @internal */
+    _defaultConnectionPointType: Nullable<NodeRenderGraphBlockConnectionPointTypes>;
+    /** Gets the direction of the point */
+    get direction(): NodeRenderGraphConnectionPointDirection;
+    /**
+     * The value stored in this connection point
+     */
+    value: NodeRenderGraphBlockConnectionPointValueType | undefined;
+    /**
+     * Gets or sets the additional types supported by this connection point
+     */
+    acceptedConnectionPointTypes: NodeRenderGraphBlockConnectionPointTypes[];
+    /**
+     * Gets or sets the additional types excluded by this connection point
+     */
+    excludedConnectionPointTypes: NodeRenderGraphBlockConnectionPointTypes[];
+    /**
+     * Observable triggered when this point is connected
+     */
+    onConnectionObservable: Observable<NodeRenderGraphConnectionPoint>;
+    /**
+     * Observable triggered when this point is disconnected
+     */
+    onDisconnectionObservable: Observable<NodeRenderGraphConnectionPoint>;
+    /**
+     * Gets or sets a boolean indicating that this connection point is exposed on a frame
+     */
+    isExposedOnFrame: boolean;
+    /**
+     * Gets or sets number indicating the position that the port is exposed to on a frame
+     */
+    exposedPortPosition: number;
+    /**
+     * Gets or sets the connection point type (default is Undefined)
+     */
+    get type(): NodeRenderGraphBlockConnectionPointTypes;
+    set type(value: NodeRenderGraphBlockConnectionPointTypes);
+    /**
+     * Gets or sets the connection point name
+     */
+    name: string;
+    /**
+     * Gets or sets the connection point display name
+     */
+    displayName: string;
+    /**
+     * Gets or sets a boolean indicating that this connection point can be omitted
+     */
+    isOptional: boolean;
+    /**
+     * Gets a boolean indicating that the current point is connected to another NodeRenderGraphBlock
+     */
+    get isConnected(): boolean;
+    /** Get the other side of the connection (if any) */
+    get connectedPoint(): Nullable<NodeRenderGraphConnectionPoint>;
+    /** Get the block that owns this connection point */
+    get ownerBlock(): NodeRenderGraphBlock;
+    /** Get the block connected on the other side of this connection (if any) */
+    get sourceBlock(): Nullable<NodeRenderGraphBlock>;
+    /** Get the block connected on the endpoints of this connection (if any) */
+    get connectedBlocks(): Array<NodeRenderGraphBlock>;
+    /** Gets the list of connected endpoints */
+    get endpoints(): NodeRenderGraphConnectionPoint[];
+    /** Gets a boolean indicating if that output point is connected to at least one input */
+    get hasEndpoints(): boolean;
+    /** Get the inner type (ie AutoDetect for instance instead of the inferred one) */
+    get innerType(): NodeRenderGraphBlockConnectionPointTypes;
+    /**
+     * 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: string, ownerBlock: NodeRenderGraphBlock, direction: NodeRenderGraphConnectionPointDirection);
+    /**
+     * Gets the current class name e.g. "NodeRenderGraphConnectionPoint"
+     * @returns the class name
+     */
+    getClassName(): string;
+    /**
+     * 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: NodeRenderGraphConnectionPoint): boolean;
+    /**
+     * 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: NodeRenderGraphConnectionPoint): NodeRenderGraphConnectionPointCompatibilityStates;
+    /**
+     * 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: NodeRenderGraphConnectionPoint, ignoreConstraints?: boolean): NodeRenderGraphConnectionPoint;
+    /**
+     * Disconnect this point from one of his endpoint
+     * @param endpoint defines the other connection point
+     * @returns the current connection point
+     */
+    disconnectFrom(endpoint: NodeRenderGraphConnectionPoint): NodeRenderGraphConnectionPoint;
+    /**
+     * Fills the list of excluded connection point types with all types other than those passed in the parameter
+     * @param mask Types (ORed values of NodeRenderGraphBlockConnectionPointTypes) that are allowed, and thus will not be pushed to the excluded list
+     */
+    addExcludedConnectionPointFromAllowedTypes(mask: number): void;
+    /**
+     * Adds accepted connection point types
+     * @param mask Types (ORed values of NodeRenderGraphBlockConnectionPointTypes) that are allowed to connect to this point
+     */
+    addAcceptedConnectionPointTypes(mask: number): void;
+    /**
+     * 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?: boolean): any;
+    /**
+     * Release resources
+     */
+    dispose(): void;
+}

package/FrameGraph/Node/nodeRenderGraphBlockConnectionPoint.js

@@ -0,0 +1,275 @@
+import { Observable } from "../../Misc/observable.js";
+import { NodeRenderGraphBlockConnectionPointTypes } from "./Types/nodeRenderGraphTypes.js";
+/**
+ * Defines a connection point for a block
+ */
+export class NodeRenderGraphConnectionPoint {
+    /** Gets the direction of the point */
+    get direction() {
+        return this._direction;
+    }
+    /**
+     * Gets or sets the connection point type (default is Undefined)
+     */
+    get type() {
+        if (this._type === NodeRenderGraphBlockConnectionPointTypes.AutoDetect) {
+            if (this._ownerBlock.isInput) {
+                return this._ownerBlock.type;
+            }
+            if (this._connectedPoint) {
+                return this._connectedPoint.type;
+            }
+            if (this._linkedConnectionSource && this._linkedConnectionSource.isConnected) {
+                return this._linkedConnectionSource.type;
+            }
+        }
+        if (this._type === NodeRenderGraphBlockConnectionPointTypes.BasedOnInput) {
+            if (this._typeConnectionSource) {
+                const typeConnectionSource = typeof this._typeConnectionSource === "function" ? this._typeConnectionSource() : this._typeConnectionSource;
+                if (!typeConnectionSource.isConnected) {
+                    return this._defaultConnectionPointType ?? typeConnectionSource.type;
+                }
+                return typeConnectionSource._connectedPoint.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 NodeRenderGraphBlock
+     */
+    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._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) {
+        this._connectedPoint = null;
+        /** @internal */
+        this._acceptedConnectionPointType = null;
+        this._endpoints = new Array();
+        this._type = NodeRenderGraphBlockConnectionPointTypes.Undefined;
+        /** @internal */
+        this._linkedConnectionSource = null;
+        /** @internal */
+        this._typeConnectionSource = null;
+        /** @internal */
+        this._defaultConnectionPointType = null;
+        /**
+         * 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;
+        this._ownerBlock = ownerBlock;
+        this.name = name;
+        this._direction = direction;
+    }
+    /**
+     * Gets the current class name e.g. "NodeRenderGraphConnectionPoint"
+     * @returns the class name
+     */
+    getClassName() {
+        return "NodeRenderGraphConnectionPoint";
+    }
+    /**
+     * 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 /* NodeRenderGraphConnectionPointCompatibilityStates.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 !== NodeRenderGraphBlockConnectionPointTypes.AutoDetect) {
+            // Accepted types
+            if (connectionPoint.acceptedConnectionPointTypes && connectionPoint.acceptedConnectionPointTypes.indexOf(this.type) !== -1) {
+                return 0 /* NodeRenderGraphConnectionPointCompatibilityStates.Compatible */;
+            }
+            else {
+                return 1 /* NodeRenderGraphConnectionPointCompatibilityStates.TypeIncompatible */;
+            }
+        }
+        // Excluded
+        if (connectionPoint.excludedConnectionPointTypes && connectionPoint.excludedConnectionPointTypes.indexOf(this.type) !== -1) {
+            return 1 /* NodeRenderGraphConnectionPointCompatibilityStates.TypeIncompatible */;
+        }
+        // Check hierarchy
+        let targetBlock = otherBlock;
+        let sourceBlock = ownerBlock;
+        if (this.direction === 0 /* NodeRenderGraphConnectionPointDirection.Input */) {
+            targetBlock = ownerBlock;
+            sourceBlock = otherBlock;
+        }
+        if (targetBlock.isAnAncestorOf(sourceBlock)) {
+            return 2 /* NodeRenderGraphConnectionPointCompatibilityStates.HierarchyIssue */;
+        }
+        return 0 /* NodeRenderGraphConnectionPointCompatibilityStates.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.";
+        }
+        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;
+    }
+    /**
+     * Fills the list of excluded connection point types with all types other than those passed in the parameter
+     * @param mask Types (ORed values of NodeRenderGraphBlockConnectionPointTypes) that are allowed, and thus will not be pushed to the excluded list
+     */
+    addExcludedConnectionPointFromAllowedTypes(mask) {
+        let bitmask = 0;
+        let val = 2 ** bitmask;
+        // Note: don't use 1 << bitmask instead of 2 ** bitmask, as it will cause an infinite loop because 1 << 31 is negative!
+        while (val < NodeRenderGraphBlockConnectionPointTypes.All) {
+            if (!(mask & val)) {
+                this.excludedConnectionPointTypes.push(val);
+            }
+            bitmask++;
+            val = 2 ** bitmask;
+        }
+    }
+    /**
+     * Adds accepted connection point types
+     * @param mask Types (ORed values of NodeRenderGraphBlockConnectionPointTypes) that are allowed to connect to this point
+     */
+    addAcceptedConnectionPointTypes(mask) {
+        let bitmask = 0;
+        let val = 2 ** bitmask;
+        // Note: don't use 1 << bitmask instead of 2 ** bitmask, as it will cause an infinite loop because 1 << 31 is negative!
+        while (val < NodeRenderGraphBlockConnectionPointTypes.All) {
+            if (mask & val && this.acceptedConnectionPointTypes.indexOf(val) === -1) {
+                this.acceptedConnectionPointTypes.push(val);
+            }
+            bitmask++;
+            val = 2 ** bitmask;
+        }
+    }
+    /**
+     * 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 (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=nodeRenderGraphBlockConnectionPoint.js.map

package/FrameGraph/Node/nodeRenderGraphBlockConnectionPoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeRenderGraphBlockConnectionPoint.js","sourceRoot":"","sources":["../../../../../dev/core/src/FrameGraph/Node/nodeRenderGraphBlockConnectionPoint.ts"],"names":[],"mappings":"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","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { Nullable, NodeRenderGraphBlock, NodeRenderGraphBlockConnectionPointValueType, NodeRenderGraphInputBlock } from \"core/index\";\r\nimport { Observable } from \"../../Misc/observable\";\r\nimport { NodeRenderGraphBlockConnectionPointTypes, NodeRenderGraphConnectionPointCompatibilityStates, NodeRenderGraphConnectionPointDirection } from \"./Types/nodeRenderGraphTypes\";\r\n\r\n/**\r\n * Defines a connection point for a block\r\n */\r\nexport class NodeRenderGraphConnectionPoint {\r\n    private readonly _ownerBlock: NodeRenderGraphBlock;\r\n    private _connectedPoint: Nullable<NodeRenderGraphConnectionPoint> = null;\r\n\r\n    /** @internal */\r\n    public _acceptedConnectionPointType: Nullable<NodeRenderGraphConnectionPoint> = null;\r\n\r\n    private _endpoints = new Array<NodeRenderGraphConnectionPoint>();\r\n    private readonly _direction: NodeRenderGraphConnectionPointDirection;\r\n    private _type = NodeRenderGraphBlockConnectionPointTypes.Undefined;\r\n\r\n    /** @internal */\r\n    public _linkedConnectionSource: Nullable<NodeRenderGraphConnectionPoint> = null;\r\n\r\n    /** @internal */\r\n    public _typeConnectionSource: Nullable<NodeRenderGraphConnectionPoint | (() => NodeRenderGraphConnectionPoint)> = null;\r\n\r\n    /** @internal */\r\n    public _defaultConnectionPointType: Nullable<NodeRenderGraphBlockConnectionPointTypes> = null;\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     * The value stored in this connection point\r\n     */\r\n    public value: NodeRenderGraphBlockConnectionPointValueType | undefined;\r\n\r\n    /**\r\n     * Gets or sets the additional types supported by this connection point\r\n     */\r\n    public acceptedConnectionPointTypes: NodeRenderGraphBlockConnectionPointTypes[] = [];\r\n\r\n    /**\r\n     * Gets or sets the additional types excluded by this connection point\r\n     */\r\n    public excludedConnectionPointTypes: NodeRenderGraphBlockConnectionPointTypes[] = [];\r\n\r\n    /**\r\n     * Observable triggered when this point is connected\r\n     */\r\n    public onConnectionObservable = new Observable<NodeRenderGraphConnectionPoint>();\r\n\r\n    /**\r\n     * Observable triggered when this point is disconnected\r\n     */\r\n    public onDisconnectionObservable = new Observable<NodeRenderGraphConnectionPoint>();\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 or sets the connection point type (default is Undefined)\r\n     */\r\n    public get type(): NodeRenderGraphBlockConnectionPointTypes {\r\n        if (this._type === NodeRenderGraphBlockConnectionPointTypes.AutoDetect) {\r\n            if (this._ownerBlock.isInput) {\r\n                return (this._ownerBlock as NodeRenderGraphInputBlock).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 && this._linkedConnectionSource.isConnected) {\r\n                return this._linkedConnectionSource.type;\r\n            }\r\n        }\r\n\r\n        if (this._type === NodeRenderGraphBlockConnectionPointTypes.BasedOnInput) {\r\n            if (this._typeConnectionSource) {\r\n                const typeConnectionSource = typeof this._typeConnectionSource === \"function\" ? this._typeConnectionSource() : this._typeConnectionSource;\r\n                if (!typeConnectionSource.isConnected) {\r\n                    return this._defaultConnectionPointType ?? typeConnectionSource.type;\r\n                }\r\n                return typeConnectionSource._connectedPoint!.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: NodeRenderGraphBlockConnectionPointTypes) {\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 NodeRenderGraphBlock\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<NodeRenderGraphConnectionPoint> {\r\n        return this._connectedPoint;\r\n    }\r\n\r\n    /** Get the block that owns this connection point */\r\n    public get ownerBlock(): NodeRenderGraphBlock {\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<NodeRenderGraphBlock> {\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<NodeRenderGraphBlock> {\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._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: NodeRenderGraphBlock, direction: NodeRenderGraphConnectionPointDirection) {\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. \"NodeRenderGraphConnectionPoint\"\r\n     * @returns the class name\r\n     */\r\n    public getClassName(): string {\r\n        return \"NodeRenderGraphConnectionPoint\";\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: NodeRenderGraphConnectionPoint) {\r\n        return this.checkCompatibilityState(connectionPoint) === NodeRenderGraphConnectionPointCompatibilityStates.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: NodeRenderGraphConnectionPoint): NodeRenderGraphConnectionPointCompatibilityStates {\r\n        const ownerBlock = this._ownerBlock;\r\n        const otherBlock = connectionPoint.ownerBlock;\r\n\r\n        if (this.type !== connectionPoint.type && connectionPoint.innerType !== NodeRenderGraphBlockConnectionPointTypes.AutoDetect) {\r\n            // Accepted types\r\n            if (connectionPoint.acceptedConnectionPointTypes && connectionPoint.acceptedConnectionPointTypes.indexOf(this.type) !== -1) {\r\n                return NodeRenderGraphConnectionPointCompatibilityStates.Compatible;\r\n            } else {\r\n                return NodeRenderGraphConnectionPointCompatibilityStates.TypeIncompatible;\r\n            }\r\n        }\r\n\r\n        // Excluded\r\n        if (connectionPoint.excludedConnectionPointTypes && connectionPoint.excludedConnectionPointTypes.indexOf(this.type) !== -1) {\r\n            return NodeRenderGraphConnectionPointCompatibilityStates.TypeIncompatible;\r\n        }\r\n\r\n        // Check hierarchy\r\n        let targetBlock = otherBlock;\r\n        let sourceBlock = ownerBlock;\r\n        if (this.direction === NodeRenderGraphConnectionPointDirection.Input) {\r\n            targetBlock = ownerBlock;\r\n            sourceBlock = otherBlock;\r\n        }\r\n\r\n        if (targetBlock.isAnAncestorOf(sourceBlock)) {\r\n            return NodeRenderGraphConnectionPointCompatibilityStates.HierarchyIssue;\r\n        }\r\n\r\n        return NodeRenderGraphConnectionPointCompatibilityStates.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: NodeRenderGraphConnectionPoint, ignoreConstraints = false): NodeRenderGraphConnectionPoint {\r\n        if (!ignoreConstraints && !this.canConnectTo(connectionPoint)) {\r\n            // eslint-disable-next-line no-throw-literal\r\n            throw \"Cannot connect these two connectors.\";\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: NodeRenderGraphConnectionPoint): NodeRenderGraphConnectionPoint {\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     * Fills 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 NodeRenderGraphBlockConnectionPointTypes) 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 = 0;\r\n        let val = 2 ** bitmask;\r\n        // Note: don't use 1 << bitmask instead of 2 ** bitmask, as it will cause an infinite loop because 1 << 31 is negative!\r\n        while (val < NodeRenderGraphBlockConnectionPointTypes.All) {\r\n            if (!(mask & val)) {\r\n                this.excludedConnectionPointTypes.push(val);\r\n            }\r\n            bitmask++;\r\n            val = 2 ** bitmask;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Adds accepted connection point types\r\n     * @param mask Types (ORed values of NodeRenderGraphBlockConnectionPointTypes) that are allowed to connect to this point\r\n     */\r\n    public addAcceptedConnectionPointTypes(mask: number): void {\r\n        let bitmask = 0;\r\n        let val = 2 ** bitmask;\r\n        // Note: don't use 1 << bitmask instead of 2 ** bitmask, as it will cause an infinite loop because 1 << 31 is negative!\r\n        while (val < NodeRenderGraphBlockConnectionPointTypes.All) {\r\n            if (mask & val && this.acceptedConnectionPointTypes.indexOf(val) === -1) {\r\n                this.acceptedConnectionPointTypes.push(val);\r\n            }\r\n            bitmask++;\r\n            val = 2 ** bitmask;\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\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/FrameGraph/Node/nodeRenderGraphBuildState.d.ts

@@ -0,0 +1,21 @@
+import type { Nullable, NodeRenderGraphConnectionPoint, Observable } from "../../index.js";
+/**
+ * Class used to store node based render graph build state
+ */
+export declare class NodeRenderGraphBuildState {
+    /** Gets or sets the build identifier */
+    buildId: number;
+    /** Gets or sets a boolean indicating that verbose mode is on */
+    verbose: boolean;
+    /**
+     * Gets or sets the list of non connected mandatory inputs
+     * @internal
+     */
+    _notConnectedNonOptionalInputs: NodeRenderGraphConnectionPoint[];
+    /**
+     * Emits console errors and exceptions if there is a failing check
+     * @param errorObservable defines an Observable to send the error message
+     * @returns true if all checks pass
+     */
+    emitErrors(errorObservable?: Nullable<Observable<string>>): boolean;
+}

package/FrameGraph/Node/nodeRenderGraphBuildState.js

@@ -0,0 +1,35 @@
+import { Logger } from "../../Misc/logger.js";
+/**
+ * Class used to store node based render graph build state
+ */
+export class NodeRenderGraphBuildState {
+    constructor() {
+        /** Gets or sets a boolean indicating that verbose mode is on */
+        this.verbose = false;
+        /**
+         * Gets or sets the list of non connected mandatory inputs
+         * @internal
+         */
+        this._notConnectedNonOptionalInputs = [];
+    }
+    /**
+     * Emits console errors and exceptions if there is a failing check
+     * @param errorObservable defines an Observable to send the error message
+     * @returns true if all checks pass
+     */
+    emitErrors(errorObservable = null) {
+        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) {
+            if (errorObservable) {
+                errorObservable.notifyObservers(errorMessage);
+            }
+            Logger.Error("Build of node render graph failed:\n" + errorMessage);
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=nodeRenderGraphBuildState.js.map

package/FrameGraph/Node/nodeRenderGraphBuildState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeRenderGraphBuildState.js","sourceRoot":"","sources":["../../../../../dev/core/src/FrameGraph/Node/nodeRenderGraphBuildState.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,yBAAyB;IAAtC;QAII,gEAAgE;QACzD,YAAO,GAAG,KAAK,CAAC;QAEvB;;;WAGG;QACI,mCAA8B,GAAqC,EAAE,CAAC;IAwBjF,CAAC;IAtBG;;;;OAIG;IACI,UAAU,CAAC,kBAAgD,IAAI;QAClE,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,KAAK,MAAM,iBAAiB,IAAI,IAAI,CAAC,8BAA8B,EAAE;YACjE,YAAY,IAAI,UAAU,iBAAiB,CAAC,IAAI,iBAC5C,iBAAiB,CAAC,UAAU,CAAC,IACjC,KAAK,iBAAiB,CAAC,UAAU,CAAC,YAAY,EAAE,2CAA2C,CAAC;SAC/F;QACD,IAAI,YAAY,EAAE;YACd,IAAI,eAAe,EAAE;gBACjB,eAAe,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;aACjD;YACD,MAAM,CAAC,KAAK,CAAC,sCAAsC,GAAG,YAAY,CAAC,CAAC;YAEpE,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { Nullable, NodeRenderGraphConnectionPoint, Observable } from \"core/index\";\r\nimport { Logger } from \"../../Misc/logger\";\r\n\r\n/**\r\n * Class used to store node based render graph build state\r\n */\r\nexport class NodeRenderGraphBuildState {\r\n    /** Gets or sets the build identifier */\r\n    public buildId: number;\r\n\r\n    /** Gets or sets a boolean indicating that verbose mode is on */\r\n    public verbose = false;\r\n\r\n    /**\r\n     * Gets or sets the list of non connected mandatory inputs\r\n     * @internal\r\n     */\r\n    public _notConnectedNonOptionalInputs: NodeRenderGraphConnectionPoint[] = [];\r\n\r\n    /**\r\n     * Emits console errors and exceptions if there is a failing check\r\n     * @param errorObservable defines an Observable to send the error message\r\n     * @returns true if all checks pass\r\n     */\r\n    public emitErrors(errorObservable: Nullable<Observable<string>> = null): boolean {\r\n        let errorMessage = \"\";\r\n        for (const notConnectedInput of this._notConnectedNonOptionalInputs) {\r\n            errorMessage += `input \"${notConnectedInput.name}\" from block \"${\r\n                notConnectedInput.ownerBlock.name\r\n            }\"[${notConnectedInput.ownerBlock.getClassName()}] is not connected and is not optional.\\n`;\r\n        }\r\n        if (errorMessage) {\r\n            if (errorObservable) {\r\n                errorObservable.notifyObservers(errorMessage);\r\n            }\r\n            Logger.Error(\"Build of node render graph failed:\\n\" + errorMessage);\r\n\r\n            return false;\r\n        }\r\n        return true;\r\n    }\r\n}\r\n"]}

package/FrameGraph/Passes/cullPass.d.ts

@@ -0,0 +1,28 @@
+import type { Nullable, AbstractEngine, IFrameGraphPass, FrameGraphContext, FrameGraphObjectList, FrameGraphTask } from "../../index.js";
+import { FrameGraphPass } from "./pass";
+/**
+ * Cull pass used to filter objects that are not visible.
+ */
+export declare class FrameGraphCullPass extends FrameGraphPass<FrameGraphContext> {
+    protected _engine: AbstractEngine;
+    protected _objectList: FrameGraphObjectList;
+    /**
+     * Checks if a pass is a cull pass.
+     * @param pass The pass to check.
+     * @returns True if the pass is a cull pass, else false.
+     */
+    static IsCullPass(pass: IFrameGraphPass): pass is FrameGraphCullPass;
+    /**
+     * Gets the object list used by the cull pass.
+     */
+    get objectList(): FrameGraphObjectList;
+    /**
+     * Sets the object list to use for culling.
+     * @param objectList The object list to use for culling.
+     */
+    setObjectList(objectList: FrameGraphObjectList): void;
+    /** @internal */
+    constructor(name: string, parentTask: FrameGraphTask, context: FrameGraphContext, engine: AbstractEngine);
+    /** @internal */
+    _isValid(): Nullable<string>;
+}

package/FrameGraph/Passes/cullPass.js

@@ -0,0 +1,38 @@
+import { FrameGraphPass } from "./pass.js";
+/**
+ * Cull pass used to filter objects that are not visible.
+ */
+export class FrameGraphCullPass extends FrameGraphPass {
+    /**
+     * Checks if a pass is a cull pass.
+     * @param pass The pass to check.
+     * @returns True if the pass is a cull pass, else false.
+     */
+    static IsCullPass(pass) {
+        return pass.setObjectList !== undefined;
+    }
+    /**
+     * Gets the object list used by the cull pass.
+     */
+    get objectList() {
+        return this._objectList;
+    }
+    /**
+     * Sets the object list to use for culling.
+     * @param objectList The object list to use for culling.
+     */
+    setObjectList(objectList) {
+        this._objectList = objectList;
+    }
+    /** @internal */
+    constructor(name, parentTask, context, engine) {
+        super(name, parentTask, context);
+        this._engine = engine;
+    }
+    /** @internal */
+    _isValid() {
+        const errMsg = super._isValid();
+        return errMsg ? errMsg : this._objectList !== undefined ? null : "Object list is not set (call setObjectList to set it)";
+    }
+}
+//# sourceMappingURL=cullPass.js.map

package/FrameGraph/Passes/cullPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cullPass.js","sourceRoot":"","sources":["../../../../../dev/core/src/FrameGraph/Passes/cullPass.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAiC;IAIrE;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,IAAqB;QAC1C,OAAQ,IAA2B,CAAC,aAAa,KAAK,SAAS,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,UAAgC;QACjD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAClC,CAAC;IAED,gBAAgB;IAChB,YAAY,IAAY,EAAE,UAA0B,EAAE,OAA0B,EAAE,MAAsB;QACpG,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,gBAAgB;IACA,QAAQ;QACpB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,uDAAuD,CAAC;IAC7H,CAAC;CACJ","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { Nullable, AbstractEngine, IFrameGraphPass, FrameGraphContext, FrameGraphObjectList, FrameGraphTask } from \"core/index\";\r\nimport { FrameGraphPass } from \"./pass\";\r\n\r\n/**\r\n * Cull pass used to filter objects that are not visible.\r\n */\r\nexport class FrameGraphCullPass extends FrameGraphPass<FrameGraphContext> {\r\n    protected _engine: AbstractEngine;\r\n    protected _objectList: FrameGraphObjectList;\r\n\r\n    /**\r\n     * Checks if a pass is a cull pass.\r\n     * @param pass The pass to check.\r\n     * @returns True if the pass is a cull pass, else false.\r\n     */\r\n    public static IsCullPass(pass: IFrameGraphPass): pass is FrameGraphCullPass {\r\n        return (pass as FrameGraphCullPass).setObjectList !== undefined;\r\n    }\r\n\r\n    /**\r\n     * Gets the object list used by the cull pass.\r\n     */\r\n    public get objectList(): FrameGraphObjectList {\r\n        return this._objectList;\r\n    }\r\n\r\n    /**\r\n     * Sets the object list to use for culling.\r\n     * @param objectList The object list to use for culling.\r\n     */\r\n    public setObjectList(objectList: FrameGraphObjectList) {\r\n        this._objectList = objectList;\r\n    }\r\n\r\n    /** @internal */\r\n    constructor(name: string, parentTask: FrameGraphTask, context: FrameGraphContext, engine: AbstractEngine) {\r\n        super(name, parentTask, context);\r\n        this._engine = engine;\r\n    }\r\n\r\n    /** @internal */\r\n    public override _isValid(): Nullable<string> {\r\n        const errMsg = super._isValid();\r\n        return errMsg ? errMsg : this._objectList !== undefined ? null : \"Object list is not set (call setObjectList to set it)\";\r\n    }\r\n}\r\n"]}

package/FrameGraph/Passes/pass.d.ts

@@ -0,0 +1,14 @@
+import type { Nullable, FrameGraphContext, IFrameGraphPass, FrameGraphTask } from "../../index.js";
+/**
+ * @internal
+ */
+export declare class FrameGraphPass<T extends FrameGraphContext> implements IFrameGraphPass {
+    name: string;
+    protected readonly _parentTask: FrameGraphTask;
+    protected readonly _context: T;
+    private _executeFunc;
+    constructor(name: string, _parentTask: FrameGraphTask, _context: T);
+    setExecuteFunc(func: (context: T) => void): void;
+    _execute(): void;
+    _isValid(): Nullable<string>;
+}

package/FrameGraph/Passes/pass.js

@@ -0,0 +1,20 @@
+/**
+ * @internal
+ */
+export class FrameGraphPass {
+    constructor(name, _parentTask, _context) {
+        this.name = name;
+        this._parentTask = _parentTask;
+        this._context = _context;
+    }
+    setExecuteFunc(func) {
+        this._executeFunc = func;
+    }
+    _execute() {
+        this._executeFunc(this._context);
+    }
+    _isValid() {
+        return this._executeFunc !== undefined ? null : "Execute function is not set (call setExecuteFunc to set it)";
+    }
+}
+//# sourceMappingURL=pass.js.map

package/FrameGraph/Passes/pass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pass.js","sourceRoot":"","sources":["../../../../../dev/core/src/FrameGraph/Passes/pass.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,cAAc;IAGvB,YACW,IAAY,EACA,WAA2B,EAC3B,QAAW;QAFvB,SAAI,GAAJ,IAAI,CAAQ;QACA,gBAAW,GAAX,WAAW,CAAgB;QAC3B,aAAQ,GAAR,QAAQ,CAAG;IAC/B,CAAC;IAEG,cAAc,CAAC,IAA0B;QAC5C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC7B,CAAC;IAEM,QAAQ;QACX,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAEM,QAAQ;QACX,OAAO,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,6DAA6D,CAAC;IAClH,CAAC;CACJ","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { Nullable, FrameGraphContext, IFrameGraphPass, FrameGraphTask } from \"core/index\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport class FrameGraphPass<T extends FrameGraphContext> implements IFrameGraphPass {\r\n    private _executeFunc: (context: T) => void;\r\n\r\n    constructor(\r\n        public name: string,\r\n        protected readonly _parentTask: FrameGraphTask,\r\n        protected readonly _context: T\r\n    ) {}\r\n\r\n    public setExecuteFunc(func: (context: T) => void) {\r\n        this._executeFunc = func;\r\n    }\r\n\r\n    public _execute() {\r\n        this._executeFunc(this._context);\r\n    }\r\n\r\n    public _isValid(): Nullable<string> {\r\n        return this._executeFunc !== undefined ? null : \"Execute function is not set (call setExecuteFunc to set it)\";\r\n    }\r\n}\r\n"]}