@onerjs/core 8.52.2 → 8.52.4

package/Materials/Textures/pure.d.ts

@@ -23,6 +23,7 @@ export * from "./rawTexture2DArray.js";
 export * from "./rawTexture3D.js";
 export * from "./refractionTexture.js";
 export * from "./renderTargetTexture.pure.js";
+export * from "./reflectionProbeTexture.pure.js";
 export * from "./textureMerger.js";
 export * from "./textureSampler.js";
 export * from "./textureProcessor.js";

package/Materials/Textures/pure.js

@@ -24,6 +24,7 @@ export * from "./rawTexture2DArray.js";
 export * from "./rawTexture3D.js";
 export * from "./refractionTexture.js";
 export * from "./renderTargetTexture.pure.js";
+export * from "./reflectionProbeTexture.pure.js";
 export * from "./textureMerger.js";
 export * from "./textureSampler.js";
 export * from "./textureProcessor.js";

package/Materials/Textures/pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"pure.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,6DAA6D;AAC7D,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC","sourcesContent":["/** Pure barrel — re-exports only side-effect-free modules */\n/* eslint-disable @typescript-eslint/no-restricted-imports */\nexport * from \"./baseTexture.pure\";\nexport * from \"./baseTexture.polynomial.pure\";\nexport * from \"./colorGradingTexture.pure\";\nexport * from \"./cubeTexture.pure\";\nexport * from \"./dynamicTexture.pure\";\nexport * from \"./equiRectangularCubeTexture.pure\";\nexport * from \"./externalTexture\";\nexport * from \"./Filtering/hdrFiltering\";\nexport * from \"./envCubeTexture.pure\";\nexport * from \"./hdrCubeTexture.pure\";\nexport * from \"./exrCubeTexture.pure\";\nexport * from \"./htmlElementTexture.pure\";\nexport * from \"./internalTexture\";\nexport * from \"./Loaders/pure\";\nexport * from \"./mirrorTexture.pure\";\nexport * from \"./multiRenderTarget.pure\";\nexport * from \"./Packer/pure\";\nexport * from \"./Procedurals/pure\";\nexport * from \"./rawCubeTexture\";\nexport * from \"./rawTexture\";\nexport * from \"./rawTexture2DArray\";\nexport * from \"./rawTexture3D\";\nexport * from \"./refractionTexture\";\nexport * from \"./renderTargetTexture.pure\";\nexport * from \"./textureMerger\";\nexport * from \"./textureSampler\";\nexport * from \"./textureProcessor\";\nexport * from \"./texture.pure\";\nexport * from \"./thinTexture\";\nexport * from \"./thinRenderTargetTexture\";\nexport * from \"./videoTexture.pure\";\nexport * from \"./ktx2decoderTypes\";\nexport * from \"./textureCreationOptions\";\n"]}
+{"version":3,"file":"pure.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,6DAA6D;AAC7D,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC","sourcesContent":["/** Pure barrel — re-exports only side-effect-free modules */\n/* eslint-disable @typescript-eslint/no-restricted-imports */\nexport * from \"./baseTexture.pure\";\nexport * from \"./baseTexture.polynomial.pure\";\nexport * from \"./colorGradingTexture.pure\";\nexport * from \"./cubeTexture.pure\";\nexport * from \"./dynamicTexture.pure\";\nexport * from \"./equiRectangularCubeTexture.pure\";\nexport * from \"./externalTexture\";\nexport * from \"./Filtering/hdrFiltering\";\nexport * from \"./envCubeTexture.pure\";\nexport * from \"./hdrCubeTexture.pure\";\nexport * from \"./exrCubeTexture.pure\";\nexport * from \"./htmlElementTexture.pure\";\nexport * from \"./internalTexture\";\nexport * from \"./Loaders/pure\";\nexport * from \"./mirrorTexture.pure\";\nexport * from \"./multiRenderTarget.pure\";\nexport * from \"./Packer/pure\";\nexport * from \"./Procedurals/pure\";\nexport * from \"./rawCubeTexture\";\nexport * from \"./rawTexture\";\nexport * from \"./rawTexture2DArray\";\nexport * from \"./rawTexture3D\";\nexport * from \"./refractionTexture\";\nexport * from \"./renderTargetTexture.pure\";\nexport * from \"./reflectionProbeTexture.pure\";\nexport * from \"./textureMerger\";\nexport * from \"./textureSampler\";\nexport * from \"./textureProcessor\";\nexport * from \"./texture.pure\";\nexport * from \"./thinTexture\";\nexport * from \"./thinRenderTargetTexture\";\nexport * from \"./videoTexture.pure\";\nexport * from \"./ktx2decoderTypes\";\nexport * from \"./textureCreationOptions\";\n"]}

package/Materials/Textures/reflectionProbeTexture.d.ts

@@ -1,86 +1 @@
-import type { Scene } from "../../scene.js";
-import type { AbstractMesh } from "../../Meshes/abstractMesh.js";
-import type { Nullable } from "../../types.js";
-import { Vector3 } from "../../Maths/math.vector.js";
-import type { IAssetContainer } from "../../IAssetContainer.js";
-import { RenderTargetTexture } from "../../Materials/Textures/renderTargetTexture.js";
-/**
- * Options for creating a ReflectionProbeTexture
- */
-export interface IReflectionProbeTextureOptions {
-    /**
-     * The texture resolution (for each face)
-     */
-    size: number;
-    /**
-     * Defines if mip maps should be generated automatically (true by default)
-     */
-    generateMipMaps?: boolean;
-    /**
-     * Defines if HDR data (float data) should be used to store colors (false by default)
-     */
-    useFloat?: boolean;
-    /**
-     * Defines if the probe should be generated in linear space or not (false by default)
-     */
-    linearSpace?: boolean;
-}
-/**
- * Class used to generate realtime reflection / refraction cube textures.
- * This is a simplified version of ReflectionProbe that can be used directly as a RenderTargetTexture.
- * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/reflectionProbes
- */
-export declare class ReflectionProbeTexture extends RenderTargetTexture {
-    private _projectionMatrix;
-    private _viewMatrix;
-    private _target;
-    private _add;
-    private _sceneUBOs;
-    private _currentSceneUBO;
-    private _invertYAxis;
-    private _options;
-    private _attachedMesh;
-    /** Gets or sets probe position (center of the cube map) */
-    position: Vector3;
-    /** @internal */
-    _parentContainer: Nullable<IAssetContainer>;
-    /**
-     * Creates a new reflection probe texture
-     * @param name defines the name of the probe
-     * @param options defines the options for creating the texture
-     * @param scene defines the hosting scene
-     */
-    constructor(
-    /** defines the name of the probe */
-    name: string, options: number | IReflectionProbeTextureOptions, scene: Scene);
-    /**
-     * Attach the probe to a specific mesh (Rendering will be done from attached mesh's position)
-     * @param mesh defines the mesh to attach to
-     */
-    attachToMesh(mesh: Nullable<AbstractMesh>): void;
-    /**
-     * Gets the mesh attached to this probe
-     * @returns the attached mesh or null
-     */
-    get attachedMesh(): Nullable<AbstractMesh>;
-    /**
-     * Gets the class name of the reflection probe texture
-     * @returns "ReflectionProbeTexture"
-     */
-    getClassName(): string;
-    /**
-     * Converts the reflection probe texture information to a readable string for debug purpose
-     * @param fullDetails Supports for multiple levels of logging within scene loading
-     * @returns the human readable reflection probe texture info
-     */
-    toString(fullDetails?: boolean): string;
-    /**
-     * Used for serializing the probe texture
-     * @returns any
-     */
-    serialize(): any;
-    /**
-     * Clean all associated resources
-     */
-    dispose(): void;
-}
+export * from "./reflectionProbeTexture.pure.js";

package/Materials/Textures/reflectionProbeTexture.js

@@ -1,197 +1,4 @@
-import { Vector3 } from "../../Maths/math.vector.js";
-import { Matrix } from "../../Maths/math.vector.js";
-import { RenderTargetTexture } from "../../Materials/Textures/renderTargetTexture.js";
-
-import { Texture } from "../../Materials/Textures/texture.js";
-/**
- * Class used to generate realtime reflection / refraction cube textures.
- * This is a simplified version of ReflectionProbe that can be used directly as a RenderTargetTexture.
- * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/reflectionProbes
- */
-export class ReflectionProbeTexture extends RenderTargetTexture {
-    /**
-     * Creates a new reflection probe texture
-     * @param name defines the name of the probe
-     * @param options defines the options for creating the texture
-     * @param scene defines the hosting scene
-     */
-    constructor(
-    /** defines the name of the probe */
-    name, options, scene) {
-        const size = typeof options === "number" ? options : options.size;
-        const generateMipMaps = typeof options === "number" ? true : (options.generateMipMaps ?? true);
-        const useFloat = typeof options === "number" ? false : (options.useFloat ?? false);
-        const linearSpace = typeof options === "number" ? false : (options.linearSpace ?? false);
-        let textureType = 0;
-        if (useFloat) {
-            const caps = scene.getEngine().getCaps();
-            if (caps.textureHalfFloatRender) {
-                textureType = 2;
-            }
-            else if (caps.textureFloatRender) {
-                textureType = 1;
-            }
-        }
-        super(name, size, scene, generateMipMaps, true, textureType, true, undefined, undefined, undefined, undefined, undefined, linearSpace);
-        this._viewMatrix = Matrix.Identity();
-        this._target = Vector3.Zero();
-        this._add = Vector3.Zero();
-        this._invertYAxis = false;
-        /** Gets or sets probe position (center of the cube map) */
-        this.position = Vector3.Zero();
-        /** @internal */
-        this._parentContainer = null;
-        this._options = options;
-        if (scene.getEngine().supportsUniformBuffers) {
-            this._sceneUBOs = [];
-            for (let i = 0; i < 6; ++i) {
-                this._sceneUBOs.push(scene.createSceneUniformBuffer(`Scene for Reflection Probe (name "${name}") face #${i}`, { forceMono: true }));
-            }
-        }
-        this.gammaSpace = !linearSpace;
-        this.invertZ = scene.useRightHandedSystem;
-        const useReverseDepthBuffer = scene.getEngine().useReverseDepthBuffer;
-        this.onBeforeRenderObservable.add((faceIndex) => {
-            if (this._sceneUBOs) {
-                scene.setSceneUniformBuffer(this._sceneUBOs[faceIndex]);
-                scene.getSceneUniformBuffer().unbindEffect();
-            }
-            switch (faceIndex) {
-                case 0:
-                    this._add.copyFromFloats(1, 0, 0);
-                    break;
-                case 1:
-                    this._add.copyFromFloats(-1, 0, 0);
-                    break;
-                case 2:
-                    this._add.copyFromFloats(0, this._invertYAxis ? 1 : -1, 0);
-                    break;
-                case 3:
-                    this._add.copyFromFloats(0, this._invertYAxis ? -1 : 1, 0);
-                    break;
-                case 4:
-                    this._add.copyFromFloats(0, 0, scene.useRightHandedSystem ? -1 : 1);
-                    break;
-                case 5:
-                    this._add.copyFromFloats(0, 0, scene.useRightHandedSystem ? 1 : -1);
-                    break;
-            }
-            if (this._attachedMesh) {
-                this.position.copyFrom(this._attachedMesh.getAbsolutePosition());
-            }
-            this.position.addToRef(this._add, this._target);
-            const lookAtFunction = scene.useRightHandedSystem ? Matrix.LookAtRHToRef : Matrix.LookAtLHToRef;
-            const perspectiveFunction = scene.useRightHandedSystem ? Matrix.PerspectiveFovRH : Matrix.PerspectiveFovLH;
-            lookAtFunction(this.position, this._target, Vector3.Up(), this._viewMatrix);
-            if (scene.activeCamera) {
-                this._projectionMatrix = perspectiveFunction(Math.PI / 2, 1, useReverseDepthBuffer ? scene.activeCamera.maxZ : scene.activeCamera.minZ, useReverseDepthBuffer ? scene.activeCamera.minZ : scene.activeCamera.maxZ, this._getEngine().isNDCHalfZRange);
-                scene.setTransformMatrix(this._viewMatrix, this._projectionMatrix);
-                if (scene.activeCamera.isRigCamera && !this.activeCamera) {
-                    this.activeCamera = scene.activeCamera.rigParent || null;
-                }
-            }
-            if (this._sceneUBOs) {
-                scene.finalizeSceneUbo();
-            }
-            scene._forcedViewPosition = this.position;
-        });
-        let currentApplyByPostProcess;
-        this.onBeforeBindObservable.add(() => {
-            const engine = scene.getEngine();
-            this._currentSceneUBO = scene.getSceneUniformBuffer();
-            if (engine._enableGPUDebugMarkers) {
-                engine._debugPushGroup?.(`reflection probe generation for ${name}`);
-            }
-            currentApplyByPostProcess = scene.imageProcessingConfiguration.applyByPostProcess;
-            if (linearSpace) {
-                scene.imageProcessingConfiguration.applyByPostProcess = true;
-            }
-        });
-        this.onAfterUnbindObservable.add(() => {
-            const engine = scene.getEngine();
-            scene.imageProcessingConfiguration.applyByPostProcess = currentApplyByPostProcess;
-            scene._forcedViewPosition = null;
-            if (this._sceneUBOs) {
-                scene.setSceneUniformBuffer(this._currentSceneUBO);
-            }
-            scene.updateTransformMatrix(true);
-            if (engine._enableGPUDebugMarkers) {
-                engine._debugPopGroup?.();
-            }
-        });
-    }
-    /**
-     * Attach the probe to a specific mesh (Rendering will be done from attached mesh's position)
-     * @param mesh defines the mesh to attach to
-     */
-    attachToMesh(mesh) {
-        this._attachedMesh = mesh;
-    }
-    /**
-     * Gets the mesh attached to this probe
-     * @returns the attached mesh or null
-     */
-    get attachedMesh() {
-        return this._attachedMesh;
-    }
-    /**
-     * Gets the class name of the reflection probe texture
-     * @returns "ReflectionProbeTexture"
-     */
-    getClassName() {
-        return "ReflectionProbeTexture";
-    }
-    /**
-     * Converts the reflection probe texture information to a readable string for debug purpose
-     * @param fullDetails Supports for multiple levels of logging within scene loading
-     * @returns the human readable reflection probe texture info
-     */
-    toString(fullDetails) {
-        let ret = "Name: " + this.name;
-        if (fullDetails) {
-            ret += ", position: " + this.position.toString();
-            if (this._attachedMesh) {
-                ret += ", attached mesh: " + this._attachedMesh.name;
-            }
-        }
-        return ret;
-    }
-    /**
-     * Used for serializing the probe texture
-     * @returns any
-     */
-    serialize() {
-        const serializationObject = super.serialize();
-        if (serializationObject) {
-            serializationObject.isReflectionProbe = true;
-            if (this._attachedMesh) {
-                serializationObject.attachedMesh = this._attachedMesh.id;
-            }
-            serializationObject.position = this.position.asArray();
-            serializationObject.options = structuredClone(this._options);
-            return serializationObject;
-        }
-        return null;
-    }
-    /**
-     * Clean all associated resources
-     */
-    dispose() {
-        if (this._sceneUBOs) {
-            for (const ubo of this._sceneUBOs) {
-                ubo.dispose();
-            }
-            this._sceneUBOs = [];
-        }
-        super.dispose();
-    }
-}
-Texture._CreateReflectionProbeTexture = function (name, options, scene, position, attachedMesh) {
-    const texture = new ReflectionProbeTexture(name, options, scene);
-    texture.position.fromArray(position);
-    if (attachedMesh) {
-        texture.attachToMesh(scene.getMeshById(attachedMesh) ?? null);
-    }
-    return texture;
-};
+import { RegisterReflectionProbeTexture } from "./reflectionProbeTexture.pure.js";
+export * from "./reflectionProbeTexture.pure.js";
+RegisterReflectionProbeTexture();
 //# sourceMappingURL=reflectionProbeTexture.js.map

package/Materials/Textures/reflectionProbeTexture.js.map

@@ -1 +1 @@
-{"version":3,"file":"reflectionProbeTexture.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/reflectionProbeTexture.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Scene } from \"../../scene\";\nimport type { AbstractMesh } from \"../../Meshes/abstractMesh\";\nimport type { Nullable } from \"../../types\";\nimport { Vector3 } from \"../../Maths/math.vector\";\nimport { Matrix } from \"../../Maths/math.vector\";\nimport type { UniformBuffer } from \"../../Materials/uniformBuffer\";\nimport type { IAssetContainer } from \"core/IAssetContainer\";\nimport { RenderTargetTexture } from \"../../Materials/Textures/renderTargetTexture\";\nimport { Constants } from \"../../Engines/constants\";\nimport { Texture } from \"../../Materials/Textures/texture\";\n\n/**\n * Options for creating a ReflectionProbeTexture\n */\nexport interface IReflectionProbeTextureOptions {\n    /**\n     * The texture resolution (for each face)\n     */\n    size: number;\n    /**\n     * Defines if mip maps should be generated automatically (true by default)\n     */\n    generateMipMaps?: boolean;\n    /**\n     * Defines if HDR data (float data) should be used to store colors (false by default)\n     */\n    useFloat?: boolean;\n    /**\n     * Defines if the probe should be generated in linear space or not (false by default)\n     */\n    linearSpace?: boolean;\n}\n\n/**\n * Class used to generate realtime reflection / refraction cube textures.\n * This is a simplified version of ReflectionProbe that can be used directly as a RenderTargetTexture.\n * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/reflectionProbes\n */\nexport class ReflectionProbeTexture extends RenderTargetTexture {\n    private _projectionMatrix: Matrix;\n    private _viewMatrix = Matrix.Identity();\n    private _target = Vector3.Zero();\n    private _add = Vector3.Zero();\n    private _sceneUBOs: UniformBuffer[];\n    private _currentSceneUBO: UniformBuffer;\n    private _invertYAxis = false;\n    private _options: number | IReflectionProbeTextureOptions;\n    private _attachedMesh: Nullable<AbstractMesh>;\n\n    /** Gets or sets probe position (center of the cube map) */\n    public position = Vector3.Zero();\n\n    /** @internal */\n    public override _parentContainer: Nullable<IAssetContainer> = null;\n\n    /**\n     * Creates a new reflection probe texture\n     * @param name defines the name of the probe\n     * @param options defines the options for creating the texture\n     * @param scene defines the hosting scene\n     */\n    constructor(\n        /** defines the name of the probe */\n        name: string,\n        options: number | IReflectionProbeTextureOptions,\n        scene: Scene\n    ) {\n        const size = typeof options === \"number\" ? options : options.size;\n        const generateMipMaps = typeof options === \"number\" ? true : (options.generateMipMaps ?? true);\n        const useFloat = typeof options === \"number\" ? false : (options.useFloat ?? false);\n        const linearSpace = typeof options === \"number\" ? false : (options.linearSpace ?? false);\n\n        let textureType = Constants.TEXTURETYPE_UNSIGNED_BYTE;\n        if (useFloat) {\n            const caps = scene.getEngine().getCaps();\n            if (caps.textureHalfFloatRender) {\n                textureType = Constants.TEXTURETYPE_HALF_FLOAT;\n            } else if (caps.textureFloatRender) {\n                textureType = Constants.TEXTURETYPE_FLOAT;\n            }\n        }\n\n        super(name, size, scene, generateMipMaps, true, textureType, true, undefined, undefined, undefined, undefined, undefined, linearSpace);\n        this._options = options;\n\n        if (scene.getEngine().supportsUniformBuffers) {\n            this._sceneUBOs = [];\n            for (let i = 0; i < 6; ++i) {\n                this._sceneUBOs.push(scene.createSceneUniformBuffer(`Scene for Reflection Probe (name \"${name}\") face #${i}`, { forceMono: true }));\n            }\n        }\n\n        this.gammaSpace = !linearSpace;\n        this.invertZ = scene.useRightHandedSystem;\n\n        const useReverseDepthBuffer = scene.getEngine().useReverseDepthBuffer;\n\n        this.onBeforeRenderObservable.add((faceIndex: number) => {\n            if (this._sceneUBOs) {\n                scene.setSceneUniformBuffer(this._sceneUBOs[faceIndex]);\n                scene.getSceneUniformBuffer().unbindEffect();\n            }\n            switch (faceIndex) {\n                case 0:\n                    this._add.copyFromFloats(1, 0, 0);\n                    break;\n                case 1:\n                    this._add.copyFromFloats(-1, 0, 0);\n                    break;\n                case 2:\n                    this._add.copyFromFloats(0, this._invertYAxis ? 1 : -1, 0);\n                    break;\n                case 3:\n                    this._add.copyFromFloats(0, this._invertYAxis ? -1 : 1, 0);\n                    break;\n                case 4:\n                    this._add.copyFromFloats(0, 0, scene.useRightHandedSystem ? -1 : 1);\n                    break;\n                case 5:\n                    this._add.copyFromFloats(0, 0, scene.useRightHandedSystem ? 1 : -1);\n                    break;\n            }\n\n            if (this._attachedMesh) {\n                this.position.copyFrom(this._attachedMesh.getAbsolutePosition());\n            }\n\n            this.position.addToRef(this._add, this._target);\n\n            const lookAtFunction = scene.useRightHandedSystem ? Matrix.LookAtRHToRef : Matrix.LookAtLHToRef;\n            const perspectiveFunction = scene.useRightHandedSystem ? Matrix.PerspectiveFovRH : Matrix.PerspectiveFovLH;\n\n            lookAtFunction(this.position, this._target, Vector3.Up(), this._viewMatrix);\n\n            if (scene.activeCamera) {\n                this._projectionMatrix = perspectiveFunction(\n                    Math.PI / 2,\n                    1,\n                    useReverseDepthBuffer ? scene.activeCamera.maxZ : scene.activeCamera.minZ,\n                    useReverseDepthBuffer ? scene.activeCamera.minZ : scene.activeCamera.maxZ,\n                    this._getEngine()!.isNDCHalfZRange\n                );\n                scene.setTransformMatrix(this._viewMatrix, this._projectionMatrix);\n                if (scene.activeCamera.isRigCamera && !this.activeCamera) {\n                    this.activeCamera = scene.activeCamera.rigParent || null;\n                }\n            }\n            if (this._sceneUBOs) {\n                scene.finalizeSceneUbo();\n            }\n            scene._forcedViewPosition = this.position;\n        });\n\n        let currentApplyByPostProcess: boolean;\n\n        this.onBeforeBindObservable.add(() => {\n            const engine = scene.getEngine();\n            this._currentSceneUBO = scene.getSceneUniformBuffer();\n            if (engine._enableGPUDebugMarkers) {\n                engine._debugPushGroup?.(`reflection probe generation for ${name}`);\n            }\n            currentApplyByPostProcess = scene.imageProcessingConfiguration.applyByPostProcess;\n            if (linearSpace) {\n                scene.imageProcessingConfiguration.applyByPostProcess = true;\n            }\n        });\n\n        this.onAfterUnbindObservable.add(() => {\n            const engine = scene.getEngine();\n            scene.imageProcessingConfiguration.applyByPostProcess = currentApplyByPostProcess;\n            scene._forcedViewPosition = null;\n            if (this._sceneUBOs) {\n                scene.setSceneUniformBuffer(this._currentSceneUBO);\n            }\n            scene.updateTransformMatrix(true);\n            if (engine._enableGPUDebugMarkers) {\n                engine._debugPopGroup?.();\n            }\n        });\n    }\n\n    /**\n     * Attach the probe to a specific mesh (Rendering will be done from attached mesh's position)\n     * @param mesh defines the mesh to attach to\n     */\n    public attachToMesh(mesh: Nullable<AbstractMesh>): void {\n        this._attachedMesh = mesh;\n    }\n\n    /**\n     * Gets the mesh attached to this probe\n     * @returns the attached mesh or null\n     */\n    public get attachedMesh(): Nullable<AbstractMesh> {\n        return this._attachedMesh;\n    }\n\n    /**\n     * Gets the class name of the reflection probe texture\n     * @returns \"ReflectionProbeTexture\"\n     */\n    public override getClassName(): string {\n        return \"ReflectionProbeTexture\";\n    }\n\n    /**\n     * Converts the reflection probe texture information to a readable string for debug purpose\n     * @param fullDetails Supports for multiple levels of logging within scene loading\n     * @returns the human readable reflection probe texture info\n     */\n    public override toString(fullDetails?: boolean): string {\n        let ret = \"Name: \" + this.name;\n\n        if (fullDetails) {\n            ret += \", position: \" + this.position.toString();\n\n            if (this._attachedMesh) {\n                ret += \", attached mesh: \" + this._attachedMesh.name;\n            }\n        }\n\n        return ret;\n    }\n\n    /**\n     * Used for serializing the probe texture\n     * @returns any\n     */\n    public override serialize(): any {\n        const serializationObject = super.serialize();\n        if (serializationObject) {\n            serializationObject.isReflectionProbe = true;\n            if (this._attachedMesh) {\n                serializationObject.attachedMesh = this._attachedMesh.id;\n            }\n            serializationObject.position = this.position.asArray();\n            serializationObject.options = structuredClone(this._options);\n            return serializationObject;\n        }\n        return null;\n    }\n\n    /**\n     * Clean all associated resources\n     */\n    public override dispose() {\n        if (this._sceneUBOs) {\n            for (const ubo of this._sceneUBOs) {\n                ubo.dispose();\n            }\n            this._sceneUBOs = [];\n        }\n\n        super.dispose();\n    }\n}\n\nTexture._CreateReflectionProbeTexture = function (name, options, scene, position, attachedMesh) {\n    const texture = new ReflectionProbeTexture(name, options, scene);\n    texture.position.fromArray(position);\n    if (attachedMesh) {\n        texture.attachToMesh(scene.getMeshById(attachedMesh) ?? null);\n    }\n    return texture;\n};\n"]}
+{"version":3,"file":"reflectionProbeTexture.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/reflectionProbeTexture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAE/E,cAAc,+BAA+B,CAAC;AAE9C,8BAA8B,EAAE,CAAC","sourcesContent":["import { RegisterReflectionProbeTexture } from \"./reflectionProbeTexture.pure\";\n\nexport * from \"./reflectionProbeTexture.pure\";\n\nRegisterReflectionProbeTexture();\n"]}

package/Materials/Textures/reflectionProbeTexture.pure.d.ts

@@ -0,0 +1,91 @@
+import { type Scene } from "../../scene.js";
+import { type AbstractMesh } from "../../Meshes/abstractMesh.js";
+import { type Nullable } from "../../types.js";
+import { Vector3 } from "../../Maths/math.vector.pure.js";
+import { type IAssetContainer } from "../../IAssetContainer.js";
+import { RenderTargetTexture } from "../../Materials/Textures/renderTargetTexture.pure.js";
+/**
+ * Options for creating a ReflectionProbeTexture
+ */
+export interface IReflectionProbeTextureOptions {
+    /**
+     * The texture resolution (for each face)
+     */
+    size: number;
+    /**
+     * Defines if mip maps should be generated automatically (true by default)
+     */
+    generateMipMaps?: boolean;
+    /**
+     * Defines if HDR data (float data) should be used to store colors (false by default)
+     */
+    useFloat?: boolean;
+    /**
+     * Defines if the probe should be generated in linear space or not (false by default)
+     */
+    linearSpace?: boolean;
+}
+/**
+ * Class used to generate realtime reflection / refraction cube textures.
+ * This is a simplified version of ReflectionProbe that can be used directly as a RenderTargetTexture.
+ * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/reflectionProbes
+ */
+export declare class ReflectionProbeTexture extends RenderTargetTexture {
+    private _projectionMatrix;
+    private _viewMatrix;
+    private _target;
+    private _add;
+    private _sceneUBOs;
+    private _currentSceneUBO;
+    private _invertYAxis;
+    private _options;
+    private _attachedMesh;
+    /** Gets or sets probe position (center of the cube map) */
+    position: Vector3;
+    /** @internal */
+    _parentContainer: Nullable<IAssetContainer>;
+    /**
+     * Creates a new reflection probe texture
+     * @param name defines the name of the probe
+     * @param options defines the options for creating the texture
+     * @param scene defines the hosting scene
+     */
+    constructor(
+    /** defines the name of the probe */
+    name: string, options: number | IReflectionProbeTextureOptions, scene: Scene);
+    /**
+     * Attach the probe to a specific mesh (Rendering will be done from attached mesh's position)
+     * @param mesh defines the mesh to attach to
+     */
+    attachToMesh(mesh: Nullable<AbstractMesh>): void;
+    /**
+     * Gets the mesh attached to this probe
+     * @returns the attached mesh or null
+     */
+    get attachedMesh(): Nullable<AbstractMesh>;
+    /**
+     * Gets the class name of the reflection probe texture
+     * @returns "ReflectionProbeTexture"
+     */
+    getClassName(): string;
+    /**
+     * Converts the reflection probe texture information to a readable string for debug purpose
+     * @param fullDetails Supports for multiple levels of logging within scene loading
+     * @returns the human readable reflection probe texture info
+     */
+    toString(fullDetails?: boolean): string;
+    /**
+     * Used for serializing the probe texture
+     * @returns any
+     */
+    serialize(): any;
+    /**
+     * Clean all associated resources
+     */
+    dispose(): void;
+}
+/**
+ * Register side effects for renderTargetTexture.
+ * Safe to call multiple times; only the first call has an effect.
+ */
+export declare function RegisterReflectionProbeTexture(): void;

package/Materials/Textures/reflectionProbeTexture.pure.js

@@ -0,0 +1,208 @@
+import { Vector3, Matrix } from "../../Maths/math.vector.pure.js";
+import { RenderTargetTexture } from "../../Materials/Textures/renderTargetTexture.pure.js";
+
+import { Texture } from "../../Materials/Textures/texture.pure.js";
+/**
+ * Class used to generate realtime reflection / refraction cube textures.
+ * This is a simplified version of ReflectionProbe that can be used directly as a RenderTargetTexture.
+ * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/reflectionProbes
+ */
+export class ReflectionProbeTexture extends RenderTargetTexture {
+    /**
+     * Creates a new reflection probe texture
+     * @param name defines the name of the probe
+     * @param options defines the options for creating the texture
+     * @param scene defines the hosting scene
+     */
+    constructor(
+    /** defines the name of the probe */
+    name, options, scene) {
+        const size = typeof options === "number" ? options : options.size;
+        const generateMipMaps = typeof options === "number" ? true : (options.generateMipMaps ?? true);
+        const useFloat = typeof options === "number" ? false : (options.useFloat ?? false);
+        const linearSpace = typeof options === "number" ? false : (options.linearSpace ?? false);
+        let textureType = 0;
+        if (useFloat) {
+            const caps = scene.getEngine().getCaps();
+            if (caps.textureHalfFloatRender) {
+                textureType = 2;
+            }
+            else if (caps.textureFloatRender) {
+                textureType = 1;
+            }
+        }
+        super(name, size, scene, generateMipMaps, true, textureType, true, undefined, undefined, undefined, undefined, undefined, linearSpace);
+        this._viewMatrix = Matrix.Identity();
+        this._target = Vector3.Zero();
+        this._add = Vector3.Zero();
+        this._invertYAxis = false;
+        /** Gets or sets probe position (center of the cube map) */
+        this.position = Vector3.Zero();
+        /** @internal */
+        this._parentContainer = null;
+        this._options = options;
+        if (scene.getEngine().supportsUniformBuffers) {
+            this._sceneUBOs = [];
+            for (let i = 0; i < 6; ++i) {
+                this._sceneUBOs.push(scene.createSceneUniformBuffer(`Scene for Reflection Probe (name "${name}") face #${i}`, { forceMono: true }));
+            }
+        }
+        this.gammaSpace = !linearSpace;
+        this.invertZ = scene.useRightHandedSystem;
+        const useReverseDepthBuffer = scene.getEngine().useReverseDepthBuffer;
+        this.onBeforeRenderObservable.add((faceIndex) => {
+            if (this._sceneUBOs) {
+                scene.setSceneUniformBuffer(this._sceneUBOs[faceIndex]);
+                scene.getSceneUniformBuffer().unbindEffect();
+            }
+            switch (faceIndex) {
+                case 0:
+                    this._add.copyFromFloats(1, 0, 0);
+                    break;
+                case 1:
+                    this._add.copyFromFloats(-1, 0, 0);
+                    break;
+                case 2:
+                    this._add.copyFromFloats(0, this._invertYAxis ? 1 : -1, 0);
+                    break;
+                case 3:
+                    this._add.copyFromFloats(0, this._invertYAxis ? -1 : 1, 0);
+                    break;
+                case 4:
+                    this._add.copyFromFloats(0, 0, scene.useRightHandedSystem ? -1 : 1);
+                    break;
+                case 5:
+                    this._add.copyFromFloats(0, 0, scene.useRightHandedSystem ? 1 : -1);
+                    break;
+            }
+            if (this._attachedMesh) {
+                this.position.copyFrom(this._attachedMesh.getAbsolutePosition());
+            }
+            this.position.addToRef(this._add, this._target);
+            const lookAtFunction = scene.useRightHandedSystem ? Matrix.LookAtRHToRef : Matrix.LookAtLHToRef;
+            const perspectiveFunction = scene.useRightHandedSystem ? Matrix.PerspectiveFovRH : Matrix.PerspectiveFovLH;
+            lookAtFunction(this.position, this._target, Vector3.Up(), this._viewMatrix);
+            if (scene.activeCamera) {
+                this._projectionMatrix = perspectiveFunction(Math.PI / 2, 1, useReverseDepthBuffer ? scene.activeCamera.maxZ : scene.activeCamera.minZ, useReverseDepthBuffer ? scene.activeCamera.minZ : scene.activeCamera.maxZ, this._getEngine().isNDCHalfZRange);
+                scene.setTransformMatrix(this._viewMatrix, this._projectionMatrix);
+                if (scene.activeCamera.isRigCamera && !this.activeCamera) {
+                    this.activeCamera = scene.activeCamera.rigParent || null;
+                }
+            }
+            if (this._sceneUBOs) {
+                scene.finalizeSceneUbo();
+            }
+            scene._forcedViewPosition = this.position;
+        });
+        let currentApplyByPostProcess;
+        this.onBeforeBindObservable.add(() => {
+            const engine = scene.getEngine();
+            this._currentSceneUBO = scene.getSceneUniformBuffer();
+            if (engine._enableGPUDebugMarkers) {
+                engine._debugPushGroup?.(`reflection probe generation for ${name}`);
+            }
+            currentApplyByPostProcess = scene.imageProcessingConfiguration.applyByPostProcess;
+            if (linearSpace) {
+                scene.imageProcessingConfiguration.applyByPostProcess = true;
+            }
+        });
+        this.onAfterUnbindObservable.add(() => {
+            const engine = scene.getEngine();
+            scene.imageProcessingConfiguration.applyByPostProcess = currentApplyByPostProcess;
+            scene._forcedViewPosition = null;
+            if (this._sceneUBOs) {
+                scene.setSceneUniformBuffer(this._currentSceneUBO);
+            }
+            scene.updateTransformMatrix(true);
+            if (engine._enableGPUDebugMarkers) {
+                engine._debugPopGroup?.();
+            }
+        });
+    }
+    /**
+     * Attach the probe to a specific mesh (Rendering will be done from attached mesh's position)
+     * @param mesh defines the mesh to attach to
+     */
+    attachToMesh(mesh) {
+        this._attachedMesh = mesh;
+    }
+    /**
+     * Gets the mesh attached to this probe
+     * @returns the attached mesh or null
+     */
+    get attachedMesh() {
+        return this._attachedMesh;
+    }
+    /**
+     * Gets the class name of the reflection probe texture
+     * @returns "ReflectionProbeTexture"
+     */
+    getClassName() {
+        return "ReflectionProbeTexture";
+    }
+    /**
+     * Converts the reflection probe texture information to a readable string for debug purpose
+     * @param fullDetails Supports for multiple levels of logging within scene loading
+     * @returns the human readable reflection probe texture info
+     */
+    toString(fullDetails) {
+        let ret = "Name: " + this.name;
+        if (fullDetails) {
+            ret += ", position: " + this.position.toString();
+            if (this._attachedMesh) {
+                ret += ", attached mesh: " + this._attachedMesh.name;
+            }
+        }
+        return ret;
+    }
+    /**
+     * Used for serializing the probe texture
+     * @returns any
+     */
+    serialize() {
+        const serializationObject = super.serialize();
+        if (serializationObject) {
+            serializationObject.isReflectionProbe = true;
+            if (this._attachedMesh) {
+                serializationObject.attachedMesh = this._attachedMesh.id;
+            }
+            serializationObject.position = this.position.asArray();
+            serializationObject.options = structuredClone(this._options);
+            return serializationObject;
+        }
+        return null;
+    }
+    /**
+     * Clean all associated resources
+     */
+    dispose() {
+        if (this._sceneUBOs) {
+            for (const ubo of this._sceneUBOs) {
+                ubo.dispose();
+            }
+            this._sceneUBOs = [];
+        }
+        super.dispose();
+    }
+}
+let _Registered = false;
+/**
+ * Register side effects for renderTargetTexture.
+ * Safe to call multiple times; only the first call has an effect.
+ */
+export function RegisterReflectionProbeTexture() {
+    if (_Registered) {
+        return;
+    }
+    _Registered = true;
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    Texture._CreateReflectionProbeTexture = function (name, options, scene, position, attachedMesh) {
+        const texture = new ReflectionProbeTexture(name, options, scene);
+        texture.position.fromArray(position);
+        if (attachedMesh) {
+            texture.attachToMesh(scene.getMeshById(attachedMesh) ?? null);
+        }
+        return texture;
+    };
+}
+//# sourceMappingURL=reflectionProbeTexture.pure.js.map