@onerjs/core 8.25.3 → 8.25.5

package/Materials/Textures/envCubeTexture.d.ts

@@ -0,0 +1,125 @@
+import type { Nullable } from "../../types.js";
+import type { Scene } from "../../scene.js";
+import { Matrix, Vector3 } from "../../Maths/math.vector.js";
+import { BaseTexture } from "../../Materials/Textures/baseTexture.js";
+import { Observable } from "../../Misc/observable.js";
+import type { AbstractEngine } from "../../Engines/abstractEngine.js";
+import "../../Materials/Textures/baseTexture.polynomial.js";
+import type { CubeMapInfo } from "../../Misc/HighDynamicRange/panoramaToCubemap.js";
+/**
+ * This represents an environment base texture which could for instance be from HDR or EXR files.
+ */
+export declare abstract class EnvCubeTexture extends BaseTexture {
+    private static _FacesMapping;
+    protected _generateHarmonics: boolean;
+    protected _noMipmap: boolean;
+    protected _size: number;
+    private _prefilterOnLoad;
+    private _prefilterIrradianceOnLoad;
+    private _prefilterUsingCdf;
+    private _textureMatrix;
+    private _supersample;
+    private _onLoad;
+    private _onError;
+    /**
+     * The texture URL.
+     */
+    url: string;
+    protected _isBlocking: boolean;
+    /**
+     * Sets whether or not the texture is blocking during loading.
+     */
+    set isBlocking(value: boolean);
+    /**
+     * Gets whether or not the texture is blocking during loading.
+     */
+    get isBlocking(): boolean;
+    protected _rotationY: number;
+    /**
+     * Sets texture matrix rotation angle around Y axis in radians.
+     */
+    set rotationY(value: number);
+    /**
+     * Gets texture matrix rotation angle around Y axis radians.
+     */
+    get rotationY(): number;
+    /**
+     * Gets or sets the center of the bounding box associated with the cube texture
+     * It must define where the camera used to render the texture was set
+     */
+    boundingBoxPosition: Vector3;
+    private _boundingBoxSize;
+    /**
+     * Gets or sets the size of the bounding box associated with the cube texture
+     * When defined, the cubemap will switch to local mode
+     * @see https://community.arm.com/graphics/b/blog/posts/reflections-based-on-local-cubemaps-in-unity
+     * @example https://www.babylonjs-playground.com/#RNASML
+     */
+    set boundingBoxSize(value: Vector3);
+    get boundingBoxSize(): Vector3;
+    /**
+     * Observable triggered once the texture has been loaded.
+     */
+    onLoadObservable: Observable<EnvCubeTexture>;
+    /**
+     * Instantiates an EnvCubeTexture from the following parameters.
+     *
+     * @param url The location of the raw data (Panorama stored in RGBE format)
+     * @param sceneOrEngine The scene or engine the texture will be used in
+     * @param size The cubemap desired size (the more it increases the longer the generation will be)
+     * @param noMipmap Forces to not generate the mipmap if true
+     * @param generateHarmonics Specifies whether you want to extract the polynomial harmonics during the generation process
+     * @param gammaSpace Specifies if the texture will be use in gamma or linear space (the PBR material requires those texture in linear space, but the standard material would require them in Gamma space)
+     * @param prefilterOnLoad Prefilters texture to allow use of this texture as a PBR reflection texture.
+     * @param onLoad on success callback function
+     * @param onError on error callback function
+     * @param supersample Defines if texture must be supersampled (default: false)
+     * @param prefilterIrradianceOnLoad Prefilters texture to allow use of this texture for irradiance lighting.
+     * @param prefilterUsingCdf Defines if the prefiltering should be done using a CDF instead of the default approach.
+     */
+    constructor(url: string, sceneOrEngine: Scene | AbstractEngine, size: number, noMipmap?: boolean, generateHarmonics?: boolean, gammaSpace?: boolean, prefilterOnLoad?: boolean, onLoad?: Nullable<() => void>, onError?: Nullable<(message?: string, exception?: any) => void>, supersample?: boolean, prefilterIrradianceOnLoad?: boolean, prefilterUsingCdf?: boolean);
+    /**
+     * Get the current class name of the texture useful for serialization or dynamic coding.
+     * @returns "EnvCubeTexture"
+     */
+    getClassName(): string;
+    /**
+     * Convert the raw data from the server into cubemap faces
+     * @param buffer The buffer containing the texture data
+     * @param size The cubemap face size
+     * @param supersample Defines if texture must be supersampled
+     * @returns The cube map data
+     */
+    protected abstract _getCubeMapTextureDataAsync(buffer: ArrayBuffer, size: number, supersample: boolean): Promise<CubeMapInfo>;
+    /**
+     * Occurs when the file has been loaded.
+     */
+    private _loadTexture;
+    delayLoad(): void;
+    /**
+     * Get the texture reflection matrix used to rotate/transform the reflection.
+     * @returns the reflection matrix
+     */
+    getReflectionTextureMatrix(): Matrix;
+    /**
+     * Set the texture reflection matrix used to rotate/transform the reflection.
+     * @param value Define the reflection matrix to set
+     */
+    setReflectionTextureMatrix(value: Matrix): void;
+    /**
+     * Dispose the texture and release its associated resources.
+     */
+    dispose(): void;
+    /**
+     * Serializes the texture to a JSON representation.
+     * @returns the JSON representation
+     */
+    serialize(): any;
+    protected abstract _instantiateClone(): this;
+    /**
+     * Clones the current texture.
+     * @returns the cloned texture
+     */
+    clone(): this;
+    protected static _Parse(parsedTexture: any, texture: EnvCubeTexture): void;
+}

package/Materials/Textures/envCubeTexture.js

@@ -0,0 +1,351 @@
+import { Matrix, Vector3 } from "../../Maths/math.vector.js";
+import { BaseTexture } from "../../Materials/Textures/baseTexture.js";
+import { Texture } from "../../Materials/Textures/texture.js";
+
+import { CubeMapToSphericalPolynomialTools } from "../../Misc/HighDynamicRange/cubemapToSphericalPolynomial.js";
+import { Observable } from "../../Misc/observable.js";
+import { Tools } from "../../Misc/tools.js";
+import { ToGammaSpace } from "../../Maths/math.constants.js";
+import { HDRFiltering } from "../../Materials/Textures/Filtering/hdrFiltering.js";
+import { HDRIrradianceFiltering } from "../../Materials/Textures/Filtering/hdrIrradianceFiltering.js";
+import { ToHalfFloat } from "../../Misc/textureTools.js";
+import "../../Materials/Textures/baseTexture.polynomial.js";
+/**
+ * This represents an environment base texture which could for instance be from HDR or EXR files.
+ */
+export class EnvCubeTexture extends BaseTexture {
+    /**
+     * Sets whether or not the texture is blocking during loading.
+     */
+    set isBlocking(value) {
+        this._isBlocking = value;
+    }
+    /**
+     * Gets whether or not the texture is blocking during loading.
+     */
+    get isBlocking() {
+        return this._isBlocking;
+    }
+    /**
+     * Sets texture matrix rotation angle around Y axis in radians.
+     */
+    set rotationY(value) {
+        this._rotationY = value;
+        this.setReflectionTextureMatrix(Matrix.RotationY(this._rotationY));
+    }
+    /**
+     * Gets texture matrix rotation angle around Y axis radians.
+     */
+    get rotationY() {
+        return this._rotationY;
+    }
+    /**
+     * Gets or sets the size of the bounding box associated with the cube texture
+     * When defined, the cubemap will switch to local mode
+     * @see https://community.arm.com/graphics/b/blog/posts/reflections-based-on-local-cubemaps-in-unity
+     * @example https://www.babylonjs-playground.com/#RNASML
+     */
+    set boundingBoxSize(value) {
+        if (this._boundingBoxSize && this._boundingBoxSize.equals(value)) {
+            return;
+        }
+        this._boundingBoxSize = value;
+        const scene = this.getScene();
+        if (scene) {
+            scene.markAllMaterialsAsDirty(1);
+        }
+    }
+    get boundingBoxSize() {
+        return this._boundingBoxSize;
+    }
+    /**
+     * Instantiates an EnvCubeTexture from the following parameters.
+     *
+     * @param url The location of the raw data (Panorama stored in RGBE format)
+     * @param sceneOrEngine The scene or engine the texture will be used in
+     * @param size The cubemap desired size (the more it increases the longer the generation will be)
+     * @param noMipmap Forces to not generate the mipmap if true
+     * @param generateHarmonics Specifies whether you want to extract the polynomial harmonics during the generation process
+     * @param gammaSpace Specifies if the texture will be use in gamma or linear space (the PBR material requires those texture in linear space, but the standard material would require them in Gamma space)
+     * @param prefilterOnLoad Prefilters texture to allow use of this texture as a PBR reflection texture.
+     * @param onLoad on success callback function
+     * @param onError on error callback function
+     * @param supersample Defines if texture must be supersampled (default: false)
+     * @param prefilterIrradianceOnLoad Prefilters texture to allow use of this texture for irradiance lighting.
+     * @param prefilterUsingCdf Defines if the prefiltering should be done using a CDF instead of the default approach.
+     */
+    constructor(url, sceneOrEngine, size, noMipmap = false, generateHarmonics = true, gammaSpace = false, prefilterOnLoad = false, onLoad = null, onError = null, supersample = false, prefilterIrradianceOnLoad = false, prefilterUsingCdf = false) {
+        super(sceneOrEngine);
+        this._generateHarmonics = true;
+        this._onError = null;
+        this._isBlocking = true;
+        this._rotationY = 0;
+        /**
+         * Gets or sets the center of the bounding box associated with the cube texture
+         * It must define where the camera used to render the texture was set
+         */
+        this.boundingBoxPosition = Vector3.Zero();
+        /**
+         * Observable triggered once the texture has been loaded.
+         */
+        this.onLoadObservable = new Observable();
+        if (!url) {
+            return;
+        }
+        this._coordinatesMode = Texture.CUBIC_MODE;
+        this.name = url;
+        this.url = url;
+        this.hasAlpha = false;
+        this.isCube = true;
+        this._textureMatrix = Matrix.Identity();
+        this._prefilterOnLoad = prefilterOnLoad;
+        this._prefilterIrradianceOnLoad = prefilterIrradianceOnLoad;
+        this._prefilterUsingCdf = prefilterUsingCdf;
+        this._onLoad = () => {
+            this.onLoadObservable.notifyObservers(this);
+            if (onLoad) {
+                onLoad();
+            }
+        };
+        this._onError = onError;
+        this.gammaSpace = gammaSpace;
+        this._noMipmap = noMipmap;
+        this._size = size;
+        // CDF is very sensitive to lost precision due to downsampling. This can result in
+        // noticeable brightness differences with different resolutions. Enabling supersampling
+        // mitigates this.
+        this._supersample = supersample || prefilterUsingCdf;
+        this._generateHarmonics = generateHarmonics;
+        this._texture = this._getFromCache(url, this._noMipmap, undefined, undefined, undefined, this.isCube);
+        if (!this._texture) {
+            if (!this.getScene()?.useDelayedTextureLoading) {
+                this._loadTexture();
+            }
+            else {
+                this.delayLoadState = 4;
+            }
+        }
+        else {
+            if (this._texture.isReady) {
+                Tools.SetImmediate(() => this._onLoad());
+            }
+            else {
+                this._texture.onLoadedObservable.add(this._onLoad);
+            }
+        }
+    }
+    /**
+     * Get the current class name of the texture useful for serialization or dynamic coding.
+     * @returns "EnvCubeTexture"
+     */
+    getClassName() {
+        return "EnvCubeTexture";
+    }
+    /**
+     * Occurs when the file has been loaded.
+     */
+    _loadTexture() {
+        const engine = this._getEngine();
+        const caps = engine.getCaps();
+        let textureType = 0;
+        if (caps.textureFloat && caps.textureFloatLinearFiltering) {
+            textureType = 1;
+        }
+        else if (caps.textureHalfFloat && caps.textureHalfFloatLinearFiltering) {
+            textureType = 2;
+        }
+        // eslint-disable-next-line no-restricted-syntax
+        const callback = async (buffer) => {
+            this.lodGenerationOffset = 0.0;
+            this.lodGenerationScale = 0.8;
+            // Extract the raw linear data.
+            const data = await this._getCubeMapTextureDataAsync(buffer, this._size, this._supersample);
+            // Generate harmonics if needed.
+            if (this._generateHarmonics) {
+                const sphericalPolynomial = CubeMapToSphericalPolynomialTools.ConvertCubeMapToSphericalPolynomial(data);
+                this.sphericalPolynomial = sphericalPolynomial;
+            }
+            const results = [];
+            let byteArray = null;
+            let shortArray = null;
+            // Push each faces.
+            for (let j = 0; j < 6; j++) {
+                // Create fallback array
+                if (textureType === 2) {
+                    shortArray = new Uint16Array(this._size * this._size * 3);
+                }
+                else if (textureType === 0) {
+                    // 3 channels of 1 bytes per pixel in bytes.
+                    byteArray = new Uint8Array(this._size * this._size * 3);
+                }
+                const dataFace = data[EnvCubeTexture._FacesMapping[j]];
+                // If special cases.
+                if (this.gammaSpace || shortArray || byteArray) {
+                    for (let i = 0; i < this._size * this._size; i++) {
+                        // Put in gamma space if requested.
+                        if (this.gammaSpace) {
+                            dataFace[i * 3 + 0] = Math.pow(dataFace[i * 3 + 0], ToGammaSpace);
+                            dataFace[i * 3 + 1] = Math.pow(dataFace[i * 3 + 1], ToGammaSpace);
+                            dataFace[i * 3 + 2] = Math.pow(dataFace[i * 3 + 2], ToGammaSpace);
+                        }
+                        // Convert to half float texture for fallback.
+                        if (shortArray) {
+                            shortArray[i * 3 + 0] = ToHalfFloat(dataFace[i * 3 + 0]);
+                            shortArray[i * 3 + 1] = ToHalfFloat(dataFace[i * 3 + 1]);
+                            shortArray[i * 3 + 2] = ToHalfFloat(dataFace[i * 3 + 2]);
+                        }
+                        // Convert to int texture for fallback.
+                        if (byteArray) {
+                            let r = Math.max(dataFace[i * 3 + 0] * 255, 0);
+                            let g = Math.max(dataFace[i * 3 + 1] * 255, 0);
+                            let b = Math.max(dataFace[i * 3 + 2] * 255, 0);
+                            // May use luminance instead if the result is not accurate.
+                            const max = Math.max(Math.max(r, g), b);
+                            if (max > 255) {
+                                const scale = 255 / max;
+                                r *= scale;
+                                g *= scale;
+                                b *= scale;
+                            }
+                            byteArray[i * 3 + 0] = r;
+                            byteArray[i * 3 + 1] = g;
+                            byteArray[i * 3 + 2] = b;
+                        }
+                    }
+                }
+                if (shortArray) {
+                    results.push(shortArray);
+                }
+                else if (byteArray) {
+                    results.push(byteArray);
+                }
+                else {
+                    results.push(dataFace);
+                }
+            }
+            return results;
+        };
+        if (engine._features.allowTexturePrefiltering && (this._prefilterOnLoad || this._prefilterIrradianceOnLoad)) {
+            const previousOnLoad = this._onLoad;
+            const hdrFiltering = new HDRFiltering(engine);
+            this._onLoad = () => {
+                let irradiancePromise = Promise.resolve(null);
+                let radiancePromise = Promise.resolve();
+                if (this._prefilterIrradianceOnLoad) {
+                    const hdrIrradianceFiltering = new HDRIrradianceFiltering(engine, { useCdf: this._prefilterUsingCdf });
+                    irradiancePromise = hdrIrradianceFiltering.prefilter(this);
+                }
+                if (this._prefilterOnLoad) {
+                    radiancePromise = hdrFiltering.prefilter(this);
+                }
+                // eslint-disable-next-line @typescript-eslint/no-floating-promises, github/no-then
+                Promise.all([irradiancePromise, radiancePromise]).then((results) => {
+                    const irradianceTexture = results[0];
+                    if (this._prefilterIrradianceOnLoad && irradianceTexture) {
+                        this.irradianceTexture = irradianceTexture;
+                        const scene = this.getScene();
+                        if (scene) {
+                            scene.markAllMaterialsAsDirty(1);
+                        }
+                    }
+                    if (previousOnLoad) {
+                        previousOnLoad();
+                    }
+                });
+            };
+        }
+        this._texture = engine.createRawCubeTextureFromUrl(this.url, this.getScene(), this._size, 4, textureType, this._noMipmap, callback, null, this._onLoad, this._onError);
+    }
+    // Methods
+    delayLoad() {
+        if (this.delayLoadState !== 4) {
+            return;
+        }
+        this.delayLoadState = 1;
+        this._texture = this._getFromCache(this.url, this._noMipmap);
+        if (!this._texture) {
+            this._loadTexture();
+        }
+    }
+    /**
+     * Get the texture reflection matrix used to rotate/transform the reflection.
+     * @returns the reflection matrix
+     */
+    getReflectionTextureMatrix() {
+        return this._textureMatrix;
+    }
+    /**
+     * Set the texture reflection matrix used to rotate/transform the reflection.
+     * @param value Define the reflection matrix to set
+     */
+    setReflectionTextureMatrix(value) {
+        this._textureMatrix = value;
+        if (value.updateFlag === this._textureMatrix.updateFlag) {
+            return;
+        }
+        if (value.isIdentity() !== this._textureMatrix.isIdentity()) {
+            this.getScene()?.markAllMaterialsAsDirty(1, (mat) => mat.getActiveTextures().indexOf(this) !== -1);
+        }
+    }
+    /**
+     * Dispose the texture and release its associated resources.
+     */
+    dispose() {
+        this.onLoadObservable.clear();
+        super.dispose();
+    }
+    /**
+     * Serializes the texture to a JSON representation.
+     * @returns the JSON representation
+     */
+    serialize() {
+        if (!this.name) {
+            return null;
+        }
+        const serializationObject = {};
+        serializationObject.name = this.name;
+        serializationObject.hasAlpha = this.hasAlpha;
+        serializationObject.isCube = true;
+        serializationObject.level = this.level;
+        serializationObject.size = this._size;
+        serializationObject.coordinatesMode = this.coordinatesMode;
+        serializationObject.useInGammaSpace = this.gammaSpace;
+        serializationObject.generateHarmonics = this._generateHarmonics;
+        serializationObject.noMipmap = this._noMipmap;
+        serializationObject.isBlocking = this._isBlocking;
+        serializationObject.rotationY = this._rotationY;
+        return serializationObject;
+    }
+    /**
+     * Clones the current texture.
+     * @returns the cloned texture
+     */
+    clone() {
+        const newTexture = this._instantiateClone();
+        // Base Texture
+        newTexture.level = this.level;
+        newTexture.wrapU = this.wrapU;
+        newTexture.wrapV = this.wrapV;
+        newTexture.coordinatesIndex = this.coordinatesIndex;
+        newTexture.coordinatesMode = this.coordinatesMode;
+        return newTexture;
+    }
+    static _Parse(parsedTexture, texture) {
+        texture.name = parsedTexture.name;
+        texture.hasAlpha = parsedTexture.hasAlpha;
+        texture.level = parsedTexture.level;
+        texture.coordinatesMode = parsedTexture.coordinatesMode;
+        texture.isBlocking = parsedTexture.isBlocking;
+        if (parsedTexture.boundingBoxPosition) {
+            texture.boundingBoxPosition = Vector3.FromArray(parsedTexture.boundingBoxPosition);
+        }
+        if (parsedTexture.boundingBoxSize) {
+            texture.boundingBoxSize = Vector3.FromArray(parsedTexture.boundingBoxSize);
+        }
+        if (parsedTexture.rotationY) {
+            texture.rotationY = parsedTexture.rotationY;
+        }
+    }
+}
+EnvCubeTexture._FacesMapping = ["right", "left", "up", "down", "front", "back"];
+//# sourceMappingURL=envCubeTexture.js.map

package/Materials/Textures/envCubeTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envCubeTexture.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/envCubeTexture.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nullable } from \"../../types\";\r\nimport type { Scene } from \"../../scene\";\r\nimport { Matrix, Vector3 } from \"../../Maths/math.vector\";\r\nimport { BaseTexture } from \"../../Materials/Textures/baseTexture\";\r\nimport { Texture } from \"../../Materials/Textures/texture\";\r\nimport { Constants } from \"../../Engines/constants\";\r\nimport { CubeMapToSphericalPolynomialTools } from \"../../Misc/HighDynamicRange/cubemapToSphericalPolynomial\";\r\nimport { Observable } from \"../../Misc/observable\";\r\nimport { Tools } from \"../../Misc/tools\";\r\nimport { ToGammaSpace } from \"../../Maths/math.constants\";\r\nimport type { AbstractEngine } from \"../../Engines/abstractEngine\";\r\nimport { HDRFiltering } from \"../../Materials/Textures/Filtering/hdrFiltering\";\r\nimport { HDRIrradianceFiltering } from \"../../Materials/Textures/Filtering/hdrIrradianceFiltering\";\r\nimport { ToHalfFloat } from \"../../Misc/textureTools\";\r\nimport \"../../Materials/Textures/baseTexture.polynomial\";\r\nimport type { CubeMapInfo } from \"../../Misc/HighDynamicRange/panoramaToCubemap\";\r\n\r\n/**\r\n * This represents an environment base texture which could for instance be from HDR or EXR files.\r\n */\r\nexport abstract class EnvCubeTexture extends BaseTexture {\r\n    private static _FacesMapping = [\"right\", \"left\", \"up\", \"down\", \"front\", \"back\"];\r\n\r\n    protected _generateHarmonics = true;\r\n    protected _noMipmap: boolean;\r\n    protected _size: number;\r\n\r\n    private _prefilterOnLoad: boolean;\r\n    private _prefilterIrradianceOnLoad: boolean;\r\n    private _prefilterUsingCdf: boolean;\r\n    private _textureMatrix: Matrix;\r\n    private _supersample: boolean;\r\n    private _onLoad: () => void;\r\n    private _onError: Nullable<() => void> = null;\r\n\r\n    /**\r\n     * The texture URL.\r\n     */\r\n    public url: string;\r\n\r\n    protected _isBlocking: boolean = true;\r\n    /**\r\n     * Sets whether or not the texture is blocking during loading.\r\n     */\r\n    public override set isBlocking(value: boolean) {\r\n        this._isBlocking = value;\r\n    }\r\n    /**\r\n     * Gets whether or not the texture is blocking during loading.\r\n     */\r\n    public override get isBlocking(): boolean {\r\n        return this._isBlocking;\r\n    }\r\n\r\n    protected _rotationY: number = 0;\r\n    /**\r\n     * Sets texture matrix rotation angle around Y axis in radians.\r\n     */\r\n    public set rotationY(value: number) {\r\n        this._rotationY = value;\r\n        this.setReflectionTextureMatrix(Matrix.RotationY(this._rotationY));\r\n    }\r\n    /**\r\n     * Gets texture matrix rotation angle around Y axis radians.\r\n     */\r\n    public get rotationY(): number {\r\n        return this._rotationY;\r\n    }\r\n\r\n    /**\r\n     * Gets or sets the center of the bounding box associated with the cube texture\r\n     * It must define where the camera used to render the texture was set\r\n     */\r\n    public boundingBoxPosition = Vector3.Zero();\r\n\r\n    private _boundingBoxSize: Vector3;\r\n\r\n    /**\r\n     * Gets or sets the size of the bounding box associated with the cube texture\r\n     * When defined, the cubemap will switch to local mode\r\n     * @see https://community.arm.com/graphics/b/blog/posts/reflections-based-on-local-cubemaps-in-unity\r\n     * @example https://www.babylonjs-playground.com/#RNASML\r\n     */\r\n    public set boundingBoxSize(value: Vector3) {\r\n        if (this._boundingBoxSize && this._boundingBoxSize.equals(value)) {\r\n            return;\r\n        }\r\n        this._boundingBoxSize = value;\r\n        const scene = this.getScene();\r\n        if (scene) {\r\n            scene.markAllMaterialsAsDirty(Constants.MATERIAL_TextureDirtyFlag);\r\n        }\r\n    }\r\n    public get boundingBoxSize(): Vector3 {\r\n        return this._boundingBoxSize;\r\n    }\r\n\r\n    /**\r\n     * Observable triggered once the texture has been loaded.\r\n     */\r\n    public onLoadObservable: Observable<EnvCubeTexture> = new Observable<EnvCubeTexture>();\r\n\r\n    /**\r\n     * Instantiates an EnvCubeTexture from the following parameters.\r\n     *\r\n     * @param url The location of the raw data (Panorama stored in RGBE format)\r\n     * @param sceneOrEngine The scene or engine the texture will be used in\r\n     * @param size The cubemap desired size (the more it increases the longer the generation will be)\r\n     * @param noMipmap Forces to not generate the mipmap if true\r\n     * @param generateHarmonics Specifies whether you want to extract the polynomial harmonics during the generation process\r\n     * @param gammaSpace Specifies if the texture will be use in gamma or linear space (the PBR material requires those texture in linear space, but the standard material would require them in Gamma space)\r\n     * @param prefilterOnLoad Prefilters texture to allow use of this texture as a PBR reflection texture.\r\n     * @param onLoad on success callback function\r\n     * @param onError on error callback function\r\n     * @param supersample Defines if texture must be supersampled (default: false)\r\n     * @param prefilterIrradianceOnLoad Prefilters texture to allow use of this texture for irradiance lighting.\r\n     * @param prefilterUsingCdf Defines if the prefiltering should be done using a CDF instead of the default approach.\r\n     */\r\n    constructor(\r\n        url: string,\r\n        sceneOrEngine: Scene | AbstractEngine,\r\n        size: number,\r\n        noMipmap = false,\r\n        generateHarmonics = true,\r\n        gammaSpace = false,\r\n        prefilterOnLoad = false,\r\n        onLoad: Nullable<() => void> = null,\r\n        onError: Nullable<(message?: string, exception?: any) => void> = null,\r\n        supersample = false,\r\n        prefilterIrradianceOnLoad = false,\r\n        prefilterUsingCdf = false\r\n    ) {\r\n        super(sceneOrEngine);\r\n\r\n        if (!url) {\r\n            return;\r\n        }\r\n\r\n        this._coordinatesMode = Texture.CUBIC_MODE;\r\n        this.name = url;\r\n        this.url = url;\r\n        this.hasAlpha = false;\r\n        this.isCube = true;\r\n        this._textureMatrix = Matrix.Identity();\r\n        this._prefilterOnLoad = prefilterOnLoad;\r\n        this._prefilterIrradianceOnLoad = prefilterIrradianceOnLoad;\r\n        this._prefilterUsingCdf = prefilterUsingCdf;\r\n        this._onLoad = () => {\r\n            this.onLoadObservable.notifyObservers(this);\r\n            if (onLoad) {\r\n                onLoad();\r\n            }\r\n        };\r\n\r\n        this._onError = onError;\r\n        this.gammaSpace = gammaSpace;\r\n\r\n        this._noMipmap = noMipmap;\r\n        this._size = size;\r\n        // CDF is very sensitive to lost precision due to downsampling. This can result in\r\n        // noticeable brightness differences with different resolutions. Enabling supersampling\r\n        // mitigates this.\r\n        this._supersample = supersample || prefilterUsingCdf;\r\n        this._generateHarmonics = generateHarmonics;\r\n\r\n        this._texture = this._getFromCache(url, this._noMipmap, undefined, undefined, undefined, this.isCube);\r\n\r\n        if (!this._texture) {\r\n            if (!this.getScene()?.useDelayedTextureLoading) {\r\n                this._loadTexture();\r\n            } else {\r\n                this.delayLoadState = Constants.DELAYLOADSTATE_NOTLOADED;\r\n            }\r\n        } else {\r\n            if (this._texture.isReady) {\r\n                Tools.SetImmediate(() => this._onLoad());\r\n            } else {\r\n                this._texture.onLoadedObservable.add(this._onLoad);\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get the current class name of the texture useful for serialization or dynamic coding.\r\n     * @returns \"EnvCubeTexture\"\r\n     */\r\n    public override getClassName(): string {\r\n        return \"EnvCubeTexture\";\r\n    }\r\n\r\n    /**\r\n     * Convert the raw data from the server into cubemap faces\r\n     * @param buffer The buffer containing the texture data\r\n     * @param size The cubemap face size\r\n     * @param supersample Defines if texture must be supersampled\r\n     * @returns The cube map data\r\n     */\r\n    protected abstract _getCubeMapTextureDataAsync(buffer: ArrayBuffer, size: number, supersample: boolean): Promise<CubeMapInfo>;\r\n\r\n    /**\r\n     * Occurs when the file has been loaded.\r\n     */\r\n    private _loadTexture() {\r\n        const engine = this._getEngine()!;\r\n        const caps = engine.getCaps();\r\n\r\n        let textureType = Constants.TEXTURETYPE_UNSIGNED_BYTE;\r\n        if (caps.textureFloat && caps.textureFloatLinearFiltering) {\r\n            textureType = Constants.TEXTURETYPE_FLOAT;\r\n        } else if (caps.textureHalfFloat && caps.textureHalfFloatLinearFiltering) {\r\n            textureType = Constants.TEXTURETYPE_HALF_FLOAT;\r\n        }\r\n\r\n        // eslint-disable-next-line no-restricted-syntax\r\n        const callback = async (buffer: ArrayBuffer): Promise<ArrayBufferView<ArrayBufferLike>[]> => {\r\n            this.lodGenerationOffset = 0.0;\r\n            this.lodGenerationScale = 0.8;\r\n\r\n            // Extract the raw linear data.\r\n            const data = await this._getCubeMapTextureDataAsync(buffer, this._size, this._supersample);\r\n\r\n            // Generate harmonics if needed.\r\n            if (this._generateHarmonics) {\r\n                const sphericalPolynomial = CubeMapToSphericalPolynomialTools.ConvertCubeMapToSphericalPolynomial(data);\r\n                this.sphericalPolynomial = sphericalPolynomial;\r\n            }\r\n\r\n            const results = [];\r\n\r\n            let byteArray: Nullable<Uint8Array> = null;\r\n            let shortArray: Nullable<Uint16Array> = null;\r\n\r\n            // Push each faces.\r\n            for (let j = 0; j < 6; j++) {\r\n                // Create fallback array\r\n                if (textureType === Constants.TEXTURETYPE_HALF_FLOAT) {\r\n                    shortArray = new Uint16Array(this._size * this._size * 3);\r\n                } else if (textureType === Constants.TEXTURETYPE_UNSIGNED_BYTE) {\r\n                    // 3 channels of 1 bytes per pixel in bytes.\r\n                    byteArray = new Uint8Array(this._size * this._size * 3);\r\n                }\r\n\r\n                const dataFace = <Float32Array>(<any>data)[EnvCubeTexture._FacesMapping[j]];\r\n\r\n                // If special cases.\r\n                if (this.gammaSpace || shortArray || byteArray) {\r\n                    for (let i = 0; i < this._size * this._size; i++) {\r\n                        // Put in gamma space if requested.\r\n                        if (this.gammaSpace) {\r\n                            dataFace[i * 3 + 0] = Math.pow(dataFace[i * 3 + 0], ToGammaSpace);\r\n                            dataFace[i * 3 + 1] = Math.pow(dataFace[i * 3 + 1], ToGammaSpace);\r\n                            dataFace[i * 3 + 2] = Math.pow(dataFace[i * 3 + 2], ToGammaSpace);\r\n                        }\r\n\r\n                        // Convert to half float texture for fallback.\r\n                        if (shortArray) {\r\n                            shortArray[i * 3 + 0] = ToHalfFloat(dataFace[i * 3 + 0]);\r\n                            shortArray[i * 3 + 1] = ToHalfFloat(dataFace[i * 3 + 1]);\r\n                            shortArray[i * 3 + 2] = ToHalfFloat(dataFace[i * 3 + 2]);\r\n                        }\r\n\r\n                        // Convert to int texture for fallback.\r\n                        if (byteArray) {\r\n                            let r = Math.max(dataFace[i * 3 + 0] * 255, 0);\r\n                            let g = Math.max(dataFace[i * 3 + 1] * 255, 0);\r\n                            let b = Math.max(dataFace[i * 3 + 2] * 255, 0);\r\n\r\n                            // May use luminance instead if the result is not accurate.\r\n                            const max = Math.max(Math.max(r, g), b);\r\n                            if (max > 255) {\r\n                                const scale = 255 / max;\r\n                                r *= scale;\r\n                                g *= scale;\r\n                                b *= scale;\r\n                            }\r\n\r\n                            byteArray[i * 3 + 0] = r;\r\n                            byteArray[i * 3 + 1] = g;\r\n                            byteArray[i * 3 + 2] = b;\r\n                        }\r\n                    }\r\n                }\r\n\r\n                if (shortArray) {\r\n                    results.push(shortArray);\r\n                } else if (byteArray) {\r\n                    results.push(byteArray);\r\n                } else {\r\n                    results.push(dataFace);\r\n                }\r\n            }\r\n\r\n            return results;\r\n        };\r\n\r\n        if (engine._features.allowTexturePrefiltering && (this._prefilterOnLoad || this._prefilterIrradianceOnLoad)) {\r\n            const previousOnLoad = this._onLoad;\r\n            const hdrFiltering = new HDRFiltering(engine);\r\n            this._onLoad = () => {\r\n                let irradiancePromise: Promise<Nullable<BaseTexture>> = Promise.resolve(null);\r\n                let radiancePromise: Promise<void> = Promise.resolve();\r\n                if (this._prefilterIrradianceOnLoad) {\r\n                    const hdrIrradianceFiltering = new HDRIrradianceFiltering(engine, { useCdf: this._prefilterUsingCdf });\r\n                    irradiancePromise = hdrIrradianceFiltering.prefilter(this);\r\n                }\r\n                if (this._prefilterOnLoad) {\r\n                    radiancePromise = hdrFiltering.prefilter(this);\r\n                }\r\n                // eslint-disable-next-line @typescript-eslint/no-floating-promises, github/no-then\r\n                Promise.all([irradiancePromise, radiancePromise]).then((results) => {\r\n                    const irradianceTexture = results[0];\r\n                    if (this._prefilterIrradianceOnLoad && irradianceTexture) {\r\n                        this.irradianceTexture = irradianceTexture;\r\n                        const scene = this.getScene();\r\n                        if (scene) {\r\n                            scene.markAllMaterialsAsDirty(Constants.MATERIAL_TextureDirtyFlag);\r\n                        }\r\n                    }\r\n                    if (previousOnLoad) {\r\n                        previousOnLoad();\r\n                    }\r\n                });\r\n            };\r\n        }\r\n\r\n        this._texture = engine.createRawCubeTextureFromUrl(\r\n            this.url,\r\n            this.getScene(),\r\n            this._size,\r\n            Constants.TEXTUREFORMAT_RGB,\r\n            textureType,\r\n            this._noMipmap,\r\n            callback,\r\n            null,\r\n            this._onLoad,\r\n            this._onError\r\n        );\r\n    }\r\n\r\n    // Methods\r\n    public override delayLoad(): void {\r\n        if (this.delayLoadState !== Constants.DELAYLOADSTATE_NOTLOADED) {\r\n            return;\r\n        }\r\n\r\n        this.delayLoadState = Constants.DELAYLOADSTATE_LOADED;\r\n        this._texture = this._getFromCache(this.url, this._noMipmap);\r\n\r\n        if (!this._texture) {\r\n            this._loadTexture();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get the texture reflection matrix used to rotate/transform the reflection.\r\n     * @returns the reflection matrix\r\n     */\r\n    public override getReflectionTextureMatrix(): Matrix {\r\n        return this._textureMatrix;\r\n    }\r\n\r\n    /**\r\n     * Set the texture reflection matrix used to rotate/transform the reflection.\r\n     * @param value Define the reflection matrix to set\r\n     */\r\n    public setReflectionTextureMatrix(value: Matrix): void {\r\n        this._textureMatrix = value;\r\n\r\n        if (value.updateFlag === this._textureMatrix.updateFlag) {\r\n            return;\r\n        }\r\n\r\n        if (value.isIdentity() !== this._textureMatrix.isIdentity()) {\r\n            this.getScene()?.markAllMaterialsAsDirty(Constants.MATERIAL_TextureDirtyFlag, (mat) => mat.getActiveTextures().indexOf(this) !== -1);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Dispose the texture and release its associated resources.\r\n     */\r\n    public override dispose(): void {\r\n        this.onLoadObservable.clear();\r\n        super.dispose();\r\n    }\r\n\r\n    /**\r\n     * Serializes the texture to a JSON representation.\r\n     * @returns the JSON representation\r\n     */\r\n    public override serialize(): any {\r\n        if (!this.name) {\r\n            return null;\r\n        }\r\n\r\n        const serializationObject: any = {};\r\n        serializationObject.name = this.name;\r\n        serializationObject.hasAlpha = this.hasAlpha;\r\n        serializationObject.isCube = true;\r\n        serializationObject.level = this.level;\r\n        serializationObject.size = this._size;\r\n        serializationObject.coordinatesMode = this.coordinatesMode;\r\n        serializationObject.useInGammaSpace = this.gammaSpace;\r\n        serializationObject.generateHarmonics = this._generateHarmonics;\r\n        serializationObject.noMipmap = this._noMipmap;\r\n        serializationObject.isBlocking = this._isBlocking;\r\n        serializationObject.rotationY = this._rotationY;\r\n\r\n        return serializationObject;\r\n    }\r\n\r\n    protected abstract _instantiateClone(): this;\r\n\r\n    /**\r\n     * Clones the current texture.\r\n     * @returns the cloned texture\r\n     */\r\n    public override clone(): this {\r\n        const newTexture = this._instantiateClone();\r\n\r\n        // Base Texture\r\n        newTexture.level = this.level;\r\n        newTexture.wrapU = this.wrapU;\r\n        newTexture.wrapV = this.wrapV;\r\n        newTexture.coordinatesIndex = this.coordinatesIndex;\r\n        newTexture.coordinatesMode = this.coordinatesMode;\r\n\r\n        return newTexture;\r\n    }\r\n\r\n    protected static _Parse(parsedTexture: any, texture: EnvCubeTexture): void {\r\n        texture.name = parsedTexture.name;\r\n        texture.hasAlpha = parsedTexture.hasAlpha;\r\n        texture.level = parsedTexture.level;\r\n        texture.coordinatesMode = parsedTexture.coordinatesMode;\r\n        texture.isBlocking = parsedTexture.isBlocking;\r\n        if (parsedTexture.boundingBoxPosition) {\r\n            texture.boundingBoxPosition = Vector3.FromArray(parsedTexture.boundingBoxPosition);\r\n        }\r\n        if (parsedTexture.boundingBoxSize) {\r\n            texture.boundingBoxSize = Vector3.FromArray(parsedTexture.boundingBoxSize);\r\n        }\r\n        if (parsedTexture.rotationY) {\r\n            texture.rotationY = parsedTexture.rotationY;\r\n        }\r\n    }\r\n}\r\n"]}

package/Materials/Textures/exrCubeTexture.d.ts

@@ -0,0 +1,55 @@
+import type { Nullable } from "../../types.js";
+import type { Scene } from "../../scene.js";
+import { EnvCubeTexture } from "./envCubeTexture.js";
+import type { AbstractEngine } from "../../Engines/abstractEngine.js";
+import "../../Materials/Textures/baseTexture.polynomial.js";
+import type { CubeMapInfo } from "../../Misc/HighDynamicRange/panoramaToCubemap.js";
+/**
+ * This represents a texture coming from an EXR input.
+ */
+export declare class EXRCubeTexture extends EnvCubeTexture {
+    /**
+     * Instantiates an HDRTexture from the following parameters.
+     *
+     * @param url The location of the HDR raw data (Panorama stored in RGBE format)
+     * @param sceneOrEngine The scene or engine the texture will be used in
+     * @param size The cubemap desired size (the more it increases the longer the generation will be)
+     * @param noMipmap Forces to not generate the mipmap if true
+     * @param generateHarmonics Specifies whether you want to extract the polynomial harmonics during the generation process
+     * @param gammaSpace Specifies if the texture will be use in gamma or linear space (the PBR material requires those texture in linear space, but the standard material would require them in Gamma space)
+     * @param prefilterOnLoad Prefilters HDR texture to allow use of this texture as a PBR reflection texture.
+     * @param onLoad on success callback function
+     * @param onError on error callback function
+     * @param supersample Defines if texture must be supersampled (default: false)
+     * @param prefilterIrradianceOnLoad Prefilters HDR texture to allow use of this texture for irradiance lighting.
+     * @param prefilterUsingCdf Defines if the prefiltering should be done using a CDF instead of the default approach.
+     */
+    constructor(url: string, sceneOrEngine: Scene | AbstractEngine, size: number, noMipmap?: boolean, generateHarmonics?: boolean, gammaSpace?: boolean, prefilterOnLoad?: boolean, onLoad?: Nullable<() => void>, onError?: Nullable<(message?: string, exception?: any) => void>, supersample?: boolean, prefilterIrradianceOnLoad?: boolean, prefilterUsingCdf?: boolean);
+    /**
+     * Get the current class name of the texture useful for serialization or dynamic coding.
+     * @returns "EXRCubeTexture"
+     */
+    getClassName(): string;
+    /**
+     * Convert the raw data from the server into cubemap faces
+     * @param buffer The buffer containing the texture data
+     * @param size The cubemap face size
+     * @param supersample Defines if texture must be supersampled
+     * @returns The cube map data
+     */
+    protected _getCubeMapTextureDataAsync(buffer: ArrayBuffer, size: number, supersample: boolean): Promise<CubeMapInfo>;
+    protected _instantiateClone(): this;
+    /**
+     * Serialize the texture to a JSON representation.
+     * @returns The JSON representation of the texture
+     */
+    serialize(): any;
+    /**
+     * Parses a JSON representation of an EXR Texture in order to create the texture
+     * @param parsedTexture Define the JSON representation
+     * @param scene Define the scene the texture should be created in
+     * @param rootUrl Define the root url in case we need to load relative dependencies
+     * @returns the newly created texture after parsing
+     */
+    static Parse(parsedTexture: any, scene: Scene, rootUrl: string): Nullable<EXRCubeTexture>;
+}