@babylonjs/core 5.23.0 → 5.24.0

package/Misc/observable.js.map

@@ -1 +1 @@
-{"version":3,"file":"observable.js","sourceRoot":"","sources":["../../../../../lts/core/generated/Misc/observable.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nullable } from \"../types\";\r\n\r\n/**\r\n * A class serves as a medium between the observable and its observers\r\n */\r\nexport class EventState {\r\n    /**\r\n     * Create a new EventState\r\n     * @param mask defines the mask associated with this state\r\n     * @param skipNextObservers defines a flag which will instruct the observable to skip following observers when set to true\r\n     * @param target defines the original target of the state\r\n     * @param currentTarget defines the current target of the state\r\n     */\r\n    constructor(mask: number, skipNextObservers = false, target?: any, currentTarget?: any) {\r\n        this.initialize(mask, skipNextObservers, target, currentTarget);\r\n    }\r\n\r\n    /**\r\n     * Initialize the current event state\r\n     * @param mask defines the mask associated with this state\r\n     * @param skipNextObservers defines a flag which will instruct the observable to skip following observers when set to true\r\n     * @param target defines the original target of the state\r\n     * @param currentTarget defines the current target of the state\r\n     * @returns the current event state\r\n     */\r\n    public initialize(mask: number, skipNextObservers = false, target?: any, currentTarget?: any): EventState {\r\n        this.mask = mask;\r\n        this.skipNextObservers = skipNextObservers;\r\n        this.target = target;\r\n        this.currentTarget = currentTarget;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * An Observer can set this property to true to prevent subsequent observers of being notified\r\n     */\r\n    public skipNextObservers: boolean;\r\n\r\n    /**\r\n     * Get the mask value that were used to trigger the event corresponding to this EventState object\r\n     */\r\n    public mask: number;\r\n\r\n    /**\r\n     * The object that originally notified the event\r\n     */\r\n    public target?: any;\r\n\r\n    /**\r\n     * The current object in the bubbling phase\r\n     */\r\n    public currentTarget?: any;\r\n\r\n    /**\r\n     * This will be populated with the return value of the last function that was executed.\r\n     * If it is the first function in the callback chain it will be the event data.\r\n     */\r\n    public lastReturnValue?: any;\r\n\r\n    /**\r\n     * User defined information that will be sent to observers\r\n     */\r\n    public userInfo?: any;\r\n}\r\n\r\n/**\r\n * Represent an Observer registered to a given Observable object.\r\n */\r\nexport class Observer<T> {\r\n    /** @hidden */\r\n    public _willBeUnregistered = false;\r\n    /**\r\n     * Gets or sets a property defining that the observer as to be unregistered after the next notification\r\n     */\r\n    public unregisterOnNextCall = false;\r\n\r\n    /**\r\n     * Creates a new observer\r\n     * @param callback defines the callback to call when the observer is notified\r\n     * @param mask defines the mask of the observer (used to filter notifications)\r\n     * @param scope defines the current scope used to restore the JS context\r\n     */\r\n    constructor(\r\n        /**\r\n         * Defines the callback to call when the observer is notified\r\n         */\r\n        public callback: (eventData: T, eventState: EventState) => void,\r\n        /**\r\n         * Defines the mask of the observer (used to filter notifications)\r\n         */\r\n        public mask: number,\r\n        /**\r\n         * Defines the current scope used to restore the JS context\r\n         */\r\n        public scope: any = null\r\n    ) {}\r\n}\r\n\r\n/**\r\n * The Observable class is a simple implementation of the Observable pattern.\r\n *\r\n * There's one slight particularity though: a given Observable can notify its observer using a particular mask value, only the Observers registered with this mask value will be notified.\r\n * This enable a more fine grained execution without having to rely on multiple different Observable objects.\r\n * For instance you may have a given Observable that have four different types of notifications: Move (mask = 0x01), Stop (mask = 0x02), Turn Right (mask = 0X04), Turn Left (mask = 0X08).\r\n * A given observer can register itself with only Move and Stop (mask = 0x03), then it will only be notified when one of these two occurs and will never be for Turn Left/Right.\r\n */\r\nexport class Observable<T> {\r\n    private _observers = new Array<Observer<T>>();\r\n\r\n    /**\r\n     * @hidden\r\n     */\r\n    public _eventState: EventState;\r\n\r\n    private _onObserverAdded: Nullable<(observer: Observer<T>) => void>;\r\n\r\n    /**\r\n     * Create an observable from a Promise.\r\n     * @param promise a promise to observe for fulfillment.\r\n     * @param onErrorObservable an observable to notify if a promise was rejected.\r\n     * @returns the new Observable\r\n     */\r\n    public static FromPromise<T, E = Error>(promise: Promise<T>, onErrorObservable?: Observable<E>): Observable<T> {\r\n        const observable = new Observable<T>();\r\n\r\n        promise\r\n            .then((ret: T) => {\r\n                observable.notifyObservers(ret);\r\n            })\r\n            .catch((err) => {\r\n                if (onErrorObservable) {\r\n                    onErrorObservable.notifyObservers(err as E);\r\n                } else {\r\n                    throw err;\r\n                }\r\n            });\r\n\r\n        return observable;\r\n    }\r\n\r\n    /**\r\n     * Gets the list of observers\r\n     */\r\n    public get observers(): Array<Observer<T>> {\r\n        return this._observers;\r\n    }\r\n\r\n    /**\r\n     * Creates a new observable\r\n     * @param onObserverAdded defines a callback to call when a new observer is added\r\n     */\r\n    constructor(onObserverAdded?: (observer: Observer<T>) => void) {\r\n        this._eventState = new EventState(0);\r\n\r\n        if (onObserverAdded) {\r\n            this._onObserverAdded = onObserverAdded;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Create a new Observer with the specified callback\r\n     * @param callback the callback that will be executed for that Observer\r\n     * @param mask the mask used to filter observers\r\n     * @param insertFirst if true the callback will be inserted at the first position, hence executed before the others ones. If false (default behavior) the callback will be inserted at the last position, executed after all the others already present.\r\n     * @param scope optional scope for the callback to be called from\r\n     * @param unregisterOnFirstCall defines if the observer as to be unregistered after the next notification\r\n     * @returns the new observer created for the callback\r\n     */\r\n    public add(\r\n        callback: (eventData: T, eventState: EventState) => void,\r\n        mask: number = -1,\r\n        insertFirst = false,\r\n        scope: any = null,\r\n        unregisterOnFirstCall = false\r\n    ): Nullable<Observer<T>> {\r\n        if (!callback) {\r\n            return null;\r\n        }\r\n\r\n        const observer = new Observer(callback, mask, scope);\r\n        observer.unregisterOnNextCall = unregisterOnFirstCall;\r\n\r\n        if (insertFirst) {\r\n            this._observers.unshift(observer);\r\n        } else {\r\n            this._observers.push(observer);\r\n        }\r\n\r\n        if (this._onObserverAdded) {\r\n            this._onObserverAdded(observer);\r\n        }\r\n\r\n        return observer;\r\n    }\r\n\r\n    /**\r\n     * Create a new Observer with the specified callback and unregisters after the next notification\r\n     * @param callback the callback that will be executed for that Observer\r\n     * @returns the new observer created for the callback\r\n     */\r\n    public addOnce(callback: (eventData: T, eventState: EventState) => void): Nullable<Observer<T>> {\r\n        return this.add(callback, undefined, undefined, undefined, true);\r\n    }\r\n\r\n    /**\r\n     * Remove an Observer from the Observable object\r\n     * @param observer the instance of the Observer to remove\r\n     * @returns false if it doesn't belong to this Observable\r\n     */\r\n    public remove(observer: Nullable<Observer<T>>): boolean {\r\n        if (!observer) {\r\n            return false;\r\n        }\r\n\r\n        const index = this._observers.indexOf(observer);\r\n\r\n        if (index !== -1) {\r\n            this._deferUnregister(observer);\r\n            return true;\r\n        }\r\n\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * Remove a callback from the Observable object\r\n     * @param callback the callback to remove\r\n     * @param scope optional scope. If used only the callbacks with this scope will be removed\r\n     * @returns false if it doesn't belong to this Observable\r\n     */\r\n    public removeCallback(callback: (eventData: T, eventState: EventState) => void, scope?: any): boolean {\r\n        for (let index = 0; index < this._observers.length; index++) {\r\n            const observer = this._observers[index];\r\n            if (observer._willBeUnregistered) {\r\n                continue;\r\n            }\r\n            if (observer.callback === callback && (!scope || scope === observer.scope)) {\r\n                this._deferUnregister(observer);\r\n                return true;\r\n            }\r\n        }\r\n\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * @param observer\r\n     * @hidden\r\n     */\r\n    public _deferUnregister(observer: Observer<T>): void {\r\n        observer.unregisterOnNextCall = false;\r\n        observer._willBeUnregistered = true;\r\n        setTimeout(() => {\r\n            this._remove(observer);\r\n        }, 0);\r\n    }\r\n\r\n    // This should only be called when not iterating over _observers to avoid callback skipping.\r\n    // Removes an observer from the _observer Array.\r\n    private _remove(observer: Nullable<Observer<T>>): boolean {\r\n        if (!observer) {\r\n            return false;\r\n        }\r\n\r\n        const index = this._observers.indexOf(observer);\r\n\r\n        if (index !== -1) {\r\n            this._observers.splice(index, 1);\r\n            return true;\r\n        }\r\n\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * Moves the observable to the top of the observer list making it get called first when notified\r\n     * @param observer the observer to move\r\n     */\r\n    public makeObserverTopPriority(observer: Observer<T>) {\r\n        this._remove(observer);\r\n        this._observers.unshift(observer);\r\n    }\r\n\r\n    /**\r\n     * Moves the observable to the bottom of the observer list making it get called last when notified\r\n     * @param observer the observer to move\r\n     */\r\n    public makeObserverBottomPriority(observer: Observer<T>) {\r\n        this._remove(observer);\r\n        this._observers.push(observer);\r\n    }\r\n\r\n    /**\r\n     * Notify all Observers by calling their respective callback with the given data\r\n     * Will return true if all observers were executed, false if an observer set skipNextObservers to true, then prevent the subsequent ones to execute\r\n     * @param eventData defines the data to send to all observers\r\n     * @param mask defines the mask of the current notification (observers with incompatible mask (ie mask & observer.mask === 0) will not be notified)\r\n     * @param target defines the original target of the state\r\n     * @param currentTarget defines the current target of the state\r\n     * @param userInfo defines any user info to send to observers\r\n     * @returns false if the complete observer chain was not processed (because one observer set the skipNextObservers to true)\r\n     */\r\n    public notifyObservers(eventData: T, mask: number = -1, target?: any, currentTarget?: any, userInfo?: any): boolean {\r\n        if (!this._observers.length) {\r\n            return true;\r\n        }\r\n\r\n        const state = this._eventState;\r\n        state.mask = mask;\r\n        state.target = target;\r\n        state.currentTarget = currentTarget;\r\n        state.skipNextObservers = false;\r\n        state.lastReturnValue = eventData;\r\n        state.userInfo = userInfo;\r\n\r\n        for (const obs of this._observers) {\r\n            if (obs._willBeUnregistered) {\r\n                continue;\r\n            }\r\n\r\n            if (obs.mask & mask) {\r\n                if (obs.scope) {\r\n                    state.lastReturnValue = obs.callback.apply(obs.scope, [eventData, state]);\r\n                } else {\r\n                    state.lastReturnValue = obs.callback(eventData, state);\r\n                }\r\n\r\n                if (obs.unregisterOnNextCall) {\r\n                    this._deferUnregister(obs);\r\n                }\r\n            }\r\n            if (state.skipNextObservers) {\r\n                return false;\r\n            }\r\n        }\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * Notify a specific observer\r\n     * @param observer defines the observer to notify\r\n     * @param eventData defines the data to be sent to each callback\r\n     * @param mask is used to filter observers defaults to -1\r\n     */\r\n    public notifyObserver(observer: Observer<T>, eventData: T, mask: number = -1): void {\r\n        if (observer._willBeUnregistered) {\r\n            return;\r\n        }\r\n\r\n        const state = this._eventState;\r\n        state.mask = mask;\r\n        state.skipNextObservers = false;\r\n\r\n        observer.callback(eventData, state);\r\n\r\n        if (observer.unregisterOnNextCall) {\r\n            this._deferUnregister(observer);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Gets a boolean indicating if the observable has at least one observer\r\n     * @returns true is the Observable has at least one Observer registered\r\n     */\r\n    public hasObservers(): boolean {\r\n        return this._observers.length > 0;\r\n    }\r\n\r\n    /**\r\n     * Clear the list of observers\r\n     */\r\n    public clear(): void {\r\n        this._observers = new Array<Observer<T>>();\r\n        this._onObserverAdded = null;\r\n    }\r\n\r\n    /**\r\n     * Clone the current observable\r\n     * @returns a new observable\r\n     */\r\n    public clone(): Observable<T> {\r\n        const result = new Observable<T>();\r\n\r\n        result._observers = this._observers.slice(0);\r\n\r\n        return result;\r\n    }\r\n\r\n    /**\r\n     * Does this observable handles observer registered with a given mask\r\n     * @param mask defines the mask to be tested\r\n     * @return whether or not one observer registered with the given mask is handled\r\n     **/\r\n    public hasSpecificMask(mask: number = -1): boolean {\r\n        for (const obs of this._observers) {\r\n            if (obs.mask & mask || obs.mask === mask) {\r\n                return true;\r\n            }\r\n        }\r\n        return false;\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"observable.js","sourceRoot":"","sources":["../../../../../lts/core/generated/Misc/observable.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nullable } from \"../types\";\r\n\r\n/**\r\n * A class serves as a medium between the observable and its observers\r\n */\r\nexport class EventState {\r\n    /**\r\n     * Create a new EventState\r\n     * @param mask defines the mask associated with this state\r\n     * @param skipNextObservers defines a flag which will instruct the observable to skip following observers when set to true\r\n     * @param target defines the original target of the state\r\n     * @param currentTarget defines the current target of the state\r\n     */\r\n    constructor(mask: number, skipNextObservers = false, target?: any, currentTarget?: any) {\r\n        this.initialize(mask, skipNextObservers, target, currentTarget);\r\n    }\r\n\r\n    /**\r\n     * Initialize the current event state\r\n     * @param mask defines the mask associated with this state\r\n     * @param skipNextObservers defines a flag which will instruct the observable to skip following observers when set to true\r\n     * @param target defines the original target of the state\r\n     * @param currentTarget defines the current target of the state\r\n     * @returns the current event state\r\n     */\r\n    public initialize(mask: number, skipNextObservers = false, target?: any, currentTarget?: any): EventState {\r\n        this.mask = mask;\r\n        this.skipNextObservers = skipNextObservers;\r\n        this.target = target;\r\n        this.currentTarget = currentTarget;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * An Observer can set this property to true to prevent subsequent observers of being notified\r\n     */\r\n    public skipNextObservers: boolean;\r\n\r\n    /**\r\n     * Get the mask value that were used to trigger the event corresponding to this EventState object\r\n     */\r\n    public mask: number;\r\n\r\n    /**\r\n     * The object that originally notified the event\r\n     */\r\n    public target?: any;\r\n\r\n    /**\r\n     * The current object in the bubbling phase\r\n     */\r\n    public currentTarget?: any;\r\n\r\n    /**\r\n     * This will be populated with the return value of the last function that was executed.\r\n     * If it is the first function in the callback chain it will be the event data.\r\n     */\r\n    public lastReturnValue?: any;\r\n\r\n    /**\r\n     * User defined information that will be sent to observers\r\n     */\r\n    public userInfo?: any;\r\n}\r\n\r\n/**\r\n * Represent an Observer registered to a given Observable object.\r\n */\r\nexport class Observer<T> {\r\n    /** @hidden */\r\n    public _willBeUnregistered = false;\r\n    /**\r\n     * Gets or sets a property defining that the observer as to be unregistered after the next notification\r\n     */\r\n    public unregisterOnNextCall = false;\r\n\r\n    /**\r\n     * Creates a new observer\r\n     * @param callback defines the callback to call when the observer is notified\r\n     * @param mask defines the mask of the observer (used to filter notifications)\r\n     * @param scope defines the current scope used to restore the JS context\r\n     */\r\n    constructor(\r\n        /**\r\n         * Defines the callback to call when the observer is notified\r\n         */\r\n        public callback: (eventData: T, eventState: EventState) => void,\r\n        /**\r\n         * Defines the mask of the observer (used to filter notifications)\r\n         */\r\n        public mask: number,\r\n        /**\r\n         * Defines the current scope used to restore the JS context\r\n         */\r\n        public scope: any = null\r\n    ) {}\r\n}\r\n\r\n/**\r\n * The Observable class is a simple implementation of the Observable pattern.\r\n *\r\n * There's one slight particularity though: a given Observable can notify its observer using a particular mask value, only the Observers registered with this mask value will be notified.\r\n * This enable a more fine grained execution without having to rely on multiple different Observable objects.\r\n * For instance you may have a given Observable that have four different types of notifications: Move (mask = 0x01), Stop (mask = 0x02), Turn Right (mask = 0X04), Turn Left (mask = 0X08).\r\n * A given observer can register itself with only Move and Stop (mask = 0x03), then it will only be notified when one of these two occurs and will never be for Turn Left/Right.\r\n */\r\nexport class Observable<T> {\r\n    private _observers = new Array<Observer<T>>();\r\n\r\n    /**\r\n     * @hidden\r\n     */\r\n    public _eventState: EventState;\r\n\r\n    private _onObserverAdded: Nullable<(observer: Observer<T>) => void>;\r\n\r\n    /**\r\n     * Create an observable from a Promise.\r\n     * @param promise a promise to observe for fulfillment.\r\n     * @param onErrorObservable an observable to notify if a promise was rejected.\r\n     * @returns the new Observable\r\n     */\r\n    public static FromPromise<T, E = Error>(promise: Promise<T>, onErrorObservable?: Observable<E>): Observable<T> {\r\n        const observable = new Observable<T>();\r\n\r\n        promise\r\n            .then((ret: T) => {\r\n                observable.notifyObservers(ret);\r\n            })\r\n            .catch((err) => {\r\n                if (onErrorObservable) {\r\n                    onErrorObservable.notifyObservers(err as E);\r\n                } else {\r\n                    throw err;\r\n                }\r\n            });\r\n\r\n        return observable;\r\n    }\r\n\r\n    /**\r\n     * Gets the list of observers\r\n     */\r\n    public get observers(): Array<Observer<T>> {\r\n        return this._observers;\r\n    }\r\n\r\n    /**\r\n     * Creates a new observable\r\n     * @param onObserverAdded defines a callback to call when a new observer is added\r\n     */\r\n    constructor(onObserverAdded?: (observer: Observer<T>) => void) {\r\n        this._eventState = new EventState(0);\r\n\r\n        if (onObserverAdded) {\r\n            this._onObserverAdded = onObserverAdded;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Create a new Observer with the specified callback\r\n     * @param callback the callback that will be executed for that Observer\r\n     * @param mask the mask used to filter observers\r\n     * @param insertFirst if true the callback will be inserted at the first position, hence executed before the others ones. If false (default behavior) the callback will be inserted at the last position, executed after all the others already present.\r\n     * @param scope optional scope for the callback to be called from\r\n     * @param unregisterOnFirstCall defines if the observer as to be unregistered after the next notification\r\n     * @returns the new observer created for the callback\r\n     */\r\n    public add(\r\n        callback: (eventData: T, eventState: EventState) => void,\r\n        mask: number = -1,\r\n        insertFirst = false,\r\n        scope: any = null,\r\n        unregisterOnFirstCall = false\r\n    ): Nullable<Observer<T>> {\r\n        if (!callback) {\r\n            return null;\r\n        }\r\n\r\n        const observer = new Observer(callback, mask, scope);\r\n        observer.unregisterOnNextCall = unregisterOnFirstCall;\r\n\r\n        if (insertFirst) {\r\n            this._observers.unshift(observer);\r\n        } else {\r\n            this._observers.push(observer);\r\n        }\r\n\r\n        if (this._onObserverAdded) {\r\n            this._onObserverAdded(observer);\r\n        }\r\n\r\n        return observer;\r\n    }\r\n\r\n    /**\r\n     * Create a new Observer with the specified callback and unregisters after the next notification\r\n     * @param callback the callback that will be executed for that Observer\r\n     * @returns the new observer created for the callback\r\n     */\r\n    public addOnce(callback: (eventData: T, eventState: EventState) => void): Nullable<Observer<T>> {\r\n        return this.add(callback, undefined, undefined, undefined, true);\r\n    }\r\n\r\n    /**\r\n     * Remove an Observer from the Observable object\r\n     * @param observer the instance of the Observer to remove\r\n     * @returns false if it doesn't belong to this Observable\r\n     */\r\n    public remove(observer: Nullable<Observer<T>>): boolean {\r\n        if (!observer) {\r\n            return false;\r\n        }\r\n\r\n        const index = this._observers.indexOf(observer);\r\n\r\n        if (index !== -1) {\r\n            this._deferUnregister(observer);\r\n            return true;\r\n        }\r\n\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * Remove a callback from the Observable object\r\n     * @param callback the callback to remove\r\n     * @param scope optional scope. If used only the callbacks with this scope will be removed\r\n     * @returns false if it doesn't belong to this Observable\r\n     */\r\n    public removeCallback(callback: (eventData: T, eventState: EventState) => void, scope?: any): boolean {\r\n        for (let index = 0; index < this._observers.length; index++) {\r\n            const observer = this._observers[index];\r\n            if (observer._willBeUnregistered) {\r\n                continue;\r\n            }\r\n            if (observer.callback === callback && (!scope || scope === observer.scope)) {\r\n                this._deferUnregister(observer);\r\n                return true;\r\n            }\r\n        }\r\n\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * @param observer\r\n     * @hidden\r\n     */\r\n    public _deferUnregister(observer: Observer<T>): void {\r\n        observer.unregisterOnNextCall = false;\r\n        observer._willBeUnregistered = true;\r\n        setTimeout(() => {\r\n            this._remove(observer);\r\n        }, 0);\r\n    }\r\n\r\n    // This should only be called when not iterating over _observers to avoid callback skipping.\r\n    // Removes an observer from the _observer Array.\r\n    private _remove(observer: Nullable<Observer<T>>): boolean {\r\n        if (!observer) {\r\n            return false;\r\n        }\r\n\r\n        const index = this._observers.indexOf(observer);\r\n\r\n        if (index !== -1) {\r\n            this._observers.splice(index, 1);\r\n            return true;\r\n        }\r\n\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * Moves the observable to the top of the observer list making it get called first when notified\r\n     * @param observer the observer to move\r\n     */\r\n    public makeObserverTopPriority(observer: Observer<T>) {\r\n        this._remove(observer);\r\n        this._observers.unshift(observer);\r\n    }\r\n\r\n    /**\r\n     * Moves the observable to the bottom of the observer list making it get called last when notified\r\n     * @param observer the observer to move\r\n     */\r\n    public makeObserverBottomPriority(observer: Observer<T>) {\r\n        this._remove(observer);\r\n        this._observers.push(observer);\r\n    }\r\n\r\n    /**\r\n     * Notify all Observers by calling their respective callback with the given data\r\n     * Will return true if all observers were executed, false if an observer set skipNextObservers to true, then prevent the subsequent ones to execute\r\n     * @param eventData defines the data to send to all observers\r\n     * @param mask defines the mask of the current notification (observers with incompatible mask (ie mask & observer.mask === 0) will not be notified)\r\n     * @param target defines the original target of the state\r\n     * @param currentTarget defines the current target of the state\r\n     * @param userInfo defines any user info to send to observers\r\n     * @returns false if the complete observer chain was not processed (because one observer set the skipNextObservers to true)\r\n     */\r\n    public notifyObservers(eventData: T, mask: number = -1, target?: any, currentTarget?: any, userInfo?: any): boolean {\r\n        if (!this._observers.length) {\r\n            return true;\r\n        }\r\n\r\n        const state = this._eventState;\r\n        state.mask = mask;\r\n        state.target = target;\r\n        state.currentTarget = currentTarget;\r\n        state.skipNextObservers = false;\r\n        state.lastReturnValue = eventData;\r\n        state.userInfo = userInfo;\r\n\r\n        for (const obs of this._observers) {\r\n            if (obs._willBeUnregistered) {\r\n                continue;\r\n            }\r\n\r\n            if (obs.mask & mask) {\r\n                if (obs.scope) {\r\n                    state.lastReturnValue = obs.callback.apply(obs.scope, [eventData, state]);\r\n                } else {\r\n                    state.lastReturnValue = obs.callback(eventData, state);\r\n                }\r\n\r\n                if (obs.unregisterOnNextCall) {\r\n                    this._deferUnregister(obs);\r\n                }\r\n            }\r\n            if (state.skipNextObservers) {\r\n                return false;\r\n            }\r\n        }\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * Notify a specific observer\r\n     * @param observer defines the observer to notify\r\n     * @param eventData defines the data to be sent to each callback\r\n     * @param mask is used to filter observers defaults to -1\r\n     */\r\n    public notifyObserver(observer: Observer<T>, eventData: T, mask: number = -1): void {\r\n        if (observer._willBeUnregistered) {\r\n            return;\r\n        }\r\n\r\n        const state = this._eventState;\r\n        state.mask = mask;\r\n        state.skipNextObservers = false;\r\n\r\n        observer.callback(eventData, state);\r\n\r\n        if (observer.unregisterOnNextCall) {\r\n            this._deferUnregister(observer);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Gets a boolean indicating if the observable has at least one observer\r\n     * @returns true is the Observable has at least one Observer registered\r\n     */\r\n    public hasObservers(): boolean {\r\n        return this._observers.length > 0;\r\n    }\r\n\r\n    /**\r\n     * Clear the list of observers\r\n     */\r\n    public clear(): void {\r\n        this._observers = new Array<Observer<T>>();\r\n        this._onObserverAdded = null;\r\n    }\r\n\r\n    /**\r\n     * Clone the current observable\r\n     * @returns a new observable\r\n     */\r\n    public clone(): Observable<T> {\r\n        const result = new Observable<T>();\r\n\r\n        result._observers = this._observers.slice(0);\r\n\r\n        return result;\r\n    }\r\n\r\n    /**\r\n     * Does this observable handles observer registered with a given mask\r\n     * @param mask defines the mask to be tested\r\n     * @returns whether or not one observer registered with the given mask is handled\r\n     **/\r\n    public hasSpecificMask(mask: number = -1): boolean {\r\n        for (const obs of this._observers) {\r\n            if (obs.mask & mask || obs.mask === mask) {\r\n                return true;\r\n            }\r\n        }\r\n        return false;\r\n    }\r\n}\r\n"]}

package/Misc/performanceMonitor.d.ts

@@ -88,12 +88,12 @@ export declare class RollingAverage {
     /**
      * Returns previously added values or null if outside of history or outside the sliding window domain
      * @param i Index in history. For example, pass 0 for the most recent value and 1 for the value before that
-     * @return Value previously recorded with add() or null if outside of range
+     * @returns Value previously recorded with add() or null if outside of range
      */
     history(i: number): number;
     /**
      * Returns true if enough samples have been taken to completely fill the sliding window
-     * @return true if sample-set saturated
+     * @returns true if sample-set saturated
      */
     isSaturated(): boolean;
     /**
@@ -103,7 +103,7 @@ export declare class RollingAverage {
     /**
      * Wraps a value around the sample range boundaries
      * @param i Position in sample range, for example if the sample length is 5, and i is -3, then 2 will be returned.
-     * @return Wrapped position in sample range
+     * @returns Wrapped position in sample range
      */
     protected _wrapPosition(i: number): number;
 }

package/Misc/performanceMonitor.js

@@ -141,7 +141,7 @@ export class RollingAverage {
     /**
      * Returns previously added values or null if outside of history or outside the sliding window domain
      * @param i Index in history. For example, pass 0 for the most recent value and 1 for the value before that
-     * @return Value previously recorded with add() or null if outside of range
+     * @returns Value previously recorded with add() or null if outside of range
      */
     history(i) {
         if (i >= this._sampleCount || i >= this._samples.length) {
@@ -152,7 +152,7 @@ export class RollingAverage {
     }
     /**
      * Returns true if enough samples have been taken to completely fill the sliding window
-     * @return true if sample-set saturated
+     * @returns true if sample-set saturated
      */
     isSaturated() {
         return this._sampleCount >= this._samples.length;
@@ -170,7 +170,7 @@ export class RollingAverage {
     /**
      * Wraps a value around the sample range boundaries
      * @param i Position in sample range, for example if the sample length is 5, and i is -3, then 2 will be returned.
-     * @return Wrapped position in sample range
+     * @returns Wrapped position in sample range
      */
     _wrapPosition(i) {
         const max = this._samples.length;

package/Misc/performanceMonitor.js.map

@@ -1 +1 @@
-{"version":3,"file":"performanceMonitor.js","sourceRoot":"","sources":["../../../../../lts/core/generated/Misc/performanceMonitor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nullable } from \"../types\";\r\nimport { PrecisionDate } from \"./precisionDate\";\r\n\r\n/**\r\n * Performance monitor tracks rolling average frame-time and frame-time variance over a user defined sliding-window\r\n */\r\nexport class PerformanceMonitor {\r\n    private _enabled: boolean = true;\r\n    private _rollingFrameTime: RollingAverage;\r\n    private _lastFrameTimeMs: Nullable<number>;\r\n\r\n    /**\r\n     * constructor\r\n     * @param frameSampleSize The number of samples required to saturate the sliding window\r\n     */\r\n    constructor(frameSampleSize: number = 30) {\r\n        this._rollingFrameTime = new RollingAverage(frameSampleSize);\r\n    }\r\n\r\n    /**\r\n     * Samples current frame\r\n     * @param timeMs A timestamp in milliseconds of the current frame to compare with other frames\r\n     */\r\n    public sampleFrame(timeMs: number = PrecisionDate.Now) {\r\n        if (!this._enabled) {\r\n            return;\r\n        }\r\n\r\n        if (this._lastFrameTimeMs != null) {\r\n            const dt = timeMs - this._lastFrameTimeMs;\r\n            this._rollingFrameTime.add(dt);\r\n        }\r\n\r\n        this._lastFrameTimeMs = timeMs;\r\n    }\r\n\r\n    /**\r\n     * Returns the average frame time in milliseconds over the sliding window (or the subset of frames sampled so far)\r\n     */\r\n    public get averageFrameTime(): number {\r\n        return this._rollingFrameTime.average;\r\n    }\r\n\r\n    /**\r\n     * Returns the variance frame time in milliseconds over the sliding window (or the subset of frames sampled so far)\r\n     */\r\n    public get averageFrameTimeVariance(): number {\r\n        return this._rollingFrameTime.variance;\r\n    }\r\n\r\n    /**\r\n     * Returns the frame time of the most recent frame\r\n     */\r\n    public get instantaneousFrameTime(): number {\r\n        return this._rollingFrameTime.history(0);\r\n    }\r\n\r\n    /**\r\n     * Returns the average framerate in frames per second over the sliding window (or the subset of frames sampled so far)\r\n     */\r\n    public get averageFPS(): number {\r\n        return 1000.0 / this._rollingFrameTime.average;\r\n    }\r\n\r\n    /**\r\n     * Returns the average framerate in frames per second using the most recent frame time\r\n     */\r\n    public get instantaneousFPS(): number {\r\n        const history = this._rollingFrameTime.history(0);\r\n\r\n        if (history === 0) {\r\n            return 0;\r\n        }\r\n\r\n        return 1000.0 / history;\r\n    }\r\n\r\n    /**\r\n     * Returns true if enough samples have been taken to completely fill the sliding window\r\n     */\r\n    public get isSaturated(): boolean {\r\n        return this._rollingFrameTime.isSaturated();\r\n    }\r\n\r\n    /**\r\n     * Enables contributions to the sliding window sample set\r\n     */\r\n    public enable() {\r\n        this._enabled = true;\r\n    }\r\n\r\n    /**\r\n     * Disables contributions to the sliding window sample set\r\n     * Samples will not be interpolated over the disabled period\r\n     */\r\n    public disable() {\r\n        this._enabled = false;\r\n        //clear last sample to avoid interpolating over the disabled period when next enabled\r\n        this._lastFrameTimeMs = null;\r\n    }\r\n\r\n    /**\r\n     * Returns true if sampling is enabled\r\n     */\r\n    public get isEnabled(): boolean {\r\n        return this._enabled;\r\n    }\r\n\r\n    /**\r\n     * Resets performance monitor\r\n     */\r\n    public reset() {\r\n        //clear last sample to avoid interpolating over the disabled period when next enabled\r\n        this._lastFrameTimeMs = null;\r\n        //wipe record\r\n        this._rollingFrameTime.reset();\r\n    }\r\n}\r\n\r\n/**\r\n * RollingAverage\r\n *\r\n * Utility to efficiently compute the rolling average and variance over a sliding window of samples\r\n */\r\nexport class RollingAverage {\r\n    /**\r\n     * Current average\r\n     */\r\n    public average: number;\r\n    /**\r\n     * Current variance\r\n     */\r\n    public variance: number;\r\n\r\n    protected _samples: Array<number>;\r\n    protected _sampleCount: number;\r\n    protected _pos: number;\r\n    protected _m2: number; //sum of squares of differences from the (current) mean\r\n\r\n    /**\r\n     * constructor\r\n     * @param length The number of samples required to saturate the sliding window\r\n     */\r\n    constructor(length: number) {\r\n        this._samples = new Array<number>(length);\r\n        this.reset();\r\n    }\r\n\r\n    /**\r\n     * Adds a sample to the sample set\r\n     * @param v The sample value\r\n     */\r\n    public add(v: number) {\r\n        //http://en.wikipedia.org/wiki/Algorithms_for_calculating_variance\r\n        let delta: number;\r\n\r\n        //we need to check if we've already wrapped round\r\n        if (this.isSaturated()) {\r\n            //remove bottom of stack from mean\r\n            const bottomValue = this._samples[this._pos];\r\n            delta = bottomValue - this.average;\r\n            this.average -= delta / (this._sampleCount - 1);\r\n            this._m2 -= delta * (bottomValue - this.average);\r\n        } else {\r\n            this._sampleCount++;\r\n        }\r\n\r\n        //add new value to mean\r\n        delta = v - this.average;\r\n        this.average += delta / this._sampleCount;\r\n        this._m2 += delta * (v - this.average);\r\n\r\n        //set the new variance\r\n        this.variance = this._m2 / (this._sampleCount - 1);\r\n\r\n        this._samples[this._pos] = v;\r\n        this._pos++;\r\n\r\n        this._pos %= this._samples.length; //positive wrap around\r\n    }\r\n\r\n    /**\r\n     * Returns previously added values or null if outside of history or outside the sliding window domain\r\n     * @param i Index in history. For example, pass 0 for the most recent value and 1 for the value before that\r\n     * @return Value previously recorded with add() or null if outside of range\r\n     */\r\n    public history(i: number): number {\r\n        if (i >= this._sampleCount || i >= this._samples.length) {\r\n            return 0;\r\n        }\r\n\r\n        const i0 = this._wrapPosition(this._pos - 1.0);\r\n        return this._samples[this._wrapPosition(i0 - i)];\r\n    }\r\n\r\n    /**\r\n     * Returns true if enough samples have been taken to completely fill the sliding window\r\n     * @return true if sample-set saturated\r\n     */\r\n    public isSaturated(): boolean {\r\n        return this._sampleCount >= this._samples.length;\r\n    }\r\n\r\n    /**\r\n     * Resets the rolling average (equivalent to 0 samples taken so far)\r\n     */\r\n    public reset() {\r\n        this.average = 0;\r\n        this.variance = 0;\r\n        this._sampleCount = 0;\r\n        this._pos = 0;\r\n        this._m2 = 0;\r\n    }\r\n\r\n    /**\r\n     * Wraps a value around the sample range boundaries\r\n     * @param i Position in sample range, for example if the sample length is 5, and i is -3, then 2 will be returned.\r\n     * @return Wrapped position in sample range\r\n     */\r\n    protected _wrapPosition(i: number): number {\r\n        const max = this._samples.length;\r\n        return ((i % max) + max) % max;\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"performanceMonitor.js","sourceRoot":"","sources":["../../../../../lts/core/generated/Misc/performanceMonitor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nullable } from \"../types\";\r\nimport { PrecisionDate } from \"./precisionDate\";\r\n\r\n/**\r\n * Performance monitor tracks rolling average frame-time and frame-time variance over a user defined sliding-window\r\n */\r\nexport class PerformanceMonitor {\r\n    private _enabled: boolean = true;\r\n    private _rollingFrameTime: RollingAverage;\r\n    private _lastFrameTimeMs: Nullable<number>;\r\n\r\n    /**\r\n     * constructor\r\n     * @param frameSampleSize The number of samples required to saturate the sliding window\r\n     */\r\n    constructor(frameSampleSize: number = 30) {\r\n        this._rollingFrameTime = new RollingAverage(frameSampleSize);\r\n    }\r\n\r\n    /**\r\n     * Samples current frame\r\n     * @param timeMs A timestamp in milliseconds of the current frame to compare with other frames\r\n     */\r\n    public sampleFrame(timeMs: number = PrecisionDate.Now) {\r\n        if (!this._enabled) {\r\n            return;\r\n        }\r\n\r\n        if (this._lastFrameTimeMs != null) {\r\n            const dt = timeMs - this._lastFrameTimeMs;\r\n            this._rollingFrameTime.add(dt);\r\n        }\r\n\r\n        this._lastFrameTimeMs = timeMs;\r\n    }\r\n\r\n    /**\r\n     * Returns the average frame time in milliseconds over the sliding window (or the subset of frames sampled so far)\r\n     */\r\n    public get averageFrameTime(): number {\r\n        return this._rollingFrameTime.average;\r\n    }\r\n\r\n    /**\r\n     * Returns the variance frame time in milliseconds over the sliding window (or the subset of frames sampled so far)\r\n     */\r\n    public get averageFrameTimeVariance(): number {\r\n        return this._rollingFrameTime.variance;\r\n    }\r\n\r\n    /**\r\n     * Returns the frame time of the most recent frame\r\n     */\r\n    public get instantaneousFrameTime(): number {\r\n        return this._rollingFrameTime.history(0);\r\n    }\r\n\r\n    /**\r\n     * Returns the average framerate in frames per second over the sliding window (or the subset of frames sampled so far)\r\n     */\r\n    public get averageFPS(): number {\r\n        return 1000.0 / this._rollingFrameTime.average;\r\n    }\r\n\r\n    /**\r\n     * Returns the average framerate in frames per second using the most recent frame time\r\n     */\r\n    public get instantaneousFPS(): number {\r\n        const history = this._rollingFrameTime.history(0);\r\n\r\n        if (history === 0) {\r\n            return 0;\r\n        }\r\n\r\n        return 1000.0 / history;\r\n    }\r\n\r\n    /**\r\n     * Returns true if enough samples have been taken to completely fill the sliding window\r\n     */\r\n    public get isSaturated(): boolean {\r\n        return this._rollingFrameTime.isSaturated();\r\n    }\r\n\r\n    /**\r\n     * Enables contributions to the sliding window sample set\r\n     */\r\n    public enable() {\r\n        this._enabled = true;\r\n    }\r\n\r\n    /**\r\n     * Disables contributions to the sliding window sample set\r\n     * Samples will not be interpolated over the disabled period\r\n     */\r\n    public disable() {\r\n        this._enabled = false;\r\n        //clear last sample to avoid interpolating over the disabled period when next enabled\r\n        this._lastFrameTimeMs = null;\r\n    }\r\n\r\n    /**\r\n     * Returns true if sampling is enabled\r\n     */\r\n    public get isEnabled(): boolean {\r\n        return this._enabled;\r\n    }\r\n\r\n    /**\r\n     * Resets performance monitor\r\n     */\r\n    public reset() {\r\n        //clear last sample to avoid interpolating over the disabled period when next enabled\r\n        this._lastFrameTimeMs = null;\r\n        //wipe record\r\n        this._rollingFrameTime.reset();\r\n    }\r\n}\r\n\r\n/**\r\n * RollingAverage\r\n *\r\n * Utility to efficiently compute the rolling average and variance over a sliding window of samples\r\n */\r\nexport class RollingAverage {\r\n    /**\r\n     * Current average\r\n     */\r\n    public average: number;\r\n    /**\r\n     * Current variance\r\n     */\r\n    public variance: number;\r\n\r\n    protected _samples: Array<number>;\r\n    protected _sampleCount: number;\r\n    protected _pos: number;\r\n    protected _m2: number; //sum of squares of differences from the (current) mean\r\n\r\n    /**\r\n     * constructor\r\n     * @param length The number of samples required to saturate the sliding window\r\n     */\r\n    constructor(length: number) {\r\n        this._samples = new Array<number>(length);\r\n        this.reset();\r\n    }\r\n\r\n    /**\r\n     * Adds a sample to the sample set\r\n     * @param v The sample value\r\n     */\r\n    public add(v: number) {\r\n        //http://en.wikipedia.org/wiki/Algorithms_for_calculating_variance\r\n        let delta: number;\r\n\r\n        //we need to check if we've already wrapped round\r\n        if (this.isSaturated()) {\r\n            //remove bottom of stack from mean\r\n            const bottomValue = this._samples[this._pos];\r\n            delta = bottomValue - this.average;\r\n            this.average -= delta / (this._sampleCount - 1);\r\n            this._m2 -= delta * (bottomValue - this.average);\r\n        } else {\r\n            this._sampleCount++;\r\n        }\r\n\r\n        //add new value to mean\r\n        delta = v - this.average;\r\n        this.average += delta / this._sampleCount;\r\n        this._m2 += delta * (v - this.average);\r\n\r\n        //set the new variance\r\n        this.variance = this._m2 / (this._sampleCount - 1);\r\n\r\n        this._samples[this._pos] = v;\r\n        this._pos++;\r\n\r\n        this._pos %= this._samples.length; //positive wrap around\r\n    }\r\n\r\n    /**\r\n     * Returns previously added values or null if outside of history or outside the sliding window domain\r\n     * @param i Index in history. For example, pass 0 for the most recent value and 1 for the value before that\r\n     * @returns Value previously recorded with add() or null if outside of range\r\n     */\r\n    public history(i: number): number {\r\n        if (i >= this._sampleCount || i >= this._samples.length) {\r\n            return 0;\r\n        }\r\n\r\n        const i0 = this._wrapPosition(this._pos - 1.0);\r\n        return this._samples[this._wrapPosition(i0 - i)];\r\n    }\r\n\r\n    /**\r\n     * Returns true if enough samples have been taken to completely fill the sliding window\r\n     * @returns true if sample-set saturated\r\n     */\r\n    public isSaturated(): boolean {\r\n        return this._sampleCount >= this._samples.length;\r\n    }\r\n\r\n    /**\r\n     * Resets the rolling average (equivalent to 0 samples taken so far)\r\n     */\r\n    public reset() {\r\n        this.average = 0;\r\n        this.variance = 0;\r\n        this._sampleCount = 0;\r\n        this._pos = 0;\r\n        this._m2 = 0;\r\n    }\r\n\r\n    /**\r\n     * Wraps a value around the sample range boundaries\r\n     * @param i Position in sample range, for example if the sample length is 5, and i is -3, then 2 will be returned.\r\n     * @returns Wrapped position in sample range\r\n     */\r\n    protected _wrapPosition(i: number): number {\r\n        const max = this._samples.length;\r\n        return ((i % max) + max) % max;\r\n    }\r\n}\r\n"]}

package/Misc/rgbdTextureTools.d.ts

@@ -17,7 +17,7 @@ export declare class RGBDTextureTools {
      * @param internalTexture the texture to encode
      * @param scene the scene hosting the texture
      * @param outputTextureType type of the texture in which the encoding is performed
-     * @return a promise with the internalTexture having its texture replaced by the result of the processing
+     * @returns a promise with the internalTexture having its texture replaced by the result of the processing
      */
     static EncodeTextureToRGBD(internalTexture: InternalTexture, scene: Scene, outputTextureType?: number): Promise<InternalTexture>;
 }

package/Misc/rgbdTextureTools.js

@@ -84,7 +84,7 @@ export class RGBDTextureTools {
      * @param internalTexture the texture to encode
      * @param scene the scene hosting the texture
      * @param outputTextureType type of the texture in which the encoding is performed
-     * @return a promise with the internalTexture having its texture replaced by the result of the processing
+     * @returns a promise with the internalTexture having its texture replaced by the result of the processing
      */
     static EncodeTextureToRGBD(internalTexture, scene, outputTextureType = 0) {
         return ApplyPostProcess("rgbdEncode", internalTexture, scene, outputTextureType, 1, 5);

package/Misc/rgbdTextureTools.js.map

@@ -1 +1 @@
-{"version":3,"file":"rgbdTextureTools.js","sourceRoot":"","sources":["../../../../../lts/core/generated/Misc/rgbdTextureTools.ts"],"names":[],"mappings":"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","sourcesContent":["import { Constants } from \"../Engines/constants\";\r\nimport { PostProcess } from \"../PostProcesses/postProcess\";\r\nimport \"../Shaders/rgbdDecode.fragment\";\r\nimport type { Engine } from \"../Engines/engine\";\r\n\r\nimport \"../Engines/Extensions/engine.renderTarget\";\r\nimport { ApplyPostProcess } from \"./textureTools\";\r\n\r\ndeclare type Texture = import(\"../Materials/Textures/texture\").Texture;\r\ndeclare type InternalTexture = import(\"../Materials/Textures/internalTexture\").InternalTexture;\r\ndeclare type Scene = import(\"../scene\").Scene;\r\n\r\n/**\r\n * Class used to host RGBD texture specific utilities\r\n */\r\nexport class RGBDTextureTools {\r\n    /**\r\n     * Expand the RGBD Texture from RGBD to Half Float if possible.\r\n     * @param texture the texture to expand.\r\n     */\r\n    public static ExpandRGBDTexture(texture: Texture) {\r\n        const internalTexture = texture._texture;\r\n        if (!internalTexture || !texture.isRGBD) {\r\n            return;\r\n        }\r\n\r\n        // Gets everything ready.\r\n        const engine = internalTexture.getEngine() as Engine;\r\n        const caps = engine.getCaps();\r\n        const isReady = internalTexture.isReady;\r\n        let expandTexture = false;\r\n\r\n        // If half float available we can uncompress the texture\r\n        if (caps.textureHalfFloatRender && caps.textureHalfFloatLinearFiltering) {\r\n            expandTexture = true;\r\n            internalTexture.type = Constants.TEXTURETYPE_HALF_FLOAT;\r\n        }\r\n        // If full float available we can uncompress the texture\r\n        else if (caps.textureFloatRender && caps.textureFloatLinearFiltering) {\r\n            expandTexture = true;\r\n            internalTexture.type = Constants.TEXTURETYPE_FLOAT;\r\n        }\r\n\r\n        if (expandTexture) {\r\n            // Do not use during decode.\r\n            internalTexture.isReady = false;\r\n            internalTexture._isRGBD = false;\r\n            internalTexture.invertY = false;\r\n        }\r\n\r\n        const expandRGBDTexture = () => {\r\n            // Expand the texture if possible\r\n            if (expandTexture) {\r\n                // Simply run through the decode PP.\r\n                const rgbdPostProcess = new PostProcess(\r\n                    \"rgbdDecode\",\r\n                    \"rgbdDecode\",\r\n                    null,\r\n                    null,\r\n                    1,\r\n                    null,\r\n                    Constants.TEXTURE_TRILINEAR_SAMPLINGMODE,\r\n                    engine,\r\n                    false,\r\n                    undefined,\r\n                    internalTexture.type,\r\n                    undefined,\r\n                    null,\r\n                    false\r\n                );\r\n                rgbdPostProcess.externalTextureSamplerBinding = true;\r\n\r\n                // Hold the output of the decoding.\r\n                const expandedTexture = engine.createRenderTargetTexture(internalTexture.width, {\r\n                    generateDepthBuffer: false,\r\n                    generateMipMaps: false,\r\n                    generateStencilBuffer: false,\r\n                    samplingMode: internalTexture.samplingMode,\r\n                    type: internalTexture.type,\r\n                    format: Constants.TEXTUREFORMAT_RGBA,\r\n                });\r\n\r\n                rgbdPostProcess.getEffect().executeWhenCompiled(() => {\r\n                    // PP Render Pass\r\n                    rgbdPostProcess.onApply = (effect) => {\r\n                        effect._bindTexture(\"textureSampler\", internalTexture);\r\n                        effect.setFloat2(\"scale\", 1, 1);\r\n                    };\r\n                    texture.getScene()!.postProcessManager.directRender([rgbdPostProcess!], expandedTexture, true);\r\n\r\n                    // Cleanup\r\n                    engine.restoreDefaultFramebuffer();\r\n                    engine._releaseTexture(internalTexture);\r\n                    if (rgbdPostProcess) {\r\n                        rgbdPostProcess.dispose();\r\n                    }\r\n\r\n                    // Internal Swap\r\n                    expandedTexture._swapAndDie(internalTexture);\r\n\r\n                    // Ready to get rolling again.\r\n                    internalTexture.isReady = true;\r\n                });\r\n            }\r\n        };\r\n\r\n        if (isReady) {\r\n            expandRGBDTexture();\r\n        } else {\r\n            texture.onLoadObservable.addOnce(expandRGBDTexture);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Encode the texture to RGBD if possible.\r\n     * @param internalTexture the texture to encode\r\n     * @param scene the scene hosting the texture\r\n     * @param outputTextureType type of the texture in which the encoding is performed\r\n     * @return a promise with the internalTexture having its texture replaced by the result of the processing\r\n     */\r\n    public static EncodeTextureToRGBD(internalTexture: InternalTexture, scene: Scene, outputTextureType = Constants.TEXTURETYPE_UNSIGNED_BYTE): Promise<InternalTexture> {\r\n        return ApplyPostProcess(\"rgbdEncode\", internalTexture, scene, outputTextureType, Constants.TEXTURE_NEAREST_SAMPLINGMODE, Constants.TEXTUREFORMAT_RGBA);\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"rgbdTextureTools.js","sourceRoot":"","sources":["../../../../../lts/core/generated/Misc/rgbdTextureTools.ts"],"names":[],"mappings":"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","sourcesContent":["import { Constants } from \"../Engines/constants\";\r\nimport { PostProcess } from \"../PostProcesses/postProcess\";\r\nimport \"../Shaders/rgbdDecode.fragment\";\r\nimport type { Engine } from \"../Engines/engine\";\r\n\r\nimport \"../Engines/Extensions/engine.renderTarget\";\r\nimport { ApplyPostProcess } from \"./textureTools\";\r\n\r\ndeclare type Texture = import(\"../Materials/Textures/texture\").Texture;\r\ndeclare type InternalTexture = import(\"../Materials/Textures/internalTexture\").InternalTexture;\r\ndeclare type Scene = import(\"../scene\").Scene;\r\n\r\n/**\r\n * Class used to host RGBD texture specific utilities\r\n */\r\nexport class RGBDTextureTools {\r\n    /**\r\n     * Expand the RGBD Texture from RGBD to Half Float if possible.\r\n     * @param texture the texture to expand.\r\n     */\r\n    public static ExpandRGBDTexture(texture: Texture) {\r\n        const internalTexture = texture._texture;\r\n        if (!internalTexture || !texture.isRGBD) {\r\n            return;\r\n        }\r\n\r\n        // Gets everything ready.\r\n        const engine = internalTexture.getEngine() as Engine;\r\n        const caps = engine.getCaps();\r\n        const isReady = internalTexture.isReady;\r\n        let expandTexture = false;\r\n\r\n        // If half float available we can uncompress the texture\r\n        if (caps.textureHalfFloatRender && caps.textureHalfFloatLinearFiltering) {\r\n            expandTexture = true;\r\n            internalTexture.type = Constants.TEXTURETYPE_HALF_FLOAT;\r\n        }\r\n        // If full float available we can uncompress the texture\r\n        else if (caps.textureFloatRender && caps.textureFloatLinearFiltering) {\r\n            expandTexture = true;\r\n            internalTexture.type = Constants.TEXTURETYPE_FLOAT;\r\n        }\r\n\r\n        if (expandTexture) {\r\n            // Do not use during decode.\r\n            internalTexture.isReady = false;\r\n            internalTexture._isRGBD = false;\r\n            internalTexture.invertY = false;\r\n        }\r\n\r\n        const expandRGBDTexture = () => {\r\n            // Expand the texture if possible\r\n            if (expandTexture) {\r\n                // Simply run through the decode PP.\r\n                const rgbdPostProcess = new PostProcess(\r\n                    \"rgbdDecode\",\r\n                    \"rgbdDecode\",\r\n                    null,\r\n                    null,\r\n                    1,\r\n                    null,\r\n                    Constants.TEXTURE_TRILINEAR_SAMPLINGMODE,\r\n                    engine,\r\n                    false,\r\n                    undefined,\r\n                    internalTexture.type,\r\n                    undefined,\r\n                    null,\r\n                    false\r\n                );\r\n                rgbdPostProcess.externalTextureSamplerBinding = true;\r\n\r\n                // Hold the output of the decoding.\r\n                const expandedTexture = engine.createRenderTargetTexture(internalTexture.width, {\r\n                    generateDepthBuffer: false,\r\n                    generateMipMaps: false,\r\n                    generateStencilBuffer: false,\r\n                    samplingMode: internalTexture.samplingMode,\r\n                    type: internalTexture.type,\r\n                    format: Constants.TEXTUREFORMAT_RGBA,\r\n                });\r\n\r\n                rgbdPostProcess.getEffect().executeWhenCompiled(() => {\r\n                    // PP Render Pass\r\n                    rgbdPostProcess.onApply = (effect) => {\r\n                        effect._bindTexture(\"textureSampler\", internalTexture);\r\n                        effect.setFloat2(\"scale\", 1, 1);\r\n                    };\r\n                    texture.getScene()!.postProcessManager.directRender([rgbdPostProcess!], expandedTexture, true);\r\n\r\n                    // Cleanup\r\n                    engine.restoreDefaultFramebuffer();\r\n                    engine._releaseTexture(internalTexture);\r\n                    if (rgbdPostProcess) {\r\n                        rgbdPostProcess.dispose();\r\n                    }\r\n\r\n                    // Internal Swap\r\n                    expandedTexture._swapAndDie(internalTexture);\r\n\r\n                    // Ready to get rolling again.\r\n                    internalTexture.isReady = true;\r\n                });\r\n            }\r\n        };\r\n\r\n        if (isReady) {\r\n            expandRGBDTexture();\r\n        } else {\r\n            texture.onLoadObservable.addOnce(expandRGBDTexture);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Encode the texture to RGBD if possible.\r\n     * @param internalTexture the texture to encode\r\n     * @param scene the scene hosting the texture\r\n     * @param outputTextureType type of the texture in which the encoding is performed\r\n     * @returns a promise with the internalTexture having its texture replaced by the result of the processing\r\n     */\r\n    public static EncodeTextureToRGBD(internalTexture: InternalTexture, scene: Scene, outputTextureType = Constants.TEXTURETYPE_UNSIGNED_BYTE): Promise<InternalTexture> {\r\n        return ApplyPostProcess(\"rgbdEncode\", internalTexture, scene, outputTextureType, Constants.TEXTURE_NEAREST_SAMPLINGMODE, Constants.TEXTUREFORMAT_RGBA);\r\n    }\r\n}\r\n"]}

package/Misc/sceneOptimizer.d.ts

@@ -101,7 +101,7 @@ export declare class HardwareScalingOptimization extends SceneOptimization {
     private _directionOffset;
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription(): string;
     /**
@@ -138,7 +138,7 @@ export declare class HardwareScalingOptimization extends SceneOptimization {
 export declare class ShadowsOptimization extends SceneOptimization {
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription(): string;
     /**
@@ -156,7 +156,7 @@ export declare class ShadowsOptimization extends SceneOptimization {
 export declare class PostProcessesOptimization extends SceneOptimization {
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription(): string;
     /**
@@ -174,7 +174,7 @@ export declare class PostProcessesOptimization extends SceneOptimization {
 export declare class LensFlaresOptimization extends SceneOptimization {
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription(): string;
     /**
@@ -218,7 +218,7 @@ export declare class CustomOptimization extends SceneOptimization {
 export declare class ParticlesOptimization extends SceneOptimization {
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription(): string;
     /**
@@ -236,7 +236,7 @@ export declare class ParticlesOptimization extends SceneOptimization {
 export declare class RenderTargetsOptimization extends SceneOptimization {
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription(): string;
     /**
@@ -263,7 +263,7 @@ export declare class MergeMeshesOptimization extends SceneOptimization {
     static set UpdateSelectionTree(value: boolean);
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription(): string;
     private _canBeMerged;

package/Misc/sceneOptimizer.js

@@ -126,7 +126,7 @@ export class HardwareScalingOptimization extends SceneOptimization {
     }
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription() {
         return "Setting hardware scaling level to " + this._currentScale;
@@ -156,7 +156,7 @@ export class HardwareScalingOptimization extends SceneOptimization {
 export class ShadowsOptimization extends SceneOptimization {
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription() {
         return "Turning shadows on/off";
@@ -179,7 +179,7 @@ export class ShadowsOptimization extends SceneOptimization {
 export class PostProcessesOptimization extends SceneOptimization {
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription() {
         return "Turning post-processes on/off";
@@ -202,7 +202,7 @@ export class PostProcessesOptimization extends SceneOptimization {
 export class LensFlaresOptimization extends SceneOptimization {
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription() {
         return "Turning lens flares on/off";
@@ -253,7 +253,7 @@ export class CustomOptimization extends SceneOptimization {
 export class ParticlesOptimization extends SceneOptimization {
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription() {
         return "Turning particles on/off";
@@ -276,7 +276,7 @@ export class ParticlesOptimization extends SceneOptimization {
 export class RenderTargetsOptimization extends SceneOptimization {
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription() {
         return "Turning render targets off";
@@ -333,7 +333,7 @@ export class MergeMeshesOptimization extends SceneOptimization {
     }
     /**
      * Gets a string describing the action executed by the current optimization
-     * @return description string
+     * @returns description string
      */
     getDescription() {
         return "Merging similar meshes together";