@onerjs/core 8.31.9 → 8.32.0

package/Helpers/sceneHelpers.js

@@ -47,7 +47,7 @@ Scene.prototype.createDefaultCamera = function (createArcRotateCamera = false, r
         let camera;
         let radius = worldSize.length() * 1.5;
         // empty scene scenario!
-        if (!isFinite(radius)) {
+        if (!isFinite(radius) || radius === 0) {
             radius = 1;
             worldCenter.copyFromFloats(0, 0, 0);
         }

package/Helpers/sceneHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"sceneHelpers.js","sourceRoot":"","sources":["../../../../dev/core/src/Helpers/sceneHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["import { Logger } from \"../Misc/logger\";\r\nimport type { Nullable } from \"../types\";\r\nimport { Scene } from \"../scene\";\r\nimport { Vector3 } from \"../Maths/math.vector\";\r\nimport type { Mesh } from \"../Meshes/mesh\";\r\nimport type { BaseTexture } from \"../Materials/Textures/baseTexture\";\r\nimport { Texture } from \"../Materials/Textures/texture\";\r\nimport { StandardMaterial } from \"../Materials/standardMaterial\";\r\nimport { PBRMaterial } from \"../Materials/PBR/pbrMaterial\";\r\nimport { HemisphericLight } from \"../Lights/hemisphericLight\";\r\nimport type { IEnvironmentHelperOptions } from \"./environmentHelper\";\r\nimport { EnvironmentHelper } from \"./environmentHelper\";\r\nimport { FreeCamera } from \"../Cameras/freeCamera\";\r\nimport { ArcRotateCamera } from \"../Cameras/arcRotateCamera\";\r\nimport type { TargetCamera } from \"../Cameras/targetCamera\";\r\nimport type { VRExperienceHelperOptions } from \"../Cameras/VR/vrExperienceHelper\";\r\nimport { VRExperienceHelper } from \"../Cameras/VR/vrExperienceHelper\";\r\n\r\nimport \"../Materials/Textures/Loaders/ddsTextureLoader\";\r\nimport \"../Materials/Textures/Loaders/envTextureLoader\";\r\nimport \"../Materials/Textures/Loaders/ktxTextureLoader\";\r\nimport { CreateBox } from \"../Meshes/Builders/boxBuilder\";\r\nimport type { WebXRDefaultExperienceOptions } from \"../XR/webXRDefaultExperience\";\r\nimport { WebXRDefaultExperience } from \"../XR/webXRDefaultExperience\";\r\n\r\n/** @internal */\r\n// eslint-disable-next-line no-var, @typescript-eslint/naming-convention\r\nexport var _forceSceneHelpersToBundle = true;\r\n\r\ndeclare module \"../scene\" {\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    export interface Scene {\r\n        /**\r\n         * Creates a default light for the scene.\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/fastBuildWorld#create-default-light\r\n         * @param replace has the default false, when true replaces the existing lights in the scene with a hemispheric light\r\n         */\r\n        createDefaultLight(replace?: boolean): void;\r\n\r\n        /**\r\n         * Creates a default camera for the scene.\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/fastBuildWorld#create-default-camera\r\n         * @param createArcRotateCamera has the default false which creates a free camera, when true creates an arc rotate camera\r\n         * @param replace has default false, when true replaces the active camera in the scene\r\n         * @param attachCameraControls has default false, when true attaches camera controls to the canvas.\r\n         */\r\n        createDefaultCamera(createArcRotateCamera?: boolean, replace?: boolean, attachCameraControls?: boolean): void;\r\n\r\n        /**\r\n         * Creates a default camera and a default light.\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/fastBuildWorld#create-default-camera-or-light\r\n         * @param createArcRotateCamera has the default false which creates a free camera, when true creates an arc rotate camera\r\n         * @param replace has the default false, when true replaces the active camera/light in the scene\r\n         * @param attachCameraControls has the default false, when true attaches camera controls to the canvas.\r\n         */\r\n        createDefaultCameraOrLight(createArcRotateCamera?: boolean, replace?: boolean, attachCameraControls?: boolean): void;\r\n\r\n        /**\r\n         * Creates a new sky box\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/fastBuildWorld#create-default-skybox\r\n         * @param environmentTexture defines the texture to use as environment texture\r\n         * @param pbr has default false which requires the StandardMaterial to be used, when true PBRMaterial must be used\r\n         * @param scale defines the overall scale of the skybox\r\n         * @param blur is only available when pbr is true, default is 0, no blur, maximum value is 1\r\n         * @param setGlobalEnvTexture has default true indicating that scene.environmentTexture must match the current skybox texture\r\n         * @returns a new mesh holding the sky box\r\n         */\r\n        createDefaultSkybox(environmentTexture?: BaseTexture, pbr?: boolean, scale?: number, blur?: number, setGlobalEnvTexture?: boolean): Nullable<Mesh>;\r\n\r\n        /**\r\n         * Creates a new environment\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/fastBuildWorld#create-default-environment\r\n         * @param options defines the options you can use to configure the environment\r\n         * @returns the new EnvironmentHelper\r\n         */\r\n        createDefaultEnvironment(options?: Partial<IEnvironmentHelperOptions>): Nullable<EnvironmentHelper>;\r\n\r\n        /**\r\n         * Creates a new VREXperienceHelper\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/webVRHelper\r\n         * @param webVROptions defines the options used to create the new VREXperienceHelper\r\n         * @deprecated Please use createDefaultXRExperienceAsync instead\r\n         * @returns a new VREXperienceHelper\r\n         */\r\n        createDefaultVRExperience(webVROptions?: VRExperienceHelperOptions): VRExperienceHelper;\r\n\r\n        /**\r\n         * Creates a new WebXRDefaultExperience\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/webXR/introToWebXR\r\n         * @param options experience options\r\n         * @returns a promise for a new WebXRDefaultExperience\r\n         */\r\n        createDefaultXRExperienceAsync(options?: WebXRDefaultExperienceOptions): Promise<WebXRDefaultExperience>;\r\n    }\r\n}\r\n\r\nScene.prototype.createDefaultLight = function (replace = false): void {\r\n    // Dispose existing light in replace mode.\r\n    if (replace) {\r\n        if (this.lights) {\r\n            for (let i = 0; i < this.lights.length; i++) {\r\n                this.lights[i].dispose();\r\n            }\r\n        }\r\n    }\r\n\r\n    // Light\r\n    if (this.lights.length === 0) {\r\n        new HemisphericLight(\"default light\", Vector3.Up(), this);\r\n    }\r\n};\r\n\r\nScene.prototype.createDefaultCamera = function (createArcRotateCamera = false, replace = false, attachCameraControls = false): void {\r\n    // Dispose existing camera in replace mode.\r\n    if (replace) {\r\n        if (this.activeCamera) {\r\n            this.activeCamera.dispose();\r\n            this.activeCamera = null;\r\n        }\r\n    }\r\n\r\n    // Camera\r\n    if (!this.activeCamera) {\r\n        const worldExtends = this.getWorldExtends((mesh) => mesh.isVisible && mesh.isEnabled());\r\n        const worldSize = worldExtends.max.subtract(worldExtends.min);\r\n        const worldCenter = worldExtends.min.add(worldSize.scale(0.5));\r\n\r\n        let camera: TargetCamera;\r\n        let radius = worldSize.length() * 1.5;\r\n        // empty scene scenario!\r\n        if (!isFinite(radius)) {\r\n            radius = 1;\r\n            worldCenter.copyFromFloats(0, 0, 0);\r\n        }\r\n        if (createArcRotateCamera) {\r\n            const arcRotateCamera = new ArcRotateCamera(\"default camera\", -(Math.PI / 2), Math.PI / 2, radius, worldCenter, this);\r\n            arcRotateCamera.lowerRadiusLimit = radius * 0.01;\r\n            arcRotateCamera.wheelPrecision = 100 / radius;\r\n            camera = arcRotateCamera;\r\n        } else {\r\n            const freeCamera = new FreeCamera(\"default camera\", new Vector3(worldCenter.x, worldCenter.y, -radius), this);\r\n            freeCamera.setTarget(worldCenter);\r\n            camera = freeCamera;\r\n        }\r\n        camera.minZ = radius * 0.01;\r\n        camera.maxZ = radius * 1000;\r\n        camera.speed = radius * 0.2;\r\n        this.activeCamera = camera;\r\n\r\n        if (attachCameraControls) {\r\n            camera.attachControl();\r\n        }\r\n    }\r\n};\r\n\r\nScene.prototype.createDefaultCameraOrLight = function (createArcRotateCamera = false, replace = false, attachCameraControls = false): void {\r\n    this.createDefaultLight(replace);\r\n    this.createDefaultCamera(createArcRotateCamera, replace, attachCameraControls);\r\n};\r\n\r\nScene.prototype.createDefaultSkybox = function (environmentTexture?: BaseTexture, pbr = false, scale = 1000, blur = 0, setGlobalEnvTexture = true): Nullable<Mesh> {\r\n    if (!environmentTexture) {\r\n        Logger.Warn(\"Can not create default skybox without environment texture.\");\r\n        return null;\r\n    }\r\n\r\n    if (setGlobalEnvTexture) {\r\n        if (environmentTexture) {\r\n            this.environmentTexture = environmentTexture;\r\n        }\r\n    }\r\n\r\n    // Skybox\r\n    const hdrSkybox = CreateBox(\"hdrSkyBox\", { size: scale }, this);\r\n    if (pbr) {\r\n        const hdrSkyboxMaterial = new PBRMaterial(\"skyBox\", this);\r\n        hdrSkyboxMaterial.backFaceCulling = false;\r\n        hdrSkyboxMaterial.reflectionTexture = environmentTexture.clone();\r\n        if (hdrSkyboxMaterial.reflectionTexture) {\r\n            hdrSkyboxMaterial.reflectionTexture.coordinatesMode = Texture.SKYBOX_MODE;\r\n        }\r\n        hdrSkyboxMaterial.microSurface = 1.0 - blur;\r\n        hdrSkyboxMaterial.disableLighting = true;\r\n        hdrSkyboxMaterial.twoSidedLighting = true;\r\n        hdrSkybox.material = hdrSkyboxMaterial;\r\n    } else {\r\n        const skyboxMaterial = new StandardMaterial(\"skyBox\", this);\r\n        skyboxMaterial.backFaceCulling = false;\r\n        skyboxMaterial.reflectionTexture = environmentTexture.clone();\r\n        if (skyboxMaterial.reflectionTexture) {\r\n            skyboxMaterial.reflectionTexture.coordinatesMode = Texture.SKYBOX_MODE;\r\n        }\r\n        skyboxMaterial.disableLighting = true;\r\n        hdrSkybox.material = skyboxMaterial;\r\n    }\r\n    hdrSkybox.isPickable = false;\r\n    hdrSkybox.infiniteDistance = true;\r\n    hdrSkybox.ignoreCameraMaxZ = true;\r\n    return hdrSkybox;\r\n};\r\n\r\nScene.prototype.createDefaultEnvironment = function (options: Partial<IEnvironmentHelperOptions>): Nullable<EnvironmentHelper> {\r\n    if (EnvironmentHelper) {\r\n        return new EnvironmentHelper(options, this);\r\n    }\r\n    return null;\r\n};\r\n\r\nScene.prototype.createDefaultVRExperience = function (webVROptions: VRExperienceHelperOptions = {}): VRExperienceHelper {\r\n    return new VRExperienceHelper(this, webVROptions);\r\n};\r\n\r\nScene.prototype.createDefaultXRExperienceAsync = async function (options: WebXRDefaultExperienceOptions = {}): Promise<WebXRDefaultExperience> {\r\n    return await WebXRDefaultExperience.CreateAsync(this, options);\r\n};\r\n"]}
+{"version":3,"file":"sceneHelpers.js","sourceRoot":"","sources":["../../../../dev/core/src/Helpers/sceneHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["import { Logger } from \"../Misc/logger\";\r\nimport type { Nullable } from \"../types\";\r\nimport { Scene } from \"../scene\";\r\nimport { Vector3 } from \"../Maths/math.vector\";\r\nimport type { Mesh } from \"../Meshes/mesh\";\r\nimport type { BaseTexture } from \"../Materials/Textures/baseTexture\";\r\nimport { Texture } from \"../Materials/Textures/texture\";\r\nimport { StandardMaterial } from \"../Materials/standardMaterial\";\r\nimport { PBRMaterial } from \"../Materials/PBR/pbrMaterial\";\r\nimport { HemisphericLight } from \"../Lights/hemisphericLight\";\r\nimport type { IEnvironmentHelperOptions } from \"./environmentHelper\";\r\nimport { EnvironmentHelper } from \"./environmentHelper\";\r\nimport { FreeCamera } from \"../Cameras/freeCamera\";\r\nimport { ArcRotateCamera } from \"../Cameras/arcRotateCamera\";\r\nimport type { TargetCamera } from \"../Cameras/targetCamera\";\r\nimport type { VRExperienceHelperOptions } from \"../Cameras/VR/vrExperienceHelper\";\r\nimport { VRExperienceHelper } from \"../Cameras/VR/vrExperienceHelper\";\r\n\r\nimport \"../Materials/Textures/Loaders/ddsTextureLoader\";\r\nimport \"../Materials/Textures/Loaders/envTextureLoader\";\r\nimport \"../Materials/Textures/Loaders/ktxTextureLoader\";\r\nimport { CreateBox } from \"../Meshes/Builders/boxBuilder\";\r\nimport type { WebXRDefaultExperienceOptions } from \"../XR/webXRDefaultExperience\";\r\nimport { WebXRDefaultExperience } from \"../XR/webXRDefaultExperience\";\r\n\r\n/** @internal */\r\n// eslint-disable-next-line no-var, @typescript-eslint/naming-convention\r\nexport var _forceSceneHelpersToBundle = true;\r\n\r\ndeclare module \"../scene\" {\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    export interface Scene {\r\n        /**\r\n         * Creates a default light for the scene.\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/fastBuildWorld#create-default-light\r\n         * @param replace has the default false, when true replaces the existing lights in the scene with a hemispheric light\r\n         */\r\n        createDefaultLight(replace?: boolean): void;\r\n\r\n        /**\r\n         * Creates a default camera for the scene.\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/fastBuildWorld#create-default-camera\r\n         * @param createArcRotateCamera has the default false which creates a free camera, when true creates an arc rotate camera\r\n         * @param replace has default false, when true replaces the active camera in the scene\r\n         * @param attachCameraControls has default false, when true attaches camera controls to the canvas.\r\n         */\r\n        createDefaultCamera(createArcRotateCamera?: boolean, replace?: boolean, attachCameraControls?: boolean): void;\r\n\r\n        /**\r\n         * Creates a default camera and a default light.\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/fastBuildWorld#create-default-camera-or-light\r\n         * @param createArcRotateCamera has the default false which creates a free camera, when true creates an arc rotate camera\r\n         * @param replace has the default false, when true replaces the active camera/light in the scene\r\n         * @param attachCameraControls has the default false, when true attaches camera controls to the canvas.\r\n         */\r\n        createDefaultCameraOrLight(createArcRotateCamera?: boolean, replace?: boolean, attachCameraControls?: boolean): void;\r\n\r\n        /**\r\n         * Creates a new sky box\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/fastBuildWorld#create-default-skybox\r\n         * @param environmentTexture defines the texture to use as environment texture\r\n         * @param pbr has default false which requires the StandardMaterial to be used, when true PBRMaterial must be used\r\n         * @param scale defines the overall scale of the skybox\r\n         * @param blur is only available when pbr is true, default is 0, no blur, maximum value is 1\r\n         * @param setGlobalEnvTexture has default true indicating that scene.environmentTexture must match the current skybox texture\r\n         * @returns a new mesh holding the sky box\r\n         */\r\n        createDefaultSkybox(environmentTexture?: BaseTexture, pbr?: boolean, scale?: number, blur?: number, setGlobalEnvTexture?: boolean): Nullable<Mesh>;\r\n\r\n        /**\r\n         * Creates a new environment\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/fastBuildWorld#create-default-environment\r\n         * @param options defines the options you can use to configure the environment\r\n         * @returns the new EnvironmentHelper\r\n         */\r\n        createDefaultEnvironment(options?: Partial<IEnvironmentHelperOptions>): Nullable<EnvironmentHelper>;\r\n\r\n        /**\r\n         * Creates a new VREXperienceHelper\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/webVRHelper\r\n         * @param webVROptions defines the options used to create the new VREXperienceHelper\r\n         * @deprecated Please use createDefaultXRExperienceAsync instead\r\n         * @returns a new VREXperienceHelper\r\n         */\r\n        createDefaultVRExperience(webVROptions?: VRExperienceHelperOptions): VRExperienceHelper;\r\n\r\n        /**\r\n         * Creates a new WebXRDefaultExperience\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/webXR/introToWebXR\r\n         * @param options experience options\r\n         * @returns a promise for a new WebXRDefaultExperience\r\n         */\r\n        createDefaultXRExperienceAsync(options?: WebXRDefaultExperienceOptions): Promise<WebXRDefaultExperience>;\r\n    }\r\n}\r\n\r\nScene.prototype.createDefaultLight = function (replace = false): void {\r\n    // Dispose existing light in replace mode.\r\n    if (replace) {\r\n        if (this.lights) {\r\n            for (let i = 0; i < this.lights.length; i++) {\r\n                this.lights[i].dispose();\r\n            }\r\n        }\r\n    }\r\n\r\n    // Light\r\n    if (this.lights.length === 0) {\r\n        new HemisphericLight(\"default light\", Vector3.Up(), this);\r\n    }\r\n};\r\n\r\nScene.prototype.createDefaultCamera = function (createArcRotateCamera = false, replace = false, attachCameraControls = false): void {\r\n    // Dispose existing camera in replace mode.\r\n    if (replace) {\r\n        if (this.activeCamera) {\r\n            this.activeCamera.dispose();\r\n            this.activeCamera = null;\r\n        }\r\n    }\r\n\r\n    // Camera\r\n    if (!this.activeCamera) {\r\n        const worldExtends = this.getWorldExtends((mesh) => mesh.isVisible && mesh.isEnabled());\r\n        const worldSize = worldExtends.max.subtract(worldExtends.min);\r\n        const worldCenter = worldExtends.min.add(worldSize.scale(0.5));\r\n\r\n        let camera: TargetCamera;\r\n        let radius = worldSize.length() * 1.5;\r\n        // empty scene scenario!\r\n        if (!isFinite(radius) || radius === 0) {\r\n            radius = 1;\r\n            worldCenter.copyFromFloats(0, 0, 0);\r\n        }\r\n        if (createArcRotateCamera) {\r\n            const arcRotateCamera = new ArcRotateCamera(\"default camera\", -(Math.PI / 2), Math.PI / 2, radius, worldCenter, this);\r\n            arcRotateCamera.lowerRadiusLimit = radius * 0.01;\r\n            arcRotateCamera.wheelPrecision = 100 / radius;\r\n            camera = arcRotateCamera;\r\n        } else {\r\n            const freeCamera = new FreeCamera(\"default camera\", new Vector3(worldCenter.x, worldCenter.y, -radius), this);\r\n            freeCamera.setTarget(worldCenter);\r\n            camera = freeCamera;\r\n        }\r\n        camera.minZ = radius * 0.01;\r\n        camera.maxZ = radius * 1000;\r\n        camera.speed = radius * 0.2;\r\n        this.activeCamera = camera;\r\n\r\n        if (attachCameraControls) {\r\n            camera.attachControl();\r\n        }\r\n    }\r\n};\r\n\r\nScene.prototype.createDefaultCameraOrLight = function (createArcRotateCamera = false, replace = false, attachCameraControls = false): void {\r\n    this.createDefaultLight(replace);\r\n    this.createDefaultCamera(createArcRotateCamera, replace, attachCameraControls);\r\n};\r\n\r\nScene.prototype.createDefaultSkybox = function (environmentTexture?: BaseTexture, pbr = false, scale = 1000, blur = 0, setGlobalEnvTexture = true): Nullable<Mesh> {\r\n    if (!environmentTexture) {\r\n        Logger.Warn(\"Can not create default skybox without environment texture.\");\r\n        return null;\r\n    }\r\n\r\n    if (setGlobalEnvTexture) {\r\n        if (environmentTexture) {\r\n            this.environmentTexture = environmentTexture;\r\n        }\r\n    }\r\n\r\n    // Skybox\r\n    const hdrSkybox = CreateBox(\"hdrSkyBox\", { size: scale }, this);\r\n    if (pbr) {\r\n        const hdrSkyboxMaterial = new PBRMaterial(\"skyBox\", this);\r\n        hdrSkyboxMaterial.backFaceCulling = false;\r\n        hdrSkyboxMaterial.reflectionTexture = environmentTexture.clone();\r\n        if (hdrSkyboxMaterial.reflectionTexture) {\r\n            hdrSkyboxMaterial.reflectionTexture.coordinatesMode = Texture.SKYBOX_MODE;\r\n        }\r\n        hdrSkyboxMaterial.microSurface = 1.0 - blur;\r\n        hdrSkyboxMaterial.disableLighting = true;\r\n        hdrSkyboxMaterial.twoSidedLighting = true;\r\n        hdrSkybox.material = hdrSkyboxMaterial;\r\n    } else {\r\n        const skyboxMaterial = new StandardMaterial(\"skyBox\", this);\r\n        skyboxMaterial.backFaceCulling = false;\r\n        skyboxMaterial.reflectionTexture = environmentTexture.clone();\r\n        if (skyboxMaterial.reflectionTexture) {\r\n            skyboxMaterial.reflectionTexture.coordinatesMode = Texture.SKYBOX_MODE;\r\n        }\r\n        skyboxMaterial.disableLighting = true;\r\n        hdrSkybox.material = skyboxMaterial;\r\n    }\r\n    hdrSkybox.isPickable = false;\r\n    hdrSkybox.infiniteDistance = true;\r\n    hdrSkybox.ignoreCameraMaxZ = true;\r\n    return hdrSkybox;\r\n};\r\n\r\nScene.prototype.createDefaultEnvironment = function (options: Partial<IEnvironmentHelperOptions>): Nullable<EnvironmentHelper> {\r\n    if (EnvironmentHelper) {\r\n        return new EnvironmentHelper(options, this);\r\n    }\r\n    return null;\r\n};\r\n\r\nScene.prototype.createDefaultVRExperience = function (webVROptions: VRExperienceHelperOptions = {}): VRExperienceHelper {\r\n    return new VRExperienceHelper(this, webVROptions);\r\n};\r\n\r\nScene.prototype.createDefaultXRExperienceAsync = async function (options: WebXRDefaultExperienceOptions = {}): Promise<WebXRDefaultExperience> {\r\n    return await WebXRDefaultExperience.CreateAsync(this, options);\r\n};\r\n"]}

package/Lights/index.d.ts

@@ -10,3 +10,4 @@ export * from "./rectAreaLight.js";
 export * from "./Clustered/index.js";
 export * from "./IES/iesLoader.js";
 export * from "./lightConstants.js";
+export * from "./lightingVolume.js";

package/Lights/index.js

@@ -11,4 +11,5 @@ export * from "./rectAreaLight.js";
 export * from "./Clustered/index.js";
 export * from "./IES/iesLoader.js";
 export * from "./lightConstants.js";
+export * from "./lightingVolume.js";
 //# sourceMappingURL=index.js.map

package/Lights/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../dev/core/src/Lights/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-restricted-imports */\r\nexport * from \"./light\";\r\nexport * from \"./shadowLight\";\r\nexport * from \"./Shadows/index\";\r\nexport * from \"./directionalLight\";\r\nexport * from \"./hemisphericLight\";\r\nexport * from \"./pointLight\";\r\nexport * from \"./spotLight\";\r\nexport * from \"./areaLight\";\r\nexport * from \"./rectAreaLight\";\r\nexport * from \"./Clustered/index\";\r\nexport * from \"./IES/iesLoader\";\r\nexport * from \"./lightConstants\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../dev/core/src/Lights/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-restricted-imports */\r\nexport * from \"./light\";\r\nexport * from \"./shadowLight\";\r\nexport * from \"./Shadows/index\";\r\nexport * from \"./directionalLight\";\r\nexport * from \"./hemisphericLight\";\r\nexport * from \"./pointLight\";\r\nexport * from \"./spotLight\";\r\nexport * from \"./areaLight\";\r\nexport * from \"./rectAreaLight\";\r\nexport * from \"./Clustered/index\";\r\nexport * from \"./IES/iesLoader\";\r\nexport * from \"./lightConstants\";\r\nexport * from \"./lightingVolume\";\r\n"]}

package/Lights/lightingVolume.d.ts

@@ -0,0 +1,89 @@
+import type { Scene, ShadowGenerator } from "../index.js";
+import { Mesh } from "../Meshes/mesh.js";
+import "../ShadersWGSL/lightingVolume.compute.js";
+/**
+ * Class used to create a lighting volume from a directional light's shadow generator.
+ */
+export declare class LightingVolume {
+    private readonly _engine;
+    private readonly _scene;
+    private readonly _mesh;
+    private readonly _copyTexture?;
+    private readonly _uBuffer?;
+    private _name;
+    private _cs?;
+    private _light?;
+    private _fallbackTexture?;
+    private _storageBuffer?;
+    private _depthCopy?;
+    private _readPixelPromise;
+    private _readPixelAbortController;
+    private _numFrames;
+    private _firstUpdate;
+    private _shadowGenerator?;
+    /**
+     * The shadow generator used to create the lighting volume.
+     */
+    get shadowGenerator(): ShadowGenerator;
+    set shadowGenerator(sg: ShadowGenerator);
+    private _tesselation;
+    /**
+     * The tesselation level of the lighting volume.
+     */
+    get tesselation(): number;
+    set tesselation(n: number);
+    private _buildFullVolume;
+    /**
+     * Indicates whether to build the full volume (true) or only the far plane (false). Default is false.
+     */
+    get buildFullVolume(): boolean;
+    set buildFullVolume(value: boolean);
+    /**
+     * The mesh used as a support for the lighting volume.
+     * Note that this mesh is not automatically added to the scene's mesh array.
+     * If you want to render it, you need to add it manually.
+     */
+    get mesh(): Mesh;
+    private _frequency;
+    /**
+     * The frequency (in number of times you call updateMesh) at which the lighting volume is updated.
+     */
+    get frequency(): number;
+    set frequency(value: number);
+    /**
+     * The name of the lighting volume.
+     */
+    get name(): string;
+    set name(name: string);
+    /**
+     * Indicates whether this is the first update of the lighting volume.
+     * If true, the volume has not yet been updated for the first time.
+     */
+    get firstUpdate(): boolean;
+    /**
+     * Creates a new LightingVolume.
+     * @param name The name of the lighting volume.
+     * @param scene The scene the lighting volume belongs to.
+     * @param shadowGenerator The shadow generator used to create the lighting volume. This is optional in the constructor, but must be set before calling updateMesh.
+     * @param tesselation The tesselation level of the lighting volume (default: 64).
+     */
+    constructor(name: string, scene: Scene, shadowGenerator?: ShadowGenerator, tesselation?: number);
+    /**
+     * Checks if the lighting volume is ready to be updated.
+     * @returns True if the volume is ready to be updated.
+     */
+    isReady(): boolean;
+    /**
+     * Updates the lighting volume mesh.
+     * @param forceUpdate If true, forces the update even if the frequency condition is not met.
+     */
+    update(forceUpdate?: boolean): void;
+    /**
+     * Disposes the lighting volume and associated resources.
+     */
+    dispose(): void;
+    private _createComputeShader;
+    private _createFallbackTextures;
+    private _fallbackReadPixelAsync;
+    private _createGeometry;
+}

package/Lights/lightingVolume.js

@@ -0,0 +1,426 @@
+import { AbortError } from "../Misc/error.js";
+
+import { Matrix, Vector3 } from "../Maths/math.vector.js";
+import { DirectionalLight } from "./directionalLight.js";
+import { Mesh } from "../Meshes/mesh.js";
+import { ComputeShader } from "../Compute/computeShader.js";
+import { CopyTextureToTexture } from "../Misc/copyTextureToTexture.js";
+import { UniformBuffer } from "../Materials/uniformBuffer.js";
+import { StorageBuffer } from "../Buffers/storageBuffer.js";
+import { BaseTexture } from "../Materials/Textures/baseTexture.js";
+import { VertexBuffer } from "../Buffers/buffer.js";
+import "../ShadersWGSL/lightingVolume.compute.js";
+const InvViewProjMatrix = new Matrix();
+const TmpVec3 = new Vector3();
+/**
+ * Class used to create a lighting volume from a directional light's shadow generator.
+ */
+export class LightingVolume {
+    /**
+     * The shadow generator used to create the lighting volume.
+     */
+    get shadowGenerator() {
+        return this._shadowGenerator;
+    }
+    set shadowGenerator(sg) {
+        const light = sg.getLight();
+        if (!(light instanceof DirectionalLight)) {
+            throw new Error(`LightingVolumeMesh ${this._name}: light must be a directional light`);
+        }
+        this._shadowGenerator = sg;
+        this._light = light;
+        this._createGeometry();
+        if (!this._engine.isWebGPU) {
+            this._createFallbackTextures();
+        }
+        const depthTexture = this._shadowGenerator.getShadowMap()?.depthStencilTexture;
+        if (this._cs && depthTexture) {
+            this._cs.setInternalTexture("shadowMap", depthTexture);
+        }
+    }
+    /**
+     * The tesselation level of the lighting volume.
+     */
+    get tesselation() {
+        return this._tesselation;
+    }
+    set tesselation(n) {
+        this._tesselation = n;
+        this._createGeometry();
+    }
+    /**
+     * Indicates whether to build the full volume (true) or only the far plane (false). Default is false.
+     */
+    get buildFullVolume() {
+        return this._buildFullVolume;
+    }
+    set buildFullVolume(value) {
+        if (this._buildFullVolume === value) {
+            return;
+        }
+        this._buildFullVolume = value;
+        this._createGeometry();
+        this._createComputeShader();
+    }
+    /**
+     * The mesh used as a support for the lighting volume.
+     * Note that this mesh is not automatically added to the scene's mesh array.
+     * If you want to render it, you need to add it manually.
+     */
+    get mesh() {
+        return this._mesh;
+    }
+    /**
+     * The frequency (in number of times you call updateMesh) at which the lighting volume is updated.
+     */
+    get frequency() {
+        return this._frequency;
+    }
+    set frequency(value) {
+        this._frequency = value;
+        this._firstUpdate = true;
+    }
+    /**
+     * The name of the lighting volume.
+     */
+    get name() {
+        return this._name;
+    }
+    set name(name) {
+        this._name = name;
+        if (this._mesh) {
+            this._mesh.name = name;
+        }
+    }
+    /**
+     * Indicates whether this is the first update of the lighting volume.
+     * If true, the volume has not yet been updated for the first time.
+     */
+    get firstUpdate() {
+        return this._firstUpdate;
+    }
+    /**
+     * Creates a new LightingVolume.
+     * @param name The name of the lighting volume.
+     * @param scene The scene the lighting volume belongs to.
+     * @param shadowGenerator The shadow generator used to create the lighting volume. This is optional in the constructor, but must be set before calling updateMesh.
+     * @param tesselation The tesselation level of the lighting volume (default: 64).
+     */
+    constructor(name, scene, shadowGenerator, tesselation = 64) {
+        this._readPixelPromise = null;
+        this._readPixelAbortController = null;
+        this._numFrames = 0;
+        this._firstUpdate = true;
+        this._tesselation = 0;
+        this._buildFullVolume = false;
+        this._frequency = 1;
+        const light = shadowGenerator ? shadowGenerator.getLight() : undefined;
+        if (light && !(light instanceof DirectionalLight)) {
+            throw new Error(`LightingVolumeMesh ${name}: light must be a directional light`);
+        }
+        this._name = name;
+        this._shadowGenerator = shadowGenerator;
+        this._light = light;
+        this._engine = scene.getEngine();
+        this._scene = scene;
+        this._mesh = new Mesh(name, this._scene);
+        scene.meshes.splice(scene.meshes.indexOf(this._mesh), 1);
+        if (this._engine.isWebGPU) {
+            this._uBuffer = new UniformBuffer(this._engine);
+            this._uBuffer.addUniform("invViewProjMatrix", 16);
+            this._uBuffer.addUniform("startVertexIndex", 1);
+            this._uBuffer.addUniform("step", 1);
+            this._uBuffer.addUniform("tesselation", 1);
+            this._uBuffer.update();
+            this._createComputeShader();
+        }
+        else {
+            this._copyTexture = new CopyTextureToTexture(this._engine, false, true);
+            this._createFallbackTextures();
+        }
+        this._tesselation = tesselation;
+        this._createGeometry();
+    }
+    /**
+     * Checks if the lighting volume is ready to be updated.
+     * @returns True if the volume is ready to be updated.
+     */
+    isReady() {
+        let isReady = this._mesh.isReady(true);
+        if (this._cs) {
+            isReady = this._cs.isReady() && isReady;
+        }
+        return isReady;
+    }
+    /**
+     * Updates the lighting volume mesh.
+     * @param forceUpdate If true, forces the update even if the frequency condition is not met.
+     */
+    update(forceUpdate = false) {
+        if (this._tesselation === 0 || !this._shadowGenerator) {
+            return;
+        }
+        if (!forceUpdate && !this._firstUpdate && (this.frequency === 0 || ++this._numFrames < this.frequency)) {
+            return;
+        }
+        this._numFrames = 0;
+        if (this._cs && this._uBuffer) {
+            const dispatchSize = Math.ceil((this._tesselation + 1) / 8);
+            const viewProjMatrix = this._shadowGenerator.getTransformMatrix();
+            viewProjMatrix.invertToRef(InvViewProjMatrix);
+            this._uBuffer.updateMatrix("invViewProjMatrix", InvViewProjMatrix);
+            this._uBuffer.update();
+            this._engine._debugPushGroup?.(`Generate lighting volume (${this._name})`);
+            this._cs.dispatch(dispatchSize, dispatchSize, 1);
+            this._engine._debugPopGroup?.();
+            this._firstUpdate = false;
+        }
+        else {
+            try {
+                void this._fallbackReadPixelAsync();
+            }
+            catch {
+                this._readPixelPromise = null;
+            }
+        }
+    }
+    /**
+     * Disposes the lighting volume and associated resources.
+     */
+    dispose() {
+        this._readPixelAbortController?.abort(new AbortError("LightingVolume is disposed"));
+        this._readPixelAbortController = null;
+        this._mesh.dispose();
+        if (this._fallbackTexture) {
+            this._fallbackTexture._texture = null;
+        }
+        this._fallbackTexture?.dispose();
+        this._copyTexture?.dispose();
+        this._storageBuffer?.dispose();
+        this._uBuffer?.dispose();
+        this._depthCopy?.dispose();
+    }
+    _createComputeShader() {
+        this._cs = new ComputeShader("createLightVolume", this._engine, "lightingVolume", {
+            bindingsMapping: {
+                shadowMap: { group: 0, binding: 0 },
+                params: { group: 0, binding: 1 },
+                positions: { group: 0, binding: 2 },
+            },
+            defines: !this._buildFullVolume ? ["#define KEEP_EDGES", "#define MOVE_FAR_DEPTH_TO_NEAR"] : undefined,
+        });
+        if (this._shadowGenerator) {
+            const depthTexture = this._shadowGenerator.getShadowMap()?.depthStencilTexture;
+            if (depthTexture) {
+                this._cs.setInternalTexture("shadowMap", depthTexture);
+            }
+        }
+        if (this._uBuffer) {
+            this._cs.setUniformBuffer("params", this._uBuffer);
+        }
+        if (this._storageBuffer) {
+            this._cs.setStorageBuffer("positions", this._storageBuffer);
+        }
+    }
+    _createFallbackTextures() {
+        if (!this._shadowGenerator) {
+            return;
+        }
+        this._readPixelAbortController?.abort(new AbortError("Fallback textures are being (re)created"));
+        this._readPixelAbortController = new AbortController();
+        const mapSize = this._shadowGenerator.mapSize;
+        this._depthCopy?.dispose();
+        this._depthCopy = this._engine.createRenderTargetTexture({ width: mapSize, height: mapSize }, {
+            type: 1,
+            format: 6,
+            samples: 1,
+            label: `${this._name} - fallback internal texture`,
+            generateDepthBuffer: false,
+        });
+        this._fallbackTexture?.dispose();
+        this._fallbackTexture = new BaseTexture(this._scene, this._depthCopy.texture);
+        this._fallbackTexture.name = `${this._name} - fallback texture`;
+    }
+    async _fallbackReadPixelAsync() {
+        if (this._readPixelPromise || !this._fallbackTexture || !this._copyTexture) {
+            return;
+        }
+        const abortController = this._readPixelAbortController;
+        abortController?.signal.throwIfAborted();
+        const engine = this._engine;
+        const shadowGenerator = this._shadowGenerator;
+        const shadowMapDepthTexture = shadowGenerator?.getShadowMap()?.depthStencilTexture;
+        if (!shadowMapDepthTexture) {
+            return;
+        }
+        // Copies the shadow map of the shadow generator into _depthCopy
+        // That's because we can't read from a depth attachment texture in WebGL. We must first copy it to a regular texture.
+        engine.updateTextureSamplingMode(1, shadowMapDepthTexture);
+        engine.updateTextureComparisonFunction(shadowMapDepthTexture, 0);
+        this._copyTexture.copy(shadowMapDepthTexture, this._depthCopy);
+        engine.updateTextureComparisonFunction(shadowMapDepthTexture, 513);
+        // Gets the texture from GPU to CPU
+        this._readPixelPromise = this._fallbackTexture.readPixels(0, 0, undefined, true, false);
+        if (!this._readPixelPromise) {
+            return;
+        }
+        const buffer = await this._readPixelPromise;
+        abortController?.signal.throwIfAborted();
+        const depthValues = buffer;
+        const positions = this._mesh.getVerticesData("position");
+        const numTesselation = this._tesselation;
+        const startPos = this._buildFullVolume ? (numTesselation + 1) * 4 * 3 : 4 * 3;
+        const mapSize = shadowGenerator.mapSize;
+        const step = (mapSize - 1) / numTesselation;
+        if (!positions) {
+            this._readPixelPromise = null;
+            return;
+        }
+        const halfTesselation = numTesselation / 2;
+        const invViewProjMatrix = shadowGenerator.getTransformMatrix().clone();
+        invViewProjMatrix.invertToRef(invViewProjMatrix);
+        const factor = 4;
+        let posIndex = startPos;
+        let stepY = 0;
+        for (let y = 0; y < numTesselation + 1; ++y) {
+            for (let x = 0; x < numTesselation + 1; ++x) {
+                let depth = depthValues[Math.floor(mapSize * Math.floor(stepY) + x * step) * factor];
+                if (!this._buildFullVolume && (depth === 1 || y === 0 || x === 0 || y === numTesselation || x === numTesselation)) {
+                    depth = 0;
+                }
+                TmpVec3.set((x - halfTesselation) / halfTesselation, (y - halfTesselation) / halfTesselation, -1 + 2 * depth);
+                Vector3.TransformCoordinatesToRef(TmpVec3, invViewProjMatrix, TmpVec3);
+                positions[posIndex] = TmpVec3.x;
+                positions[posIndex + 1] = TmpVec3.y;
+                positions[posIndex + 2] = TmpVec3.z;
+                posIndex += 3;
+            }
+            stepY += step;
+        }
+        this._mesh.setVerticesData("position", positions);
+        this._readPixelPromise = null;
+        this._firstUpdate = false;
+    }
+    _createGeometry() {
+        if (!this._light) {
+            return;
+        }
+        this._tesselation = Math.max(Math.ceil(this._tesselation) & ~1, 2);
+        const light = this._light;
+        const min = new Vector3(light.orthoLeft, light.orthoBottom, light.shadowMinZ ?? 0);
+        const max = new Vector3(light.orthoRight, light.orthoTop, light.shadowMaxZ ?? 10000);
+        const invViewMatrix = Matrix.LookAtLH(light.position, light.position.add(light.direction), Vector3.UpReadOnly);
+        invViewMatrix.invertToRef(invViewMatrix);
+        const positions = [];
+        const indices = [];
+        const numTesselation = this._tesselation;
+        const stepX = (max.x - min.x) / numTesselation;
+        const stepY = (max.y - min.y) / numTesselation;
+        const v = new Vector3();
+        const startFarIndices = this._buildFullVolume ? (numTesselation + 1) * 4 : 4;
+        if (this._buildFullVolume) {
+            let startIndices = 0;
+            // Right faces of the frustum
+            for (let i = 0; i <= numTesselation; ++i) {
+                v.set(max.x, min.y + i * stepY, min.z);
+                const p = Vector3.TransformCoordinates(v, invViewMatrix);
+                positions.push(p.x, p.y, p.z);
+                if (i < numTesselation) {
+                    indices.push(startIndices + i, startFarIndices + numTesselation + (i + 1) * (numTesselation + 1), startFarIndices + numTesselation + i * (numTesselation + 1));
+                    indices.push(startIndices + i, startIndices + i + 1, startFarIndices + numTesselation + (i + 1) * (numTesselation + 1));
+                }
+            }
+            const n0 = 0;
+            const n1 = positions.length / 3 - 1;
+            const n2 = n1 + 1;
+            startIndices = positions.length / 3;
+            // Left faces of the frustum
+            for (let i = 0; i <= numTesselation; ++i) {
+                v.set(min.x, min.y + i * stepY, min.z);
+                const p = Vector3.TransformCoordinates(v, invViewMatrix);
+                positions.push(p.x, p.y, p.z);
+                if (i < numTesselation) {
+                    indices.push(startIndices + i, startFarIndices + 0 + i * (numTesselation + 1), startFarIndices + 0 + (i + 1) * (numTesselation + 1));
+                    indices.push(startIndices + i, startFarIndices + 0 + (i + 1) * (numTesselation + 1), startIndices + i + 1);
+                }
+            }
+            const n3 = positions.length / 3 - 1;
+            startIndices = positions.length / 3;
+            // Bottom faces of the frustum
+            for (let i = 0; i <= numTesselation; ++i) {
+                v.set(min.x + i * stepX, min.y, min.z);
+                const p = Vector3.TransformCoordinates(v, invViewMatrix);
+                positions.push(p.x, p.y, p.z);
+                if (i < numTesselation) {
+                    indices.push(startIndices + i, startIndices + i + 1, startFarIndices + i + 0 * (numTesselation + 1));
+                    indices.push(startIndices + i + 1, startFarIndices + i + 1 + 0 * (numTesselation + 1), startFarIndices + i + 0 * (numTesselation + 1));
+                }
+            }
+            startIndices = positions.length / 3;
+            // Top faces of the frustum
+            for (let i = 0; i <= numTesselation; ++i) {
+                v.set(min.x + i * stepX, max.y, min.z);
+                const p = Vector3.TransformCoordinates(v, invViewMatrix);
+                positions.push(p.x, p.y, p.z);
+                if (i < numTesselation) {
+                    indices.push(startIndices + i, startFarIndices + i + numTesselation * (numTesselation + 1), startIndices + i + 1);
+                    indices.push(startIndices + i + 1, startFarIndices + i + numTesselation * (numTesselation + 1), startFarIndices + i + 1 + numTesselation * (numTesselation + 1));
+                }
+            }
+            startIndices = positions.length / 3;
+            // Near faces of the frustum
+            indices.push(n0, n2, n1);
+            indices.push(n2, n3, n1);
+        }
+        else {
+            let p;
+            v.set(max.x, min.y, min.z);
+            p = Vector3.TransformCoordinates(v, invViewMatrix);
+            positions.push(p.x, p.y, p.z);
+            v.set(max.x, max.y, min.z);
+            p = Vector3.TransformCoordinates(v, invViewMatrix);
+            positions.push(p.x, p.y, p.z);
+            v.set(min.x, min.y, min.z);
+            p = Vector3.TransformCoordinates(v, invViewMatrix);
+            positions.push(p.x, p.y, p.z);
+            v.set(min.x, max.y, min.z);
+            p = Vector3.TransformCoordinates(v, invViewMatrix);
+            positions.push(p.x, p.y, p.z);
+            indices.push(0, 2, 1);
+            indices.push(2, 3, 1);
+        }
+        // Tesselate the far plane
+        let y = min.y;
+        for (let iy = 0; iy <= numTesselation; ++iy) {
+            let x = min.x;
+            for (let ix = 0; ix <= numTesselation; ++ix) {
+                v.set(x, y, min.z);
+                const p = Vector3.TransformCoordinates(v, invViewMatrix);
+                positions.push(p.x, p.y, p.z);
+                if (ix < numTesselation && iy < numTesselation) {
+                    indices.push(startFarIndices + ix + iy * (numTesselation + 1), startFarIndices + ix + 1 + iy * (numTesselation + 1), startFarIndices + ix + 1 + (iy + 1) * (numTesselation + 1));
+                    indices.push(startFarIndices + ix + iy * (numTesselation + 1), startFarIndices + ix + 1 + (iy + 1) * (numTesselation + 1), startFarIndices + ix + (iy + 1) * (numTesselation + 1));
+                }
+                x += stepX;
+            }
+            y += stepY;
+        }
+        if (this._uBuffer && this._cs) {
+            const webGPUEngine = this._engine;
+            this._storageBuffer?.dispose();
+            this._storageBuffer = new StorageBuffer(webGPUEngine, positions.length * 4, 8 | 3);
+            this._storageBuffer.update(positions);
+            const vertexBuffer = new VertexBuffer(webGPUEngine, this._storageBuffer.getBuffer(), "position");
+            this._mesh.setVerticesBuffer(vertexBuffer);
+            this._cs.setStorageBuffer("positions", this._storageBuffer);
+            this._uBuffer.updateUInt("startVertexIndex", this._buildFullVolume ? (numTesselation + 1) * 4 * 3 : 4 * 3);
+            this._uBuffer.updateFloat("step", ((this._shadowGenerator?.mapSize ?? 128) - 1) / numTesselation);
+            this._uBuffer.updateUInt("tesselation", numTesselation);
+        }
+        else {
+            this._mesh.setVerticesData("position", positions);
+        }
+        this._mesh.setIndices(indices, positions.length / 3);
+    }
+}
+//# sourceMappingURL=lightingVolume.js.map