@babylonjs/core 5.45.2 → 5.47.0

package/Lights/Shadows/shadowGenerator.js

@@ -24,121 +24,6 @@ import { addClipPlaneUniforms, bindClipPlane, prepareDefinesForClipPlanes } from
  * Documentation: https://doc.babylonjs.com/features/featuresDeepDive/lights/shadows
  */
 export class ShadowGenerator {
-    /**
-     * Creates a ShadowGenerator object.
-     * A ShadowGenerator is the required tool to use the shadows.
-     * Each light casting shadows needs to use its own ShadowGenerator.
-     * Documentation : https://doc.babylonjs.com/features/featuresDeepDive/lights/shadows
-     * @param mapSize The size of the texture what stores the shadows. Example : 1024.
-     * @param light The light object generating the shadows.
-     * @param usefullFloatFirst By default the generator will try to use half float textures but if you need precision (for self shadowing for instance), you can use this option to enforce full float texture.
-     * @param camera Camera associated with this shadow generator (default: null). If null, takes the scene active camera at the time we need to access it
-     */
-    constructor(mapSize, light, usefullFloatFirst, camera) {
-        /**
-         * Observable triggered before the shadow is rendered. Can be used to update internal effect state
-         */
-        this.onBeforeShadowMapRenderObservable = new Observable();
-        /**
-         * Observable triggered after the shadow is rendered. Can be used to restore internal effect state
-         */
-        this.onAfterShadowMapRenderObservable = new Observable();
-        /**
-         * Observable triggered before a mesh is rendered in the shadow map.
-         * Can be used to update internal effect state (that you can get from the onBeforeShadowMapRenderObservable)
-         */
-        this.onBeforeShadowMapRenderMeshObservable = new Observable();
-        /**
-         * Observable triggered after a mesh is rendered in the shadow map.
-         * Can be used to update internal effect state (that you can get from the onAfterShadowMapRenderObservable)
-         */
-        this.onAfterShadowMapRenderMeshObservable = new Observable();
-        this._bias = 0.00005;
-        this._normalBias = 0;
-        this._blurBoxOffset = 1;
-        this._blurScale = 2;
-        this._blurKernel = 1;
-        this._useKernelBlur = false;
-        this._filter = ShadowGenerator.FILTER_NONE;
-        this._filteringQuality = ShadowGenerator.QUALITY_HIGH;
-        this._contactHardeningLightSizeUVRatio = 0.1;
-        this._darkness = 0;
-        this._transparencyShadow = false;
-        /**
-         * Enables or disables shadows with varying strength based on the transparency
-         * When it is enabled, the strength of the shadow is taken equal to mesh.visibility
-         * If you enabled an alpha texture on your material, the alpha value red from the texture is also combined to compute the strength:
-         *          mesh.visibility * alphaTexture.a
-         * The texture used is the diffuse by default, but it can be set to the opacity by setting useOpacityTextureForTransparentShadow
-         * Note that by definition transparencyShadow must be set to true for enableSoftTransparentShadow to work!
-         */
-        this.enableSoftTransparentShadow = false;
-        /**
-         * If this is true, use the opacity texture's alpha channel for transparent shadows instead of the diffuse one
-         */
-        this.useOpacityTextureForTransparentShadow = false;
-        /**
-         * Controls the extent to which the shadows fade out at the edge of the frustum
-         */
-        this.frustumEdgeFalloff = 0;
-        /**
-         * If true the shadow map is generated by rendering the back face of the mesh instead of the front face.
-         * This can help with self-shadowing as the geometry making up the back of objects is slightly offset.
-         * It might on the other hand introduce peter panning.
-         */
-        this.forceBackFacesOnly = false;
-        this._lightDirection = Vector3.Zero();
-        this._viewMatrix = Matrix.Zero();
-        this._projectionMatrix = Matrix.Zero();
-        this._transformMatrix = Matrix.Zero();
-        this._cachedPosition = new Vector3(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE);
-        this._cachedDirection = new Vector3(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE);
-        this._currentFaceIndex = 0;
-        this._currentFaceIndexCache = 0;
-        this._defaultTextureMatrix = Matrix.Identity();
-        this._mapSize = mapSize;
-        this._light = light;
-        this._scene = light.getScene();
-        this._camera = camera !== null && camera !== void 0 ? camera : null;
-        let shadowGenerators = light._shadowGenerators;
-        if (!shadowGenerators) {
-            shadowGenerators = light._shadowGenerators = new Map();
-        }
-        shadowGenerators.set(this._camera, this);
-        this.id = light.id;
-        this._useUBO = this._scene.getEngine().supportsUniformBuffers;
-        if (this._useUBO) {
-            this._sceneUBOs = [];
-            this._sceneUBOs.push(this._scene.createSceneUniformBuffer(`Scene for Shadow Generator (light "${this._light.name}")`));
-        }
-        ShadowGenerator._SceneComponentInitialization(this._scene);
-        // Texture type fallback from float to int if not supported.
-        const caps = this._scene.getEngine().getCaps();
-        if (!usefullFloatFirst) {
-            if (caps.textureHalfFloatRender && caps.textureHalfFloatLinearFiltering) {
-                this._textureType = 2;
-            }
-            else if (caps.textureFloatRender && caps.textureFloatLinearFiltering) {
-                this._textureType = 1;
-            }
-            else {
-                this._textureType = 0;
-            }
-        }
-        else {
-            if (caps.textureFloatRender && caps.textureFloatLinearFiltering) {
-                this._textureType = 1;
-            }
-            else if (caps.textureHalfFloatRender && caps.textureHalfFloatLinearFiltering) {
-                this._textureType = 2;
-            }
-            else {
-                this._textureType = 0;
-            }
-        }
-        this._initializeGenerator();
-        this._applyFilterValues();
-    }
     /**
      * Gets the bias: offset applied on the depth preventing acnea (in light direction).
      */
@@ -595,6 +480,121 @@ export class ShadowGenerator {
         this._light._markMeshesAsLightDirty();
         this.recreateShadowMap();
     }
+    /**
+     * Creates a ShadowGenerator object.
+     * A ShadowGenerator is the required tool to use the shadows.
+     * Each light casting shadows needs to use its own ShadowGenerator.
+     * Documentation : https://doc.babylonjs.com/features/featuresDeepDive/lights/shadows
+     * @param mapSize The size of the texture what stores the shadows. Example : 1024.
+     * @param light The light object generating the shadows.
+     * @param usefullFloatFirst By default the generator will try to use half float textures but if you need precision (for self shadowing for instance), you can use this option to enforce full float texture.
+     * @param camera Camera associated with this shadow generator (default: null). If null, takes the scene active camera at the time we need to access it
+     */
+    constructor(mapSize, light, usefullFloatFirst, camera) {
+        /**
+         * Observable triggered before the shadow is rendered. Can be used to update internal effect state
+         */
+        this.onBeforeShadowMapRenderObservable = new Observable();
+        /**
+         * Observable triggered after the shadow is rendered. Can be used to restore internal effect state
+         */
+        this.onAfterShadowMapRenderObservable = new Observable();
+        /**
+         * Observable triggered before a mesh is rendered in the shadow map.
+         * Can be used to update internal effect state (that you can get from the onBeforeShadowMapRenderObservable)
+         */
+        this.onBeforeShadowMapRenderMeshObservable = new Observable();
+        /**
+         * Observable triggered after a mesh is rendered in the shadow map.
+         * Can be used to update internal effect state (that you can get from the onAfterShadowMapRenderObservable)
+         */
+        this.onAfterShadowMapRenderMeshObservable = new Observable();
+        this._bias = 0.00005;
+        this._normalBias = 0;
+        this._blurBoxOffset = 1;
+        this._blurScale = 2;
+        this._blurKernel = 1;
+        this._useKernelBlur = false;
+        this._filter = ShadowGenerator.FILTER_NONE;
+        this._filteringQuality = ShadowGenerator.QUALITY_HIGH;
+        this._contactHardeningLightSizeUVRatio = 0.1;
+        this._darkness = 0;
+        this._transparencyShadow = false;
+        /**
+         * Enables or disables shadows with varying strength based on the transparency
+         * When it is enabled, the strength of the shadow is taken equal to mesh.visibility
+         * If you enabled an alpha texture on your material, the alpha value red from the texture is also combined to compute the strength:
+         *          mesh.visibility * alphaTexture.a
+         * The texture used is the diffuse by default, but it can be set to the opacity by setting useOpacityTextureForTransparentShadow
+         * Note that by definition transparencyShadow must be set to true for enableSoftTransparentShadow to work!
+         */
+        this.enableSoftTransparentShadow = false;
+        /**
+         * If this is true, use the opacity texture's alpha channel for transparent shadows instead of the diffuse one
+         */
+        this.useOpacityTextureForTransparentShadow = false;
+        /**
+         * Controls the extent to which the shadows fade out at the edge of the frustum
+         */
+        this.frustumEdgeFalloff = 0;
+        /**
+         * If true the shadow map is generated by rendering the back face of the mesh instead of the front face.
+         * This can help with self-shadowing as the geometry making up the back of objects is slightly offset.
+         * It might on the other hand introduce peter panning.
+         */
+        this.forceBackFacesOnly = false;
+        this._lightDirection = Vector3.Zero();
+        this._viewMatrix = Matrix.Zero();
+        this._projectionMatrix = Matrix.Zero();
+        this._transformMatrix = Matrix.Zero();
+        this._cachedPosition = new Vector3(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE);
+        this._cachedDirection = new Vector3(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE);
+        this._currentFaceIndex = 0;
+        this._currentFaceIndexCache = 0;
+        this._defaultTextureMatrix = Matrix.Identity();
+        this._mapSize = mapSize;
+        this._light = light;
+        this._scene = light.getScene();
+        this._camera = camera !== null && camera !== void 0 ? camera : null;
+        let shadowGenerators = light._shadowGenerators;
+        if (!shadowGenerators) {
+            shadowGenerators = light._shadowGenerators = new Map();
+        }
+        shadowGenerators.set(this._camera, this);
+        this.id = light.id;
+        this._useUBO = this._scene.getEngine().supportsUniformBuffers;
+        if (this._useUBO) {
+            this._sceneUBOs = [];
+            this._sceneUBOs.push(this._scene.createSceneUniformBuffer(`Scene for Shadow Generator (light "${this._light.name}")`));
+        }
+        ShadowGenerator._SceneComponentInitialization(this._scene);
+        // Texture type fallback from float to int if not supported.
+        const caps = this._scene.getEngine().getCaps();
+        if (!usefullFloatFirst) {
+            if (caps.textureHalfFloatRender && caps.textureHalfFloatLinearFiltering) {
+                this._textureType = 2;
+            }
+            else if (caps.textureFloatRender && caps.textureFloatLinearFiltering) {
+                this._textureType = 1;
+            }
+            else {
+                this._textureType = 0;
+            }
+        }
+        else {
+            if (caps.textureFloatRender && caps.textureFloatLinearFiltering) {
+                this._textureType = 1;
+            }
+            else if (caps.textureHalfFloatRender && caps.textureHalfFloatLinearFiltering) {
+                this._textureType = 2;
+            }
+            else {
+                this._textureType = 0;
+            }
+        }
+        this._initializeGenerator();
+        this._applyFilterValues();
+    }
     _initializeGenerator() {
         this._light._markMeshesAsLightDirty();
         this._initializeShadowMap();